---
generated: 2026-05-10T18:47:00Z
sf_version: 2.75.3
---

# SF — Singularity Forge

**What it does:** Autonomous repo operator built on Pi SDK. Takes bounded intent, applies PDD/TDD gates, executes milestones/slices/tasks with self-healing recovery, and produces verified software.

**Core value:** Purpose-to-software compiler — not a generic coding assistant. Every unit must name its purpose, consumer, and falsifiable contract before implementation.

**Current state:** Active. DB healthy. M001-6377a4 in progress — S01 (doctrine alignment) and S02 (runaway guard + gap-audit) complete. S03 (deepen reliability / verification evidence) is next.

**Architecture:** TypeScript monorepo (7 workspace packages), Rust N-API engine, Next.js web frontend, Pi SDK harness. Extension source at `src/resources/extensions/sf/` compiled to `dist/resources/extensions/sf/`.

## Milestone Sequence

- [x] **M001-3hf5k0**: DB Recovery and S01-T01 Execution — complete
- [ ] **M001-6377a4**: M001 Roadmap — stabilize core doctrine, sharpen execution, deepen reliability, keep surfaces coherent, prepare ACE convergence
  - [x] S01 — Doctrine alignment (CLI/help surfaces)
  - [x] S02 — Runaway guard + gap-audit cleanup
  - [ ] S03 — Deepen reliability / verification evidence (T02–T04 pending)
  - [ ] S04 — Keep product surfaces coherent
  - [ ] S05 — Prepare ACE convergence deliberately

## Key Verification Commands

```bash
# Run full test suite
npm run test

# Build core
npm run build:core

# Type check extensions
npm run typecheck:extensions

# Lint
npm run lint

# Rust checks
for d in "rust-engine" "rust-engine/crates/ast" "rust-engine/crates/engine" "rust-engine/crates/grep"; do
  (cd "$d" && cargo check && cargo test -- --test-threads=2 && cargo clippy -- -D warnings)
done
```
