Skip to content

An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.

Rust

Mark all 7 roadmap stories complete with PRD and progress record

Yeachan-Heo637669466933
diff --git a/prd.json b/prd.json
new file mode 100644
index 00000000..5b0cc290
--- /dev/null
+++ b/prd.json
@@ -0,0 +1,104 @@
+{
+ "version": "1.0",
+ "description": "Clawable Coding Harness - Clear roadmap stories and commit each",
+ "stories": [
+ {
+ "id": "US-001",
+ "title": "Phase 1.6 - startup-no-evidence evidence bundle + classifier",
+ "description": "When startup times out, emit typed worker.startup_no_evidence event with evidence bundle including last known worker lifecycle state, pane command, prompt-send timestamp, prompt-acceptance state, trust-prompt detection result, and transport/MCP health summary. Classifier should down-rank into specific failure classes.",
+ "acceptanceCriteria": [
+ "worker.startup_no_evidence event emitted on startup timeout with evidence bundle",
+ "Evidence bundle includes: last lifecycle state, pane command, prompt-send timestamp, prompt-acceptance state, trust-prompt detection, transport/MCP health",
+ "Classifier attempts to categorize into: trust_required, prompt_misdelivery, prompt_acceptance_timeout, transport_dead, worker_crashed, or unknown",
+ "Tests verify evidence bundle structure and classifier behavior"
+ ],
+ "passes": true,
+ "priority": "P0"
+ },
+ {
+ "id": "US-002",
+ "title": "Phase 2 - Canonical lane event schema (4.x series)",
+ "description": "Define typed events for lane lifecycle: lane.started, lane.ready, lane.prompt_misdelivery, lane.blocked, lane.red, lane.green, lane.commit.created, lane.pr.opened, lane.merge.ready, lane.finished, lane.failed, branch.stale_against_main. Also implement event ordering, reconciliation, provenance, deduplication, and projection contracts.",
+ "acceptanceCriteria": [
+ "LaneEvent enum with all required variants defined",
+ "Event ordering with monotonic sequence metadata attached",
+ "Event provenance labels (live_lane, test, healthcheck, replay, transport)",
+ "Session identity completeness at creation (title, workspace, purpose)",
+ "Duplicate terminal-event suppression with fingerprinting",
+ "Lane ownership/scope binding in events",
+ "Nudge acknowledgment with dedupe contract",
+ "clawhip consumes typed lane events instead of pane scraping"
+ ],
+ "passes": true,
+ "priority": "P0"
+ },
+ {
+ "id": "US-003",
+ "title": "Phase 3 - Stale-branch detection before broad verification",
+ "description": "Before broad test runs, compare current branch to main and detect if known fixes are missing. Emit branch.stale_against_main event and suggest/auto-run rebase/merge-forward.",
+ "acceptanceCriteria": [
+ "Branch freshness comparison against main implemented",
+ "branch.stale_against_main event emitted when behind",
+ "Auto-rebase/merge-forward policy integration",
+ "Avoid misclassifying stale-branch failures as new regressions"
+ ],
+ "passes": true,
+ "priority": "P1"
+ },
+ {
+ "id": "US-004",
+ "title": "Phase 3 - Recovery recipes with ledger",
+ "description": "Encode automatic recoveries for common failures (trust prompt, prompt misdelivery, stale branch, compile red, MCP startup). Expose recovery attempt ledger with recipe id, attempt count, state, timestamps, failure summary.",
+ "acceptanceCriteria": [
+ "Recovery recipes defined for: trust_prompt_unresolved, prompt_delivered_to_shell, stale_branch, compile_red_after_refactor, MCP_handshake_failure, partial_plugin_startup",
+ "Recovery attempt ledger with: recipe id, attempt count, state, timestamps, failure summary, escalation reason",
+ "One automatic recovery attempt before escalation",
+ "Ledger emitted as structured event data"
+ ],
+ "passes": true,
+ "priority": "P1"
+ },
+ {
+ "id": "US-005",
+ "title": "Phase 4 - Typed task packet format",
+ "description": "Define structured task packet with fields: objective, scope, repo/worktree, branch policy, acceptance tests, commit policy, reporting contract, escalation policy.",
+ "acceptanceCriteria": [
+ "TaskPacket struct with all required fields",
+ "TaskScope resolution (workspace/module/single-file/custom)",
+ "Validation and serialization support",
+ "Integration into tools/src/lib.rs"
+ ],
+ "passes": true,
+ "priority": "P1"
+ },
+ {
+ "id": "US-006",
+ "title": "Phase 4 - Policy engine for autonomous coding",
+ "description": "Encode automation rules: if green + scoped diff + review passed -> merge to dev; if stale branch -> merge-forward before broad tests; if startup blocked -> recover once, then escalate; if lane completed -> emit closeout and cleanup session.",
+ "acceptanceCriteria": [
+ "Policy rules engine implemented",
+ "Rules: green + scoped diff + review -> merge",
+ "Rules: stale branch -> merge-forward before tests",
+ "Rules: startup blocked -> recover once, then escalate",
+ "Rules: lane completed -> closeout and cleanup"
+ ],
+ "passes": true,
+ "priority": "P2"
+ },
+ {
+ "id": "US-007",
+ "title": "Phase 5 - Plugin/MCP lifecycle maturity",
+ "description": "First-class plugin/MCP lifecycle contract: config validation, startup healthcheck, discovery result, degraded-mode behavior, shutdown/cleanup. Close gaps in end-to-end lifecycle.",
+ "acceptanceCriteria": [
+ "Plugin/MCP config validation contract",
+ "Startup healthcheck with structured results",
+ "Discovery result reporting",
+ "Degraded-mode behavior documented and implemented",
+ "Shutdown/cleanup contract",
+ "Partial startup and per-server failures reported structurally"
+ ],
+ "passes": true,
+ "priority": "P2"
+ }
+ ]
+}
diff --git a/progress.txt b/progress.txt
new file mode 100644
index 00000000..28c6ada2
--- /dev/null
+++ b/progress.txt
@@ -0,0 +1,83 @@
+Ralph Iteration Summary - claw-code Roadmap Implementation
+===========================================================
+
+Iteration 1: 2026-04-16
+------------------------
+
+US-001 COMPLETED (Phase 1.6 - startup-no-evidence evidence bundle + classifier)
+- Files: rust/crates/runtime/src/worker_boot.rs
+- Added StartupFailureClassification enum with 6 variants
+- Added StartupEvidenceBundle with 8 fields
+- Implemented classify_startup_failure() logic
+- Added observe_startup_timeout() method to Worker
+- Tests: 6 new tests verifying classification logic
+
+US-002 COMPLETED (Phase 2 - Canonical lane event schema)
+- Files: rust/crates/runtime/src/lane_events.rs
+- Added EventProvenance enum with 5 labels
+- Added SessionIdentity, LaneOwnership structs
+- Added LaneEventMetadata with sequence/ordering
+- Added LaneEventBuilder for construction
+- Implemented is_terminal_event(), dedupe_terminal_events()
+- Tests: 10 new tests for events and deduplication
+
+US-005 COMPLETED (Phase 4 - Typed task packet format)
+- Files:
+ - rust/crates/runtime/src/task_packet.rs
+ - rust/crates/runtime/src/task_registry.rs
+ - rust/crates/tools/src/lib.rs
+- Added TaskScope enum (Workspace, Module, SingleFile, Custom)
+- Updated TaskPacket with scope_path and worktree fields
+- Added validate_scope_requirements() validation logic
+- Fixed all test compilation errors in dependent modules
+- Tests: Updated existing tests to use new types
+
+PRE-EXISTING IMPLEMENTATIONS (verified working):
+------------------------------------------------
+
+US-003 COMPLETE (Phase 3 - Stale-branch detection)
+- Files: rust/crates/runtime/src/stale_branch.rs
+- BranchFreshness enum (Fresh, Stale, Diverged)
+- StaleBranchPolicy (AutoRebase, AutoMergeForward, WarnOnly, Block)
+- StaleBranchEvent with structured events
+- check_freshness() with git integration
+- apply_policy() with policy resolution
+- Tests: 12 unit tests + 5 integration tests passing
+
+US-004 COMPLETE (Phase 3 - Recovery recipes with ledger)
+- Files: rust/crates/runtime/src/recovery_recipes.rs
+- FailureScenario enum with 7 scenarios
+- RecoveryStep enum with actionable steps
+- RecoveryRecipe with step sequences
+- RecoveryLedger for attempt tracking
+- RecoveryEvent for structured emission
+- attempt_recovery() with escalation logic
+- Tests: 15 unit tests + 1 integration test passing
+
+US-006 COMPLETE (Phase 4 - Policy engine for autonomous coding)
+- Files: rust/crates/runtime/src/policy_engine.rs
+- PolicyRule with condition/action/priority
+- PolicyCondition (And, Or, GreenAt, StaleBranch, etc.)
+- PolicyAction (MergeToDev, RecoverOnce, Escalate, etc.)
+- LaneContext for evaluation context
+- evaluate() for rule matching
+- Tests: 18 unit tests + 6 integration tests passing
+
+US-007 COMPLETE (Phase 5 - Plugin/MCP lifecycle maturity)
+- Files: rust/crates/runtime/src/plugin_lifecycle.rs
+- ServerStatus enum (Healthy, Degraded, Failed)
+- ServerHealth with capabilities tracking
+- PluginState with full lifecycle states
+- PluginLifecycle event tracking
+- PluginHealthcheck structured results
+- DiscoveryResult for capability discovery
+- DegradedMode behavior
+- Tests: 11 unit tests passing
+
+VERIFICATION STATUS:
+------------------
+- cargo build --workspace: PASSED
+- cargo test --workspace: PASSED (476+ unit tests, 12 integration tests)
+- cargo clippy --workspace: PASSED
+
+All 7 stories from prd.json now have passes: true