motir.co serves /docs — the eight generated pages, the mechanism decided and recorded before they are written
Type: code · Executor: coding_agent · Repo: motir-marketing · ONE PR.
Render /docs on motir.co. The mechanism must be DECIDED and recorded BEFORE the pages are written — this is the card's first deliverable, not a detail.
The decision it owes first
The eight doc pages are GENERATED from motir-core's own registries — lib/apiDocs/reference reads the OpenAPI spec file, lib/apiDocs/mcp reads the tool catalogue. Rendering them here means consuming those registries across a repository boundary, which is the mirror-rot tests/navigation/proxy-matcher.test.ts exists to catch. Decide HOW and record it (an ADR in this repo, or the PR body) before writing the pages: a published artifact motir-core emits and this repo installs is the shape that does not rot; a copied spec with no guard is the shape that does.
Scope
- The eight pages (
/docs,/docs/api,/docs/api/getting-started,/docs/api/stability,/docs/mcp,/docs/mcp/tools,/docs/cli,/docs/sandbox), matching whatmotir-corecurrently publishes. - Whatever mechanism is chosen carries a guard that fails when this repo's copy drifts from motir-core's registries — a copied spec with no guard is not an acceptable outcome.
- Internalise the Docs nav item and footer link —
DOCSinlib/destinations.tsbecomes/docs(same-origin), matching MOTIR-3880's chrome. - The crawl surface entries for these pages.
Boundary
- It composes MOTIR-3880's chrome; redraws none of it.
- It reads no database and adds no Prisma client / connection string (asserted).
Acceptance criteria
/docsrenders onmotir.counder one chrome, and its content matches whatmotir-corecurrently publishes.- The mechanism is decided and recorded before the pages are written, and carries a drift guard that fails when this repo's copy drifts from
motir-core's registries. DOCSinlib/destinations.tsis same-origin;tests/destinations.test.tsasserts it.- No database client / Prisma / connection string (asserted).
pnpm lint · format:check · typecheck · build · testpass; AA contrast holds in both themes.