Skip to content
PointSav Digital Systems

Three-binary architecture: os-console, os-totebox, os-orchestration

← All revisions

9ad6df5a · PointSav Digital Systems ·

Phase C A1d: topic-* batch complete — 4 merges into canonical articles (+ content backfill), 4 prefix-drop renames, 2 merge-checks resolved (capability-geometry, private-git-paid-customer-endpoint); research/ seeded (preprint-notice-convention + landing cleanup). Track A (documentation) complete.

View the full record as of this revision →

@@ -0,0 +1,210 @@
---
schema: foundry-doc-v1
content_type: topic
title: "Three-binary architecture: os-console, os-totebox, os-orchestration"
slug: three-binary-architecture
aliases:
  - topic-three-binary-architecture
short_description: "Totebox Orchestration is delivered through three distinct binary operating environments — os-console, os-totebox, and os-orchestration — each with a distinct role, deployment target, and hosted application set."
category: architecture
type: reference
quality: complete
status: active
audience: public
bcsc_class: public-disclosure-safe
language_protocol: PROSE-TOPIC
last_edited: 2026-06-20
editor: pointsav-engineering
paired_with: three-binary-architecture.es.md
cites: []
---

# The Three-Binary Architecture: os-console, os-totebox, os-orchestration

[[totebox-orchestration|Totebox Orchestration]] is delivered through three distinct binary operating environments.
Each has a distinct role, a distinct deployment target, and a distinct set of hosted
applications. Together they form a complete system for sovereign data management.

---

## Overview

```
                    ┌──────────────────────────────────────┐
                    │           HOST MACHINE               │
                    │                                      │
                    │         os-console                   │
                    │   Operator Terminal Surface          │
                    │   cartridges: app-console-* (F2–F12)│
                    │   keyboard-native TUI                │
                    │   machine-authorized via F11         │
                    └──────────────┬───────────────────────┘
                                   │  machine capability token
                                   │  (authorized at F11 pairing)
                                   ▼
                    ┌──────────────────────────────────────┐
                    │       CUSTOMER HARDWARE / VM         │
                    │                                      │
                    │         os-totebox                   │
                    │   Sovereign WORM Data Vault          │
                    │   services: service-* (Ring 1+2)    │
                    │   no shell; no root process          │
                    │   WORM append-only ledger            │
                    │   Tier A local AI (service-slm)      │
                    └──────────────┬───────────────────────┘
                                   │  capability-gated federation
                                   │  (Totebox grants derived caps)
                                   ▼
                    ┌──────────────────────────────────────┐
                    │        VENDOR INFRASTRUCTURE         │
                    │                                      │
                    │      os-orchestration                │
                    │   Stateless Aggregation Layer        │
                    │   apps: app-orchestration-*          │
                    │   Yo-Yo GPU fleet (Tier B)           │
                    │   multi-Totebox commercial flows     │
                    │   holds no archive keys              │
                    └──────────────────────────────────────┘
```

---

## os-totebox: Sovereign WORM Data Vault

[[os-totebox|os-totebox]] is the customer-side deployment. It runs on hardware under the customer's
physical control — a NUC-class machine, a GCP VM, or a private server. Its function is
to host the [[three-ring-architecture|Ring 1 and Ring 2]] services:

**Ring 1 — Boundary Ingest:**
- `service-fs` — [[worm-ledger-architecture|WORM append-only filesystem]]; every write is a ledger entry
- `service-input` — structured input ingestion from os-console operators
- `service-extraction` — entity extraction pipeline from email and document payloads
- `service-egress` — controlled outbound data flow

**Ring 2 — Deterministic Processing:**
- `service-content` — knowledge graph over all ingested entities
- `service-people` — personnel and identity ledger
- `service-email` — email archive bridge (Microsoft Exchange → Maildir)
- `service-slm` — local AI inference gateway (Tier A)

Ring 3 (optional AI, Tier B+ inference) is hosted by [[os-orchestration|os-orchestration]], not os-totebox.
A Totebox ships with Rings 1 and 2. Ring 3 is an opt-in paid tier.

**Intended final form (Phase H2, planned):** os-totebox boots bare metal or as a VM
into a [[sel4-microkernel-substrate|seL4 Microkit]] image. Each service runs as a seL4 Protection Domain. No Linux
shell. No package manager. No init system. The service-fs PD holds the WORM storage
device capability; no other PD can reach the physical storage directly.

---

## os-console: Operator Terminal Surface

[[os-console-architecture|os-console]] runs on the operator's personal machine. It is the interface through which
the operator interacts with Totebox services. It does not store data — it renders views
of data that lives in os-totebox.

os-console is deployed as a node instance (naming prefix: `node-console-*`). The
operator boots it or runs it as an application. It connects outbound to the Totebox,
authenticates via [[pairing-as-permission|machine pairing]] (F11), and presents the authorized cartridge set.

**Cartridges (app-console-*) are the rendering unit:**

| Key | Cartridge | Backend |
|---|---|---|
| F2 | People | service-people |
| F3 | Email | service-email |
| F4 | Content | service-content |
| F6 | Bookkeeper | service-bookkeeper |
| F9 | SLM | service-slm |
| F11 | System / Pairing | pairing-server |
| F12 | Input / Audit | service-input |

**Intended final form (Phase H2, planned):** os-console boots as a seL4 Microkit image.
Each cartridge runs as a seL4 Protection Domain (the "browser tab" isolation model).
moonshot-hypervisor provides the host-side VMM on Linux (KVM) and macOS
(Hypervisor.framework).

---

## os-orchestration: Stateless Aggregation Layer

os-orchestration is the vendor-side paid tier. It aggregates across multiple customer
Toteboxes and provides commercial services that require cross-Totebox data access.

os-orchestration is **stateless**: it holds no archive keys, writes no data, owns no
ledger. It computes over capability-granted views of Totebox data.

**Hosted applications (app-orchestration-*):**

| App | Role | Port |
|---|---|---|
| app-orchestration-slm | Yo-Yo GPU broker (Tier B); multi-Totebox SLM federation | :9180 |
| app-orchestration-market | Data marketplace UI (planned) | — |
| app-orchestration-exchange | Ad exchange gateway (planned) | — |
| [[app-orchestration-gis|app-orchestration-gis]] | Continental-scale GIS processing | deployed |
| app-orchestration-bim | Multi-archive BIM federation | — |

**Commercial model:** A single Totebox runs Rings 1–2 at no licensing
cost. Connecting to os-orchestration for Tier B inference, data marketplace, or BIM
aggregation is the paid tier.

**Intended final form (Phase H2, planned):** os-orchestration boots as a seL4 Microkit
image. A capability-broker Protection Domain holds all cross-Totebox endpoint
capabilities. No app-orchestration-* PD can directly contact a Totebox service without
routing through the capability-broker PD.

---

## Capability Geometry Across All Three

The [[capability-geometry|Capability Geometry]] model applies at each layer with the same mechanism but a
different scope:

| Layer | PD boundary | What it bounds |
|---|---|---|
| os-console | Per cartridge (F2, F3, F4...) | One cartridge cannot read another's data |
| os-totebox | Per service (service-people, service-slm...) | One service cannot escalate to another |
| os-orchestration | Per app + capability-broker chokepoint | One org's data cannot reach another org |

The seL4 kernel provides the same formal proof at each layer. The capability substrate
(system-core, system-ledger) provides the Rust-language interface to these proofs.
moonshot-sel4-vmm provides the PD runtime that makes Rust code run inside each
Protection Domain.

The three-binary architecture is one system — one seL4 proof, one capability substrate,
one [[moonshot-toolkit-build-orchestrator|moonshot-toolkit]] build pipeline — deployed at three distinct tiers.

---

## Deployment Topology

```
TOTEBOX ORCHESTRATION LAYER
gateway-orchestration-command-1   [os-orchestration hub]
  │
  ├── cluster-totebox-*     (os-totebox)     outbound capability grant
  ├── node-console-*        (os-console)     outbound machine pairing
  └── gateway-orchestration-[gis/bim/slm]-N  outbound federation
```

Each `cluster-totebox-*` is one customer's Sovereign WORM Data Vault. Each
`node-console-*` is one operator's terminal. `gateway-orchestration-*` instances are
named deployments of specific os-orchestration applications.

---

## What This Means for the SMB Operator

A small business with no IT department runs:
- One `cluster-totebox-1` — on a NUC under the server room desk or a $7/month GCP VM
- One or more `node-console-*` — one per staff member who needs Totebox access
- Optional: connection to `gateway-orchestration-slm-1` for Tier B AI capability

The operator does not manage servers. They do not configure firewalls. They boot the
Totebox, boot os-console, scan a QR code, and the system is running. If they cancel the
optional Tier B subscription, their Totebox (and all their data) continues operating
independently. There is no mandatory cloud dependency.

---

*Woodfine Capital Projects™, MCorp™, PointSav Digital Systems™, Totebox Orchestration™, Totebox Archive™, and Capability Geometry™ are trademarks of Woodfine Capital Projects Inc., used in Canada, the United States, Latin America, and Europe. All other trademarks are the property of their respective owners.*
Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →