Repository map

Ledger · source keeperI remember the exact starting point so the next change belongs to the same app. Where each product, protocol, service, contract, and compatibility responsibility lives.

Ask with AI

Authority first

protocol/ — normative bytes and verification law.
docs/adr/ — accepted architecture/product decisions.
MASTER_PROMPT.md — historical v0.7 implementation input, not current authority.
genome/LAWS.md — historical planning law retained for verification compatibility.
docs/STATE.md — current shipped/inactive/deferred snapshot.

Product and private loop

Path	Responsibility
`macos/Tohseno/`	Native SwiftUI Mac app, factory client, packaging and product tests
`companion/apple/TohsenoCompanion/`	Native iPhone Companion product
`sdk/apple/TohsenoCompanionKit/`	Swift private wire, crypto, storage and client SDK
`companion/`	Rust private wire, pairing, capability, envelope and vectors
`packages/cli/`	`menloapp` npm launcher, GitHub deployment, listing metadata, previews, version links and source-review commands
`cli/`	CLI, loopback Workspace Service, LaunchAgent lifecycle and Companion coordinator
`application/`	Command admission, journals, idempotency, presentation, factory lease and execution manager
`engine/`	Shot lifecycle, source materialization, harness and deterministic gates
`studio/`	Retained thin loopback UI; deleted dashboard features stay deleted

Apple materialization

Path	Responsibility
`apple-identity/`	Apple identity support and tests
`fascia/apple/`	Reusable Apple Fascia, capability definitions and Swift package
`fixtures/`	Cross-surface presentation and deterministic fixtures
`oneshot/`	Canonical installer source retained under release gates

Public network

Path	Responsibility
`protocol/`	Neutral public records, exact encodings and conformance
`contracts/`	BuilderAccountFactory, BuilderAccount, ShotRegistry and additive Claims contract
`network/`	Catalog, sanitized-source, recipient, Claim and public-network logic
`node/`	Public action validation/storage and rebuildable indexes
`website/apps/companion-relay/`	Content-blind private mailbox transport
`website/apps/site/`	Public GitHub directory, app/version pages, source reviews, plus retained Registry/Claims, managed compute and web handoff
`release/`	Immutable activation/readiness/evidence records

Documentation site

website/docs-pages/ is the standalone Astro Starlight site for docs.menloapp.lol. It owns the familiar documentation shell, Pagefind search, quiet character guides, per-page AI handoff, and generated llms.txt corpus. The main website’s /docs route redirects here; its older static tutorial is excluded from this build.

Historical and compatibility material

history/, frozen tags, legacy schemas, recording-layer files, MASTER_PROMPT.md, and old readable execution variants remain for byte compatibility and audit. Their presence does not make them active product architecture. In particular, readable names such as Conception do not authorize a new Conception phase.