@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
@@ -1,10 +1,10 @@
1
1
  // checks/status-holes.ts — Tier-3 advisory status-hole detector.
2
2
  //
3
- // A fail-open advisory that compares the set of ship steps RECORDED in a
4
- // status.jsonl against the set of steps the workflow PROSE says should be
5
- // there. It derives its expected set from .bkit/core/workflows/bkit-ship.md at
6
- // runtime (headings + step:"ship-*" literals) — NEVER a hand-maintained table
7
- // (decision 384-tier3-promotion).
3
+ // A fail-open advisory that compares the steps RECORDED in each run of a
4
+ // status.jsonl against the steps the workflow PROSE says should be there. It
5
+ // derives the expected set from .bkit/core/workflows/bkit-{workflow}.md at
6
+ // runtime (headings + --step= literals) — NEVER a hand-maintained table
7
+ // (decision 384-tier3-promotion). Each run's workflow is inferred from its rows.
8
8
  //
9
9
  // ADVISORY / FAIL-OPEN: the CLI exits 0 unconditionally — even when holes are
10
10
  // found (decision 384-tier3-promotion).
@@ -20,13 +20,17 @@
20
20
  // appear only in the merge-retry loop.
21
21
  //
22
22
  // Usage (advisory CI step or manual):
23
- // npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl> [--ship-md <path>]
23
+ // npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl>...
24
24
  // # exits 0 always; prints advisory report to stdout
25
+ import { createHash } from "node:crypto";
25
26
  import * as fs from "node:fs";
26
27
  import * as path from "node:path";
27
28
  import { fileURLToPath } from "node:url";
29
+ import { DECISION_ROUTES, WORKFLOW_STEPS } from "../commands/workflow/step-table.js";
30
+ import { substituteWorkflow } from "../render/trackers.js";
28
31
  import { parseJson } from "../shared/json.js";
29
32
  import { getWorkflowsRoot } from "../shared/package-roots.js";
33
+ import { ciRoundMatches } from "../ledgers/status.js";
30
34
  // ---------------------------------------------------------------------------
31
35
  // Canonical ship step order (mirrors audits/workflows/ship-invariants.test.ts
32
36
  // CANONICAL_SHIP_STEP_KEYS — the frozen schema). The detector cross-checks its
@@ -74,83 +78,636 @@ const MERGED_ON_ENTRY_SKIP = new Set([
74
78
  "ship-merge-pr",
75
79
  // failure-diagnose/remediate are already in RETRY_LOOP_STEPS (never expected)
76
80
  ]);
77
- // ---------------------------------------------------------------------------
78
- // Source derivation — parse bkit-ship.md to find the expected step universe.
79
- // ---------------------------------------------------------------------------
80
81
  /**
81
- * Derive the universe of ship step keys from the workflow markdown.
82
- *
83
- * Strategy:
84
- * 1. Extract every `step:"ship-..."` literal from fenced code blocks.
85
- * 2. Extract every `## … Step N — Name` heading and map the heading's section
86
- * to the step key(s) found within it.
87
- * 3. Return the union of all unique step keys.
88
- *
89
- * The two passes scan the SAME `step:"ship-*"` regex and the heading pass only
90
- * narrows the line range, so `headingSteps` is always a subset of `literalSteps`.
91
- * The detector reports `orphanSteps`: a status write that appears in the file but NOT
92
- * inside any `## … Step N` section.
82
+ * Step rows an engine verb writes itself, keyed by noun + verb: `tests red` writes the
83
+ * `RED_STEP` row of `commands/workflow/tests.ts` inside build Step 7.
84
+ */
85
+ const VERB_ROWS = {
86
+ "tests red": ["build-tests-red"],
87
+ };
88
+ // A step that reads a verb row (`counters derive --step=build-tests-red`) does not own it.
89
+ const VERB_ROW_KEYS = new Set(Object.values(VERB_ROWS).flat());
90
+ /**
91
+ * Calls the orchestrator may run at any point of a run, active when the workflow's
92
+ * `**Contract:**` block names them as `` `bkit {noun} {verb}` `` (the **Friction** bullet's
93
+ * `bkit ledgers append`). The Contract also names step-bound calls, so it is not read wholesale.
93
94
  */
94
- export function deriveExpectedStepSetFromSource(shipMd) {
95
- const lines = shipMd.split("\n");
96
- // 1. Collect every `step:"ship-..."` / `--step=ship-...` literal (anywhere — fenced or prose).
97
- const literalSet = new Set();
98
- const literalRe = /(?:step:"|--step=)(ship-[a-z-]+)/g;
99
- for (const line of lines) {
100
- let m;
101
- while ((m = literalRe.exec(line)) !== null) {
102
- literalSet.add(m[1]);
95
+ const ANYWHERE_CALLS = ["ledgers append"];
96
+ // A key followed by `{` is a templated log label (`build-group-gate-{GROUP}`), not a row key.
97
+ const STEP_KEY_RE = /(?:step:"|--step=)([a-z][a-z0-9-]*)(\{)?/g;
98
+ /** The words of one `"{BKIT}" ...` call: shell-split, quotes kept, stopped at the first unquoted operator. */
99
+ export function callWords(rest) {
100
+ const words = [];
101
+ let word = "";
102
+ let quote = "";
103
+ for (const ch of rest) {
104
+ if (quote) {
105
+ word += ch;
106
+ if (ch === quote)
107
+ quote = "";
103
108
  }
104
- literalRe.lastIndex = 0; // reset per-line
109
+ else if (ch === '"' || ch === "'") {
110
+ word += ch;
111
+ quote = ch;
112
+ }
113
+ else if ("|;&><)`".includes(ch))
114
+ break;
115
+ else if (/\s/.test(ch)) {
116
+ if (word)
117
+ words.push(word);
118
+ word = "";
119
+ }
120
+ else
121
+ word += ch;
105
122
  }
106
- // 2. Collect heading-derived steps. A `## … Step N` heading opens a section;
107
- // the step key(s) within that section's body (until the next `## ` heading)
108
- // belong to that step.
109
- const headingSet = new Set();
110
- let inStep = false;
111
- for (const line of lines) {
112
- if (/^##\s+.*Step\s+\d+/i.test(line)) {
113
- inStep = true;
114
- continue;
123
+ if (word)
124
+ words.push(word);
125
+ return words;
126
+ }
127
+ /** Each `Step N — Title` heading, with the text up to the next step or section heading. */
128
+ export function stepSections(text) {
129
+ const lines = text.split("\n");
130
+ const heading = /^#{2,3} \S+ Step (\d+) — (.+)$/;
131
+ const out = [];
132
+ lines.forEach((l, i) => {
133
+ const m = heading.exec(l);
134
+ if (!m)
135
+ return;
136
+ const end = lines.findIndex((x, j) => j > i && /^#{2,3} /.test(x) && !x.startsWith("### 🔒"));
137
+ out.push({
138
+ number: Number(m[1]),
139
+ title: m[2],
140
+ body: lines.slice(i, end === -1 ? undefined : end).join("\n"),
141
+ });
142
+ });
143
+ return out;
144
+ }
145
+ /** Each `"{BKIT}"` call in `text` as noun / verb / flag names. */
146
+ function requiredCalls(text) {
147
+ const joined = text.replace(/\\\n\s*/g, " ");
148
+ return joined
149
+ .split('"{BKIT}"')
150
+ .slice(1)
151
+ .map((call) => {
152
+ const [noun = "", verb = "", ...rest] = callWords(call.replace(/^ /, ""));
153
+ const flags = rest.flatMap((w) => {
154
+ const f = /^--([a-z][a-z0-9-]*)/.exec(w)?.[1];
155
+ return f ? [f] : [];
156
+ });
157
+ return { noun, verb: verb.startsWith("--") ? "" : verb, flags };
158
+ });
159
+ }
160
+ /** R1: per line of a step section, true when it sits on an `If` / `Else` arm. */
161
+ function branchLines(lines) {
162
+ const branch = lines.map(() => false);
163
+ const targets = new Set();
164
+ const blocks = new Set();
165
+ let ifIndent = null;
166
+ lines.forEach((l, i) => {
167
+ if (l.trim() === "") {
168
+ branch[i] = ifIndent !== null;
169
+ return;
170
+ }
171
+ const indent = l.length - l.trimStart().length;
172
+ if (ifIndent !== null && indent <= ifIndent)
173
+ ifIndent = null;
174
+ if (/^\s*(?:- |\d+\. )\*\*(If|Else)\*\*/.test(l))
175
+ ifIndent = indent;
176
+ branch[i] = ifIndent !== null;
177
+ if (/\*\*(If|Else)\*\*/.test(l)) {
178
+ for (const m of l.matchAll(/sub-step (\d+)/g))
179
+ targets.add(Number(m[1]));
180
+ for (const m of l.matchAll(/→ \*\*([^*]+)\*\*/g))
181
+ blocks.add(m[1]);
182
+ }
183
+ });
184
+ let sub = null;
185
+ let block = false;
186
+ lines.forEach((l, i) => {
187
+ const m = /^(\d+)\. /.exec(l);
188
+ if (m)
189
+ sub = Number(m[1]);
190
+ else if (l.startsWith("#"))
191
+ sub = null;
192
+ if (sub !== null && targets.has(sub))
193
+ branch[i] = true;
194
+ // A `**Name:**` block an `**If**` line routes to runs to the next such block or heading.
195
+ const label = /^\*\*([^*]+):\*\*/.exec(l)?.[1];
196
+ if (label !== undefined && blocks.has(label))
197
+ block = true;
198
+ else if (/^#{2,} /.test(l))
199
+ block = false;
200
+ if (block)
201
+ branch[i] = true;
202
+ });
203
+ return branch;
204
+ }
205
+ /**
206
+ * Per `"{BKIT}"` call in `text`, true when it sits after an inline `**If** … →` / `**Else** →`
207
+ * in the same sentence (`→ add `Group gate`: `"{BKIT}" tests run …``). A call in the fence
208
+ * below such a line stays required: there the condition may only change the call.
209
+ */
210
+ function inlineArms(text) {
211
+ const parts = text.split('"{BKIT}"');
212
+ return parts.slice(1).map((_, i) => {
213
+ const before = parts.slice(0, i + 1).join('"{BKIT}"');
214
+ const lead = [...before.matchAll(/\*\*(?:If|Else)\*\*/g)].at(-1);
215
+ if (lead?.index === undefined)
216
+ return false;
217
+ const clause = before.slice(lead.index).replace(/`[^`]*`/g, "");
218
+ return clause.includes("→") && !/\.\s/.test(clause);
219
+ });
220
+ }
221
+ /** The `"{BKIT}"` calls of one step section, each tagged with its position (R3) and branch flag (R1). */
222
+ function sectionCalls(body) {
223
+ const lines = body.split("\n");
224
+ const branch = branchLines(lines);
225
+ const logical = [];
226
+ for (let i = 0; i < lines.length; i++) {
227
+ let text = lines[i];
228
+ const start = i;
229
+ while (text.endsWith("\\") && i + 1 < lines.length) {
230
+ i += 1;
231
+ text = `${text.slice(0, -1)} ${lines[i].trimStart()}`;
232
+ }
233
+ logical.push({ text, branch: branch[start] });
234
+ }
235
+ const perLine = logical.map((l) => requiredCalls(l.text));
236
+ const isFinish = (c) => c.noun === "steps" && (c.verb === "finish" || (c.verb === "done" && c.flags.includes("step")));
237
+ // An optional finish below the step's own (a route arm's row) does not move the line.
238
+ const finishes = perLine.flatMap((calls, i) => (calls.some(isFinish) ? [i] : []));
239
+ const plain = finishes.filter((i) => !logical[i].branch);
240
+ const lastFinish = (plain.length > 0 ? plain : finishes).at(-1) ?? -1;
241
+ return perLine.flatMap((calls, i) => {
242
+ const inline = inlineArms(logical[i].text);
243
+ return calls.map((c, j) => ({
244
+ ...c,
245
+ position: i > lastFinish && lastFinish !== -1 ? "post" : "pre",
246
+ branch: logical[i].branch || inline[j],
247
+ line: i,
248
+ }));
249
+ });
250
+ }
251
+ /** Row keys a section writes (not merely names in a `steps gate --step=` read). */
252
+ function stepWrites(text) {
253
+ const joined = text.replace(/\\\n\s*/g, " ");
254
+ const found = joined.split("\n").flatMap((line) => {
255
+ const viaCall = /"\{BKIT\}" steps (?:finish|done)\b/.test(line) ? stepKeys(line) : [];
256
+ return [...viaCall, ...[...line.matchAll(/step:"([a-z][a-z0-9-]*)"/g)].map((m) => m[1])];
257
+ });
258
+ return [...new Set(found)];
259
+ }
260
+ const stepKeys = (text) => [
261
+ ...new Set([...text.matchAll(STEP_KEY_RE)].filter((m) => !m[2]).map((m) => m[1])),
262
+ ];
263
+ /** A step is conditional under a column-0 marker line anywhere in its section, or a `(Path X only)` heading. */
264
+ export function isConditionalSection(body) {
265
+ const lines = body.split("\n");
266
+ return (/\(Path [A-Z] only\)/.test(lines[0] ?? "") ||
267
+ lines.some((l) => /^\*\*(Run only if|Skip if)\*\*/.test(l)));
268
+ }
269
+ /**
270
+ * Derive the contract of one workflow from its markdown: the step sections, the
271
+ * row keys and `"{BKIT}"` calls each holds, and the calls no step owns. The
272
+ * universe is cross-checked against the deduped `WORKFLOW_STEPS[workflow]`; a
273
+ * disagreement is reported as drift, never thrown. With a `tracker`, the markdown is
274
+ * first rendered for it, so a consumer is held to the calls its installed workflow names.
275
+ */
276
+ export function deriveContract(sourceMd, workflow, tracker) {
277
+ const workflowMd = tracker === undefined ? sourceMd : substituteWorkflow(sourceMd, tracker).output;
278
+ const sections = stepSections(workflowMd);
279
+ // The journal window runs from the first `workflows start` call to the `workflows close`
280
+ // call: a call written above or below it is matched when journaled, never required.
281
+ const lineOf = (offset) => workflowMd.slice(0, offset).split("\n").length - 1;
282
+ const absLine = (s, line) => lineOf(workflowMd.indexOf(s.body)) + line;
283
+ const marks = (noun, verb) => sections.flatMap((s) => sectionCalls(s.body)
284
+ .filter((c) => c.noun === noun && c.verb === verb)
285
+ .map((c) => absLine(s, c.line)));
286
+ const starts = marks("workflows", "start");
287
+ const closes = marks("workflows", "close");
288
+ const windowStart = starts.length > 0 ? Math.min(...starts) : -1;
289
+ const windowEnd = closes.length > 0 ? Math.max(...closes) : Number.POSITIVE_INFINITY;
290
+ const outsideWindow = [];
291
+ const steps = sections.map((s) => {
292
+ const inside = [];
293
+ for (const { line, ...c } of sectionCalls(s.body)) {
294
+ const at = absLine(s, line);
295
+ // `workflows start` itself is outside: a fresh run has no active run to journal it under.
296
+ const isStart = c.noun === "workflows" && c.verb === "start";
297
+ if (isStart || at < windowStart || at > windowEnd)
298
+ outsideWindow.push(c);
299
+ else
300
+ inside.push(c);
301
+ }
302
+ return {
303
+ number: s.number,
304
+ title: s.title,
305
+ keys: stepKeys(s.body).filter((k) => !VERB_ROW_KEYS.has(k)),
306
+ writes: stepWrites(s.body),
307
+ calls: inside,
308
+ conditional: isConditionalSection(s.body),
309
+ };
310
+ });
311
+ const universe = [...new Set(steps.flatMap((s) => s.keys))].sort();
312
+ // Text outside every step section: the md minus each section body.
313
+ let outside = workflowMd;
314
+ for (const s of sections)
315
+ outside = outside.replace(s.body, "");
316
+ const table = WORKFLOW_STEPS[workflow];
317
+ const tableKeys = new Set((table ?? []).flatMap((s) => (s.step ? [s.step] : [])));
318
+ const drift = [];
319
+ if (table) {
320
+ for (const k of tableKeys)
321
+ if (!universe.includes(k))
322
+ drift.push(`table-but-not-source:${k}`);
323
+ for (const k of universe)
324
+ if (!tableKeys.has(k))
325
+ drift.push(`source-but-not-table:${k}`);
326
+ }
327
+ const outsideKeys = stepKeys(outside).filter((k) => k.startsWith(`${workflow}-`) && !universe.includes(k));
328
+ const pause = DECISION_ROUTES[workflow]?.step;
329
+ const pauseRows = pause !== undefined && outsideKeys.includes(pause) ? [pause] : [];
330
+ const named = new Set(sections.flatMap((s) => sectionCalls(s.body)).map(callKey));
331
+ const contractBlock = /^\*\*Contract:\*\*[\s\S]*?(?=^#{1,3} |(?![\s\S]))/m.exec(workflowMd)?.[0] ?? "";
332
+ const anywhereCalls = ANYWHERE_CALLS.filter((call) => contractBlock.includes(`\`bkit ${call}\``)).map((call) => {
333
+ const [noun = "", verb = ""] = call.split(" ");
334
+ return { noun, verb, flags: [] };
335
+ });
336
+ const subRows = Object.entries(VERB_ROWS)
337
+ .filter(([call]) => named.has(call))
338
+ .flatMap(([, keys]) => keys.filter((k) => k.startsWith(`${workflow}-`)));
339
+ return {
340
+ workflow,
341
+ steps,
342
+ universe,
343
+ workflowCalls: [...requiredCalls(outside), ...outsideWindow],
344
+ anywhereCalls,
345
+ sourceSha: createHash("sha256").update(workflowMd).digest("hex"),
346
+ pauseRows,
347
+ subRows,
348
+ orphanSteps: outsideKeys.filter((k) => !pauseRows.includes(k)).sort(),
349
+ drift,
350
+ };
351
+ }
352
+ /** The `completeness` verb journals itself; it is neither expected nor ever unexpected. */
353
+ const SELF_NOUN = "completeness";
354
+ const callKey = (c) => `${c.noun} ${c.verb}`;
355
+ export function contractUnits(contract) {
356
+ const owner = new Map();
357
+ for (const k of contract.universe) {
358
+ const writers = contract.steps.filter((s) => s.writes.includes(k));
359
+ const namers = contract.steps.filter((s) => s.keys.includes(k));
360
+ const first = writers.length > 0 ? writers[0] : namers.at(-1);
361
+ if (first)
362
+ owner.set(k, first);
363
+ }
364
+ const owners = contract.steps.filter((s) => [...owner.values()].includes(s));
365
+ return owners.map((s) => {
366
+ const keys = s.keys.filter((k) => owner.get(k) === s);
367
+ const folded = contract.steps.filter((f) => !owners.includes(f) && f.keys[0] !== undefined && owner.get(f.keys[0]) === s);
368
+ const calls = [
369
+ ...folded.filter((f) => f.number < s.number).flatMap((f) => f.calls),
370
+ ...s.calls,
371
+ ...folded
372
+ .filter((f) => f.number > s.number)
373
+ .flatMap((f) => f.calls.map((c) => ({ ...c, position: "post" }))),
374
+ ];
375
+ const shared = s.writes.filter((k) => owner.has(k) && owner.get(k) !== s);
376
+ return { number: s.number, keys, shared, calls, conditional: s.conditional };
377
+ });
378
+ }
379
+ /**
380
+ * Classify one run's rows against its contract. Consecutive rows of one unit form a
381
+ * visit (a repeat of a key starts a new one, so each group-loop repeat owns its own
382
+ * gaps). A visit owns the calls before its first row and between its rows, and the
383
+ * calls after its last row that are one of its `post` calls (R3); the rest belong to
384
+ * the next visit. Matching is on noun + verb (R2). `holey` keys on `evidenceHoles` +
385
+ * `stepHoles` only. Never throws and never filters by age.
386
+ */
387
+ export function check(rows, contract, options = {}) {
388
+ const workflow = contract.workflow;
389
+ const own = rows.filter((r) => r.workflow === workflow);
390
+ const units = contractUnits(contract).map((u) => ({
391
+ ...u,
392
+ calls: u.calls.filter((c) => c.noun !== SELF_NOUN),
393
+ }));
394
+ const unitOf = new Map();
395
+ for (const u of units)
396
+ for (const k of u.keys)
397
+ unitOf.set(k, u);
398
+ const writersOf = new Map();
399
+ for (const u of units)
400
+ for (const k of [...u.keys, ...u.shared])
401
+ writersOf.set(k, [...(writersOf.get(k) ?? []), u]);
402
+ const workflowCalls = contract.workflowCalls.filter((c) => c.noun !== SELF_NOUN);
403
+ const workflowKeys = new Set([...workflowCalls, ...contract.anywhereCalls].map(callKey));
404
+ const subRows = new Set(contract.subRows);
405
+ const pauseRows = new Set(contract.pauseRows);
406
+ // A sub-row sits inside the visit of the step whose call wrote it, so it is no visit boundary.
407
+ // A pause row is a boundary owned by no step, like a row outside the contract.
408
+ const items = own.flatMap((r) => {
409
+ if (r.type === "engine-call" && r["noun"] !== SELF_NOUN) {
410
+ return [{ kind: "call", call: { noun: String(r["noun"]), verb: String(r["verb"]) } }];
411
+ }
412
+ if (r.type === "step-done" && typeof r.step === "string" && !subRows.has(r.step)) {
413
+ return [{ kind: "step", key: r.step, row: r, unit: unitOf.get(r.step) }];
414
+ }
415
+ return [];
416
+ });
417
+ const stepRowCount = own.filter((r) => r.type === "step-done" && typeof r.step === "string").length;
418
+ const callCount = items.filter((i) => i.kind === "call").length;
419
+ const preJournal = callCount === 0;
420
+ // A journal that starts mid-run (an engine upgrade, the kill switch lifted) leaves the
421
+ // visits that finished before its first `engine-call` row with no evidence to judge.
422
+ const firstCall = items.findIndex((i) => i.kind === "call");
423
+ // Visits over the step rows, in order; a row outside the contract closes the current visit.
424
+ const visits = [];
425
+ const visitOfRow = new Map();
426
+ let current;
427
+ const keysInCurrent = new Set();
428
+ // A row two units write joins the open visit of one of them, else the unit that also
429
+ // writes the next row, else its owner.
430
+ const unitOfRow = (key, owner, i) => {
431
+ const writers = writersOf.get(key) ?? [owner];
432
+ if (writers.length === 1)
433
+ return owner;
434
+ if (current && writers.includes(current.unit) && !keysInCurrent.has(key))
435
+ return current.unit;
436
+ const next = items.slice(i + 1).find((x) => x.kind === "step" && x.unit !== undefined);
437
+ const nextWriters = next?.kind === "step" ? (writersOf.get(next.key) ?? []) : [];
438
+ return writers.find((w) => nextWriters.includes(w)) ?? owner;
439
+ };
440
+ items.forEach((item, i) => {
441
+ if (item.kind !== "step")
442
+ return;
443
+ if (!item.unit) {
444
+ current = undefined;
445
+ return;
446
+ }
447
+ const unit = unitOfRow(item.key, item.unit, i);
448
+ const sameUnit = current?.unit === unit && !keysInCurrent.has(item.key);
449
+ if (!sameUnit) {
450
+ current = { unit, rows: [] };
451
+ keysInCurrent.clear();
452
+ visits.push(current);
453
+ }
454
+ current.rows.push(i);
455
+ keysInCurrent.add(item.key);
456
+ visitOfRow.set(i, current);
457
+ });
458
+ const postSlots = new Map();
459
+ const freshSlots = (v) => {
460
+ const slots = { plain: new Map(), arm: new Map() };
461
+ for (const c of v.unit.calls) {
462
+ if (c.position !== "post")
463
+ continue;
464
+ const m = c.branch ? slots.arm : slots.plain;
465
+ m.set(callKey(c), (m.get(callKey(c)) ?? 0) + 1);
115
466
  }
116
- if (/^##\s+/m.test(line) && !/Step\s+\d+/i.test(line)) {
117
- inStep = false;
467
+ postSlots.set(v, slots);
468
+ return slots;
469
+ };
470
+ const take = (m, key) => {
471
+ const n = m.get(key) ?? 0;
472
+ if (n > 0)
473
+ m.set(key, n - 1);
474
+ return n > 0;
475
+ };
476
+ const stepIdx = items.flatMap((it, i) => (it.kind === "step" ? [i] : []));
477
+ const owned = new Map();
478
+ const unexpectedCalls = new Map();
479
+ const unattributable = new Map();
480
+ items.forEach((item, i) => {
481
+ if (item.kind !== "call")
482
+ return;
483
+ const key = callKey(item.call);
484
+ const prevIdx = stepIdx.filter((x) => x < i).at(-1) ?? -1;
485
+ const nextIdx = stepIdx.find((x) => x > i) ?? -1;
486
+ const prevVisit = visitOfRow.get(prevIdx);
487
+ const nextVisit = visitOfRow.get(nextIdx);
488
+ // Each post call of a visit absorbs one journaled call: a noun + verb written both
489
+ // below one step's finish line and above the next step's is charged once to each.
490
+ // A route-arm post call absorbs more only while the next visit names no such call.
491
+ const slots = prevVisit === undefined ? undefined : (postSlots.get(prevVisit) ?? freshSlots(prevVisit));
492
+ const nextNames = (armsToo) => nextVisit?.unit.calls.some((c) => callKey(c) === key && (armsToo || !c.branch)) === true;
493
+ const claimsPost = prevVisit !== undefined &&
494
+ prevVisit.rows.at(-1) === prevIdx &&
495
+ slots !== undefined &&
496
+ (take(slots.plain, key) ||
497
+ (prevVisit.unit.calls.some((c) => c.position === "post" && c.branch && callKey(c) === key) &&
498
+ !nextNames(false) &&
499
+ (take(slots.arm, key) || !nextNames(true))));
500
+ const insideVisit = prevVisit !== undefined && prevVisit === nextVisit ? prevVisit : undefined;
501
+ // A post call journaled between its visit's own rows (above an arm's row) uses its slot.
502
+ if (insideVisit !== undefined && slots !== undefined) {
503
+ if (!take(slots.plain, key))
504
+ take(slots.arm, key);
505
+ }
506
+ const owner = insideVisit ?? (claimsPost ? prevVisit : nextVisit);
507
+ const required = owner?.unit.calls.some((c) => callKey(c) === key) === true;
508
+ if (owner && required) {
509
+ owned.set(owner, (owned.get(owner) ?? new Set()).add(key));
510
+ }
511
+ else if (workflowKeys.has(key)) {
512
+ // R4: a workflow-level call is never charged to a step and never unexpected.
513
+ }
514
+ else if (owner === undefined) {
515
+ unattributable.set(key, item.call);
516
+ }
517
+ else {
518
+ unexpectedCalls.set(key, item.call);
519
+ }
520
+ });
521
+ const evidenceHoles = [];
522
+ if (workflow === "debug") {
523
+ rows.forEach((stepRow, position) => {
524
+ if (stepRow.type === "step-done" &&
525
+ stepRow.workflow === "debug" &&
526
+ stepRow.step === "context-fetch") {
527
+ const prior = rows.slice(0, position);
528
+ const previous = prior
529
+ .map((r, i) => (r.type === "step-done" || r.type === "workflow-started" ? i : -1))
530
+ .filter((i) => i >= 0)
531
+ .at(-1) ?? -1;
532
+ const start = prior
533
+ .map((r, i) => (r.type === "workflow-started" ? i : -1))
534
+ .filter((i) => i >= 0)
535
+ .at(-1) ?? -1;
536
+ const history = prior.slice(start + 1);
537
+ const meta = [...history]
538
+ .reverse()
539
+ .find((r) => r.type === "workflow-meta" && r.workflow === "debug" && r.ciSelection !== undefined);
540
+ const ci = history.some((r) => r.type === "test-run" &&
541
+ r.workflow === "debug" &&
542
+ ciRoundMatches(r, meta?.ciSelection, meta?.ciGeneration));
543
+ if (ci &&
544
+ !prior
545
+ .slice(previous + 1)
546
+ .some((r) => r.type === "engine-call" && r.noun === "context" && r.verb === "fetch"))
547
+ evidenceHoles.push({
548
+ step: "context-fetch",
549
+ number: unitOf.get("context-fetch")?.number ?? 2,
550
+ index: 1,
551
+ missing: [{ noun: "context", verb: "fetch", flags: ["context"] }],
552
+ });
553
+ }
554
+ if (stepRow.type !== "step-done" ||
555
+ stepRow.workflow !== "debug" ||
556
+ stepRow.step !== "debug-run-tests" ||
557
+ stepRow.source !== "ci")
558
+ return;
559
+ const prior = rows.slice(0, position);
560
+ const start = prior
561
+ .map((r, i) => (r.type === "workflow-started" ? i : -1))
562
+ .filter((i) => i >= 0)
563
+ .at(-1) ?? -1;
564
+ const history = prior.slice(start + 1).reverse();
565
+ const meta = history.find((r) => r.type === "workflow-meta" && r.workflow === "debug" && r.ciSelection !== undefined);
566
+ const round = history.find((r) => r.type === "test-run" &&
567
+ r.workflow === "debug" &&
568
+ r.step === "debug-run-tests" &&
569
+ r.attempt === stepRow.attempt);
570
+ if (!round ||
571
+ !ciRoundMatches(round, meta?.ciSelection, meta?.ciGeneration) ||
572
+ stepRow.scope !== round.scope ||
573
+ stepRow.verdict !== "FAIL" ||
574
+ stepRow.ciGeneration !== meta?.ciGeneration ||
575
+ !Array.isArray(stepRow.artifacts) ||
576
+ !stepRow.artifacts.includes(round.artifact))
577
+ evidenceHoles.push({
578
+ step: "debug-run-tests",
579
+ number: unitOf.get("debug-run-tests")?.number ?? 1,
580
+ index: 1,
581
+ missing: [{ noun: "tests", verb: "run", flags: ["ci-run"] }],
582
+ });
583
+ });
584
+ }
585
+ const occurrence = new Map();
586
+ const exercised = new Map();
587
+ for (const v of visits) {
588
+ const index = (occurrence.get(v.unit) ?? 0) + 1;
589
+ occurrence.set(v.unit, index);
590
+ const beforeJournal = firstCall !== -1 && v.rows.every((r) => r < firstCall);
591
+ if (beforeJournal)
592
+ continue;
593
+ const got = owned.get(v) ?? new Set();
594
+ // A visit whose own row-writing call (`steps finish` / `steps done`) left no journaled
595
+ // call is judged on its step row alone: the journal did not see this visit's commands.
596
+ // A writer outside the journal window is never required, so there a visit with no
597
+ // journaled call at all is judged the same way.
598
+ const isWriter = (k) => k === "steps finish" || k === "steps done";
599
+ const writerInWindow = v.unit.calls.some((c) => !c.branch && isWriter(callKey(c)));
600
+ if (writerInWindow ? ![...got].some(isWriter) : got.size === 0)
601
+ continue;
602
+ const pool = exercised.get(v.unit) ?? new Set();
603
+ for (const k of got)
604
+ pool.add(k);
605
+ exercised.set(v.unit, pool);
606
+ const rowsOf = v.rows.map((i) => items[i]).flatMap((x) => (x?.kind === "step" ? [x.row] : []));
607
+ const done = rowsOf.some((r) => r.status === undefined || r.status === "DONE");
608
+ if (preJournal || !done)
118
609
  continue;
610
+ const missing = new Map();
611
+ for (const c of v.unit.calls) {
612
+ if (!c.branch && !got.has(callKey(c)) && !missing.has(callKey(c))) {
613
+ missing.set(callKey(c), { noun: c.noun, verb: c.verb, flags: c.flags });
614
+ }
119
615
  }
120
- if (inStep) {
121
- let m;
122
- const re = /(?:step:"|--step=)(ship-[a-z-]+)/g;
123
- while ((m = re.exec(line)) !== null) {
124
- headingSet.add(m[1]);
616
+ if (missing.size === 0)
617
+ continue;
618
+ const group = rowsOf.map((r) => r["group"]).find((g) => typeof g === "number");
619
+ evidenceHoles.push({
620
+ step: rowsOf[0]?.step ?? v.unit.keys[0] ?? "",
621
+ number: v.unit.number,
622
+ index,
623
+ ...(typeof group === "number" ? { group } : {}),
624
+ missing: [...missing.values()],
625
+ });
626
+ }
627
+ const unexercised = [];
628
+ if (!preJournal) {
629
+ for (const u of units) {
630
+ const pool = exercised.get(u);
631
+ if (pool === undefined)
632
+ continue;
633
+ const required = new Set(u.calls.filter((c) => !c.branch).map(callKey));
634
+ const reported = new Set();
635
+ for (const c of u.calls) {
636
+ const k = callKey(c);
637
+ if (c.branch && !required.has(k) && !pool.has(k) && !reported.has(k)) {
638
+ reported.add(k);
639
+ unexercised.push({ step: u.keys[0] ?? "", call: { noun: c.noun, verb: c.verb } });
640
+ }
125
641
  }
126
- re.lastIndex = 0;
127
642
  }
128
643
  }
129
- // 3. Union + the one asymmetry that carries signal (see the docstring).
130
- const all = new Set([...literalSet, ...headingSet]);
131
- const orphanSteps = [...literalSet].filter((s) => !headingSet.has(s)).sort();
644
+ const observed = new Set(items.flatMap((i) => (i.kind === "step" ? [i.key] : [])));
645
+ const closed = observed.has(`${workflow}-close-workflow`);
646
+ const failed = own.some((r) => r.type === "workflow-failed");
647
+ const lastNumber = Math.max(0, ...visits.map((v) => v.unit.number));
648
+ const stepHoles = units
649
+ .filter((u) => !u.conditional && !u.keys.some((k) => observed.has(k)))
650
+ .filter((u) => closed || (failed && u.number < lastNumber))
651
+ .map((u) => u.keys[0]);
652
+ const unexpected = [
653
+ ...[...observed]
654
+ .filter((k) => !unitOf.has(k) && !pauseRows.has(k))
655
+ .sort()
656
+ .map((step) => ({ step })),
657
+ ...(preJournal ? [] : unexpectedCalls.values()),
658
+ ];
659
+ const holey = evidenceHoles.length > 0 || stepHoles.length > 0;
132
660
  return {
133
- steps: [...all].sort(),
134
- headingSteps: [...headingSet].sort(),
135
- literalSteps: [...literalSet].sort(),
136
- orphanSteps,
661
+ workflow,
662
+ verdict: holey ? "HOLEY" : "CLEAN",
663
+ holey,
664
+ preJournal,
665
+ journalSuspect: preJournal && options.journalSuspect === true,
666
+ observed: { steps: stepRowCount, calls: callCount },
667
+ evidenceHoles,
668
+ stepHoles,
669
+ unexercised,
670
+ unexpected,
671
+ unattributable: [...unattributable.values()],
672
+ sourceSha: contract.sourceSha,
673
+ workflowCalls: workflowCalls.map((c) => ({ noun: c.noun, verb: c.verb })),
137
674
  };
138
675
  }
139
676
  /**
140
- * Cross-check the source-derived set against the frozen canonical set.
141
- * Returns the keys that disagree (present in one but not the other).
677
+ * The verdict of a run: its last stored `completeness` row, recomputed when a
678
+ * `step-done` or `engine-call` row follows it (the closing `workflow-done` row and
679
+ * the `completeness` verb's own journal row do not).
142
680
  */
143
- export function checkSourceCanonicalDrift(sourceSteps) {
144
- const sourceSet = new Set(sourceSteps);
145
- const canonicalSet = new Set(SHIP_STEP_ORDER);
146
- const drift = [];
147
- for (const k of canonicalSet)
148
- if (!sourceSet.has(k))
149
- drift.push(`canonical-but-not-source:${k}`);
150
- for (const k of sourceSet)
151
- if (!canonicalSet.has(k))
152
- drift.push(`source-but-not-canonical:${k}`);
153
- return drift;
681
+ export function readCompleteness(rows, contract, options = {}) {
682
+ const own = rows.filter((r) => r.workflow === contract.workflow);
683
+ const at = own.map((r) => r.type).lastIndexOf("completeness");
684
+ const stored = at === -1 ? undefined : own[at];
685
+ const followed = own
686
+ .slice(at + 1)
687
+ .some((r) => r.type === "step-done" || (r.type === "engine-call" && r["noun"] !== SELF_NOUN));
688
+ if (!stored || followed)
689
+ return { verdict: check(rows, contract, options), source: "computed" };
690
+ const list = (key) => Array.isArray(stored[key]) ? stored[key] : [];
691
+ const holey = stored["verdict"] === "HOLEY";
692
+ const observed = stored["observed"];
693
+ return {
694
+ source: "stored",
695
+ verdict: {
696
+ workflow: contract.workflow,
697
+ verdict: holey ? "HOLEY" : "CLEAN",
698
+ holey,
699
+ preJournal: stored["preJournal"] === true,
700
+ journalSuspect: stored["journalSuspect"] === true,
701
+ observed: observed ?? { steps: 0, calls: 0 },
702
+ evidenceHoles: list("evidenceHoles"),
703
+ stepHoles: list("stepHoles"),
704
+ unexercised: list("unexercised"),
705
+ unexpected: list("unexpected"),
706
+ unattributable: list("unattributable"),
707
+ sourceSha: typeof stored["sourceSha"] === "string" ? stored["sourceSha"] : "",
708
+ workflowCalls: list("workflowCalls"),
709
+ },
710
+ };
154
711
  }
155
712
  // ---------------------------------------------------------------------------
156
713
  // Run classification + path-conditional expected sets
@@ -206,6 +763,9 @@ export function computeMandatoryForPath(path, sourceUniverse) {
206
763
  case "MERGED_ON_ENTRY":
207
764
  // Skip the entire middle + retry-loop steps
208
765
  return new Set([...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s) && !RETRY_LOOP_STEPS.has(s)));
766
+ case "COMPLETED":
767
+ // Non-ship runs derive their mandatory set from the contract (auditRun)
768
+ return new Set(universe);
209
769
  case "ABORTED":
210
770
  // No mandatory steps — the run terminated; post-abort absences are expected
211
771
  return new Set();
@@ -262,13 +822,9 @@ export function detectHoles(observed, sourceUniverse, path) {
262
822
  return { missing, unexpected };
263
823
  }
264
824
  // ---------------------------------------------------------------------------
265
- // Full audit — parse status.jsonl + ship md, classify, detect, report
825
+ // Full audit — parse status.jsonl + workflow md, classify, detect, report
266
826
  // ---------------------------------------------------------------------------
267
- export function auditStatusJsonl(statusJsonl, shipMd) {
268
- // Derive expected set from source
269
- const { steps: sourceUniverse, orphanSteps } = deriveExpectedStepSetFromSource(shipMd);
270
- const sourceCanonicalDrift = checkSourceCanonicalDrift(sourceUniverse);
271
- // Parse status rows
827
+ export function parseRows(statusJsonl) {
272
828
  const rows = [];
273
829
  for (const line of statusJsonl.split("\n")) {
274
830
  const trimmed = line.trim();
@@ -279,35 +835,94 @@ export function auditStatusJsonl(statusJsonl, shipMd) {
279
835
  if (row.ok)
280
836
  rows.push(row.value);
281
837
  }
282
- // Filter to ship step-done rows + workflow-failed rows
283
- const shipStepRows = rows.filter((r) => r.type === "step-done" && r.workflow === "ship" && typeof r.step === "string");
284
- const hasWorkflowFailed = rows.some((r) => r.type === "workflow-failed" && r.workflow === "ship");
285
- const hasMergedOnEntryMarker = rows.some((r) => r.type === "ship-merged-on-entry" && r.workflow === "ship");
286
- // Collect observed steps
838
+ return rows;
839
+ }
840
+ /** Audit one run's rows against the contract derived from its workflow markdown. */
841
+ export function auditRun(rows, workflow, workflowMd) {
842
+ const contract = deriveContract(workflowMd, workflow);
843
+ const stepRows = rows.filter((r) => r.type === "step-done" && r.workflow === workflow && typeof r.step === "string");
844
+ const hasWorkflowFailed = rows.some((r) => r.type === "workflow-failed" && r.workflow === workflow);
287
845
  const observed = new Set();
288
- for (const r of shipStepRows) {
846
+ for (const r of stepRows)
289
847
  if (r.step)
290
848
  observed.add(r.step);
849
+ const sorted = [...observed].sort();
850
+ const side = new Set([...contract.pauseRows, ...contract.subRows]);
851
+ if (workflow === "ship") {
852
+ const hasMergedOnEntryMarker = rows.some((r) => r.type === "ship-merged-on-entry" && r.workflow === "ship");
853
+ const runPath = classifyRun(observed, hasWorkflowFailed, hasMergedOnEntryMarker);
854
+ const { missing, unexpected } = detectHoles(observed, contract.universe, runPath);
855
+ return {
856
+ workflow,
857
+ missing,
858
+ unexpected: unexpected.filter((k) => !side.has(k)),
859
+ path: runPath,
860
+ observed: sorted,
861
+ sourceUniverse: contract.universe,
862
+ sourceCanonicalDrift: contract.drift,
863
+ orphanSteps: contract.orphanSteps,
864
+ };
291
865
  }
292
- // Classify + detect
293
- const runPath = classifyRun(observed, hasWorkflowFailed, hasMergedOnEntryMarker);
294
- const { missing, unexpected } = detectHoles(observed, sourceUniverse, runPath);
866
+ const closeKey = `${workflow}-close-workflow`;
867
+ const runPath = observed.has(closeKey)
868
+ ? "COMPLETED"
869
+ : hasWorkflowFailed
870
+ ? "ABORTED"
871
+ : "IN_PROGRESS";
872
+ const missing = runPath === "COMPLETED"
873
+ ? contract.steps
874
+ .filter((s) => s.keys.length > 0 && !s.conditional && !s.keys.some((k) => observed.has(k)))
875
+ .map((s) => s.keys[0])
876
+ .sort()
877
+ : [];
295
878
  return {
879
+ workflow,
296
880
  missing,
297
- unexpected,
881
+ unexpected: sorted.filter((k) => !contract.universe.includes(k) && !side.has(k)),
298
882
  path: runPath,
299
- observed: [...observed].sort(),
300
- sourceUniverse: [...sourceUniverse].sort(),
301
- sourceCanonicalDrift,
302
- orphanSteps,
883
+ observed: sorted,
884
+ sourceUniverse: contract.universe,
885
+ sourceCanonicalDrift: contract.drift,
886
+ orphanSteps: contract.orphanSteps,
303
887
  };
304
888
  }
889
+ /** `workflow`'s rows split into runs: each `workflow-started` opens a run that ends at the next one; rows before the first start form their own run. */
890
+ export function runsOf(rows, workflow) {
891
+ const at = (r) => (typeof r["at"] === "string" ? r["at"] : "");
892
+ const own = rows
893
+ .filter((r) => r.workflow === workflow)
894
+ .sort((a, b) => (at(a) < at(b) ? -1 : at(a) > at(b) ? 1 : 0));
895
+ const runs = [];
896
+ for (const row of own) {
897
+ const current = runs.at(-1);
898
+ if (current === undefined || row.type === "workflow-started")
899
+ runs.push([row]);
900
+ else
901
+ current.push(row);
902
+ }
903
+ return runs;
904
+ }
905
+ /** Audit a status.jsonl as a ship run against `shipMd`. */
906
+ export function auditStatusJsonl(statusJsonl, shipMd) {
907
+ return auditRun(parseRows(statusJsonl), "ship", shipMd);
908
+ }
909
+ /** The workflows a status.jsonl holds runs of, inferred from its own rows. */
910
+ export function inferWorkflows(rows) {
911
+ const known = new Set(Object.keys(WORKFLOW_STEPS));
912
+ const found = new Set();
913
+ for (const r of rows)
914
+ if (typeof r.workflow === "string" && known.has(r.workflow))
915
+ found.add(r.workflow);
916
+ return [...found].sort();
917
+ }
305
918
  // ---------------------------------------------------------------------------
306
919
  // Advisory report formatter
307
920
  // ---------------------------------------------------------------------------
308
921
  export function formatAdvisoryReport(report) {
309
922
  const lines = [];
310
923
  lines.push("[bkit-status-holes] ADVISORY — fail-open (exit 0 regardless)");
924
+ if (report.workflow)
925
+ lines.push(` workflow: ${report.workflow}`);
311
926
  lines.push(` path: ${report.path}`);
312
927
  lines.push(` observed: ${report.observed.length} step(s)`);
313
928
  if (report.sourceCanonicalDrift.length > 0) {
@@ -334,34 +949,26 @@ export function formatAdvisoryReport(report) {
334
949
  // CLI entry — always exits 0 (advisory / fail-open)
335
950
  // ---------------------------------------------------------------------------
336
951
  export function main(argv) {
337
- const args = argv.slice(2);
338
- // Resolve the ship-md override FIRST so its VALUE is never mistaken for a
339
- // positional. `args.find(a => !a.startsWith("--"))` alone picks up the value
340
- // of `--ship-md` when the flag is passed before the status path.
341
- const mdFlagIdx = args.indexOf("--ship-md");
342
- const shipMdOverride = mdFlagIdx >= 0 ? args[mdFlagIdx + 1] : undefined;
343
- const consumed = new Set();
344
- if (mdFlagIdx >= 0) {
345
- consumed.add(mdFlagIdx);
346
- if (shipMdOverride)
347
- consumed.add(mdFlagIdx + 1);
348
- }
349
- // Every remaining positional is a status.jsonl to audit — one report each, so
350
- // a whole corpus can be swept in one advisory CI step.
351
- const statusPaths = args.filter((a, i) => !consumed.has(i) && !a.startsWith("--"));
952
+ // Every positional is a status.jsonl to audit — one report per run of each
953
+ // workflow in each file, so a whole corpus can be swept in one advisory CI step.
954
+ const statusPaths = argv.slice(2).filter((a) => !a.startsWith("--"));
352
955
  if (statusPaths.length === 0) {
353
956
  process.stdout.write("[bkit-status-holes] no status.jsonl path given — skipping (advisory)\n");
354
957
  return; // exit 0
355
958
  }
356
- const shipMdPath = shipMdOverride || path.join(getWorkflowsRoot(), "bkit-ship.md");
357
- let shipMd = "";
358
- try {
359
- shipMd = fs.readFileSync(shipMdPath, "utf-8");
360
- }
361
- catch {
362
- process.stdout.write(`[bkit-status-holes] ${shipMdPath} not found — skipping (advisory)\n`);
363
- return; // exit 0
364
- }
959
+ const mdCache = new Map();
960
+ const loadMd = (workflow) => {
961
+ if (!mdCache.has(workflow)) {
962
+ try {
963
+ mdCache.set(workflow, fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"));
964
+ }
965
+ catch {
966
+ mdCache.set(workflow, null);
967
+ }
968
+ }
969
+ return mdCache.get(workflow) ?? null;
970
+ };
971
+ let holeyRuns = 0;
365
972
  for (const statusPath of statusPaths) {
366
973
  // Read inputs (advisory — missing files = skip, never fail)
367
974
  let statusJsonl = "";
@@ -372,10 +979,28 @@ export function main(argv) {
372
979
  process.stdout.write(`[bkit-status-holes] ${statusPath} not found — skipping (advisory)\n`);
373
980
  continue; // exit 0
374
981
  }
375
- const report = auditStatusJsonl(statusJsonl, shipMd);
982
+ const rows = parseRows(statusJsonl);
983
+ const workflows = inferWorkflows(rows);
376
984
  process.stdout.write(`\n${statusPath}\n`);
377
- process.stdout.write(formatAdvisoryReport(report) + "\n");
985
+ if (workflows.length === 0) {
986
+ process.stdout.write(`[bkit-status-holes] ${statusPath}: no workflow rows — skipping (advisory)\n`);
987
+ continue;
988
+ }
989
+ for (const workflow of workflows) {
990
+ const md = loadMd(workflow);
991
+ if (md === null) {
992
+ process.stdout.write(`[bkit-status-holes] bkit-${workflow}.md not found — skipping ${workflow} run (advisory)\n`);
993
+ continue;
994
+ }
995
+ for (const run of runsOf(rows, workflow)) {
996
+ const report = auditRun(run, workflow, md);
997
+ if (report.missing.length > 0)
998
+ holeyRuns += 1;
999
+ process.stdout.write(formatAdvisoryReport(report) + "\n");
1000
+ }
1001
+ }
378
1002
  }
1003
+ process.stdout.write(`[bkit-status-holes] sweep: ${statusPaths.length} file(s), ${holeyRuns} holey\n`);
379
1004
  // ALWAYS exit 0 — this is advisory / fail-open
380
1005
  }
381
1006
  // Run if invoked directly (ESM-compatible main-module detection)