Skip to content

Commit bc477fb

Browse files
author
Kurt Overmier
committed
feat(phase3): mcp.md canonical from AEGIS wiki
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-*).
1 parent 8f35667 commit bc477fb

5 files changed

Lines changed: 95 additions & 220 deletions

File tree

docs-manifest.json

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,6 @@
2727
"color": "#f472b6",
2828
"tag": "04"
2929
},
30-
"mcp.md": {
31-
"source": "docs/mcp.md",
32-
"section": "platform",
33-
"order": 5,
34-
"color": "#22d3ee",
35-
"tag": "05"
36-
},
3730
"api-reference.md": {
3831
"source": "docs/api-reference.md",
3932
"section": "platform",

scripts/docs-sync-from-wiki.sh

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,11 +103,14 @@ while IFS=$'\t' read -r slug page section order color tag; do
103103
continue
104104
fi
105105

106-
# Parse JSON: extract title, summary, body, last_verified
106+
# Parse JSON: extract title, summary, body, last_verified.
107+
# Tolerate either response shape:
108+
# { page: { title, ... } } — original aegis#582 spec
109+
# { title, ... } — aegis-daemon v2.10.6 actually returns the page directly
107110
parsed=$(echo "$body" | python3 -c "
108111
import json, sys
109112
data = json.load(sys.stdin)
110-
page = data.get('page', {})
113+
page = data.get('page', data) if isinstance(data, dict) else {}
111114
print('---TITLE---')
112115
print(page.get('title', ''))
113116
print('---SUMMARY---')

scripts/wiki-publish-manifest.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
"$schema": "Phase 2 wiki-as-SoT publish manifest — AEGIS wiki slugs → Astro page metadata. Per wiki-as-docs-sot-migration AEGIS decision.",
33
"version": 4,
44
"contentDir": "src/content/docs",
5-
"_note": "Phase 2 parallel: page filenames are explicit per entry and use a -from-wiki suffix so they land at top-level (e.g., mcp-from-wiki.md) and route at /mcp-from-wiki for side-by-side comparison with the legacy /mcp page. Astro treats __-prefixed dirs as private and skips them, which is why we don't put files in a __from-wiki/ subdir. After Phase 4 migration (legacy retired), drop the suffix and use the actual page filename.",
5+
"_note": "Phase 3: mcp-gateway-architecture is now canonical (page: mcp.md). The corresponding entry was removed from legacy docs-manifest.json and the parallel POC slot mcp-from-wiki.md was retired. Remaining migration candidates land here per wiki-as-docs-sot-migration.",
66
"source": "aegis-wiki",
77
"aegisBase": "https://aegis.stackbilt.dev",
88
"pages": [
99
{
1010
"slug": "mcp-gateway-architecture",
11-
"page": "mcp-from-wiki.md",
11+
"page": "mcp.md",
1212
"section": "platform",
1313
"order": 5,
1414
"color": "#22d3ee",

src/content/docs/mcp-from-wiki.md

Lines changed: 0 additions & 141 deletions
This file was deleted.

0 commit comments

Comments
 (0)