01 / capability
CLI + harness
The command surface turns plain-language objectives into named workflow runs and exposes status, attach, connect, send, interrupt, pause, resume, quit, and reload controls.
Capability map / traceability first
Every promise has a path.
Atomic is easiest to understand as a set of executable contracts. These cards name the contract, describe the observed behavior, and link directly to the source files that own it.
02 / capability
Graph execution
Typed workflow definitions become a dependency graph. Sequential, parallel, nested, prompt, and tool nodes are rendered and scheduled with explicit stage boundaries.
03 / capability
Durability
DBOS-backed state and checkpoint envelopes preserve run/stage topology, outputs, timings, prompts, and replay decisions across process boundaries where the backend is available.
04 / capability
Sessions + process controls
Atomic stores JSONL session trees, binds stage sessions to workflow metadata, and uses RPC/interactive controls to interrupt, pause queues, resume, or quit without silently creating a new conversation.
05 / capability
Artifacts + receipts
Large handoffs are file-backed artifacts. Goal and Ralph persist ledgers, review rounds, reports, and evidence paths so downstream stages read a stable artifact instead of an inflated prompt.
06 / capability
Steering + Intercom
Queue modes distinguish steering from follow-up, while Intercom brokers parent/child results and supervisor authorization with bounded delivery and reply tracking.
07 / capability
Tools + verification
Tool admission, structured outputs, model fallback, tests, and lifecycle notices keep completion evidence separate from model narration.
08 / capability
Tests + contracts
Focused suites cover runtime controls, paused queues, durable resume, artifacts, graph topology, RPC, and workflow stage behavior; CI documents ordering and native-build boundaries.
Improvement plan traceability
These are intentionally plans, not unimplemented claims. Each one is anchored to exact current Atomic files so an Atomic++ implementation can be reviewed against the runtime it extends.
| Plan | Current Atomic anchors | Atomic++ direction |
|---|---|---|
| Transport adapters | packages/coding-agent/src/modes/rpc/rpc-types.ts packages/coding-agent/src/modes/rpc/rpc-command-handler.ts packages/intercom/types.ts | Normalize Telegram, Slack, GitHub events into a versioned envelope, then route to a workflow or stage without coupling transport code to the executor. |
| Durable delivery | packages/workflows/src/durable/backend.ts packages/workflows/src/durable/dbos-envelope.ts packages/workflows/src/shared/persistence-session-entries.ts | Persist inbound event IDs, delivery attempts, run IDs, and response receipts beside workflow checkpoints; replay is explicit and idempotent. |
| Human control | packages/workflows/src/extension/workflow-run-control-command.ts packages/workflows/src/runs/background/quit.ts packages/workflows/src/durable/resume-runtime.ts | Expose status, pause, resume, interrupt, and quit as authenticated adapter actions with the same state transition rules as the CLI. |
| Grok compatibility | packages/intercom/broker/client-message-validation.ts packages/intercom/broker/supervisor-channel.ts packages/coding-agent/src/core/agent-session-message-queue.ts | Keep useful bridge patterns—polling, concise routing, thread/reply context, retries, and safe action parsing—while replacing process-local assumptions with signed, durable, transport-neutral events. |
Usage & cost in the capability map
The coding-agent session layer already exposes provider usage and configured cost totals; workflow model-attempt metadata only permits optional usage today, and the foreground controller does not populate it. A future ledger should attach reported metrics to the stage attempt without turning compaction estimates or model-rate configuration into provider claims.
packages/coding-agent/src/core/agent-session-export.ts#L14-L101 packages/coding-agent/src/core/agent-session-types.ts#L192-L209 packages/coding-agent/src/core/usage-totals.ts#L4-L59 packages/coding-agent/docs/extensions.md#ctx-getcontextusage packages/workflows/src/shared/authoring-contract-stage.ts#L82-L97 packages/workflows/src/durable/dbos-envelope.ts#L447-L482 packages/workflows/src/runs/foreground/stage-runner-controller.ts#L445-L455 packages/workflows/src/runs/foreground/stage-runner-controller.ts#L1236-L1265