diff --git a/docs/contract-additions/ergonomics-superiority.md b/docs/contract-additions/ergonomics-superiority.md new file mode 100644 index 0000000..3f3524b --- /dev/null +++ b/docs/contract-additions/ergonomics-superiority.md @@ -0,0 +1,47 @@ +# Ergonomics — one integrated system, more ergonomic than Apple + +Apple ships excellent apps that do **not** share a spine: each has its own permissions +(TCC), its own sync (iCloud), its own idea of the assistant (Siri, which mostly can't act +inside them). SociOS is the inverse thesis — **one system**. The ergonomic win is not a +prettier clone of any single app; it is that **every app rides the same five planes**, so +the whole set composes. + +## The one spine (every app rides all five) +| Plane | Every app gets… | Contract | +|---|---|---| +| **Launcher + NLQA** | reachable by name; grounded, cited help | lampstand · sherlock · docs-index | +| **Consent** | one purpose model for app *and* agent | role × surface × space × purpose (E11) | +| **Model** | one board, cloud ∩ local, sovereignty-ranked | InferenceGateway · GatewayCallAudit | +| **Mesh** | continuity across every device you own | MeshTransfer · WireGuard (E3) | +| **Receipts** | every action readable, sealed, replayable | AutonomyAdmissionReceipt (E4) | + +Because the spine is shared, **anything you can do the agent can do the same governed +way**, and every action — a file drop, a mail draft, a model call, a launcher query — +carries the same consent and the same receipt. That composition is the ergonomics. + +## Why it beats Apple (the dimensions) +- **One grammar** — ask in plain language; the launcher routes to a *typed, consented* + action in any app. (Apple: learn each app; Siri can't act inside most.) +- **Agent = you** — the agent uses the *same consented surface you do*; nothing it can do + is off-book. (Apple: brittle Shortcuts; the assistant can't drive your apps.) +- **Permissions** — one *purpose* model, fail-closed, editable, legible. (Apple: per-app + TCC checkboxes, opaque, all-or-nothing.) +- **Transparency** — every action is a sealed receipt with its warrant. (Apple: you can't + see what an app or Siri did.) +- **Continuity** — your mesh, any device you own, no vendor cloud, every transfer + receipted. (Apple: Handoff/AirDrop only between Apple devices via iCloud.) +- **Help** — grounded NLQA cites the docs and *abstains* when it can't. (Apple: scattered + docs, confident guessing.) +- **Ownership** — no account lock-in; models run local-first, ranked by sovereignty. + (Apple: Apple ID + iCloud; models are theirs.) + +## Done-definition for "integrated" +A surface is part of the integrated set only when it is **agent-native** (agent uses the +same typed/consented/receipted surface as a human), **accessible by default**, passes its +**seam's purple-team test**, and **rides all five planes** (or honestly declares which it +does not yet). The census (`macos-replacement-matrix.md`) tracks the ~37 surfaces; the +[integrated surface](../surfaces/integrated.html) is the operator view of the whole set. + +The honest caps remain the hardware register (Neural Engine, Secure Enclave, HW codecs, +display on Asahi) — silicon, not ergonomics. Everywhere else the integrated, agent-native, +receipted system is a superset, not a clone. diff --git a/docs/surfaces/README.md b/docs/surfaces/README.md index d4904f1..2930b9c 100644 --- a/docs/surfaces/README.md +++ b/docs/surfaces/README.md @@ -46,6 +46,10 @@ the real SociOS/GNOME chrome (top bar, launcher card) so they read as in-shell, - **`docs-support.html`** — Tier 2, *grounded NLQA + support*. Answers only from the auto-generated docs index (`tools/build_docs_index.py`), cites every source, and **abstains** to support when a question isn't in the docs. A CI drift-guard keeps the index fresh from source. +- **`integrated.html`** — Tier 1+2, *the whole system*. The E2E application set as one + integrated OS: every app riding the shared spine (launcher · consent · model · mesh · receipts), + the ergonomic wins over Apple, and one task threaded through many apps. See + [ergonomics-superiority.md](../contract-additions/ergonomics-superiority.md). - **`model-governance.html`** — Tier 2, *regulated model registry*. Business targets (fraud/churn/ credit/AML/propensity) with champion-vs-challenger, historic version comparison, PSI drift, and the DataClass classifiers per target. Model risk management as a witness surface. diff --git a/docs/surfaces/data/docs-index.json b/docs/surfaces/data/docs-index.json index 99a7d9b..3a218c2 100644 --- a/docs/surfaces/data/docs-index.json +++ b/docs/surfaces/data/docs-index.json @@ -1,7 +1,7 @@ { "provenance": "live", "generated_by": "tools/build_docs_index.py", - "doc_count": 43, + "doc_count": 44, "docs": [ { "path": "docs/contract-additions/2026-04-fog-contract-index.md", @@ -306,6 +306,30 @@ "personal" ] }, + { + "path": "docs/contract-additions/ergonomics-superiority.md", + "title": "Ergonomics — one integrated system, more ergonomic than Apple", + "summary": "Apple ships excellent apps that do **not** share a spine: each has its own permissions", + "headings": [ + "The one spine (every app rides all five)", + "Why it beats Apple (the dimensions)", + "Done-definition for \"integrated\"" + ], + "keywords": [ + "apple", + "one", + "every", + "app", + "integrated", + "can", + "not", + "its", + "own", + "same", + "spine", + "agent" + ] + }, { "path": "docs/contract-additions/focus-state.md", "title": "FocusState contract addition", @@ -1145,12 +1169,12 @@ "surfaces", "not", "source", - "canonical", "every", + "canonical", + "model", "diagram", "live", - "state", - "instrument" + "state" ] } ] diff --git a/docs/surfaces/integrated.html b/docs/surfaces/integrated.html new file mode 100644 index 0000000..c1aa26c --- /dev/null +++ b/docs/surfaces/integrated.html @@ -0,0 +1,127 @@ +SociOS — One Integrated System + + + +
+

One Integrated System

SociOS · not a bag of apps +
+

Apple ships great apps that don't share a spine — each has its own permissions, its own sync, its own idea of the assistant. SociOS is one system. Every app rides the same five planes, so anything you can do, the agent can do the same governed way — and every action leaves a receipt. That shared spine is what makes it more ergonomic than Apple, not just a clone.

+ +

The one spine — every app rides all five

+
+
No app is an island: a file drop, a mail draft, a model call, a launcher query — same consent, same receipt, same mesh, same agent.
+ +

The application set — 37 surfaces, one grammar

+
+
Every chip is consent-gated · model-plane-aware · on your mesh · receipted — reachable by name from the one launcher.
+ +

Why it's more ergonomic than Apple

+
+ +

One flow, many apps — the integration you feel

+
+ +

Every surface here is built to the same contract (agent-native · accessible-by-default · seam purple-tested) and merged across sourceos-spec · agent-machine · prophet-platform · client-vue. This isn't a mockup of an OS — it's the shape of the one that boots.

+
+ +