Uh oh!
There was an error while loading. Please reload this page.
docs: clarify repo topology and semantic role - #3
Merged
Conversation
This was referenced Aug 2, 2026
mdheller pushed a commit
that referenced
this pull request
Aug 3, 2026
… parity, campaign gap #3); fix census owner attribution
mdheller added a commit
that referenced
this pull request
Aug 3, 2026
…s-zero census) (#266) * spec(macos): app-by-app replacement & enhancement matrix (feature-gaps-zero census) Closes the biggest spec gap: the contract (#262) says HOW to build agent-native apps, but the app-by-app macOS→SourceOS census never existed. This is it — 24 stock-macOS apps/subsystems mapped to their SourceOS replacement, owning repo, the SociOS superiority (why it's a superset not a clone), the E1-E12 IDs it draws on, third-party deps vs stock macOS, and an honest status (spec/partial/built/gap/hw). Plus a hardware-gap register: the four places Apple silicon wins (Neural Engine, Secure Enclave, HW codecs, display pipeline) that spec cannot close on Asahi — stated honestly so nothing is over-promised. The census makes the feature-gaps-zero campaign tractable: every gap/partial row is a work item; a row is 'built' only when agent-native + accessible-by-default + its seam's purple-team test passes. * spec(macos): complete the long tail (Contacts/Reminders/Maps/Weather/Passwords/ScreenTime/Disk/FaceTime/AirPlay/…) — ~37 surfaces total * spec(E11): consent & receipts UX design (campaign gap #2) + clickable prototype; cross-link census * spec(E3): personal mesh transport (Continuity/Handoff/AirDrop/AirPlay parity, campaign gap #3); fix census owner attribution * docs(surfaces): canonical truthful surfaces + doctrine (diagram-is-a-witness) Replaces garbled DALL-E renders with reproducible HTML/SVG: holography+ghostspace framework poster (Tier 1), B11 life-mirror automaton + E11 consent/receipts (Tier 2). Adds the surfaces doctrine (3 tiers; instruments must not lie). * docs(surfaces): lampstand semantic launcher + turn-witness (Godel/consistency/conclusions); canonical sourceos.tokens.css from source Validates surface style against the OS: tokens extracted from source-os/website + GNOME workstation-v0 (Cantarell, color-scheme honored). Turn-witness proves well-formed != admissible via real BigInt Godel numbering + teeth'd consistency checks. * docs(surfaces): Tier-1 genesis braid + install + flywheel diagrams (first theme); set house theme in tokens Completes Tier-1 architecture set in the chosen first-theme (B11 instrument) palette. Correct equations. tokens.css now documents OS base + first-theme house layer. * docs(surfaces): reflow holography/turn-witness/e11 onto the first theme (house style) lampstand kept faithful-light to match the real SociOS Albert launcher screenshot. --------- Co-authored-by: Michael Heller <mdheller314@icloud.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Clarifies that this repo is the canonical typed-contract / JSON-LD / shared vocabulary lane for the SourceOS / AgentOS topology.
Why
The repo already contains semantic overlay language, but the broader topology fit was implicit. This change makes it explicit from the README so adjacent repos can point here as the canonical semantic lane.