VM-* architecture and OS family
fix(systems,infrastructure): OS-family wiki audit round 2 -- totebox-os rewrite, PSP corpus fix, network-admin/mesh corrections, workplace ES sync, totebox siblings update
@@ -19,7 +19,7 @@ The PointSav platform organises its runtime deployments under a set of named VM This correspondence is not incidental. The platform is designed to be deployed the same way by a builder running a development environment as by a customer running a production system. The five VM types map directly to the five ways customers and community members engage with the platform. **Correction (2026-08-02, revised):** several specific claims below don't match the real codebase. (1) `os-orchestration` (VM-Orchestration's named source binary) is a real crate on canonical but currently an empty placeholder scaffold (retracted from an earlier "not built" claim — the related `app-orchestration-command` crate is real and substantial, see [[personnel-permissions]]); its "PointSav Protocol (PSP)" aggregation mechanism remains confirmed fabricated, zero code footprint even on canonical. (2) `service-proofreader` is not a real crate name — the real proofreader implementation is `app-console-content/src/proofreader.rs`, described in its own `Cargo.toml` as "os-console F4 Content Cartridge," which undercuts this article's own placement argument that its callers are MediaKit-resident: its real caller is `os-console`. (3) `app-privategit-design-system` is misnamed — the real crate is `app-privategit-design` (no "-system" suffix). (4) The genesis-node roles below are inverted relative to the real provisioning scripts: `infrastructure/virt/provision-vm-infrastructure-cloud.sh` states outright that "GCP is the canonical genesis-seed for the internet-facing hub" (not Laptop A), and `provision-vm-infrastructure-onprem.sh` shows Laptop A peers with the GCP hub via `--genesis` while Laptop B uses a distinct `--genesis-hub` flag for the on-prem LAN — not the plain `--join <short-code>` this article assigns it. **Flagged, not resolved** — needs correcting the binary/crate names and the genesis-role sequence; the Phase 2/3 Microkit/NVMM roadmap section is already correctly hedged as "intended" and needs no change. **Correction (2026-08-02, revised):** several specific claims below don't match the real codebase. (1) `os-orchestration` (VM-Orchestration's named source binary) is a real crate on canonical but currently an empty placeholder scaffold (retracted from an earlier "not built" claim — the related `app-orchestration-command` crate is real and substantial, see [[personnel-permissions]]); its "PointSav Protocol (PSP)" aggregation mechanism was confirmed fabricated, zero code footprint even on canonical, and has been removed below (2026-08-06) — the mechanism is now described as planned/intended with no invented protocol name. (2) `service-proofreader` is not a real crate name — the real proofreader implementation is `app-console-content/src/proofreader.rs`, described in its own `Cargo.toml` as "os-console F4 Content Cartridge," which undercuts this article's own placement argument that its callers are MediaKit-resident: its real caller is `os-console`. (3) `app-privategit-design-system` is misnamed — the real crate is `app-privategit-design` (no "-system" suffix). (4) The genesis-node roles below are inverted relative to the real provisioning scripts: `infrastructure/virt/provision-vm-infrastructure-cloud.sh` states outright that "GCP is the canonical genesis-seed for the internet-facing hub" (not Laptop A), and `provision-vm-infrastructure-onprem.sh` shows Laptop A peers with the GCP hub via `--genesis` while Laptop B uses a distinct `--genesis-hub` flag for the on-prem LAN — not the plain `--join <short-code>` this article assigns it. **Flagged, not resolved** — still needs correcting the binary/crate names and the genesis-role sequence; the Phase 2/3 Microkit/NVMM roadmap section is already correctly hedged as "intended" and needs no change. ## VM types and their purposes @@ -50,7 +50,7 @@ Services: `app-mediakit-knowledge` (documentation, corporate, and projects wikis **Source binary:** `os-orchestration` **Purpose:** Stateless multi-archive aggregator. Commercial paid tier. VM-Orchestration queries multiple VM-Totebox instances and presents fleet-wide or portfolio-wide views. It holds no data of its own — it aggregates via the PointSav Protocol (PSP), which is a capability-based query protocol. A VM-Orchestration instance serves the BIM coordination terminal, the GIS fleet map, and the SLM broker chassis. VM-Orchestration queries multiple VM-Totebox instances and presents fleet-wide or portfolio-wide views. It holds no data of its own — it is designed to aggregate via a capability-based query protocol, with no specific protocol name committed to code today. A VM-Orchestration instance serves the BIM coordination terminal, the GIS fleet map, and the SLM broker chassis. Services: `app-orchestration-bim`, `app-orchestration-gis`, `app-orchestration-slm` (:9180).