Skip to content

docs(synapse): reconcile architecture to the shipped 17-host distribution#17

Merged
Lyther merged 1 commit into
mainfrom
docs/synapse-arch-drift
Jul 5, 2026
Merged

docs(synapse): reconcile architecture to the shipped 17-host distribution#17
Lyther merged 1 commit into
mainfrom
docs/synapse-arch-drift

Conversation

@Lyther

@Lyther Lyther commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Why

The synapse architecture.md drifted from the shipped distribution state. It still described the v0.4-core picture — "13 hosts / 11 secret-bearing manual hosts" — and listed the already-completed P3.4 pending-target wiring as remaining. P3.4 + P5.3 (merged in #14) landed 17 generated MCP hosts: added VSCodium, Grok Build, Antigravity CLI (JSON merge) and Goose, Poolside (YAML block-merge).

Source of truth verified: registry/target-capabilities.json → 17 targets with surfaces.mcp.generation == "generated".

Changes (docs only)

  • All six stale counts (13 hosts / 11 manual) → 17 generated MCP hosts.
  • Dropped the completed P3.4 from every "remaining" line (only the operator-run live smoke, T2.5, remains).
  • Fixed the lifecycle component row that said "+ idle shutdown" — the sidecar stays resident (already stated correctly under Operations; this was a self-contradiction).
  • Replaced the brittle inline host enumerations (which also named a no-longer-modeled "Gemini") with the count + the merge-format families (JSON/TOML/JSONC/YAML) + a pointer to the canonical matrix docs/reference/targets.md — one home for the per-host list (SSOT), so this can't silently re-drift.

Verification

  • npm run check — pass · npm test — pass
  • No residual 13 hosts / 11 manual / pending-target wiring (P3.4) / + idle shutdown claims.
  • New relative link ../../docs/reference/targets.md resolves.
  • Grimoire architecture.md checked — no parallel drift (no host-count claims).

by mass-energy equivalence

…tion

The synapse architecture doc still described the v0.4-core distribution: '13 hosts
/ 11 secret-bearing manual hosts' and listed the already-shipped 'pending-target
wiring (P3.4)' as remaining. P3.4 + P5.3 landed 17 generated MCP hosts (added
VSCodium, Grok Build, Antigravity CLI via JSON merge; Goose, Poolside via YAML
block-merge). Reconcile all six stale counts to 17, drop the completed-P3.4
'remaining' claims, fix the lifecycle row that said 'idle shutdown' (the sidecar
stays resident, per Operations), and replace the brittle inline host lists with
the count + a pointer to the canonical matrix (docs/reference/targets.md) so the
enumeration has one home. Source of truth: registry/target-capabilities.json.

by mass-energy equivalence
@Lyther
Lyther merged commit 773c9e1 into main Jul 5, 2026
2 checks passed
@Lyther
Lyther deleted the docs/synapse-arch-drift branch July 5, 2026 10:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant