Forge is a Rust workspace implementing a spec-first software factory stack centered on Attractor-style orchestration.

Upstream spec references:

• Attractor ecosystem source: https://github.com/strongdm/attractor
• Factory vision: https://factory.strongdm.ai/

• forge-llm (crates/forge-llm): unified multi-provider LLM client (spec/01-unified-llm-spec.md).
• forge-agent (crates/forge-agent): coding-agent loop (spec/02-coding-agent-loop-spec.md).
• forge-attractor (crates/forge-attractor): DOT pipeline parser/runtime (spec/03-attractor-spec.md).
• forge-cli (crates/forge-cli): in-process CLI host for running/resuming/inspecting Attractor pipelines.
• forge-cxdb-runtime (crates/forge-cxdb-runtime): CXDB runtime and host integration contracts (binary/HTTP clients, runtime store, deterministic fake).

• spec/01 and spec/02 core layers are implemented with deterministic test coverage.
• spec/03 Attractor runtime core, host surfaces, and conformance suites are implemented for headless and CLI-first operation.
• spec/04 adopts CXDB-first persistence architecture

cargo build

# Full workspace
cargo test

# Targeted crates
cargo test -p forge-llm
cargo test -p forge-agent
cargo test -p forge-attractor --tests
cargo test -p forge-cli --tests
cargo test -p forge-cxdb-runtime

Optional live-provider tests remain ignored by default and require credentials.

RUN_LIVE_OPENAI_TESTS=1 cargo test -p forge-llm --test openai_live -- --ignored
RUN_LIVE_ANTHROPIC_TESTS=1 cargo test -p forge-llm --test anthropic_live -- --ignored

# Run from DOT file
cargo run -p forge-cli -- run --dot-file examples/01-linear-foundation.dot --backend mock

# Resume from checkpoint
cargo run -p forge-cli -- resume --dot-file examples/01-linear-foundation.dot --checkpoint /path/to/checkpoint.json --backend mock

# Inspect checkpoint
cargo run -p forge-cli -- inspect-checkpoint --checkpoint /path/to/checkpoint.json --json

• spec/: source-of-truth specifications
• roadmap/: milestone plans and completion tracking
• examples/: sample DOT graphs
• crates/forge-llm/, crates/forge-agent/, crates/forge-attractor/, crates/forge-cli/, crates/forge-cxdb-runtime/, crates/forge-cxdb/

See CONTRIBUTING.md and AGENTS.md for coding standards, test expectations, and spec-alignment requirements.