singularity-forge/.sf/PROJECT.md

generated	sf_version
2026-05-10T03:56:00Z	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: BLOCKED. SQLite DB (.sf/sf.db) is malformed (corrupted). DB backup exists at .sf/backups/db/sf.db.2026-05-10T02-42-23-822Z. This milestone recovers the DB and executes the highest-value pending task from the recovered roadmap.

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

• M001-3hf5k0: DB Recovery and S01-T01 Execution — recover corrupted DB, execute CLI/help doctrine fix
• M001-6377a4 (pending, recovered from backup): M001 Roadmap — stabilize core doctrine, sharpen execution, deepen reliability, keep surfaces coherent, prepare ACE convergence

Key Verification Commands

# 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