@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,841 +0,0 @@
1
- // RE-ARCH: keep
2
- /**
3
- * Tests for src/precheck/checks.ts
4
- *
5
- * Tests individual precheck implementations including Tier 1 blockers and Tier 2 warnings.
6
- */
7
-
8
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
9
- import { chmodSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
10
- import { tmpdir } from "node:os";
11
- import { join } from "node:path";
12
- import type { ExecutionConfig, NaxConfig } from "../../src/config";
13
- import type { PRD, UserStory } from "../../src/prd/types";
14
- import {
15
- checkClaudeCLI,
16
- checkClaudeMdExists,
17
- checkDependenciesInstalled,
18
- checkDiskSpace,
19
- checkGitRepoExists,
20
- checkGitUserConfigured,
21
- checkGitignoreCoversNax,
22
- checkLintCommand,
23
- checkOptionalCommands,
24
- checkPRDValid,
25
- checkPendingStories,
26
- checkStaleLock,
27
- checkTestCommand,
28
- checkTypecheckCommand,
29
- checkWorkingTreeClean,
30
- } from "../../src/precheck/checks";
31
-
32
- // ─────────────────────────────────────────────────────────────────────────────
33
- // Test fixtures
34
- // ─────────────────────────────────────────────────────────────────────────────
35
-
36
- const createMockConfig = (overrides: Partial<ExecutionConfig> = {}): NaxConfig => ({
37
- execution: {
38
- maxIterations: 10,
39
- iterationDelayMs: 1000,
40
- maxCostUSD: 10,
41
- testCommand: "bun test",
42
- lintCommand: "bun run lint",
43
- typecheckCommand: "bun run typecheck",
44
- contextProviderTokenBudget: 2000,
45
- requireExplicitContextFiles: false,
46
- preflightExpectedFilesEnabled: false,
47
- cwd: process.cwd(),
48
- ...overrides,
49
- },
50
- autoMode: {
51
- enabled: false,
52
- defaultAgent: "test-agent",
53
- fallbackOrder: [],
54
- complexityRouting: {
55
- simple: "fast",
56
- medium: "balanced",
57
- complex: "powerful",
58
- expert: "ultra",
59
- },
60
- escalation: {
61
- enabled: true,
62
- tierOrder: [],
63
- },
64
- },
65
- quality: {
66
- minTestCoverage: 80,
67
- requireTypecheck: true,
68
- requireLint: true,
69
- },
70
- tdd: {
71
- strategy: "auto",
72
- skipGeneratedVerificationTests: false,
73
- },
74
- models: {},
75
- rectification: {
76
- enabled: true,
77
- maxRetries: 2,
78
- fullSuiteTimeoutSeconds: 120,
79
- maxFailureSummaryChars: 2000,
80
- abortOnIncreasingFailures: true,
81
- },
82
- });
83
-
84
- const createMockStory = (overrides: Partial<UserStory> = {}): UserStory => ({
85
- id: "US-001",
86
- title: "Test story",
87
- description: "Test description",
88
- acceptanceCriteria: ["AC1"],
89
- tags: [],
90
- dependencies: [],
91
- status: "pending",
92
- passes: false,
93
- escalations: [],
94
- attempts: 0,
95
- ...overrides,
96
- });
97
-
98
- const createMockPRD = (stories: UserStory[] = []): PRD => ({
99
- project: "test-project",
100
- feature: "test-feature",
101
- branchName: "test-branch",
102
- createdAt: new Date().toISOString(),
103
- updatedAt: new Date().toISOString(),
104
- userStories: stories.length > 0 ? stories : [createMockStory()],
105
- });
106
-
107
- // ─────────────────────────────────────────────────────────────────────────────
108
- // Tier 1 Blockers
109
- // ─────────────────────────────────────────────────────────────────────────────
110
-
111
- describe("checkGitRepoExists (Tier 1 blocker)", () => {
112
- let testDir: string;
113
-
114
- beforeEach(() => {
115
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
116
- });
117
-
118
- afterEach(() => {
119
- rmSync(testDir, { recursive: true, force: true });
120
- });
121
-
122
- test("passes when .git directory exists", async () => {
123
- // Create a .git directory
124
- mkdirSync(join(testDir, ".git"));
125
-
126
- const result = await checkGitRepoExists(testDir);
127
-
128
- expect(result.name).toBe("git-repo-exists");
129
- expect(result.tier).toBe("blocker");
130
- expect(result.passed).toBe(true);
131
- expect(result.message).toContain("git repository");
132
- });
133
-
134
- test("fails when .git directory does not exist", async () => {
135
- const result = await checkGitRepoExists(testDir);
136
-
137
- expect(result.name).toBe("git-repo-exists");
138
- expect(result.tier).toBe("blocker");
139
- expect(result.passed).toBe(false);
140
- expect(result.message).toContain("not a git repository");
141
- });
142
-
143
- test("uses git rev-parse --git-dir command", async () => {
144
- // This test verifies the implementation uses the correct git command
145
- // The actual implementation should run: git rev-parse --git-dir
146
- mkdirSync(join(testDir, ".git"));
147
-
148
- const result = await checkGitRepoExists(testDir);
149
-
150
- // If implemented correctly with git rev-parse, this should pass
151
- expect(result.passed).toBe(true);
152
- });
153
- });
154
-
155
- describe("checkWorkingTreeClean (Tier 1 blocker)", () => {
156
- let testDir: string;
157
-
158
- beforeEach(() => {
159
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
160
- // Initialize git repo
161
- mkdirSync(join(testDir, ".git"));
162
- });
163
-
164
- afterEach(() => {
165
- rmSync(testDir, { recursive: true, force: true });
166
- });
167
-
168
- test("uses git status --porcelain command", async () => {
169
- // This test verifies the implementation uses git status --porcelain
170
- const result = await checkWorkingTreeClean(testDir);
171
-
172
- expect(result.name).toBe("working-tree-clean");
173
- expect(result.tier).toBe("blocker");
174
- // Result depends on actual git status
175
- });
176
-
177
- test("returns blocker tier", async () => {
178
- const result = await checkWorkingTreeClean(testDir);
179
-
180
- expect(result.tier).toBe("blocker");
181
- });
182
-
183
- test("includes helpful message", async () => {
184
- const result = await checkWorkingTreeClean(testDir);
185
-
186
- expect(result.message).toBeDefined();
187
- expect(typeof result.message).toBe("string");
188
- });
189
- });
190
-
191
- describe("checkStaleLock (Tier 1 blocker)", () => {
192
- let testDir: string;
193
-
194
- beforeEach(() => {
195
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
196
- });
197
-
198
- afterEach(() => {
199
- rmSync(testDir, { recursive: true, force: true });
200
- });
201
-
202
- test("passes when no lock file exists", async () => {
203
- const result = await checkStaleLock(testDir);
204
-
205
- expect(result.name).toBe("no-stale-lock");
206
- expect(result.tier).toBe("blocker");
207
- expect(result.passed).toBe(true);
208
- expect(result.message).toContain("No lock file");
209
- });
210
-
211
- test("passes when lock file is fresh (< 2 hours old)", async () => {
212
- const lockPath = join(testDir, "nax.lock");
213
- writeFileSync(lockPath, JSON.stringify({ pid: 12345, startedAt: new Date().toISOString() }));
214
-
215
- const result = await checkStaleLock(testDir);
216
-
217
- expect(result.passed).toBe(true);
218
- expect(result.message).toContain("Lock file is fresh");
219
- });
220
-
221
- test("fails when lock file is stale (> 2 hours old)", async () => {
222
- const lockPath = join(testDir, "nax.lock");
223
- const threeHoursAgo = new Date(Date.now() - 3 * 60 * 60 * 1000);
224
- writeFileSync(lockPath, JSON.stringify({ pid: 12345, startedAt: threeHoursAgo.toISOString() }));
225
-
226
- const result = await checkStaleLock(testDir);
227
-
228
- expect(result.name).toBe("no-stale-lock");
229
- expect(result.tier).toBe("blocker");
230
- expect(result.passed).toBe(false);
231
- expect(result.message).toContain("stale");
232
- expect(result.message).toContain("2 hours");
233
- });
234
-
235
- test("detects exactly 2 hours as the threshold", async () => {
236
- const lockPath = join(testDir, "nax.lock");
237
- const twoHoursOneMinuteAgo = new Date(Date.now() - (2 * 60 * 60 * 1000 + 60 * 1000));
238
- writeFileSync(lockPath, JSON.stringify({ pid: 12345, startedAt: twoHoursOneMinuteAgo.toISOString() }));
239
-
240
- const result = await checkStaleLock(testDir);
241
-
242
- expect(result.passed).toBe(false);
243
- });
244
- });
245
-
246
- describe("checkPRDValid (Tier 1 blocker)", () => {
247
- test("passes when all stories have required fields", async () => {
248
- const prd = createMockPRD([
249
- createMockStory({ id: "US-001", title: "Story 1", description: "Description 1" }),
250
- createMockStory({ id: "US-002", title: "Story 2", description: "Description 2" }),
251
- ]);
252
-
253
- const result = await checkPRDValid(prd);
254
-
255
- expect(result.name).toBe("prd-valid");
256
- expect(result.tier).toBe("blocker");
257
- expect(result.passed).toBe(true);
258
- expect(result.message).toContain("valid");
259
- });
260
-
261
- test("fails when story is missing id", async () => {
262
- const prd = createMockPRD([createMockStory({ id: "", title: "Story", description: "Description" })]);
263
-
264
- const result = await checkPRDValid(prd);
265
-
266
- expect(result.passed).toBe(false);
267
- expect(result.message).toContain("id");
268
- });
269
-
270
- test("fails when story is missing title", async () => {
271
- const prd = createMockPRD([createMockStory({ id: "US-001", title: "", description: "Description" })]);
272
-
273
- const result = await checkPRDValid(prd);
274
-
275
- expect(result.passed).toBe(false);
276
- expect(result.message).toContain("title");
277
- });
278
-
279
- test("fails when story is missing description", async () => {
280
- const prd = createMockPRD([createMockStory({ id: "US-001", title: "Story", description: "" })]);
281
-
282
- const result = await checkPRDValid(prd);
283
-
284
- expect(result.passed).toBe(false);
285
- expect(result.message).toContain("description");
286
- });
287
-
288
- test("auto-defaults missing tags to empty array in-memory", async () => {
289
- const storyWithoutTags = {
290
- id: "US-001",
291
- title: "Story",
292
- description: "Description",
293
- acceptanceCriteria: [],
294
- dependencies: [],
295
- status: "pending" as const,
296
- passes: false,
297
- escalations: [],
298
- attempts: 0,
299
- // tags intentionally omitted
300
- } as any;
301
-
302
- const prd = createMockPRD([storyWithoutTags]);
303
-
304
- const result = await checkPRDValid(prd);
305
-
306
- // Validation should pass after auto-defaulting tags
307
- expect(result.passed).toBe(true);
308
- // The story object should now have tags defaulted to []
309
- expect(prd.userStories[0].tags).toEqual([]);
310
- });
311
-
312
- test("auto-defaults missing status to pending in-memory", async () => {
313
- const storyWithoutStatus = {
314
- id: "US-001",
315
- title: "Story",
316
- description: "Description",
317
- acceptanceCriteria: [],
318
- tags: [],
319
- dependencies: [],
320
- // status intentionally omitted
321
- passes: false,
322
- escalations: [],
323
- attempts: 0,
324
- } as any;
325
-
326
- const prd = createMockPRD([storyWithoutStatus]);
327
-
328
- const result = await checkPRDValid(prd);
329
-
330
- expect(result.passed).toBe(true);
331
- expect(prd.userStories[0].status).toBe("pending");
332
- });
333
-
334
- test("auto-defaults missing storyPoints to 1 in-memory", async () => {
335
- const storyWithoutPoints = {
336
- id: "US-001",
337
- title: "Story",
338
- description: "Description",
339
- acceptanceCriteria: [],
340
- tags: [],
341
- dependencies: [],
342
- status: "pending" as const,
343
- passes: false,
344
- escalations: [],
345
- attempts: 0,
346
- // storyPoints intentionally omitted
347
- } as any;
348
-
349
- const prd = createMockPRD([storyWithoutPoints]);
350
-
351
- const result = await checkPRDValid(prd);
352
-
353
- expect(result.passed).toBe(true);
354
- // Note: storyPoints is not in the current UserStory type, but the test validates
355
- // the behavior if it were to be added in the future
356
- });
357
-
358
- test("checks all required fields per story", async () => {
359
- const prd = createMockPRD([
360
- createMockStory({ id: "US-001", title: "Good", description: "Good" }),
361
- createMockStory({ id: "", title: "Bad", description: "Missing ID" }),
362
- ]);
363
-
364
- const result = await checkPRDValid(prd);
365
-
366
- expect(result.passed).toBe(false);
367
- });
368
- });
369
-
370
- // Skip in CI: checkClaudeCLI spawns the real `claude` binary which is not installed
371
- // in CI runners. These tests verify the check mechanism works correctly, but require
372
- // the Claude CLI to be present. They pass in local dev and on Mac01/VPS where claude
373
- // is installed. Skipping prevents false failures that mask real test regressions.
374
- const skipInCI = process.env.CI ? test.skip : test;
375
-
376
- describe("checkClaudeCLI (Tier 1 blocker)", () => {
377
- skipInCI("runs claude --version command", async () => {
378
- const result = await checkClaudeCLI();
379
-
380
- expect(result.name).toBe("claude-cli-available");
381
- expect(result.tier).toBe("blocker");
382
- // Pass/fail depends on whether Claude CLI is actually installed
383
- });
384
-
385
- skipInCI("returns blocker tier", async () => {
386
- const result = await checkClaudeCLI();
387
-
388
- expect(result.tier).toBe("blocker");
389
- });
390
-
391
- skipInCI("provides helpful error message on failure", async () => {
392
- // This test assumes Claude CLI might not be installed
393
- const result = await checkClaudeCLI();
394
-
395
- if (!result.passed) {
396
- expect(result.message).toContain("claude");
397
- }
398
- });
399
- });
400
-
401
- describe("checkDependenciesInstalled (Tier 1 blocker)", () => {
402
- let testDir: string;
403
-
404
- beforeEach(() => {
405
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
406
- });
407
-
408
- afterEach(() => {
409
- rmSync(testDir, { recursive: true, force: true });
410
- });
411
-
412
- test("detects Node.js dependencies via node_modules", async () => {
413
- mkdirSync(join(testDir, "node_modules"));
414
-
415
- const result = await checkDependenciesInstalled(testDir);
416
-
417
- expect(result.name).toBe("dependencies-installed");
418
- expect(result.tier).toBe("blocker");
419
- expect(result.passed).toBe(true);
420
- expect(result.message).toContain("node_modules");
421
- });
422
-
423
- test("detects Rust dependencies via target directory", async () => {
424
- mkdirSync(join(testDir, "target"));
425
-
426
- const result = await checkDependenciesInstalled(testDir);
427
-
428
- expect(result.passed).toBe(true);
429
- expect(result.message).toContain("target");
430
- });
431
-
432
- test("detects Python dependencies via venv directory", async () => {
433
- mkdirSync(join(testDir, "venv"));
434
-
435
- const result = await checkDependenciesInstalled(testDir);
436
-
437
- expect(result.passed).toBe(true);
438
- expect(result.message).toContain("venv");
439
- });
440
-
441
- test("detects PHP dependencies via vendor directory", async () => {
442
- mkdirSync(join(testDir, "vendor"));
443
-
444
- const result = await checkDependenciesInstalled(testDir);
445
-
446
- expect(result.passed).toBe(true);
447
- expect(result.message).toContain("vendor");
448
- });
449
-
450
- test("fails when no dependency directories exist", async () => {
451
- const result = await checkDependenciesInstalled(testDir);
452
-
453
- expect(result.passed).toBe(false);
454
- expect(result.message).toContain("No dependency");
455
- });
456
-
457
- test("is language-aware and checks all supported package managers", async () => {
458
- // Create multiple dependency directories
459
- mkdirSync(join(testDir, "node_modules"));
460
- mkdirSync(join(testDir, "venv"));
461
-
462
- const result = await checkDependenciesInstalled(testDir);
463
-
464
- // Should detect at least one
465
- expect(result.passed).toBe(true);
466
- });
467
- });
468
-
469
- describe("checkTestCommand (Tier 1 blocker)", () => {
470
- test("passes when test command is configured", async () => {
471
- const config = createMockConfig({ testCommand: "bun test" });
472
-
473
- const result = await checkTestCommand(config);
474
-
475
- expect(result.name).toBe("test-command-works");
476
- expect(result.tier).toBe("blocker");
477
- expect(result.passed).toBe(true);
478
- });
479
-
480
- test("skips silently when test command is null", async () => {
481
- const config = createMockConfig({ testCommand: null as any });
482
-
483
- const result = await checkTestCommand(config);
484
-
485
- expect(result.passed).toBe(true);
486
- expect(result.message).toContain("skip");
487
- });
488
-
489
- test("skips silently when test command is false", async () => {
490
- const config = createMockConfig({ testCommand: false as any });
491
-
492
- const result = await checkTestCommand(config);
493
-
494
- expect(result.passed).toBe(true);
495
- expect(result.message).toContain("skip");
496
- });
497
-
498
- test("reads command from config.execution", async () => {
499
- const config = createMockConfig({ testCommand: "custom-test-cmd" });
500
-
501
- const result = await checkTestCommand(config);
502
-
503
- // Implementation should use the configured command
504
- expect(result.message).toContain("custom-test-cmd");
505
- });
506
- });
507
-
508
- describe("checkLintCommand (Tier 1 blocker)", () => {
509
- test("passes when lint command is configured", async () => {
510
- const config = createMockConfig({ lintCommand: "bun run lint" });
511
-
512
- const result = await checkLintCommand(config);
513
-
514
- expect(result.name).toBe("lint-command-works");
515
- expect(result.tier).toBe("blocker");
516
- expect(result.passed).toBe(true);
517
- });
518
-
519
- test("skips silently when lint command is null", async () => {
520
- const config = createMockConfig({ lintCommand: null as any });
521
-
522
- const result = await checkLintCommand(config);
523
-
524
- expect(result.passed).toBe(true);
525
- expect(result.message).toContain("skip");
526
- });
527
-
528
- test("skips silently when lint command is false", async () => {
529
- const config = createMockConfig({ lintCommand: false as any });
530
-
531
- const result = await checkLintCommand(config);
532
-
533
- expect(result.passed).toBe(true);
534
- expect(result.message).toContain("skip");
535
- });
536
-
537
- test("reads command from config.execution", async () => {
538
- const config = createMockConfig({ lintCommand: "custom-lint-cmd" });
539
-
540
- const result = await checkLintCommand(config);
541
-
542
- expect(result.message).toContain("custom-lint-cmd");
543
- });
544
- });
545
-
546
- describe("checkTypecheckCommand (Tier 1 blocker)", () => {
547
- test("passes when typecheck command is configured", async () => {
548
- const config = createMockConfig({ typecheckCommand: "bun run typecheck" });
549
-
550
- const result = await checkTypecheckCommand(config);
551
-
552
- expect(result.name).toBe("typecheck-command-works");
553
- expect(result.tier).toBe("blocker");
554
- expect(result.passed).toBe(true);
555
- });
556
-
557
- test("skips silently when typecheck command is null", async () => {
558
- const config = createMockConfig({ typecheckCommand: null as any });
559
-
560
- const result = await checkTypecheckCommand(config);
561
-
562
- expect(result.passed).toBe(true);
563
- expect(result.message).toContain("skip");
564
- });
565
-
566
- test("skips silently when typecheck command is false", async () => {
567
- const config = createMockConfig({ typecheckCommand: false as any });
568
-
569
- const result = await checkTypecheckCommand(config);
570
-
571
- expect(result.passed).toBe(true);
572
- expect(result.message).toContain("skip");
573
- });
574
-
575
- test("reads command from config.execution", async () => {
576
- const config = createMockConfig({ typecheckCommand: "tsc --noEmit" });
577
-
578
- const result = await checkTypecheckCommand(config);
579
-
580
- expect(result.message).toContain("tsc");
581
- });
582
- });
583
-
584
- describe("checkGitUserConfigured (Tier 1 blocker)", () => {
585
- test("checks git config user.name and user.email", async () => {
586
- const result = await checkGitUserConfigured();
587
-
588
- expect(result.name).toBe("git-user-configured");
589
- expect(result.tier).toBe("blocker");
590
- // Pass/fail depends on actual git config
591
- });
592
-
593
- test("returns blocker tier", async () => {
594
- const result = await checkGitUserConfigured();
595
-
596
- expect(result.tier).toBe("blocker");
597
- });
598
-
599
- test("provides helpful message", async () => {
600
- const result = await checkGitUserConfigured();
601
-
602
- expect(result.message).toBeDefined();
603
- expect(typeof result.message).toBe("string");
604
- });
605
- });
606
-
607
- // ─────────────────────────────────────────────────────────────────────────────
608
- // Tier 2 Warnings
609
- // ─────────────────────────────────────────────────────────────────────────────
610
-
611
- describe("checkClaudeMdExists (Tier 2 warning)", () => {
612
- let testDir: string;
613
-
614
- beforeEach(() => {
615
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
616
- });
617
-
618
- afterEach(() => {
619
- rmSync(testDir, { recursive: true, force: true });
620
- });
621
-
622
- test("passes when CLAUDE.md exists", async () => {
623
- writeFileSync(join(testDir, "CLAUDE.md"), "# Project instructions");
624
-
625
- const result = await checkClaudeMdExists(testDir);
626
-
627
- expect(result.name).toBe("claude-md-exists");
628
- expect(result.tier).toBe("warning");
629
- expect(result.passed).toBe(true);
630
- expect(result.message).toContain("CLAUDE.md");
631
- });
632
-
633
- test("fails when CLAUDE.md does not exist", async () => {
634
- const result = await checkClaudeMdExists(testDir);
635
-
636
- expect(result.tier).toBe("warning");
637
- expect(result.passed).toBe(false);
638
- expect(result.message).toContain("not found");
639
- });
640
-
641
- test("returns warning tier not blocker", async () => {
642
- const result = await checkClaudeMdExists(testDir);
643
-
644
- expect(result.tier).toBe("warning");
645
- });
646
- });
647
-
648
- describe("checkDiskSpace (Tier 2 warning)", () => {
649
- test("passes when disk space is above 1GB", async () => {
650
- const result = await checkDiskSpace();
651
-
652
- // Most systems should have > 1GB free
653
- expect(result.name).toBe("disk-space-sufficient");
654
- expect(result.tier).toBe("warning");
655
- });
656
-
657
- test("fails when disk space is below 1GB", async () => {
658
- // This is hard to test without mocking, but validates the structure
659
- const result = await checkDiskSpace();
660
-
661
- expect(result.tier).toBe("warning");
662
- if (!result.passed) {
663
- expect(result.message).toContain("1GB");
664
- }
665
- });
666
-
667
- test("triggers warning below 1GB threshold", async () => {
668
- const result = await checkDiskSpace();
669
-
670
- expect(result.tier).toBe("warning");
671
- });
672
-
673
- test("provides disk space information in message", async () => {
674
- const result = await checkDiskSpace();
675
-
676
- expect(result.message).toBeDefined();
677
- expect(typeof result.message).toBe("string");
678
- });
679
- });
680
-
681
- describe("checkPendingStories (Tier 2 warning)", () => {
682
- test("passes when there are pending stories", async () => {
683
- const prd = createMockPRD([createMockStory({ status: "pending" }), createMockStory({ status: "pending" })]);
684
-
685
- const result = await checkPendingStories(prd);
686
-
687
- expect(result.name).toBe("has-pending-stories");
688
- expect(result.tier).toBe("warning");
689
- expect(result.passed).toBe(true);
690
- });
691
-
692
- test("warns when all stories are passed", async () => {
693
- const prd = createMockPRD([createMockStory({ status: "passed" }), createMockStory({ status: "passed" })]);
694
-
695
- const result = await checkPendingStories(prd);
696
-
697
- expect(result.tier).toBe("warning");
698
- expect(result.passed).toBe(false);
699
- expect(result.message).toContain("no pending");
700
- });
701
-
702
- test("counts pending and in-progress as actionable", async () => {
703
- const prd = createMockPRD([
704
- createMockStory({ status: "pending" }),
705
- createMockStory({ status: "in-progress" }),
706
- createMockStory({ status: "passed" }),
707
- ]);
708
-
709
- const result = await checkPendingStories(prd);
710
-
711
- expect(result.passed).toBe(true);
712
- });
713
- });
714
-
715
- describe("checkOptionalCommands (Tier 2 warning)", () => {
716
- test("warns when optional commands are missing", async () => {
717
- const config = createMockConfig({
718
- testCommand: null as any,
719
- lintCommand: null as any,
720
- typecheckCommand: null as any,
721
- });
722
-
723
- const result = await checkOptionalCommands(config);
724
-
725
- expect(result.name).toBe("optional-commands-configured");
726
- expect(result.tier).toBe("warning");
727
- expect(result.passed).toBe(false);
728
- });
729
-
730
- test("passes when all optional commands are configured", async () => {
731
- const config = createMockConfig({
732
- testCommand: "bun test",
733
- lintCommand: "bun run lint",
734
- typecheckCommand: "bun run typecheck",
735
- });
736
-
737
- const result = await checkOptionalCommands(config);
738
-
739
- expect(result.passed).toBe(true);
740
- });
741
-
742
- test("lists which commands are missing", async () => {
743
- const config = createMockConfig({
744
- testCommand: "bun test",
745
- lintCommand: null as any,
746
- typecheckCommand: null as any,
747
- });
748
-
749
- const result = await checkOptionalCommands(config);
750
-
751
- expect(result.message).toContain("lint");
752
- expect(result.message).toContain("typecheck");
753
- });
754
- });
755
-
756
- describe("checkGitignoreCoversNax (Tier 2 warning)", () => {
757
- let testDir: string;
758
-
759
- beforeEach(() => {
760
- testDir = mkdtempSync(join(tmpdir(), "nax-test-precheck-"));
761
- });
762
-
763
- afterEach(() => {
764
- rmSync(testDir, { recursive: true, force: true });
765
- });
766
-
767
- test("passes when .gitignore exists and covers nax runtime files", async () => {
768
- writeFileSync(
769
- join(testDir, ".gitignore"),
770
- `
771
- node_modules/
772
- nax.lock
773
- nax/features/*/runs/
774
- test/tmp/
775
- `.trim(),
776
- );
777
-
778
- const result = await checkGitignoreCoversNax(testDir);
779
-
780
- expect(result.name).toBe("gitignore-covers-nax");
781
- expect(result.tier).toBe("warning");
782
- expect(result.passed).toBe(true);
783
- });
784
-
785
- test("fails when .gitignore does not exist", async () => {
786
- const result = await checkGitignoreCoversNax(testDir);
787
-
788
- expect(result.tier).toBe("warning");
789
- expect(result.passed).toBe(false);
790
- expect(result.message).toContain(".gitignore");
791
- });
792
-
793
- test("fails when .gitignore exists but does not cover nax.lock", async () => {
794
- writeFileSync(join(testDir, ".gitignore"), "node_modules/");
795
-
796
- const result = await checkGitignoreCoversNax(testDir);
797
-
798
- expect(result.passed).toBe(false);
799
- expect(result.message).toContain("nax.lock");
800
- });
801
-
802
- test("fails when .gitignore exists but does not cover runs directories", async () => {
803
- writeFileSync(
804
- join(testDir, ".gitignore"),
805
- `
806
- nax.lock
807
- test/tmp/
808
- `.trim(),
809
- );
810
-
811
- const result = await checkGitignoreCoversNax(testDir);
812
-
813
- expect(result.passed).toBe(false);
814
- expect(result.message).toContain("runs");
815
- });
816
-
817
- test("fails when .gitignore exists but does not cover test/tmp", async () => {
818
- writeFileSync(
819
- join(testDir, ".gitignore"),
820
- `
821
- nax.lock
822
- nax/features/*/runs/
823
- `.trim(),
824
- );
825
-
826
- const result = await checkGitignoreCoversNax(testDir);
827
-
828
- expect(result.passed).toBe(false);
829
- expect(result.message).toContain("test/tmp");
830
- });
831
-
832
- test("checks all three nax runtime file patterns", async () => {
833
- writeFileSync(join(testDir, ".gitignore"), "# Empty");
834
-
835
- const result = await checkGitignoreCoversNax(testDir);
836
-
837
- expect(result.passed).toBe(false);
838
- // Message should mention missing patterns
839
- expect(result.message.toLowerCase()).toMatch(/nax\.lock|runs|test\/tmp/);
840
- });
841
- });