Skip to content

History / Privileges

Revisions

  • docs: align operator wiki with current alpha state

    @flynn33 flynn33 committed Jul 4, 2026
  • Major wiki face-lift for v0.11.0-alpha.1 Refresh every page in the operator wiki against the v0.11.0-alpha.1 internal-alpha cut. Replaces the v0.6.0 baseline (~5 months stale) that still referenced the retired MCPJungle substrate as the active gateway. Tier 1 (landing + navigation) - Home: hero diagram, alpha-channel callout, "I want to..." task tables, current-release block reflecting the alpha MSI - _Sidebar: version + channel header, regrouped nav - _Footer: corrected source attribution (wiki is its own repo; prior footer pointed at a non-existent docs/wiki tree) - Architecture: 7 Mermaid views (system, process topology, HTTP surface map, pool state machine, lease-routing decision, telemetry+diagnostics flow, Forsetti module boundaries) plus persistent file layout + source-tree crosswalk - Quick-Start: install-to-first-call sequence diagram + 5-step walk-through ending in tools/call round-trip Tier 2 (core architecture) - Gateway, Worker-Pools, Onboarding, LAN-Discovery, LAN-Clients, Configuration — rewritten with 25 Mermaid diagrams total covering IMcpGateway lifecycle, the 7-state pool state machine, lease routing decisions, DNS-SD + UDP beacon flow, client identity lifecycle, config GET-mutate-POST pattern + self-heal flow Tier 3 (reference + operations) - API-Reference: complete route catalogue including the new v0.11.0 /api/diagnostics/* surface (5 routes) plus the honest 501 on /api/diagnostics/clear pending Slice E - Telemetry-and-Activity: event flow, rotation state machine, SSE Last-Event-ID resume, unavailable-vs-idle sentinel semantics - Operations: full Package-MasterControlOrchestrationServer.ps1 pipeline including the Launch-VsDevShell PATH-corruption workaround - Daily-Operations, Maintenance, Troubleshooting: decision-tree flowcharts top-to-bottom - Versions: channel semantics (alpha/beta/rc), MSI ProductVersion mapping table, PHASE-00..PHASE-14 gantt timeline - Release-Gate: local gate flow with green/red branches Tier 4 (governance + UX + ADRs + misc) - Governance, CLU-Governance, Privileges, Sub-Agents, Claude-Code-Plugin, Dashboard, Tron-UI-Theme, Remote-Client, Client-Config-Bundle, Automation, Windows-Firewall-LAN-Mode, Infrastructure, Packaging-and-Gateway-Binary, Architecture-Decisions, ADR-001, ADR-002, ADR-003 — refreshed for the current substrate (NativeHttpSysGatewayAdapter only) and the current pool catalog (25 MCP + 7 sub-agents, 126 tools) Across all 36 content pages - 94 Mermaid diagrams using the consistent Tron-palette dark theme - Every page opens with a Type/Audience/Time blockquote - Every page ends with a Related-pages cross-link footer - Every MCPJungle reference is now correctly framed as retired / superseded (none endorse it as the active substrate) - Every cross-link resolves to an existing wiki page - Version refs everywhere normalised to v0.11.0-alpha.1 - Build-Msi.ps1 regex documentation reflects the PR-#8 extended pattern (-(?:alpha|beta|rc)\.N), not the old rc-only form - Total wiki size: ~400 KB across 36 content pages plus sidebar and footer

    James Daley committed May 15, 2026
  • fix(wiki): flatten structure + fix link rendering issues GitHub wiki renders flat-structure pages most reliably. The earlier nested layout (Architecture-Decisions/, Operations/) and the related '[Page](Subdir/Page)' link form caused intermittent rendering issues. Changes: - Move ADR-001/002/003 from Architecture-Decisions/ to top level. - Move Windows-Firewall-LAN-Mode, Packaging-and-Gateway-Binary, and Release-Gate from Operations/ to top level. - Rewrite all internal links to use the flat form ([Page](Page)). - Rewrite ../../ in-repo paths to absolute GitHub blob URLs at https://github.com/flynn33/Master-Control-Orchestration-Server/blob/main/... (previous form did not resolve in the wiki context). - Strip decorative HTML tags (<b>, </b>, <code>, </code>, <i>, </i>, <strong>, </strong>, <em>, </em>) from inside Mermaid blocks. GitHub's mermaid renderer handles these inconsistently, especially inside cylinder shapes [(...)] like Runtime[(<b>X</b>)]. Plain text with <br/> for line breaks renders cleanly across all surfaces. - _Sidebar updated to point at flat-named pages. Pages affected: every wiki page touched. No content changes; only structural and rendering fixes.

    James Daley committed May 3, 2026
  • Wiki refresh aligned to v0.6.0 gateway-first realignment Major rewrite reflecting ADR-002 / ADR-003 and the PHASE-00..PHASE-11 realignment program shipped in v0.6.0. The wiki was previously at v0.2.12 and described the removed provider stack. New pages: - Quick-Start: 6-step install, smoke-test, and verification - Architecture-Decisions: ADR-001/002/003 index + supersession diagram - Gateway: IMcpGateway + MCPJungle adapter + supervised-mock fallback - Worker-Pools: 7-state lifecycle, lease router, autoscaling, drain - LAN-Discovery: DNS-SD service types, beacon, discovery document - Onboarding: per-client-type profiles, manual setup first-class - Dashboard: tour of the 11 destinations from PHASE-09 - Architecture-Decisions/ADR-001/002/003: full ADR text - Operations/Windows-Firewall-LAN-Mode + Packaging-and-Gateway-Binary + Release-Gate - Client-Config-Bundle, LAN-Clients, Privileges, Governance: ADR-001 operator surface preserved alongside gateway-first model Rewritten: - Home: landing page realigned to gateway-first - Architecture: layered + topology + lifecycle + sequence + gantt diagrams - _Sidebar: new navigation structure - CLU-Governance: bundles + decision policy + role separation - Sub-Agents: now a kind of managed pool - Versions: v0.6.0 entry with PHASE-00..PHASE-11 timeline gantt - Telemetry-and-Activity: PHASE-08 aggregator + -1.0 honesty rule - Troubleshooting: new sections for LAN discovery + supervised-mock Removed: - Auto-Connect-AI: provider stack retired in PHASE-01 Heavy use of Mermaid diagrams (flowchart, sequenceDiagram, stateDiagram-v2, gantt, classDiagram) throughout. Every page cross-references ADRs, contracts, and source files.

    James Daley committed May 3, 2026