@nathapp/nax 0.28.0 → 0.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (385) hide show
  1. package/CHANGELOG.md +23 -2
  2. package/bin/nax.ts +2 -3
  3. package/dist/nax.js +72753 -0
  4. package/package.json +11 -3
  5. package/src/cli/analyze.ts +2 -7
  6. package/src/cli/config.ts +3 -1
  7. package/src/config/defaults.ts +1 -0
  8. package/src/config/schemas.ts +1 -0
  9. package/src/config/types.ts +1 -0
  10. package/src/context/builder.ts +10 -1
  11. package/src/execution/lifecycle/headless-formatter.ts +2 -4
  12. package/src/prompts/builder.ts +12 -69
  13. package/src/prompts/sections/isolation.ts +38 -8
  14. package/src/prompts/sections/role-task.ts +79 -17
  15. package/src/review/runner.ts +6 -1
  16. package/src/version.ts +2 -1
  17. package/.claude/rules/01-project-conventions.md +0 -34
  18. package/.claude/rules/02-test-architecture.md +0 -39
  19. package/.claude/rules/03-test-writing.md +0 -58
  20. package/.claude/rules/04-forbidden-patterns.md +0 -29
  21. package/.claude/settings.json +0 -15
  22. package/.githooks/pre-commit +0 -16
  23. package/.gitlab-ci.yml +0 -103
  24. package/.mcp.json +0 -8
  25. package/BRIEF.md +0 -140
  26. package/CLAUDE.md +0 -143
  27. package/US-007-IMPLEMENTATION.md +0 -139
  28. package/biome.json +0 -14
  29. package/bun.lock +0 -163
  30. package/bunfig.toml +0 -12
  31. package/docker-compose.test.yml +0 -15
  32. package/docs/20260216-fix-plan-context-review.md +0 -56
  33. package/docs/20260216-relentless-vs-ngent-comparison.md +0 -208
  34. package/docs/20260216-v02-plan.md +0 -136
  35. package/docs/20260216-v02-review.md +0 -685
  36. package/docs/20260217-dogfood-findings.md +0 -56
  37. package/docs/20260217-p2-plus-plan.md +0 -117
  38. package/docs/20260217-partial-fixes-plan.md +0 -62
  39. package/docs/20260217-plan-analyze-spec.md +0 -117
  40. package/docs/20260217-post-impl-review.md +0 -1137
  41. package/docs/20260217-quick-wins-plan.md +0 -66
  42. package/docs/20260217-split-runner-plan.md +0 -75
  43. package/docs/20260217-v03-impl-plan.md +0 -80
  44. package/docs/20260217-v03-post-impl-review.md +0 -589
  45. package/docs/20260217-v04-impl-plan.md +0 -86
  46. package/docs/20260217-v05-post-impl-review.md +0 -850
  47. package/docs/20260217-v06-post-impl-review.md +0 -817
  48. package/docs/20260218-adr003-port-plan.md +0 -151
  49. package/docs/20260218-review-adr003-verification.md +0 -175
  50. package/docs/20260219-fix-plan-bug16-19.md +0 -79
  51. package/docs/20260219-fix-plan-bug20-22.md +0 -114
  52. package/docs/20260219-plan-llm-routing.md +0 -116
  53. package/docs/20260219-review-bug20-22-fixes.md +0 -135
  54. package/docs/20260219-routing-baseline-keyword.md +0 -63
  55. package/docs/20260220-plan-structured-logging-p1.md +0 -80
  56. package/docs/20260220-plan-structured-logging-p2.md +0 -37
  57. package/docs/20260220-review-llm-routing.md +0 -180
  58. package/docs/20260220-review-post-fix-llm-routing.md +0 -70
  59. package/docs/20260221-fix-plan-relevantfiles-split.md +0 -101
  60. package/docs/20260221-fix-plan-routing-mode.md +0 -125
  61. package/docs/20260221-review-v0.9-implementation.md +0 -379
  62. package/docs/20260222-fix-plan-v091-routing-isolation.md +0 -197
  63. package/docs/20260223-fix-plan-prompt-audit.md +0 -62
  64. package/docs/20260224-nax-roadmap-phases.md +0 -189
  65. package/docs/20260225-phase2-llm-service-layer.md +0 -401
  66. package/docs/20260225-review-v0.10.1.md +0 -187
  67. package/docs/20260303-v010-implementation-plan.md +0 -165
  68. package/docs/20260304-review-nax.md +0 -492
  69. package/docs/CLAUDE.md.bak +0 -191
  70. package/docs/ROADMAP.md +0 -390
  71. package/docs/SPEC-rectification.md +0 -0
  72. package/docs/SPEC.md +0 -324
  73. package/docs/US-001-plugin-loading-verification.md +0 -152
  74. package/docs/adr/ADR-005-implementation-plan.md +0 -655
  75. package/docs/adr/ADR-005-pipeline-re-architecture.md +0 -464
  76. package/docs/architecture-analysis.md +0 -1076
  77. package/docs/bugs/BUG-21-escalation-null-attempts.md +0 -48
  78. package/docs/bugs-from-dogfood-run-c.md +0 -243
  79. package/docs/code-review-20260228.md +0 -612
  80. package/docs/code-review-v0.15.0.md +0 -629
  81. package/docs/hook-lifecycle-test-plan.md +0 -149
  82. package/docs/releases/v0.11.0-and-earlier.md +0 -20
  83. package/docs/releases/v0.12.0.md +0 -15
  84. package/docs/releases/v0.13.0.md +0 -14
  85. package/docs/releases/v0.14.0.md +0 -20
  86. package/docs/releases/v0.14.1.md +0 -36
  87. package/docs/releases/v0.14.2.md +0 -51
  88. package/docs/releases/v0.14.3.md +0 -174
  89. package/docs/releases/v0.14.4.md +0 -94
  90. package/docs/releases/v0.15.0.md +0 -502
  91. package/docs/releases/v0.15.1.md +0 -170
  92. package/docs/releases/v0.15.3.md +0 -193
  93. package/docs/specs/bug-039-orphan-processes.md +0 -131
  94. package/docs/specs/bug-040-review-rectification.md +0 -82
  95. package/docs/specs/bug-041-cross-story-test-isolation.md +0 -88
  96. package/docs/specs/bug-042-verifier-failure-capture.md +0 -117
  97. package/docs/specs/bun-pty-migration.md +0 -171
  98. package/docs/specs/central-run-registry.md +0 -116
  99. package/docs/specs/feat-010-smart-runner-git-history.md +0 -96
  100. package/docs/specs/feat-011-file-context-strategy.md +0 -73
  101. package/docs/specs/feat-012-tdd-writer-tier.md +0 -79
  102. package/docs/specs/feat-013-test-after-review.md +0 -89
  103. package/docs/specs/feat-014-heartbeat-observability.md +0 -127
  104. package/docs/specs/status-file-consolidation.md +0 -93
  105. package/docs/specs/status-file-v0.10.1.md +0 -812
  106. package/docs/specs/trigger-completion.md +0 -145
  107. package/docs/specs/verification-architecture-v2.md +0 -343
  108. package/docs/tdd/strategies.md +0 -97
  109. package/docs/v0.10-global-config.md +0 -206
  110. package/docs/v0.10-plugin-system.md +0 -415
  111. package/docs/v0.10-prompt-optimizer.md +0 -234
  112. package/docs/v0.3-spec.md +0 -244
  113. package/docs/v0.4-spec.md +0 -140
  114. package/docs/v0.5-spec.md +0 -237
  115. package/docs/v0.6-spec.md +0 -371
  116. package/docs/v0.7-spec.md +0 -177
  117. package/docs/v0.8-llm-routing.md +0 -206
  118. package/docs/v0.8-structured-logging.md +0 -132
  119. package/docs/v0.9.3-prompt-audit.md +0 -112
  120. package/examples/plugins/console-reporter/index.test.ts +0 -207
  121. package/examples/plugins/console-reporter/index.ts +0 -110
  122. package/memory/topic/feat-010-baseref.md +0 -28
  123. package/memory/topic/feat-013-test-after-deprecation.md +0 -22
  124. package/nax/config.json +0 -154
  125. package/nax/features/bug-039-medium/prd.json +0 -45
  126. package/nax/features/bugfix-v0171/prd.json +0 -52
  127. package/nax/features/central-run-registry/prd.json +0 -105
  128. package/nax/features/config-management/prd.json +0 -108
  129. package/nax/features/config-management/progress.txt +0 -5
  130. package/nax/features/diagnose/acceptance.test.ts +0 -414
  131. package/nax/features/diagnose/prd.json +0 -41
  132. package/nax/features/nax-compliance/prd.json +0 -52
  133. package/nax/features/nax-compliance/progress.txt +0 -1
  134. package/nax/features/orchestration-fixes/prd.json +0 -89
  135. package/nax/features/orchestration-fixes/progress.txt +0 -1
  136. package/nax/features/plugin-integration/US-007-VERIFICATION.md +0 -259
  137. package/nax/features/plugin-integration/prd.json +0 -208
  138. package/nax/features/plugin-integration/progress.txt +0 -5
  139. package/nax/features/post-rearch-bugfix/prd.json +0 -137
  140. package/nax/features/precheck/prd.json +0 -205
  141. package/nax/features/precheck/progress.txt +0 -15
  142. package/nax/features/prompt-builder/prd.json +0 -152
  143. package/nax/features/prompt-builder/progress.txt +0 -3
  144. package/nax/features/review-quality/prd.json +0 -55
  145. package/nax/features/routing-persistence/prd.json +0 -104
  146. package/nax/features/routing-persistence/progress.txt +0 -1
  147. package/nax/features/smart-test-runner/plan.md +0 -7
  148. package/nax/features/smart-test-runner/prd.json +0 -203
  149. package/nax/features/smart-test-runner/progress.txt +0 -13
  150. package/nax/features/smart-test-runner/spec.md +0 -7
  151. package/nax/features/smart-test-runner/tasks.md +0 -8
  152. package/nax/features/status-file-consolidation/prd.json +0 -106
  153. package/nax/features/structured-logging/prd.json +0 -199
  154. package/nax/features/trigger-completion/prd.json +0 -150
  155. package/nax/features/trigger-completion/progress.txt +0 -7
  156. package/nax/features/unlock/prd.json +0 -36
  157. package/nax/features/v0.18.3-execution-reliability/prd.json +0 -80
  158. package/nax/features/v0.18.3-execution-reliability/progress.txt +0 -3
  159. package/nax/features/v0.19.0-hardening/plan.md +0 -7
  160. package/nax/features/v0.19.0-hardening/prd.json +0 -84
  161. package/nax/features/v0.19.0-hardening/progress.txt +0 -7
  162. package/nax/features/v0.19.0-hardening/spec.md +0 -18
  163. package/nax/features/v0.19.0-hardening/tasks.md +0 -8
  164. package/nax/features/verify-v2/prd.json +0 -79
  165. package/nax/features/verify-v2/progress.txt +0 -3
  166. package/nax/status.json +0 -36
  167. package/src/prompts/templates/implementer.ts +0 -6
  168. package/src/prompts/templates/single-session.ts +0 -6
  169. package/src/prompts/templates/test-writer.ts +0 -6
  170. package/src/prompts/templates/verifier.ts +0 -6
  171. package/test/COVERAGE-GAPS.md +0 -333
  172. package/test/e2e/cm-003-default-view.test.ts +0 -195
  173. package/test/e2e/plan-analyze-run.test.ts +0 -902
  174. package/test/helpers/helpers.test.ts +0 -295
  175. package/test/helpers/timeout.ts +0 -42
  176. package/test/integration/US-002-TEST-SUMMARY.md +0 -107
  177. package/test/integration/US-003-TEST-SUMMARY.md +0 -149
  178. package/test/integration/US-004-TEST-SUMMARY.md +0 -106
  179. package/test/integration/US-005-TEST-SUMMARY.md +0 -138
  180. package/test/integration/US-007-TEST-SUMMARY.md +0 -100
  181. package/test/integration/cli/agent-validation.test.ts +0 -439
  182. package/test/integration/cli/cli-config-default-edge-cases.test.ts +0 -223
  183. package/test/integration/cli/cli-config-default-view.test.ts +0 -230
  184. package/test/integration/cli/cli-config-diff.test.ts +0 -461
  185. package/test/integration/cli/cli-config-prompts-explain.test.ts +0 -74
  186. package/test/integration/cli/cli-config.test.ts +0 -737
  187. package/test/integration/cli/cli-diagnose.test.ts +0 -595
  188. package/test/integration/cli/cli-logs.test.ts +0 -346
  189. package/test/integration/cli/cli-plugins.test.ts +0 -679
  190. package/test/integration/cli/cli-precheck.test.ts +0 -372
  191. package/test/integration/cli/cli-run-headless.test.ts +0 -174
  192. package/test/integration/cli/cli.test.ts +0 -76
  193. package/test/integration/cli/precheck-integration.test.ts +0 -476
  194. package/test/integration/cli/precheck-orchestrator.test.ts +0 -247
  195. package/test/integration/cli/precheck.test.ts +0 -806
  196. package/test/integration/config/config-loader.test.ts +0 -266
  197. package/test/integration/config/config.test.ts +0 -444
  198. package/test/integration/config/merger.test.ts +0 -466
  199. package/test/integration/config/paths.test.ts +0 -52
  200. package/test/integration/config/security-loader.test.ts +0 -83
  201. package/test/integration/context/context-integration.test.ts +0 -703
  202. package/test/integration/context/context-path-security.test.ts +0 -173
  203. package/test/integration/context/context-provider-injection.test.ts +0 -507
  204. package/test/integration/context/context-verification-integration.test.ts +0 -296
  205. package/test/integration/context/s5-greenfield-fallback.test.ts +0 -298
  206. package/test/integration/execution/execution-isolation.test.ts +0 -143
  207. package/test/integration/execution/execution.test.ts +0 -634
  208. package/test/integration/execution/feature-status-write.test.ts +0 -302
  209. package/test/integration/execution/parallel.test.ts +0 -251
  210. package/test/integration/execution/prd-pause.test.ts +0 -205
  211. package/test/integration/execution/prd-resolvers.test.ts +0 -186
  212. package/test/integration/execution/progress.test.ts +0 -34
  213. package/test/integration/execution/runner-batching.test.ts +0 -682
  214. package/test/integration/execution/runner-config-plugins.test.ts +0 -462
  215. package/test/integration/execution/runner-escalation.test.ts +0 -561
  216. package/test/integration/execution/runner-fixes.test.ts +0 -400
  217. package/test/integration/execution/runner-plugin-integration.test.ts +0 -544
  218. package/test/integration/execution/runner-queue-and-attempts.test.ts +0 -476
  219. package/test/integration/execution/status-file-integration.test.ts +0 -289
  220. package/test/integration/execution/status-file.test.ts +0 -380
  221. package/test/integration/execution/status-writer.test.ts +0 -447
  222. package/test/integration/execution/story-id-in-events.test.ts +0 -274
  223. package/test/integration/interaction/interaction-chain-pipeline.test.ts +0 -476
  224. package/test/integration/pipeline/hooks.test.ts +0 -363
  225. package/test/integration/pipeline/pipeline-acceptance.test.ts +0 -303
  226. package/test/integration/pipeline/pipeline-events.test.ts +0 -476
  227. package/test/integration/pipeline/pipeline.test.ts +0 -660
  228. package/test/integration/pipeline/reporter-lifecycle.test.ts +0 -862
  229. package/test/integration/pipeline/verify-stage.test.ts +0 -286
  230. package/test/integration/plan/analyze-integration.test.ts +0 -262
  231. package/test/integration/plan/analyze-scanner.test.ts +0 -132
  232. package/test/integration/plan/logger.test.ts +0 -461
  233. package/test/integration/plan/plan.test.ts +0 -157
  234. package/test/integration/plugins/config-integration.test.ts +0 -173
  235. package/test/integration/plugins/config-resolution.test.ts +0 -523
  236. package/test/integration/plugins/loader.test.ts +0 -644
  237. package/test/integration/plugins/plugins-registry.test.ts +0 -747
  238. package/test/integration/plugins/validator.test.ts +0 -564
  239. package/test/integration/prompts/pb-004-migration.test.ts +0 -523
  240. package/test/integration/review/review-config-commands.test.ts +0 -320
  241. package/test/integration/review/review-config-schema.test.ts +0 -117
  242. package/test/integration/review/review-plugin-integration.test.ts +0 -729
  243. package/test/integration/review/review.test.ts +0 -150
  244. package/test/integration/routing/plugin-routing-advanced.test.ts +0 -461
  245. package/test/integration/routing/plugin-routing-core.test.ts +0 -527
  246. package/test/integration/routing/routing-stage-bug-021.test.ts +0 -275
  247. package/test/integration/routing/routing-stage-greenfield.test.ts +0 -287
  248. package/test/integration/tdd/tdd-cleanup.test.ts +0 -246
  249. package/test/integration/tdd/tdd-orchestrator-core.test.ts +0 -565
  250. package/test/integration/tdd/tdd-orchestrator-failureCategory.test.ts +0 -355
  251. package/test/integration/tdd/tdd-orchestrator-fallback.test.ts +0 -311
  252. package/test/integration/tdd/tdd-orchestrator-lite.test.ts +0 -289
  253. package/test/integration/tdd/tdd-orchestrator-prompts.test.ts +0 -260
  254. package/test/integration/tdd/tdd-orchestrator-verdict.test.ts +0 -536
  255. package/test/integration/tmp/headless-test/test.jsonl +0 -30
  256. package/test/integration/verification/test-scanner.test.ts +0 -403
  257. package/test/integration/verification/verification-asset-check.test.ts +0 -143
  258. package/test/integration/worktree/manager.test.ts +0 -218
  259. package/test/integration/worktree/worktree-merge.test.ts +0 -341
  260. package/test/manual/logging-formatter-demo.ts +0 -158
  261. package/test/ui/tui-agent-panel.test.tsx +0 -99
  262. package/test/ui/tui-pty-integration.test.tsx +0 -146
  263. package/test/unit/acceptance.test.ts +0 -187
  264. package/test/unit/agent-stderr-capture.test.ts +0 -147
  265. package/test/unit/agents/claude.test.ts +0 -107
  266. package/test/unit/analyze-classifier.test.ts +0 -216
  267. package/test/unit/analyze.test.ts +0 -224
  268. package/test/unit/auto-detect.test.ts +0 -250
  269. package/test/unit/cli-status-project-level.test.ts +0 -283
  270. package/test/unit/cli-status.test.ts +0 -418
  271. package/test/unit/commands/common.test.ts +0 -321
  272. package/test/unit/commands/logs.test.ts +0 -458
  273. package/test/unit/commands/runs.test.ts +0 -303
  274. package/test/unit/commands/unlock.test.ts +0 -320
  275. package/test/unit/config/defaults.test.ts +0 -70
  276. package/test/unit/config/quality-commands-schema.test.ts +0 -72
  277. package/test/unit/config/regression-gate-schema.test.ts +0 -160
  278. package/test/unit/config/smart-runner-flag.test.ts +0 -250
  279. package/test/unit/constitution-generators.test.ts +0 -161
  280. package/test/unit/constitution.test.ts +0 -210
  281. package/test/unit/context/context-autodetect.test.ts +0 -297
  282. package/test/unit/context/context-build.test.ts +0 -575
  283. package/test/unit/context/context-coverage.test.ts +0 -236
  284. package/test/unit/context/context-error.test.ts +0 -93
  285. package/test/unit/context/context-estimate-tokens.test.ts +0 -201
  286. package/test/unit/context/context-format.test.ts +0 -302
  287. package/test/unit/context/context-isolation.test.ts +0 -267
  288. package/test/unit/context/context-sort.test.ts +0 -93
  289. package/test/unit/context/context-story.test.ts +0 -108
  290. package/test/unit/context/prior-failures.test.ts +0 -463
  291. package/test/unit/context.test.ts +0 -1726
  292. package/test/unit/cost.test.ts +0 -231
  293. package/test/unit/crash-recovery.test.ts +0 -309
  294. package/test/unit/escalation.test.ts +0 -127
  295. package/test/unit/execution/lifecycle/run-completion.test.ts +0 -240
  296. package/test/unit/execution/lifecycle/run-regression.test.ts +0 -420
  297. package/test/unit/execution/pid-registry.test.ts +0 -241
  298. package/test/unit/execution/sequential-executor.test.ts +0 -235
  299. package/test/unit/execution/sfc-004-dead-code-cleanup.test.ts +0 -89
  300. package/test/unit/execution/structured-failure.test.ts +0 -415
  301. package/test/unit/execution-logging-stderr.test.ts +0 -157
  302. package/test/unit/execution-stage.test.ts +0 -123
  303. package/test/unit/fix-generator.test.ts +0 -276
  304. package/test/unit/formatters.test.ts +0 -468
  305. package/test/unit/greenfield.test.ts +0 -180
  306. package/test/unit/hooks/shell-security.test.ts +0 -40
  307. package/test/unit/interaction/auto-plugin.test.ts +0 -162
  308. package/test/unit/interaction/human-review-trigger.test.ts +0 -165
  309. package/test/unit/interaction-network-failures.test.ts +0 -390
  310. package/test/unit/interaction-plugins.test.ts +0 -472
  311. package/test/unit/logging/formatter.test.ts +0 -456
  312. package/test/unit/merge.test.ts +0 -269
  313. package/test/unit/metrics/aggregator.test.ts +0 -164
  314. package/test/unit/metrics/tracker.test.ts +0 -186
  315. package/test/unit/metrics.test.ts +0 -276
  316. package/test/unit/optimizer/noop.optimizer.test.ts +0 -125
  317. package/test/unit/optimizer/rule-based.optimizer.test.ts +0 -358
  318. package/test/unit/pipeline/event-bus.test.ts +0 -105
  319. package/test/unit/pipeline/routing-partial-override.test.ts +0 -121
  320. package/test/unit/pipeline/runner-retry.test.ts +0 -89
  321. package/test/unit/pipeline/stages/autofix.test.ts +0 -97
  322. package/test/unit/pipeline/stages/completion-review-gate.test.ts +0 -218
  323. package/test/unit/pipeline/stages/execution-ambiguity.test.ts +0 -311
  324. package/test/unit/pipeline/stages/execution-merge-conflict.test.ts +0 -218
  325. package/test/unit/pipeline/stages/rectify.test.ts +0 -101
  326. package/test/unit/pipeline/stages/regression-stage.test.ts +0 -69
  327. package/test/unit/pipeline/stages/review.test.ts +0 -201
  328. package/test/unit/pipeline/stages/routing-idempotence.test.ts +0 -139
  329. package/test/unit/pipeline/stages/routing-initial-complexity.test.ts +0 -321
  330. package/test/unit/pipeline/stages/routing-persistence.test.ts +0 -380
  331. package/test/unit/pipeline/stages/verify.test.ts +0 -267
  332. package/test/unit/pipeline/subscribers/events-writer.test.ts +0 -227
  333. package/test/unit/pipeline/subscribers/hooks.test.ts +0 -84
  334. package/test/unit/pipeline/subscribers/interaction.test.ts +0 -313
  335. package/test/unit/pipeline/subscribers/registry.test.ts +0 -149
  336. package/test/unit/pipeline/subscribers/reporters.test.ts +0 -90
  337. package/test/unit/pipeline/verify-smart-runner.test.ts +0 -345
  338. package/test/unit/prd-auto-default.test.ts +0 -291
  339. package/test/unit/prd-failure-category.test.ts +0 -177
  340. package/test/unit/prd-get-next-story.test.ts +0 -215
  341. package/test/unit/precheck/checks-warnings.test.ts +0 -114
  342. package/test/unit/precheck-checks.test.ts +0 -841
  343. package/test/unit/precheck-story-size-gate.test.ts +0 -288
  344. package/test/unit/precheck-types.test.ts +0 -143
  345. package/test/unit/prompts/builder.test.ts +0 -258
  346. package/test/unit/prompts/loader.test.ts +0 -355
  347. package/test/unit/prompts/sections/conventions.test.ts +0 -30
  348. package/test/unit/prompts/sections/isolation.test.ts +0 -35
  349. package/test/unit/prompts/sections/role-task.test.ts +0 -40
  350. package/test/unit/prompts/sections/sections.test.ts +0 -238
  351. package/test/unit/prompts/sections/story.test.ts +0 -45
  352. package/test/unit/prompts/sections/verdict.test.ts +0 -58
  353. package/test/unit/prompts.test.ts +0 -476
  354. package/test/unit/queue.test.ts +0 -237
  355. package/test/unit/rectification.test.ts +0 -285
  356. package/test/unit/registry.test.ts +0 -288
  357. package/test/unit/review/runner.test.ts +0 -117
  358. package/test/unit/routing/content-hash.test.ts +0 -99
  359. package/test/unit/routing/routing-stability.test.ts +0 -208
  360. package/test/unit/routing/strategies/llm.test.ts +0 -306
  361. package/test/unit/routing-advanced.test.ts +0 -313
  362. package/test/unit/routing-core.test.ts +0 -341
  363. package/test/unit/routing-strategies.test.ts +0 -440
  364. package/test/unit/storyid-events.test.ts +0 -213
  365. package/test/unit/tdd-verdict.test.ts +0 -492
  366. package/test/unit/test-output-parser.test.ts +0 -377
  367. package/test/unit/ui/tui-controls.test.ts +0 -335
  368. package/test/unit/ui/tui-cost-and-pty.test.ts +0 -190
  369. package/test/unit/ui/tui-layout.test.ts +0 -379
  370. package/test/unit/ui/tui-stories.test.ts +0 -333
  371. package/test/unit/unit-isolation.test.ts +0 -135
  372. package/test/unit/utils/git.test.ts +0 -50
  373. package/test/unit/utils/path-security.test.ts +0 -47
  374. package/test/unit/utils-helpers.test.ts +0 -318
  375. package/test/unit/verdict.test.ts +0 -325
  376. package/test/unit/verification/orchestrator-types.test.ts +0 -54
  377. package/test/unit/verification/orchestrator.test.ts +0 -66
  378. package/test/unit/verification/smart-runner-config.test.ts +0 -163
  379. package/test/unit/verification/smart-runner-discovery.test.ts +0 -354
  380. package/test/unit/verification/smart-runner.test.ts +0 -262
  381. package/test/unit/verification/strategies/acceptance.test.ts +0 -33
  382. package/test/unit/verification/strategies/regression.test.ts +0 -87
  383. package/test/unit/verification/strategies/scoped.test.ts +0 -100
  384. package/test/unit/worktree-manager.test.ts +0 -159
  385. package/tsconfig.json +0 -27
@@ -1,52 +0,0 @@
1
- {
2
- "project": "@nathapp/nax",
3
- "feature": "nax-compliance",
4
- "branchName": "feat/v0.19.0-sec",
5
- "createdAt": "2026-03-05T02:37:00Z",
6
- "updatedAt": "2026-03-05T02:38:46.450Z",
7
- "userStories": [
8
- {
9
- "id": "US-001",
10
- "title": "Node.js API Removal",
11
- "description": "Replace all forbidden Node.js APIs (readFileSync, appendFileSync, existsSync, setTimeout) with Bun-native equivalents (Bun.file().text(), Bun.write, Bun.file().exists(), Bun.sleep) across the codebase as per the v0.19.0 roadmap. Refer to .claude/rules/04-forbidden-patterns.md.",
12
- "acceptanceCriteria": [
13
- "No occurrences of readFileSync or appendFileSync remain in src/",
14
- "No occurrences of existsSync remain in src/ (unless performance critical)",
15
- "No occurrences of setTimeout remain in src/",
16
- "Codebase passes typecheck and lint after changes"
17
- ],
18
- "status": "failed",
19
- "passes": false,
20
- "attempts": 1,
21
- "routing": {
22
- "complexity": "simple",
23
- "modelTier": "powerful",
24
- "testStrategy": "test-after"
25
- },
26
- "priorErrors": [
27
- "Attempt 1 failed with model tier: fast: Stage requested escalation to higher tier",
28
- "Attempt 1 failed with model tier: balanced: Stage requested escalation to higher tier"
29
- ],
30
- "priorFailures": [
31
- {
32
- "attempt": 1,
33
- "modelTier": "fast",
34
- "stage": "escalation",
35
- "summary": "Failed with tier fast, escalating to next tier",
36
- "timestamp": "2026-03-05T02:37:41.586Z"
37
- },
38
- {
39
- "attempt": 1,
40
- "modelTier": "balanced",
41
- "stage": "escalation",
42
- "summary": "Failed with tier balanced, escalating to next tier",
43
- "timestamp": "2026-03-05T02:38:14.713Z"
44
- }
45
- ],
46
- "escalations": [],
47
- "dependencies": [],
48
- "tags": [],
49
- "storyPoints": 1
50
- }
51
- ]
52
- }
@@ -1 +0,0 @@
1
- [2026-03-05T02:38:46.450Z] US-001 — FAILED — Node.js API Removal — Execution failed
@@ -1,89 +0,0 @@
1
- {
2
- "project": "nax",
3
- "branchName": "feat/v0.18.0-orchestration-fixes",
4
- "feature": "orchestration-fixes",
5
- "userStories": [
6
- {
7
- "id": "BUG-021",
8
- "title": "Fix misleading Task classified log",
9
- "description": "The 'Task classified' log in routing.ts currently logs the raw LLM output even after config/cache overrides are applied. This makes it look like overrides are ignored when they aren't.\n\nFix: Ensure the log reflects the final routing state (ctx.routing) after all overrides and greenfield detection are finished.\n\nAcceptance criteria:\n1. Log shows final testStrategy/complexity/modelTier after all overrides\n2. Existing tests pass",
10
- "complexity": "simple",
11
- "status": "passed",
12
- "attempts": 0,
13
- "priorErrors": [
14
- "Attempt 1 failed with model tier: fast"
15
- ],
16
- "escalations": [],
17
- "dependencies": [],
18
- "tags": [],
19
- "acceptanceCriteria": [],
20
- "storyPoints": 1,
21
- "routing": {
22
- "complexity": "simple",
23
- "modelTier": "balanced",
24
- "testStrategy": "three-session-tdd-lite",
25
- "reasoning": "three-session-tdd-lite: strategy:lite"
26
- }
27
- },
28
- {
29
- "id": "BUG-022",
30
- "title": "Fix story interleaving in getNextStory()",
31
- "description": "When a story fails and escalates, getNextStory() currently round-robins to the next pending story. This wastes iterations by jumping between unrelated tasks.\n\nFix: Update getNextStory() in src/execution/sequential-executor.ts to prioritize retrying the current story until max attempts are reached before moving to the next story.\n\nAcceptance criteria:\n1. If current story is failed but has attempts remaining, it is picked again for retry\n2. Run order: S1-I1 -> S1-I2 (retry) -> S2-I1 (if S1 complete/failed out)\n3. Unit test for getNextStory() behavior",
32
- "complexity": "simple",
33
- "status": "passed",
34
- "attempts": 0,
35
- "priorErrors": [
36
- "Attempt 1 failed with model tier: fast"
37
- ],
38
- "escalations": [],
39
- "dependencies": [],
40
- "tags": [],
41
- "acceptanceCriteria": [],
42
- "storyPoints": 1,
43
- "routing": {
44
- "complexity": "simple",
45
- "modelTier": "balanced",
46
- "testStrategy": "three-session-tdd-lite",
47
- "reasoning": "three-session-tdd-lite: strategy:lite"
48
- }
49
- },
50
- {
51
- "id": "BUG-023",
52
- "title": "Log exitCode/stderr on agent failure",
53
- "description": "Agent session failures currently log 'rateLimited' but hide the actual exit code and stderr. This makes diagnosing silent failures (like 401, 500, or process crashes) difficult.\n\nFix: Audit src/agents/adapters/claude.ts and src/pipeline/stages/execution.ts. Ensure the 'Agent session failed' event includes exitCode and the tail of stderr in its data payload.\n\nAcceptance criteria:\n1. agent.complete event includes exitCode and stderr tail on failure\n2. Logs are machine-readable and don't break JSONL format",
54
- "complexity": "simple",
55
- "status": "passed",
56
- "attempts": 0,
57
- "priorErrors": [],
58
- "escalations": [],
59
- "dependencies": [],
60
- "tags": [],
61
- "acceptanceCriteria": [],
62
- "storyPoints": 1
63
- },
64
- {
65
- "id": "BUG-025",
66
- "title": "Integrate Interaction Chain into Runner Loop",
67
- "description": "The Interaction system is initialized but never called from the core orchestrator. This is a major integration task.\n\nFix:\n1. Add 'human-review' to TriggerName in src/interaction/types.ts and metadata in TRIGGER_METADATA\n2. Pass interactionChain from runner.ts -> executeSequential -> Pipeline\n3. Inject 'interaction' into PipelineContext\n4. Call executeTrigger('human-review', ...) when a story reaches max retries or a critical failure occurs\n5. Verify other triggers (security-review, story-ambiguity) are called at relevant pipeline stages\n\nAcceptance criteria:\n1. interactionChain is accessible in PipelineContext\n2. Story reaching max retries triggers a 'human-review' interaction request\n3. Test with CLI interaction plugin (non-headless)",
68
- "complexity": "medium",
69
- "status": "failed",
70
- "attempts": 1,
71
- "priorErrors": [
72
- "Attempt 1 failed with model tier: balanced"
73
- ],
74
- "escalations": [],
75
- "dependencies": [],
76
- "tags": [],
77
- "acceptanceCriteria": [],
78
- "storyPoints": 1,
79
- "routing": {
80
- "complexity": "complex",
81
- "modelTier": "powerful",
82
- "testStrategy": "three-session-tdd-lite",
83
- "reasoning": "three-session-tdd-lite: security-critical, strategy:lite"
84
- },
85
- "failureCategory": "session-failure"
86
- }
87
- ],
88
- "updatedAt": "2026-03-02T16:29:51.415Z"
89
- }
@@ -1 +0,0 @@
1
- [2026-03-02T16:29:51.415Z] BUG-025 — FAILED — Integrate Interaction Chain into Runner Loop — Execution failed
@@ -1,259 +0,0 @@
1
- # US-007: Read plugin config entries from nax config.json
2
-
3
- ## Verification Report
4
-
5
- **Date**: 2026-02-26
6
- **Status**: ✅ COMPLETE (Already Implemented)
7
- **Test Results**: 10/10 tests passing
8
-
9
- ---
10
-
11
- ## Implementation Summary
12
-
13
- US-007 functionality was already fully implemented. This verification confirms all acceptance criteria are met with comprehensive test coverage.
14
-
15
- ### Architecture
16
-
17
- The implementation follows this flow:
18
-
19
- ```
20
- config.json (plugins[])
21
- → loadConfig() (src/config/loader.ts)
22
- → runner/CLI extracts config.plugins
23
- → loadPlugins(globalDir, projectDir, configPlugins, projectRoot)
24
- → resolveModulePath() for each plugin
25
- → loadAndValidatePlugin(resolvedPath, config)
26
- → plugin.setup(config)
27
- ```
28
-
29
- ---
30
-
31
- ## Acceptance Criteria Verification
32
-
33
- ### ✅ AC1: plugins[] from config.json passed to loadPlugins()
34
-
35
- **Implementation:**
36
- - `src/execution/runner.ts:201-202`
37
- - `src/execution/run-lifecycle.ts:88-89`
38
- - `src/cli/plugins.ts:22-23`
39
-
40
- **Code:**
41
- ```typescript
42
- const configPlugins = config.plugins || [];
43
- const pluginRegistry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir);
44
- ```
45
-
46
- **Tests:** 2 tests in `config-resolution.test.ts`
47
-
48
- ---
49
-
50
- ### ✅ AC2: Relative module paths resolved relative to project root
51
-
52
- **Implementation:** `src/plugins/loader.ts:173-186`
53
-
54
- **Code:**
55
- ```typescript
56
- function resolveModulePath(modulePath: string, projectRoot?: string): string {
57
- // Absolute paths and npm packages work as-is
58
- if (path.isAbsolute(modulePath) || (!modulePath.startsWith("./") && !modulePath.startsWith("../"))) {
59
- return modulePath;
60
- }
61
-
62
- // Relative paths resolved relative to project root
63
- if (projectRoot) {
64
- return path.resolve(projectRoot, modulePath);
65
- }
66
-
67
- return path.resolve(modulePath);
68
- }
69
- ```
70
-
71
- **Tests:** 2 tests in `config-resolution.test.ts`
72
- - `./relative/path` resolution
73
- - `../parent/path` resolution
74
-
75
- ---
76
-
77
- ### ✅ AC3: Absolute paths and npm package names work as-is
78
-
79
- **Implementation:** `src/plugins/loader.ts:175-176`
80
-
81
- **Logic:**
82
- - Absolute paths: `path.isAbsolute(modulePath)` → return as-is
83
- - npm packages: No `./` or `../` prefix → return as-is
84
-
85
- **Tests:** 2 tests in `config-resolution.test.ts`
86
- - Absolute path loading
87
- - npm package name handling
88
-
89
- ---
90
-
91
- ### ✅ AC4: Clear error message when plugin module not found
92
-
93
- **Implementation:** `src/plugins/loader.ts:230-235`
94
-
95
- **Code:**
96
- ```typescript
97
- if (errorMsg.includes("Cannot find module") || errorMsg.includes("ENOENT")) {
98
- console.error(`[nax] Failed to load plugin module '${displayPath}'`);
99
- console.error(`[nax] Attempted path: ${modulePath}`);
100
- console.error(
101
- "[nax] Ensure the module exists and the path is correct (relative paths are resolved from project root)",
102
- );
103
- }
104
- ```
105
-
106
- **Error Output Example:**
107
- ```
108
- [nax] Failed to load plugin module './nonexistent/plugin.ts'
109
- [nax] Attempted path: /project/root/nonexistent/plugin.ts
110
- [nax] Ensure the module exists and the path is correct (relative paths are resolved from project root)
111
- ```
112
-
113
- **Tests:** 2 tests in `config-resolution.test.ts`
114
-
115
- ---
116
-
117
- ### ✅ AC5: Plugin-specific config passed to setup() function
118
-
119
- **Implementation:** `src/plugins/loader.ts:93, 215-221`
120
-
121
- **Code:**
122
- ```typescript
123
- // Extract config from entry
124
- const validated = await loadAndValidatePlugin(resolvedModule, entry.config ?? {}, entry.module);
125
-
126
- // Inside loadAndValidatePlugin:
127
- if (validated.setup) {
128
- try {
129
- await validated.setup(config);
130
- } catch (error) {
131
- console.error(`[nax] Plugin '${validated.name}' setup failed:`, error);
132
- return null;
133
- }
134
- }
135
- ```
136
-
137
- **Tests:** 2 tests in `config-resolution.test.ts`
138
- - Config passed correctly
139
- - Empty config when undefined
140
-
141
- ---
142
-
143
- ## Test Coverage
144
-
145
- ### Unit Tests: `test/integration/plugins/config-resolution.test.ts`
146
-
147
- ```
148
- ✅ AC1: plugins[] from config.json passed to loadPlugins
149
- ✅ loads plugins from config array
150
- ✅ loads multiple plugins from config array
151
-
152
- ✅ AC2: Relative module paths resolved relative to project root
153
- ✅ resolves ./relative/path from project root
154
- ✅ resolves ../relative/path from project root
155
-
156
- ✅ AC3: Absolute paths and npm packages work as-is
157
- ✅ loads plugin with absolute path
158
- ✅ treats non-relative paths as npm packages (doesn't crash)
159
-
160
- ✅ AC4: Clear error message when plugin module not found
161
- ✅ logs helpful error for missing relative path
162
- ✅ logs helpful error for missing absolute path
163
-
164
- ✅ AC5: Plugin-specific config passed to setup()
165
- ✅ passes config object to plugin setup function
166
- ✅ passes empty config object when config is undefined
167
-
168
- Total: 10 tests, 10 passing, 0 failing
169
- ```
170
-
171
- ### Integration Test: `test/integration/plugins/config-integration.test.ts`
172
-
173
- ```
174
- ✅ realistic scenario: project with relative plugin paths in config
175
- - Creates project with custom-plugins/ directory
176
- - Loads multiple plugins with relative paths
177
- - Verifies configs passed to each plugin's setup()
178
-
179
- Total: 1 test, 1 passing, 0 failing
180
- ```
181
-
182
- ### Overall Plugin Test Suite
183
-
184
- ```
185
- ✅ 102 plugin-related tests pass
186
- ✅ 0 failures
187
- ✅ 177 expect() calls
188
- ```
189
-
190
- ---
191
-
192
- ## Example Usage
193
-
194
- ### Config Format
195
-
196
- ```json
197
- {
198
- "version": 1,
199
- "plugins": [
200
- {
201
- "module": "./custom-plugins/my-plugin.ts",
202
- "config": {
203
- "apiKey": "key-123",
204
- "enabled": true
205
- }
206
- },
207
- {
208
- "module": "/absolute/path/to/plugin.js",
209
- "config": {
210
- "timeout": 5000
211
- }
212
- },
213
- {
214
- "module": "@org/nax-plugin-package"
215
- }
216
- ]
217
- }
218
- ```
219
-
220
- ### Path Resolution Examples
221
-
222
- | Config Path | Project Root | Resolved Path |
223
- |------------|--------------|---------------|
224
- | `./plugins/foo.ts` | `/home/user/project` | `/home/user/project/plugins/foo.ts` |
225
- | `../shared/bar.ts` | `/home/user/project` | `/home/user/shared/bar.ts` |
226
- | `/abs/path/baz.ts` | `/home/user/project` | `/abs/path/baz.ts` |
227
- | `@org/plugin` | `/home/user/project` | `@org/plugin` |
228
-
229
- ---
230
-
231
- ## Files Involved
232
-
233
- ### Implementation
234
- - `src/config/schema.ts` - PluginConfigEntry type definition
235
- - `src/config/loader.ts` - Config loading with plugins[] array
236
- - `src/plugins/loader.ts` - Plugin loading and path resolution
237
- - `src/execution/runner.ts` - Runner integration
238
- - `src/execution/run-lifecycle.ts` - Lifecycle integration
239
- - `src/cli/plugins.ts` - CLI command integration
240
-
241
- ### Tests
242
- - `test/integration/plugins/config-resolution.test.ts` - AC verification (10 tests)
243
- - `test/integration/plugins/config-integration.test.ts` - E2E test (1 test)
244
- - `test/integration/cli-plugins.test.ts` - CLI integration (9 tests)
245
-
246
- ---
247
-
248
- ## Conclusion
249
-
250
- ✅ **US-007 is fully implemented and verified**
251
-
252
- All acceptance criteria are met with comprehensive test coverage. The implementation correctly:
253
- 1. Reads plugins[] from config.json
254
- 2. Resolves relative paths against project root
255
- 3. Handles absolute paths and npm packages
256
- 4. Provides clear error messages
257
- 5. Passes plugin-specific config to setup()
258
-
259
- **No code changes required.** Implementation was completed in prior stories.
@@ -1,208 +0,0 @@
1
- {
2
- "project": "nax",
3
- "feature": "plugin-integration",
4
- "branchName": "feat/plugin-integration",
5
- "createdAt": "2026-02-26T22:00:00Z",
6
- "updatedAt": "2026-02-28T06:34:45Z",
7
- "userStories": [
8
- {
9
- "id": "US-001",
10
- "title": "Wire plugin loading into the runner startup",
11
- "description": "The runner (src/execution/runner.ts) should call loadPlugins() at startup and store the resulting PluginRegistry in the pipeline context. Currently loadPlugins() exists in src/plugins/loader.ts but is never called. The runner should: 1) resolve global dir (~/.nax/plugins), project dir (<workdir>/nax/plugins), and config.plugins[] entries, 2) call loadPlugins(), 3) store the registry on the RunContext or pass it through the pipeline. On teardown (run end), call registry.teardownAll().",
12
- "acceptanceCriteria": [
13
- "Runner calls loadPlugins() during initialization before story loop starts",
14
- "PluginRegistry is accessible from pipeline context (RunContext or similar)",
15
- "registry.teardownAll() is called on both success and failure paths",
16
- "If no plugins are found, an empty registry is used (no error)",
17
- "Plugin loading errors are logged but do not abort the run"
18
- ],
19
- "dependencies": [],
20
- "tags": [],
21
- "status": "passed",
22
- "passes": true,
23
- "attempts": 1,
24
- "escalations": [],
25
- "priorErrors": []
26
- },
27
- {
28
- "id": "US-002",
29
- "title": "Context providers inject into agent prompts",
30
- "description": "Before agent execution in the pipeline, call all registered context providers (registry.getContextProviders()) for the current story. Each provider returns {content, estimatedTokens, label}. Append provider content to the agent prompt under labeled sections, respecting a configurable token budget (default 2000 tokens total for all providers). If a provider throws, log warning and skip it. Add contextProviderTokenBudget to ExecutionConfig.",
31
- "acceptanceCriteria": [
32
- "All registered context providers are called before agent execution",
33
- "Provider content is appended to the prompt under a markdown section with the provider's label",
34
- "Total injected tokens respect the token budget (providers are added in order until budget exhausted)",
35
- "Provider errors are caught, logged, and skipped without failing the story",
36
- "Token budget is configurable via execution.contextProviderTokenBudget in config"
37
- ],
38
- "dependencies": [
39
- "US-001"
40
- ],
41
- "tags": [],
42
- "status": "passed",
43
- "passes": true,
44
- "attempts": 2,
45
- "escalations": [],
46
- "priorErrors": [
47
- "Implemented directly with Claude outside nax. Marked passed on cleanup 2026-02-28."
48
- ],
49
- "routing": {
50
- "complexity": "medium",
51
- "modelTier": "powerful",
52
- "testStrategy": "three-session-tdd-lite",
53
- "reasoning": "three-session-tdd-lite: security-critical, strategy:lite"
54
- }
55
- },
56
- {
57
- "id": "US-003",
58
- "title": "Review plugins run after built-in verification",
59
- "description": "After the built-in review checks (typecheck/lint/test) pass in the pipeline's review stage (src/pipeline/stages/), call all registered reviewer plugins (registry.getReviewers()). Each reviewer's check(workdir, changedFiles) returns {passed, output, exitCode?}. If any reviewer fails, treat it the same as a built-in check failure (triggers retry/escalation). Include reviewer output in the story result for debugging.",
60
- "acceptanceCriteria": [
61
- "Plugin reviewers run after built-in checks pass",
62
- "Each reviewer receives the workdir and list of changed files",
63
- "Reviewer failure triggers the same retry/escalation as built-in check failures",
64
- "Reviewer output is included in the story execution result",
65
- "If a reviewer throws an exception, it counts as a failure with the exception message as output",
66
- "Multiple reviewers run sequentially; first failure short-circuits remaining reviewers"
67
- ],
68
- "dependencies": [
69
- "US-001"
70
- ],
71
- "tags": [],
72
- "status": "passed",
73
- "passes": true,
74
- "attempts": 2,
75
- "escalations": [],
76
- "priorErrors": [
77
- "Implemented directly with Claude outside nax. Marked passed on cleanup 2026-02-28."
78
- ],
79
- "routing": {
80
- "complexity": "medium",
81
- "modelTier": "powerful",
82
- "testStrategy": "three-session-tdd-lite",
83
- "reasoning": "three-session-tdd-lite: strategy:lite"
84
- }
85
- },
86
- {
87
- "id": "US-004",
88
- "title": "Reporter plugins receive lifecycle events",
89
- "description": "Fire reporter events at the appropriate points in the runner loop: onRunStart when the run begins, onStoryComplete after each story finishes (success or failure), onRunEnd when the run completes. All reporter calls are fire-and-forget (errors logged, never block pipeline). Build event objects from existing run state (RunStartEvent, StoryCompleteEvent, RunEndEvent as defined in src/plugins/types.ts).",
90
- "acceptanceCriteria": [
91
- "onRunStart fires once at run start with runId, feature, totalStories, startTime",
92
- "onStoryComplete fires after each story with storyId, status, durationMs, cost, tier, testStrategy",
93
- "onRunEnd fires once at run end with runId, totalDurationMs, totalCost, storySummary counts",
94
- "Reporter errors are caught and logged but never block execution",
95
- "Multiple reporters all receive events (not short-circuited on error)",
96
- "Events fire even when the run fails or is aborted (onRunEnd still fires)"
97
- ],
98
- "dependencies": [
99
- "US-001"
100
- ],
101
- "tags": [],
102
- "status": "passed",
103
- "passes": true,
104
- "attempts": 1,
105
- "escalations": [],
106
- "priorErrors": [
107
- "Implemented directly with Claude outside nax. Marked passed on cleanup 2026-02-28."
108
- ],
109
- "routing": {
110
- "complexity": "medium",
111
- "modelTier": "powerful",
112
- "testStrategy": "three-session-tdd-lite",
113
- "reasoning": "three-session-tdd-lite: strategy:lite"
114
- }
115
- },
116
- {
117
- "id": "US-005",
118
- "title": "Plugin routing strategies integrate into router chain",
119
- "description": "Insert plugin routing strategies (registry.getRouters()) before the built-in router in the routing chain (src/routing/). When routing a story, iterate plugin routers first; if any returns a routing decision, use it. If all plugin routers return null/undefined, fall back to the built-in strategy. This allows plugins to override routing for specific stories (e.g., always route security-tagged stories to premium).",
120
- "acceptanceCriteria": [
121
- "Plugin routers are tried before the built-in routing strategy",
122
- "First plugin router that returns a non-null result wins",
123
- "If all plugin routers return null, built-in strategy is used as fallback",
124
- "Plugin routers receive the same story context as built-in routers",
125
- "Router errors are caught and logged; fallback to next router in chain"
126
- ],
127
- "dependencies": [
128
- "US-001"
129
- ],
130
- "tags": [],
131
- "status": "passed",
132
- "passes": true,
133
- "attempts": 2,
134
- "escalations": [],
135
- "priorErrors": [
136
- "Implemented directly with Claude outside nax. Marked passed on cleanup 2026-02-28."
137
- ]
138
- },
139
- {
140
- "id": "US-006",
141
- "title": "CLI 'nax plugins list' command",
142
- "description": "Add a 'plugins' subcommand to the CLI (src/cli/) with a 'list' action. It should: 1) load plugins from global + project + config sources (reuse loadPlugins), 2) display a table with name, version, provides[], and source (global/project/config), 3) exit cleanly. If no plugins found, print a helpful message pointing to docs.",
143
- "acceptanceCriteria": [
144
- "Running 'nax plugins list' prints a formatted table of installed plugins",
145
- "Each row shows: plugin name, version, extension types provided, source location",
146
- "If no plugins found, prints 'No plugins installed' with help text",
147
- "Works in both project directory and outside (global-only scan outside project)",
148
- "Exit code 0 on success"
149
- ],
150
- "dependencies": [],
151
- "tags": [],
152
- "status": "passed",
153
- "passes": true,
154
- "attempts": 1,
155
- "escalations": [],
156
- "priorErrors": []
157
- },
158
- {
159
- "id": "US-007",
160
- "title": "Read plugin config entries from nax config.json",
161
- "description": "The config loader (src/config/loader.ts) already supports a plugins[] array in the schema. Ensure that when config is loaded, the plugins[] entries are passed to loadPlugins() as the configPlugins parameter. Each entry has {module, config?}. Validate that module paths resolve correctly (relative to project root). Add a helpful error message if a configured plugin module cannot be found.",
162
- "acceptanceCriteria": [
163
- "plugins[] from config.json are passed to loadPlugins() as configPlugins parameter",
164
- "Relative module paths in plugins[].module are resolved relative to project root",
165
- "Absolute module paths and npm package names work as-is",
166
- "If a plugin module cannot be found, a clear error message is logged with the path tried",
167
- "Plugin-specific config (plugins[].config) is passed to the plugin's setup() function"
168
- ],
169
- "dependencies": [],
170
- "tags": [],
171
- "status": "passed",
172
- "passes": true,
173
- "attempts": 1,
174
- "escalations": [],
175
- "priorErrors": []
176
- },
177
- {
178
- "id": "US-008",
179
- "title": "Sample console reporter plugin with tests",
180
- "description": "Create a sample reporter plugin at examples/plugins/console-reporter/ that demonstrates the plugin API. It should: 1) implement IReporter with onRunStart (print banner), onStoryComplete (print status line), onRunEnd (print summary table), 2) have a setup() that reads config.verbose for detail level, 3) include unit tests in the same directory. This serves as both documentation and a smoke test for the plugin system.",
181
- "acceptanceCriteria": [
182
- "Plugin exports a valid NaxPlugin with provides: ['reporter']",
183
- "onRunStart prints a run banner with feature name and story count",
184
- "onStoryComplete prints a status line (\u2713/\u2717) with story ID, tier, duration, cost",
185
- "onRunEnd prints a summary table with total stories, pass/fail counts, total cost, total duration",
186
- "setup() reads config.verbose (boolean, default false) for extra detail",
187
- "Plugin passes validatePlugin() from src/plugins/validator.ts",
188
- "Unit tests verify all three event handlers produce expected output"
189
- ],
190
- "dependencies": [
191
- "US-004",
192
- "US-007"
193
- ],
194
- "tags": [],
195
- "status": "passed",
196
- "passes": true,
197
- "attempts": 1,
198
- "escalations": [],
199
- "priorErrors": [
200
- "Implemented directly with Claude outside nax. Marked passed on cleanup 2026-02-28."
201
- ]
202
- }
203
- ],
204
- "analyzeConfig": {
205
- "maxStories": 15,
206
- "granularity": "medium"
207
- }
208
- }
@@ -1,5 +0,0 @@
1
- [2026-02-26T16:06:18.213Z] US-001 — FAILED — Wire plugin loading into the runner startup — All tiers exhausted
2
- [2026-02-26T16:18:45.006Z] US-006 — FAILED — CLI 'nax plugins list' command — All tiers exhausted
3
- [2026-02-26T16:27:59.795Z] US-007 — FAILED — Read plugin config entries from nax config.json — All tiers exhausted
4
- [2026-02-26T17:26:43.751Z] US-002 — FAILED — Context providers inject into agent prompts — All tiers exhausted
5
- [2026-02-26T17:27:52.898Z] US-003 — FAILED — Review plugins run after built-in verification — All tiers exhausted