Each top-level ledger has one job:
- GitHub issues: current behavior, known gaps and open work
- ROADMAP.md: future direction
- elastos/CHANGELOG.md: released history
- PRINCIPLES.md: decision constraints
- Repository README: quick install, source build, and system model
- Runtime overview: product and repository orientation
- Getting started: user installation and source development
- Local source Home setup: source-home browser Home on one machine
- Installing ElastOS: Linux setup, update, and trust
- Windows strategy: WSL-first host direction and later native adapters
- Glossary: canonical terminology
- ElastOS system map: layered C4 and code paths for people and agents
- Architecture: responsibility, authority, and isolation boundaries
- Human and agent architecture: principal parity, profiles, Agent Host capsules, delegation, and provider effects
- Capsule model: artifact, Runtime contract, instance, state, and head
- Namespaces:
localhost://,elastos://, and principal roots - Carrier: endpoint-authenticated communication and content transport
- Private network: signed membership, named services, optional IP compatibility, Exit, and LAN Gateway policy
- Consequence-aware effects: shared observation, actuation, settlement, and local-safety rules
- Content availability: CID, IPLD, availability, and replication
- Storage, ownership, and access: encrypted storage, protected use, sharing, groups, devices, agents, revocation, and recovery
- Content capsule distribution: games, models, Get, bootstrap sources, and external gateways
- People and conversations: profiles, contacts, discovery, and current Chat integration
- Collaboration network profile: private collaboration routes and authority
- Design system: first-party visual and interaction contract
- Principles: normative authority constraints
- ESP v0: shell-facing Runtime facts and intents
- Shell/ESP boundary map: placement rules for Runtime, providers, shells, and shared projection code
- Capsule interface contract: web, CLI, fact, gate, and audit projections
- Home shell host contract: sign-in, shell lifecycle, and child intents
- Interactive runtime contract: interactive sessions and return behavior
- Execution: release execution boundaries
- Command runtime matrix: Runtime ownership for every command
- Authentication audit chain: activation and retention rules for the signed audit chain
- Capsule Inspector: live facts and gate preview; Inbox owns approval and Runtime owns dispatch
- Capsule authoring: supported roles, ABI, Bus, manifests, and verification
- Capsule templates: checked-in starting points
- ElastOS Bus WIT: executable Component interface
- Peer resource contract: peer bootstrap, topic membership, gossip operations, and trust limits
- Model provider: provider and model selection, streams, cancellation, recovery, and terminal outcomes
- Chain provider: typed chain reads, proofs, and transactions
- Wallet provider: account, proof, approval, and signing authority
- Protected content: sealed object access sequence
- Object protection implementation: replaceable dKMS/dDRM boundary, migration rules, delivery slices, and acceptance
- Protected-content v1 contracts: canonical identity, rights, custody and release schemas
- Rights provider: canonical role and provisional capsule retirement state
- Key provider: provisional provider retirement notice
- Decrypt provider: canonical role and provisional capsule retirement state
- Archive policy: archive dependencies and family enablement
- Browser capsule: Browser, Net, Exit, and Engine contract
- Browser protocol: typed Browser operations
- Browser support: target and operator support matrix
- Browser acceptance: B01–B16 product criteria
- Browser VM target: VM guest, helper, media, and target maintenance
- Browser provider acceptance: shared candidate gates; current status comes from generated evidence
- Source integration and release acceptance: source, installed-product, and release decision checklist
- Home journey audit: privacy-reviewed workbook with findings, coverage and the limits of its installed test evidence
- Collaboration handoff: dated integration evidence
- Mac source-home staging: Apple silicon staging and Browser acceptance
- Inspector testing: local Inspector checks
- Sites: local site roots and public exposure
- Scripts: build, proof, release, and operator commands
- Debugging: developer diagnostics
- Security: reporting policy and verified security findings
- Runtime versioning: release version policy
- Share versioning: immutable revisions and mutable heads