@nathapp/nax 0.28.0 → 0.29.0

package/nax/features/central-run-registry/prd.json

@@ -1,105 +0,0 @@
-{
-  "project": "nax",
-  "branchName": "feat/central-run-registry",
-  "feature": "central-run-registry",
-  "version": "0.24.0",
-  "description": "Global run index across all projects. Events file writer for machine-readable lifecycle events, registry subscriber that indexes every run to ~/.nax/runs/, nax runs CLI for cross-project run history, and nax logs --run <runId> for global log resolution.",
-  "userStories": [
-    {
-      "id": "CRR-000",
-      "title": "Events file writer subscriber",
-      "description": "New subscriber: src/pipeline/subscribers/events-writer.ts \u2014 wireEventsWriter(bus, project, feature, runId, workdir). Listens to run:started, story:started, story:completed, story:failed, run:completed, run:paused. Writes one JSON line per event to ~/.nax/events/<project>/events.jsonl (append mode). Each line: {\"ts\": ISO8601, \"event\": string, \"runId\": string, \"feature\": string, \"project\": string, \"storyId\"?: string, \"data\"?: object}. The run:completed event writes an 'on-complete' entry \u2014 the machine-readable signal that nax exited gracefully (fixes watchdog false crash reports). Best-effort: wrap all writes in try/catch, log warnings on failure, never throw or block the pipeline. Create ~/.nax/events/<project>/ on first write via mkdir recursive. Derive project name from path.basename(workdir). Wire in sequential-executor.ts alongside existing wireHooks/wireReporters/wireInteraction calls. Return UnsubscribeFn matching existing subscriber pattern.",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "After a run, ~/.nax/events/<project>/events.jsonl exists with JSONL entries",
-        "Each line is valid JSON with ts, event, runId, feature, project fields",
-        "run:completed produces an entry with event=on-complete",
-        "story:started/completed/failed events include storyId",
-        "Write failure does not crash or block the nax run",
-        "Directory is created automatically on first write",
-        "wireEventsWriter is called in sequential-executor.ts",
-        "Returns UnsubscribeFn consistent with wireHooks/wireReporters pattern"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 2
-    },
-    {
-      "id": "CRR-001",
-      "title": "Registry writer subscriber",
-      "description": "New subscriber: src/pipeline/subscribers/registry.ts \u2014 wireRegistry(bus, project, feature, runId, workdir). Listens to run:started. On event, creates ~/.nax/runs/<project>-<feature>-<runId>/meta.json with fields: {runId, project, feature, workdir, statusPath: join(workdir, 'nax/features', feature, 'status.json'), eventsDir: join(workdir, 'nax/features', feature, 'runs'), registeredAt: ISO8601}. meta.json schema exported as MetaJson interface. Written once, never updated. Best-effort: try/catch + warn log, never throw/block. Create ~/.nax/runs/ directory on first call via mkdir recursive. Derive project from path.basename(workdir). Wire in sequential-executor.ts alongside wireEventsWriter. Return UnsubscribeFn.",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "After run start, ~/.nax/runs/<project>-<feature>-<runId>/meta.json exists",
-        "meta.json contains runId, project, feature, workdir, statusPath, eventsDir, registeredAt",
-        "statusPath points to <workdir>/nax/features/<feature>/status.json",
-        "eventsDir points to <workdir>/nax/features/<feature>/runs",
-        "MetaJson interface is exported from the module",
-        "Write failure does not crash or block the nax run",
-        "wireRegistry is called in sequential-executor.ts"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [],
-      "tags": [],
-      "storyPoints": 2
-    },
-    {
-      "id": "CRR-002",
-      "title": "nax runs CLI command",
-      "description": "New command: src/commands/runs.ts \u2014 runsCommand(options). Reads all ~/.nax/runs/*/meta.json, resolves each statusPath to read the live NaxStatusFile for current state. Displays a table sorted by registeredAt desc. Columns: RUN ID, PROJECT, FEATURE, STATUS, STORIES (passed/total), DURATION, DATE. Default limit: 20. Options: --project <name> (filter), --last <N> (limit), --status <running|completed|failed|crashed> (filter). If statusPath missing, show status as '[unavailable]'. Register in src/commands/index.ts and wire in bin/nax.ts CLI arg parser (match pattern of existing diagnose/logs/status commands). Use chalk for colored output. Green for completed, red for failed, yellow for running, dim for unavailable.",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "nax runs displays a table of all registered runs sorted newest-first",
-        "nax runs --project <name> filters by project name",
-        "nax runs --last <N> limits output to N runs",
-        "nax runs --status <status> filters by run status",
-        "Runs with missing statusPath show '[unavailable]' status gracefully",
-        "Empty registry shows 'No runs found' message",
-        "Command is registered in CLI help output and bin/nax.ts"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [
-        "CRR-001"
-      ],
-      "tags": [],
-      "storyPoints": 3
-    },
-    {
-      "id": "CRR-003",
-      "title": "nax logs --run <runId> global resolution",
-      "description": "Enhance src/commands/logs.ts logsCommand: when --run <runId> is provided, scan ~/.nax/runs/*/meta.json for matching runId (exact or prefix match). Read eventsDir from meta.json, locate the JSONL log file in that directory (newest .jsonl file), then display using existing displayLogs/followLogs functions. Falls back to current behavior (local feature context) when --run is not specified. If runId not found in registry, throw error Run not found in registry: <runId>. If eventsDir or log file missing, show unavailable message. Update LogsOptions interface to accept run?: string. Update bin/nax.ts to pass --run option through.",
-      "complexity": "medium",
-      "status": "pending",
-      "acceptanceCriteria": [
-        "nax logs --run <runId> displays logs from the matching run regardless of cwd",
-        "Resolution uses ~/.nax/runs/*/meta.json to find eventsDir path",
-        "Unknown runId shows clear error message",
-        "Missing log files show unavailable message",
-        "Without --run flag, existing local behavior is unchanged",
-        "Partial runId matching works (prefix match on runId field)"
-      ],
-      "attempts": 0,
-      "priorErrors": [],
-      "priorFailures": [],
-      "escalations": [],
-      "dependencies": [
-        "CRR-001"
-      ],
-      "tags": [],
-      "storyPoints": 2
-    }
-  ]
-}

package/nax/features/config-management/prd.json

@@ -1,108 +0,0 @@
-{
-  "project": "nax",
-  "branchName": "feat/v0.17.0-config-management",
-  "feature": "config-management",
-  "userStories": [
-    {
-      "id": "CM-001",
-      "title": "nax config --explain",
-      "description": "Add `nax config` CLI command with `--explain` flag that dumps the effective merged config with inline comments. Resolution order: defaults \u2192 global (~/.nax/config.json) \u2192 project (nax/config.json) \u2192 CLI overrides. Each field gets a one-line human-readable description of what it does. Fields overridden by project config are annotated with '(project override)' vs '(global)' vs '(default)'. Output format: YAML-like with # comments. Must cover all sections: models, routing, execution, tdd, quality, review, context, constitution, analyze, plan, acceptance, interaction, autoMode. Implementation: add `src/cli/config.ts` with `configCommand()`. Read merged config from loader, annotate each field using a static descriptions map (Record<string, string>). Register in `src/cli/index.ts`.",
-      "complexity": "medium",
-      "status": "passed",
-      "attempts": 1,
-      "escalations": [],
-      "dependencies": [],
-      "tags": [
-        "cli",
-        "config",
-        "dx"
-      ],
-      "acceptanceCriteria": [
-        "Running `nax config --explain` outputs all config fields with descriptions",
-        "Each field shows its source: (default), (global), or (project override)",
-        "Output is human-readable, not raw JSON",
-        "Works from any directory (uses existing config loader)"
-      ],
-      "storyPoints": 1,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: fast",
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "passes": true,
-      "routing": {
-        "complexity": "simple",
-        "modelTier": "powerful",
-        "testStrategy": "three-session-tdd-lite",
-        "reasoning": "three-session-tdd-lite: strategy:lite"
-      }
-    },
-    {
-      "id": "CM-002",
-      "title": "nax config --diff",
-      "description": "Add `--diff` flag to `nax config` that shows only fields where project config overrides the global config. Output format: table or structured list showing field path, project value, and global value. Skip fields that are identical or only set at one layer. If no project config exists, print 'No project config found \u2014 using global defaults'. Implementation: in `src/cli/config.ts`, load global and project configs separately (extend loader to expose both), deep-diff them, format as table. Use the same descriptions map from CM-001 to add context.",
-      "complexity": "medium",
-      "status": "passed",
-      "attempts": 1,
-      "escalations": [],
-      "dependencies": [
-        "CM-001"
-      ],
-      "tags": [
-        "cli",
-        "config",
-        "dx"
-      ],
-      "acceptanceCriteria": [
-        "Running `nax config --diff` shows only fields where project differs from global",
-        "Each differing field shows: field path, project value, global value",
-        "Shows 'No project config found' when no nax/config.json exists",
-        "Works alongside --explain (mutually exclusive flags)"
-      ],
-      "storyPoints": 1,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: fast",
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "passes": false,
-      "routing": {
-        "complexity": "simple",
-        "modelTier": "powerful",
-        "testStrategy": "three-session-tdd-lite",
-        "reasoning": "three-session-tdd-lite: strategy:lite"
-      }
-    },
-    {
-      "id": "CM-003",
-      "title": "nax config (default view)",
-      "description": "When `nax config` is run without flags, print the effective merged config as formatted JSON with a header showing the config sources found (global path, project path if exists). This is the quick 'what am I actually running with?' view. Implementation: default action in `src/cli/config.ts`. Load merged config, pretty-print with JSON.stringify(config, null, 2). Add header lines showing which config files were found and loaded.",
-      "complexity": "simple",
-      "status": "passed",
-      "attempts": 1,
-      "escalations": [],
-      "dependencies": [],
-      "tags": [
-        "cli",
-        "config",
-        "dx"
-      ],
-      "acceptanceCriteria": [
-        "Running `nax config` prints the effective merged config as formatted JSON",
-        "Header shows paths of config files found (global, project)",
-        "Missing config files noted in header"
-      ],
-      "storyPoints": 1,
-      "priorErrors": [
-        "Attempt 1 failed with model tier: fast",
-        "Attempt 1 failed with model tier: balanced"
-      ],
-      "passes": true,
-      "routing": {
-        "complexity": "simple",
-        "modelTier": "powerful",
-        "testStrategy": "three-session-tdd-lite",
-        "reasoning": "three-session-tdd-lite: strategy:lite"
-      }
-    }
-  ],
-  "updatedAt": "2026-03-02T07:38:25.351Z"
-}

package/nax/features/config-management/progress.txt

@@ -1,5 +0,0 @@
-[2026-03-02T06:07:47.434Z] CM-001 — FAILED — nax config --explain — Execution failed
-[2026-03-02T08:15:00.000Z] CM-002 — PASSED — nax config --diff — All acceptance criteria met
-[2026-03-02T07:12:34.595Z] CM-002 — FAILED — nax config --diff — Execution failed
-[2026-03-02T09:30:00.000Z] CM-003 — PASSED — nax config (default view) — All acceptance criteria met
-[2026-03-02T07:20:20.866Z] CM-003 — FAILED — nax config (default view) — Execution failed

package/nax/features/diagnose/acceptance.test.ts

@@ -1,414 +0,0 @@
-/**
- * Acceptance Test: nax diagnose CLI
- *
- * Validates that the nax diagnose command meets all acceptance criteria.
- */
-
-import { describe, test, expect, beforeEach, afterEach } from "bun:test";
-import { existsSync, mkdirSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { diagnoseCommand } from "../../../src/cli/diagnose";
-import type { PRD } from "../../../src/prd";
-import { savePRD } from "../../../src/prd";
-import type { NaxStatusFile } from "../../../src/execution/status-file";
-
-// Test fixture directory
-let testDir: string;
-
-beforeEach(() => {
-	// Create unique test directory
-	testDir = join(tmpdir(), `nax-diagnose-acceptance-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-	mkdirSync(testDir, { recursive: true });
-	mkdirSync(join(testDir, "nax", "features"), { recursive: true });
-});
-
-afterEach(() => {
-	// Clean up test directory
-	if (existsSync(testDir)) {
-		rmSync(testDir, { recursive: true, force: true });
-	}
-});
-
-/**
- * Create a minimal PRD fixture
- */
-function createPRD(feature: string, stories: Array<Partial<PRD["userStories"][0]>>): PRD {
-	return {
-		project: "test-project",
-		feature,
-		branchName: "feature/test",
-		createdAt: "2026-01-01T00:00:00Z",
-		updatedAt: "2026-01-01T00:00:00Z",
-		userStories: stories.map((s, i) => ({
-			id: s.id ?? `US-${String(i + 1).padStart(3, "0")}`,
-			title: s.title ?? "Test Story",
-			description: s.description ?? "Test description",
-			acceptanceCriteria: s.acceptanceCriteria ?? [],
-			tags: s.tags ?? [],
-			dependencies: s.dependencies ?? [],
-			status: s.status ?? "pending",
-			passes: s.passes ?? false,
-			escalations: s.escalations ?? [],
-			attempts: s.attempts ?? 0,
-			priorErrors: s.priorErrors ?? [],
-			...s,
-		})),
-	};
-}
-
-/**
- * Create a status.json fixture
- */
-async function createStatusFile(
-	dir: string,
-	feature: string,
-	overrides: Partial<NaxStatusFile> = {},
-): Promise<void> {
-	const status: NaxStatusFile = {
-		version: 1,
-		run: {
-			id: "run-001",
-			feature,
-			startedAt: "2026-01-01T10:00:00Z",
-			status: "running",
-			dryRun: false,
-			pid: process.pid,
-			...overrides.run,
-		},
-		progress: {
-			total: 3,
-			passed: 1,
-			failed: 1,
-			paused: 0,
-			blocked: 0,
-			pending: 1,
-			...overrides.progress,
-		},
-		cost: {
-			spent: 0.05,
-			limit: null,
-			...overrides.cost,
-		},
-		current: null,
-		iterations: 1,
-		updatedAt: "2026-01-01T10:30:00Z",
-		durationMs: 1800000,
-		...overrides,
-	};
-
-	// Ensure nax directory exists
-	mkdirSync(join(dir, "nax"), { recursive: true });
-	await Bun.write(join(dir, "nax", "status.json"), JSON.stringify(status, null, 2));
-}
-
-/**
- * Create a lock file fixture
- */
-async function createLockFile(dir: string, pid: number): Promise<void> {
-	await Bun.write(
-		join(dir, "nax.lock"),
-		JSON.stringify({
-			pid,
-			timestamp: Date.now(),
-		}),
-	);
-}
-
-// ============================================================================
-// AC1: Basic diagnosis with all 5 sections
-// ============================================================================
-
-describe("AC1: nax diagnose reads last run and prints all 5 sections", () => {
-	test("prints Run Summary, Story Breakdown, Failure Analysis, Lock Check, Recommendations", async () => {
-		const feature = "test-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [
-			{ id: "US-001", title: "Passed Story", status: "passed", passes: true, attempts: 1 },
-			{
-				id: "US-002",
-				title: "Failed Story",
-				status: "failed",
-				passes: false,
-				attempts: 3,
-				priorErrors: ["tests-failing", "tests-failing"],
-			},
-			{ id: "US-003", title: "Pending Story", status: "pending", passes: false, attempts: 0 },
-		]);
-
-		await savePRD(prd, join(featureDir, "prd.json"));
-		await createStatusFile(testDir, feature);
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir, verbose: true });
-
-			// Verify all sections present
-			expect(output).toContain("Diagnosis Report");
-			expect(output).toContain("Run Summary");
-			expect(output).toContain("Story Breakdown");
-			expect(output).toContain("Failure Analysis");
-			expect(output).toContain("Lock Check");
-			expect(output).toContain("Recommendations");
-
-			// Verify counts
-			expect(output).toContain("Passed:      1");
-			expect(output).toContain("Failed:      1");
-			expect(output).toContain("Pending:     1");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC2: Pattern classification for failed stories
-// ============================================================================
-
-describe("AC2: Each failed story shows pattern classification", () => {
-	test("classifies all failure patterns correctly", async () => {
-		const feature = "patterns-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [
-			{
-				id: "US-001",
-				title: "Greenfield Story",
-				status: "failed",
-				failureCategory: "greenfield-no-tests",
-				attempts: 1,
-			},
-			{
-				id: "US-002",
-				title: "Test Mismatch",
-				status: "failed",
-				priorErrors: ["tests-failing", "tests-failing"],
-				attempts: 2,
-			},
-			{
-				id: "US-003",
-				title: "Isolation Violation",
-				status: "failed",
-				failureCategory: "isolation-violation",
-				attempts: 1,
-			},
-		]);
-
-		await savePRD(prd, join(featureDir, "prd.json"));
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir });
-
-			expect(output).toContain("GREENFIELD_TDD");
-			expect(output).toContain("TEST_MISMATCH");
-			expect(output).toContain("ISOLATION_VIOLATION");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC3: Stale lock detection
-// ============================================================================
-
-describe("AC3: Stale nax.lock detection", () => {
-	test("detects stale lock and shows fix command", async () => {
-		const feature = "locked-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [{ id: "US-001", title: "Test Story", status: "pending" }]);
-		await savePRD(prd, join(featureDir, "prd.json"));
-		await createLockFile(testDir, 999999); // Dead PID
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir });
-
-			expect(output).toContain("Stale lock detected");
-			expect(output).toContain("rm nax.lock");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC4: JSON output mode
-// ============================================================================
-
-describe("AC4: --json flag outputs machine-readable JSON", () => {
-	test("outputs valid JSON with all report fields", async () => {
-		const feature = "json-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [
-			{ id: "US-001", title: "Passed Story", status: "passed", passes: true },
-			{ id: "US-002", title: "Failed Story", status: "failed", attempts: 2 },
-		]);
-
-		await savePRD(prd, join(featureDir, "prd.json"));
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir, json: true });
-
-			const report = JSON.parse(output);
-
-			expect(report).toHaveProperty("runSummary");
-			expect(report).toHaveProperty("storyBreakdown");
-			expect(report).toHaveProperty("failureAnalysis");
-			expect(report).toHaveProperty("lockCheck");
-			expect(report).toHaveProperty("recommendations");
-			expect(report).toHaveProperty("dataSources");
-
-			expect(report.runSummary.storiesPassed).toBe(1);
-			expect(report.runSummary.storiesFailed).toBe(1);
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC5: Graceful degradation when events.jsonl missing
-// ============================================================================
-
-describe("AC5: Works gracefully when events.jsonl missing", () => {
-	test("uses PRD + git log only and prints note", async () => {
-		const feature = "no-events-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [{ id: "US-001", title: "Test Story", status: "passed", passes: true }]);
-		await savePRD(prd, join(featureDir, "prd.json"));
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir });
-
-			expect(output).toContain("Diagnosis Report");
-			expect(output).toContain("events.jsonl not found");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC6: -f and -d flags for targeting
-// ============================================================================
-
-describe("AC6: -f <feature> and -d <workdir> flags work", () => {
-	test("diagnoses specific feature with -f flag", async () => {
-		const feature = "specific-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [{ id: "US-001", title: "Specific Story", status: "passed", passes: true }]);
-		await savePRD(prd, join(featureDir, "prd.json"));
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir, verbose: true });
-
-			expect(output).toContain(feature);
-			expect(output).toContain("Specific Story");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC7: AUTO_RECOVERED shown as INFO not ERROR
-// ============================================================================
-
-describe("AC7: AUTO_RECOVERED stories shown as INFO", () => {
-	test("displays AUTO_RECOVERED with INFO level, not ERROR", async () => {
-		const feature = "recovered-feature";
-		const featureDir = join(testDir, "nax", "features", feature);
-		mkdirSync(featureDir, { recursive: true });
-
-		const prd = createPRD(feature, [
-			{
-				id: "US-001",
-				title: "Recovered Story",
-				status: "passed",
-				passes: true,
-				priorErrors: ["greenfield-no-tests"],
-				attempts: 2,
-			},
-		]);
-
-		await savePRD(prd, join(featureDir, "prd.json"));
-
-		let output = "";
-		const originalLog = console.log;
-		console.log = (...args: unknown[]) => {
-			output += args.join(" ") + "\n";
-		};
-
-		try {
-			await diagnoseCommand({ feature, workdir: testDir });
-
-			expect(output).toContain("INFO");
-			expect(output).toContain("AUTO_RECOVERED");
-			expect(output).not.toContain("ERROR US-001");
-		} finally {
-			console.log = originalLog;
-		}
-	});
-});
-
-// ============================================================================
-// AC8: TypeScript compiles cleanly
-// ============================================================================
-
-describe("AC8: TypeScript compiles cleanly", () => {
-	test("bun x tsc --noEmit passes", async () => {
-		const result = Bun.spawnSync(["bun", "x", "tsc", "--noEmit"], {
-			cwd: join(__dirname, "../../.."),
-			stdout: "pipe",
-			stderr: "pipe",
-		});
-
-		expect(result.exitCode).toBe(0);
-	}, 60000);
-});

package/nax/features/diagnose/prd.json

@@ -1,41 +0,0 @@
-{
-  "project": "nax",
-  "feature": "diagnose",
-  "branchName": "feat/v0.14.1-diagnose-cli",
-  "createdAt": "2026-02-28T12:00:00Z",
-  "userStories": [
-    {
-      "id": "US-001",
-      "title": "nax diagnose CLI \u2014 pure pattern-matching diagnosis",
-      "description": "Implement the `nax diagnose` command that reads existing run artifacts (events.jsonl from ~/.nax/events/<project>/, status.json from <workdir>/.nax-status.json, PRD from nax/features/<feature>/prd.json, nax.lock from <workdir>/nax.lock, git log) and produces a structured human-readable diagnosis report. No LLM calls. No agent. Purely deterministic pattern matching.\n\nCOMMAND SIGNATURE:\n  nax diagnose [-f <feature>] [-d <workdir>] [--json] [--verbose]\n\nOUTPUT SECTIONS:\n1. Run Summary \u2014 feature, last run time, status (complete/stalled/failed), stories passed/failed/pending, cost, commits produced\n2. Story Breakdown \u2014 per-story: status, attempts, tier, strategy, pattern detected\n3. Failure Analysis \u2014 for each failed story: pattern name, symptom description, fix suggestion\n4. Lock Check \u2014 is nax.lock present? Is PID alive (process.kill(pid, 0))? Show fix command if stale.\n5. Recommendations \u2014 ordered list of next actions\n\nFAILURE PATTERNS TO DETECT (match in order):\n- GREENFIELD_TDD: failureCategory === greenfield-no-tests in priorErrors or events\n- TEST_MISMATCH: 2+ consecutive tests-failing escalation events for same story\n- ENVIRONMENTAL: precheck-failed event OR blocker in status.json\n- RATE_LIMITED: rateLimited: true in agent session failure events\n- ISOLATION_VIOLATION: failureCategory === isolation-violation\n- MAX_TIERS_EXHAUSTED: story has priorErrors for all configured tiers AND status is failed/paused\n- SESSION_CRASH: session-failure category + no commits for that story in git log\n- STALLED: isStalled flag in status.json OR all pending stories blocked by dependencies\n- LOCK_STALE: nax.lock present + PID not alive\n- AUTO_RECOVERED: story had greenfield-no-tests but status is passed (S5 worked)\n- UNKNOWN: no pattern matched\n\nGRACEFUL DEGRADATION: If events.jsonl is missing, fall back to PRD priorErrors + git log only. Never crash \u2014 always produce partial output with a note about missing data.\n\nFILES TO CREATE:\n- src/cli/diagnose.ts \u2014 main implementation (read artifacts, pattern match, format output)\n- src/commands/diagnose.ts \u2014 thin commander wrapper registering the command\n- Register in bin/nax.ts \u2014 add diagnose command import\n- test/integration/cli-diagnose.test.ts \u2014 integration tests covering all ACs",
-      "acceptanceCriteria": [
-        "AC1: `nax diagnose` reads the last run for the current directory feature and prints human-readable output with all 5 sections (Run Summary, Story Breakdown, Failure Analysis, Lock Check, Recommendations)",
-        "AC2: Each failed story shows a pattern classification from the known patterns list, or UNKNOWN if no match",
-        "AC3: Stale nax.lock (lock present + PID dead) is detected and a fix command shown: rm nax.lock",
-        "AC4: `--json` flag outputs machine-readable JSON containing the same data as human output",
-        "AC5: Works gracefully when events.jsonl is missing \u2014 uses PRD + git log only, prints a note about missing events",
-        "AC6: `-f <feature>` targets a specific feature; `-d <workdir>` sets working directory",
-        "AC7: AUTO_RECOVERED stories (S5 switched strategy, story passed) are shown as INFO not ERROR",
-        "AC8: TypeScript compiles cleanly (bun x tsc --noEmit)"
-      ],
-      "dependencies": [],
-      "tags": [
-        "cli",
-        "medium"
-      ],
-      "status": "passed",
-      "passes": true,
-      "attempts": 1,
-      "escalations": [],
-      "priorErrors": [
-        "Manual accept: verified 8/8 AC tests pass on VPS. Mac01 Bun env issue with git detection in temp dirs during verification."
-      ],
-      "storyPoints": 1
-    }
-  ],
-  "analyzeConfig": {
-    "maxStories": 5,
-    "granularity": "medium"
-  },
-  "updatedAt": "2026-02-28T06:18:08Z"
-}