Reframe UCF around persistent machine operation

[sinethxyz]

Reframes UCF around the systems problem that originally motivated the Foundry implementation: maintaining coherent machine operation across changing state.

Documentation

• rewrites the README around state transitions, evidence, verification, continuity, and replaceable intelligence
• preserves Unicorn/Foundry as historical origin rather than the active purpose
• adds RETROSPECTIVE.md and a runtime decoupling audit
• separates the generalized UCF repository map from the explicitly historical Foundry runtime
• keeps the original docs/architecture.md and Git history intact
• explicitly avoids claiming a learned world model or retroactively rewriting the original work

Runtime foundation

• adds an IntelligenceProvider protocol; Claude remains the backwards-compatible default
• removes the Unicorn-only restriction from TaskRequest.repo
• adds an ExecutionEnvironment boundary and Git worktree adapter
• adds provider-neutral state/evidence/action/verification/outcome contracts
• adds a parallel TransitionEngine for state -> action -> observation -> verification -> outcome
• adds a TransitionJournal boundary so verified outcomes survive the call
• adds non-Unicorn tests using fake environment/planner/executor/verifier/journal components

Historical runtime repairs exposed by CI

• declares Hatch package selection so editable installs work
• declares aiosqlite for the existing async-SQLite tests
• normalizes the historical review-completion event contract
• cleans pre-existing run_engine lint debt

Deliberately not migrated yet

The historical RunEngine, PR terminal state, coding-specific prompts, Go/TypeScript verification, persistence naming, and other Foundry internals remain intact. The new transition runtime is a parallel foundation; the next phase is to adapt the historical Git/Claude path onto it.

Verification

Current head is green in GitHub Actions:

• editable install: pass
• compileall: pass
• Ruff targeted boundary/runtime lint: pass
• UCF foundation tests: 16 passed
• full legacy regression suite: 490 passed