@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
@@ -23,10 +23,12 @@ import * as fs from "node:fs";
23
23
  import * as os from "node:os";
24
24
  import * as path from "node:path";
25
25
  import { appendLine, fold, lastRun, runNumber, runOrStepField, statusTimestamp, } from "../../ledgers/status.js";
26
- import { foldFrom, normalize, resolveRepoSlug, workflowTelemetry, } from "../../ledgers/telemetry.js";
27
- import { readBkitConfig } from "../../shared/settings.js";
26
+ import { compareTs, foldFrom, normalize, resolveRepoSlug, workflowTelemetry, } from "../../ledgers/telemetry.js";
27
+ import { check as checkCompleteness, deriveContract, parseRows, readCompleteness, } from "../../checks/status-holes.js";
28
+ import { getWorkflowsRoot } from "../../shared/package-roots.js";
29
+ import { ASK_POINTS, readBkitConfig } from "../../shared/settings.js";
28
30
  import { gradeCompliance } from "../comply.js";
29
- import { landDir, pushToDev } from "../land.js";
31
+ import { fetchDev, landDir, pushToDev } from "../land.js";
30
32
  import { CommandError, DEV, EXIT, git, isSharedBranch, parseJson, repoRoot, runGh, runGit, statusLocation, statusRelPath, } from "../lib.js";
31
33
  import { anchorBkitStatus, pushBranch, readAnchor, stampAnchor } from "./branches.js";
32
34
  import { AUTO_LABEL, AUTO_ROUTE_SUFFIX, buildComment, issueParts, parseComments, sortOldestFirst, trackerState, transitionLabels, } from "./issues.js";
@@ -34,7 +36,7 @@ import { EXIT_EMPTY, activeRecord, commitBookkeeping, ownPathCommit, ownSet, rem
34
36
  import { readIssueTracker } from "./fids.js";
35
37
  import { agentContextBlock, buildBlock, chatFingerprint, ciList, claudeTranscripts, hostChat, planBlock, planFiles, runChats, runLines, runStatusRows, stepsBlock, timeBlock, } from "./run-facts.js";
36
38
  import { buildSummary, refOf, SUMMARY_WORKFLOWS } from "./summary.js";
37
- import { parseWorkstreams } from "./workstreams.js";
39
+ import { parsePlans, parseWorkstreams } from "./plans.js";
38
40
  import { EXIT_REMOVE_FAILED, EXIT_SPLIT_BUCKET, acquireWorkflowLock, owns, readHolder, releaseLock, resolveMonth, workflowLockPath, } from "./locks.js";
39
41
  import { highestVersion } from "./plan-versions.js";
40
42
  import { mergePr, probePr } from "./prs.js";
@@ -158,19 +160,25 @@ function checkHeldLock(file, who) {
158
160
  // fail
159
161
  // ---------------------------------------------------------------------------
160
162
  /**
161
- * Abort a rebase left in progress in `tree`. `git rev-parse --git-path X` always
162
- * exits 0 (it only computes the path), so the directory's existence is the test.
163
+ * Abort a rebase or a merge left in progress in `tree` (ship Step 4 leaves a merge
164
+ * of origin/dev in progress for a hand resolution). `git rev-parse --git-path X`
165
+ * always exits 0 (it only computes the path), so the path's existence is the test.
163
166
  */
164
167
  function abortRebase(tree, log) {
165
- const inProgress = ["rebase-merge", "rebase-apply"].some((name) => {
168
+ const present = (name) => {
166
169
  const p = git(tree, ["rev-parse", "--path-format=absolute", "--git-path", name]);
167
170
  return p !== null && fs.existsSync(p);
168
- });
169
- if (!inProgress)
171
+ };
172
+ const op = ["rebase-merge", "rebase-apply"].some(present)
173
+ ? "rebase"
174
+ : present("MERGE_HEAD")
175
+ ? "merge"
176
+ : null;
177
+ if (op === null)
170
178
  return false;
171
- const res = runGit(tree, ["rebase", "--abort"]);
179
+ const res = runGit(tree, [op, "--abort"]);
172
180
  if (!res.ok)
173
- log(`git rebase --abort failed in ${tree}: ${res.stderr}`);
181
+ log(`git ${op} --abort failed in ${tree}: ${res.stderr}`);
174
182
  return res.ok;
175
183
  }
176
184
  /** The workflow-failed state: row, rebase abort, lock release, sentinels. */
@@ -668,7 +676,9 @@ async function handoverVerb(ctx) {
668
676
  skipped = r.skipped;
669
677
  }
670
678
  else if (push) {
671
- addAllButCopied(tree);
679
+ const added = addAllButCopied(tree);
680
+ if (!added.ok)
681
+ ctx.log(`abort commit: git add failed: ${added.stderr}`);
672
682
  const made = runGit(tree, ["commit", "-m", `docs(${fid}): ${workflow} aborted bkit [skip ci]`]);
673
683
  if (!made.ok)
674
684
  ctx.log(`abort commit: ${made.stderr || made.stdout}`);
@@ -816,6 +826,83 @@ function appendStats(tree, rows, log) {
816
826
  return false;
817
827
  }
818
828
  }
829
+ /**
830
+ * The rows of `workflow`'s `nth` run in `file` (the last when omitted), in time order;
831
+ * unreadable lines skipped. Runs split as `fold` splits them: rows ordered by `at`, file
832
+ * order on a tie, each new `workflow-started` opening a run, so a previous run's rows in
833
+ * the same second as this run's start stay with the previous run.
834
+ */
835
+ function runRowsOf(file, workflow, nth = -1) {
836
+ const at = (r) => (typeof r["at"] === "string" ? r["at"] : "");
837
+ const ordered = parseRows(fs.readFileSync(file, "utf-8"))
838
+ .map((r, i) => ({ r, i }))
839
+ .filter(({ r }) => r.workflow === workflow)
840
+ .sort((a, b) => (at(a.r) < at(b.r) ? -1 : at(a.r) > at(b.r) ? 1 : a.i - b.i))
841
+ .map(({ r }) => r);
842
+ const runs = [];
843
+ const starts = new Set();
844
+ for (const r of ordered) {
845
+ if (r.type === "workflow-started" && !starts.has(at(r))) {
846
+ starts.add(at(r));
847
+ runs.push([]);
848
+ }
849
+ else if (runs.length === 0 && r.type === "step-done") {
850
+ runs.push([]);
851
+ }
852
+ runs.at(-1)?.push(r);
853
+ }
854
+ return runs.at(nth) ?? [];
855
+ }
856
+ /** The contract of `workflow`, derived from its shipped markdown rendered for the tracker `cwd` is configured with. */
857
+ const contractOf = (workflow, cwd) => deriveContract(fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"), workflow, readIssueTracker(cwd));
858
+ /**
859
+ * Appends the close's `completeness` row for `workflow`'s last run. Advisory:
860
+ * a failure of the check or of the write is logged in one line and never fails the close.
861
+ * `journalSuspect` is set here only: the closing engine journals itself.
862
+ */
863
+ function writeCompletenessRow(file, workflow, parentSha, log) {
864
+ try {
865
+ const verdict = checkCompleteness(runRowsOf(file, workflow), contractOf(workflow, path.dirname(file)), {
866
+ journalSuspect: true,
867
+ });
868
+ const row = { type: "completeness", ...verdict, at: statusTimestamp(), parentSha };
869
+ fs.appendFileSync(file, appendLine(row));
870
+ if (verdict.journalSuspect) {
871
+ log("[bkit-telemetry] journal looks dead at close: no engine-call rows for this run; the completeness verdict cannot be trusted");
872
+ }
873
+ }
874
+ catch (err) {
875
+ // The check is advisory: report the failure and close without the row.
876
+ log(`[bkit-telemetry] completeness row not written: ${err.message}`);
877
+ }
878
+ }
879
+ /**
880
+ * The warning line for the run before the one being started (or resumed) when that run
881
+ * was holey; `null` when it is clean, absent or unreadable. Never throws.
882
+ */
883
+ function previousRunWarning(file, resumed) {
884
+ try {
885
+ const events = readStatusEvents(file);
886
+ const runs = fold(events);
887
+ const at = runs.length - (resumed ? 2 : 1);
888
+ const prev = runs[at];
889
+ if (prev === undefined)
890
+ return null;
891
+ const number = runs.slice(0, at + 1).filter((r) => r.workflow === prev.workflow).length;
892
+ const own = runRowsOf(file, prev.workflow, number - 1);
893
+ const { verdict } = readCompleteness(own, contractOf(prev.workflow, path.dirname(file)));
894
+ if (!verdict.holey)
895
+ return null;
896
+ const closed = own.filter((e) => e.type === "workflow-done").at(-1)?.["at"] ?? "never";
897
+ return (`[bkit-workflows] previous run (${prev.workflow} run ${number}, closed ${closed}) was incomplete: ` +
898
+ `${verdict.evidenceHoles.length} evidence hole(s), ${verdict.stepHoles.length} step hole(s); ` +
899
+ `see: bkit completeness check --workflow=${prev.workflow} --file=${path.relative(process.cwd(), file) || file}`);
900
+ }
901
+ catch {
902
+ // Advisory: an unreadable run or checker failure degrades to no warning.
903
+ return null;
904
+ }
905
+ }
819
906
  /** Markdown link per feature doc and per log of this workflow, as on `ref`. */
820
907
  export function artifactLinks(root, ref, month, fid, workflow, ownerRepo) {
821
908
  const list = (dir) => (git(root, ["ls-tree", "-r", "--name-only", ref, "--", dir]) ?? "").split("\n").filter(Boolean);
@@ -846,6 +933,19 @@ function closeComment(cwd, outbox, o) {
846
933
  sections,
847
934
  });
848
935
  }
936
+ /** `--ending` / `--publish` of the close verb, validated. */
937
+ function closeEnding(f) {
938
+ const ending = str(f.ending);
939
+ if (ending !== undefined && ending !== "done" && ending !== "held")
940
+ throw new CommandError(EXIT.USAGE, `--ending must be done or held, got ${ending}`);
941
+ const publish = str(f.publish);
942
+ if (publish !== undefined && publish !== "true" && publish !== "false")
943
+ throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publish}`);
944
+ return {
945
+ ...(ending === undefined ? {} : { ending }),
946
+ ...(publish === undefined ? {} : { publish: publish === "true" }),
947
+ };
948
+ }
849
949
  /**
850
950
  * Grade compliance, append the workflow-done row (and, with `recordStep`, the
851
951
  * close step's row first), the counter and outcome telemetry rows, and build the
@@ -871,11 +971,22 @@ export function closeWorkflow(cwd, o, log) {
871
971
  const parentSha = headSha(where.tree);
872
972
  // Graded first, so the report below carries this run's grade.
873
973
  const violations = gradeCompliance(where.tree, workflow, log, o.squashSha, { parentSha, step });
974
+ let progressLine;
874
975
  if (o.recordStep === true) {
875
- writeStepRow(where.tree, { file: where.status, workflow, step, artifacts: [], commit: "none" }, log);
976
+ const written = writeStepRow(where.tree, { file: where.status, workflow, step, artifacts: [], commit: "none" }, log);
977
+ progressLine = written.progressLine;
876
978
  }
979
+ writeCompletenessRow(where.status, workflow, parentSha, log);
877
980
  const endAt = statusTimestamp();
878
- const row = { type: "workflow-done", workflow, at: endAt, parentSha };
981
+ const ending = o.ending ?? "done";
982
+ const row = {
983
+ type: "workflow-done",
984
+ workflow,
985
+ at: endAt,
986
+ parentSha,
987
+ ending,
988
+ ...(o.publish === undefined ? {} : { publish: o.publish }),
989
+ };
879
990
  fs.appendFileSync(where.status, appendLine(row));
880
991
  const repo = resolveRepoSlug(where.root) || "unknown/repo";
881
992
  const started = lastOfType(events, "workflow-started", workflow);
@@ -888,7 +999,6 @@ export function closeWorkflow(cwd, o, log) {
888
999
  ? runLines(where.tree, `${o.squashSha}^`, o.squashSha)
889
1000
  : runLines(where.tree, base, parentSha);
890
1001
  const startedRows = new Set(events.filter((e) => e.type === "workflow-started" && e.workflow === workflow).map((e) => e.at)).size;
891
- const logDir = path.join(where.tree, logDirRel(where.month, o.fid));
892
1002
  const by = { workflow, step };
893
1003
  const counterRow = {
894
1004
  kind: "counter",
@@ -920,7 +1030,8 @@ export function closeWorkflow(cwd, o, log) {
920
1030
  by,
921
1031
  run: { parentSha, ...(o.prNumber === undefined ? {} : { pr: o.prNumber }) },
922
1032
  time: startKnown === undefined ? null : timeBlock(startKnown, Math.max(startKnown, endMs)),
923
- ending: "done",
1033
+ ending,
1034
+ ...(o.publish === undefined ? {} : { publish: o.publish }),
924
1035
  lines,
925
1036
  ...(runRowsOf.length > 0 ? { steps: stepsBlock(runRowsOf) } : {}),
926
1037
  ...(ci.length > 0 ? { ci } : {}),
@@ -928,7 +1039,7 @@ export function closeWorkflow(cwd, o, log) {
928
1039
  ...(plan === undefined ? {} : { plan }),
929
1040
  ...(workflow === "build"
930
1041
  ? {
931
- build: buildBlock(runRowsOf, logDir, planFiles(where.tree, where.month, o.fid), runDeferrals()),
1042
+ build: buildBlock(runRowsOf, planFiles(where.tree, where.month, o.fid), runDeferrals()),
932
1043
  }
933
1044
  : {}),
934
1045
  ...(context === undefined ? {} : { context }),
@@ -1000,6 +1111,7 @@ export function closeWorkflow(cwd, o, log) {
1000
1111
  comment,
1001
1112
  roadmapFoldNeeded: true,
1002
1113
  featureStatus: FEATURE_STATUS[workflow],
1114
+ ...(progressLine === undefined ? {} : { progressLine }),
1003
1115
  };
1004
1116
  }
1005
1117
  /**
@@ -1039,8 +1151,8 @@ function closePr(ctx, dir, fid, subject) {
1039
1151
  * checkout): the close rows there, then ONE `docs({fid}): ship DONE bkit [skip ci]`
1040
1152
  * commit built in a throwaway origin/dev checkout carrying the run's book and
1041
1153
  * landed on dev — a refused push publishes it through a `ship-close/{fid}` PR.
1042
- * Only a close that landed (or opened its PR) releases the workflow lock; once
1043
- * the close is on dev, the feature worktree and `branch` are removed. A close
1154
+ * Once the close is on dev, the feature worktree and `branch` are removed; then
1155
+ * a close that landed (or opened its PR) releases the workflow lock. A close
1044
1156
  * that did not land keeps the lock for the Failure Path.
1045
1157
  */
1046
1158
  async function shipClose(ctx, o, token) {
@@ -1108,22 +1220,14 @@ async function shipClose(ctx, o, token) {
1108
1220
  ctx.log(`throwaway checkout failed: ${res.stderr} — ${kept}`);
1109
1221
  return { code: EXIT_FLUSH_FAILED, out: null };
1110
1222
  }
1111
- const released = releaseLock(workflowLockPath(root, month, o.fid), {
1112
- workflow: "ship",
1113
- fid: o.fid,
1114
- token,
1115
- });
1116
- if (released.removeFailed) {
1117
- ctx.log("Lock removal failed");
1118
- return { code: EXIT_FLUSH_FAILED, out: null };
1119
- }
1120
- // The book is on dev only once the close landed or its PR merged.
1223
+ // The book is on dev only once the close landed or its PR merged. The worktree
1224
+ // goes while the lock is still held, so no run of this FID resumes into it.
1121
1225
  let worktree = null;
1122
1226
  if (landed.via === "close-pr-open") {
1123
1227
  ctx.log(`close PR not merged — ${kept} until it is`);
1124
1228
  }
1125
1229
  else {
1126
- if (landed.via === "close-pr" && !runGit(root, ["fetch", "origin", DEV]).ok)
1230
+ if (landed.via === "close-pr" && !fetchDev(root).ok)
1127
1231
  ctx.log(`fetch of dev after the close PR failed — origin/${DEV} is stale until the next fetch`);
1128
1232
  try {
1129
1233
  worktree = removeWorktree(root, o.fid, o.branch, ctx.log);
@@ -1132,6 +1236,15 @@ async function shipClose(ctx, o, token) {
1132
1236
  ctx.log(`${err.message} — remove ${book} by hand`);
1133
1237
  }
1134
1238
  }
1239
+ const released = releaseLock(workflowLockPath(root, month, o.fid), {
1240
+ workflow: "ship",
1241
+ fid: o.fid,
1242
+ token,
1243
+ });
1244
+ if (released.removeFailed) {
1245
+ ctx.log("Lock removal failed");
1246
+ return { code: EXIT_FLUSH_FAILED, out: null };
1247
+ }
1135
1248
  return { code: EXIT.OK, out: { ...out, landed, worktree } };
1136
1249
  }
1137
1250
  // ---------------------------------------------------------------------------
@@ -1252,22 +1365,30 @@ function summaryVerb(ctx) {
1252
1365
  const abs = path.resolve(tree, r);
1253
1366
  return fs.existsSync(abs) && fs.statSync(abs).isFile() ? fs.readFileSync(abs, "utf-8") : null;
1254
1367
  };
1255
- const deferrals = ledgerRows(path.join(tree, "docs", "deferrals.jsonl"))
1256
- .map((r) => normalize(r))
1257
- .filter((r) => byWorkflow(r) === workflow && Number(r.ts) >= startMs);
1368
+ const deferralHistory = ledgerRows(path.join(tree, "docs", "deferrals.jsonl")).map((r) => normalize(r));
1369
+ const runDeferralKeys = new Set(deferralHistory
1370
+ .filter((r) => isRunsOwnRow(r, { fid, workflow, startMs }, new Set()))
1371
+ .map((r) => r.key));
1372
+ const currentDeferrals = new Map(deferralHistory.sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts })).map((r) => [r.key, r]));
1373
+ const deferrals = [...currentDeferrals.values()].filter((r) => runDeferralKeys.has(r.key));
1258
1374
  const organisedPath = path.join(logDir, "design-v3-organised.md");
1259
1375
  const organised = workflow === "design" && fs.existsSync(organisedPath)
1260
1376
  ? fs.readFileSync(organisedPath, "utf-8")
1261
1377
  : undefined;
1262
1378
  const prNumber = positiveInt(ctx.flags.pr, "pr");
1379
+ const publishFlag = str(ctx.flags.publish);
1380
+ if (publishFlag !== undefined && publishFlag !== "true" && publishFlag !== "false")
1381
+ throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publishFlag}`);
1263
1382
  const summary = buildSummary({
1383
+ root: tree,
1384
+ publish: publishFlag === undefined ? undefined : publishFlag === "true",
1264
1385
  workflow: workflow,
1265
1386
  fid,
1266
1387
  ref: refOf(fid, readIssueTracker(tree)),
1267
1388
  rows,
1268
1389
  plans: plans.map((p) => ({ path: rel(p), text: fs.readFileSync(p, "utf-8") })),
1269
1390
  deferrals,
1270
- deferralsAdded: ledgerCounts(tree, workflow, startMs).deferrals.added ?? 0,
1391
+ deferralsAdded: deferrals.filter((r) => r.status !== "CLOSED").length,
1271
1392
  decisionFiles: (workflow === "build" || workflow === "ship") && fs.existsSync(logDir)
1272
1393
  ? fs
1273
1394
  .readdirSync(logDir)
@@ -1277,6 +1398,7 @@ function summaryVerb(ctx) {
1277
1398
  : [],
1278
1399
  read,
1279
1400
  workstreams: organised === undefined ? undefined : parseWorkstreams(organised),
1401
+ suggestedPlans: organised === undefined ? undefined : parsePlans(organised),
1280
1402
  organised,
1281
1403
  pr: workflow === "ship" && prNumber !== undefined
1282
1404
  ? prSize(ctx.cwd, prNumber, ctx.log)
@@ -1541,6 +1663,7 @@ export const workflowsCommand = {
1541
1663
  verbs: {
1542
1664
  start: {
1543
1665
  summary: "Take the feature lock and open a run (workflow-started unless resuming).",
1666
+ use: "workflow",
1544
1667
  flags: [
1545
1668
  WORKFLOW_FLAG,
1546
1669
  FID_FLAG,
@@ -1562,7 +1685,7 @@ export const workflowsCommand = {
1562
1685
  lock: "{path, month, token, reclaimed} of the lock taken, or {path} with --lock-held",
1563
1686
  file: "absolute path to status.jsonl",
1564
1687
  resumed: "the latest run was this workflow, IN_PROGRESS: no new row",
1565
- row: "the appended workflow-started row, or null when resuming",
1688
+ row: "the appended workflow-started row, with `limits` (the workflow's ask points from bkit.workflows, frozen for the run), or null when resuming",
1566
1689
  run: "which run of the workflow this is (1-based)",
1567
1690
  lastDoneStep: "the current run's last DONE step: resume after it (null on a new run)",
1568
1691
  openDecision: "{file, decision, question, from, pauseStep, group, verifyAttempt, testAttempt, plan} of the current run's highest {workflow}-decision-{run}-{N}.md holding Status: OPEN, else null",
@@ -1625,15 +1748,21 @@ export const workflowsCommand = {
1625
1748
  ctx.log(`cleared stale ${name}`);
1626
1749
  }
1627
1750
  }
1628
- const latest = fold(readStatusEvents(file)).at(-1);
1629
- const resumed = latest?.workflow === workflow && latest.status === "IN_PROGRESS";
1751
+ const resumed = lastRun(fold(readStatusEvents(file)), workflow)?.status === "IN_PROGRESS";
1752
+ const holeyWarning = previousRunWarning(file, resumed);
1753
+ if (holeyWarning !== null)
1754
+ ctx.log(holeyWarning);
1630
1755
  let row = null;
1631
1756
  if (!resumed) {
1757
+ // The run's limits, frozen here: `counters route` reads them for the whole run.
1758
+ const asks = readBkitConfig(where.tree).asks;
1759
+ const limits = Object.fromEntries(ASK_POINTS.filter((p) => p.startsWith(`${workflow}.`)).map((p) => [p, asks[p]]));
1632
1760
  row = {
1633
1761
  type: "workflow-started",
1634
1762
  workflow,
1635
1763
  at: statusTimestamp(),
1636
1764
  parentSha: headSha(path.dirname(file)),
1765
+ ...(Object.keys(limits).length === 0 ? {} : { limits }),
1637
1766
  };
1638
1767
  fs.appendFileSync(file, appendLine(row));
1639
1768
  }
@@ -1657,6 +1786,7 @@ export const workflowsCommand = {
1657
1786
  },
1658
1787
  fail: {
1659
1788
  summary: "Failure Path: workflow-failed row, abort rebase, release lock, clear sentinels (with --token); the bkit:failed labels and the failure comment.",
1789
+ use: "workflow",
1660
1790
  flags: [
1661
1791
  WORKFLOW_FLAG,
1662
1792
  { ...FID_FLAG, required: false, help: "feature id (needed with --token)" },
@@ -1713,7 +1843,7 @@ export const workflowsCommand = {
1713
1843
  ],
1714
1844
  output: {
1715
1845
  row: "the appended workflow-failed row, or null (no --token, or no status.jsonl)",
1716
- rebaseAborted: "an in-progress rebase was found and aborted",
1846
+ rebaseAborted: "an in-progress rebase or merge was found and aborted",
1717
1847
  lock: "{path, existed, released, heldBy}: heldBy is another owner's lock line, left in place; null without --token",
1718
1848
  sentinels: "[{name, path}] sentinels that existed before this call removed them",
1719
1849
  handoverNeeded: "--max-exceeded, a sentinel existed, or a debug run in SOAK mode: write the abort handover",
@@ -1736,6 +1866,7 @@ export const workflowsCommand = {
1736
1866
  },
1737
1867
  handover: {
1738
1868
  summary: "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.",
1869
+ use: "workflow",
1739
1870
  flags: [
1740
1871
  WORKFLOW_FLAG,
1741
1872
  FID_FLAG,
@@ -1791,6 +1922,7 @@ export const workflowsCommand = {
1791
1922
  },
1792
1923
  close: {
1793
1924
  summary: "Grade compliance, workflow-done row, counter + outcome telemetry, report, artifact links; --flush lands ship's close on dev.",
1925
+ use: "workflow",
1794
1926
  flags: [
1795
1927
  WORKFLOW_FLAG,
1796
1928
  FID_FLAG,
@@ -1840,6 +1972,16 @@ export const workflowsCommand = {
1840
1972
  },
1841
1973
  ...COMMENT_FLAGS,
1842
1974
  { name: "tree", type: "string", help: "the close comment links the tree of this ref" },
1975
+ {
1976
+ name: "ending",
1977
+ type: "string",
1978
+ help: "done|held (default done); held = a local build that published nothing",
1979
+ },
1980
+ {
1981
+ name: "publish",
1982
+ type: "string",
1983
+ help: "build: true|false, the resolved publish value; recorded on the workflow-done and outcome rows",
1984
+ },
1843
1985
  {
1844
1986
  name: "flush",
1845
1987
  type: "boolean",
@@ -1902,6 +2044,7 @@ export const workflowsCommand = {
1902
2044
  tracker: TRACKER_OUTPUT,
1903
2045
  roadmapFoldNeeded: "always true: append the feature row and re-render the board (not run here)",
1904
2046
  featureStatus: "roadmap status this close moves the feature to",
2047
+ progressLine: "--record-step: the exact chat progress line after a numbered completion is recorded",
1905
2048
  landed: "--flush: {ref, via: head-push | close-pr | close-pr-open}",
1906
2049
  worktree: "--flush: the `bkit worktrees remove` result once the close is on dev; null while the close PR is unmerged or the removal failed",
1907
2050
  sessionRemoved: SESSION_REMOVED_OUTPUT,
@@ -1935,6 +2078,7 @@ export const workflowsCommand = {
1935
2078
  number: str(f.number),
1936
2079
  title: str(f.title),
1937
2080
  tree: str(f.tree),
2081
+ ...closeEnding(f),
1938
2082
  };
1939
2083
  const finalParts = finalReturnParts(ctx, input.fid);
1940
2084
  if (f.flush === true) {
@@ -1959,6 +2103,7 @@ export const workflowsCommand = {
1959
2103
  },
1960
2104
  input: {
1961
2105
  summary: "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.",
2106
+ use: "workflow",
1962
2107
  flags: [
1963
2108
  WORKFLOW_FLAG,
1964
2109
  FID_FLAG,
@@ -2006,6 +2151,7 @@ export const workflowsCommand = {
2006
2151
  },
2007
2152
  promote: {
2008
2153
  summary: "Design / plan close: the highest versioned draft becomes the canonical doc (anchor stamped, a changed canonical archived).",
2154
+ use: "workflow",
2009
2155
  flags: [
2010
2156
  { ...WORKFLOW_FLAG, help: "design | plan" },
2011
2157
  FID_FLAG,
@@ -2035,6 +2181,7 @@ export const workflowsCommand = {
2035
2181
  },
2036
2182
  links: {
2037
2183
  summary: "The feature's docs and this workflow's logs on a ref as markdown links; optionally the close comment.",
2184
+ use: "workflow",
2038
2185
  flags: [
2039
2186
  WORKFLOW_FLAG,
2040
2187
  FID_FLAG,
@@ -2091,6 +2238,7 @@ export const workflowsCommand = {
2091
2238
  },
2092
2239
  summary: {
2093
2240
  summary: "The Summary step: write {workflow}-summary.md next to --file with the run's verdict, reasons and next command.",
2241
+ use: "workflow",
2094
2242
  flags: [
2095
2243
  { ...WORKFLOW_FLAG, help: "plan | design | build | debug | ship" },
2096
2244
  {
@@ -2110,6 +2258,11 @@ export const workflowsCommand = {
2110
2258
  type: "string",
2111
2259
  help: "ship: the PR number; its size comes from gh pr view (left out when gh cannot answer)",
2112
2260
  },
2261
+ {
2262
+ name: "publish",
2263
+ type: "string",
2264
+ help: "build: true|false, the resolved ending; false writes `Publish: held` and `Docs: not synced` (default true)",
2265
+ },
2113
2266
  ],
2114
2267
  output: {
2115
2268
  verdict: "PASS | CONCERNS | FAIL",