@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
@@ -23,7 +23,7 @@
23
23
  import * as fs from "node:fs";
24
24
  import * as path from "node:path";
25
25
  import { statusTimestamp } from "../../ledgers/status.js";
26
- import { CommandError, EXIT, repoRoot, runTool } from "../lib.js";
26
+ import { CommandError, EXIT, git, repoRoot, runTool, } from "../lib.js";
27
27
  import { EXIT_NO_STATUS, FILE_FLAG, WORKFLOW_FLAG, readStatusEvents, statusFile, str, } from "./status.js";
28
28
  export const RUNTIMES = [
29
29
  "LOCAL",
@@ -88,6 +88,17 @@ export function classify(env, root, log) {
88
88
  const capable = (runtime) => runtime === "LOCAL" || runtime === "GITHUB_ACTION" || runtime === "CLOUD_CURSOR";
89
89
  /** No human can reply into the session: a GitHub Actions run. */
90
90
  const headless = (runtime) => runtime === "GITHUB_ACTION";
91
+ /**
92
+ * `classify` for a process working in `cwd`, which may be a build worktree: the Cursor
93
+ * marker sits in the main checkout (`repoRoot`), as `runtime detect` reads it. Outside a
94
+ * git repo the marker is looked for under `cwd`.
95
+ */
96
+ export function classifyAt(cwd) {
97
+ const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
98
+ return classify(process.env, common ? path.dirname(common) : cwd, () => undefined);
99
+ }
100
+ /** Whether a process working in `cwd` runs headless, classified like `runtime detect`. */
101
+ export const headlessRun = (cwd) => headless(classifyAt(cwd));
91
102
  /** The full table: classification, default capabilities, and the one live gh probe. */
92
103
  export function detect(cwd, root, log) {
93
104
  const runtime = classify(process.env, root, log);
@@ -159,6 +170,7 @@ export const runtimeCommand = {
159
170
  verbs: {
160
171
  detect: {
161
172
  summary: "Classify the runtime, its default capabilities, gh auth, and the worktree path.",
173
+ use: "by-hand",
162
174
  flags: [FID_FLAG],
163
175
  output: {
164
176
  ...TABLE_OUTPUT,
@@ -176,6 +188,7 @@ export const runtimeCommand = {
176
188
  },
177
189
  row: {
178
190
  summary: "Detect, then build the runtime-resolved row (and append it with --file).",
191
+ use: "workflow",
179
192
  flags: [
180
193
  WORKFLOW_FLAG,
181
194
  {
@@ -214,6 +227,7 @@ export const runtimeCommand = {
214
227
  },
215
228
  assert: {
216
229
  summary: "Read back the latest runtime-resolved row and fail unless every field is resolved.",
230
+ use: "workflow",
217
231
  flags: [
218
232
  FILE_FLAG,
219
233
  { ...WORKFLOW_FLAG, required: false, help: "only rows written by this workflow" },
@@ -50,6 +50,7 @@ export const skillsCommand = {
50
50
  verbs: {
51
51
  prune: {
52
52
  summary: "Uninstall every non-bkit skill .agents/skills.md does not list (ship Step 7).",
53
+ use: "workflow",
53
54
  flags: [],
54
55
  output: {
55
56
  removed: "skills uninstalled",
@@ -1,8 +1,13 @@
1
- // bkit status route|meta|path|row — read and annotate a workflow's `status.jsonl`.
1
+ // bkit status route|resume|meta|path|row — read and annotate a workflow's `status.jsonl`.
2
2
  import * as fs from "node:fs";
3
3
  import * as path from "node:path";
4
- import { activeDoneSteps, appendLine, fold, lastDoneStepAllRuns, lastRun, nextStrategy, runOrStepField, statusTimestamp, } from "../../ledgers/status.js";
5
- import { CommandError, EXIT, git, parseJson, statusLocation, } from "../lib.js";
4
+ import { BKIT_DEBUG_GATES } from "../../install/manifest.js";
5
+ import { appendFrictionRow, journalEnabled, pauseFrictionRow } from "../../ledgers/journal.js";
6
+ import { resolveGitSha } from "../../ledgers/telemetry.js";
7
+ import { readBkitConfig } from "../../shared/settings.js";
8
+ import { activeDoneSteps, validateCiSelection, ciSelectionIdentity, allRunsDoneSteps, appendLine, fold, lastDoneStepAllRuns, lastRun, nextStrategy, runNumber, runOrStepField, statusTimestamp, } from "../../ledgers/status.js";
9
+ import { CommandError, EXIT, git, parseJson, resolveActiveRun, statusLocation, } from "../lib.js";
10
+ import { WORKFLOW_STEPS, isResumable, resumePoint } from "./step-table.js";
6
11
  // ---------------------------------------------------------------------------
7
12
  // Shared with counters / steps
8
13
  // ---------------------------------------------------------------------------
@@ -24,13 +29,15 @@ export const STEP_FLAG = {
24
29
  required: true,
25
30
  help: "step name",
26
31
  };
27
- export const SUB_PLAN_FLAG = {
28
- name: "sub-plan",
32
+ export const GROUP_FLAG = {
33
+ name: "group",
29
34
  type: "string",
30
- help: "only rows for this sub-plan (positive integer)",
35
+ help: "only rows for this task group (positive integer)",
31
36
  };
32
37
  /** Exit code: status.jsonl missing, unreadable, or not valid NDJSON. */
33
38
  export const EXIT_NO_STATUS = 3;
39
+ /** Exit code: the owner-pause friction row was not written; the status row is kept. */
40
+ export const EXIT_PAUSE_FRICTION = 4;
34
41
  /** Every row of status.jsonl, whatever its type; exit 3 when the file is missing or a line is not JSON. */
35
42
  export function readStatusRows(file) {
36
43
  if (!fs.existsSync(file))
@@ -59,6 +66,14 @@ export function readStatusRowsAt(file, ref) {
59
66
  throw new CommandError(EXIT_NO_STATUS, `${spec} does not exist`);
60
67
  return parseStatusRows(text, spec);
61
68
  }
69
+ /**
70
+ * Step names a row may carry from before a rename, read as the current name so a run
71
+ * in flight across the rename folds, resumes and counts as one (`docs/migrations.md`).
72
+ * The row on disk is history and is not rewritten.
73
+ */
74
+ const RENAMED_STEPS = {
75
+ "build-plan-execute": "build-plan-tasks",
76
+ };
62
77
  /** Parse NDJSON status text; `label` names it in errors. Malformed is an error, never "no rows". */
63
78
  function parseStatusRows(text, label) {
64
79
  return text
@@ -72,7 +87,9 @@ function parseStatusRows(text, label) {
72
87
  if (typeof parsed.value !== "object" || parsed.value === null) {
73
88
  throw new CommandError(EXIT_NO_STATUS, `${label} line ${i + 1} is not a JSON object`);
74
89
  }
75
- return parsed.value;
90
+ const row = parsed.value;
91
+ const renamed = typeof row.step === "string" ? RENAMED_STEPS[row.step] : undefined;
92
+ return renamed === undefined ? row : { ...row, step: renamed };
76
93
  });
77
94
  }
78
95
  /** The rows as the fold reads them; the fold skips types it does not model. */
@@ -124,10 +141,17 @@ const VERDICTS = ["PASS", "CONCERNS", "FAIL"];
124
141
  const DEBUG_MODES = ["NORMAL", "SOAK"];
125
142
  const PUSH_MODES = ["PR", "LOCAL"];
126
143
  const STRATEGIES = ["STANDARD", "PIVOT", "FINAL"];
127
- const ROUTE_FIELDS = ["verdict", "failures", "strategy", "debugMode", "pushMode"];
144
+ const ROUTE_FIELDS = [
145
+ "verdict",
146
+ "failures",
147
+ "strategy",
148
+ "debugMode",
149
+ "pushMode",
150
+ "publish",
151
+ ];
128
152
  /** Exit code: a `--require`d field is missing or holds a value outside its set. */
129
153
  export const EXIT_ROUTE_MISSING = 4;
130
- function route(runs, workflow, step, subPlan) {
154
+ function route(runs, workflow, step, group) {
131
155
  const out = {
132
156
  verdict: null,
133
157
  failures: null,
@@ -135,11 +159,16 @@ function route(runs, workflow, step, subPlan) {
135
159
  nextStrategy: null,
136
160
  debugMode: null,
137
161
  pushMode: null,
162
+ publish: null,
163
+ publishSource: null,
138
164
  debugAttempt: 0,
165
+ parentSha: null,
139
166
  };
140
167
  const problems = {};
141
168
  if (step !== undefined) {
142
- const last = activeDoneSteps(runs, workflow, { step, subPlan }).at(-1);
169
+ const last = activeDoneSteps(runs, workflow, { step, group }).at(-1);
170
+ if (typeof last?.parentSha === "string")
171
+ out.parentSha = last.parentSha;
143
172
  if (!last) {
144
173
  problems.verdict = `no DONE ${step} row in the active ${workflow} run`;
145
174
  problems.failures = problems.verdict;
@@ -150,13 +179,16 @@ function route(runs, workflow, step, subPlan) {
150
179
  }
151
180
  else {
152
181
  out.verdict = last.verdict;
153
- const failures = last.failures ?? 0;
154
- if (Number.isInteger(failures) && failures >= 0)
182
+ // An absent count on FAIL is unknown, never 0: a FAIL always has failures.
183
+ const failures = last.failures ?? (last.verdict === "FAIL" ? null : 0);
184
+ if (failures === null)
185
+ out.failures = null;
186
+ else if (Number.isInteger(failures) && failures >= 0)
155
187
  out.failures = failures;
156
188
  else
157
189
  problems.failures = `${step} failures "${String(failures)}" is not a non-negative integer`;
158
190
  }
159
- const prior = lastDoneStepAllRuns(runs, workflow, { step, subPlan })?.strategy;
191
+ const prior = lastDoneStepAllRuns(runs, workflow, { step, group })?.strategy;
160
192
  if (prior === undefined || STRATEGIES.includes(prior)) {
161
193
  out.strategy = prior ?? null;
162
194
  out.nextStrategy = nextStrategy(prior);
@@ -176,10 +208,87 @@ function route(runs, workflow, step, subPlan) {
176
208
  problems[field] =
177
209
  value === "" ? `${field} not recorded` : `${field} "${value}" is not ${allowed.join("|")}`;
178
210
  }
211
+ problems.publish = "publish not resolved: needs --workflow=build with --prompt-file";
179
212
  const attempt = Number(lastRun(runs, workflow)?.debugAttempt ?? 0);
180
213
  out.debugAttempt = Number.isFinite(attempt) ? attempt : 0;
181
214
  return { out, problems };
182
215
  }
216
+ /**
217
+ * The debug run's start decisions, from the session prompt and the feature's debug runs.
218
+ * `fixMax` is `bkit.workflows.debug.fix.maxAttempts`: once that many fix rounds ran across
219
+ * every debug run, the run starts in SOAK.
220
+ */
221
+ export function debugStart(runs, promptText, fixMax) {
222
+ const attempt = runNumber(runs, "debug");
223
+ const latest = runs.at(-1);
224
+ // A resume: the newest run is debug's and still open. A finished run's modes never
225
+ // carry into the next run; its fix rounds count against `fixMax`.
226
+ const open = latest?.workflow === "debug" && latest.status === "IN_PROGRESS" ? latest : null;
227
+ const soaking = open !== null &&
228
+ (runOrStepField([open], "debug", "debugMode") === "SOAK" ||
229
+ open.steps.some((s) => s.step === "debug-failure-soak" && s.status === "DONE"));
230
+ const fixes = allRunsDoneSteps(runs, "debug", { step: "debug-failure-remediate" }).length;
231
+ const debugMode = promptText.includes("[soak]") || soaking || fixes >= fixMax ? "SOAK" : "NORMAL";
232
+ const selection = !promptText.includes("[local]") && validateCiSelection(open?.ciSelection)
233
+ ? open.ciSelection
234
+ : null;
235
+ const ci = selection?.mode === "ci" ? selection : null;
236
+ const ciGeneration = typeof open?.ciGeneration === "number" ? open.ciGeneration : 0;
237
+ const current = open?.steps.filter((s) => s.status === "DONE" && s.ciGeneration === ciGeneration) ?? [];
238
+ const defaults = promptText.includes("[live=off]")
239
+ ? BKIT_DEBUG_GATES.filter((g) => !g.endsWith("-live"))
240
+ : [...BKIT_DEBUG_GATES];
241
+ const covering = ci && ci.redTiers.length > 0
242
+ ? defaults
243
+ .filter((g) => ci.redTiers.every((tier) => g.slice("bkit:gate:".length).split("-").includes(tier)))
244
+ .reverse()
245
+ : [];
246
+ return {
247
+ debugAttempt: attempt,
248
+ debugMode,
249
+ repro: promptText.includes("[repro]"),
250
+ gates: [...new Set([...covering, ...defaults])],
251
+ ciRun: ci?.runId ?? null,
252
+ ciGeneration,
253
+ redTiers: ci?.redTiers ?? [],
254
+ ciFixDone: ci !== null &&
255
+ current.some((s) => ["debug-failure-remediate", "debug-failure-soak"].includes(s.step)),
256
+ ciReproduced: ci !== null &&
257
+ current.some((s) => s.step === "debug-failure-reproduce" && s.reproduced === "YES"),
258
+ };
259
+ }
260
+ const PUBLISH_TOKEN = /(?<![\w-])publish=(true|false)(?![\w-])/;
261
+ /**
262
+ * Build's ending, from the session prompt, `bkit.workflows.build.publish` and the runtime.
263
+ * A `publish=true|false` token wins; else LOCAL reads `publish.local` and any other runtime
264
+ * `publish.remote`. A non-LOCAL `false` resolves `true`. No `runtime-resolved` row throws.
265
+ */
266
+ export function publishRoute(rows, promptText, config) {
267
+ const row = rows.filter((r) => r.type === "runtime-resolved" && r.workflow === "build").at(-1);
268
+ if (row === undefined)
269
+ throw new CommandError(EXIT_ROUTE_MISSING, "no runtime-resolved row for build: Step 2 never recorded the runtime");
270
+ const local = row.runtime === "LOCAL";
271
+ const token = PUBLISH_TOKEN.exec(promptText)?.[1];
272
+ const wanted = token !== undefined ? token === "true" : local ? config.local : config.remote;
273
+ if (!local && !wanted)
274
+ return { publish: true, publishSource: "coerced" };
275
+ return {
276
+ publish: wanted,
277
+ publishSource: token !== undefined ? "token" : local ? "local" : "remote",
278
+ };
279
+ }
280
+ /** `--file`, else the debug status.jsonl `--fid` and `--month` name. */
281
+ function routeFile(ctx) {
282
+ if (ctx.flags.file !== undefined)
283
+ return statusFile(ctx);
284
+ const fid = str(ctx.flags.fid);
285
+ const month = str(ctx.flags.month);
286
+ if (fid === undefined || month === undefined || ctx.flags.promptFile === undefined)
287
+ throw new CommandError(EXIT.USAGE, "give --file, or --prompt-file with --fid and --month");
288
+ if (!/^[0-9]{6}$/.test(month))
289
+ throw new CommandError(EXIT.USAGE, "--month must be YYYYMM");
290
+ return statusLocation({ cwd: ctx.cwd, workflow: "debug", fid, month }).path;
291
+ }
183
292
  // ---------------------------------------------------------------------------
184
293
  // meta
185
294
  // ---------------------------------------------------------------------------
@@ -187,7 +296,6 @@ const META_FIELDS = {
187
296
  "debug-mode": { key: "debugMode", check: (v) => oneOf(v, DEBUG_MODES, "--debug-mode") },
188
297
  "push-mode": { key: "pushMode", check: (v) => oneOf(v, PUSH_MODES, "--push-mode") },
189
298
  "debug-attempt": { key: "debugAttempt", check: (v) => positiveInt(v, "debug-attempt") },
190
- "plan-source": { key: "planSource", check: (v) => oneOf(v, PLAN_SOURCES, "--plan-source") },
191
299
  };
192
300
  /** Row types the fold reads; each has its own verb (workflows start|fail|close, steps done, status meta). */
193
301
  const FOLDED_TYPES = new Set([
@@ -197,13 +305,10 @@ const FOLDED_TYPES = new Set([
197
305
  "workflow-done",
198
306
  "workflow-failed",
199
307
  ]);
200
- /** Markers that record the row's own time or a fact, not a value. */
308
+ /** Markers that record a fact, not a value. */
201
309
  const META_MARKS = {
202
- "soak-entry": (at) => ({ soakEntryAt: at }),
203
310
  "opened-pr": () => ({ openedPr: true }),
204
311
  };
205
- /** `brief` = the run had no plan file and works from its input file. */
206
- const PLAN_SOURCES = ["brief", "plan"];
207
312
  const camelFlag = (kebab) => kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
208
313
  function oneOf(v, allowed, flag) {
209
314
  if (!allowed.includes(v))
@@ -219,6 +324,7 @@ export const statusCommand = {
219
324
  verbs: {
220
325
  path: {
221
326
  summary: "Where this workflow's status.jsonl lives.",
327
+ use: "by-hand",
222
328
  flags: [
223
329
  WORKFLOW_FLAG,
224
330
  { name: "fid", type: "string", required: true, help: "feature id" },
@@ -244,16 +350,17 @@ export const statusCommand = {
244
350
  },
245
351
  },
246
352
  route: {
247
- summary: "Routing state: last verdict / failures / strategy of a step, debug and push mode.",
353
+ summary: "Routing state: last verdict / failures / strategy of a step, debug and push mode; with --prompt-file, debug's start decisions.",
354
+ use: "workflow",
248
355
  flags: [
249
- FILE_FLAG,
356
+ { ...FILE_FLAG, required: false, help: `${FILE_FLAG.help}; or --fid and --month` },
250
357
  WORKFLOW_FLAG,
251
358
  {
252
359
  ...STEP_FLAG,
253
360
  required: false,
254
361
  help: "step whose last DONE row gives verdict, failures, strategy",
255
362
  },
256
- SUB_PLAN_FLAG,
363
+ GROUP_FLAG,
257
364
  {
258
365
  name: "require",
259
366
  type: "string",
@@ -266,15 +373,32 @@ export const statusCommand = {
266
373
  repeatable: true,
267
374
  help: "field=value — fail (exit 4) unless the field holds this value, e.g. debugMode=NORMAL",
268
375
  },
376
+ {
377
+ name: "prompt-file",
378
+ type: "string",
379
+ help: "debug or build: the session prompt; debug: this run's attempt, mode, repro and gates (a missing status.jsonl is a fresh run); build: publish and publishSource",
380
+ },
381
+ { name: "fid", type: "string", help: "with --prompt-file, in place of --file: feature id" },
382
+ { name: "month", type: "string", help: "with --prompt-file, in place of --file: YYYYMM" },
269
383
  ],
270
384
  output: {
271
385
  verdict: "PASS|CONCERNS|FAIL of the step's last DONE row in the active run, or null",
272
- failures: "its failures (absent with a verdict = 0), or null",
386
+ ciRun: "active saved CI run ID with --prompt-file, or null; explicit [local] clears it",
387
+ ciGeneration: "active saved selection generation with --prompt-file, or 0",
388
+ redTiers: "active selected failed tiers with --prompt-file; empty for local or unknown jobs",
389
+ ciFixDone: "whether the active generation has a DONE remediation or soak",
390
+ ciReproduced: "whether the active generation has DONE reproduction with YES",
391
+ failures: "its failures (absent on PASS|CONCERNS = 0, absent on FAIL = null: count unknown), or null",
273
392
  strategy: "the step's last strategy across ALL runs, or null",
274
393
  nextStrategy: "next rung: STANDARD, PIVOT, FINAL (null without --step)",
275
- debugMode: "NORMAL|SOAK of the active run, or null",
394
+ debugMode: "NORMAL|SOAK of the active run, or null; with --prompt-file, the mode this invocation runs in (SOAK on [soak] in the prompt, an open run already in SOAK, or bkit.workflows.debug.fix.maxAttempts fix rounds already run across every debug run; else NORMAL)",
276
395
  pushMode: "PR|LOCAL of the active run, or null",
277
- debugAttempt: "debugAttempt of the active run (0 when unset)",
396
+ debugAttempt: "debugAttempt of the active run (0 when unset); with --prompt-file, this invocation's run number (a resume keeps its number)",
397
+ repro: "with --prompt-file: [repro] in the prompt",
398
+ gates: "with --prompt-file: the gates to try, deepest first; [live=off] in the prompt drops the live gate",
399
+ publish: "with --workflow=build and --prompt-file: whether the build publishes (a publish=true|false token, else publish.local on LOCAL or publish.remote elsewhere; a non-LOCAL false resolves true), else null",
400
+ publishSource: "with publish: token | local | remote | coerced (a non-LOCAL false forced to true), else null",
401
+ parentSha: "HEAD when the step's last DONE row in the active run was written — a build-group-start row's is the group's start commit, the base for `context diff` — or null",
278
402
  },
279
403
  exitCodes: {
280
404
  [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON",
@@ -302,8 +426,32 @@ export const statusCommand = {
302
426
  throw new CommandError(EXIT.USAGE, `--require ${r} needs --step`);
303
427
  }
304
428
  }
305
- const runs = readRuns(statusFile(ctx));
306
- const { out, problems } = route(runs, String(ctx.flags.workflow), step, positiveInt(ctx.flags.subPlan, "sub-plan"));
429
+ const promptFile = str(ctx.flags.promptFile);
430
+ if (promptFile !== undefined && !["debug", "build"].includes(String(ctx.flags.workflow)))
431
+ throw new CommandError(EXIT.USAGE, "--prompt-file is for --workflow=debug or build");
432
+ const file = routeFile(ctx);
433
+ let promptText = "";
434
+ if (promptFile !== undefined) {
435
+ const abs = path.resolve(ctx.cwd, promptFile);
436
+ if (!fs.existsSync(abs))
437
+ throw new CommandError(EXIT.USAGE, `--prompt-file ${abs} does not exist`);
438
+ promptText = fs.readFileSync(abs, "utf-8");
439
+ }
440
+ const runs = promptFile !== undefined && !fs.existsSync(file) ? [] : readRuns(file);
441
+ const { out, problems } = route(runs, String(ctx.flags.workflow), step, positiveInt(ctx.flags.group, "group"));
442
+ if (promptFile !== undefined) {
443
+ const root = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
444
+ const config = readBkitConfig(root);
445
+ if (ctx.flags.workflow === "debug") {
446
+ Object.assign(out, debugStart(runs, promptText, config.asks["debug.fix"].max));
447
+ delete problems.debugMode;
448
+ }
449
+ else {
450
+ const rows = fs.existsSync(file) ? readStatusRows(file) : [];
451
+ Object.assign(out, publishRoute(rows, promptText, config.buildPublish));
452
+ delete problems.publish;
453
+ }
454
+ }
307
455
  ctx.emit(out);
308
456
  const failed = required.filter((r) => problems[r] !== undefined);
309
457
  for (const r of failed)
@@ -315,21 +463,56 @@ export const statusCommand = {
315
463
  return failed.length === 0 && differ.length === 0 ? EXIT.OK : EXIT_ROUTE_MISSING;
316
464
  },
317
465
  },
466
+ resume: {
467
+ summary: "The step a stopped run continues at: after its last DONE step, setup steps and retired rows aside.",
468
+ use: "by-hand",
469
+ flags: [
470
+ { ...FILE_FLAG, help: "path to status.jsonl; a missing file is a run with no rows" },
471
+ { ...WORKFLOW_FLAG, help: `workflow name: ${Object.keys(WORKFLOW_STEPS).join(", ")}` },
472
+ ],
473
+ output: {
474
+ step: "the step's row name, or null for a step that writes no row",
475
+ number: "the step number to continue at (1 when no run is active)",
476
+ title: "the step heading's title",
477
+ after: "the DONE row that placed it, or null",
478
+ group: "that row's task group, or null",
479
+ active: "whether the latest run is this workflow, still IN_PROGRESS",
480
+ challengeRound: "build: the round Step 11's challenge runs as (1 up to bkit.workflows.build.challenge.maxAttempts), from the build-challenge rows' round field; null for other workflows",
481
+ challengeDone: "build: true once the last allowed challenge round has merged, so Step 11 goes on to Step 12; null for other workflows",
482
+ },
483
+ exitCodes: { [EXIT_NO_STATUS]: "status.jsonl unreadable or not valid NDJSON" },
484
+ run: (ctx) => {
485
+ const workflow = String(ctx.flags.workflow);
486
+ if (!isResumable(workflow))
487
+ throw new CommandError(EXIT.USAGE, `--workflow must be ${Object.keys(WORKFLOW_STEPS).join("|")}, got "${workflow}"`);
488
+ const file = statusFile(ctx);
489
+ const root = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
490
+ const challengeMax = readBkitConfig(root).asks["build.challenge"].max;
491
+ ctx.emit({
492
+ ...resumePoint(fs.existsSync(file) ? readRuns(file) : [], workflow, challengeMax),
493
+ });
494
+ return EXIT.OK;
495
+ },
496
+ },
318
497
  meta: {
319
498
  summary: "Append a workflow-meta row (run-level routing state).",
499
+ use: "workflow",
320
500
  flags: [
321
501
  FILE_FLAG,
322
502
  WORKFLOW_FLAG,
323
503
  { name: "debug-mode", type: "string", help: "NORMAL|SOAK" },
324
504
  { name: "push-mode", type: "string", help: "PR|LOCAL" },
325
- { name: "debug-attempt", type: "string", help: "positive integer" },
326
- { name: "plan-source", type: "string", help: "brief|plan" },
327
505
  {
328
- name: "soak-entry",
329
- type: "boolean",
330
- help: "record soakEntryAt (the soak budget counts from here)",
506
+ name: "debug-attempt",
507
+ type: "string",
508
+ help: "positive integer, or run (the active run's number)",
331
509
  },
332
510
  { name: "opened-pr", type: "boolean", help: "record openedPr: this run opened the PR" },
511
+ {
512
+ name: "ci-selection-file",
513
+ type: "string",
514
+ help: "validated atomic debug CI or local selection JSON",
515
+ },
333
516
  ],
334
517
  output: { row: "the appended workflow-meta row" },
335
518
  exitCodes: { [EXIT_NO_STATUS]: "status.jsonl does not exist (meta never starts a log)" },
@@ -337,10 +520,27 @@ export const statusCommand = {
337
520
  const file = statusFile(ctx);
338
521
  const at = statusTimestamp();
339
522
  const fields = {};
523
+ if (ctx.flags.ciSelectionFile !== undefined) {
524
+ const parsed = parseJson(fs.readFileSync(path.resolve(ctx.cwd, String(ctx.flags.ciSelectionFile)), "utf-8"));
525
+ const selection = parsed.ok ? parsed.value : null;
526
+ if (!validateCiSelection(selection))
527
+ throw new CommandError(EXIT.USAGE, "invalid CI selection");
528
+ const active = readRuns(file).at(-1);
529
+ if (ctx.flags.workflow !== "debug" ||
530
+ active?.workflow !== "debug" ||
531
+ active.status !== "IN_PROGRESS")
532
+ throw new CommandError(EXIT.USAGE, "CI selection needs an active debug run");
533
+ const same = validateCiSelection(active.ciSelection) &&
534
+ ciSelectionIdentity(active.ciSelection) === ciSelectionIdentity(selection);
535
+ fields.ciSelection =
536
+ selection.mode === "local" ? { mode: "local", reason: selection.reason } : selection;
537
+ fields.ciGeneration = (Number(active.ciGeneration) || 0) + (same ? 0 : 1);
538
+ }
340
539
  for (const { key, check } of Object.values(META_FIELDS)) {
341
540
  const v = str(ctx.flags[key]);
541
+ // `--debug-attempt=run`: the active run's number, read once the log is known to exist.
342
542
  if (v !== undefined)
343
- fields[key] = check(v);
543
+ fields[key] = key === "debugAttempt" && v === "run" ? v : check(v);
344
544
  }
345
545
  for (const [flag, mark] of Object.entries(META_MARKS)) {
346
546
  if (ctx.flags[camelFlag(flag)] === true)
@@ -353,6 +553,9 @@ export const statusCommand = {
353
553
  }
354
554
  if (!fs.existsSync(file))
355
555
  throw new CommandError(EXIT_NO_STATUS, `${file} does not exist`);
556
+ if (fields.debugAttempt === "run") {
557
+ fields.debugAttempt = runNumber(readRuns(file), String(ctx.flags.workflow));
558
+ }
356
559
  const row = {
357
560
  type: "workflow-meta",
358
561
  workflow: String(ctx.flags.workflow),
@@ -365,7 +568,8 @@ export const statusCommand = {
365
568
  },
366
569
  },
367
570
  row: {
368
- summary: "Append a typed audit row the fold does not model (ship's gate refusals, CI probes, merge CI).",
571
+ summary: "Append a typed audit row the fold does not model (ship's gate refusals, CI probes, merge CI); an owner-pause row also logs a human-confirm friction row.",
572
+ use: "workflow",
369
573
  flags: [
370
574
  FILE_FLAG,
371
575
  WORKFLOW_FLAG,
@@ -383,7 +587,10 @@ export const statusCommand = {
383
587
  },
384
588
  ],
385
589
  output: { row: "the appended row" },
386
- exitCodes: { [EXIT_NO_STATUS]: "status.jsonl does not exist (a row never starts a log)" },
590
+ exitCodes: {
591
+ [EXIT_NO_STATUS]: "status.jsonl does not exist (a row never starts a log)",
592
+ [EXIT_PAUSE_FRICTION]: "an owner-pause row was appended but its human-confirm friction row was not written",
593
+ },
387
594
  run: (ctx) => {
388
595
  const type = String(ctx.flags.type);
389
596
  if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(type))
@@ -403,10 +610,51 @@ export const statusCommand = {
403
610
  at: statusTimestamp(),
404
611
  ...fields,
405
612
  };
613
+ const prior = type === "owner-pause" ? fs.readFileSync(file, "utf-8") : "";
406
614
  fs.appendFileSync(file, appendLine(row));
615
+ if (type === "owner-pause")
616
+ recordPause(ctx.cwd, file, row, prior);
407
617
  ctx.emit({ row });
408
618
  return EXIT.OK;
409
619
  },
410
620
  },
411
621
  },
412
622
  };
623
+ const pauseReason = (row) => row["reason"] === undefined ? undefined : String(row["reason"]);
624
+ /**
625
+ * Log an owner pause as `human-confirm` friction in the active run's books. A
626
+ * follow-up wait writes nothing: `prior` (the status file before this row) holds an
627
+ * `owner-pause` row with the same workflow and reason and no `step-done` row after it.
628
+ * Nothing is written outside an active run or with `BKIT_ENGINE_JOURNAL=off`.
629
+ */
630
+ function recordPause(cwd, file, row, prior) {
631
+ if (!journalEnabled())
632
+ return;
633
+ const reason = pauseReason(row);
634
+ let waiting = false;
635
+ for (const line of prior.split("\n")) {
636
+ const parsed = parseJson(line);
637
+ if (!parsed.ok || parsed.value === null || typeof parsed.value !== "object")
638
+ continue;
639
+ const r = parsed.value;
640
+ if (r["type"] === "step-done")
641
+ waiting = false;
642
+ else if (r["type"] === "owner-pause" && r["workflow"] === row.workflow) {
643
+ waiting ||= pauseReason(r) === reason;
644
+ }
645
+ }
646
+ if (waiting)
647
+ return;
648
+ const run = resolveActiveRun({ cwd, file });
649
+ if (run === undefined)
650
+ return;
651
+ const wrote = appendFrictionRow(run.bookRoot, pauseFrictionRow({
652
+ workflow: row.workflow,
653
+ reason,
654
+ bookRoot: run.bookRoot,
655
+ parentSha: resolveGitSha("HEAD", run.bookRoot),
656
+ }));
657
+ if (!wrote.ok) {
658
+ throw new CommandError(EXIT_PAUSE_FRICTION, `owner-pause row kept; its friction row was not written: ${wrote.error}`);
659
+ }
660
+ }