Skip to content

History / LAN Discovery

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
  • Refocus wiki on operator workflows: setup, daily use, features The previous refresh was product-marketing framed. MCOS is an internal tool, not a product. Refocus around how to use it, how to set it up, how to use the features. Home page rewritten as task-oriented 'I want to...' table of contents pointing at the right page for each operator task. Architecture and ADRs moved to a Reference section near the bottom. _Sidebar restructured into five groups: Setup / Daily use / Tasks / Maintenance / Troubleshooting / Reference New pages: - Configuration.md — every field of mcos.json, when to change it, how to apply the change. Three editing paths (Settings panel, dashboard, direct file edit). - Daily-Operations.md — health check, presence roster, activity stream, add/scale/drain/remove pools, lease inspection, governance approvals, bundle distribution, log tailing. - Maintenance.md — upgrade flow (MajorUpgrade), repair (msiexec /fa), backup + restore, shortcut management, standard + clean uninstall, move to a new host, factory reset. Feature pages refactored to lead with How-To, push architecture down: - Onboarding: 'How to onboard, in 90 seconds' + per-client-type recipes - Worker-Pools: 'How to add a managed pool' with PowerShell body, field guidance table, scale/drain/remove recipes, manual lease ops - Gateway: 'How to install MCPJungle and turn the gateway on' with five-step diagram, restart and verification recipes - LAN-Discovery: 'How to verify MCOS is discoverable on the LAN' with cross-platform browser commands, disable/re-enable, instance label - Telemetry-and-Activity: how to read events, see who's connected, read gateway traffic with delta computation, send a test heartbeat Architecture diagrams and contract details preserved as Reference at the bottom of each page so the pages still answer 'why' questions when needed.

    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