feat(phase3): mcp.md canonical from AEGIS wiki#22
Merged
Conversation
added 2 commits
May 2, 2026 16:48
Phase 3 of the wiki-as-SoT migration (AEGIS wiki slug
`wiki-as-docs-sot-migration`). The HTTP wiki proxy endpoint
(`aegis#582`) shipped in aegis-daemon v2.10.6, so
docs-sync-from-wiki.sh is now CI-runnable end-to-end.
Changes:
- scripts/wiki-publish-manifest.json: flip
mcp-gateway-architecture from POC slot (mcp-from-wiki.md) to
canonical (mcp.md). Updated _note accordingly.
- docs-manifest.json: drop the legacy stackbilt-web/docs/mcp.md
entry. mcp.md is now wiki-sourced; the gh-API path no longer
produces a file at this slot.
- scripts/docs-sync-from-wiki.sh: parser tolerates either
response shape — `{ page: { ... } }` (original aegis#582 spec)
or `{ ... }` directly (what aegis-daemon v2.10.6 actually
returns). Discrepancy noted; not blocking.
- src/content/docs/mcp.md: regenerated from wiki via the now-live
HTTP path. Carries lastVerified + sourceSlug provenance.
- src/content/docs/mcp-from-wiki.md: retired POC slot.
Verified locally: `npm run build` produces clean /mcp/ page
with wiki content (43.6KB). /mcp-from-wiki/ no longer routes.
Per the migration plan, Phase 4 will batch the remaining
candidates (evidence-engine-*, consult-harness-*, trust-*).
PR #22 review surfaced that mcp.md's description ended mid-word ("...as stackbilde", missing the "r" of stackbilder.com) because the previous `head -c 280` byte cut had no word-boundary awareness. Fix: pipe the summary through python to truncate at the last space before 280 chars, strip trailing punctuation, and append an ellipsis when truncation occurs. Re-synced mcp.md ends with "...service bindings as…" — a clean word boundary.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 3 of the wiki-as-SoT migration (AEGIS wiki:
wiki-as-docs-sot-migration). The HTTP wiki proxy endpoint (aegis#582) shipped in aegis-daemon v2.10.6, sodocs-sync-from-wiki.shis now CI-runnable end-to-end. This PR:mcp-gateway-architecturefrom the parallel POC slot (mcp-from-wiki.md) to canonical (mcp.md).stackbilt-web/docs/mcp.mdentry fromdocs-manifest.json— the gh-API path no longer produces a file at this slot; wiki is now the source of truth.src/content/docs/mcp-from-wiki.mddeleted;/mcp-from-wiki/route gone).docs-sync-from-wiki.shto tolerate either response shape —{ page: { ... } }(originalaegis#582spec) or{ ... }directly (what aegis-daemon v2.10.6 actually returns). Discrepancy noted but not blocking.After merge,
docs.stackbilt.dev/mcpis sourced from AEGIS wiki at build time.Verification
npm run buildclean: 9 pages,/mcp/rendered (43.6 KB),/mcp-from-wiki/retired.grepfor "Upstream/Downstream Architecture" → 3 hits, "three-consumer fractal" → 1 hit).lastVerified: 2026-05-02+sourceSlug: mcp-gateway-architecturepropagate to the content file frontmatter.Test plan
https://docs.stackbilt.dev/mcp/renders and shows wiki content (not legacy)https://docs.stackbilt.dev/mcp-from-wiki/returns 404 (POC slot retired)Follow-ups (not blocking)
{ page: ... }per theaegis#582spec, or (b) update the spec to reflect the unwrapped shape that v2.10.6 returns. Either is fine; the script tolerates both.evidence-engine-compose-and-trust-surface,evidence-engine-gap-fill-architecture,consult-harness-web-surface,trust-bundle-storage-architecture,trust-page-governance-timeline-architecture).