@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,288 +0,0 @@
1
- // RE-ARCH: keep
2
- /**
3
- * Tests for src/precheck/story-size-gate.ts
4
- *
5
- * Tests story size gate detection logic including heuristic signals
6
- * (AC count, description length, bullet points).
7
- */
8
-
9
- import { describe, expect, test } from "bun:test";
10
- import type { NaxConfig } from "../../src/config";
11
- import type { PRD, UserStory } from "../../src/prd/types";
12
- import { checkStorySizeGate } from "../../src/precheck/story-size-gate";
13
-
14
- // ─────────────────────────────────────────────────────────────────────────────
15
- // Test fixtures
16
- // ─────────────────────────────────────────────────────────────────────────────
17
-
18
- const createMockConfig = (
19
- storySizeGateConfig?: NaxConfig["precheck"],
20
- ): NaxConfig =>
21
- ({
22
- precheck: storySizeGateConfig,
23
- version: 1,
24
- models: {
25
- fast: "haiku",
26
- balanced: "sonnet",
27
- powerful: "opus",
28
- },
29
- autoMode: {
30
- enabled: false,
31
- defaultAgent: "test",
32
- fallbackOrder: [],
33
- complexityRouting: { simple: "fast", medium: "balanced", complex: "powerful", expert: "powerful" },
34
- escalation: { enabled: false, tierOrder: [] },
35
- },
36
- routing: { strategy: "keyword" },
37
- execution: {
38
- maxIterations: 10,
39
- iterationDelayMs: 1000,
40
- costLimit: 10,
41
- sessionTimeoutSeconds: 600,
42
- verificationTimeoutSeconds: 300,
43
- maxStoriesPerFeature: 100,
44
- rectification: {
45
- enabled: false,
46
- maxRetries: 0,
47
- fullSuiteTimeoutSeconds: 120,
48
- maxFailureSummaryChars: 2000,
49
- abortOnIncreasingFailures: true,
50
- },
51
- regressionGate: { enabled: false, timeoutSeconds: 120 },
52
- contextProviderTokenBudget: 2000,
53
- },
54
- quality: {
55
- requireTypecheck: false,
56
- requireLint: false,
57
- requireTests: false,
58
- commands: {},
59
- forceExit: false,
60
- detectOpenHandles: false,
61
- detectOpenHandlesRetries: 1,
62
- gracePeriodMs: 5000,
63
- drainTimeoutMs: 2000,
64
- shell: "/bin/sh",
65
- stripEnvVars: [],
66
- environmentalEscalationDivisor: 2,
67
- },
68
- tdd: {
69
- maxRetries: 0,
70
- autoVerifyIsolation: false,
71
- autoApproveVerifier: false,
72
- strategy: "off",
73
- },
74
- constitution: { enabled: false, path: "", maxTokens: 2000 },
75
- analyze: { llmEnhanced: false, model: "fast", fallbackToKeywords: true, maxCodebaseSummaryTokens: 5000 },
76
- review: { enabled: false, checks: [], commands: {} },
77
- plan: { model: "balanced", outputPath: "" },
78
- acceptance: { enabled: false, maxRetries: 0, generateTests: false, testPath: "" },
79
- context: {
80
- testCoverage: {
81
- enabled: false,
82
- detail: "names-only",
83
- maxTokens: 500,
84
- testPattern: "**/*.test.ts",
85
- scopeToStory: false,
86
- },
87
- autoDetect: { enabled: false, maxFiles: 5, traceImports: false },
88
- },
89
- }) as NaxConfig;
90
-
91
- const createMockStory = (overrides: Partial<UserStory> = {}): UserStory => ({
92
- id: "US-001",
93
- title: "Test story",
94
- description: "Test description",
95
- acceptanceCriteria: ["AC1"],
96
- tags: [],
97
- dependencies: [],
98
- status: "pending",
99
- passes: false,
100
- escalations: [],
101
- attempts: 0,
102
- ...overrides,
103
- });
104
-
105
- const createMockPRD = (stories: UserStory[] = []): PRD => ({
106
- project: "test-project",
107
- feature: "test-feature",
108
- branchName: "test-branch",
109
- userStories: stories,
110
- createdAt: new Date().toISOString(),
111
- updatedAt: new Date().toISOString(),
112
- });
113
-
114
- // ─────────────────────────────────────────────────────────────────────────────
115
- // Tests
116
- // ─────────────────────────────────────────────────────────────────────────────
117
-
118
- describe("checkStorySizeGate", () => {
119
- test("passes when gate is disabled", async () => {
120
- const config = createMockConfig({ storySizeGate: { enabled: false, maxAcCount: 6, maxDescriptionLength: 2000, maxBulletPoints: 8 } });
121
- const story = createMockStory({ acceptanceCriteria: Array(10).fill("AC") });
122
- const prd = createMockPRD([story]);
123
-
124
- const result = await checkStorySizeGate(config, prd);
125
-
126
- expect(result.check.passed).toBe(true);
127
- expect(result.check.tier).toBe("warning");
128
- expect(result.check.message).toContain("disabled");
129
- expect(result.flaggedStories).toHaveLength(0);
130
- });
131
-
132
- test("passes when no stories exceed thresholds", async () => {
133
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 6, maxDescriptionLength: 2000, maxBulletPoints: 8 } });
134
- const story = createMockStory({
135
- acceptanceCriteria: ["AC1", "AC2", "AC3"],
136
- description: "Short description",
137
- });
138
- const prd = createMockPRD([story]);
139
-
140
- const result = await checkStorySizeGate(config, prd);
141
-
142
- expect(result.check.passed).toBe(true);
143
- expect(result.check.tier).toBe("warning");
144
- expect(result.flaggedStories).toHaveLength(0);
145
- });
146
-
147
- test("flags story when AC count exceeds threshold", async () => {
148
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 6, maxDescriptionLength: 2000, maxBulletPoints: 8 } });
149
- const story = createMockStory({
150
- id: "US-001",
151
- acceptanceCriteria: Array(8).fill("AC"),
152
- description: "Short description",
153
- });
154
- const prd = createMockPRD([story]);
155
-
156
- const result = await checkStorySizeGate(config, prd);
157
-
158
- expect(result.check.passed).toBe(false);
159
- expect(result.check.tier).toBe("warning");
160
- expect(result.check.message).toContain("US-001");
161
- expect(result.flaggedStories).toHaveLength(1);
162
- expect(result.flaggedStories[0].storyId).toBe("US-001");
163
- expect(result.flaggedStories[0].signals.acCount.flagged).toBe(true);
164
- expect(result.flaggedStories[0].signals.acCount.value).toBe(8);
165
- });
166
-
167
- test("flags story when description length exceeds threshold", async () => {
168
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 6, maxDescriptionLength: 100, maxBulletPoints: 8 } });
169
- const longDescription = "a".repeat(150);
170
- const story = createMockStory({
171
- id: "US-002",
172
- acceptanceCriteria: ["AC1"],
173
- description: longDescription,
174
- });
175
- const prd = createMockPRD([story]);
176
-
177
- const result = await checkStorySizeGate(config, prd);
178
-
179
- expect(result.check.passed).toBe(false);
180
- expect(result.flaggedStories).toHaveLength(1);
181
- expect(result.flaggedStories[0].signals.descriptionLength.flagged).toBe(true);
182
- expect(result.flaggedStories[0].signals.descriptionLength.value).toBe(150);
183
- });
184
-
185
- test("flags story when bullet point count exceeds threshold", async () => {
186
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 6, maxDescriptionLength: 2000, maxBulletPoints: 5 } });
187
- const description = `
188
- Requirements:
189
- - Item 1
190
- - Item 2
191
- - Item 3
192
- - Item 4
193
- - Item 5
194
- - Item 6
195
- - Item 7
196
- `;
197
- const story = createMockStory({
198
- id: "US-003",
199
- acceptanceCriteria: ["AC1"],
200
- description,
201
- });
202
- const prd = createMockPRD([story]);
203
-
204
- const result = await checkStorySizeGate(config, prd);
205
-
206
- expect(result.check.passed).toBe(false);
207
- expect(result.flaggedStories).toHaveLength(1);
208
- expect(result.flaggedStories[0].signals.bulletPoints.flagged).toBe(true);
209
- expect(result.flaggedStories[0].signals.bulletPoints.value).toBeGreaterThan(5);
210
- });
211
-
212
- test("flags multiple stories when multiple exceed thresholds", async () => {
213
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 3, maxDescriptionLength: 50, maxBulletPoints: 5 } });
214
- const story1 = createMockStory({
215
- id: "US-001",
216
- acceptanceCriteria: Array(5).fill("AC"),
217
- });
218
- const story2 = createMockStory({
219
- id: "US-002",
220
- description: "a".repeat(100),
221
- });
222
- const prd = createMockPRD([story1, story2]);
223
-
224
- const result = await checkStorySizeGate(config, prd);
225
-
226
- expect(result.check.passed).toBe(false);
227
- expect(result.flaggedStories).toHaveLength(2);
228
- expect(result.flaggedStories[0].storyId).toBe("US-001");
229
- expect(result.flaggedStories[1].storyId).toBe("US-002");
230
- });
231
-
232
- test("only checks pending stories, ignores completed/failed/skipped", async () => {
233
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 3, maxDescriptionLength: 2000, maxBulletPoints: 8 } });
234
- const pendingStory = createMockStory({
235
- id: "US-001",
236
- status: "pending",
237
- acceptanceCriteria: Array(5).fill("AC"),
238
- });
239
- const passedStory = createMockStory({
240
- id: "US-002",
241
- status: "passed",
242
- acceptanceCriteria: Array(5).fill("AC"),
243
- });
244
- const failedStory = createMockStory({
245
- id: "US-003",
246
- status: "failed",
247
- acceptanceCriteria: Array(5).fill("AC"),
248
- });
249
- const prd = createMockPRD([pendingStory, passedStory, failedStory]);
250
-
251
- const result = await checkStorySizeGate(config, prd);
252
-
253
- expect(result.check.passed).toBe(false);
254
- expect(result.flaggedStories).toHaveLength(1);
255
- expect(result.flaggedStories[0].storyId).toBe("US-001");
256
- });
257
-
258
- test("uses default thresholds when config is not provided", async () => {
259
- const config = createMockConfig(undefined);
260
- const story = createMockStory({
261
- id: "US-001",
262
- acceptanceCriteria: Array(10).fill("AC"),
263
- });
264
- const prd = createMockPRD([story]);
265
-
266
- const result = await checkStorySizeGate(config, prd);
267
-
268
- // Default threshold is 6, so 10 AC should be flagged
269
- expect(result.check.passed).toBe(false);
270
- expect(result.flaggedStories).toHaveLength(1);
271
- });
272
-
273
- test("includes recommendation message in flagged story", async () => {
274
- const config = createMockConfig({ storySizeGate: { enabled: true, maxAcCount: 3, maxDescriptionLength: 2000, maxBulletPoints: 8 } });
275
- const story = createMockStory({
276
- id: "US-001",
277
- acceptanceCriteria: Array(5).fill("AC"),
278
- });
279
- const prd = createMockPRD([story]);
280
-
281
- const result = await checkStorySizeGate(config, prd);
282
-
283
- expect(result.flaggedStories[0].recommendation).toContain("US-001");
284
- expect(result.flaggedStories[0].recommendation).toContain("too large");
285
- expect(result.flaggedStories[0].recommendation).toContain("5 AC");
286
- expect(result.flaggedStories[0].recommendation).toContain("max 3");
287
- });
288
- });
@@ -1,143 +0,0 @@
1
- // RE-ARCH: keep
2
- /**
3
- * Tests for src/precheck/types.ts
4
- *
5
- * Tests the precheck type definitions including PrecheckResult, CheckStatus, and CheckTier.
6
- */
7
-
8
- import { describe, expect, test } from "bun:test";
9
- import type { Check, CheckStatus, CheckTier, PrecheckResult } from "../../src/precheck/types";
10
-
11
- describe("PrecheckResult type structure", () => {
12
- test("PrecheckResult has blockers array", () => {
13
- const result: PrecheckResult = {
14
- blockers: [],
15
- warnings: [],
16
- };
17
-
18
- expect(result.blockers).toBeDefined();
19
- expect(Array.isArray(result.blockers)).toBe(true);
20
- });
21
-
22
- test("PrecheckResult has warnings array", () => {
23
- const result: PrecheckResult = {
24
- blockers: [],
25
- warnings: [],
26
- };
27
-
28
- expect(result.warnings).toBeDefined();
29
- expect(Array.isArray(result.warnings)).toBe(true);
30
- });
31
-
32
- test("PrecheckResult can contain Check objects in blockers", () => {
33
- const check: Check = {
34
- name: "git-repo-exists",
35
- tier: "blocker",
36
- passed: false,
37
- message: "Not a git repository",
38
- };
39
-
40
- const result: PrecheckResult = {
41
- blockers: [check],
42
- warnings: [],
43
- };
44
-
45
- expect(result.blockers).toHaveLength(1);
46
- expect(result.blockers[0].name).toBe("git-repo-exists");
47
- expect(result.blockers[0].tier).toBe("blocker");
48
- expect(result.blockers[0].passed).toBe(false);
49
- });
50
-
51
- test("PrecheckResult can contain Check objects in warnings", () => {
52
- const check: Check = {
53
- name: "claude-md-exists",
54
- tier: "warning",
55
- passed: false,
56
- message: "CLAUDE.md not found",
57
- };
58
-
59
- const result: PrecheckResult = {
60
- blockers: [],
61
- warnings: [check],
62
- };
63
-
64
- expect(result.warnings).toHaveLength(1);
65
- expect(result.warnings[0].name).toBe("claude-md-exists");
66
- expect(result.warnings[0].tier).toBe("warning");
67
- });
68
- });
69
-
70
- describe("Check type structure", () => {
71
- test("Check has required name field", () => {
72
- const check: Check = {
73
- name: "test-check",
74
- tier: "blocker",
75
- passed: true,
76
- message: "Check passed",
77
- };
78
-
79
- expect(check.name).toBe("test-check");
80
- });
81
-
82
- test("Check has required tier field", () => {
83
- const check: Check = {
84
- name: "test-check",
85
- tier: "blocker",
86
- passed: true,
87
- message: "Check passed",
88
- };
89
-
90
- expect(check.tier).toBe("blocker");
91
- });
92
-
93
- test("Check has required passed field", () => {
94
- const check: Check = {
95
- name: "test-check",
96
- tier: "blocker",
97
- passed: false,
98
- message: "Check failed",
99
- };
100
-
101
- expect(check.passed).toBe(false);
102
- });
103
-
104
- test("Check has required message field", () => {
105
- const check: Check = {
106
- name: "test-check",
107
- tier: "blocker",
108
- passed: true,
109
- message: "All good",
110
- };
111
-
112
- expect(check.message).toBe("All good");
113
- });
114
- });
115
-
116
- describe("CheckTier type values", () => {
117
- test("CheckTier accepts blocker value", () => {
118
- const tier: CheckTier = "blocker";
119
- expect(tier).toBe("blocker");
120
- });
121
-
122
- test("CheckTier accepts warning value", () => {
123
- const tier: CheckTier = "warning";
124
- expect(tier).toBe("warning");
125
- });
126
- });
127
-
128
- describe("CheckStatus type values", () => {
129
- test("CheckStatus accepts passed value", () => {
130
- const status: CheckStatus = "passed";
131
- expect(status).toBe("passed");
132
- });
133
-
134
- test("CheckStatus accepts failed value", () => {
135
- const status: CheckStatus = "failed";
136
- expect(status).toBe("failed");
137
- });
138
-
139
- test("CheckStatus accepts skipped value", () => {
140
- const status: CheckStatus = "skipped";
141
- expect(status).toBe("skipped");
142
- });
143
- });
@@ -1,258 +0,0 @@
1
- /**
2
- * PromptBuilder unit tests — PB-001
3
- *
4
- * Tests verify section ordering, non-overridable sections, and override fallthrough.
5
- * All tests are expected to FAIL until PromptBuilder is implemented.
6
- */
7
-
8
- import { describe, expect, test } from "bun:test";
9
- import { mkdtempSync, writeFileSync } from "node:fs";
10
- import { tmpdir } from "node:os";
11
- import { join } from "node:path";
12
- import type { UserStory } from "../../../src/prd";
13
- import { PromptBuilder } from "../../../src/prompts/builder";
14
- import type { PromptRole } from "../../../src/prompts/types";
15
-
16
- // ---------------------------------------------------------------------------
17
- // Fixtures
18
- // ---------------------------------------------------------------------------
19
-
20
- function makeStory(overrides: Partial<UserStory> = {}): UserStory {
21
- return {
22
- id: "US-001",
23
- title: "Example story",
24
- description: "Do the thing",
25
- acceptanceCriteria: ["Criterion 1", "Criterion 2"],
26
- tags: [],
27
- dependencies: [],
28
- status: "pending",
29
- passes: false,
30
- escalations: [],
31
- ...overrides,
32
- };
33
- }
34
-
35
- const ROLES: PromptRole[] = ["test-writer", "implementer", "verifier", "single-session"];
36
-
37
- // ---------------------------------------------------------------------------
38
- // 1. Fluent API — builder returns itself for chaining
39
- // ---------------------------------------------------------------------------
40
-
41
- describe("PromptBuilder fluent API", () => {
42
- test("PromptBuilder.for() returns a PromptBuilder instance", () => {
43
- const builder = PromptBuilder.for("test-writer");
44
- expect(builder).toBeInstanceOf(PromptBuilder);
45
- });
46
-
47
- test(".story() is chainable", () => {
48
- const builder = PromptBuilder.for("implementer").story(makeStory());
49
- expect(builder).toBeInstanceOf(PromptBuilder);
50
- });
51
-
52
- test(".context() is chainable", () => {
53
- const builder = PromptBuilder.for("verifier").story(makeStory()).context("# Context");
54
- expect(builder).toBeInstanceOf(PromptBuilder);
55
- });
56
-
57
- test(".constitution() is chainable", () => {
58
- const builder = PromptBuilder.for("single-session").story(makeStory()).constitution("Be helpful.");
59
- expect(builder).toBeInstanceOf(PromptBuilder);
60
- });
61
-
62
- test(".override() is chainable", () => {
63
- const builder = PromptBuilder.for("test-writer").story(makeStory()).override("/tmp/override.md");
64
- expect(builder).toBeInstanceOf(PromptBuilder);
65
- });
66
-
67
- test(".build() returns a Promise<string>", async () => {
68
- const result = PromptBuilder.for("test-writer").story(makeStory()).build();
69
- expect(result).toBeInstanceOf(Promise);
70
- const text = await result;
71
- expect(typeof text).toBe("string");
72
- });
73
- });
74
-
75
- // ---------------------------------------------------------------------------
76
- // 2. Section ordering
77
- // ---------------------------------------------------------------------------
78
-
79
- describe("PromptBuilder section order", () => {
80
- test("constitution appears before role task", async () => {
81
- const prompt = await PromptBuilder.for("test-writer")
82
- .story(makeStory())
83
- .constitution("CONSTITUTION_MARKER")
84
- .build();
85
-
86
- const constitutionIdx = prompt.indexOf("CONSTITUTION_MARKER");
87
- const roleTaskIdx = prompt.indexOf("YOUR TASK") !== -1 ? prompt.indexOf("YOUR TASK") : prompt.indexOf("Your role");
88
-
89
- expect(constitutionIdx).toBeGreaterThanOrEqual(0);
90
- expect(roleTaskIdx).toBeGreaterThanOrEqual(0);
91
- expect(constitutionIdx).toBeLessThan(roleTaskIdx);
92
- });
93
-
94
- test("story context appears before conventions footer", async () => {
95
- const story = makeStory({ title: "STORY_TITLE_MARKER" });
96
- const prompt = await PromptBuilder.for("implementer").story(story).build();
97
-
98
- const storyIdx = prompt.indexOf("STORY_TITLE_MARKER");
99
- // Conventions footer is always last — it contains "conventions" or appears after story
100
- const footerIdx = prompt.lastIndexOf("conventions") !== -1 ? prompt.lastIndexOf("conventions") : prompt.length - 1;
101
-
102
- expect(storyIdx).toBeGreaterThanOrEqual(0);
103
- expect(storyIdx).toBeLessThan(footerIdx);
104
- });
105
-
106
- test("isolation rules appear after role task body", async () => {
107
- const prompt = await PromptBuilder.for("test-writer").story(makeStory()).build();
108
-
109
- // Isolation rules section — comes after the main role task body
110
- const isolationIdx = prompt.indexOf("isolation") !== -1 ? prompt.indexOf("isolation") : prompt.indexOf("ISOLATION");
111
-
112
- expect(isolationIdx).toBeGreaterThanOrEqual(0);
113
- });
114
-
115
- test("context markdown appears before conventions footer", async () => {
116
- const ctxMarker = "CONTEXT_MARKDOWN_MARKER";
117
- const prompt = await PromptBuilder.for("verifier").story(makeStory()).context(ctxMarker).build();
118
-
119
- const ctxIdx = prompt.indexOf(ctxMarker);
120
- const footerIdx = prompt.lastIndexOf("conventions") !== -1 ? prompt.lastIndexOf("conventions") : prompt.length;
121
-
122
- expect(ctxIdx).toBeGreaterThanOrEqual(0);
123
- expect(ctxIdx).toBeLessThan(footerIdx);
124
- });
125
-
126
- describe("section order for each role", () => {
127
- for (const role of ROLES) {
128
- test(`role ${role}: constitution → role task → story context → isolation rules → context md → conventions footer`, async () => {
129
- const story = makeStory({ title: `STORY_${role.toUpperCase()}` });
130
- const ctxMd = `CTXMD_${role.toUpperCase()}`;
131
- const prompt = await PromptBuilder.for(role)
132
- .story(story)
133
- .constitution("CONSTITUTION_BLOCK")
134
- .context(ctxMd)
135
- .build();
136
-
137
- const constitutionIdx = prompt.indexOf("CONSTITUTION_BLOCK");
138
- const storyIdx = prompt.indexOf(`STORY_${role.toUpperCase()}`);
139
- const ctxIdx = prompt.indexOf(ctxMd);
140
-
141
- // All markers present
142
- expect(constitutionIdx).toBeGreaterThanOrEqual(0);
143
- expect(storyIdx).toBeGreaterThanOrEqual(0);
144
- expect(ctxIdx).toBeGreaterThanOrEqual(0);
145
-
146
- // Ordering: constitution < story < ctx
147
- expect(constitutionIdx).toBeLessThan(storyIdx);
148
- expect(storyIdx).toBeLessThan(ctxIdx);
149
- });
150
- }
151
- });
152
- });
153
-
154
- // ---------------------------------------------------------------------------
155
- // 3. Non-overridable sections always present
156
- // ---------------------------------------------------------------------------
157
-
158
- describe("PromptBuilder non-overridable sections", () => {
159
- test("story context always included even when override is set", async () => {
160
- const tmpDir = mkdtempSync(join(tmpdir(), "nax-pb-test-"));
161
- const overridePath = join(tmpDir, "override.md");
162
- writeFileSync(overridePath, "# Custom override body\nThis replaces the template.");
163
-
164
- const story = makeStory({ title: "NON_OVERRIDABLE_STORY" });
165
- const prompt = await PromptBuilder.for("test-writer").story(story).override(overridePath).build();
166
-
167
- expect(prompt).toContain("NON_OVERRIDABLE_STORY");
168
- });
169
-
170
- test("conventions footer always last even when override is set", async () => {
171
- const tmpDir = mkdtempSync(join(tmpdir(), "nax-pb-test-"));
172
- const overridePath = join(tmpDir, "override.md");
173
- writeFileSync(overridePath, "# Custom override body");
174
-
175
- const prompt = await PromptBuilder.for("implementer").story(makeStory()).override(overridePath).build();
176
-
177
- // Conventions footer must exist and be after the override content
178
- const overrideIdx = prompt.indexOf("Custom override body");
179
- const conventionsIdx = prompt.lastIndexOf("conventions");
180
- expect(conventionsIdx).toBeGreaterThan(overrideIdx);
181
- });
182
-
183
- test("isolation rules always present even when override is set", async () => {
184
- const tmpDir = mkdtempSync(join(tmpdir(), "nax-pb-test-"));
185
- const overridePath = join(tmpDir, "override.md");
186
- writeFileSync(overridePath, "# My custom template");
187
-
188
- const prompt = await PromptBuilder.for("test-writer").story(makeStory()).override(overridePath).build();
189
-
190
- // Isolation rules must appear somewhere in the final prompt
191
- const lowerPrompt = prompt.toLowerCase();
192
- const hasIsolation = lowerPrompt.includes("isolation") || lowerPrompt.includes("isolat");
193
- expect(hasIsolation).toBe(true);
194
- });
195
-
196
- test("story context not removable via override for each role", async () => {
197
- const tmpDir = mkdtempSync(join(tmpdir(), "nax-pb-test-"));
198
- const overridePath = join(tmpDir, "override.md");
199
- writeFileSync(overridePath, "Override that attempts to hide story context.");
200
-
201
- for (const role of ROLES) {
202
- const story = makeStory({ title: `ROLE_${role}_TITLE` });
203
- const prompt = await PromptBuilder.for(role).story(story).override(overridePath).build();
204
- expect(prompt).toContain(`ROLE_${role}_TITLE`);
205
- }
206
- });
207
- });
208
-
209
- // ---------------------------------------------------------------------------
210
- // 4. Override fallthrough to default template
211
- // ---------------------------------------------------------------------------
212
-
213
- describe("PromptBuilder override fallthrough", () => {
214
- test("missing override file falls through to default template", async () => {
215
- const prompt = await PromptBuilder.for("test-writer")
216
- .story(makeStory({ title: "FALLTHROUGH_STORY" }))
217
- .override("/nonexistent/path/override.md")
218
- .build();
219
-
220
- // Should still contain story context (non-overridable)
221
- expect(prompt).toContain("FALLTHROUGH_STORY");
222
- // Should contain default role task content (not crash)
223
- expect(typeof prompt).toBe("string");
224
- expect(prompt.length).toBeGreaterThan(0);
225
- });
226
-
227
- test("no override set uses default template body", async () => {
228
- const promptWithout = await PromptBuilder.for("test-writer")
229
- .story(makeStory({ title: "DEFAULT_TEMPLATE_STORY" }))
230
- .build();
231
-
232
- expect(promptWithout).toContain("DEFAULT_TEMPLATE_STORY");
233
- expect(promptWithout.length).toBeGreaterThan(0);
234
- });
235
-
236
- test("valid override file replaces default template body", async () => {
237
- const tmpDir = mkdtempSync(join(tmpdir(), "nax-pb-test-"));
238
- const overridePath = join(tmpDir, "override.md");
239
- const overrideBody = "UNIQUE_OVERRIDE_BODY_CONTENT";
240
- writeFileSync(overridePath, overrideBody);
241
-
242
- const prompt = await PromptBuilder.for("implementer").story(makeStory()).override(overridePath).build();
243
-
244
- expect(prompt).toContain(overrideBody);
245
- });
246
- });
247
-
248
- // ---------------------------------------------------------------------------
249
- // 5. Types exported correctly
250
- // ---------------------------------------------------------------------------
251
-
252
- describe("src/prompts/types exports", () => {
253
- test("PromptRole values are correct literals", () => {
254
- // This is a compile-time check — if types.ts exports correctly, import works
255
- const roles: PromptRole[] = ["test-writer", "implementer", "verifier", "single-session"];
256
- expect(roles).toHaveLength(4);
257
- });
258
- });