@cbartens/bkit 6.0.0 → 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 (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -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 +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  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 +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -32,8 +32,10 @@ import {
32
32
  runOrStepField,
33
33
  statusTimestamp,
34
34
  type StatusEvent,
35
+ type StatusRow,
35
36
  } from "../../ledgers/status.js";
36
37
  import {
38
+ compareTs,
37
39
  foldFrom,
38
40
  normalize,
39
41
  resolveRepoSlug,
@@ -41,9 +43,17 @@ import {
41
43
  type CoverageStats,
42
44
  type OutcomePayload,
43
45
  } from "../../ledgers/telemetry.js";
44
- import { readBkitConfig } from "../../shared/settings.js";
46
+ import {
47
+ check as checkCompleteness,
48
+ deriveContract,
49
+ parseRows,
50
+ readCompleteness,
51
+ type StatusRow as HoleRow,
52
+ } from "../../checks/status-holes.js";
53
+ import { getWorkflowsRoot } from "../../shared/package-roots.js";
54
+ import { ASK_POINTS, readBkitConfig } from "../../shared/settings.js";
45
55
  import { gradeCompliance } from "../comply.js";
46
- import { landDir, pushToDev, type DevPush } from "../land.js";
56
+ import { fetchDev, landDir, pushToDev, type DevPush } from "../land.js";
47
57
  import {
48
58
  CommandError,
49
59
  DEV,
@@ -102,7 +112,7 @@ import {
102
112
  timeBlock,
103
113
  } from "./run-facts.js";
104
114
  import { buildSummary, refOf, SUMMARY_WORKFLOWS, type SummaryWorkflow } from "./summary.js";
105
- import { parseWorkstreams } from "./workstreams.js";
115
+ import { parsePlans, parseWorkstreams } from "./plans.js";
106
116
  import {
107
117
  EXIT_REMOVE_FAILED,
108
118
  EXIT_SPLIT_BUCKET,
@@ -304,17 +314,23 @@ function checkHeldLock(file: string, who: { workflow: string; fid: string; token
304
314
  // ---------------------------------------------------------------------------
305
315
 
306
316
  /**
307
- * Abort a rebase left in progress in `tree`. `git rev-parse --git-path X` always
308
- * exits 0 (it only computes the path), so the directory's existence is the test.
317
+ * Abort a rebase or a merge left in progress in `tree` (ship Step 4 leaves a merge
318
+ * of origin/dev in progress for a hand resolution). `git rev-parse --git-path X`
319
+ * always exits 0 (it only computes the path), so the path's existence is the test.
309
320
  */
310
321
  function abortRebase(tree: string, log: (m: string) => void): boolean {
311
- const inProgress = ["rebase-merge", "rebase-apply"].some((name) => {
322
+ const present = (name: string) => {
312
323
  const p = git(tree, ["rev-parse", "--path-format=absolute", "--git-path", name]);
313
324
  return p !== null && fs.existsSync(p);
314
- });
315
- if (!inProgress) return false;
316
- const res = runGit(tree, ["rebase", "--abort"]);
317
- if (!res.ok) log(`git rebase --abort failed in ${tree}: ${res.stderr}`);
325
+ };
326
+ const op = ["rebase-merge", "rebase-apply"].some(present)
327
+ ? "rebase"
328
+ : present("MERGE_HEAD")
329
+ ? "merge"
330
+ : null;
331
+ if (op === null) return false;
332
+ const res = runGit(tree, [op, "--abort"]);
333
+ if (!res.ok) log(`git ${op} --abort failed in ${tree}: ${res.stderr}`);
318
334
  return res.ok;
319
335
  }
320
336
 
@@ -871,7 +887,8 @@ async function handoverVerb(ctx: RunContext): Promise<number> {
871
887
  ref = r.ref;
872
888
  skipped = r.skipped;
873
889
  } else if (push) {
874
- addAllButCopied(tree);
890
+ const added = addAllButCopied(tree);
891
+ if (!added.ok) ctx.log(`abort commit: git add failed: ${added.stderr}`);
875
892
  const made = runGit(tree, ["commit", "-m", `docs(${fid}): ${workflow} aborted bkit [skip ci]`]);
876
893
  if (!made.ok) ctx.log(`abort commit: ${made.stderr || made.stdout}`);
877
894
  const r = await pushBranch(tree, { mode: "abort", openPr: str(ctx.flags.openPr) }, ctx.log);
@@ -1033,6 +1050,100 @@ function appendStats(tree: string, rows: Array<Record<string, unknown>>, log: (m
1033
1050
  }
1034
1051
  }
1035
1052
 
1053
+ /**
1054
+ * The rows of `workflow`'s `nth` run in `file` (the last when omitted), in time order;
1055
+ * unreadable lines skipped. Runs split as `fold` splits them: rows ordered by `at`, file
1056
+ * order on a tie, each new `workflow-started` opening a run, so a previous run's rows in
1057
+ * the same second as this run's start stay with the previous run.
1058
+ */
1059
+ function runRowsOf(file: string, workflow: string, nth = -1): HoleRow[] {
1060
+ const at = (r: HoleRow) => (typeof r["at"] === "string" ? r["at"] : "");
1061
+ const ordered = parseRows(fs.readFileSync(file, "utf-8"))
1062
+ .map((r, i) => ({ r, i }))
1063
+ .filter(({ r }) => r.workflow === workflow)
1064
+ .sort((a, b) => (at(a.r) < at(b.r) ? -1 : at(a.r) > at(b.r) ? 1 : a.i - b.i))
1065
+ .map(({ r }) => r);
1066
+ const runs: HoleRow[][] = [];
1067
+ const starts = new Set<string>();
1068
+ for (const r of ordered) {
1069
+ if (r.type === "workflow-started" && !starts.has(at(r))) {
1070
+ starts.add(at(r));
1071
+ runs.push([]);
1072
+ } else if (runs.length === 0 && r.type === "step-done") {
1073
+ runs.push([]);
1074
+ }
1075
+ runs.at(-1)?.push(r);
1076
+ }
1077
+ return runs.at(nth) ?? [];
1078
+ }
1079
+
1080
+ /** The contract of `workflow`, derived from its shipped markdown rendered for the tracker `cwd` is configured with. */
1081
+ const contractOf = (workflow: string, cwd: string) =>
1082
+ deriveContract(
1083
+ fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"),
1084
+ workflow,
1085
+ readIssueTracker(cwd),
1086
+ );
1087
+
1088
+ /**
1089
+ * Appends the close's `completeness` row for `workflow`'s last run. Advisory:
1090
+ * a failure of the check or of the write is logged in one line and never fails the close.
1091
+ * `journalSuspect` is set here only: the closing engine journals itself.
1092
+ */
1093
+ function writeCompletenessRow(
1094
+ file: string,
1095
+ workflow: string,
1096
+ parentSha: string,
1097
+ log: (m: string) => void,
1098
+ ): void {
1099
+ try {
1100
+ const verdict = checkCompleteness(
1101
+ runRowsOf(file, workflow),
1102
+ contractOf(workflow, path.dirname(file)),
1103
+ {
1104
+ journalSuspect: true,
1105
+ },
1106
+ );
1107
+ const row: StatusRow = { type: "completeness", ...verdict, at: statusTimestamp(), parentSha };
1108
+ fs.appendFileSync(file, appendLine(row));
1109
+ if (verdict.journalSuspect) {
1110
+ log(
1111
+ "[bkit-telemetry] journal looks dead at close: no engine-call rows for this run; the completeness verdict cannot be trusted",
1112
+ );
1113
+ }
1114
+ } catch (err) {
1115
+ // The check is advisory: report the failure and close without the row.
1116
+ log(`[bkit-telemetry] completeness row not written: ${(err as Error).message}`);
1117
+ }
1118
+ }
1119
+
1120
+ /**
1121
+ * The warning line for the run before the one being started (or resumed) when that run
1122
+ * was holey; `null` when it is clean, absent or unreadable. Never throws.
1123
+ */
1124
+ function previousRunWarning(file: string, resumed: boolean): string | null {
1125
+ try {
1126
+ const events = readStatusEvents(file);
1127
+ const runs = fold(events);
1128
+ const at = runs.length - (resumed ? 2 : 1);
1129
+ const prev = runs[at];
1130
+ if (prev === undefined) return null;
1131
+ const number = runs.slice(0, at + 1).filter((r) => r.workflow === prev.workflow).length;
1132
+ const own = runRowsOf(file, prev.workflow, number - 1);
1133
+ const { verdict } = readCompleteness(own, contractOf(prev.workflow, path.dirname(file)));
1134
+ if (!verdict.holey) return null;
1135
+ const closed = own.filter((e) => e.type === "workflow-done").at(-1)?.["at"] ?? "never";
1136
+ return (
1137
+ `[bkit-workflows] previous run (${prev.workflow} run ${number}, closed ${closed}) was incomplete: ` +
1138
+ `${verdict.evidenceHoles.length} evidence hole(s), ${verdict.stepHoles.length} step hole(s); ` +
1139
+ `see: bkit completeness check --workflow=${prev.workflow} --file=${path.relative(process.cwd(), file) || file}`
1140
+ );
1141
+ } catch {
1142
+ // Advisory: an unreadable run or checker failure degrades to no warning.
1143
+ return null;
1144
+ }
1145
+ }
1146
+
1036
1147
  /** Markdown link per feature doc and per log of this workflow, as on `ref`. */
1037
1148
  export function artifactLinks(
1038
1149
  root: string,
@@ -1085,6 +1196,20 @@ function closeComment(
1085
1196
  });
1086
1197
  }
1087
1198
 
1199
+ /** `--ending` / `--publish` of the close verb, validated. */
1200
+ function closeEnding(f: Record<string, FlagValue>): Pick<CloseInput, "ending" | "publish"> {
1201
+ const ending = str(f.ending);
1202
+ if (ending !== undefined && ending !== "done" && ending !== "held")
1203
+ throw new CommandError(EXIT.USAGE, `--ending must be done or held, got ${ending}`);
1204
+ const publish = str(f.publish);
1205
+ if (publish !== undefined && publish !== "true" && publish !== "false")
1206
+ throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publish}`);
1207
+ return {
1208
+ ...(ending === undefined ? {} : { ending }),
1209
+ ...(publish === undefined ? {} : { publish: publish === "true" }),
1210
+ };
1211
+ }
1212
+
1088
1213
  export interface CloseInput {
1089
1214
  workflow: string;
1090
1215
  fid: string;
@@ -1102,6 +1227,10 @@ export interface CloseInput {
1102
1227
  number?: string;
1103
1228
  title?: string;
1104
1229
  tree?: string;
1230
+ /** `held` = a local build that published nothing; default `done`. */
1231
+ ending?: "done" | "held";
1232
+ /** The resolved publish value of a build; absent when unset. */
1233
+ publish?: boolean;
1105
1234
  }
1106
1235
 
1107
1236
  /**
@@ -1134,15 +1263,26 @@ export function closeWorkflow(
1134
1263
  // Graded first, so the report below carries this run's grade.
1135
1264
  const violations = gradeCompliance(where.tree, workflow, log, o.squashSha, { parentSha, step });
1136
1265
 
1266
+ let progressLine: string | undefined;
1137
1267
  if (o.recordStep === true) {
1138
- writeStepRow(
1268
+ const written = writeStepRow(
1139
1269
  where.tree,
1140
1270
  { file: where.status, workflow, step, artifacts: [], commit: "none" },
1141
1271
  log,
1142
1272
  );
1273
+ progressLine = written.progressLine;
1143
1274
  }
1275
+ writeCompletenessRow(where.status, workflow, parentSha, log);
1144
1276
  const endAt = statusTimestamp();
1145
- const row = { type: "workflow-done" as const, workflow, at: endAt, parentSha };
1277
+ const ending = o.ending ?? "done";
1278
+ const row = {
1279
+ type: "workflow-done" as const,
1280
+ workflow,
1281
+ at: endAt,
1282
+ parentSha,
1283
+ ending,
1284
+ ...(o.publish === undefined ? {} : { publish: o.publish }),
1285
+ };
1146
1286
  fs.appendFileSync(where.status, appendLine(row));
1147
1287
 
1148
1288
  const repo = resolveRepoSlug(where.root) || "unknown/repo";
@@ -1159,7 +1299,6 @@ export function closeWorkflow(
1159
1299
  const startedRows = new Set(
1160
1300
  events.filter((e) => e.type === "workflow-started" && e.workflow === workflow).map((e) => e.at),
1161
1301
  ).size;
1162
- const logDir = path.join(where.tree, logDirRel(where.month, o.fid));
1163
1302
  const by = { workflow, step };
1164
1303
 
1165
1304
  const counterRow = {
@@ -1199,7 +1338,8 @@ export function closeWorkflow(
1199
1338
  by,
1200
1339
  run: { parentSha, ...(o.prNumber === undefined ? {} : { pr: o.prNumber }) },
1201
1340
  time: startKnown === undefined ? null : timeBlock(startKnown, Math.max(startKnown, endMs)),
1202
- ending: "done",
1341
+ ending,
1342
+ ...(o.publish === undefined ? {} : { publish: o.publish }),
1203
1343
  lines,
1204
1344
  ...(runRowsOf.length > 0 ? { steps: stepsBlock(runRowsOf) } : {}),
1205
1345
  ...(ci.length > 0 ? { ci } : {}),
@@ -1207,12 +1347,7 @@ export function closeWorkflow(
1207
1347
  ...(plan === undefined ? {} : { plan }),
1208
1348
  ...(workflow === "build"
1209
1349
  ? {
1210
- build: buildBlock(
1211
- runRowsOf,
1212
- logDir,
1213
- planFiles(where.tree, where.month, o.fid),
1214
- runDeferrals(),
1215
- ),
1350
+ build: buildBlock(runRowsOf, planFiles(where.tree, where.month, o.fid), runDeferrals()),
1216
1351
  }
1217
1352
  : {}),
1218
1353
  ...(context === undefined ? {} : { context }),
@@ -1296,6 +1431,7 @@ export function closeWorkflow(
1296
1431
  comment,
1297
1432
  roadmapFoldNeeded: true,
1298
1433
  featureStatus: FEATURE_STATUS[workflow],
1434
+ ...(progressLine === undefined ? {} : { progressLine }),
1299
1435
  };
1300
1436
  }
1301
1437
 
@@ -1343,8 +1479,8 @@ function closePr(
1343
1479
  * checkout): the close rows there, then ONE `docs({fid}): ship DONE bkit [skip ci]`
1344
1480
  * commit built in a throwaway origin/dev checkout carrying the run's book and
1345
1481
  * landed on dev — a refused push publishes it through a `ship-close/{fid}` PR.
1346
- * Only a close that landed (or opened its PR) releases the workflow lock; once
1347
- * the close is on dev, the feature worktree and `branch` are removed. A close
1482
+ * Once the close is on dev, the feature worktree and `branch` are removed; then
1483
+ * a close that landed (or opened its PR) releases the workflow lock. A close
1348
1484
  * that did not land keeps the lock for the Failure Path.
1349
1485
  */
1350
1486
  async function shipClose(
@@ -1420,22 +1556,13 @@ async function shipClose(
1420
1556
  return { code: EXIT_FLUSH_FAILED, out: null };
1421
1557
  }
1422
1558
 
1423
- const released = releaseLock(workflowLockPath(root, month, o.fid), {
1424
- workflow: "ship",
1425
- fid: o.fid,
1426
- token,
1427
- });
1428
- if (released.removeFailed) {
1429
- ctx.log("Lock removal failed");
1430
- return { code: EXIT_FLUSH_FAILED, out: null };
1431
- }
1432
-
1433
- // The book is on dev only once the close landed or its PR merged.
1559
+ // The book is on dev only once the close landed or its PR merged. The worktree
1560
+ // goes while the lock is still held, so no run of this FID resumes into it.
1434
1561
  let worktree: RemoveResult | null = null;
1435
1562
  if (landed.via === "close-pr-open") {
1436
1563
  ctx.log(`close PR not merged — ${kept} until it is`);
1437
1564
  } else {
1438
- if (landed.via === "close-pr" && !runGit(root, ["fetch", "origin", DEV]).ok)
1565
+ if (landed.via === "close-pr" && !fetchDev(root).ok)
1439
1566
  ctx.log(
1440
1567
  `fetch of dev after the close PR failed — origin/${DEV} is stale until the next fetch`,
1441
1568
  );
@@ -1445,6 +1572,16 @@ async function shipClose(
1445
1572
  ctx.log(`${(err as Error).message} — remove ${book} by hand`);
1446
1573
  }
1447
1574
  }
1575
+
1576
+ const released = releaseLock(workflowLockPath(root, month, o.fid), {
1577
+ workflow: "ship",
1578
+ fid: o.fid,
1579
+ token,
1580
+ });
1581
+ if (released.removeFailed) {
1582
+ ctx.log("Lock removal failed");
1583
+ return { code: EXIT_FLUSH_FAILED, out: null };
1584
+ }
1448
1585
  return { code: EXIT.OK, out: { ...out, landed, worktree } };
1449
1586
  }
1450
1587
 
@@ -1583,24 +1720,38 @@ function summaryVerb(ctx: RunContext): number {
1583
1720
  const abs = path.resolve(tree, r);
1584
1721
  return fs.existsSync(abs) && fs.statSync(abs).isFile() ? fs.readFileSync(abs, "utf-8") : null;
1585
1722
  };
1586
- const deferrals = ledgerRows(path.join(tree, "docs", "deferrals.jsonl"))
1587
- .map((r) => normalize(r))
1588
- .filter((r) => byWorkflow(r) === workflow && Number(r.ts) >= startMs);
1723
+ const deferralHistory = ledgerRows(path.join(tree, "docs", "deferrals.jsonl")).map((r) =>
1724
+ normalize(r),
1725
+ );
1726
+ const runDeferralKeys = new Set(
1727
+ deferralHistory
1728
+ .filter((r) => isRunsOwnRow(r, { fid, workflow, startMs }, new Set()))
1729
+ .map((r) => r.key),
1730
+ );
1731
+ const currentDeferrals = new Map(
1732
+ deferralHistory.sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts })).map((r) => [r.key, r]),
1733
+ );
1734
+ const deferrals = [...currentDeferrals.values()].filter((r) => runDeferralKeys.has(r.key));
1589
1735
  const organisedPath = path.join(logDir, "design-v3-organised.md");
1590
1736
  const organised =
1591
1737
  workflow === "design" && fs.existsSync(organisedPath)
1592
1738
  ? fs.readFileSync(organisedPath, "utf-8")
1593
1739
  : undefined;
1594
1740
  const prNumber = positiveInt(ctx.flags.pr, "pr");
1741
+ const publishFlag = str(ctx.flags.publish);
1742
+ if (publishFlag !== undefined && publishFlag !== "true" && publishFlag !== "false")
1743
+ throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publishFlag}`);
1595
1744
 
1596
1745
  const summary = buildSummary({
1746
+ root: tree,
1747
+ publish: publishFlag === undefined ? undefined : publishFlag === "true",
1597
1748
  workflow: workflow as SummaryWorkflow,
1598
1749
  fid,
1599
1750
  ref: refOf(fid, readIssueTracker(tree)),
1600
1751
  rows,
1601
1752
  plans: plans.map((p) => ({ path: rel(p), text: fs.readFileSync(p, "utf-8") })),
1602
1753
  deferrals,
1603
- deferralsAdded: ledgerCounts(tree, workflow, startMs).deferrals.added ?? 0,
1754
+ deferralsAdded: deferrals.filter((r) => r.status !== "CLOSED").length,
1604
1755
  decisionFiles:
1605
1756
  (workflow === "build" || workflow === "ship") && fs.existsSync(logDir)
1606
1757
  ? fs
@@ -1611,6 +1762,7 @@ function summaryVerb(ctx: RunContext): number {
1611
1762
  : [],
1612
1763
  read,
1613
1764
  workstreams: organised === undefined ? undefined : parseWorkstreams(organised),
1765
+ suggestedPlans: organised === undefined ? undefined : parsePlans(organised),
1614
1766
  organised,
1615
1767
  pr:
1616
1768
  workflow === "ship" && prNumber !== undefined
@@ -1901,6 +2053,7 @@ export const workflowsCommand: CommandSpec = {
1901
2053
  verbs: {
1902
2054
  start: {
1903
2055
  summary: "Take the feature lock and open a run (workflow-started unless resuming).",
2056
+ use: "workflow",
1904
2057
  flags: [
1905
2058
  WORKFLOW_FLAG,
1906
2059
  FID_FLAG,
@@ -1922,7 +2075,7 @@ export const workflowsCommand: CommandSpec = {
1922
2075
  lock: "{path, month, token, reclaimed} of the lock taken, or {path} with --lock-held",
1923
2076
  file: "absolute path to status.jsonl",
1924
2077
  resumed: "the latest run was this workflow, IN_PROGRESS: no new row",
1925
- row: "the appended workflow-started row, or null when resuming",
2078
+ row: "the appended workflow-started row, with `limits` (the workflow's ask points from bkit.workflows, frozen for the run), or null when resuming",
1926
2079
  run: "which run of the workflow this is (1-based)",
1927
2080
  lastDoneStep: "the current run's last DONE step: resume after it (null on a new run)",
1928
2081
  openDecision:
@@ -1986,15 +2139,22 @@ export const workflowsCommand: CommandSpec = {
1986
2139
  }
1987
2140
  }
1988
2141
 
1989
- const latest = fold(readStatusEvents(file)).at(-1);
1990
- const resumed = latest?.workflow === workflow && latest.status === "IN_PROGRESS";
2142
+ const resumed = lastRun(fold(readStatusEvents(file)), workflow)?.status === "IN_PROGRESS";
2143
+ const holeyWarning = previousRunWarning(file, resumed);
2144
+ if (holeyWarning !== null) ctx.log(holeyWarning);
1991
2145
  let row: Record<string, unknown> | null = null;
1992
2146
  if (!resumed) {
2147
+ // The run's limits, frozen here: `counters route` reads them for the whole run.
2148
+ const asks = readBkitConfig(where.tree).asks;
2149
+ const limits = Object.fromEntries(
2150
+ ASK_POINTS.filter((p) => p.startsWith(`${workflow}.`)).map((p) => [p, asks[p]]),
2151
+ );
1993
2152
  row = {
1994
2153
  type: "workflow-started",
1995
2154
  workflow,
1996
2155
  at: statusTimestamp(),
1997
2156
  parentSha: headSha(path.dirname(file)),
2157
+ ...(Object.keys(limits).length === 0 ? {} : { limits }),
1998
2158
  };
1999
2159
  fs.appendFileSync(file, appendLine(row as StatusEvent));
2000
2160
  }
@@ -2019,6 +2179,7 @@ export const workflowsCommand: CommandSpec = {
2019
2179
  fail: {
2020
2180
  summary:
2021
2181
  "Failure Path: workflow-failed row, abort rebase, release lock, clear sentinels (with --token); the bkit:failed labels and the failure comment.",
2182
+ use: "workflow",
2022
2183
  flags: [
2023
2184
  WORKFLOW_FLAG,
2024
2185
  { ...FID_FLAG, required: false, help: "feature id (needed with --token)" },
@@ -2075,7 +2236,7 @@ export const workflowsCommand: CommandSpec = {
2075
2236
  ],
2076
2237
  output: {
2077
2238
  row: "the appended workflow-failed row, or null (no --token, or no status.jsonl)",
2078
- rebaseAborted: "an in-progress rebase was found and aborted",
2239
+ rebaseAborted: "an in-progress rebase or merge was found and aborted",
2079
2240
  lock: "{path, existed, released, heldBy}: heldBy is another owner's lock line, left in place; null without --token",
2080
2241
  sentinels: "[{name, path}] sentinels that existed before this call removed them",
2081
2242
  handoverNeeded:
@@ -2103,6 +2264,7 @@ export const workflowsCommand: CommandSpec = {
2103
2264
  handover: {
2104
2265
  summary:
2105
2266
  "Keep a failed run's record: commit and push it on the feature branch, or land its logs and ledgers on dev (--push from dev / main, ship's --flush); print the handover comment.",
2267
+ use: "workflow",
2106
2268
  flags: [
2107
2269
  WORKFLOW_FLAG,
2108
2270
  FID_FLAG,
@@ -2163,6 +2325,7 @@ export const workflowsCommand: CommandSpec = {
2163
2325
  close: {
2164
2326
  summary:
2165
2327
  "Grade compliance, workflow-done row, counter + outcome telemetry, report, artifact links; --flush lands ship's close on dev.",
2328
+ use: "workflow",
2166
2329
  flags: [
2167
2330
  WORKFLOW_FLAG,
2168
2331
  FID_FLAG,
@@ -2212,6 +2375,16 @@ export const workflowsCommand: CommandSpec = {
2212
2375
  },
2213
2376
  ...COMMENT_FLAGS,
2214
2377
  { name: "tree", type: "string", help: "the close comment links the tree of this ref" },
2378
+ {
2379
+ name: "ending",
2380
+ type: "string",
2381
+ help: "done|held (default done); held = a local build that published nothing",
2382
+ },
2383
+ {
2384
+ name: "publish",
2385
+ type: "string",
2386
+ help: "build: true|false, the resolved publish value; recorded on the workflow-done and outcome rows",
2387
+ },
2215
2388
  {
2216
2389
  name: "flush",
2217
2390
  type: "boolean",
@@ -2278,6 +2451,8 @@ export const workflowsCommand: CommandSpec = {
2278
2451
  roadmapFoldNeeded:
2279
2452
  "always true: append the feature row and re-render the board (not run here)",
2280
2453
  featureStatus: "roadmap status this close moves the feature to",
2454
+ progressLine:
2455
+ "--record-step: the exact chat progress line after a numbered completion is recorded",
2281
2456
  landed: "--flush: {ref, via: head-push | close-pr | close-pr-open}",
2282
2457
  worktree:
2283
2458
  "--flush: the `bkit worktrees remove` result once the close is on dev; null while the close PR is unmerged or the removal failed",
@@ -2316,6 +2491,7 @@ export const workflowsCommand: CommandSpec = {
2316
2491
  number: str(f.number),
2317
2492
  title: str(f.title),
2318
2493
  tree: str(f.tree),
2494
+ ...closeEnding(f),
2319
2495
  };
2320
2496
  const finalParts = finalReturnParts(ctx, input.fid);
2321
2497
  if (f.flush === true) {
@@ -2341,6 +2517,7 @@ export const workflowsCommand: CommandSpec = {
2341
2517
  input: {
2342
2518
  summary:
2343
2519
  "Write logs/{FID}/{workflow}-input-{run}.md: the session prompt, the issue description and each human comment, then the plan, design and audit reports, each section dated.",
2520
+ use: "workflow",
2344
2521
  flags: [
2345
2522
  WORKFLOW_FLAG,
2346
2523
  FID_FLAG,
@@ -2391,6 +2568,7 @@ export const workflowsCommand: CommandSpec = {
2391
2568
  promote: {
2392
2569
  summary:
2393
2570
  "Design / plan close: the highest versioned draft becomes the canonical doc (anchor stamped, a changed canonical archived).",
2571
+ use: "workflow",
2394
2572
  flags: [
2395
2573
  { ...WORKFLOW_FLAG, help: "design | plan" },
2396
2574
  FID_FLAG,
@@ -2422,6 +2600,7 @@ export const workflowsCommand: CommandSpec = {
2422
2600
  links: {
2423
2601
  summary:
2424
2602
  "The feature's docs and this workflow's logs on a ref as markdown links; optionally the close comment.",
2603
+ use: "workflow",
2425
2604
  flags: [
2426
2605
  WORKFLOW_FLAG,
2427
2606
  FID_FLAG,
@@ -2487,6 +2666,7 @@ export const workflowsCommand: CommandSpec = {
2487
2666
  summary: {
2488
2667
  summary:
2489
2668
  "The Summary step: write {workflow}-summary.md next to --file with the run's verdict, reasons and next command.",
2669
+ use: "workflow",
2490
2670
  flags: [
2491
2671
  { ...WORKFLOW_FLAG, help: "plan | design | build | debug | ship" },
2492
2672
  {
@@ -2506,6 +2686,11 @@ export const workflowsCommand: CommandSpec = {
2506
2686
  type: "string",
2507
2687
  help: "ship: the PR number; its size comes from gh pr view (left out when gh cannot answer)",
2508
2688
  },
2689
+ {
2690
+ name: "publish",
2691
+ type: "string",
2692
+ help: "build: true|false, the resolved ending; false writes `Publish: held` and `Docs: not synced` (default true)",
2693
+ },
2509
2694
  ],
2510
2695
  output: {
2511
2696
  verdict: "PASS | CONCERNS | FAIL",