@nathapp/nax 0.28.0 → 0.30.0

package/nax/features/routing-persistence/prd.json

@@ -1,104 +0,0 @@
-{
-  "project": "nax-routing-persistence",
-  "branchName": "feat/routing-persistence",
-  "feature": "routing-persistence",
-  "userStories": [
-    {
-      "id": "RRP-001",
-      "title": "Persist initial routing to prd.json on first classification",
-      "description": "Currently, when nax run classifies a story for the first time (no prior nax analyze, story.routing is undefined), the result lives only in ctx.routing (in-memory). If the run crashes and resumes, the routing stage re-classifies fresh — LLM may return different complexity/testStrategy, causing silent inconsistency mid-feature. Fix: after fresh classification in routing.ts, write the result back to prd.json via savePRD so story.routing is populated from the very first iteration.",
-      "acceptanceCriteria": [
-        "When story.routing is undefined before routing stage, after classification story.routing is written to prd.json",
-        "Subsequent iterations (or resume after crash) use the persisted story.routing — no re-classification",
-        "Escalation still overwrites modelTier and testStrategy as before — only initialComplexity is protected",
-        "savePRD is called once per story on first classification (not on every iteration if already persisted)",
-        "Unit tests verify prd.json is updated after first routing stage execution"
-      ],
-      "complexity": "medium",
-      "status": "passed",
-      "tags": [],
-      "dependencies": [],
-      "escalations": [],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "storyPoints": 1,
-      "passes": true
-    },
-    {
-      "id": "RRP-002",
-      "title": "Add initialComplexity to StoryRouting and StoryMetrics for accurate reporting",
-      "description": "StoryMetrics.complexity currently captures ctx.routing.complexity at completion time — which may reflect a post-escalation re-classification, not the original prediction. Add story.routing.initialComplexity (written once at first classify, never overwritten) and StoryMetrics.initialComplexity. Update metrics/aggregator.ts complexityAccuracy to compare initialComplexity vs finalTier instead of current complexity vs finalTier.",
-      "acceptanceCriteria": [
-        "StoryRouting interface gains initialComplexity?: Complexity field",
-        "Routing stage writes initialComplexity when story.routing is first created (RRP-001 path)",
-        "Escalation path never overwrites initialComplexity — only modelTier and testStrategy change",
-        "StoryMetrics gains initialComplexity?: string field",
-        "collectStoryMetrics() reads initialComplexity from story.routing.initialComplexity (falls back to routing.complexity for backward compat)",
-        "metrics/aggregator.ts complexityAccuracy uses initialComplexity for predicted vs finalTier comparison",
-        "Unit tests verify initialComplexity is set on first classify and unchanged after escalation"
-      ],
-      "complexity": "medium",
-      "status": "pending",
-      "tags": [],
-      "dependencies": [
-        "RRP-001"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "RRP-003",
-      "title": "Add contentHash to StoryRouting for staleness detection (BUG-048)",
-      "description": "When nax analyze is run, it writes story.routing to prd.json. If the story is subsequently edited (more ACs, changed tags, updated description), nax run blindly trusts the existing routing — wrong complexity, wrong testStrategy. Fix: add story.routing.contentHash — a hash of title+description+acceptanceCriteria.join()+tags.join() written at classify time. Routing stage recomputes hash on each run; if mismatch, treat as cache miss and re-classify.",
-      "acceptanceCriteria": [
-        "StoryRouting interface gains contentHash?: string field",
-        "A helper function computeStoryContentHash(story: UserStory): string computes a hash of title+description+ACs+tags",
-        "Routing stage: if story.routing exists but contentHash is missing or mismatches current story content, re-classify (treat as cache miss)",
-        "Routing stage: after classification, write contentHash to story.routing",
-        "If story content unchanged, routing stage uses cached routing as before — no regression",
-        "Unit tests cover: hash match uses cache; hash mismatch re-classifies; missing hash re-classifies"
-      ],
-      "complexity": "medium",
-      "status": "pending",
-      "tags": [],
-      "dependencies": [
-        "RRP-001"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "RRP-004",
-      "title": "Integration tests: routing persistence across simulated crash-resume and staleness",
-      "description": "Write integration tests that verify routing persistence end-to-end: (1) first run classifies and persists story.routing to prd.json, (2) second run uses persisted routing without re-classifying, (3) escalation preserves initialComplexity, (4) story content change triggers re-classification via contentHash mismatch.",
-      "acceptanceCriteria": [
-        "Integration test: routing stage with story.routing=undefined writes story.routing to prd.json after classification",
-        "Integration test: routing stage re-run with same prd.json uses cached routing — no LLM call made",
-        "Integration test: escalation updates modelTier in prd.json but initialComplexity remains unchanged",
-        "Integration test: edit story content after routing — hash mismatch detected — routing stage re-classifies",
-        "Integration test: story.routing with matching contentHash — no re-classification (cache hit confirmed)"
-      ],
-      "complexity": "medium",
-      "status": "pending",
-      "tags": [],
-      "dependencies": [
-        "RRP-001",
-        "RRP-002",
-        "RRP-003"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "storyPoints": 1
-    }
-  ],
-  "updatedAt": "2026-03-07T16:32:39.496Z"
-}

package/nax/features/routing-persistence/progress.txt

@@ -1 +0,0 @@
-[2026-03-07T16:32:39.495Z] RRP-001 — PASSED — Persist initial routing to prd.json on first classification — Cost: $0.5223

package/nax/features/smart-test-runner/plan.md

@@ -1,7 +0,0 @@
-# Plan: smart-test-runner
-
-## Architecture
-
-## Phases
-
-## Dependencies

package/nax/features/smart-test-runner/prd.json

@@ -1,203 +0,0 @@
-{
-  "project": "nax",
-  "feature": "smart-test-runner",
-  "branchName": "feat/v0.18.2-smart-runner",
-  "userStories": [
-    {
-      "id": "FIX-001",
-      "title": "Fix partial routing override in routing stage",
-      "description": "In `src/pipeline/stages/routing.ts`, the code unconditionally overwrites complexity and testStrategy from story.routing, even if undefined. Fix: only override when the field is actually set. Change line 41 `routing.complexity = ctx.story.routing.complexity` to `if (ctx.story.routing?.complexity) routing.complexity = ctx.story.routing.complexity`. Same for testStrategy on the next line. This allows PRD authors to set just `\"routing\": { \"testStrategy\": \"test-after\" }` without needing complexity/modelTier. Add test in `test/unit/pipeline/routing-partial-override.test.ts` verifying: (1) partial override with only testStrategy works, (2) LLM-classified complexity is preserved when not overridden, (3) full override still works.",
-      "complexity": "simple",
-      "status": "passed",
-      "tags": [
-        "bugfix"
-      ],
-      "acceptanceCriteria": [
-        "routing.complexity is only overridden when ctx.story.routing.complexity is defined",
-        "routing.testStrategy is only overridden when ctx.story.routing.testStrategy is defined",
-        "PRD with only routing.testStrategy set uses LLM for complexity",
-        "Test file test/unit/pipeline/routing-partial-override.test.ts exists with 3 passing tests"
-      ],
-      "dependencies": [],
-      "escalations": [],
-      "attempts": 1,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after"
-      },
-      "priorErrors": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-001",
-      "title": "Git diff file detection",
-      "description": "Create module `src/verification/smart-runner.ts` with exported function `getChangedSourceFiles(workdir: string): Promise<string[]>`. Runs `git diff --name-only HEAD~1` in the workdir to get changed files. Filter to only `.ts` files that start with `src/`. Use Bun.spawn for the git command. Handle git errors gracefully (return empty array on failure).",
-      "complexity": "simple",
-      "status": "passed",
-      "tags": [
-        "core"
-      ],
-      "acceptanceCriteria": [
-        "getChangedSourceFiles returns only .ts files under src/",
-        "Returns empty array when git command fails",
-        "Uses Bun.spawn (not child_process)"
-      ],
-      "dependencies": [
-        "FIX-001"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after",
-        "modelTier": "powerful"
-      },
-      "priorErrors": [
-        "REGRESSION: full-suite regression detected",
-        "Attempt 2 failed with model tier: fast",
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-002",
-      "title": "Source-to-test file mapping",
-      "description": "Add `mapSourceToTests(sourceFiles: string[], workdir: string): Promise<string[]>` to `src/verification/smart-runner.ts`. Convention: `src/foo/bar.ts` → `test/unit/foo/bar.test.ts`. Also check `test/integration/foo/bar.test.ts`. Only return paths where the file actually exists on disk (use Bun.file(path).exists()). Return empty array if no test files map.",
-      "complexity": "simple",
-      "status": "passed",
-      "tags": [
-        "core"
-      ],
-      "acceptanceCriteria": [
-        "Maps src/foo/bar.ts to test/unit/foo/bar.test.ts correctly",
-        "Also checks test/integration/ path",
-        "Only returns files that exist on disk",
-        "Returns empty array when no test files match"
-      ],
-      "dependencies": [
-        "STR-001"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after"
-      },
-      "priorErrors": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-003",
-      "title": "Smart test command builder",
-      "description": "Add `buildSmartTestCommand(testFiles: string[], baseCommand: string): string` to `src/verification/smart-runner.ts`. When testFiles is non-empty: replace the last path argument in baseCommand with the specific test file paths joined by spaces. E.g., `bun test test/` with files `[test/unit/foo.test.ts]` → `bun test test/unit/foo.test.ts`. When testFiles is empty: return the original baseCommand unchanged (full suite fallback).",
-      "complexity": "simple",
-      "status": "passed",
-      "tags": [
-        "core"
-      ],
-      "acceptanceCriteria": [
-        "Builds scoped command with specific test files",
-        "Returns original command when testFiles is empty",
-        "Works with bun test test/ base command"
-      ],
-      "dependencies": [
-        "STR-002"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after"
-      },
-      "priorErrors": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-004",
-      "title": "Smart runner config flag",
-      "description": "Add `execution.smartTestRunner: boolean` (default: true) to the config in `src/config/types.ts` (ExecutionConfig interface) and the Zod schema in `src/config/loader.ts`. When false, the verify stage skips smart runner entirely and uses the full test suite command.",
-      "complexity": "simple",
-      "status": "passed",
-      "tags": [
-        "config"
-      ],
-      "acceptanceCriteria": [
-        "execution.smartTestRunner field exists in ExecutionConfig interface",
-        "Zod schema accepts and defaults to true",
-        "Config loads correctly with and without the field"
-      ],
-      "dependencies": [
-        "STR-003"
-      ],
-      "escalations": [],
-      "attempts": 0,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after"
-      },
-      "priorErrors": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-005",
-      "title": "Integrate smart runner into verify stage",
-      "description": "Modify `src/pipeline/stages/verify.ts` to use smart runner when `ctx.config.execution.smartTestRunner` is true (default). Before calling regression(): call getChangedSourceFiles(ctx.workdir) → mapSourceToTests(files, ctx.workdir) → buildSmartTestCommand(testFiles, testCommand). Use the result as the command for regression(). Log which mode was selected: `[smart-runner] Running N targeted test files` or `[smart-runner] No mapped tests — falling back to full suite`.",
-      "complexity": "medium",
-      "status": "passed",
-      "tags": [
-        "integration"
-      ],
-      "acceptanceCriteria": [
-        "Verify stage uses scoped test command when smart runner finds test files",
-        "Falls back to full suite when no test files map",
-        "Skips smart runner entirely when config.execution.smartTestRunner is false",
-        "Logs the mode used"
-      ],
-      "dependencies": [
-        "STR-004"
-      ],
-      "escalations": [],
-      "attempts": 1,
-      "passes": true,
-      "routing": {
-        "testStrategy": "test-after",
-        "modelTier": "powerful"
-      },
-      "priorErrors": [
-        "Attempt 1 failed with model tier: fast",
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "storyPoints": 1
-    },
-    {
-      "id": "STR-006",
-      "title": "Unit tests for smart runner module",
-      "description": "Write `test/unit/verification/smart-runner.test.ts` with tests: (1) getChangedSourceFiles filters to .ts src/ files only, (2) mapSourceToTests maps paths correctly and checks file existence, (3) mapSourceToTests returns empty when files don't exist, (4) buildSmartTestCommand builds scoped command with test files, (5) buildSmartTestCommand returns original command when testFiles is empty. Use temp dirs with Bun.write for file existence tests.",
-      "complexity": "medium",
-      "status": "failed",
-      "tags": [
-        "test"
-      ],
-      "acceptanceCriteria": [
-        "5 test cases all pass",
-        "Uses temp dirs for file existence tests",
-        "No external process spawning in unit tests (mock Bun.spawn)"
-      ],
-      "dependencies": [
-        "STR-005"
-      ],
-      "escalations": [],
-      "attempts": 1,
-      "passes": false,
-      "routing": {
-        "testStrategy": "test-after",
-        "modelTier": "powerful"
-      },
-      "priorErrors": [
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "storyPoints": 1
-    }
-  ],
-  "updatedAt": "2026-03-03T14:17:09.852Z"
-}

package/nax/features/smart-test-runner/progress.txt

@@ -1,13 +0,0 @@
-# Progress: smart-test-runner
-
-Created: 2026-03-03T11:45:10.257Z
-
----
-[2026-03-03T12:12:58.473Z] FIX-001 — FAILED — Fix partial routing override in routing stage — Review failed: test failed (exit code 132)
-[2026-03-03T12:27:31.803Z] STR-001 — PASSED — Git diff file detection — Cost: $0.0994
-[2026-03-03T12:29:37.971Z] STR-001 — FAILED — Git diff file detection -- REGRESSION: full-suite regression detected
-[2026-03-03T12:52:43.615Z] STR-002 — PASSED — Source-to-test file mapping — Cost: $0.0889
-[2026-03-03T12:59:34.497Z] STR-003 — PASSED — Smart test command builder — Cost: $0.0862
-[2026-03-03T13:05:48.251Z] STR-004 — PASSED — Smart runner config flag — Cost: $0.1583
-[2026-03-03T13:21:09.123Z] STR-005 — FAILED — Integrate smart runner into verify stage — Execution failed
-[2026-03-03T14:17:09.853Z] STR-006 — FAILED — Unit tests for smart runner module — Execution failed

package/nax/features/smart-test-runner/spec.md

@@ -1,7 +0,0 @@
-# Feature: smart-test-runner
-
-## Overview
-
-## Requirements
-
-## Acceptance Criteria

package/nax/features/smart-test-runner/tasks.md

@@ -1,8 +0,0 @@
-# Tasks: smart-test-runner
-
-## US-001: [Title]
-
-### Description
-
-### Acceptance Criteria
-- [ ] Criterion 1

package/nax/features/status-file-consolidation/prd.json

@@ -1,106 +0,0 @@
-{
-  "project": "nax",
-  "branchName": "feat/status-file-consolidation",
-  "feature": "status-file-consolidation",
-  "version": "0.22.2",
-  "description": "Auto-write status.json to well-known paths (project-level + feature-level). Remove --status-file CLI flag. Align nax status and nax diagnose readers.",
-  "userStories": [
-    {
-      "id": "SFC-001",
-      "title": "Auto-write project-level status",
-      "description": "Remove --status-file CLI option. StatusWriter always writes to <workdir>/nax/status.json automatically. In bin/nax.ts, remove --status-file option and compute statusFile = join(workdir, 'nax', 'status.json'). In runner.ts, statusFile is no longer optional. In status-writer.ts, remove the if (!this.statusFile) guard in update().",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "Running nax without --status-file flag writes nax/status.json automatically",
-        "nax/status.json contains valid NaxStatusFile schema with run.id, run.status, progress counts",
-        "--status-file CLI option no longer exists",
-        "StatusWriter.update() always writes (no no-op guard on missing statusFile)"
-      ],
-      "attempts": 0,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: fast: Review failed: test failed (exit code -1)"
-      ],
-      "priorFailures": [
-        {
-          "attempt": 1,
-          "modelTier": "fast",
-          "stage": "escalation",
-          "summary": "Failed with tier fast, escalating to next tier",
-          "timestamp": "2026-03-07T06:22:18.122Z"
-        }
-      ],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 1,
-      "routing": {
-        "complexity": "medium",
-        "modelTier": "balanced",
-        "testStrategy": "test-after",
-        "reasoning": "Straightforward refactor: remove CLI option, hardcode path computation, remove null guard across 3 files"
-      }
-    },
-    {
-      "id": "SFC-002",
-      "title": "Write feature-level status on run end",
-      "description": "On run complete/fail/crash, write the final status snapshot to <workdir>/nax/features/<feature>/status.json. Add writeFeatureStatus(featureDir) method to StatusWriter. Call it in runner.ts finally block and in crash-recovery.ts.",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "After a completed run, nax/features/<feature>/status.json exists with status 'completed'",
-        "After a failed run, nax/features/<feature>/status.json exists with status 'failed'",
-        "After a crash, nax/features/<feature>/status.json exists with status 'crashed'",
-        "Feature status.json uses the same NaxStatusFile schema as project-level"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "SFC-003",
-      "title": "Align status readers",
-      "description": "Make nax status read project-level status from nax/status.json for currently running info. Make nax diagnose read from nax/status.json instead of .nax-status.json. status-features.ts loadStatusFile() already reads <featureDir>/status.json which SFC-002 now writes — no change needed for feature-level reads.",
-      "complexity": "simple",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "nax status shows current run info from nax/status.json at the top",
-        "nax status shows per-feature historical status from nax/features/<feature>/status.json",
-        "nax diagnose reads from nax/status.json (not .nax-status.json)",
-        "No references to .nax-status.json remain in codebase"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 1
-    },
-    {
-      "id": "SFC-004",
-      "title": "Clean up dead code",
-      "description": "Remove --status-file option definition from bin/nax.ts. Remove .nax-status.json path from diagnose.ts. Remove statusFile optional from RunOptions type (now required, auto-computed). Verify no stale references remain.",
-      "complexity": "simple",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "No references to --status-file CLI option in codebase",
-        "No references to .nax-status.json in codebase",
-        "RunOptions.statusFile is required (not optional)",
-        "All existing tests pass"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 1
-    }
-  ],
-  "updatedAt": "2026-03-07T06:22:18.122Z"
-}

package/nax/features/structured-logging/prd.json

@@ -1,199 +0,0 @@
-{
-  "project": "nax",
-  "feature": "structured-logging",
-  "branchName": "feat/structured-logging",
-  "createdAt": "2026-02-27T05:50:00Z",
-  "updatedAt": "2026-02-27T08:42:37.832Z",
-  "userStories": [
-    {
-      "id": "US-001",
-      "title": "Project resolver with CWD and -d flag support",
-      "description": "Create src/commands/common.ts with resolveProject(options) function. Resolution order: 1) -d flag path, 2) CWD if it contains nax/ directory, 3) Error with helpful message. Validate: nax/ exists, nax/config.json exists. If -f flag given, validate nax/features/<name>/ exists. Return resolved {projectDir, configPath, featureDir?}. This is shared by status, logs, and future CLI commands.",
-      "acceptanceCriteria": [
-        "resolveProject() returns projectDir when CWD has nax/ directory",
-        "resolveProject({dir:\"/path\"}) uses explicit directory",
-        "Throws descriptive error when no nax/ directory found",
-        "Validates nax/config.json exists in resolved directory",
-        "When feature specified, validates nax/features/<name>/ exists",
-        "Error message lists available features when feature not found",
-        "Works with both relative and absolute -d paths"
-      ],
-      "dependencies": [],
-      "tags": [
-        "cli",
-        "resolver"
-      ],
-      "status": "passed",
-      "attempts": 2,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: balanced",
-        "Attempt 2 failed with model tier: balanced"
-      ],
-      "escalations": []
-    },
-    {
-      "id": "US-002",
-      "title": "Human-friendly logging formatter with verbosity levels",
-      "description": "Create src/logging/formatter.ts and src/logging/types.ts. Transform JSONL entries into human-readable output with emoji indicators. Support 4 modes: quiet, normal, verbose, json. Include run header, story progress with tree-style output, stage results with emoji, retry indicators, run summary footer.",
-      "acceptanceCriteria": [
-        "formatLogEntry renders story start with title, complexity, tier",
-        "formatLogEntry renders stage results with appropriate emoji",
-        "formatRunSummary renders pass/fail/duration/cost stats",
-        "quiet mode only shows pass/fail + summary",
-        "verbose mode includes routing, tokens, context files",
-        "json mode passes through raw JSONL",
-        "Timestamps formatted in local timezone HH:MM:SS"
-      ],
-      "dependencies": [],
-      "tags": [
-        "logging",
-        "formatter"
-      ],
-      "status": "passed",
-      "attempts": 0,
-      "priorErrors": [],
-      "escalations": []
-    },
-    {
-      "id": "US-003",
-      "title": "status.json writer for live run state",
-      "description": "Create src/logging/status-writer.ts. Maintain status.json at nax/features/<feature>/status.json during runs. Write on: run start (runId, feature, totalStories, pid), story start (currentStory), story complete (status/duration/cost/commit), run end (completed/failed + totals). Atomic writes via tmp+rename.",
-      "acceptanceCriteria": [
-        "status.json created at run start with runId, feature, startedAt, pid, status=running",
-        "Updates currentStory on story begin",
-        "Updates story entry on completion",
-        "Updates totals after each story",
-        "Status changes to completed/failed at run end",
-        "Atomic writes prevent corruption",
-        "PID included for crash detection"
-      ],
-      "dependencies": [],
-      "tags": [
-        "logging",
-        "state"
-      ],
-      "status": "passed",
-      "attempts": 1,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "escalations": [],
-      "passes": true
-    },
-    {
-      "id": "US-004",
-      "title": "nax status command with active run detection",
-      "description": "Create src/commands/status.ts, register in CLI. Uses resolveProject(). Show feature table (done/failed/pending, last run, cost). Detect active run via status.json+PID. Detect crash via status.json+dead PID. Support -f for single feature.",
-      "acceptanceCriteria": [
-        "Shows table of all features with counts and last run",
-        "Detailed single-feature view with story table",
-        "Active run detected via PID alive check",
-        "Crashed run shows warning with recovery hints",
-        "No status.json shows No runs yet",
-        "Uses resolveProject() for resolution",
-        "Registered as CLI subcommand"
-      ],
-      "dependencies": [
-        "US-001",
-        "US-003"
-      ],
-      "tags": [
-        "cli",
-        "status"
-      ],
-      "status": "passed",
-      "attempts": 0,
-      "priorErrors": [],
-      "escalations": [],
-      "passes": true
-    },
-    {
-      "id": "US-005",
-      "title": "nax logs command with filtering and follow mode",
-      "description": "Create src/commands/logs.ts, register in CLI. Uses resolveProject(). Supports: default (latest run formatted), --follow (tail -f), --story (filter), --level (filter), --list (run table), --run (specific run), --json (raw). Uses formatter from US-002.",
-      "acceptanceCriteria": [
-        "Shows latest run logs formatted",
-        "--follow streams new entries real-time",
-        "--story filters to one story",
-        "--level filters by severity",
-        "--list shows runs table",
-        "--run selects specific run",
-        "--json outputs raw JSONL",
-        "Filters combinable",
-        "Uses resolveProject()"
-      ],
-      "dependencies": [
-        "US-001",
-        "US-002"
-      ],
-      "tags": [
-        "cli",
-        "logs"
-      ],
-      "status": "passed",
-      "attempts": 1,
-      "priorErrors": [],
-      "escalations": [],
-      "passes": true
-    },
-    {
-      "id": "US-006",
-      "title": "Integrate formatter into headless runner",
-      "description": "Modify src/execution/runner.ts to use formatter for headless stdout instead of raw JSONL. Default=normal. Add --quiet/--verbose/--json flags to nax run. Wire status-writer into run loop. JSONL still written to disk. Integrate status.json updates at lifecycle points.",
-      "acceptanceCriteria": [
-        "Headless stdout shows formatted output by default",
-        "JSONL still written to disk (unchanged)",
-        "--json flag restores raw JSONL stdout",
-        "--quiet and --verbose flags work",
-        "status.json written throughout lifecycle",
-        "Run header with version, feature, count, path",
-        "Run footer with summary stats"
-      ],
-      "dependencies": [
-        "US-002",
-        "US-003"
-      ],
-      "tags": [
-        "runner",
-        "integration"
-      ],
-      "status": "passed",
-      "attempts": 0,
-      "priorErrors": [],
-      "escalations": [],
-      "passes": true
-    },
-    {
-      "id": "US-007",
-      "title": "Crash recovery with signal handlers heartbeat and exit summary",
-      "description": "Add SIGTERM/SIGINT/SIGHUP handlers and uncaught exception handlers. On signal: write fatal JSONL + update status.json to crashed + exit. During agent execution: heartbeat every 60s. On normal exit: write exit summary entry.",
-      "acceptanceCriteria": [
-        "Signal handlers write fatal log with signal name",
-        "Signal handlers update status.json to crashed",
-        "Uncaught exceptions write fatal log with stack",
-        "Heartbeat every 60s during agent execution",
-        "Normal exit writes summary entry",
-        "Signal handlers exit cleanly",
-        "Heartbeat timer cleaned up on story completion"
-      ],
-      "dependencies": [
-        "US-003"
-      ],
-      "tags": [
-        "crash-recovery",
-        "signals"
-      ],
-      "status": "passed",
-      "attempts": 1,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "escalations": [],
-      "passes": true
-    }
-  ],
-  "analyzeConfig": {
-    "maxStories": 15,
-    "granularity": "medium"
-  }
-}