Skip to content

T8/P1: documentation + factoring guards (Sphinx, MCP manifest, splittability) #49

Description

@mzargham

Owner-added P1 scope (2026-08-02 review) on branch feat/t8-concept-definition-app. Discharges N5 (the app definition is a versioned, reviewed artifact).

Traceability:

  • Generated MCP tool-manifest doc docs/services/mcp-manifest.md, drift-checked → tests/unit/test_docs_drift.py
  • Hand-written per-surface docs: docs/services/mcp-server.md (MCP endpoint), docs/services/rest-api.md (OpenAPI/Swagger surface)
  • Splittability contract docs/architecture/factoring.md + AST import-direction guards → tests/unit/test_factoring.py
  • Sphinx wiring: docs/api.md (cds.mcp/cds.service autodoc), docs/index.md toctree
  • Spec amendment: §7 tree + service extra + cds-api script; §8.1 transport-independence sentence

Commits reference this issue with Refs: footers. Closes only when feat/t8-concept-definition-app merges to main.

Metadata

Metadata

Assignees

No one assigned

    Labels

    docst8T8 — LLM ergonomics + hosting (concept-definition web app)

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions