feat(phase3): mcp.md canonical from AEGIS wiki

docs-manifest.json

@@ -27,13 +27,6 @@
           "color": "#f472b6",
           "tag": "04"
         },
-        "mcp.md": {
-          "source": "docs/mcp.md",
-          "section": "platform",
-          "order": 5,
-          "color": "#22d3ee",
-          "tag": "05"
-        },
         "api-reference.md": {
           "source": "docs/api-reference.md",
           "section": "platform",

scripts/docs-sync-from-wiki.sh

@@ -103,11 +103,14 @@ while IFS=$'\t' read -r slug page section order color tag; do
     continue
   fi
 
-  # Parse JSON: extract title, summary, body, last_verified
+  # Parse JSON: extract title, summary, body, last_verified.
+  # Tolerate either response shape:
+  #   { page: { title, ... } }  — original aegis#582 spec
+  #   { title, ... }             — aegis-daemon v2.10.6 actually returns the page directly
   parsed=$(echo "$body" | python3 -c "
 import json, sys
 data = json.load(sys.stdin)
-page = data.get('page', {})
+page = data.get('page', data) if isinstance(data, dict) else {}
 print('---TITLE---')
 print(page.get('title', ''))
 print('---SUMMARY---')
@@ -123,11 +126,22 @@ print(page.get('body', ''))
   last_verified=$(echo "$parsed" | sed -n '/^---LAST_VERIFIED---$/,/^---BODY---$/p' | sed '1d;$d')
   page_body=$(echo "$parsed" | sed -n '/^---BODY---$/,$p' | sed '1d')
 
+  # Truncate summary to ~280 chars at a word boundary so frontmatter
+  # `description` doesn't end mid-word (PR #22 review surfaced "stackbilde"
+  # cut from "stackbilder.com"). Adds ellipsis when truncation occurs.
+  description=$(printf '%s' "$summary" | python3 -c "
+import sys
+s = sys.stdin.read().strip().replace('\n', ' ').replace('\"', '\\\\\"')
+if len(s) > 280:
+    s = s[:280].rsplit(' ', 1)[0].rstrip(',.;:') + '…'
+print(s)
+")
+
   # Build Astro frontmatter from wiki metadata + manifest cosmetics
   frontmatter=$(cat <<FRONTMATTER
 ---
 title: "$(echo "$title" | sed 's/"/\\"/g')"
-description: "$(echo "$summary" | head -c 280 | sed 's/"/\\"/g' | tr '\n' ' ')"
+description: "$description"
 section: "$section"
 order: $order
 color: "$color"

scripts/wiki-publish-manifest.json

@@ -2,13 +2,13 @@
   "$schema": "Phase 2 wiki-as-SoT publish manifest — AEGIS wiki slugs → Astro page metadata. Per wiki-as-docs-sot-migration AEGIS decision.",
   "version": 4,
   "contentDir": "src/content/docs",
-  "_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.",
+  "_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.",
   "source": "aegis-wiki",
   "aegisBase": "https://aegis.stackbilt.dev",
   "pages": [
     {
       "slug": "mcp-gateway-architecture",
-      "page": "mcp-from-wiki.md",
+      "page": "mcp.md",
       "section": "platform",
       "order": 5,
       "color": "#22d3ee",