@nathapp/nax 0.28.0 → 0.29.0

package/CLAUDE.md

@@ -1,143 +0,0 @@
-# nax — AI Coding Agent Orchestrator
-
-Bun + TypeScript CLI that orchestrates AI coding agents (Claude Code) with model-tier routing, TDD strategies, plugin hooks, and a Central Run Registry.
-
-## Tech Stack
-
-| Layer | Choice |
-|:------|:-------|
-| Runtime | **Bun 1.3.7+** — Bun-native APIs only, no Node.js equivalents |
-| Language | **TypeScript strict** — no `any` without explicit justification |
-| Test | **`bun:test`** — describe/test/expect |
-| Lint/Format | **Biome** (`bun run lint`) |
-| Build | `bun run build` |
-
-## Git Identity
-
-```bash
-git config user.name "subrina.tai"
-git config user.email "subrina8080@outlook.com"
-```
-
-## Commands
-
-| Command | Purpose |
-|:--------|:--------|
-| `bun run typecheck` | tsc --noEmit |
-| `bun run lint` | Biome |
-| `bun test test/unit/foo.test.ts` | Targeted test during iteration |
-| `NAX_SKIP_PRECHECK=1 bun test test/ --timeout=60000 --bail` | Full suite |
-
-nax runs lint, typecheck, and tests automatically via the pipeline. Run these manually only when working outside a nax session.
-
-## Engineering Persona
-
-- **Senior Engineer mindset**: check edge cases, null/undefined, race conditions, and error states.
-- **TDD first**: write or update tests before implementation when the story calls for it.
-- **Stuck rule**: if the same test fails 2+ iterations, stop, summarise failed attempts, reassess approach.
-- **Never push to remote** — the human reviews and pushes.
-
-## Architecture
-
-```
-Runner.run()  [src/execution/runner.ts — thin orchestrator only]
-  → loadPlugins()
-  → for each story:
-    → Pipeline.execute()  [src/pipeline/pipeline.ts]
-      → stages: queueCheck → routing → constitution → context → prompt
-               → execution → verify → review → completion
-    → Reporter.emit()
-  → registry.teardownAll()
-```
-
-### Key Source Directories
-
-| Directory | Purpose |
-|:----------|:--------|
-| `src/execution/` | Runner loop, agent adapters, escalation, lifecycle hooks |
-| `src/execution/escalation/` | Tier escalation on repeated failures |
-| `src/pipeline/stages/` | One file per pipeline stage |
-| `src/pipeline/subscribers/` | Event-driven hooks (interaction, hooks.ts) |
-| `src/routing/` | Model-tier routing — keyword, LLM, plugin chain |
-| `src/routing/strategies/` | keyword.ts, llm.ts, llm-prompts.ts |
-| `src/interaction/` | Interaction triggers + plugins (Auto, Telegram, Webhook) |
-| `src/plugins/` | Plugin system — loader, registry, validator |
-| `src/verification/` | Test execution, smart runner, scoped runner |
-| `src/metrics/` | StoryMetrics, aggregator, tracker |
-| `src/config/` | Config schema + layered loader (global → project) |
-| `src/agents/adapters/` | Agent integrations (Claude Code) |
-| `src/cli/` + `src/commands/` | CLI commands — check both locations |
-| `src/prd/` | PRD types, loader, story state machine |
-| `src/hooks/` | Lifecycle hook wiring |
-| `src/constitution/` | Constitution loader + injection |
-| `src/analyze/` | `nax analyze` — story classifier |
-
-### Plugin Extension Points
-
-| Interface | Loaded By | Purpose |
-|:----------|:----------|:--------|
-| `IContextProvider` | `context.ts` stage | Inject context into agent prompts |
-| `IReviewer` | Review stage | Post-verify quality checks |
-| `IReporter` | Runner | onRunStart / onStoryComplete / onRunEnd events |
-| `IRoutingStrategy` | Router chain | Override model-tier routing |
-
-### Config
-
-- Global: `~/.nax/config.json` → Project: `<workdir>/nax/config.json`
-- Schema: `src/config/schema.ts` — no hardcoded flags or credentials anywhere
-
-## Workflow Protocol
-
-1. **Explore first**: use `grep`, `cat`, and solograph MCP to understand context before writing code.
-2. **Plan complex tasks**: for multi-file changes, write a short plan before implementing.
-3. **Implement in small chunks**: one logical concern per commit.
-
-## Code Intelligence (Solograph MCP) — MANDATORY
-
-**Always use solograph MCP tools before writing code or analyzing architecture.** Do NOT use `web_search` or `kb_search` as substitutes.
-
-### Tool Selection Guide
-
-| Tool | Capability | When to Use | Availability |
-|:-----|:-----------|:-----------|:-------------|
-| `codegraph_query` | Structural queries (Cypher) — find calls, dependencies, imports | **Preferred for dependency analysis, call tracing, symbol lookup** | ✅ Always works (in-memory graph) |
-| `project_code_search` | Semantic search (Redis vector DB) — pattern matching by meaning | Natural language queries like "find auth patterns" | ⚠️ Requires explicit `project_code_reindex` + Redis daemon |
-| `codegraph_explain` | Architecture overview for unfamiliar subsystems | Understand module relationships before major changes | ✅ Always works |
-| `project_code_reindex` | Index project for semantic search | After creating/deleting source files | ✅ Always works |
-
-### Recommended Workflow
-
-For nax, **prefer `codegraph_query`** for routine tasks:
-- Finding where functions are called (`calculateAggregateMetrics` called by `status-cost.ts`)
-- Analyzing dependencies before refactoring
-- Tracing import/export chains
-- Querying symbol definitions and relationships
-
-**Use `project_code_search` only if:**
-- You need semantic similarity ("find authentication patterns")
-- Redis is indexed and running (not guaranteed in all sessions)
-
-### Example Queries
-
-```cypher
--- Find files calling calculateAggregateMetrics
-MATCH (f:File)-[:CALLS]->(s:Symbol {name: "calculateAggregateMetrics"})
-RETURN f.path
-
--- Find all imports of aggregator.ts
-MATCH (f:File)-[:IMPORTS]->(target:File {path: "src/metrics/aggregator.ts"})
-RETURN f.path
-
--- Find symbols defined in a file
-MATCH (f:File {path: "src/metrics/aggregator.ts"})-[:DEFINES]->(s:Symbol)
-RETURN s.name, s.type
-```
-
-## Coding Standards & Forbidden Patterns
-
-Full rules in `.claude/rules/` (loaded automatically):
-
-- `01-project-conventions.md` — Bun-native APIs, 400-line limit, barrel imports, logging, commits
-- `02-test-architecture.md` — directory mirroring, placement rules, file naming
-- `03-test-writing.md` — `_deps` injection pattern, mock discipline, CI guards
-- `04-forbidden-patterns.md` — banned APIs and test anti-patterns with alternatives

package/US-007-IMPLEMENTATION.md

@@ -1,139 +0,0 @@
-# US-007 Implementation Summary
-
-## Story: Read plugin config entries from nax config.json
-
-**Status:** ✅ COMPLETE
-
-## Implementation Details
-
-The functionality described in US-007 was already implemented in the codebase. This document verifies that all acceptance criteria are met.
-
-### Acceptance Criteria Verification
-
-#### ✅ AC1: plugins[] from config.json are passed to loadPlugins() as configPlugins parameter
-
-**Implementation:**
-- `src/config/loader.ts`: Config schema includes `plugins?: PluginConfigEntry[]` (line 369)
-- `src/execution/runner.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 201)
-- `src/execution/run-lifecycle.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 88)
-- `src/cli/plugins.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 22)
-
-**Test Coverage:**
-- `test/integration/config-loader.test.ts`: New tests verify plugins[] are loaded from config.json
-- `test/integration/plugins/config-integration.test.ts`: End-to-end test with realistic scenario
-- `test/integration/plugins/config-resolution.test.ts`: Comprehensive path resolution tests
-
-#### ✅ AC2: Relative module paths in plugins[].module are resolved relative to project root
-
-**Implementation:**
-- `src/plugins/loader.ts`: `resolveModulePath()` function (lines 173-186)
-  - Relative paths (starting with `./` or `../`) are resolved relative to `projectRoot`
-  - Uses `path.resolve(projectRoot, modulePath)` for relative paths
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC2: Relative module paths resolved relative to project root"
-  - "resolves ./custom-plugins/plugin.ts relative to project root"
-
-#### ✅ AC3: Absolute module paths and npm package names work as-is
-
-**Implementation:**
-- `src/plugins/loader.ts`: `resolveModulePath()` function (lines 173-186)
-  - Absolute paths: `path.isAbsolute(modulePath)` returns true → no resolution needed
-  - NPM packages: No leading `./` or `../` → treated as package name, passed as-is
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC3: Absolute paths and npm packages work as-is"
-  - "resolves npm package names as-is"
-  - "resolves absolute paths as-is"
-
-#### ✅ AC4: If a plugin module cannot be found, a clear error message is logged with the path tried
-
-**Implementation:**
-- `src/plugins/loader.ts`: `loadAndValidatePlugin()` function (lines 225-241)
-  - Catches import errors and provides helpful error messages
-  - Lines 230-235: Special handling for "Cannot find module" and "ENOENT" errors
-  - Logs both original path and attempted resolved path
-  - Provides guidance: "Ensure the module exists and the path is correct (relative paths are resolved from project root)"
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC4: Clear error message when plugin module not found (relative path)"
-  - "AC4: Clear error message when plugin module not found (npm package)"
-
-**Example Error Output:**
-```
-[nax] Failed to load plugin module './custom-plugins/missing.ts'
-[nax] Attempted path: /path/to/project/custom-plugins/missing.ts
-[nax] Ensure the module exists and the path is correct (relative paths are resolved from project root)
-```
-
-#### ✅ AC5: Plugin-specific config (plugins[].config) is passed to the plugin's setup() function
-
-**Implementation:**
-- `src/plugins/loader.ts`: `loadAndValidatePlugin()` function (lines 214-221)
-  - Calls plugin's `setup()` function with the provided config
-  - Config is passed as the first parameter: `await validated.setup(config)`
-
-**Test Coverage:**
-- `test/integration/plugins/config-integration.test.ts`:
-  - "realistic scenario: project with relative plugin paths in config"
-  - Verifies that plugin configs are written to tracker file via setup()
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC5: Plugin-specific config passed to setup() function"
-
-## Test Results
-
-All plugin-related tests pass:
-
-```bash
-$ bun test test/integration/plugins/ test/integration/config-loader.test.ts test/integration/runner-plugin-integration.test.ts
-
-✓ 101 tests passed
-✓ 154 expect() calls
-✓ 0 failures
-```
-
-### New Tests Added
-
-Added 4 new tests to `test/integration/config-loader.test.ts`:
-
-1. **"loads plugins[] from config.json"** - Verifies plugins array is loaded correctly
-2. **"handles missing plugins[] array"** - Verifies graceful handling of missing plugins
-3. **"merges plugins[] from global and project config"** - Verifies config merging behavior
-4. **"validates plugin config entries have required fields"** - Verifies validation works
-
-## Files Modified
-
-1. **test/integration/config-loader.test.ts**
-   - Added new test suite: "Config Loader - Plugin Configuration (US-007)"
-   - Added 4 tests covering config loading scenarios
-   - Tests verify plugins[] array is properly loaded and validated
-
-## Architecture Overview
-
-```
-config.json
-  └─> loadConfig() (src/config/loader.ts)
-      └─> NaxConfig { plugins?: PluginConfigEntry[] }
-          └─> Runner/CLI reads config.plugins
-              └─> loadPlugins(globalDir, projectDir, configPlugins, projectRoot)
-                  └─> resolveModulePath() for each entry
-                      └─> loadAndValidatePlugin()
-                          └─> import module
-                              └─> validatePlugin()
-                                  └─> plugin.setup(config)
-```
-
-## Conclusion
-
-All acceptance criteria for US-007 are met. The implementation correctly:
-1. Reads plugins[] from config.json
-2. Passes them to loadPlugins() as configPlugins parameter
-3. Resolves relative paths relative to project root
-4. Handles absolute paths and npm packages correctly
-5. Provides clear error messages when modules are not found
-6. Passes plugin-specific config to setup() functions
-
-The feature is production-ready and fully tested.

package/biome.json

@@ -1,14 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "organizeImports": { "enabled": true },
-  "linter": {
-    "enabled": true,
-    "rules": { "recommended": true }
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 120
-  }
-}

package/bun.lock

@@ -1,163 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "ngent",
-      "dependencies": {
-        "@anthropic-ai/sdk": "^0.74.0",
-        "@types/react": "^19.2.14",
-        "chalk": "^5.6.2",
-        "commander": "^13.1.0",
-        "ink": "^6.7.0",
-        "ink-spinner": "^5.0.0",
-        "ink-testing-library": "^4.0.0",
-        "react": "^19.2.4",
-        "zod": "^4.3.6",
-      },
-      "devDependencies": {
-        "@biomejs/biome": "^1.9.4",
-        "@types/bun": "^1.3.8",
-        "react-devtools-core": "^7.0.1",
-        "typescript": "^5.7.3",
-      },
-    },
-  },
-  "packages": {
-    "@alcalzone/ansi-tokenize": ["@alcalzone/ansi-tokenize@0.2.5", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-3NX/MpTdroi0aKz134A6RC2Gb2iXVECN4QaAXnvCIxxIm3C3AVB1mkUe8NaaiyvOpDfsrqWhYtj+Q6a62RrTsw=="],
-
-    "@anthropic-ai/sdk": ["@anthropic-ai/sdk@0.74.0", "", { "dependencies": { "json-schema-to-ts": "^3.1.1" }, "peerDependencies": { "zod": "^3.25.0 || ^4.0.0" }, "optionalPeers": ["zod"], "bin": { "anthropic-ai-sdk": "bin/cli" } }, "sha512-srbJV7JKsc5cQ6eVuFzjZO7UR3xEPJqPamHFIe29bs38Ij2IripoAhC0S5NslNbaFUYqBKypmmpzMTpqfHEUDw=="],
-
-    "@babel/runtime": ["@babel/runtime@7.28.6", "", {}, "sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA=="],
-
-    "@biomejs/biome": ["@biomejs/biome@1.9.4", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "1.9.4", "@biomejs/cli-darwin-x64": "1.9.4", "@biomejs/cli-linux-arm64": "1.9.4", "@biomejs/cli-linux-arm64-musl": "1.9.4", "@biomejs/cli-linux-x64": "1.9.4", "@biomejs/cli-linux-x64-musl": "1.9.4", "@biomejs/cli-win32-arm64": "1.9.4", "@biomejs/cli-win32-x64": "1.9.4" }, "bin": { "biome": "bin/biome" } }, "sha512-1rkd7G70+o9KkTn5KLmDYXihGoTaIGO9PIIN2ZB7UJxFrWw04CZHPYiMRjYsaDvVV7hP1dYNRLxSANLaBFGpog=="],
-
-    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@1.9.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-bFBsPWrNvkdKrNCYeAp+xo2HecOGPAy9WyNyB/jKnnedgzl4W4Hb9ZMzYNbf8dMCGmUdSavlYHiR01QaYR58cw=="],
-
-    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@1.9.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-ngYBh/+bEedqkSevPVhLP4QfVPCpb+4BBe2p7Xs32dBgs7rh9nY2AIYUL6BgLw1JVXV8GlpKmb/hNiuIxfPfZg=="],
-
-    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-fJIW0+LYujdjUgJJuwesP4EjIBl/N/TcOX3IvIHJQNsAqvV2CHIogsmA94BPG6jZATS4Hi+xv4SkBBQSt1N4/g=="],
-
-    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-v665Ct9WCRjGa8+kTr0CzApU0+XXtRgwmzIf1SeKSGAv+2scAlW6JR5PMFo6FzqqZ64Po79cKODKf3/AAmECqA=="],
-
-    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-lRCJv/Vi3Vlwmbd6K+oQ0KhLHMAysN8lXoCI7XeHlxaajk06u7G+UsFSO01NAs5iYuWKmVZjmiOzJ0OJmGsMwg=="],
-
-    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-gEhi/jSBhZ2m6wjV530Yy8+fNqG8PAinM3oV7CyO+6c3CEh16Eizm21uHVsyVBEB6RIM8JHIl6AGYCv6Q6Q9Tg=="],
-
-    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@1.9.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-tlbhLk+WXZmgwoIKwHIHEBZUwxml7bRJgk0X2sPyNR3S93cdRq6XulAZRQJ17FYGGzWne0fgrXBKpl7l4M87Hg=="],
-
-    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@1.9.4", "", { "os": "win32", "cpu": "x64" }, "sha512-8Y5wMhVIPaWe6jw2H+KlEm4wP/f7EW3810ZLmDlrEEy5KvBsb9ECEfu/kMWD484ijfQ8+nIi0giMgu9g1UAuuA=="],
-
-    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
-
-    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
-
-    "@types/react": ["@types/react@19.2.14", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w=="],
-
-    "ansi-escapes": ["ansi-escapes@7.3.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg=="],
-
-    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
-
-    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
-
-    "auto-bind": ["auto-bind@5.0.1", "", {}, "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg=="],
-
-    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
-
-    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
-
-    "cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
-
-    "cli-cursor": ["cli-cursor@4.0.0", "", { "dependencies": { "restore-cursor": "^4.0.0" } }, "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg=="],
-
-    "cli-spinners": ["cli-spinners@2.9.2", "", {}, "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg=="],
-
-    "cli-truncate": ["cli-truncate@5.1.1", "", { "dependencies": { "slice-ansi": "^7.1.0", "string-width": "^8.0.0" } }, "sha512-SroPvNHxUnk+vIW/dOSfNqdy1sPEFkrTk6TUtqLCnBlo3N7TNYYkzzN7uSD6+jVjrdO4+p8nH7JzH6cIvUem6A=="],
-
-    "code-excerpt": ["code-excerpt@4.0.0", "", { "dependencies": { "convert-to-spaces": "^2.0.1" } }, "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA=="],
-
-    "commander": ["commander@13.1.0", "", {}, "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw=="],
-
-    "convert-to-spaces": ["convert-to-spaces@2.0.1", "", {}, "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ=="],
-
-    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
-
-    "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
-
-    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
-
-    "es-toolkit": ["es-toolkit@1.44.0", "", {}, "sha512-6penXeZalaV88MM3cGkFZZfOoLGWshWWfdy0tWw/RlVVyhvMaWSBTOvXNeiW3e5FwdS5ePW0LGEu17zT139ktg=="],
-
-    "escape-string-regexp": ["escape-string-regexp@2.0.0", "", {}, "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w=="],
-
-    "get-east-asian-width": ["get-east-asian-width@1.4.0", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],
-
-    "indent-string": ["indent-string@5.0.0", "", {}, "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg=="],
-
-    "ink": ["ink@6.7.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.2.4", "ansi-escapes": "^7.3.0", "ansi-styles": "^6.2.1", "auto-bind": "^5.0.1", "chalk": "^5.6.0", "cli-boxes": "^3.0.0", "cli-cursor": "^4.0.0", "cli-truncate": "^5.1.1", "code-excerpt": "^4.0.0", "es-toolkit": "^1.39.10", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "scheduler": "^0.27.0", "signal-exit": "^3.0.7", "slice-ansi": "^7.1.0", "stack-utils": "^2.0.6", "string-width": "^8.1.1", "terminal-size": "^4.0.1", "type-fest": "^5.4.1", "widest-line": "^6.0.0", "wrap-ansi": "^9.0.0", "ws": "^8.18.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.0.0", "react": ">=19.0.0", "react-devtools-core": "^6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-dhB16KfdTO8yYwF2K0E4wPXpL88tdrjjB6w44AZ0ljSktYoUQQcxccq9KL1vpRhk8JIa0A7B7zvjajHqI42teA=="],
-
-    "ink-spinner": ["ink-spinner@5.0.0", "", { "dependencies": { "cli-spinners": "^2.7.0" }, "peerDependencies": { "ink": ">=4.0.0", "react": ">=18.0.0" } }, "sha512-EYEasbEjkqLGyPOUc8hBJZNuC5GvXGMLu0w5gdTNskPc7Izc5vO3tdQEYnzvshucyGCBXc86ig0ujXPMWaQCdA=="],
-
-    "ink-testing-library": ["ink-testing-library@4.0.0", "", { "peerDependencies": { "@types/react": ">=18.0.0" }, "optionalPeers": ["@types/react"] }, "sha512-yF92kj3pmBvk7oKbSq5vEALO//o7Z9Ck/OaLNlkzXNeYdwfpxMQkSowGTFUCS5MSu9bWfSZMewGpp7bFc66D7Q=="],
-
-    "is-fullwidth-code-point": ["is-fullwidth-code-point@5.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.1" } }, "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ=="],
-
-    "is-in-ci": ["is-in-ci@2.0.0", "", { "bin": { "is-in-ci": "cli.js" } }, "sha512-cFeerHriAnhrQSbpAxL37W1wcJKUUX07HyLWZCW1URJT/ra3GyUTzBgUnh24TMVfNTV2Hij2HLxkPHFZfOZy5w=="],
-
-    "json-schema-to-ts": ["json-schema-to-ts@3.1.1", "", { "dependencies": { "@babel/runtime": "^7.18.3", "ts-algebra": "^2.0.0" } }, "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g=="],
-
-    "mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
-
-    "onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
-
-    "patch-console": ["patch-console@2.0.0", "", {}, "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA=="],
-
-    "react": ["react@19.2.4", "", {}, "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ=="],
-
-    "react-devtools-core": ["react-devtools-core@7.0.1", "", { "dependencies": { "shell-quote": "^1.6.1", "ws": "^7" } }, "sha512-C3yNvRHaizlpiASzy7b9vbnBGLrhvdhl1CbdU6EnZgxPNbai60szdLtl+VL76UNOt5bOoVTOz5rNWZxgGt+Gsw=="],
-
-    "react-reconciler": ["react-reconciler@0.33.0", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.0" } }, "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA=="],
-
-    "restore-cursor": ["restore-cursor@4.0.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg=="],
-
-    "scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
-
-    "shell-quote": ["shell-quote@1.8.3", "", {}, "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw=="],
-
-    "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
-
-    "slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
-
-    "stack-utils": ["stack-utils@2.0.6", "", { "dependencies": { "escape-string-regexp": "^2.0.0" } }, "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ=="],
-
-    "string-width": ["string-width@8.1.1", "", { "dependencies": { "get-east-asian-width": "^1.3.0", "strip-ansi": "^7.1.0" } }, "sha512-KpqHIdDL9KwYk22wEOg/VIqYbrnLeSApsKT/bSj6Ez7pn3CftUiLAv2Lccpq1ALcpLV9UX1Ppn92npZWu2w/aw=="],
-
-    "strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
-
-    "tagged-tag": ["tagged-tag@1.0.0", "", {}, "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng=="],
-
-    "terminal-size": ["terminal-size@4.0.1", "", {}, "sha512-avMLDQpUI9I5XFrklECw1ZEUPJhqzcwSWsyyI8blhRLT+8N1jLJWLWWYQpB2q2xthq8xDvjZPISVh53T/+CLYQ=="],
-
-    "ts-algebra": ["ts-algebra@2.0.0", "", {}, "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw=="],
-
-    "type-fest": ["type-fest@5.4.4", "", { "dependencies": { "tagged-tag": "^1.0.0" } }, "sha512-JnTrzGu+zPV3aXIUhnyWJj4z/wigMsdYajGLIYakqyOW1nPllzXEJee0QQbHj+CTIQtXGlAjuK0UY+2xTyjVAw=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-
-    "widest-line": ["widest-line@6.0.0", "", { "dependencies": { "string-width": "^8.1.0" } }, "sha512-U89AsyEeAsyoF0zVJBkG9zBgekjgjK7yk9sje3F4IQpXBJ10TF6ByLlIfjMhcmHMJgHZI4KHt4rdNfktzxIAMA=="],
-
-    "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
-
-    "ws": ["ws@7.5.10", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": "^5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ=="],
-
-    "yoga-layout": ["yoga-layout@3.2.1", "", {}, "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ=="],
-
-    "zod": ["zod@4.3.6", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
-
-    "ink/ws": ["ws@8.19.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="],
-
-    "wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
-  }
-}

package/bunfig.toml

@@ -1,12 +0,0 @@
-# Bun Test Configuration
-
-[test]
-# Global test timeout: 30 seconds per test (unit/integration)
-# This prevents individual tests from hanging indefinitely
-timeout = 30000
-
-# Exclude nax dogfood feature directories (contain acceptance tests from nax runs, not source tests)
-exclude = ["nax/**"]
-
-[test]
-concurrent = 1

package/docker-compose.test.yml

@@ -1,15 +0,0 @@
-version: "3.9"
-services:
-  app:
-    image: nathapp/bun:1.3.8-ci
-    working_dir: /app
-    volumes:
-      - .:/app
-    command: >
-      sh -c "
-        bun install &&
-        bun run test
-      "    
-    environment:
-      - NAX_SKIP_PRECHECK=1
-      - CI=true

package/docs/20260216-fix-plan-context-review.md

@@ -1,56 +0,0 @@
-# Fix Plan: Context Builder Review Findings
-**Date:** 2026-02-16
-**Branch:** main (local commits only)
-
-## Phase 1: DRY + Token Estimation + Dead Config
-
-### Fix 1: Extract context building helper in runner.ts
-**File:** `src/execution/runner.ts`
-**Impact:** Code duplication between TDD and single-session paths
-**Change:** Extract the duplicated 8-line context building block (build + log) into a helper function like `maybeGetContext(story, config, useContext)` that returns `string | undefined`. Call it from both TDD and single-session branches.
-
-### Fix 2: Token estimation ratio
-**File:** `src/context/builder.ts`
-**Impact:** Budget underestimates for code (1:4 is too generous; code averages closer to 1:3)
-**Change:** Change `estimateTokens()` from `Math.ceil(text.length / 4)` to `Math.ceil(text.length / 3)`. Update any test assertions that check specific token counts.
-
-### Fix 3: Remove dead config paths
-**File:** `src/context/types.ts`, `src/context/builder.ts`, `src/execution/runner.ts`
-**Impact:** `includeConfig` and `includeDependencies` in `ContextBuilderConfig` are set but never read in `buildContext()`
-**Change:** Remove `includeConfig` and `includeDependencies` from `ContextBuilderConfig`. Remove them from the config object in `buildStoryContext()`. If dependencies should be used, wire them — otherwise remove the dead path. The `dependency` type in `ContextElement` can stay for future use.
-
-## Phase 2: Wire UserStory fields for real context
-
-### Fix 4: Add optional context fields to UserStory
-**File:** `src/prd/types.ts`
-**Change:** Add to `UserStory` interface:
-```ts
-/** Relevant source files for context injection */
-relevantFiles?: string[];
-/** Prior error messages from failed attempts */
-priorErrors?: string[];
-/** Custom context strings */
-customContext?: string[];
-```
-
-### Fix 5: Wire UserStory fields into buildStoryContext
-**File:** `src/execution/runner.ts`
-**Change:** Replace the hardcoded empty arrays in `buildStoryContext()` with actual values from `story`:
-```ts
-relevantFiles: story.relevantFiles || [],
-priorErrors: story.priorErrors,
-customContext: story.customContext,
-```
-
-### Fix 6: Populate priorErrors on retry
-**File:** `src/execution/runner.ts`
-**Change:** When a story fails and gets retried (escalation), capture the error/failure reason and push it to `story.priorErrors` so the next attempt gets context about what went wrong.
-
-## Test Strategy
-- Mode: test-after
-- Run: `bun test` after each phase
-- Update existing assertions in `test/context.test.ts` and `test/context-integration.test.ts` for token ratio change
-
-## Commits
-- Phase 1: `refactor: DRY context helper, fix token estimation, remove dead config`
-- Phase 2: `feat: wire UserStory context fields into context builder`