@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # Annotations Triage
8
8
 
9
9
  > [!CAUTION]
@@ -11,142 +11,144 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Read-only audit; never edit code, config, or data.
15
- > - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
16
- > - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
17
- > - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
18
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
19
- > - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
20
- > - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
21
- > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
- > - never edit a workflow, composite action, or other CI config; a recommended change is a finding for a human.
14
+ > - Do not edit a workflow, composite action or other CI config.
15
+ > - Record a recommended CI change as a finding for a human.
23
16
  > - NEVER dispatch a workflow, push, or otherwise start a run to verify a fix.
24
17
 
25
18
  ## Universal Instructions
26
19
 
27
20
  ### Context & Goals
28
21
 
29
- Green CI hides costly warnings. Two failure modes: step success while the operation was refused, skipped, or ignored (annotation was the only signal); deprecation with a deadline stays green until runtime/API removal — CI red on a date nobody chose.
22
+ Green CI hides costly warnings. The failure this audit targets takes two forms. In the first, a step succeeds while the operation it ran was refused, skipped or ignored, and the annotation was the only signal. In the second, a deprecation with a deadline stays green until the runtime or API is removed, and CI goes red on a date nobody chose.
30
23
 
31
- **Applies when:** CI emits annotations, warnings, or notices (e.g. GitHub Actions check-run annotations, GitLab code-quality reports, Buildkite annotations). None → one `N/A` row with evidence, never "clean".
24
+ **Applies when:** CI emits annotations, warnings or notices (e.g., GitHub Actions check-run annotations, GitLab code-quality reports, Buildkite annotations). **If** it emits none → write one `N/A` row with its evidence, and never report the surface as "clean".
32
25
 
33
- **Cadence:** weekly, and before every release to the production branch. In-passing sweeps are not a control. Extra pass when: CI-vendor deprecation/retirement post or runner-image announcement touches these workflows; workflow, composite action, or reusable workflow changes (conditional lane annotates only when it runs); deprecation deadline before next weekly sweep.
26
+ **Cadence:** Run once a week, and before every release to the production branch. Sweeps done in passing are not a control. Run an extra pass when a CI-vendor deprecation or retirement post, or a runner-image announcement, touches these workflows; when a workflow, composite action or reusable workflow changes, because a conditional lane annotates only when it runs; and when a deprecation deadline falls before the next weekly sweep.
34
27
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
28
+ **Anchor Standards:**
36
29
 
37
- - CI vendor changelog, deprecation, and retirement posts (e.g. GitHub Changelog deprecation label). Living; record the date read.
38
- - Runner-image announcements (e.g. `actions/runner-images` Announcement label). Living; record the date read.
39
- - Workflow command reference, including deprecated commands (e.g. GitHub `set-output`, `save-state`, `set-env`, `add-path`).
40
- - Problem matchers and annotation limits (e.g. `actions/toolkit` problem matchers; per-step and per-job caps).
41
- - Workflow static analysers (e.g. actionlint, zizmor); record versions.
42
- - Deprecated-API lint (e.g. typescript-eslint `no-deprecated`); record the version in the lockfile.
30
+ - CI vendor changelog, deprecation, and retirement posts (e.g., GitHub Changelog deprecation label). These are living pages; record the date read.
31
+ - Runner-image announcements (e.g., `actions/runner-images` Announcement label). These are living pages; record the date read.
32
+ - Workflow command reference, including deprecated commands (e.g., GitHub `set-output`, `save-state`, `set-env`, `add-path`).
33
+ - Problem matchers and annotation limits (e.g., `actions/toolkit` problem matchers; per-step and per-job caps).
34
+ - Workflow static analysers (e.g., actionlint, zizmor). Record their versions.
35
+ - Deprecated-API lint (e.g., typescript-eslint `no-deprecated`). Record the version in the lockfile.
43
36
 
44
37
  ### Scope
45
38
 
46
- - Annotations and notices on recent runs of every workflow, including scheduled, manual, and bot-triggered. Not one pipeline.
47
- - Deprecation notices in the vendor changelog before they annotate.
48
- - Action and runtime inventory, including leftover opt-out env keys.
49
- - Log lines that never become annotations (deprecations, outdated CLIs).
50
- - Workflow static analysis, and deprecated workflow commands a conditional lane hides.
51
- - One verdict per annotation. Root cause for each silent failure.
52
- - Which node a lint warning actually trips. Problem matchers so lint output becomes annotations.
53
- - What was verified locally, and what still needs a real run.
39
+ - Read the annotations and notices on recent runs of every workflow, including scheduled, manual and bot-triggered runs, not just one pipeline.
40
+ - Read deprecation notices in the vendor changelog before they show up as annotations.
41
+ - Inventory actions and runtimes, including leftover opt-out env keys.
42
+ - Read log lines that never become annotations (deprecations, outdated CLIs).
43
+ - Run workflow static analysis, and find deprecated workflow commands that a conditional lane hides.
44
+ - Give one verdict per annotation.
45
+ - Find the root cause of each silent failure.
46
+ - Find which node a lint warning actually trips.
47
+ - Check that problem matchers turn lint output into annotations.
48
+ - Record what was verified locally, and what still needs a real run.
54
49
 
55
50
  ### Out of Scope
56
51
 
57
52
  <!-- prettier-ignore -->
58
53
  | Excluded item | Why | Where it belongs |
59
54
  | --- | --- | --- |
60
- | Runtime errors, and log lines that are not annotations or deprecation warnings | Log sweep | `bkit-audit-logs` |
61
- | Flaky tests | Flake sweep | `bkit-audit-flakes` |
62
- | Whether a static-analysis hit is exploitable | Security sweep | `bkit-audit-security` |
63
- | Applying fixes / changing workflows | Audit reports only | Plan from this report |
55
+ | Runtime errors, and log lines that are not annotations or deprecation warnings | The log sweep owns them | `bkit-audit-logs` |
56
+ | Flaky tests | The flake sweep owns them | `bkit-audit-flakes` |
57
+ | Whether a static-analysis hit is exploitable | The security sweep owns it | `bkit-audit-security` |
58
+ | Applying fixes; changing workflows | The audit only reports | A plan made from this report |
64
59
 
65
60
  ### Verdicts
66
61
 
67
- One per annotation. **SILENT FAILURE** outranks every other verdict.
62
+ Give each annotation one verdict. **SILENT FAILURE** outranks every other verdict.
68
63
 
69
- - **SILENT FAILURE:** step reported success, but annotation says operation was refused, skipped, or ignored. Report names root cause. Fix is next step.
70
- - **DEPRECATION:** action, runtime, or API with announced end date. Report names date and bump. Scheduling is next step.
71
- - **LINT WARNING:** real warning pointing at code. Report says fix, or why it stands. Do not edit the code here.
72
- - **DEAD SUPPRESSION:** disable comment with nothing left to disable. Report says delete it, and whether it sat on the wrong node. Do not delete it here.
73
- - **ACCEPTED:** known, and already recorded. Say where, and skip.
74
- - **OTHER:** fits none. Resolve to one of the above if you can; otherwise say what it is and why it fits none. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
64
+ - **SILENT FAILURE:** the step reported success, but the annotation says the operation was refused, skipped or ignored. The report names the root cause, and the fix is the next step.
65
+ - **DEPRECATION:** an action, runtime or API has an announced end date. The report names the date and the bump, and scheduling it is the next step.
66
+ - **LINT WARNING:** a real warning that points at code. The report says the fix, or why the warning stands. Do not edit the code here.
67
+ - **DEAD SUPPRESSION:** a disable comment with nothing left to disable. The report says to delete it, and whether it sat on the wrong node. Do not delete it here.
68
+ - **ACCEPTED:** the annotation is known and already recorded. Say where, and skip it.
69
+ - **OTHER:** it fits no other verdict. Resolve to one of the above if you can; otherwise say what it is and why it fits none. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
75
70
 
76
71
  ### Pre-Flight / Dependencies
77
72
 
78
- **Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
79
-
80
- **Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
81
-
82
73
  #### Core
83
74
 
84
- Always verify.
85
-
86
- - [ ] **Permissions:** Before Step 1 — one cheap read-only call per tool this run uses (every item below, every rule under `Project Instructions` `Permissions`), e.g. `gh run list --limit 1`, one MCP read, one anchor-standard fetch. Blocked / denied (here or in any step) → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`; run every step the remaining tools allow; work needing blocked call → `Not Checked`. never stop the run for a blocked call; never retry or reword a blocked call to get past it.
87
- - [ ] **CI Read:** Steps 2, 5, 11 — annotations and step logs for recent runs of every workflow, e.g. `gh api` check-run annotations, `gh run view --log`, GitLab job-trace API. Log access: `.agents/context.md` `context-fetch` blocks below `bkit:end` are ready-made read-only readers (`bkit context list-blocks` → each block's `context` and `body`); set a body's `# Customise:` knobs to the audit window; run it via `direnv exec . bash`. Fallback: saved logs; runs not fetched `Not Checked`.
88
- - [ ] **Workflow Files:** Steps 4, 6, 8 — workflows, composite actions, reusable workflows on disk. Fallback: none.
89
- - [ ] **Web:** Steps 3, 12 — vendor changelog, runner-image announcements, anchor standards. Fallback: versions recorded as unread.
75
+ - [ ] **Permissions:** every blocked call is recorded.
76
+ - [ ] **CI Read:** Steps 2, 5, 11 — annotations and step logs for recent runs of every workflow (e.g., `gh api` check-run annotations, `gh run view --log`, GitLab job-trace API). Log access: the `context-fetch` blocks below `bkit:end` in `.agents/context.md` are ready-made read-only readers. `bkit context list-blocks` prints each block's `context` and `body`. Set a body's `# Customise:` knobs to the audit window, and run it with `direnv exec . bash`. Fallback: read saved logs, and mark the runs not fetched `Not Checked`.
77
+ - [ ] **Workflow Files:** Steps 4, 6, 8 — the workflows, composite actions and reusable workflows on disk. Fallback: none.
78
+ - [ ] **Web:** Steps 3, 12 — the vendor changelog, runner-image announcements and anchor standards. Fallback: record the versions as unread.
90
79
 
91
80
  #### Conditional
92
81
 
93
- Verify only when applicable.
94
-
95
- - [ ] **Workflow Linters:** Workflows on disk → Step 6 — e.g. actionlint, zizmor, shellcheck. Fallback: read the workflows; name each check skipped.
96
- - [ ] **Language Server:** Typed language and a lint annotation → Step 9 — per-file diagnostics, e.g. Serena, `tsserver`. Fallback: lint that file; say so. Empty is inconclusive; corroborate with text search.
97
- - [ ] **Deprecated-API Lint:** Typed language → Step 10 — e.g. `@typescript-eslint/no-deprecated`. Fallback: text search for known deprecated calls; under-count recorded.
82
+ - [ ] **Workflow Linters:** **If** workflows are on disk → Step 6 (e.g., actionlint, zizmor, shellcheck). Fallback: read the workflows, and name each check skipped.
83
+ - [ ] **Language Server:** **If** the language is typed **and** there is a lint annotation → Step 9 — per-file diagnostics (e.g., Serena, `tsserver`). Fallback: lint that file, and say so. An empty language-server result is inconclusive, so corroborate it with text search.
84
+ - [ ] **Deprecated-API Lint:** **If** the language is typed → Step 10 (e.g., `@typescript-eslint/no-deprecated`). Fallback: text search for known deprecated calls, and record the under-count.
98
85
 
99
86
  ### 🔒 Gate 1: Prerequisites Check
100
87
 
101
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
102
-
103
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
104
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
88
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
89
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
105
90
 
106
91
  ### Probe Steps
107
92
 
108
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
109
- - [ ] **Step 2 — Collect:** No CI → one `N/A` row with evidence and STOP. Else read annotation lists for recent runs of every workflow, not last run of one pipeline. Deprecations surface on whichever workflow uses the old action. Include scheduled, manual, and bot-triggered runs. Collect mechanically, not by eye from the UI. Window = since previous report, and at least latest completed run of each workflow. Save list; diff vs previous report: new, resolved, persisting. Annotations capped (e.g. GitHub: 10 warnings, 10 errors, and 10 notices per step, and 50 per job). Step at cap → grep raw job log for warning and error markers; triage overflow. Record run ids and commit. Id, run, or path you cannot re-open → do not cite it. **Done when:** `Annotations` holds diff (new, resolved, persisting) and run ids.
110
- - [ ] **Step 3 — Deprecations:** Read vendor deprecation/retirement posts and runner-image announcements since previous report. List every dated change touching these workflows: runtimes, runner images, events, actions. Changelog notice precedes run notice. Each → DEPRECATION with date and bump. Dependency bot already tracks bump → say so; schedule rest next step. **Done when:** `Deprecations` row per dated change: what · date · bump · bot already tracking?
111
- - [ ] **Step 4 — Runtimes:** Every `uses:` (or the CI system's equivalent) in workflows, local composite actions, and reusable workflows — resolved version and declared runtime (e.g. `runs.using`). Action declaring removed runtime (e.g. `node20` after runners dropped it) runs on forced runtime with no opt-out → finding, unless seen working there. List leftover opt-out env keys that no longer change anything. **Done when:** `Runtimes` row per action: version · declared runtime · verdict, plus leftover keys.
112
- - [ ] **Step 5 — Log Warnings:** Some deprecations print only to log. Grep same runs' step logs for deprecation markers (e.g. `DeprecationWarning`, `[DEP0`, `npm warn deprecated`, `WARN deprecated`, `will be removed`) and CLI outdated notices (e.g. EAS, Expo, Vercel). Verdict each as if annotation. Agree with `bkit-audit-logs` which sweep owns each line — triage once. **Done when:** `Log Warnings` row per line: verdict or owning sweep.
113
- - [ ] **Step 6 — Static Analysis:** Run workflow linters every sweep, not only to verify a fix. Each new finding = annotation: shell issues in `run:` blocks, expression typos, template injection, excessive permissions, unpinned `uses:`. Grep workflows/scripts for deprecated workflow commands (e.g. GitHub Actions `::set-output`, `::save-state`, `::set-env`, `::add-path`) and opt-in re-enabling them (e.g. `ACTIONS_ALLOW_UNSECURE_COMMANDS`). Runner warns on some only at execute — conditional lane hides them. **Done when:** `Static Analysis` row per finding with verdict.
114
- - [ ] **Step 7 — Classify:** One verdict each from `Verdicts`. SILENT FAILURE on sight, e.g. GitHub `Unexpected input(s) '…', valid inputs are …` (misspelled input key, ignored); `No files were found with the provided path` (artifact never uploaded). No forced fit → OTHER. Destinations (next step; this run does not send; the audit agent writes `docs/failures.jsonl` rows): real defect → `docs/failures.jsonl` row; SILENT FAILURE → root cause, fix, guard (`Silent Failures`); DEPRECATION → date and bump, dependency bot first; LINT WARNING → fix or why it stands; DEAD SUPPRESSION → delete directive, wrong-node flag; flake → `bkit-audit-flakes`; runtime error or log-sweep line → `bkit-audit-logs`; standing rule → sentence for testing or deployments doc; workflow change → recommendation needing explicit human confirmation; ACCEPTED → nothing, cite record. **Done when:** every annotation in `Annotations` has verdict and destination.
115
- - [ ] **Step 8 — Silent Failures:** Root-cause each SILENT FAILURE vs runner rules. Annotation = platform vocabulary symptom. Examples (GitHub Actions): `$GITHUB_ENV` blocklists some names (`NODE_OPTIONS` among them) — set as static job-level `env:` keys; `env` context unavailable to job-level `env:` value → shortened form resolves empty, fails quiet; step-level `env:` replaces job-level map (no merge) — overriding one key restates others; managed blocks revert in-marker edits — check key inside managed marker before recommending move. Other CI → equivalent (masked variables, non-merging env, platform-rewritten config). Report names guard fix should carry, proven red by reintroducing bug; where deleting mechanism leaves lane quiet and knob-less → second guard that replacement knob exists. Writing fix = next step. **Done when:** `Silent Failures` names root cause, fix, guard for each.
116
- - [ ] **Step 9 — Lint Node:** Lint annotation or in-code suppression → node rule fires on; count change if directive removed. Reason from per-file diagnostics; do not edit; do not whole-repo typecheck/lint for one file. Language server = one language; workflow files = text search. Dead disable at annotation line with effect further down (comment only) → DEAD SUPPRESSION on wrong node (live rule = LINT WARNING). **Done when:** `Lint` row per warning: node · directive · verdict.
117
- - [ ] **Step 10 — Matchers:** Problem matchers or annotation reporters for typecheck, lint, test output in CI (e.g. `tsc`, ESLint, Vitest). Without them warnings stay in logs — LINT WARNING under-counted. Confirm deprecated-API lint enabled (e.g. `@typescript-eslint/no-deprecated`). Deprecated framework API calls = code-side same deadline. **Done when:** `Matchers` names each reporter and deprecated-API rule: present or absent.
118
- - [ ] **Step 11 — Verified:** Green run does not verify fix to conditional lane. Marker-gated lane needs run carrying marker — deliberate workflow dispatch, not push. State local verification (workflow linters, YAML parse, guard tests, per-file diagnostics) vs still needs real run. Do not dispatch. **Done when:** `Verified` splits local vs still needs a run.
119
- - [ ] **Step 12 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: row per deprecation/retirement announcement in window, deprecated workflow command, linter check class → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
120
- - [ ] **Step 13 — Anything Else:** (a) Everything changed since previous report's commit touching CI signal (workflows, composite actions, reusable workflows, `uses:` pins, runner images, workflow and step `env:` keys, lint config) → one-line verdict each. (b) Bounded ~30 min pass: what senior CI platform engineer flags that no step asks; read since previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
93
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
94
+ - [ ] **Step 2 — Collect:** **If** there is no CI → write one `N/A` row with evidence, then **STOP**. **Else** → read the annotation lists for recent runs of every workflow, not the last run of one pipeline, because deprecations surface on whichever workflow uses the old action. Include scheduled, manual and bot-triggered runs. Collect them mechanically, not by eye from the UI. The window runs from the previous report, and covers at least the latest completed run of each workflow. Save the list, and diff it against the previous report: new, resolved and persisting. Annotations are capped (e.g., GitHub allows 10 warnings, 10 errors and 10 notices per step, and 50 per job). **If** a step is at the cap → grep its raw job log for warning and error markers, and triage the overflow. Record the run ids and the commit. **If** you cannot re-open an id, run or path → do not cite it. **Done when:** `Annotations` holds the diff (new, resolved, persisting) and the run ids.
95
+ - [ ] **Step 3 — Deprecations:** Read the vendor's deprecation and retirement posts and the runner-image announcements since the previous report. List every dated change that touches these workflows: runtimes, runner images, events and actions. The changelog notice comes before the run notice. Give each one a DEPRECATION verdict with its date and bump. **If** a dependency bot already tracks the bump → say so. Schedule the rest as the next step. **Done when:** `Deprecations` holds one row per dated change: what · date · bump · bot already tracking?
96
+ - [ ] **Step 4 — Runtimes:** For every `uses:` (or the CI system's equivalent) in workflows, local composite actions and reusable workflows, record the resolved version and the declared runtime (e.g., `runs.using`). An action that declares a removed runtime (e.g., `node20` after the runners dropped it) runs on a forced runtime with no opt-out, and is a finding unless it has been seen working there. List leftover opt-out env keys that no longer change anything. **Done when:** `Runtimes` holds one row per action: version · declared runtime · verdict, plus the leftover keys.
97
+ - [ ] **Step 5 — Log Warnings:** Some deprecations print only to the log. Grep the same runs' step logs for deprecation markers (e.g., `DeprecationWarning`, `[DEP0`, `npm warn deprecated`, `WARN deprecated`, `will be removed`) and for outdated-CLI notices (e.g., EAS, Expo, Vercel). Give each line a verdict as if it were an annotation. Agree with `bkit-audit-logs` which sweep owns each line, so it is triaged once. **Done when:** `Log Warnings` holds one row per line: verdict or owning sweep.
98
+ - [ ] **Step 6 — Static Analysis:** Run the workflow linters on every sweep, not only to verify a fix. Treat each new finding as an annotation: shell issues in `run:` blocks, expression typos, template injection, excessive permissions and unpinned `uses:`. Grep workflows and scripts for deprecated workflow commands (e.g., GitHub Actions `::set-output`, `::save-state`, `::set-env`, `::add-path`) and for opt-ins that re-enable them (e.g., `ACTIONS_ALLOW_UNSECURE_COMMANDS`). The runner warns about some of these only when they execute, so a conditional lane hides them. **Done when:** `Static Analysis` holds one row per finding, with its verdict.
99
+ - [ ] **Step 7 — Classify:** Give each annotation one verdict from `Verdicts`.
100
+ - Some annotations are a SILENT FAILURE on sight, e.g., GitHub's `Unexpected input(s) '…', valid inputs are …` (a misspelled input key, ignored) and `No files were found with the provided path` (the artifact was never uploaded).
101
+ - **If** no verdict fits without forcing → use OTHER.
102
+ - Record each annotation's destination.
103
+ - This run writes the `docs/failures.jsonl` rows. Sending to every other destination is the next step's job.
104
+ - Destinations:
105
+ - a real defect → a `docs/failures.jsonl` row
106
+ - SILENT FAILURE → root cause, fix and guard (`Silent Failures`)
107
+ - DEPRECATION → date and bump, dependency bot first
108
+ - LINT WARNING → the fix, or why it stands
109
+ - DEAD SUPPRESSION → delete the directive, flagging a wrong node
110
+ - a flake → `bkit-audit-flakes`
111
+ - a runtime error or a line the log sweep owns → `bkit-audit-logs`
112
+ - a standing rule → a sentence for the testing or deployments doc
113
+ - a workflow change → a recommendation that needs explicit human confirmation
114
+ - ACCEPTED → nothing, citing the record
115
+
116
+ **Done when:** every annotation in `Annotations` has a verdict and a destination.
117
+
118
+ - [ ] **Step 8 — Silent Failures:** Find the root cause of each SILENT FAILURE in the runner's rules. The annotation is the symptom, in the platform's vocabulary. Examples from GitHub Actions: `$GITHUB_ENV` blocklists some names (`NODE_OPTIONS` among them), so set them as static job-level `env:` keys; the `env` context is not available to a job-level `env:` value, so the shortened form resolves empty and fails quietly; a step-level `env:` replaces the job-level map instead of merging, so overriding one key means restating the others; and managed blocks revert edits inside their markers, so check whether a key sits inside a managed marker before recommending a move. On other CI, look for the equivalents (masked variables, env that does not merge, config the platform rewrites). The report names the guard the fix should carry, proven red by reintroducing the bug. **If** deleting the mechanism leaves the lane quiet with no knob → name a second guard that checks the replacement knob exists. Writing the fix is the next step. **Done when:** `Silent Failures` names the root cause, fix and guard for each.
119
+ - [ ] **Step 9 — Lint Node:** For each lint annotation or in-code suppression, find the node the rule fires on, and how the count changes if the directive is removed. Reason from per-file diagnostics. Do not edit the code, and do not typecheck or lint the whole repo for one file. A language server covers one language; use text search for workflow files. **If** a disable comment sits at the annotation line, but the rule's effect is further down → it is a DEAD SUPPRESSION on the wrong node (comment only), and the live rule is a LINT WARNING. **Done when:** `Lint` holds one row per warning: node · directive · verdict.
120
+ - [ ] **Step 10 — Matchers:** Check for problem matchers or annotation reporters on typecheck, lint and test output in CI (e.g., `tsc`, ESLint, Vitest). Without them, warnings stay in the logs, and LINT WARNING is under-counted. Confirm that the deprecated-API lint is enabled (e.g., `@typescript-eslint/no-deprecated`). Calls to deprecated framework APIs are the code-side version of the same deadline. **Done when:** `Matchers` names each reporter and the deprecated-API rule: present or absent.
121
+ - [ ] **Step 11 — Verified:** A green run does not verify a fix to a conditional lane. A lane gated on a marker needs a run that carries the marker, which means a deliberate workflow dispatch, not a push. State what was verified locally (workflow linters, YAML parse, guard tests, per-file diagnostics), and what still needs a real run. Do not dispatch. **Done when:** `Verified` splits what was checked locally from what still needs a run.
122
+ - [ ] **Step 12 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per deprecation or retirement announcement in the window, one per deprecated workflow command and one per linter check class, each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
123
+ - [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the CI signal: workflows, composite actions, reusable workflows, `uses:` pins, runner images, workflow and step `env:` keys, or lint config. (b) In a bounded pass of about 30 minutes, note what a senior CI platform engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
121
124
 
122
125
  ### 🔒 Gate 2: Probes Check
123
126
 
124
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
125
-
126
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
127
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
128
- - [ ] **Workflows untouched:** no workflow, composite action, or CI config edited.
129
- - [ ] **No dispatch:** no workflow run triggered, and no push.
130
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
127
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
128
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
129
+ - [ ] **Workflows untouched:** no workflow, composite action or CI config was edited.
130
+ - [ ] **No dispatch:** no workflow run was triggered.
131
+ - [ ] **No push:** nothing was pushed.
132
+ - [ ] **Gate 2 — Verified:** every item above holds.
131
133
 
132
134
  ## Findings
133
135
 
134
136
  <!-- prettier-ignore -->
135
137
  | Severity | Use |
136
138
  | --- | --- |
137
- | `CRITICAL` | Step reported success while a required operation was refused, skipped, or ignored, and no other check fails |
138
- | `HIGH` | Deprecation whose deadline falls before the next release, or an action on a runtime the runners removed; suppression on the wrong node so the intended rule still fires |
139
- | `MEDIUM` | Lint warning that points at code; deprecation with a deadline still after the next release; dead suppression; static-analysis finding that is not itself a silent failure |
140
- | `LOW` | Leftover env key that changes nothing; accepted annotation with no written record; cosmetic notice |
139
+ | `CRITICAL` | A step reported success while a required operation was refused, skipped or ignored, and no other check fails |
140
+ | `HIGH` | A deprecation whose deadline falls before the next release, or an action on a runtime the runners removed. A suppression on the wrong node, so the intended rule still fires |
141
+ | `MEDIUM` | A lint warning that points at code. A deprecation whose deadline is still after the next release. A dead suppression. A static-analysis finding that is not itself a silent failure |
142
+ | `LOW` | A leftover env key that changes nothing. An accepted annotation with no written record. A cosmetic notice |
141
143
 
142
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: silent failures first.
144
+ Within a severity, list silent failures first.
143
145
 
144
146
  <!-- prettier-ignore -->
145
147
  | ID | Severity | Verdict | Location | Evidence | Expected |
146
148
  | --- | --- | --- | --- | --- | --- |
147
149
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
148
150
 
149
- Empty and clean → one row `None`.
151
+ **If** the run finds nothing → write one row: `None`.
150
152
 
151
153
  ## Report
152
154
 
@@ -223,18 +225,18 @@ PENDING
223
225
 
224
226
  ### 🔒 Gate 3: Report Check
225
227
 
226
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
227
-
228
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
229
- - [ ] **Summary:** names count per severity and the runs read.
230
- - [ ] **Series:** new / resolved / persisting counts beside previous report's, or marked baseline.
231
- - [ ] **Verified:** states what was checked locally and what still needs a real run.
232
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
233
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
234
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
235
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
236
-
237
- > `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
228
+ - [ ] **No placeholders:** no `PENDING` is left.
229
+ - [ ] **Summary:** `Summary` gives the count per severity.
230
+ - [ ] **Runs read:** `Summary` names the runs read.
231
+ - [ ] **Series:** the report shows new / resolved / persisting counts beside the previous report's numbers, or marks the run as baseline.
232
+ - [ ] **Checked locally:** `Verified` states what was checked locally.
233
+ - [ ] **Needs a real run:** `Verified` states what still needs a real run.
234
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
235
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
236
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
237
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
238
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
239
+ - [ ] **Gate 3 — Verified:** every item above holds.
238
240
 
239
241
  <!-- bkit:end -->
240
242