@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,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,122 +11,144 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - 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.
15
16
  > - NEVER dispatch a workflow, push, or otherwise start a run to verify a fix.
16
17
 
17
18
  ## Universal Instructions
18
19
 
19
20
  ### Context & Goals
20
21
 
21
- 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.
22
23
 
23
- **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".
24
25
 
25
- **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.
26
27
 
27
28
  **Anchor Standards:**
28
29
 
29
- - CI vendor changelog, deprecation, and retirement posts (e.g. GitHub Changelog deprecation label). Living; record the date read.
30
- - Runner-image announcements (e.g. `actions/runner-images` Announcement label). Living; record the date read.
31
- - Workflow command reference, including deprecated commands (e.g. GitHub `set-output`, `save-state`, `set-env`, `add-path`).
32
- - Problem matchers and annotation limits (e.g. `actions/toolkit` problem matchers; per-step and per-job caps).
33
- - Workflow static analysers (e.g. actionlint, zizmor); record versions.
34
- - 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.
35
36
 
36
37
  ### Scope
37
38
 
38
- - Annotations and notices on recent runs of every workflow, including scheduled, manual, and bot-triggered. Not one pipeline.
39
- - Deprecation notices in the vendor changelog before they annotate.
40
- - Action and runtime inventory, including leftover opt-out env keys.
41
- - Log lines that never become annotations (deprecations, outdated CLIs).
42
- - Workflow static analysis, and deprecated workflow commands a conditional lane hides.
43
- - One verdict per annotation. Root cause for each silent failure.
44
- - Which node a lint warning actually trips. Problem matchers so lint output becomes annotations.
45
- - 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.
46
49
 
47
50
  ### Out of Scope
48
51
 
49
52
  <!-- prettier-ignore -->
50
53
  | Excluded item | Why | Where it belongs |
51
54
  | --- | --- | --- |
52
- | Runtime errors, and log lines that are not annotations or deprecation warnings | Log sweep | `bkit-audit-logs` |
53
- | Flaky tests | Flake sweep | `bkit-audit-flakes` |
54
- | Whether a static-analysis hit is exploitable | Security sweep | `bkit-audit-security` |
55
- | 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 |
56
59
 
57
60
  ### Verdicts
58
61
 
59
- One per annotation. **SILENT FAILURE** outranks every other verdict.
62
+ Give each annotation one verdict. **SILENT FAILURE** outranks every other verdict.
60
63
 
61
- - **SILENT FAILURE:** step reported success, but annotation says operation was refused, skipped, or ignored. Report names root cause. Fix is next step.
62
- - **DEPRECATION:** action, runtime, or API with announced end date. Report names date and bump. Scheduling is next step.
63
- - **LINT WARNING:** real warning pointing at code. Report says fix, or why it stands. Do not edit the code here.
64
- - **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.
65
- - **ACCEPTED:** known, and already recorded. Say where, and skip.
66
- - **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`.
67
70
 
68
71
  ### Pre-Flight / Dependencies
69
72
 
70
73
  #### Core
71
74
 
72
- - [ ] **Permissions:** blocked calls recorded
73
- - [ ] **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`.
74
- - [ ] **Workflow Files:** Steps 4, 6, 8 — workflows, composite actions, reusable workflows on disk. Fallback: none.
75
- - [ ] **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.
76
79
 
77
80
  #### Conditional
78
81
 
79
- - [ ] **Workflow Linters:** Workflows on disk → Step 6 — e.g. actionlint, zizmor, shellcheck. Fallback: read the workflows; name each check skipped.
80
- - [ ] **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.
81
- - [ ] **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.
82
85
 
83
86
  ### 🔒 Gate 1: Prerequisites Check
84
87
 
85
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
86
- - [ ] **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.
87
90
 
88
91
  ### Probe Steps
89
92
 
90
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
91
- - [ ] **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.
92
- - [ ] **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?
93
- - [ ] **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.
94
- - [ ] **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.
95
- - [ ] **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.
96
- - [ ] **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.
97
- - [ ] **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.
98
- - [ ] **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.
99
- - [ ] **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.
100
- - [ ] **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.
101
- - [ ] **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.
102
- - [ ] **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`.
103
124
 
104
125
  ### 🔒 Gate 2: Probes Check
105
126
 
106
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
107
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
108
- - [ ] **Workflows untouched:** no workflow, composite action, or CI config edited.
109
- - [ ] **No dispatch:** no workflow run triggered, and no push.
110
- - [ ] **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.
111
133
 
112
134
  ## Findings
113
135
 
114
136
  <!-- prettier-ignore -->
115
137
  | Severity | Use |
116
138
  | --- | --- |
117
- | `CRITICAL` | Step reported success while a required operation was refused, skipped, or ignored, and no other check fails |
118
- | `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 |
119
- | `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 |
120
- | `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 |
121
143
 
122
- Within a severity: silent failures first.
144
+ Within a severity, list silent failures first.
123
145
 
124
146
  <!-- prettier-ignore -->
125
147
  | ID | Severity | Verdict | Location | Evidence | Expected |
126
148
  | --- | --- | --- | --- | --- | --- |
127
149
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
128
150
 
129
- Empty and clean → one row `None`.
151
+ **If** the run finds nothing → write one row: `None`.
130
152
 
131
153
  ## Report
132
154
 
@@ -203,14 +225,18 @@ PENDING
203
225
 
204
226
  ### 🔒 Gate 3: Report Check
205
227
 
206
- - [ ] **No placeholders:** no `PENDING` left
207
- - [ ] **Summary:** names count per severity and the runs read.
208
- - [ ] **Series:** new / resolved / persisting counts beside previous report's numbers, or marked baseline.
209
- - [ ] **Verified:** states what was checked locally and what still needs a real run.
210
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
211
- - [ ] **Process Improvements:** `Universal` and `Project` filled
212
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
213
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
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.
214
240
 
215
241
  <!-- bkit:end -->
216
242