@nathapp/nax 0.28.0 → 0.29.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 (376) hide show
  1. package/CHANGELOG.md +13 -2
  2. package/dist/nax.js +72691 -0
  3. package/package.json +12 -4
  4. package/src/cli/config.ts +3 -1
  5. package/src/config/defaults.ts +1 -0
  6. package/src/config/schemas.ts +1 -0
  7. package/src/config/types.ts +1 -0
  8. package/src/context/builder.ts +10 -1
  9. package/src/prompts/sections/role-task.ts +4 -2
  10. package/src/review/runner.ts +6 -1
  11. package/src/version.ts +2 -1
  12. package/.claude/rules/01-project-conventions.md +0 -34
  13. package/.claude/rules/02-test-architecture.md +0 -39
  14. package/.claude/rules/03-test-writing.md +0 -58
  15. package/.claude/rules/04-forbidden-patterns.md +0 -29
  16. package/.claude/settings.json +0 -15
  17. package/.githooks/pre-commit +0 -16
  18. package/.gitlab-ci.yml +0 -103
  19. package/.mcp.json +0 -8
  20. package/BRIEF.md +0 -140
  21. package/CLAUDE.md +0 -143
  22. package/US-007-IMPLEMENTATION.md +0 -139
  23. package/biome.json +0 -14
  24. package/bun.lock +0 -163
  25. package/bunfig.toml +0 -12
  26. package/docker-compose.test.yml +0 -15
  27. package/docs/20260216-fix-plan-context-review.md +0 -56
  28. package/docs/20260216-relentless-vs-ngent-comparison.md +0 -208
  29. package/docs/20260216-v02-plan.md +0 -136
  30. package/docs/20260216-v02-review.md +0 -685
  31. package/docs/20260217-dogfood-findings.md +0 -56
  32. package/docs/20260217-p2-plus-plan.md +0 -117
  33. package/docs/20260217-partial-fixes-plan.md +0 -62
  34. package/docs/20260217-plan-analyze-spec.md +0 -117
  35. package/docs/20260217-post-impl-review.md +0 -1137
  36. package/docs/20260217-quick-wins-plan.md +0 -66
  37. package/docs/20260217-split-runner-plan.md +0 -75
  38. package/docs/20260217-v03-impl-plan.md +0 -80
  39. package/docs/20260217-v03-post-impl-review.md +0 -589
  40. package/docs/20260217-v04-impl-plan.md +0 -86
  41. package/docs/20260217-v05-post-impl-review.md +0 -850
  42. package/docs/20260217-v06-post-impl-review.md +0 -817
  43. package/docs/20260218-adr003-port-plan.md +0 -151
  44. package/docs/20260218-review-adr003-verification.md +0 -175
  45. package/docs/20260219-fix-plan-bug16-19.md +0 -79
  46. package/docs/20260219-fix-plan-bug20-22.md +0 -114
  47. package/docs/20260219-plan-llm-routing.md +0 -116
  48. package/docs/20260219-review-bug20-22-fixes.md +0 -135
  49. package/docs/20260219-routing-baseline-keyword.md +0 -63
  50. package/docs/20260220-plan-structured-logging-p1.md +0 -80
  51. package/docs/20260220-plan-structured-logging-p2.md +0 -37
  52. package/docs/20260220-review-llm-routing.md +0 -180
  53. package/docs/20260220-review-post-fix-llm-routing.md +0 -70
  54. package/docs/20260221-fix-plan-relevantfiles-split.md +0 -101
  55. package/docs/20260221-fix-plan-routing-mode.md +0 -125
  56. package/docs/20260221-review-v0.9-implementation.md +0 -379
  57. package/docs/20260222-fix-plan-v091-routing-isolation.md +0 -197
  58. package/docs/20260223-fix-plan-prompt-audit.md +0 -62
  59. package/docs/20260224-nax-roadmap-phases.md +0 -189
  60. package/docs/20260225-phase2-llm-service-layer.md +0 -401
  61. package/docs/20260225-review-v0.10.1.md +0 -187
  62. package/docs/20260303-v010-implementation-plan.md +0 -165
  63. package/docs/20260304-review-nax.md +0 -492
  64. package/docs/CLAUDE.md.bak +0 -191
  65. package/docs/ROADMAP.md +0 -390
  66. package/docs/SPEC-rectification.md +0 -0
  67. package/docs/SPEC.md +0 -324
  68. package/docs/US-001-plugin-loading-verification.md +0 -152
  69. package/docs/adr/ADR-005-implementation-plan.md +0 -655
  70. package/docs/adr/ADR-005-pipeline-re-architecture.md +0 -464
  71. package/docs/architecture-analysis.md +0 -1076
  72. package/docs/bugs/BUG-21-escalation-null-attempts.md +0 -48
  73. package/docs/bugs-from-dogfood-run-c.md +0 -243
  74. package/docs/code-review-20260228.md +0 -612
  75. package/docs/code-review-v0.15.0.md +0 -629
  76. package/docs/hook-lifecycle-test-plan.md +0 -149
  77. package/docs/releases/v0.11.0-and-earlier.md +0 -20
  78. package/docs/releases/v0.12.0.md +0 -15
  79. package/docs/releases/v0.13.0.md +0 -14
  80. package/docs/releases/v0.14.0.md +0 -20
  81. package/docs/releases/v0.14.1.md +0 -36
  82. package/docs/releases/v0.14.2.md +0 -51
  83. package/docs/releases/v0.14.3.md +0 -174
  84. package/docs/releases/v0.14.4.md +0 -94
  85. package/docs/releases/v0.15.0.md +0 -502
  86. package/docs/releases/v0.15.1.md +0 -170
  87. package/docs/releases/v0.15.3.md +0 -193
  88. package/docs/specs/bug-039-orphan-processes.md +0 -131
  89. package/docs/specs/bug-040-review-rectification.md +0 -82
  90. package/docs/specs/bug-041-cross-story-test-isolation.md +0 -88
  91. package/docs/specs/bug-042-verifier-failure-capture.md +0 -117
  92. package/docs/specs/bun-pty-migration.md +0 -171
  93. package/docs/specs/central-run-registry.md +0 -116
  94. package/docs/specs/feat-010-smart-runner-git-history.md +0 -96
  95. package/docs/specs/feat-011-file-context-strategy.md +0 -73
  96. package/docs/specs/feat-012-tdd-writer-tier.md +0 -79
  97. package/docs/specs/feat-013-test-after-review.md +0 -89
  98. package/docs/specs/feat-014-heartbeat-observability.md +0 -127
  99. package/docs/specs/status-file-consolidation.md +0 -93
  100. package/docs/specs/status-file-v0.10.1.md +0 -812
  101. package/docs/specs/trigger-completion.md +0 -145
  102. package/docs/specs/verification-architecture-v2.md +0 -343
  103. package/docs/tdd/strategies.md +0 -97
  104. package/docs/v0.10-global-config.md +0 -206
  105. package/docs/v0.10-plugin-system.md +0 -415
  106. package/docs/v0.10-prompt-optimizer.md +0 -234
  107. package/docs/v0.3-spec.md +0 -244
  108. package/docs/v0.4-spec.md +0 -140
  109. package/docs/v0.5-spec.md +0 -237
  110. package/docs/v0.6-spec.md +0 -371
  111. package/docs/v0.7-spec.md +0 -177
  112. package/docs/v0.8-llm-routing.md +0 -206
  113. package/docs/v0.8-structured-logging.md +0 -132
  114. package/docs/v0.9.3-prompt-audit.md +0 -112
  115. package/examples/plugins/console-reporter/index.test.ts +0 -207
  116. package/examples/plugins/console-reporter/index.ts +0 -110
  117. package/memory/topic/feat-010-baseref.md +0 -28
  118. package/memory/topic/feat-013-test-after-deprecation.md +0 -22
  119. package/nax/config.json +0 -154
  120. package/nax/features/bug-039-medium/prd.json +0 -45
  121. package/nax/features/bugfix-v0171/prd.json +0 -52
  122. package/nax/features/central-run-registry/prd.json +0 -105
  123. package/nax/features/config-management/prd.json +0 -108
  124. package/nax/features/config-management/progress.txt +0 -5
  125. package/nax/features/diagnose/acceptance.test.ts +0 -414
  126. package/nax/features/diagnose/prd.json +0 -41
  127. package/nax/features/nax-compliance/prd.json +0 -52
  128. package/nax/features/nax-compliance/progress.txt +0 -1
  129. package/nax/features/orchestration-fixes/prd.json +0 -89
  130. package/nax/features/orchestration-fixes/progress.txt +0 -1
  131. package/nax/features/plugin-integration/US-007-VERIFICATION.md +0 -259
  132. package/nax/features/plugin-integration/prd.json +0 -208
  133. package/nax/features/plugin-integration/progress.txt +0 -5
  134. package/nax/features/post-rearch-bugfix/prd.json +0 -137
  135. package/nax/features/precheck/prd.json +0 -205
  136. package/nax/features/precheck/progress.txt +0 -15
  137. package/nax/features/prompt-builder/prd.json +0 -152
  138. package/nax/features/prompt-builder/progress.txt +0 -3
  139. package/nax/features/review-quality/prd.json +0 -55
  140. package/nax/features/routing-persistence/prd.json +0 -104
  141. package/nax/features/routing-persistence/progress.txt +0 -1
  142. package/nax/features/smart-test-runner/plan.md +0 -7
  143. package/nax/features/smart-test-runner/prd.json +0 -203
  144. package/nax/features/smart-test-runner/progress.txt +0 -13
  145. package/nax/features/smart-test-runner/spec.md +0 -7
  146. package/nax/features/smart-test-runner/tasks.md +0 -8
  147. package/nax/features/status-file-consolidation/prd.json +0 -106
  148. package/nax/features/structured-logging/prd.json +0 -199
  149. package/nax/features/trigger-completion/prd.json +0 -150
  150. package/nax/features/trigger-completion/progress.txt +0 -7
  151. package/nax/features/unlock/prd.json +0 -36
  152. package/nax/features/v0.18.3-execution-reliability/prd.json +0 -80
  153. package/nax/features/v0.18.3-execution-reliability/progress.txt +0 -3
  154. package/nax/features/v0.19.0-hardening/plan.md +0 -7
  155. package/nax/features/v0.19.0-hardening/prd.json +0 -84
  156. package/nax/features/v0.19.0-hardening/progress.txt +0 -7
  157. package/nax/features/v0.19.0-hardening/spec.md +0 -18
  158. package/nax/features/v0.19.0-hardening/tasks.md +0 -8
  159. package/nax/features/verify-v2/prd.json +0 -79
  160. package/nax/features/verify-v2/progress.txt +0 -3
  161. package/nax/status.json +0 -36
  162. package/test/COVERAGE-GAPS.md +0 -333
  163. package/test/e2e/cm-003-default-view.test.ts +0 -195
  164. package/test/e2e/plan-analyze-run.test.ts +0 -902
  165. package/test/helpers/helpers.test.ts +0 -295
  166. package/test/helpers/timeout.ts +0 -42
  167. package/test/integration/US-002-TEST-SUMMARY.md +0 -107
  168. package/test/integration/US-003-TEST-SUMMARY.md +0 -149
  169. package/test/integration/US-004-TEST-SUMMARY.md +0 -106
  170. package/test/integration/US-005-TEST-SUMMARY.md +0 -138
  171. package/test/integration/US-007-TEST-SUMMARY.md +0 -100
  172. package/test/integration/cli/agent-validation.test.ts +0 -439
  173. package/test/integration/cli/cli-config-default-edge-cases.test.ts +0 -223
  174. package/test/integration/cli/cli-config-default-view.test.ts +0 -230
  175. package/test/integration/cli/cli-config-diff.test.ts +0 -461
  176. package/test/integration/cli/cli-config-prompts-explain.test.ts +0 -74
  177. package/test/integration/cli/cli-config.test.ts +0 -737
  178. package/test/integration/cli/cli-diagnose.test.ts +0 -595
  179. package/test/integration/cli/cli-logs.test.ts +0 -346
  180. package/test/integration/cli/cli-plugins.test.ts +0 -679
  181. package/test/integration/cli/cli-precheck.test.ts +0 -372
  182. package/test/integration/cli/cli-run-headless.test.ts +0 -174
  183. package/test/integration/cli/cli.test.ts +0 -76
  184. package/test/integration/cli/precheck-integration.test.ts +0 -476
  185. package/test/integration/cli/precheck-orchestrator.test.ts +0 -247
  186. package/test/integration/cli/precheck.test.ts +0 -806
  187. package/test/integration/config/config-loader.test.ts +0 -266
  188. package/test/integration/config/config.test.ts +0 -444
  189. package/test/integration/config/merger.test.ts +0 -466
  190. package/test/integration/config/paths.test.ts +0 -52
  191. package/test/integration/config/security-loader.test.ts +0 -83
  192. package/test/integration/context/context-integration.test.ts +0 -703
  193. package/test/integration/context/context-path-security.test.ts +0 -173
  194. package/test/integration/context/context-provider-injection.test.ts +0 -507
  195. package/test/integration/context/context-verification-integration.test.ts +0 -296
  196. package/test/integration/context/s5-greenfield-fallback.test.ts +0 -298
  197. package/test/integration/execution/execution-isolation.test.ts +0 -143
  198. package/test/integration/execution/execution.test.ts +0 -634
  199. package/test/integration/execution/feature-status-write.test.ts +0 -302
  200. package/test/integration/execution/parallel.test.ts +0 -251
  201. package/test/integration/execution/prd-pause.test.ts +0 -205
  202. package/test/integration/execution/prd-resolvers.test.ts +0 -186
  203. package/test/integration/execution/progress.test.ts +0 -34
  204. package/test/integration/execution/runner-batching.test.ts +0 -682
  205. package/test/integration/execution/runner-config-plugins.test.ts +0 -462
  206. package/test/integration/execution/runner-escalation.test.ts +0 -561
  207. package/test/integration/execution/runner-fixes.test.ts +0 -400
  208. package/test/integration/execution/runner-plugin-integration.test.ts +0 -544
  209. package/test/integration/execution/runner-queue-and-attempts.test.ts +0 -476
  210. package/test/integration/execution/status-file-integration.test.ts +0 -289
  211. package/test/integration/execution/status-file.test.ts +0 -380
  212. package/test/integration/execution/status-writer.test.ts +0 -447
  213. package/test/integration/execution/story-id-in-events.test.ts +0 -274
  214. package/test/integration/interaction/interaction-chain-pipeline.test.ts +0 -476
  215. package/test/integration/pipeline/hooks.test.ts +0 -363
  216. package/test/integration/pipeline/pipeline-acceptance.test.ts +0 -303
  217. package/test/integration/pipeline/pipeline-events.test.ts +0 -476
  218. package/test/integration/pipeline/pipeline.test.ts +0 -660
  219. package/test/integration/pipeline/reporter-lifecycle.test.ts +0 -862
  220. package/test/integration/pipeline/verify-stage.test.ts +0 -286
  221. package/test/integration/plan/analyze-integration.test.ts +0 -262
  222. package/test/integration/plan/analyze-scanner.test.ts +0 -132
  223. package/test/integration/plan/logger.test.ts +0 -461
  224. package/test/integration/plan/plan.test.ts +0 -157
  225. package/test/integration/plugins/config-integration.test.ts +0 -173
  226. package/test/integration/plugins/config-resolution.test.ts +0 -523
  227. package/test/integration/plugins/loader.test.ts +0 -644
  228. package/test/integration/plugins/plugins-registry.test.ts +0 -747
  229. package/test/integration/plugins/validator.test.ts +0 -564
  230. package/test/integration/prompts/pb-004-migration.test.ts +0 -523
  231. package/test/integration/review/review-config-commands.test.ts +0 -320
  232. package/test/integration/review/review-config-schema.test.ts +0 -117
  233. package/test/integration/review/review-plugin-integration.test.ts +0 -729
  234. package/test/integration/review/review.test.ts +0 -150
  235. package/test/integration/routing/plugin-routing-advanced.test.ts +0 -461
  236. package/test/integration/routing/plugin-routing-core.test.ts +0 -527
  237. package/test/integration/routing/routing-stage-bug-021.test.ts +0 -275
  238. package/test/integration/routing/routing-stage-greenfield.test.ts +0 -287
  239. package/test/integration/tdd/tdd-cleanup.test.ts +0 -246
  240. package/test/integration/tdd/tdd-orchestrator-core.test.ts +0 -565
  241. package/test/integration/tdd/tdd-orchestrator-failureCategory.test.ts +0 -355
  242. package/test/integration/tdd/tdd-orchestrator-fallback.test.ts +0 -311
  243. package/test/integration/tdd/tdd-orchestrator-lite.test.ts +0 -289
  244. package/test/integration/tdd/tdd-orchestrator-prompts.test.ts +0 -260
  245. package/test/integration/tdd/tdd-orchestrator-verdict.test.ts +0 -536
  246. package/test/integration/tmp/headless-test/test.jsonl +0 -30
  247. package/test/integration/verification/test-scanner.test.ts +0 -403
  248. package/test/integration/verification/verification-asset-check.test.ts +0 -143
  249. package/test/integration/worktree/manager.test.ts +0 -218
  250. package/test/integration/worktree/worktree-merge.test.ts +0 -341
  251. package/test/manual/logging-formatter-demo.ts +0 -158
  252. package/test/ui/tui-agent-panel.test.tsx +0 -99
  253. package/test/ui/tui-pty-integration.test.tsx +0 -146
  254. package/test/unit/acceptance.test.ts +0 -187
  255. package/test/unit/agent-stderr-capture.test.ts +0 -147
  256. package/test/unit/agents/claude.test.ts +0 -107
  257. package/test/unit/analyze-classifier.test.ts +0 -216
  258. package/test/unit/analyze.test.ts +0 -224
  259. package/test/unit/auto-detect.test.ts +0 -250
  260. package/test/unit/cli-status-project-level.test.ts +0 -283
  261. package/test/unit/cli-status.test.ts +0 -418
  262. package/test/unit/commands/common.test.ts +0 -321
  263. package/test/unit/commands/logs.test.ts +0 -458
  264. package/test/unit/commands/runs.test.ts +0 -303
  265. package/test/unit/commands/unlock.test.ts +0 -320
  266. package/test/unit/config/defaults.test.ts +0 -70
  267. package/test/unit/config/quality-commands-schema.test.ts +0 -72
  268. package/test/unit/config/regression-gate-schema.test.ts +0 -160
  269. package/test/unit/config/smart-runner-flag.test.ts +0 -250
  270. package/test/unit/constitution-generators.test.ts +0 -161
  271. package/test/unit/constitution.test.ts +0 -210
  272. package/test/unit/context/context-autodetect.test.ts +0 -297
  273. package/test/unit/context/context-build.test.ts +0 -575
  274. package/test/unit/context/context-coverage.test.ts +0 -236
  275. package/test/unit/context/context-error.test.ts +0 -93
  276. package/test/unit/context/context-estimate-tokens.test.ts +0 -201
  277. package/test/unit/context/context-format.test.ts +0 -302
  278. package/test/unit/context/context-isolation.test.ts +0 -267
  279. package/test/unit/context/context-sort.test.ts +0 -93
  280. package/test/unit/context/context-story.test.ts +0 -108
  281. package/test/unit/context/prior-failures.test.ts +0 -463
  282. package/test/unit/context.test.ts +0 -1726
  283. package/test/unit/cost.test.ts +0 -231
  284. package/test/unit/crash-recovery.test.ts +0 -309
  285. package/test/unit/escalation.test.ts +0 -127
  286. package/test/unit/execution/lifecycle/run-completion.test.ts +0 -240
  287. package/test/unit/execution/lifecycle/run-regression.test.ts +0 -420
  288. package/test/unit/execution/pid-registry.test.ts +0 -241
  289. package/test/unit/execution/sequential-executor.test.ts +0 -235
  290. package/test/unit/execution/sfc-004-dead-code-cleanup.test.ts +0 -89
  291. package/test/unit/execution/structured-failure.test.ts +0 -415
  292. package/test/unit/execution-logging-stderr.test.ts +0 -157
  293. package/test/unit/execution-stage.test.ts +0 -123
  294. package/test/unit/fix-generator.test.ts +0 -276
  295. package/test/unit/formatters.test.ts +0 -468
  296. package/test/unit/greenfield.test.ts +0 -180
  297. package/test/unit/hooks/shell-security.test.ts +0 -40
  298. package/test/unit/interaction/auto-plugin.test.ts +0 -162
  299. package/test/unit/interaction/human-review-trigger.test.ts +0 -165
  300. package/test/unit/interaction-network-failures.test.ts +0 -390
  301. package/test/unit/interaction-plugins.test.ts +0 -472
  302. package/test/unit/logging/formatter.test.ts +0 -456
  303. package/test/unit/merge.test.ts +0 -269
  304. package/test/unit/metrics/aggregator.test.ts +0 -164
  305. package/test/unit/metrics/tracker.test.ts +0 -186
  306. package/test/unit/metrics.test.ts +0 -276
  307. package/test/unit/optimizer/noop.optimizer.test.ts +0 -125
  308. package/test/unit/optimizer/rule-based.optimizer.test.ts +0 -358
  309. package/test/unit/pipeline/event-bus.test.ts +0 -105
  310. package/test/unit/pipeline/routing-partial-override.test.ts +0 -121
  311. package/test/unit/pipeline/runner-retry.test.ts +0 -89
  312. package/test/unit/pipeline/stages/autofix.test.ts +0 -97
  313. package/test/unit/pipeline/stages/completion-review-gate.test.ts +0 -218
  314. package/test/unit/pipeline/stages/execution-ambiguity.test.ts +0 -311
  315. package/test/unit/pipeline/stages/execution-merge-conflict.test.ts +0 -218
  316. package/test/unit/pipeline/stages/rectify.test.ts +0 -101
  317. package/test/unit/pipeline/stages/regression-stage.test.ts +0 -69
  318. package/test/unit/pipeline/stages/review.test.ts +0 -201
  319. package/test/unit/pipeline/stages/routing-idempotence.test.ts +0 -139
  320. package/test/unit/pipeline/stages/routing-initial-complexity.test.ts +0 -321
  321. package/test/unit/pipeline/stages/routing-persistence.test.ts +0 -380
  322. package/test/unit/pipeline/stages/verify.test.ts +0 -267
  323. package/test/unit/pipeline/subscribers/events-writer.test.ts +0 -227
  324. package/test/unit/pipeline/subscribers/hooks.test.ts +0 -84
  325. package/test/unit/pipeline/subscribers/interaction.test.ts +0 -313
  326. package/test/unit/pipeline/subscribers/registry.test.ts +0 -149
  327. package/test/unit/pipeline/subscribers/reporters.test.ts +0 -90
  328. package/test/unit/pipeline/verify-smart-runner.test.ts +0 -345
  329. package/test/unit/prd-auto-default.test.ts +0 -291
  330. package/test/unit/prd-failure-category.test.ts +0 -177
  331. package/test/unit/prd-get-next-story.test.ts +0 -215
  332. package/test/unit/precheck/checks-warnings.test.ts +0 -114
  333. package/test/unit/precheck-checks.test.ts +0 -841
  334. package/test/unit/precheck-story-size-gate.test.ts +0 -288
  335. package/test/unit/precheck-types.test.ts +0 -143
  336. package/test/unit/prompts/builder.test.ts +0 -258
  337. package/test/unit/prompts/loader.test.ts +0 -355
  338. package/test/unit/prompts/sections/conventions.test.ts +0 -30
  339. package/test/unit/prompts/sections/isolation.test.ts +0 -35
  340. package/test/unit/prompts/sections/role-task.test.ts +0 -40
  341. package/test/unit/prompts/sections/sections.test.ts +0 -238
  342. package/test/unit/prompts/sections/story.test.ts +0 -45
  343. package/test/unit/prompts/sections/verdict.test.ts +0 -58
  344. package/test/unit/prompts.test.ts +0 -476
  345. package/test/unit/queue.test.ts +0 -237
  346. package/test/unit/rectification.test.ts +0 -285
  347. package/test/unit/registry.test.ts +0 -288
  348. package/test/unit/review/runner.test.ts +0 -117
  349. package/test/unit/routing/content-hash.test.ts +0 -99
  350. package/test/unit/routing/routing-stability.test.ts +0 -208
  351. package/test/unit/routing/strategies/llm.test.ts +0 -306
  352. package/test/unit/routing-advanced.test.ts +0 -313
  353. package/test/unit/routing-core.test.ts +0 -341
  354. package/test/unit/routing-strategies.test.ts +0 -440
  355. package/test/unit/storyid-events.test.ts +0 -213
  356. package/test/unit/tdd-verdict.test.ts +0 -492
  357. package/test/unit/test-output-parser.test.ts +0 -377
  358. package/test/unit/ui/tui-controls.test.ts +0 -335
  359. package/test/unit/ui/tui-cost-and-pty.test.ts +0 -190
  360. package/test/unit/ui/tui-layout.test.ts +0 -379
  361. package/test/unit/ui/tui-stories.test.ts +0 -333
  362. package/test/unit/unit-isolation.test.ts +0 -135
  363. package/test/unit/utils/git.test.ts +0 -50
  364. package/test/unit/utils/path-security.test.ts +0 -47
  365. package/test/unit/utils-helpers.test.ts +0 -318
  366. package/test/unit/verdict.test.ts +0 -325
  367. package/test/unit/verification/orchestrator-types.test.ts +0 -54
  368. package/test/unit/verification/orchestrator.test.ts +0 -66
  369. package/test/unit/verification/smart-runner-config.test.ts +0 -163
  370. package/test/unit/verification/smart-runner-discovery.test.ts +0 -354
  371. package/test/unit/verification/smart-runner.test.ts +0 -262
  372. package/test/unit/verification/strategies/acceptance.test.ts +0 -33
  373. package/test/unit/verification/strategies/regression.test.ts +0 -87
  374. package/test/unit/verification/strategies/scoped.test.ts +0 -100
  375. package/test/unit/worktree-manager.test.ts +0 -159
  376. 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