@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -13,6 +13,7 @@ import * as fs from "node:fs";
13
13
  import * as path from "node:path";
14
14
  import { fold, lastRun, statusTimestamp, } from "../../ledgers/status.js";
15
15
  import { CommandError, EXIT, parseJson, repoRoot, statusRelPath, utcMonth, } from "../lib.js";
16
+ import { removeRecord } from "./ledgers.js";
16
17
  import { str } from "./status.js";
17
18
  /** A workflow lock whose holder shows no sign of life for this long is stale. */
18
19
  export const WORKFLOW_LOCK_IDLE_S = 1800;
@@ -112,7 +113,7 @@ function liveReason(root, month, fid, holder, now) {
112
113
  * Fold a status log for the lock cross-check. A missing or malformed log shows no
113
114
  * run: there is no evidence the holder is alive, so the lock is reclaimed.
114
115
  */
115
- function readRunsLenient(file) {
116
+ export function readRunsLenient(file) {
116
117
  if (!fs.existsSync(file))
117
118
  return [];
118
119
  const raw = fs.readFileSync(file, "utf-8").trim();
@@ -127,6 +128,24 @@ function readRunsLenient(file) {
127
128
  }
128
129
  return fold(events);
129
130
  }
131
+ /** Whether `fid` holds a workflow lock whose holder is still stepping (not reclaimable). */
132
+ export function workflowLockLive(root, fid) {
133
+ return monthBuckets(root, fid).some((month) => {
134
+ const holder = readHolder(workflowLockPath(root, month, fid));
135
+ return holder !== undefined && "live" in liveReason(root, month, fid, holder, Date.now());
136
+ });
137
+ }
138
+ /**
139
+ * Whether `fid` has a workflow lock file younger than the idle limit, whatever
140
+ * its run's state: a run that has closed but not yet released its lock (it still
141
+ * pushes and waits for CI) still owns its checkout.
142
+ */
143
+ export function workflowLockFresh(root, fid) {
144
+ return monthBuckets(root, fid).some((month) => {
145
+ const stat = fs.statSync(workflowLockPath(root, month, fid), { throwIfNoEntry: false });
146
+ return stat !== undefined && (Date.now() - stat.mtimeMs) / 1000 < WORKFLOW_LOCK_IDLE_S;
147
+ });
148
+ }
130
149
  export function acquireWorkflowLock(opts) {
131
150
  const root = repoRoot(opts.cwd);
132
151
  const month = resolveMonth(root, opts.fid, opts.month);
@@ -194,6 +213,7 @@ export const locksCommand = {
194
213
  verbs: {
195
214
  acquire: {
196
215
  summary: "Take the workflow lock, reclaiming a dead holder's.",
216
+ use: "workflow",
197
217
  flags: [KIND_FLAG, LOCK_WORKFLOW_FLAG, FID_FLAG, MONTH_FLAG],
198
218
  output: {
199
219
  kind: "workflow",
@@ -219,7 +239,8 @@ export const locksCommand = {
219
239
  },
220
240
  },
221
241
  release: {
222
- summary: "Remove a lock this caller owns; another owner's lock is left in place.",
242
+ summary: "Remove a lock this caller owns (and the feature's shared-checkout record); another owner's lock is left in place.",
243
+ use: "workflow",
223
244
  flags: [
224
245
  KIND_FLAG,
225
246
  LOCK_WORKFLOW_FLAG,
@@ -253,6 +274,9 @@ export const locksCommand = {
253
274
  const root = repoRoot(ctx.cwd);
254
275
  const file = workflowLockPath(root, resolveMonth(root, who.fid, str(ctx.flags.month)), who.fid);
255
276
  const { removeFailed, ...result } = releaseLock(file, who);
277
+ // The run is over once its lock is released: so is its shared-checkout record.
278
+ if (!removeFailed && result.heldBy === null)
279
+ removeRecord(root, who.fid);
256
280
  ctx.emit({ kind, ...result });
257
281
  if (removeFailed) {
258
282
  ctx.log(`lock removal failed: ${file}`);
@@ -0,0 +1,501 @@
1
+ // The one reader of a plan's (or a change-shape issue's) task section: groups and
2
+ // task blocks between lowercase HTML-comment markers, each task's uppercase fields.
3
+ //
4
+ // <!-- bkit:group N start -->
5
+ // ### TASK GROUP N: {title} (`### GROUP N: {title}` is read too)
6
+ // <!-- bkit:task M start -->
7
+ // - [ ] **TASK M:** {title}
8
+ // - **UPDATE:** `symbol` in `file`: what changes
9
+ // - **DONE WHEN:** ...
10
+ // - **TEST FIRST:**
11
+ // - `test file` `test name` fails on ...
12
+ // <!-- bkit:task M end -->
13
+ // <!-- bkit:group N end -->
14
+ //
15
+ // Pure text in, groups / tasks / line-numbered errors out; no file-system access, so
16
+ // `tests`, `challenge` and the run facts share it. Fenced code is skipped. Task-like
17
+ // text outside every task block is an error of kind `stray`, never silently unread.
18
+ import * as path from "node:path";
19
+ /** The task fields, written in uppercase as `**LABEL:**`. */
20
+ export const PLAN_FIELDS = [
21
+ "CREATE",
22
+ "READ",
23
+ "UPDATE",
24
+ "DELETE",
25
+ "DEPENDS ON",
26
+ "DONE WHEN",
27
+ "TEST FIRST",
28
+ "TEST EXCEPTION",
29
+ ];
30
+ /** Why every plan reader (`tests`, `tasks`, `ledgers triage`) refuses a plan with no task blocks. */
31
+ export const NO_MARKERS_REASON = "this plan has no task markers; run /bkit-build again to convert it";
32
+ const tableCells = (row) => row
33
+ .split("|")
34
+ .slice(1, -1)
35
+ .map((c) => c.trim());
36
+ /**
37
+ * The first table under the first heading matching `heading`, before the next heading of
38
+ * the same or a higher level: the header line's index and its cells. No heading or table → null.
39
+ */
40
+ function firstTable(lines, heading) {
41
+ const start = lines.findIndex((l) => heading.test(l));
42
+ if (start < 0)
43
+ return null;
44
+ const level = /^#+/.exec(lines[start])[0].length;
45
+ const ends = (l) => new RegExp(`^#{1,${level}} `).test(l);
46
+ let head = -1;
47
+ for (let i = start + 1; i < lines.length && !ends(lines[i]); i++)
48
+ if (/^\s*\|/.test(lines[i])) {
49
+ head = i;
50
+ break;
51
+ }
52
+ if (head < 0)
53
+ return null;
54
+ return { head, cols: tableCells(lines[head]) };
55
+ }
56
+ /**
57
+ * The plan's Reuse Inventory: the first table under the first heading naming Reuse
58
+ * Inventory, before the next heading of the same or a higher level. Each row's `File`
59
+ * cell gives its backticked paths, normalised. No heading, table or `File` column → null.
60
+ */
61
+ export function reuseInventory(text) {
62
+ const lines = text.split(/\r?\n/);
63
+ const table = firstTable(lines, /^#{2,4} .*Reuse Inventory/i);
64
+ if (table === null)
65
+ return null;
66
+ const file = table.cols.findIndex((c) => /^file\b/i.test(c));
67
+ const decision = table.cols.findIndex((c) => /^decision\b/i.test(c));
68
+ if (file < 0)
69
+ return null;
70
+ const rows = [];
71
+ for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
72
+ const cells = tableCells(lines[i]);
73
+ rows.push({
74
+ line: lines[i],
75
+ files: [...(cells[file] ?? "").matchAll(/`([^`]+)`/g)].map((m) => path.posix.normalize(m[1])),
76
+ decision: decision < 0 ? "" : (cells[decision] ?? ""),
77
+ });
78
+ }
79
+ return { head: lines.slice(table.head, table.head + 2), rows };
80
+ }
81
+ /** The plan's `Derived Test Matrix` over `tableCells`; null when the plan has no such table. */
82
+ export function derivedTestMatrix(text) {
83
+ const lines = text.split(/\r?\n/);
84
+ const table = firstTable(lines, /^#{2,4} .*Derived Test Matrix/i);
85
+ if (table === null)
86
+ return null;
87
+ const column = table.cols.findIndex((c) => /^task\b/i.test(c));
88
+ const rows = [];
89
+ for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
90
+ const cells = tableCells(lines[i]);
91
+ rows.push({
92
+ line: lines[i],
93
+ number: i + 1,
94
+ cells,
95
+ tasks: column < 0 ? [] : [...(cells[column] ?? "").matchAll(/\d+/g)].map((m) => Number(m[0])),
96
+ });
97
+ }
98
+ return {
99
+ head: lines.slice(table.head, table.head + 2),
100
+ line: table.head + 1,
101
+ taskColumn: column < 0 ? null : column,
102
+ rows,
103
+ };
104
+ }
105
+ /** The plan's `Supersession Inventory` rows over `tableCells`; null when the plan has no such table. */
106
+ export function supersessionInventory(text) {
107
+ const lines = text.split(/\r?\n/);
108
+ const table = firstTable(lines, /^#{2,4} .*Supersession Inventory/i);
109
+ if (table === null)
110
+ return null;
111
+ const column = table.cols.findIndex((c) => /^existing\b/i.test(c));
112
+ const rows = [];
113
+ for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
114
+ const cells = tableCells(lines[i]);
115
+ rows.push({
116
+ line: lines[i],
117
+ number: i + 1,
118
+ files: spansOf(cells[column < 0 ? 0 : column] ?? "").map((f) => path.posix.normalize(f)),
119
+ });
120
+ }
121
+ return rows;
122
+ }
123
+ /** The plan's `Out of Scope` rows over `tableCells`; null when the plan has no such table. */
124
+ export function outOfScope(text) {
125
+ const lines = text.split(/\r?\n/);
126
+ const table = firstTable(lines, /^#{2,4} .*Out of Scope/i);
127
+ if (table === null)
128
+ return null;
129
+ const rows = [];
130
+ for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++)
131
+ rows.push({ line: lines[i], number: i + 1, cells: tableCells(lines[i]) });
132
+ return rows;
133
+ }
134
+ /** The error for a code fence opened at `line` and never closed. */
135
+ export const fenceNeverClosed = (line) => `the code fence at line ${line} is never closed; nothing after it is read`;
136
+ /** The fields a task writes at most once; CREATE / READ / UPDATE / DELETE repeat, one line per ref. */
137
+ const SINGLE_FIELDS = new Set([
138
+ "DEPENDS ON",
139
+ "DONE WHEN",
140
+ "TEST FIRST",
141
+ "TEST EXCEPTION",
142
+ ]);
143
+ const MARKER = /^\s*<!--\s*bkit:(group|task)\s+(\d+)\s+(start|end)\s*-->\s*$/;
144
+ const GROUP_HEAD = /^###\s+(?:TASK\s+)?GROUP\s+(\d+):\s*(.*)$/;
145
+ const TASK_HEAD = /^\s*- \[([ xX])\] \*\*TASK (\d+):\*\*\s*(.*)$/;
146
+ const LABEL_LINE = /^(\s*)(?:- )?\*\*([A-Za-z][A-Za-z -]*?):\*\*\s*(.*)$/;
147
+ const SUB_BULLET = /^(\s*)- (.*)$/;
148
+ const FENCE = /^\s*(`{3,}|~{3,})/;
149
+ const FENCE_CLOSE = /^\s*(`{3,}|~{3,})\s*$/;
150
+ const STRAY_TASK = /\*\*\s*task\s+\d+/i;
151
+ /** A bold `**TASK N:**` inside a task block other than its own task line. */
152
+ const INNER_TASK = /(?<!\S)\*\*task\s+\d+\s*:?\s*\*\*/i;
153
+ const STRAY_FIELD = new RegExp(String.raw `\*\*\s*(${[...PLAN_FIELDS, "TEST-ORDER EXCEPTION"].join("|")})\s*(?::\*\*|\*\*\s*:)`, "i");
154
+ /** `text` with inline code spans removed: prose naming a label is not the label. */
155
+ const withoutCode = (text) => text.replace(/(`+)[\s\S]*?\1/g, "");
156
+ const spansOf = (text) => [...text.matchAll(/`([^`]+)`/g)].map((m) => m[1].trim());
157
+ /** A CREATE / READ / UPDATE / DELETE value, or null when it is none of the forms. */
158
+ export function parseRef(value, line) {
159
+ const v = value.trim();
160
+ const sym = /^`([^`]+)`\s+in\s+`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
161
+ if (sym)
162
+ return { symbol: sym[1].trim(), file: sym[2].trim(), what: (sym[3] ?? "").trim(), line };
163
+ const section = /^(§[^`]*?)\s+in\s+`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
164
+ if (section)
165
+ return {
166
+ symbol: section[1].trim(),
167
+ file: section[2].trim(),
168
+ what: (section[3] ?? "").trim(),
169
+ line,
170
+ };
171
+ const file = /^`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
172
+ if (file)
173
+ return { file: file[1].trim(), what: (file[2] ?? "").trim(), line };
174
+ return null;
175
+ }
176
+ const testOf = (text, line) => {
177
+ const spans = spansOf(text);
178
+ return spans.length >= 2
179
+ ? { test: path.posix.normalize(spans[0]), name: spans[1], line }
180
+ : null;
181
+ };
182
+ /** One task's fields from its entries; format errors are pushed to `errors`. */
183
+ function taskFromFields(head, fields, text, errors) {
184
+ const t = {
185
+ ...head,
186
+ create: [],
187
+ read: [],
188
+ update: [],
189
+ delete: [],
190
+ dependsOn: [],
191
+ text,
192
+ };
193
+ const refs = {
194
+ CREATE: t.create,
195
+ READ: t.read,
196
+ UPDATE: t.update,
197
+ DELETE: t.delete,
198
+ };
199
+ for (const f of fields) {
200
+ const entries = [
201
+ ...(f.value.trim() === "" ? [] : [{ line: f.line, text: f.value }]),
202
+ ...f.items,
203
+ ];
204
+ if (f.label in refs) {
205
+ if (entries.length === 0)
206
+ errors.push({
207
+ line: f.line,
208
+ kind: "format",
209
+ message: `TASK ${t.task}: ${f.label} is empty`,
210
+ });
211
+ for (const e of entries) {
212
+ const ref = parseRef(e.text, e.line);
213
+ if (ref === null)
214
+ errors.push({
215
+ line: e.line,
216
+ kind: "format",
217
+ message: `TASK ${t.task}: ${f.label} is neither \`symbol\` in \`file\`: what nor \`file\`: what`,
218
+ });
219
+ else
220
+ refs[f.label].push(ref);
221
+ }
222
+ }
223
+ else if (f.label === "DEPENDS ON") {
224
+ // `TASK N` names when the entry has them, else bare numbers as the template writes them;
225
+ // an entry starting `none` names no task, whatever follows it. `GROUP N` numbers name
226
+ // groups, never tasks.
227
+ for (const e of entries) {
228
+ if (/^none\b/i.test(e.text.trim()))
229
+ continue;
230
+ const text = e.text.replace(/\bGROUPS?\s+\d+(?:\s*(?:,|&|-|–|and)\s*\d+)*/gi, "");
231
+ const named = [...text.matchAll(/TASK\s+(\d+)/gi)];
232
+ const nums = named.length > 0 ? named : [...text.matchAll(/\b(\d+)\b/g)];
233
+ for (const m of nums)
234
+ t.dependsOn.push(Number(m[1]));
235
+ }
236
+ }
237
+ else if (f.label === "DONE WHEN") {
238
+ t.doneWhen = entries.map((e) => e.text.trim()).join(" ");
239
+ }
240
+ else if (f.label === "TEST FIRST") {
241
+ const tf = { line: f.line, tests: [], malformed: [] };
242
+ for (const e of entries) {
243
+ if (/^n\/a\b/i.test(e.text.trim())) {
244
+ tf.na = e.text.trim().replace(/^n\/a\s*[—–-]?\s*/i, "");
245
+ continue;
246
+ }
247
+ const test = testOf(e.text, e.line);
248
+ if (test === null)
249
+ tf.malformed.push(e.line);
250
+ else
251
+ tf.tests.push(test);
252
+ }
253
+ t.testFirst = tf;
254
+ }
255
+ else {
256
+ const tests = entries.map((e) => testOf(e.text, e.line)).filter((x) => x !== null);
257
+ const lines = Array.from({ length: f.last - f.line + 1 }, (_, k) => f.line + k);
258
+ t.testException = { tests, lines, text: entries.map((e) => e.text.trim()).join(" ") };
259
+ }
260
+ }
261
+ return t;
262
+ }
263
+ /** Groups, tasks and errors of a plan's (or issue's) task section. */
264
+ export function parsePlanBlocks(text) {
265
+ const lines = text.split(/\r?\n/);
266
+ const errors = [];
267
+ const groups = [];
268
+ const tasks = [];
269
+ const groupSeen = new Map();
270
+ const taskSeen = new Map();
271
+ const err = (line, message) => errors.push({ line, kind: "format", message });
272
+ /**
273
+ * Group numbers ascend through the file: the build runs groups in file order. Task numbers
274
+ * ascend within a group, so a Decision Pause task numbered above the plan's highest can join
275
+ * the paused group.
276
+ */
277
+ let lastGroup = 0;
278
+ let lastTask = 0;
279
+ const numbered = (kind, no, last, n) => {
280
+ if (no === 0)
281
+ err(n, `${kind} 0: ${kind.toLowerCase()} numbers start at 1`);
282
+ else if (no <= last)
283
+ err(n, `${kind} ${no} comes after ${kind} ${last}; number ${kind.toLowerCase()}s in ascending order`);
284
+ };
285
+ let fence = null;
286
+ let fenceLine = 0;
287
+ let group = null;
288
+ let task = null;
289
+ /** The marker whose next non-blank line must be its heading. */
290
+ let expect = null;
291
+ const closeTask = (end) => {
292
+ const open = task;
293
+ task = null;
294
+ if (!open.counted)
295
+ return;
296
+ const block = taskFromFields({
297
+ task: open.task,
298
+ group: group?.group ?? 0,
299
+ title: (open.head?.[3] ?? "").trim(),
300
+ done: open.head !== null && open.head[1] !== " ",
301
+ line: open.line,
302
+ end,
303
+ }, open.fields, lines.slice(open.line - 1, end).join("\n"), errors);
304
+ tasks.push(block);
305
+ group?.tasks.push(block);
306
+ };
307
+ for (const [i, raw] of lines.entries()) {
308
+ const n = i + 1;
309
+ const fenceMark = FENCE.exec(raw)?.[1];
310
+ // A closing fence carries no info string: only the fence characters and spaces.
311
+ const closes = fence !== null && fenceMark?.startsWith(fence) === true && FENCE_CLOSE.test(raw);
312
+ if (fenceMark !== undefined && (fence === null || closes)) {
313
+ fence = fence === null ? fenceMark : null;
314
+ fenceLine = n;
315
+ continue;
316
+ }
317
+ if (fence !== null)
318
+ continue;
319
+ if (expect !== null && raw.trim() !== "") {
320
+ const want = expect;
321
+ expect = null;
322
+ if (want.kind === "group") {
323
+ const h = GROUP_HEAD.exec(raw);
324
+ if (h === null)
325
+ err(n, `GROUP ${want.n} (line ${want.line}) is not followed by \`### TASK GROUP ${want.n}: {title}\``);
326
+ else if (Number(h[1]) !== want.n)
327
+ err(n, `heading says GROUP ${h[1]}, its marker at line ${want.line} says GROUP ${want.n}`);
328
+ else if (group !== null)
329
+ group.title = h[2].trim();
330
+ if (h !== null)
331
+ continue;
332
+ }
333
+ else {
334
+ const h = TASK_HEAD.exec(raw);
335
+ if (h === null)
336
+ err(n, `TASK ${want.n} (line ${want.line}) is not followed by \`- [ ] **TASK ${want.n}:** {title}\``);
337
+ else if (Number(h[2]) !== want.n)
338
+ err(n, `task line says TASK ${h[2]}, its marker at line ${want.line} says TASK ${want.n}`);
339
+ else if (task !== null)
340
+ task.head = h;
341
+ if (h !== null)
342
+ continue;
343
+ }
344
+ }
345
+ const marker = MARKER.exec(raw);
346
+ if (marker) {
347
+ const kind = marker[1] === "group" ? "group" : "task";
348
+ const edge = marker[3];
349
+ const no = Number(marker[2]);
350
+ if (kind === "group" && edge === "start") {
351
+ if (task !== null) {
352
+ err(n, `GROUP ${no} starts inside TASK ${task.task} (line ${task.line})`);
353
+ closeTask(n - 1);
354
+ }
355
+ if (group !== null)
356
+ err(n, `GROUP ${no} starts inside GROUP ${group.group} (line ${group.line})`);
357
+ if (groupSeen.has(no))
358
+ err(n, `GROUP ${no} is already used at line ${groupSeen.get(no)}`);
359
+ else {
360
+ groupSeen.set(no, n);
361
+ numbered("GROUP", no, lastGroup, n);
362
+ lastGroup = no;
363
+ }
364
+ lastTask = 0;
365
+ group = { group: no, title: "", line: n, end: n, tasks: [] };
366
+ groups.push(group);
367
+ expect = { kind, n: no, line: n };
368
+ }
369
+ else if (kind === "task" && edge === "start") {
370
+ if (task !== null) {
371
+ err(n, `TASK ${no} starts inside TASK ${task.task} (line ${task.line})`);
372
+ closeTask(n - 1);
373
+ }
374
+ if (group === null)
375
+ err(n, `TASK ${no} starts outside a group: wrap it in \`<!-- bkit:group N start -->\``);
376
+ const dup = taskSeen.has(no);
377
+ if (dup)
378
+ err(n, `TASK ${no} is already used at line ${taskSeen.get(no)}; task numbers are unique in the plan`);
379
+ else {
380
+ taskSeen.set(no, n);
381
+ numbered("TASK", no, lastTask, n);
382
+ lastTask = no;
383
+ }
384
+ task = {
385
+ task: no,
386
+ line: n,
387
+ head: null,
388
+ fields: [],
389
+ current: null,
390
+ counted: group !== null && !dup,
391
+ };
392
+ expect = { kind, n: no, line: n };
393
+ }
394
+ else if (kind === "task") {
395
+ if (task === null)
396
+ err(n, `\`<!-- bkit:task ${no} end -->\` has no open TASK ${no}`);
397
+ else {
398
+ if (task.task !== no)
399
+ err(n, `\`<!-- bkit:task ${no} end -->\` closes TASK ${task.task}, opened at line ${task.line}`);
400
+ closeTask(n);
401
+ }
402
+ }
403
+ else {
404
+ if (task !== null) {
405
+ err(n, `GROUP ${no} ends inside TASK ${task.task} (line ${task.line})`);
406
+ closeTask(n - 1);
407
+ }
408
+ if (group === null)
409
+ err(n, `\`<!-- bkit:group ${no} end -->\` has no open GROUP ${no}`);
410
+ else {
411
+ if (group.group !== no)
412
+ err(n, `\`<!-- bkit:group ${no} end -->\` closes GROUP ${group.group}, opened at line ${group.line}`);
413
+ group.end = n;
414
+ group = null;
415
+ }
416
+ }
417
+ continue;
418
+ }
419
+ if (task !== null) {
420
+ if (INNER_TASK.test(withoutCode(raw))) {
421
+ err(n, `TASK ${task.task}: a second task line inside its block; give that task its own \`<!-- bkit:task N start -->\` block`);
422
+ task.current = null;
423
+ continue;
424
+ }
425
+ const label = LABEL_LINE.exec(raw);
426
+ if (label) {
427
+ const name = label[2].trim();
428
+ const known = PLAN_FIELDS.find((f) => f === name);
429
+ const first = task.fields.find((f) => f.label === known);
430
+ if (known !== undefined && SINGLE_FIELDS.has(known) && first !== undefined) {
431
+ err(n, `TASK ${task.task}: **${known}:** is written twice (first at line ${first.line}); write each field once`);
432
+ task.current = null;
433
+ continue;
434
+ }
435
+ if (known !== undefined) {
436
+ task.current = {
437
+ label: known,
438
+ line: n,
439
+ value: label[3],
440
+ indent: label[1].length,
441
+ items: [],
442
+ last: n,
443
+ };
444
+ task.fields.push(task.current);
445
+ continue;
446
+ }
447
+ if (PLAN_FIELDS.some((f) => f === name.toUpperCase()))
448
+ err(n, `TASK ${task.task}: write the label in uppercase: **${name.toUpperCase()}:**`);
449
+ else if (/^[A-Z][A-Z -]*$/.test(name))
450
+ err(n, `TASK ${task.task}: unknown label **${name}:** (fields: ${PLAN_FIELDS.join(", ")})`);
451
+ task.current = null;
452
+ continue;
453
+ }
454
+ const field = task.current;
455
+ if (field === null || raw.trim() === "")
456
+ continue;
457
+ const bullet = SUB_BULLET.exec(raw);
458
+ if (bullet && bullet[1].length <= field.indent)
459
+ task.current = null;
460
+ else {
461
+ if (bullet)
462
+ field.items.push({ line: n, text: bullet[2] });
463
+ else if (field.items.length > 0)
464
+ field.items.at(-1).text += ` ${raw.trim()}`;
465
+ else
466
+ field.value += ` ${raw.trim()}`;
467
+ field.last = n;
468
+ }
469
+ continue;
470
+ }
471
+ if (raw.trim() === "")
472
+ continue;
473
+ const prose = withoutCode(raw);
474
+ if (STRAY_TASK.test(prose) || STRAY_FIELD.test(prose))
475
+ errors.push({
476
+ line: n,
477
+ kind: "stray",
478
+ message: `task-like text outside every task block: ${raw.trim()}`,
479
+ });
480
+ }
481
+ if (fence !== null)
482
+ err(fenceLine, fenceNeverClosed(fenceLine));
483
+ if (task !== null) {
484
+ const open = task;
485
+ err(open.line, `TASK ${open.task} has no \`<!-- bkit:task ${open.task} end -->\``);
486
+ closeTask(lines.length);
487
+ }
488
+ if (group !== null) {
489
+ const open = group;
490
+ err(open.line, `GROUP ${open.group} has no \`<!-- bkit:group ${open.group} end -->\``);
491
+ open.end = lines.length;
492
+ }
493
+ if (expect !== null) {
494
+ const want = expect;
495
+ err(want.line, `${want.kind.toUpperCase()} ${want.n} has no heading line`);
496
+ }
497
+ errors.sort((a, b) => a.line - b.line);
498
+ return fence === null
499
+ ? { groups, tasks, errors }
500
+ : { groups, tasks, errors, fenceOpen: fenceLine };
501
+ }
@@ -0,0 +1,22 @@
1
+ // Which numbered draft in a run's log folder is the newest: `bkit workflow promote`
2
+ // and the run's `plan` block (`run-facts.ts`) both pick the draft this way.
3
+ import * as fs from "node:fs";
4
+ /**
5
+ * The highest `{workflow}-v{N}-{name}.md` draft, or null. `-v{N}-{k}.md` and `-v{N}-split.md`
6
+ * are files an older bkit's plan split wrote; they are never a draft.
7
+ */
8
+ export function highestVersion(dir, workflow) {
9
+ if (!fs.existsSync(dir))
10
+ return null;
11
+ const re = new RegExp(`^${workflow}-v([0-9]+)-(.+)\\.md$`);
12
+ let best = null;
13
+ for (const f of fs.readdirSync(dir).sort()) {
14
+ const m = re.exec(f);
15
+ if (!m || /^[0-9]+$/.test(m[2]) || m[2] === "split")
16
+ continue;
17
+ const n = Number(m[1]);
18
+ if (best === null || n > best.n)
19
+ best = { file: f, n };
20
+ }
21
+ return best;
22
+ }