@cbartens/bkit 5.5.1 → 6.1.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 (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -0,0 +1,484 @@
1
+ // bkit decisions compose|apply|pending — the build's decision files, from question to ship.
2
+ //
3
+ // A decision file (`docs/plans/{YYYYMM}/logs/{FID}/build-decision-{RUN}-{N}.md`) holds header
4
+ // lines, an optional progress block, then one item per question:
5
+ //
6
+ // **Q{n} — {title}:** {question}
7
+ // Options: A) {A} / B) {B}
8
+ // Recommended: A) {A} — {reason} (a hard blocker: `No recommendation — {why}`)
9
+ // Decision: {answer} — {words} (once decided)
10
+ //
11
+ // `apply --by=headless` takes each recommendation when nobody can or should be asked: an
12
+ // `Accept` is written `Accept (assumed)` and the file says `Status: ASSUMED`. It never writes a
13
+ // `docs/decisions.jsonl` row or a `TEST EXCEPTION`: only the owner's words do. Ship lists the
14
+ // assumed items with `pending`; the owner confirms each (`apply --by=owner --confirm`, which
15
+ // writes the real acceptance) or rejects it, and `pending --defer` writes one `needs-decision`
16
+ // deferral per item nobody confirmed.
17
+ import * as fs from "node:fs";
18
+ import * as path from "node:path";
19
+ import { readJsonFile } from "../../shared/json.js";
20
+ import { CommandError, EXIT, git } from "../lib.js";
21
+ import { loopProgress } from "./counters.js";
22
+ import { appendLedgerRows } from "./ledgers.js";
23
+ import { classifyAt } from "./runtime.js";
24
+ import { positiveInt, str } from "./status.js";
25
+ /** Exit code: `apply --by=headless` left hard blockers (no recommendation) for the owner. */
26
+ export const EXIT_HARD_BLOCKERS = 4;
27
+ const ITEM_SPLIT = /^(?=\*\*Q\d+ — )/m;
28
+ const lineOf = (text, key) => new RegExp(`^${key}:[ \\t]*(.+?)[ \\t]*$`, "m").exec(text)?.[1] ?? null;
29
+ /** Options one item may hold: one per letter, `A` to `Z`. */
30
+ const MAX_OPTIONS = 26;
31
+ /** `A`, `B`, … for option index `i`. */
32
+ const letterAt = (i) => String.fromCharCode(65 + i);
33
+ /** An option entry's leading letter (`A) `) dropped, so a parsed name stays bare. */
34
+ const bareName = (s) => s.replace(/^[A-Z]\)[ \t]*/, "");
35
+ /** A reply opening on an option letter: `B`, `B)`, `B — …`, `B) {option} …`, `B {option} …`. */
36
+ const LETTER_REPLY = /^([A-Za-z])(?:\)|(?=[ \t—:,.-]|$))[ \t]*(?:[—:,.-][ \t]*)?/;
37
+ /**
38
+ * An answer read as the option it names. A leading letter of `options` (either case, with or
39
+ * without `)`) becomes the option it labels: `B`, `B) Reject` and `B — too risky` read as
40
+ * `Reject`, `Reject` and `Reject — too risky`. Any other answer is returned unchanged; with
41
+ * no options known, only a leading `A) ` is dropped.
42
+ */
43
+ export function optionAnswer(answer, options) {
44
+ if (options.length === 0)
45
+ return bareName(answer);
46
+ const m = LETTER_REPLY.exec(answer);
47
+ const name = m === null ? undefined : options[m[1].toUpperCase().charCodeAt(0) - 65];
48
+ if (m === null || name === undefined)
49
+ return answer;
50
+ const rest = answer.slice(m[0].length);
51
+ if (rest.toLowerCase().startsWith(name.toLowerCase()))
52
+ return name + rest.slice(name.length);
53
+ if (rest === "")
54
+ return name;
55
+ return /[)—:,.-]/.test(m[0]) ? `${name} — ${rest}` : answer;
56
+ }
57
+ /** The option list as it is written: `A) {A} / B) {B}`. */
58
+ const letteredOptions = (options) => options.map((o, i) => `${letterAt(i)}) ${o}`).join(" / ");
59
+ /** The letter `name` holds in `options`, or null when it is not one of them. */
60
+ const letterOf = (options, name) => options.includes(name) ? letterAt(options.indexOf(name)) : null;
61
+ /** The items of a decision file's text, in file order. */
62
+ export function parseDecisionItems(text) {
63
+ return text
64
+ .split(ITEM_SPLIT)
65
+ .slice(1)
66
+ .map((part) => {
67
+ const head = /^\*\*Q(\d+) — (.+?):\*\*/.exec(part);
68
+ const rec = lineOf(part, "Recommended");
69
+ const none = /^No recommendation\b/m.test(part);
70
+ const [option, ...why] = (rec ?? "").split(" — ");
71
+ const options = (lineOf(part, "Options") ?? "")
72
+ .split(" / ")
73
+ .map((o) => bareName(o.trim()))
74
+ .filter(Boolean);
75
+ const answer = lineOf(part, "Decision");
76
+ const decision = answer === null ? null : optionAnswer(answer, options);
77
+ return {
78
+ n: Number(head?.[1] ?? 0),
79
+ title: head?.[2] ?? "",
80
+ text: part.trimEnd(),
81
+ options,
82
+ recommended: none || rec === null ? null : bareName((option ?? "").trim()),
83
+ reason: why.join(" — ").trim(),
84
+ decision,
85
+ assumed: decision !== null && /^Accept \(assumed\)/.test(decision),
86
+ rejected: lineOf(part, "Rejected") !== null,
87
+ deferred: lineOf(part, "Deferred") !== null,
88
+ };
89
+ });
90
+ }
91
+ /** `Status:` set to `status`. */
92
+ const withStatus = (text, status) => /^Status:.*$/m.test(text)
93
+ ? text.replace(/^Status:.*$/m, `Status: ${status}`)
94
+ : `Status: ${status}\n${text}`;
95
+ /** `extra` lines added under item `n`'s last line. */
96
+ function addUnder(text, n, extra, replace) {
97
+ const parts = text.split(ITEM_SPLIT);
98
+ const i = parts.findIndex((p) => p.startsWith(`**Q${n} — `));
99
+ if (i < 0)
100
+ throw new CommandError(EXIT.USAGE, `no Q${n} in the decision file`);
101
+ const body = parts[i].trimEnd().split("\n");
102
+ const kept = replace === undefined ? body : body.filter((l) => !replace.test(l));
103
+ const trail = parts[i].slice(parts[i].trimEnd().length) || "\n\n";
104
+ parts[i] = [...kept, ...extra].join("\n") + trail;
105
+ return parts.join("");
106
+ }
107
+ /** The status a file's items leave it in. */
108
+ function statusOf(items) {
109
+ if (items.some((i) => i.decision === null))
110
+ return "OPEN";
111
+ return items.some((i) => i.assumed && !i.deferred) ? "ASSUMED" : "DECIDED";
112
+ }
113
+ const today = () => new Date().toISOString().slice(0, 10);
114
+ const readText = (file) => {
115
+ if (!fs.existsSync(file))
116
+ throw new CommandError(EXIT.USAGE, `${file} does not exist`);
117
+ return fs.readFileSync(file, "utf-8");
118
+ };
119
+ /** `FID` and run/decision numbers from a `.../logs/{FID}/build-decision-{RUN}-{N}.md` path. */
120
+ function fileRef(file) {
121
+ const fid = path.basename(path.dirname(file));
122
+ const m = /build-decision-(\d+)-(\d+)\.md$/.exec(file);
123
+ return { fid, ref: m ? `run ${m[1]} decision ${m[2]}` : path.basename(file) };
124
+ }
125
+ const slug = (s) => s
126
+ .toLowerCase()
127
+ .replace(/[^a-z0-9]+/g, "-")
128
+ .replace(/^-+|-+$/g, "")
129
+ .slice(0, 60);
130
+ const LOOPS = {
131
+ verify: {
132
+ title: "Verify",
133
+ check: "build-plan-verify",
134
+ fix: "build-plan-gaps-remediate",
135
+ point: "verify",
136
+ },
137
+ tests: {
138
+ title: "Tests",
139
+ check: "build-run-tests",
140
+ fix: "build-failure-diagnose",
141
+ point: "tests",
142
+ },
143
+ };
144
+ function composeItems(raw) {
145
+ if (!Array.isArray(raw))
146
+ throw new CommandError(EXIT.USAGE, "--items must hold a JSON array");
147
+ return raw.map((r, i) => {
148
+ const o = (r ?? {});
149
+ const s = (k) => (typeof o[k] === "string" ? o[k].trim() : "");
150
+ const options = Array.isArray(o.options) ? o.options.filter((x) => typeof x === "string") : [];
151
+ if (s("title") === "" || s("question") === "" || options.length === 0)
152
+ throw new CommandError(EXIT.USAGE, `item ${i + 1}: needs title, question and options`);
153
+ if (options.length > MAX_OPTIONS)
154
+ throw new CommandError(EXIT.USAGE, `item ${i + 1}: at most ${MAX_OPTIONS} options (A-Z)`);
155
+ if (s("noRecommendation") === "" && !options.includes(s("recommended")))
156
+ throw new CommandError(EXIT.USAGE, `item ${i + 1}: recommended must be one of its options, or set noRecommendation`);
157
+ return {
158
+ title: s("title"),
159
+ question: s("question"),
160
+ options: options,
161
+ recommended: s("recommended"),
162
+ reason: s("reason"),
163
+ noRecommendation: s("noRecommendation"),
164
+ };
165
+ });
166
+ }
167
+ const itemLines = (n, it) => {
168
+ const rec = it.recommended ?? "";
169
+ const letter = letterOf(it.options, rec);
170
+ return [
171
+ `**Q${n} — ${it.title}:** ${it.question}`,
172
+ `Options: ${letteredOptions(it.options)}`,
173
+ it.noRecommendation
174
+ ? `No recommendation — ${it.noRecommendation}`
175
+ : `Recommended: ${letter === null ? rec : `${letter}) ${rec}`} — ${it.reason || "the orchestrator's call"}`,
176
+ ];
177
+ };
178
+ // ---------------------------------------------------------------------------
179
+ // apply
180
+ // ---------------------------------------------------------------------------
181
+ /** Each undecided item's recommendation written in; hard blockers left for the owner. */
182
+ export function applyRecommendations(text, runtime, why) {
183
+ const items = parseDecisionItems(text);
184
+ const loopItem = items.find((i) => i.options.includes("Try again"));
185
+ const loop = loopItem?.decision?.split(" — ")[0] ?? loopItem?.recommended ?? null;
186
+ const applied = [];
187
+ const hardBlockers = [];
188
+ let out = text;
189
+ for (const it of items) {
190
+ if (it.decision !== null)
191
+ continue;
192
+ // `Try again` settles the loop alone; the items wait for the next round.
193
+ if (it !== loopItem && loop === "Try again")
194
+ continue;
195
+ if (it.recommended === null) {
196
+ hardBlockers.push(it.n);
197
+ continue;
198
+ }
199
+ const line = it.recommended === "Accept"
200
+ ? `Decision: Accept (assumed) — ${it.reason} (${why}, ${runtime}, ${today()})`
201
+ : `Decision: ${it.recommended} — recommended; applied without asking (${runtime})`;
202
+ out = addUnder(out, it.n, [line]);
203
+ applied.push(it.n);
204
+ }
205
+ out = withStatus(out, statusOf(parseDecisionItems(out)));
206
+ return { text: out, applied, hardBlockers, loop };
207
+ }
208
+ /** The `decision` row an owner's confirmation writes. */
209
+ function decisionRow(file, it, reason) {
210
+ const { fid, ref } = fileRef(file);
211
+ return {
212
+ kind: "decision",
213
+ key: `${slug(fid)}-accepted-${slug(it.title)}`,
214
+ by: { workflow: "ship", step: "ship-confirm-decisions" },
215
+ references: [fid, file],
216
+ summary: `${fid}: ${it.title} accepted (${ref}, confirmed at ship)`,
217
+ rationale: `accepted by owner: ${reason}`,
218
+ status: "ACTIVE",
219
+ };
220
+ }
221
+ /** The `deferral` row an unconfirmed assumed item becomes. */
222
+ function deferralRow(file, it) {
223
+ const { fid, ref } = fileRef(file);
224
+ const severity = /\b(CRITICAL|HIGH|MEDIUM|LOW)\b/.exec(it.text)?.[1] ?? "MEDIUM";
225
+ return {
226
+ kind: "deferral",
227
+ key: `${slug(fid)}-assumed-${slug(it.title)}`,
228
+ by: { workflow: "ship", step: "ship-confirm-decisions" },
229
+ references: [fid, file],
230
+ type: "issue",
231
+ category: "other",
232
+ severity,
233
+ reason: "needs-decision",
234
+ summary: `${fid}: ${it.title} accepted without the owner (${ref})`,
235
+ description: `Decision needed: accept or fix "${it.title}". Options: ${letteredOptions(it.options)}. ${it.rejected ? "The owner rejected the assumed accept at ship." : "Nobody confirmed the assumed accept before the merge."} Item: ${it.text.split("\n")[0]}`,
236
+ status: "OPEN",
237
+ };
238
+ }
239
+ /** Every `build-decision-*.md` under `logDir`, in name order. */
240
+ function decisionFiles(logDir) {
241
+ return fs.existsSync(logDir)
242
+ ? fs
243
+ .readdirSync(logDir)
244
+ .filter((f) => /^build-decision-\d+-\d+\.md$/.test(f))
245
+ .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))
246
+ .map((f) => path.join(logDir, f))
247
+ : [];
248
+ }
249
+ const root = (cwd, flag) => path.resolve(cwd, str(flag) ?? git(cwd, ["rev-parse", "--show-toplevel"]) ?? ".");
250
+ // ---------------------------------------------------------------------------
251
+ // Command
252
+ // ---------------------------------------------------------------------------
253
+ export const decisionsCommand = {
254
+ noun: "decisions",
255
+ summary: "Build decision files: write questions, apply recommendations, list assumed items.",
256
+ verbs: {
257
+ compose: {
258
+ summary: "Write a decision file in the one question layout, with loop progress when asked.",
259
+ use: "workflow",
260
+ flags: [
261
+ { name: "out", type: "string", required: true, help: "the decision file to write" },
262
+ {
263
+ name: "header",
264
+ type: "string",
265
+ repeatable: true,
266
+ help: "Key=Value header line (Status: OPEN is written first)",
267
+ },
268
+ {
269
+ name: "items",
270
+ type: "string",
271
+ help: "JSON file: [{title, question, options, recommended, reason} | {…, noRecommendation}]",
272
+ },
273
+ {
274
+ name: "loop",
275
+ type: "string",
276
+ help: "verify | tests: add the progress block and the loop question as Q1",
277
+ },
278
+ { name: "file", type: "string", help: "status.jsonl, with --loop" },
279
+ { name: "group", type: "string", help: "with --loop=verify: the task group" },
280
+ { name: "attempt", type: "string", help: "with --loop: the attempt just failed" },
281
+ { name: "max", type: "string", help: "with --loop: the point's maxAttempts" },
282
+ ],
283
+ output: {
284
+ file: "the decision file written",
285
+ questions: "number of questions",
286
+ loopRecommended: "Try again | Decide (with --loop), else null",
287
+ },
288
+ run: (ctx) => {
289
+ const out = path.resolve(ctx.cwd, String(ctx.flags.out));
290
+ const headers = (ctx.flags.header ?? []).map((h) => {
291
+ const eq = h.indexOf("=");
292
+ if (eq <= 0)
293
+ throw new CommandError(EXIT.USAGE, `--header ${h}: must be Key=Value`);
294
+ return `${h.slice(0, eq)}: ${h.slice(eq + 1)}`;
295
+ });
296
+ let items = [];
297
+ if (ctx.flags.items !== undefined) {
298
+ const read = readJsonFile(path.resolve(ctx.cwd, String(ctx.flags.items)));
299
+ if (!read.ok)
300
+ throw new CommandError(EXIT.USAGE, "--items is missing or not JSON");
301
+ items = composeItems(read.value);
302
+ }
303
+ const lines = ["Status: OPEN", ...headers.filter((h) => !h.startsWith("Status:")), ""];
304
+ let loopRecommended = null;
305
+ const loopName = str(ctx.flags.loop);
306
+ if (loopName !== undefined) {
307
+ const loop = LOOPS[loopName];
308
+ if (loop === undefined)
309
+ throw new CommandError(EXIT.USAGE, "--loop must be verify or tests");
310
+ if (ctx.flags.file === undefined)
311
+ throw new CommandError(EXIT.USAGE, "--loop needs --file");
312
+ const p = loopProgress(path.resolve(ctx.cwd, String(ctx.flags.file)), ctx.cwd, "build", loop.check, loop.fix, positiveInt(ctx.flags.group, "group"));
313
+ const attempt = str(ctx.flags.attempt) ?? String(p.rounds.length);
314
+ const max = str(ctx.flags.max) ?? "?";
315
+ const changed = p.codeChanged === null ? "unknown" : p.codeChanged ? "yes" : "no";
316
+ const trendLine = {
317
+ "first-round": "This was the first round, so there is no trend yet.",
318
+ closing: "Fewer problems after each round, and the code changed.",
319
+ stuck: "No fewer problems, or the code did not change.",
320
+ worse: "More problems than the first round.",
321
+ }[p.trend];
322
+ loopRecommended = p.recommend === "stop" ? "Decide" : "Try again";
323
+ lines.push(`build ${loop.point}: attempt ${attempt} of ${max}`, "", "## Progress", "", `Problems after each round: ${p.counts || "none recorded"}`, `Code changed: ${changed}`, `Strategy: ${p.lastStrategy ?? "none"} → next ${p.nextStrategy}${p.finalSpent ? " (FINAL already used)" : ""}`, `Minutes per round: ${p.minutesPerRound ?? "unknown"}`, `Trend: ${p.trend}`, "", ...itemLines(1, {
324
+ title: loop.title,
325
+ question: loopRecommended === "Try again"
326
+ ? `another fix round? ${trendLine}`
327
+ : `decide the items below instead of another round? ${trendLine}`,
328
+ options: items.length > 0 ? ["Try again", "Decide"] : ["Try again", "Stop"],
329
+ recommended: items.length > 0 || loopRecommended === "Try again" ? loopRecommended : "Stop",
330
+ reason: loopRecommended === "Try again"
331
+ ? "the last round made progress"
332
+ : "another round is unlikely to close the remaining items",
333
+ }), "");
334
+ if (items.length === 0 && loopRecommended === "Decide")
335
+ loopRecommended = "Stop";
336
+ }
337
+ const first = loopName === undefined ? 1 : 2;
338
+ items.forEach((it, i) => lines.push(...itemLines(first + i, it), ""));
339
+ lines.push('Reply per question. "yes" takes every recommendation. "stop" writes a handover; the run can be resumed.', "");
340
+ fs.mkdirSync(path.dirname(out), { recursive: true });
341
+ fs.writeFileSync(out, lines.join("\n"), "utf-8");
342
+ ctx.emit({
343
+ file: path.relative(ctx.cwd, out),
344
+ questions: items.length + (loopName === undefined ? 0 : 1),
345
+ loopRecommended,
346
+ });
347
+ return EXIT.OK;
348
+ },
349
+ },
350
+ apply: {
351
+ summary: "Settle a decision file's items: --by=headless takes each recommendation; --by=owner confirms or rejects one assumed item.",
352
+ use: "workflow",
353
+ flags: [
354
+ { name: "file", type: "string", required: true, help: "the decision file" },
355
+ { name: "by", type: "string", required: true, help: "headless | owner" },
356
+ { name: "q", type: "string", help: "--by=owner: the question number" },
357
+ { name: "confirm", type: "boolean", help: "--by=owner: confirm the assumed Accept" },
358
+ { name: "reject", type: "boolean", help: "--by=owner: reject the assumed Accept" },
359
+ { name: "reason", type: "string", help: "--by=owner: the owner's words" },
360
+ {
361
+ name: "root",
362
+ type: "string",
363
+ help: "--by=owner: the checkout the ledgers live in (default: the repo top)",
364
+ },
365
+ ],
366
+ output: {
367
+ status: "the file's Status after the call: OPEN | ASSUMED | DECIDED",
368
+ applied: "--by=headless: question numbers settled on their recommendation",
369
+ hardBlockers: "--by=headless: question numbers with no recommendation, left for the owner",
370
+ loop: "--by=headless: the loop answer (Try again | Decide | Stop), or null",
371
+ fixNow: "--by=headless: question numbers settled as Fix now",
372
+ decisionKey: "--by=owner --confirm: key of the decision row written",
373
+ },
374
+ exitCodes: {
375
+ [EXIT_HARD_BLOCKERS]: "--by=headless: hard blockers remain (headless → Failure Path; a session asks them)",
376
+ },
377
+ run: (ctx) => {
378
+ const file = path.resolve(ctx.cwd, String(ctx.flags.file));
379
+ const text = readText(file);
380
+ const by = String(ctx.flags.by);
381
+ if (by === "headless") {
382
+ const runtime = classifyAt(ctx.cwd);
383
+ const r = applyRecommendations(text, runtime, runtime === "GITHUB_ACTION" ? "headless" : "ask:false");
384
+ fs.writeFileSync(file, r.text, "utf-8");
385
+ const after = parseDecisionItems(r.text);
386
+ ctx.emit({
387
+ status: /^Status:[ \t]*(\S+)/m.exec(r.text)?.[1] ?? "OPEN",
388
+ applied: r.applied,
389
+ hardBlockers: r.hardBlockers,
390
+ loop: r.loop,
391
+ fixNow: after.filter((i) => i.decision?.startsWith("Fix now")).map((i) => i.n),
392
+ });
393
+ if (r.hardBlockers.length > 0)
394
+ ctx.log(`hard blockers need the owner: Q${r.hardBlockers.join(", Q")}`);
395
+ return r.hardBlockers.length > 0 ? EXIT_HARD_BLOCKERS : EXIT.OK;
396
+ }
397
+ if (by !== "owner")
398
+ throw new CommandError(EXIT.USAGE, "--by must be headless or owner");
399
+ const n = positiveInt(ctx.flags.q, "q");
400
+ const reason = str(ctx.flags.reason);
401
+ if (n === undefined ||
402
+ reason === undefined ||
403
+ (ctx.flags.confirm === true) === (ctx.flags.reject === true))
404
+ throw new CommandError(EXIT.USAGE, "--by=owner needs --q, --reason and one of --confirm / --reject");
405
+ const it = parseDecisionItems(text).find((i) => i.n === n);
406
+ if (it === undefined || !it.assumed)
407
+ throw new CommandError(EXIT.USAGE, `Q${n} is not an assumed Accept in ${path.basename(file)}`);
408
+ let out;
409
+ let decisionKey = null;
410
+ if (ctx.flags.confirm === true) {
411
+ const row = decisionRow(path.relative(root(ctx.cwd, ctx.flags.root), file), it, reason);
412
+ appendLedgerRows(root(ctx.cwd, ctx.flags.root), "decisions", [row]);
413
+ decisionKey = String(row.key);
414
+ out = addUnder(text, n, [`Decision: Accept — ${reason} (owner, confirmed at ship, ${today()})`], /^(Decision|Rejected):/);
415
+ }
416
+ else {
417
+ out = addUnder(text, n, [`Rejected: ${reason} (owner, ${today()})`], /^Rejected:/);
418
+ }
419
+ out = withStatus(out, statusOf(parseDecisionItems(out)));
420
+ fs.writeFileSync(file, out, "utf-8");
421
+ ctx.emit({ status: /^Status:[ \t]*(\S+)/m.exec(out)?.[1] ?? "OPEN", decisionKey });
422
+ return EXIT.OK;
423
+ },
424
+ },
425
+ pending: {
426
+ summary: "List the feature's assumed Accepts nobody confirmed; --defer writes one needs-decision deferral per item.",
427
+ use: "workflow",
428
+ flags: [
429
+ { name: "fid", type: "string", required: true, help: "feature id" },
430
+ { name: "month", type: "string", required: true, help: "YYYYMM of the feature's logs" },
431
+ {
432
+ name: "root",
433
+ type: "string",
434
+ help: "the checkout the plans and ledgers live in (default: the repo top)",
435
+ },
436
+ {
437
+ name: "defer",
438
+ type: "boolean",
439
+ help: "write a deferral row per listed item and mark it Deferred",
440
+ },
441
+ ],
442
+ output: {
443
+ items: "[{file, q, title, reason, state: pending|rejected}]",
444
+ count: "items listed",
445
+ deferred: "--defer: deferral keys written",
446
+ },
447
+ run: (ctx) => {
448
+ const top = root(ctx.cwd, ctx.flags.root);
449
+ const month = String(ctx.flags.month);
450
+ if (!/^[0-9]{6}$/.test(month))
451
+ throw new CommandError(EXIT.USAGE, "--month must be YYYYMM");
452
+ const logDir = path.join(top, "docs", "plans", month, "logs", String(ctx.flags.fid));
453
+ const items = [];
454
+ const rows = [];
455
+ for (const abs of decisionFiles(logDir)) {
456
+ const rel = path.relative(top, abs);
457
+ let text = fs.readFileSync(abs, "utf-8");
458
+ for (const it of parseDecisionItems(text)) {
459
+ if (!it.assumed || it.deferred)
460
+ continue;
461
+ items.push({
462
+ file: rel,
463
+ q: it.n,
464
+ title: it.title,
465
+ reason: it.reason,
466
+ state: it.rejected ? "rejected" : "pending",
467
+ });
468
+ if (ctx.flags.defer === true) {
469
+ rows.push(deferralRow(rel, it));
470
+ text = addUnder(text, it.n, [`Deferred: needs-decision (${today()})`]);
471
+ }
472
+ }
473
+ if (ctx.flags.defer === true) {
474
+ text = withStatus(text, statusOf(parseDecisionItems(text)));
475
+ fs.writeFileSync(abs, text, "utf-8");
476
+ }
477
+ }
478
+ const deferred = rows.length > 0 ? appendLedgerRows(top, "deferrals", rows).keys : [];
479
+ ctx.emit({ items, count: items.length, deferred });
480
+ return EXIT.OK;
481
+ },
482
+ },
483
+ },
484
+ };