How open-worker-2077/atom works
Atom is an executable, evolving fact world: people, Agents, and Programs read and change shared facts through Web or CLI interactions. The principal path is an interaction entering the shared world service, executing Program logic when requested, and committing changes to durable world state; projections and spatial views make that state observable and editable. The README documents the product boundary and capabilities. Source excerpts and the index support several internal calls, but many Web, spatial, and persistence connections are documented only at a high level, so those links are omitted or marked unverified.
Main entry points: browser-entry.mjs Web entry · legacy-engine-adapter.mjs Engine adapter · engine.mjs Atom engine · world-service.mjs World service
Components 23
Interaction
- Web entry
src/atom-system/browser-entry.mjs - CLI interface
cli/lib/cli-app.mjs - Command mapper
src/atom-system/browser-command-mapper.mjs - World service
src/atom-system/public/world-service.mjs - Engine adapter
src/atom-system/adapters/legacy-engine-adapter.mjs
World runtime
- World facts
work-engine/atom-language/context-store.mjs - JSON world repository
src/atom-system/adapters/json-world-repository.mjs - Transactional persistence
src/atom-system/adapters/transactional-world-persistence.mjs - Durable save worker
src/atom-system/adapters/durable-world-save-worker.mjs - World revisions
src/atom-system/world-runtime/world-revision.mjs - Commit coordinator
src/atom-system/world-runtime/commit-coordinator.mjs - Projection pipeline
src/atom-system/projections/projection-pipeline.mjs
Program runtime
- Atom engine
work-engine/atom-language/engine.mjs - Program definitions
work-engine/atom-language/program.mjs - Query capability
work-engine/atom-language/query-capability.mjs - Transform executor
work-engine/atom-language/transform-executor.mjs - Key parser
work-engine/atom-language/key-parser.mjs
Spatial experience
- Scene adapter
src/atom-system/adapters/browser-scene-adapter.mjs - Spatial engine
spatial-engine.js - Cluster field
spatial-cluster-field.js - View state
src/atom-system/spatial-experience/view-state-repository.mjs - Presentation settings
src/atom-system/spatial-experience/presentation-settings-service.mjs
Other components
- People / Agents
Connections 21
- People / Agents → Web entry: uses
README.md - People / Agents → CLI interface: uses
README.md - Web entry → World service: interacts through
- CLI interface → World service: shares world
README.md - Web entry → Command mapper: maps commands
- World service → Engine adapter: delegates execution
src/atom-system/adapters/legacy-engine-adapter.mjs - Engine adapter → Atom engine: executes
src/atom-system/adapters/legacy-engine-adapter.mjs - Atom engine → Query capability: queries
work-engine/atom-language/engine.mjs - Atom engine → Transform executor: applies transforms
work-engine/atom-language/engine.mjs - Program definitions → Transform executor: applies transforms
work-engine/atom-language/program.mjs - Key parser → World facts: validates keys
work-engine/atom-language/context-store.mjs - Engine adapter → Transactional persistence: creates persistence
src/atom-system/adapters/legacy-engine-adapter.mjs - Transactional persistence → JSON world repository: persists world
- Durable save worker → JSON world repository: writes durable state
src/atom-system/adapters/durable-world-save-worker.mjs - Durable save worker → Commit coordinator: coordinates commits
src/atom-system/adapters/durable-world-save-worker.mjs - JSON world repository → World revisions: checks revisions
src/atom-system/adapters/json-world-repository.mjs - World facts → World revisions: derives revision
work-engine/atom-language/context-store.mjs - Projection pipeline → World facts: projects facts
- Scene adapter → Spatial engine: adapts scene
- Spatial engine → Cluster field: renders clusters
- Presentation settings → View state: configures views