docs/config.yml

# aetos-docs configuration
# Single source of truth for which repositories the docs service serves.
#
#   repos:   documentation collected from sibling source repositories via collect.py
#            (refreshed manually: run `python collect.py` after rebuilding each repo's docs)
#   static:  docs already vendored inside this repository (never collected)
#
# Each repo may provide any of the doc kinds: lib, api, wiki (web sites) and mcp (MCP bundle).
# Each site is copied whole from the repo's `site/` dir.
# Served layout (flat, one dir per repo; no redirects):
#   lib  -> /<repo>/lib/
#   api  -> /<repo>/api/
#   wiki -> /<repo>/wiki/
#   mcp  -> MCP server on its configured port
# The docs homepage shows one card per repo, grouped by its `section`
# (apps, tutorial, services, libraries); card links cover the repo's kinds.

service:
  name: aetos-docs
  html_port: 9000      # nginx: html portal
  health_port: 8000    # mcp: /healthz

repos:
  - name: openapi-first
    source: ../openapi-first
    title: OpenAPI First
    description: Design-first API development toolkit enforcing OpenAPI contracts as the single source of truth.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: openapi_first, port: 8004 }

  - name: doc-forge
    source: ../doc-forge
    title: Doc Forge
    description: Renderer-agnostic Python documentation compiler powering MkDocs and MCP generation across Aetoskia projects.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: docforge, port: 8001 }

  - name: doc-weaver
    source: ../doc-weaver
    title: Doc Weaver
    description: TypeScript documentation compiler using TypeDoc + JSDoc (RDFC), generating a TypeDoc site and a doc-forge-shaped MCP bundle for React packages.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: doc-weaver, port: 8010 }

  - name: react-auth
    source: ../react/react-auth
    title: React Auth
    description: JWT-backed React authentication UI — AuthProvider context, login/register screen, profile screens, and an axios client that carries bearer tokens and handles 401s.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: react-auth, port: 8011 }

  - name: react-openapi
    source: ../react/react-openapi
    title: React OpenAPI
    description: Spec-driven React admin UI — derives CRUD routes, tables, forms, foreign-key selects and SSE streams from an OpenAPI document at runtime.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: react-openapi, port: 8012 }

  - name: dagpipe
    source: ../dagpipe
    title: DAG Pipe
    description: Deterministic pipeline framework for executing state transformations through a directed acyclic graph (DAG).
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: dagpipe, port: 8006 }

  - name: mail-intake
    source: ../mail-intake
    title: Mail Intake
    description: High-performance email ingestion and processing framework with pluggable adapters and automation workflows.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: mail_intake, port: 8002 }

  - name: omniread
    source: ../omniread
    title: Omniread
    description: Unified ingestion and normalization layer for structured and unstructured data sources.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: omniread, port: 8003 }

  - name: py-jwt
    source: ../py-jwt
    title: Py JWT
    description: Lightweight, explicit JWT utilities for Python services with strong validation and minimal magic.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: jwtlib, port: 8005 }

  - name: hexa
    source: ../hexa
    title: Hexa
    description: Hexagonal architecture framework and toolbox for Python services.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: hexa, port: 8008 }

  - name: mongo-ops
    source: ../mongo-ops
    title: Mongo Ops
    description: A modular, async MongoDB operations layer for FastAPI microservices. Simplifies CRUD, transactions, and model management.
    section: libraries
    docs:
      wiki: site
      lib: site
      mcp: { bundle: docs/mcp, server: mongo_ops, port: 8007 }

  - name: auth-server
    source: ../auth-server
    title: Auth Server
    description: Aetoskia authentication service. OpenAPI-driven, FastAPI backend for auth flows.
    section: services
    docs:
      api: site
      lib: site
      wiki: site

  - name: khata-app
    source: ../../apps/khata-app
    title: Khata App
    description: OpenAPI-first expenses & cashflow service — ingestion, enrichment, and reporting on MongoDB.
    section: apps
    docs:
      wiki: site
      lib: site
      api: site

static:
  - kind: wiki
    repo: standards
    title: Standards
    description: The standardized application blueprint and the internal library registry.
    section: standards
    path: standards
    docs:
      lib: yes
      wiki: yes

  - kind: tutorial
    repo: media-manager
    title: Media Manager Tutorial
    description: Step-by-step guide to the Media Manager architecture, ingestion pipeline, automation workflows, and integrations.
    section: tutorial
    path: media-manager

mcp_static:
  # Hand-authored bundles that live in this repo (not collected from a source repo).
  - name: standards
    title: Standards
    bundle: standards/mcp
    server: standards
    port: 8009
    kind: registry