@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
@@ -9,10 +9,11 @@
9
9
  // unique. A finding at the location and severity of an earlier task that is still open
10
10
  // reruns that task (its Round value gains this round) rather than adding a twin; one whose
11
11
  // earlier task is done from an earlier round is a new task. It then names the route:
12
- // `fix` (run the tasks), `pause` (ask the owner) or `none`. More than `maxChallengeTasks`
13
- // new tasks in one merge writes nothing and pauses. The plan is checked in memory before
14
- // it is written, so a refused merge leaves every file as it was. A re-run with the same
15
- // reports appends nothing.
12
+ // `fix` (run the tasks: every one is fixable, in any round), `pause` (a task is not
13
+ // fixable: ask the owner) or `none`. More than `maxChallengeTasks` new tasks in one merge
14
+ // writes nothing and pauses. The plan is checked in memory before it is written, so a
15
+ // refused merge leaves every file as it was. A re-run with the same reports appends
16
+ // nothing.
16
17
  //
17
18
  // bkit challenge gate — size the run's diff before the reviewers start. A small change
18
19
  // (under CHALLENGE_SMALL lines and files, `docs/plans/**` excluded) runs the security
@@ -26,9 +27,11 @@ import * as path from "node:path";
26
27
  import { appendLine, statusTimestamp } from "../../ledgers/status.js";
27
28
  import { CommandError, DEV, EXIT, git, runGit, type CommandSpec } from "../lib.js";
28
29
  import { DIFF_BASE, EXIT_BASE, diffNumstat, type DiffStat } from "./context.js";
30
+ import { parseDecisionItems } from "./decisions.js";
29
31
  import { EXIT_ROW_REFUSED, EXIT_STAGE, appendLedgerRows } from "./ledgers.js";
30
- import { parsePlanBlocks, type PlanTaskBlock } from "./plan-blocks.js";
32
+ import { derivedTestMatrix, parsePlanBlocks, type PlanTaskBlock } from "./plan-blocks.js";
31
33
  import { readBkitConfig, type TaskCaps } from "../../shared/settings.js";
34
+ import { grantCount } from "./counters.js";
32
35
  import { checkPlanText, planCaps, readTestFirst } from "./tests.js";
33
36
  import { ledgerRows } from "./workflows.js";
34
37
 
@@ -140,7 +143,7 @@ function findingsLog(text: string): { body: string; line: number } {
140
143
  }
141
144
 
142
145
  /** The group wrapper a Findings Log gets when the reviewer wrote task blocks only. */
143
- const WRAP = ["<!-- bkit:group 1 start -->", "### GROUP 1: Findings"];
146
+ const WRAP = ["<!-- bkit:group 1 start -->", "### TASK GROUP 1: Findings"];
144
147
 
145
148
  /**
146
149
  * One report's findings: each task block under `## Findings Log` (read through
@@ -217,7 +220,8 @@ export function mergeFindings(
217
220
  }
218
221
 
219
222
  /**
220
- * Locations named in a `Decision: Accept` item of any `build-decision-*.md` in `logDir`. An
223
+ * Locations named in a `Decision: Accept` item of any `build-decision-*.md` in `logDir`, the
224
+ * decision read by `parseDecisionItems` (so `Decision: A) Accept …` counts). An
221
225
  * `Accept (assumed)` counts too, so the next round does not raise it again; the build summary
222
226
  * and ship report it as assumed.
223
227
  */
@@ -227,11 +231,11 @@ export function acceptedLocations(logDir: string, cwd: string): Set<string> {
227
231
  ? fs.readdirSync(logDir).filter((f) => /^build-decision-.*\.md$/.test(f))
228
232
  : [];
229
233
  for (const file of files) {
230
- const items = fs.readFileSync(path.join(logDir, file), "utf-8").split(/^(?=\*\*Q\d+)/m);
231
- for (const item of items.slice(1)) {
232
- if (!/^Decision:\s*Accept\b/m.test(item)) continue;
234
+ const items = parseDecisionItems(fs.readFileSync(path.join(logDir, file), "utf-8"));
235
+ for (const item of items) {
236
+ if (!/^Accept\b/.test(item.decision ?? "")) continue;
233
237
  // `path:line`, the path with or without an extension (`src/a.ts:10`, `Makefile:12`).
234
- for (const m of item.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)) {
238
+ for (const m of item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)) {
235
239
  const loc = normalizeLocation(m[0], cwd);
236
240
  if (loc !== null) out.add(loc);
237
241
  }
@@ -251,6 +255,36 @@ const taskBlock = (n: number, f: Finding, round: number) => [
251
255
  `<!-- bkit:task ${n} end -->`,
252
256
  ];
253
257
 
258
+ /** The test tier `docs/testing.md` records for a test file's name. */
259
+ const testTier = (file: string) =>
260
+ /\.integration\.test\./.test(file)
261
+ ? "Integration"
262
+ : /\.live\.test\./.test(file)
263
+ ? "@live (golden)"
264
+ : "Unit";
265
+
266
+ /**
267
+ * One `Derived Test Matrix` row per test a finding task appends: the test's own name and
268
+ * file from its `TEST FIRST` entry, its tier from the file's name, and the task number.
269
+ * A file or name holding a `|` would split the row's cells, so it is refused, not written.
270
+ */
271
+ function matrixRows(findings: Finding[], firstTask: number): { rows: string[]; refused: string[] } {
272
+ const refused: string[] = [];
273
+ const rows = findings.flatMap((f, i) =>
274
+ f.tests.map((entry) => {
275
+ const spans = [...entry.matchAll(/`([^`]+)`/g)].map((m) => m[1]!.trim());
276
+ const file = spans[0] ?? "";
277
+ const name = spans[1] ?? entry.replace(/[`|]/g, "").trim();
278
+ if (file.includes("|") || name.includes("|"))
279
+ refused.push(
280
+ `TASK ${firstTask + i} (${f.location}): its TEST FIRST test file or name holds a \`|\`, which breaks the Derived Test Matrix row`,
281
+ );
282
+ return `| ${name} | ${testTier(file)} | \`${file}\` | ${firstTask + i} |`;
283
+ }),
284
+ );
285
+ return { rows, refused };
286
+ }
287
+
254
288
  /**
255
289
  * The findings as groups of task blocks, numbered from `firstTask` and `firstGroup`: a
256
290
  * group closes at `caps.maxPerGroup` tasks, or before a task that would take it past
@@ -285,7 +319,7 @@ function findingGroups(
285
319
  const lines = chunks.flatMap((chunk, g) => [
286
320
  ...(g === 0 ? [] : [""]),
287
321
  `<!-- bkit:group ${firstGroup + g} start -->`,
288
- `### GROUP ${firstGroup + g}: Challenge round ${round} findings`,
322
+ `### TASK GROUP ${firstGroup + g}: Challenge round ${round} findings`,
289
323
  ...chunk.flatMap((f) => taskBlock(next++, f, round)),
290
324
  `<!-- bkit:group ${firstGroup + g} end -->`,
291
325
  ]);
@@ -296,11 +330,17 @@ function findingGroups(
296
330
  interface Written {
297
331
  from: number;
298
332
  to: number;
333
+ /** The `Derived Test Matrix` rows it inserted, when the plan has a matrix. */
334
+ rows?: { from: number; to: number };
335
+ /** Matrix rows refused before writing: a test span that would break the table. */
336
+ refused: string[];
299
337
  }
300
338
 
301
339
  /**
302
340
  * `plan` with the findings written as new groups after its last group (at the end when
303
- * it has none), tasks numbered from `firstTask`, grouped within `caps`.
341
+ * it has none), tasks numbered from `firstTask`, grouped within `caps`. A plan that
342
+ * carries a `Derived Test Matrix` gains a row per finding test, so the matrix check holds
343
+ * over the appended tasks too.
304
344
  */
305
345
  export function appendTasks(
306
346
  plan: string,
@@ -312,31 +352,56 @@ export function appendTasks(
312
352
  const blocks = parsePlanBlocks(plan);
313
353
  const firstGroup = Math.max(0, ...blocks.groups.map((g) => g.group)) + 1;
314
354
  const { lines: block, tasks } = findingGroups(findings, firstTask, firstGroup, round, caps);
355
+ const matrix = derivedTestMatrix(plan);
356
+ const { rows, refused } =
357
+ matrix === null ? { rows: [], refused: [] } : matrixRows(findings, firstTask);
358
+ // The matrix table's last row, or its separator line when it holds none: 0-based index.
359
+ const matrixAt = matrix === null ? -1 : (matrix.rows.at(-1)?.number ?? matrix.line + 1);
360
+ const lines = plan.split("\n");
361
+ if (matrixAt >= 0) lines.splice(matrixAt, 0, ...rows);
362
+ const rowLines =
363
+ matrixAt >= 0 && rows.length > 0
364
+ ? { from: matrixAt + 1, to: matrixAt + rows.length }
365
+ : undefined;
315
366
  const last = blocks.groups.at(-1);
316
367
  if (last === undefined) {
317
- const body = plan.replace(/\n*$/, "");
368
+ const body = lines.join("\n").replace(/\n*$/, "");
318
369
  const from = body.split("\n").length + 2;
319
370
  return {
320
371
  text: `${body}\n\n${block.join("\n")}\n`,
321
372
  tasks,
322
- written: { from, to: from + block.length - 1 },
373
+ written: { from, to: from + block.length - 1, rows: rowLines, refused },
323
374
  };
324
375
  }
325
- const lines = plan.split("\n");
326
- lines.splice(last.end, 0, "", ...block);
327
- const from = last.end + 2;
328
- return { text: lines.join("\n"), tasks, written: { from, to: from + block.length - 1 } };
376
+ const shift = matrixAt >= 0 && matrixAt <= last.end ? rows.length : 0;
377
+ lines.splice(last.end + shift, 0, "", ...block);
378
+ const from = last.end + shift + 2;
379
+ // Matrix rows below the last group move down by the block and its blank line.
380
+ const moved =
381
+ rowLines !== undefined && shift === 0
382
+ ? { from: rowLines.from + block.length + 1, to: rowLines.to + block.length + 1 }
383
+ : rowLines;
384
+ return {
385
+ text: lines.join("\n"),
386
+ tasks,
387
+ written: { from, to: from + block.length - 1, rows: moved, refused },
388
+ };
329
389
  }
330
390
 
331
391
  /**
332
- * Why the merged `text` may not be written: a plan-check problem on the lines the merge
333
- * wrote (a malformed block, a group or task over its cap), or a written task whose
334
- * TEST FIRST names no test.
392
+ * Why the merged `text` may not be written: a refused matrix row, a plan-check problem on
393
+ * the lines the merge wrote (a malformed block, a group or task over its cap, a broken
394
+ * matrix row), or a written task whose TEST FIRST names no test.
335
395
  */
336
396
  function planProblems(text: string, written: Written, added: number[], caps: TaskCaps): string[] {
337
- const problems = checkPlanText(text, caps)
338
- .problems.filter((p) => p.line >= written.from && p.line <= written.to)
339
- .map((p) => `line ${p.line}: ${p.message}`);
397
+ const at = (line: number, r?: { from: number; to: number }) =>
398
+ r !== undefined && line >= r.from && line <= r.to;
399
+ const problems = [
400
+ ...written.refused,
401
+ ...checkPlanText(text, caps)
402
+ .problems.filter((p) => at(p.line, written) || at(p.line, written.rows))
403
+ .map((p) => `line ${p.line}: ${p.message}`),
404
+ ];
340
405
  const kinds = readTestFirst(text);
341
406
  for (const n of added) {
342
407
  const kind = kinds.find((s) => s.task === n)?.kind ?? "missing";
@@ -346,13 +411,17 @@ function planProblems(text: string, written: Written, added: number[], caps: Tas
346
411
  return problems;
347
412
  }
348
413
 
414
+ /** Stable identity shared by the challenge writer and its resolution reader. */
415
+ export const lowDeferralKey = (fid: string, location: string): string =>
416
+ `${fid}-challenge-low-${location.replace(/[^A-Za-z0-9]+/g, "-").replace(/^-|-$/g, "")}`.toLowerCase();
417
+
349
418
  /** LOW findings as `docs/deferrals.jsonl` rows, keyed by FID and location. */
350
419
  export function lowDeferrals(fid: string, findings: Finding[]): Array<Record<string, unknown>> {
351
420
  return findings
352
421
  .filter((f) => f.severity === "LOW")
353
422
  .map((f) => ({
354
423
  kind: "deferral",
355
- key: `${fid}-challenge-low-${f.location.replace(/[^A-Za-z0-9]+/g, "-").replace(/^-|-$/g, "")}`.toLowerCase(),
424
+ key: lowDeferralKey(fid, f.location),
356
425
  type: "issue",
357
426
  category: "correctness",
358
427
  severity: "LOW",
@@ -425,6 +494,7 @@ export const challengeCommand: CommandSpec = {
425
494
  gate: {
426
495
  summary:
427
496
  "Size the run's diff ({base}...HEAD, docs/plans/** excluded) and name the reviewers: small runs challenge-2 alone, large runs both. Writes a challenge-gate status row.",
497
+ use: "workflow",
428
498
  flags: [
429
499
  {
430
500
  name: "file",
@@ -494,6 +564,7 @@ export const challengeCommand: CommandSpec = {
494
564
  merge: {
495
565
  summary:
496
566
  "Merge the challenge reports' findings into the plan as tasks (LOW → deferral rows); prints the route: fix | pause | none.",
567
+ use: "workflow",
497
568
  flags: [
498
569
  {
499
570
  name: "report",
@@ -518,12 +589,12 @@ export const challengeCommand: CommandSpec = {
518
589
  name: "round",
519
590
  type: "string",
520
591
  required: true,
521
- help: "challenge round, 1 up to bkit.workflows.build.challenge.maxAttempts; any task from the last round routes to pause",
592
+ help: "challenge round, 1 up to bkit.workflows.build.challenge.maxAttempts, one more full set per allowance-granted row for build.challenge in the log folder's status.jsonl",
522
593
  },
523
594
  ],
524
595
  output: {
525
596
  route:
526
- "fix (tasks to run), pause (a task is not fixable, the last round left tasks, or more than 4 x `bkit.workflows.tasks.maxPerGroup` new tasks) or none (nothing to run)",
597
+ "fix (tasks to run, every one fixable), pause (a task is not fixable, or more than 4 x `bkit.workflows.tasks.maxPerGroup` new tasks) or none (nothing to run)",
527
598
  fixTasks:
528
599
  "comma-separated task numbers in `plan` this round runs: every task reopened, then every task appended; empty when none",
529
600
  appended: "how many tasks this run wrote",
@@ -548,17 +619,25 @@ export const challengeCommand: CommandSpec = {
548
619
  run: (ctx) => {
549
620
  const round = String(ctx.flags.round);
550
621
  const top = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
551
- const maxRounds = readBkitConfig(top).asks["build.challenge"].max;
622
+ const abs = (p: string) => path.resolve(ctx.cwd, p);
623
+ const rel = (p: string) => path.relative(ctx.cwd, p).split(path.sep).join("/");
624
+ const planArg = String(ctx.flags.plan);
625
+ const logDir = abs(String(ctx.flags.log));
626
+ // Each allowance the owner granted at the used-up limit adds one full set of rounds.
627
+ const grants = grantCount(
628
+ path.join(logDir, "status.jsonl"),
629
+ "build",
630
+ "build.challenge",
631
+ undefined,
632
+ false,
633
+ );
634
+ const maxRounds = readBkitConfig(top).asks["build.challenge"].max * (1 + grants);
552
635
  if (!/^[1-9][0-9]*$/.test(round) || Number(round) > maxRounds)
553
636
  throw new CommandError(
554
637
  EXIT.USAGE,
555
- `--round must be 1 to ${maxRounds} (bkit.workflows.build.challenge.maxAttempts), got "${round}"`,
638
+ `--round must be 1 to ${maxRounds} (bkit.workflows.build.challenge.maxAttempts x (1 + ${grants} allowance(s) granted)), got "${round}"`,
556
639
  );
557
640
  const roundN = Number(round);
558
- const abs = (p: string) => path.resolve(ctx.cwd, p);
559
- const rel = (p: string) => path.relative(ctx.cwd, p).split(path.sep).join("/");
560
- const planArg = String(ctx.flags.plan);
561
- const logDir = abs(String(ctx.flags.log));
562
641
  const fid = path.basename(logDir);
563
642
 
564
643
  const reports = (ctx.flags.report as string[]).map((r) => {
@@ -648,11 +727,7 @@ export const challengeCommand: CommandSpec = {
648
727
 
649
728
  const running = [...fresh, ...open.map((x) => x.f)];
650
729
  const route =
651
- fixTasks.length === 0
652
- ? "none"
653
- : roundN >= maxRounds || running.some((f) => !f.fixable)
654
- ? "pause"
655
- : "fix";
730
+ fixTasks.length === 0 ? "none" : running.some((f) => !f.fixable) ? "pause" : "fix";
656
731
  ctx.emit({
657
732
  route,
658
733
  fixTasks: fixTasks.join(","),
@@ -0,0 +1,109 @@
1
+ // bkit completeness check — report whether a run recorded every step and journaled every command its workflow requires.
2
+
3
+ import * as fs from "node:fs";
4
+ import * as path from "node:path";
5
+
6
+ import {
7
+ deriveContract,
8
+ inferWorkflows,
9
+ parseRows,
10
+ readCompleteness,
11
+ runsOf,
12
+ type CompletenessVerdict,
13
+ } from "../../checks/status-holes.js";
14
+ import { getWorkflowsRoot } from "../../shared/package-roots.js";
15
+ import { EXIT, type CommandSpec } from "../lib.js";
16
+ import { readIssueTracker } from "./fids.js";
17
+ import { FILE_FLAG, WORKFLOW_FLAG, statusFile } from "./status.js";
18
+
19
+ const TAG = "[bkit-status-holes]";
20
+
21
+ const readText = (file: string, log: (message: string) => void): string | null => {
22
+ try {
23
+ return fs.readFileSync(file, "utf-8");
24
+ } catch (err) {
25
+ log(`${TAG} ${file} not readable: ${err instanceof Error ? err.message : String(err)}`);
26
+ return null;
27
+ }
28
+ };
29
+
30
+ function reportLines(v: CompletenessVerdict): string[] {
31
+ const calls = (list: Array<{ noun: string; verb: string }>) =>
32
+ list.map((c) => `${c.noun} ${c.verb}`).join(", ");
33
+ const lines = [
34
+ `${TAG} ADVISORY — ${v.workflow}: ${v.verdict} (${v.observed.steps} step(s), ${v.observed.calls} call(s) observed)`,
35
+ ];
36
+ if (v.preJournal) lines.push(" pre-journal run: command evidence not available");
37
+ if (v.stepHoles.length > 0) lines.push(` step holes: ${v.stepHoles.join(", ")}`);
38
+ for (const h of v.evidenceHoles)
39
+ lines.push(` evidence hole: ${h.step} lacks ${calls(h.missing)}`);
40
+ if (v.unexercised.length > 0)
41
+ lines.push(` unexercised arms: ${v.unexercised.length} (not holes)`);
42
+ return lines;
43
+ }
44
+
45
+ export const completenessCommand: CommandSpec = {
46
+ noun: "completeness",
47
+ summary: "Check a run for missing steps and missing bkit commands.",
48
+ verbs: {
49
+ check: {
50
+ summary:
51
+ "Report the steps and bkit commands a run is missing, from its status.jsonl and the workflow markdown; advisory, always exits 0.",
52
+ use: "by-hand",
53
+ flags: [
54
+ FILE_FLAG,
55
+ {
56
+ ...WORKFLOW_FLAG,
57
+ required: false,
58
+ help: "workflow name: design, plan, build, debug, ship; absent = each workflow the file holds rows of",
59
+ },
60
+ ],
61
+ output: {
62
+ report: "the human-readable report",
63
+ holey: "true when any checked run has an evidence hole or a step hole",
64
+ verdicts: "one completeness verdict per checked run; empty when nothing could be read",
65
+ },
66
+ run: (ctx) => {
67
+ const file = statusFile(ctx);
68
+ const text = readText(file, ctx.log);
69
+ if (text === null) {
70
+ ctx.emit({ report: `${TAG} no status.jsonl to check`, holey: false, verdicts: [] });
71
+ return EXIT.OK;
72
+ }
73
+ const rows = parseRows(text);
74
+ const given = typeof ctx.flags.workflow === "string" ? ctx.flags.workflow : undefined;
75
+ const workflows = given === undefined ? inferWorkflows(rows) : [given];
76
+ // The repo holding the file sets the tracker, as on the close and start paths.
77
+ const tracker = readIssueTracker(path.dirname(file));
78
+ const verdicts: CompletenessVerdict[] = [];
79
+ const lines: string[] = [];
80
+ for (const workflow of workflows) {
81
+ const md = readText(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), ctx.log);
82
+ if (md === null) {
83
+ ctx.log(`${TAG} bkit-${workflow}.md not readable — skipping ${workflow} (advisory)`);
84
+ continue;
85
+ }
86
+ try {
87
+ const contract = deriveContract(md, workflow, tracker);
88
+ for (const run of runsOf(rows, workflow)) {
89
+ const { verdict } = readCompleteness(run, contract);
90
+ verdicts.push(verdict);
91
+ lines.push(...reportLines(verdict));
92
+ }
93
+ } catch (err) {
94
+ ctx.log(
95
+ `${TAG} ${workflow}: ${err instanceof Error ? err.message : String(err)} — no verdict (advisory)`,
96
+ );
97
+ }
98
+ }
99
+ if (lines.length === 0) lines.push(`${TAG} no verdict`);
100
+ ctx.emit({
101
+ report: lines.join("\n"),
102
+ holey: verdicts.some((v) => v.holey),
103
+ verdicts,
104
+ });
105
+ return EXIT.OK;
106
+ },
107
+ },
108
+ },
109
+ };