@cbartens/bkit 0.0.0-stage → 5.0.1

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 +417 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +867 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +924 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,283 @@
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. `@bkit-audit-generate` fills this template. -->
2
+
3
+ <!-- bkit:start -->
4
+
5
+ {{BKIT_MANAGED_MARKER}}
6
+
7
+ # Deferrals Triage
8
+
9
+ > [!CAUTION]
10
+ > **Purpose:** Verdict on every open deferral — already done, superseded, tracked, parked, or in-scope work that should have been finished.
11
+ >
12
+ > **Rules:**
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 evidence (`file:line`, or command / query and its output) and tool behind it.
21
+ > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
+ > - NEVER append or edit a ledger line. Correction and close rows live in `Expected` only. `ts` is minted at append (`.bkit/jsonl.md` § Write Idiom), never written in this report.
23
+ > - A winning row whose `ts` is in the future outranks every correction. Name its `key`. Do not invent a later `ts`.
24
+
25
+ ## Universal Instructions
26
+
27
+ ### Context & Goals
28
+
29
+ Deferred work appends rows; nothing re-reads them. Three drifts: silently done (landed, row still not `CLOSED`); superseded (surface rewritten or removed); genuinely deferred and untracked (real work, no tracker issue). Target failure: **an open row the code has already finished, or a real deferral with nothing carrying it** — e.g. `RESOLVED` or `SUPERSEDED` left open because only `CLOSED` is done, or a deferral whose only record is a comment on a closed issue. Deliberate debt only (prudent and deliberate quadrant).
30
+
31
+ **Applies when:** `docs/deferrals.jsonl` exists, or a workflow writes `kind: "deferral"`. None → one `N/A` row with evidence, never "clean".
32
+
33
+ **Cadence:** once per ship cycle; at least monthly when no cycle ships. Extra pass after release, or after another audit records deferred items (e.g. `bkit-audit-app-performance`).
34
+
35
+ **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
36
+
37
+ - Technical debt, principal, and interest, and the Technical Debt Quadrant (e.g. Martin Fowler).
38
+ - Hotspot analysis, churn against code health (e.g. CodeScene).
39
+ - Review of deferred problem records on a schedule and on release: activate, keep deferred, or close (e.g. ITIL-aligned known-error monitoring).
40
+ - `.bkit/jsonl.md` § Deferral Reason — `reason` enum and the four `unjustified` tests, at the installed bkit version.
41
+
42
+ ### Scope
43
+
44
+ - Fold `docs/deferrals.jsonl` last-row-wins. Open = winning `status != "CLOSED"`.
45
+ - Data defects on the winning row: `ts`, `status`, `reason`. The row to append goes in `Expected`.
46
+ - Verify every open row against source before any verdict.
47
+ - Re-test each `reason`, and each `KEEP` trigger.
48
+ - Carrying cost: 90-day churn, related `docs/failures.jsonl` and `.bkit/friction.jsonl` rows.
49
+ - Tracker issues rows point at. Deferrals that exist only as comments on closed issues.
50
+ - `unjustified` adjudication (four tests). Report the row. Do not append.
51
+ - Trend: open count, inflow, outflow, age, missing `severity` or `reason`, rows verified / rows open.
52
+
53
+ ### Out of Scope
54
+
55
+ <!-- prettier-ignore -->
56
+ | Excluded item | Why | Where it belongs |
57
+ | --- | --- | --- |
58
+ | Reckless and inadvertent debt | Not in this register | `bkit-audit-slop`, `bkit-audit-architecture`, `bkit-audit-dead-code` |
59
+ | Known bugs | Failure ledger | `bkit-audit-failures` |
60
+ | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | Ledger writes. Utility reads every winning row not `CLOSED` | `@bkit-utility-update-deferrals` |
61
+ | Doing the deferred work; opening tracker issues | Audit reports only | Plan from this report |
62
+
63
+ ### Verdicts
64
+
65
+ One per verified row.
66
+
67
+ - **DONE:** already landed. `Expected` = `CLOSED` same-`key` row. Cite `file:line`.
68
+ - **SUPERSEDED:** no longer applies (moved, rewritten, removed, or N/A). `Expected` = `CLOSED` row and the reason.
69
+ - **TRACKED:** genuinely deferred, an open issue already covers it. `Expected` = the issue to point the row at, or the acceptance criteria to extend.
70
+ - **NEEDS ISSUE:** genuinely deferred, real work, untracked. `Expected` = the issue to open.
71
+ - **KEEP:** genuinely deferred, correctly parked, not worth an issue yet (tripwire or contingent). `Expected` = no action, and the trigger.
72
+ - **SMALL:** small enough for the next cycle. This run does not do it.
73
+ - **ACCEPTED:** still true, and deliberately never to be done. `Expected` = who decides, and the `CLOSED` row to append once signed off. Record it. Do not wait.
74
+ - **UNJUSTIFIED:** all four tests hold. `Expected` = same-`key` row, `reason: "unjustified"`, the failed test named in `description`, `status: "TRIAGED"`. Later rows carry `reason` verbatim. Work goes back in scope via a plan.
75
+ - **OTHER:** fits none. Say what it is, why, and where it goes. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
76
+
77
+ **DONE is the verdict most likely to be wrong.** Plausible commit message ≠ evidence. DONE or SUPERSEDED needs positive reason — commit, deleted file, or new owner module. Empty query is not absence.
78
+
79
+ **UNJUSTIFIED** when all four hold (`.bkit/jsonl.md` § Deferral Reason):
80
+
81
+ 1. `remediation` names specific files and a bounded edit, not a new architecture.
82
+ 2. The surface is inside files the cycle already touched.
83
+ 3. No external blocker: no missing decision, credential, upstream fix, or confirmation.
84
+ 4. `reason` is `scope-declared`, and the row is the only place it was called out of scope. Test 4 carries the weight.
85
+
86
+ Never set `unjustified` while repairing a missing or illegal `reason`. That repair uses one of the first four enum values. This step is the only place `unjustified` is set.
87
+
88
+ **KEEP needs a trigger** ("before launch", "when N users", a dependency version). No trigger, or trigger fired → another verdict. Row on third consecutive KEEP → NEEDS ISSUE or ACCEPTED.
89
+
90
+ **Cluster** open rows by package and `category`. 3+ in one group → one `own-cycle` issue in `Expected`, not one per row.
91
+
92
+ ### Pre-Flight / Dependencies
93
+
94
+ **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.
95
+
96
+ #### Core
97
+
98
+ Always verify.
99
+
100
+ - [ ] **Ledger:** Steps 3–9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
101
+ - [ ] **Git History:** Steps 2, 7 — commits since the previous report, 90-day churn. Fallback: closures and churn `Not Checked`.
102
+ - [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
103
+
104
+ #### Conditional
105
+
106
+ Verify only when applicable.
107
+
108
+ - [ ] **Language Server:** Typed language → Steps 5, 6 — symbol location and callers, e.g. Serena, `tsserver`. Fallback: text search. A close that needs a caller set stays a hypothesis until corroborated.
109
+ - [ ] **Tracker:** Issues wired → Steps 6, 8 — open issue, acceptance criteria, comments on issues closed since the previous report. Fallback: tracker pointers `Not Checked`.
110
+ - [ ] **Run Stats:** `.bkit/stats.jsonl` has `outcome` rows → Step 3 — sum `deferralsAdded`. Fallback: inflow `Not Checked`.
111
+
112
+ ### 🔒 Gate 1: Prerequisites Check
113
+
114
+ **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
115
+
116
+ - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
117
+ - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
118
+
119
+ ### Probe Steps
120
+
121
+ - [ ] **Step 1 — Previous Run:** Record `git rev-parse HEAD`. Read newest prior report for this slug under `docs/audits/`. 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.
122
+ - [ ] **Step 2 — Closures:** Re-verify every DONE and SUPERSEDED row from the previous report at `HEAD`. Each that no longer holds = finding, with what changed. **Done when:** `Closures` holds every row, each failure, and the failure rate, or run marked baseline.
123
+ - [ ] **Step 3 — Fold:** Last-row-wins per `key`, not per line. Append-only (`.gitattributes` `merge=union`); editing a line keeps stale copy beside replacement. Highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row). Non-numeric `ts` on a `key` → last line in file is latest. Open = every winning row with `status != "CLOSED"`, including `TRIAGED`, `RESOLVED`, `BLOCKED`, `SUPERSEDED`, `CANCELLED`, free text after the word, missing `status`, and any value outside the enum. Finished-looking words ≠ done. Order: `CRITICAL`, then `HIGH`, then oldest `ts`. Compare `severity` case-insensitively. No `severity` → assign with verdict. Trend vs previous report: open count; inflow = sum `deferralsAdded` on `outcome` rows in `.bkit/stats.jsonl` since previous run where field exists; outflow = rows that became `CLOSED` since; age histogram by `ts`; share of open rows missing `severity` or `reason`. Large open set may be partial pass → record rows verified / rows open. Invisible to fold: deferral with no `key`, or recorded only in a PR description. **Done when:** `Trend` holds counts, histogram, inflow, outflow, missing-field share, verified / open, and those limits, or `N/A` and STOP.
124
+ - [ ] **Step 4 — Defects:** Winning row of each `key`. Do not append. `Expected` = row writer appends: copy latest row, change only defective field, same `key`, `ts` minted at append, never literal and never in the future.
125
+
126
+ <!-- prettier-ignore -->
127
+ | Field | Defect | Expected row |
128
+ | --- | --- | --- |
129
+ | `ts` | Not numeric Unix milliseconds: a string, seconds, or missing. Fold order is then undefined | The same row with a fresh `ts` |
130
+ | `status` | Outside `OPEN` / `TRIAGED` / `CLOSED` (`RESOLVED`, `BLOCKED`, `SUPERSEDED`, free text) | `TRIAGED` where the row records analysis, otherwise `OPEN`, old word kept in `description`. `CLOSED` comes only from a verdict |
131
+ | `reason` | Missing, or outside `scope-declared` / `hard-blocked` / `needs-decision` / `own-cycle` / `unjustified` | One of the first four the row's text supports, old text kept in `description`. Never `unjustified` |
132
+
133
+ Winning row with future `ts` → finding names `key` for owner. No correction row. **Done when:** count of each defect, and each `Expected` row, in `Defects`, or `none`.
134
+
135
+ - [ ] **Step 5 — Source:** No verdict before this step. Outstanding-work claims as unreliable as done claims.
136
+
137
+ <!-- prettier-ignore -->
138
+ | Row claims | Check with |
139
+ | --- | --- |
140
+ | "`X` should be extracted, renamed, or consolidated" | Language server, symbol lookup. Exists, and at what path now? A symbol that moved is SUPERSEDED |
141
+ | "Every caller of `Y` still does Z" | Language server, references, then read the callers. This is DONE evidence |
142
+ | "The guard is missing at N sites" | Text search for the literal signature. Counting sites is a pattern question |
143
+ | Migrations, workflows, SQL, docs, or other ledgers | Text search. A language server reads one language |
144
+
145
+ Pace reference queries. Re-run empty or surprisingly low results before close verdict. Partial answer indistinguishable from real. Empty is inconclusive, not absence. **Done when:** every row verified this pass has evidence and the tool on its finding. Unverified rows stay counted in `Trend` and are not passed.
146
+
147
+ - [ ] **Step 6 — Reasons:** `reason` = why deferred. Each value implies a check. Re-test enum value Step 4 assigned the same way. UNJUSTIFIED replaces it only when Step 9's four tests hold.
148
+
149
+ <!-- prettier-ignore -->
150
+ | `reason` | Check |
151
+ | --- | --- |
152
+ | `hard-blocked` | Is the blocker the row names still there? |
153
+ | `needs-decision` | Was the decision made since? Search `docs/decisions.jsonl` |
154
+ | `own-cycle` | Does a plan or an issue for it exist? |
155
+ | `scope-declared` | Does the cited doc section exist, and does it predate the row? |
156
+
157
+ Blocker lifted = highest-yield finding. Flag on verdict. Apply KEEP trigger rule. **Done when:** every verified row's reason, and every KEEP trigger, has a result on the finding.
158
+
159
+ - [ ] **Step 7 — Cost:** Severity = gap badness, not carry cost. Each row still open after Step 6: churn = commits touching surface in last 90 days (e.g. `git log --since=90.days --oneline -- <path>`); related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl` on same symbol or path. High churn + related failures → raise severity. Risk already a failure row = live bug: pair failure `key`, raise severity, name `bkit-audit-failures` for bug triage. **Done when:** `Cost` row per surviving open row: churn, related keys, severity change.
160
+ - [ ] **Step 8 — Pointers:** (a) TRACKED: open issue acceptance criteria include deferred scope; issue not stale and not `Low` across 3+ `bkit-audit-issues` passes. Either fails → say which: extend criteria, or verdict NEEDS ISSUE. (b) Row pointing at closed issue: read what closed it. DONE if scope landed, NEEDS ISSUE if dropped. (c) Deferrals with no row: each issue closed since previous report → read closing comments for deferred items. No row keyed → `Expected` = row to append. **Done when:** `Pointers` lists issue checks and comment-only deferrals, or `none`.
161
+ - [ ] **Step 9 — Classify:** Every row as Step 5 left it gets one verdict. Adjudicate `unjustified` here, and only here. Cluster before naming issues. `needs-decision` and every ACCEPTED row → `Decisions` with who decides. This run does not append, open issues, or do the work.
162
+
163
+ <!-- prettier-ignore -->
164
+ | Finding | Expected |
165
+ | --- | --- |
166
+ | DONE | The `CLOSED` row, with the `file:line` evidence |
167
+ | SUPERSEDED | The `CLOSED` row, with the reason |
168
+ | TRACKED | The issue to point the row at, or the criteria to extend |
169
+ | NEEDS ISSUE | The issue to open. One per cluster of 3 or more |
170
+ | KEEP | No action. Its trigger, re-checked next run |
171
+ | SMALL | The next cycle's work. This run does not do it |
172
+ | ACCEPTED | Who decides, then the `CLOSED` row to append once signed off |
173
+ | UNJUSTIFIED | The same-`key` row (`reason`, failed test, `TRIAGED`), and the work routed back in scope |
174
+ | `needs-decision` | Who decides, under `Decisions` |
175
+ | Risk already a failure row | The failure `key`. Triage at `bkit-audit-failures` |
176
+ | Deferral with no row | The row to append |
177
+ | Data defect | The correction row, or the future-`ts` key for the owner |
178
+ | OTHER | Where it goes |
179
+
180
+ **Done when:** every verified row has one verdict. `Decisions` lists each `needs-decision` and ACCEPTED row with who decides, or `none`.
181
+
182
+ - [ ] **Step 10 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per practice (principal and interest, debt quadrant, hotspots, review triggers for deferred records) and per `reason` value → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
183
+ - [ ] **Step 11 — Anything Else:** (a) Everything changed since previous report's commit touching deferrals (schema and writers in `.bkit/jsonl.md`, design, plan, build, and ship steps that write rows, ship deferral check `@bkit-ship-deferred-sweep`, issues rows point at) → one-line verdict each. (b) Bounded ~30 min pass: what a senior EM owning a technical-debt register flags that no step asks; read since previous run (incidents, `bkit-audit-logs` sweeps, 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`.
184
+
185
+ ### 🔒 Gate 2: Probes Check
186
+
187
+ **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
188
+
189
+ - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
190
+ - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
191
+ - [ ] **Read-only:** no ledger line, code, or config changed. Every correction and close row is `Expected` only.
192
+ - [ ] **Positive close:** every DONE and SUPERSEDED cites a positive reason, never an empty query.
193
+ - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
194
+
195
+ ## Findings
196
+
197
+ <!-- prettier-ignore -->
198
+ | Severity | Use |
199
+ | --- | --- |
200
+ | `CRITICAL` | Deferred gap is data loss, a security hole, or a broken workflow with no workaround. Risk already showing as a `CRITICAL` failure |
201
+ | `HIGH` | Blocker has lifted on work that still does real damage. Deferral paired with a failure row. Unjustified in-scope work that has a workaround |
202
+ | `MEDIUM` | Data defect (`ts`, `status`, `reason`). KEEP whose trigger has fired. Real work with no issue. Reason no longer holds |
203
+ | `LOW` | KEEP with no trigger. Missing `severity`. Locator drift. Superseded surface that changes no result |
204
+
205
+ Scale per `.bkit/jsonl.md` § Severity. Within a severity: oldest `ts` first. Finding keeps severity when it becomes a ledger row or an issue. Row bucket = ledger severity, or verdict-assigned.
206
+
207
+ <!-- prettier-ignore -->
208
+ | ID | Severity | Verdict | Location | Evidence | Expected |
209
+ | --- | --- | --- | --- | --- | --- |
210
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
211
+
212
+ Empty and clean → one row `None`.
213
+
214
+ ## Report
215
+
216
+ ### Summary
217
+
218
+ PENDING
219
+
220
+ ### Previous Run
221
+
222
+ PENDING
223
+
224
+ ### Closures
225
+
226
+ PENDING
227
+
228
+ ### Trend
229
+
230
+ PENDING
231
+
232
+ ### Defects
233
+
234
+ PENDING
235
+
236
+ ### Cost
237
+
238
+ PENDING
239
+
240
+ ### Pointers
241
+
242
+ PENDING
243
+
244
+ ### Decisions
245
+
246
+ PENDING
247
+
248
+ ### Checked
249
+
250
+ PENDING
251
+
252
+ ### Not Checked
253
+
254
+ PENDING
255
+
256
+ ### Standards Coverage
257
+
258
+ PENDING
259
+
260
+ ### Beyond the Steps
261
+
262
+ PENDING
263
+
264
+ ### Process Improvements
265
+
266
+ PENDING
267
+
268
+ ### 🔒 Gate 3: Report Check
269
+
270
+ **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
271
+
272
+ - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
273
+ - [ ] **Summary:** names count per severity, count per verdict, and rows verified / rows open.
274
+ - [ ] **Series:** `Trend` open count, inflow, and outflow beside previous report's numbers, or marked baseline.
275
+ - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
276
+ - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
277
+ - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
278
+
279
+ > `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.
280
+
281
+ <!-- bkit:end -->
282
+
283
+ ## Project Instructions
@@ -0,0 +1,268 @@
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. `@bkit-audit-generate` fills this template. -->
2
+
3
+ <!-- bkit:start -->
4
+
5
+ {{BKIT_MANAGED_MARKER}}
6
+
7
+ # Dependency Triage
8
+
9
+ > [!CAUTION]
10
+ > **Purpose:** Batch open dependency-update PRs for verification; judge supply-chain settings, advisories, licences, and end of life.
11
+ >
12
+ > **Rules:**
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 evidence (`file:line`, or command / query and its output) and tool behind it.
21
+ > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
+ > - NEVER push, merge, label, close, or comment on a PR. NEVER commit onto the integration branch. Throwaway worktree = evidence; remove before report finishes.
23
+ > - never resolve a lockfile conflict as text, and never with `-X ours` / `-X theirs`. NEVER run a recursive update that rewrites ranges the PRs did not name.
24
+ > - A breaking major or a migration stays out of the batch even when green. This run records the plan; landing it is the next step.
25
+
26
+ ## Universal Instructions
27
+
28
+ ### Context & Goals
29
+
30
+ Every dependency PR rewrites the lockfile. Unbatched → PRs stale against each other, bot stops rebasing some, each separate merge = full CI. Batching is cheap; manual batching breaks CI: install rewrites manifest the commit omitted, recursive update rewrites bot-unproposed ranges, partial refresh leaves two copies of one tool. Breaking majors need a person; batch must not carry one. Target failure: **a batch that quietly carries a breaking major, or a lockfile that does not match its manifests**.
31
+
32
+ **Applies when:** a dependency bot opens update PRs, or the repo has manifests and a lockfile. None → one `N/A` row with evidence, never "clean".
33
+
34
+ **Cadence:** weekly after bot open window. Extra pass: security PR outside window, bot config change on default branch, or `bkit-audit-app-store` deadline forcing SDK / target-API upgrade.
35
+
36
+ **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
37
+
38
+ - Dependency-bot best-practice and security presets (e.g. Renovate `config:best-practices`, and the presets it extends: `security:minimumReleaseAgeNpm`, `helpers:pinGitHubActionDigests`, `docker:pinDigests`, `abandonments:recommended`, `:configMigration`). Record the bot version.
39
+ - Package-manager supply-chain settings (e.g. pnpm `minimumReleaseAge`, `trustPolicy: no-downgrade`, `blockExoticSubdeps`, `allowBuilds`, `strictDepBuilds`).
40
+ - Registry provenance and trusted publishing (e.g. npm provenance).
41
+ - OpenSSF Scorecard; record version.
42
+ - OpenSSF Concise Guide for Evaluating Open Source Software; record revision date.
43
+ - Vulnerability scanner and advisory database (e.g. OSV-Scanner, GitHub Advisory Database).
44
+ - Lockfile-integrity linter (e.g. lockfile-lint). Unreadable format → apply checks by hand.
45
+ - Runtime end-of-life catalogue (e.g. endoflife.date); record the date read.
46
+ - SPDX License List; record version.
47
+ - Install-script supply-chain attacks (e.g. Shai-Hulud, September 2025, and Shai-Hulud 2.0, November 2025).
48
+
49
+ ### Scope
50
+
51
+ - No dependency updater config is a CRITICAL finding. Examples: Renovate (`.github/renovate.json` or `.github/renovate.json5`) or Dependabot (`.github/dependabot.yml`). Copy one example and own it.
52
+ - Open dependency PRs: classify, batch, verify, and plan the landing.
53
+ - Bot config against best-practice and supply-chain settings, including which branch the bot actually reads.
54
+ - Lockfile-maintenance cooldown while the package-manager release-age gate is off or absent.
55
+ - Settings that multiply PRs and CI runs.
56
+ - Supply-chain screen of the batch diff.
57
+ - Advisories the bot does not see, fix latency, unmaintained, and deprecated packages, licences.
58
+ - Runtime and framework end of life.
59
+
60
+ ### Out of Scope
61
+
62
+ <!-- prettier-ignore -->
63
+ | Excluded item | Why | Where it belongs |
64
+ | --- | --- | --- |
65
+ | Store submission deadlines | Store sweep | `bkit-audit-app-store` |
66
+ | Dependencies nothing uses | Dead-code sweep | `bkit-audit-dead-code` |
67
+ | Whether a vulnerable function is reachable, beyond naming the call | Security sweep | `bkit-audit-security` |
68
+ | Landing the batch, or labelling, closing, or commenting on PRs | Audit reports only | Plan from this report |
69
+
70
+ ### Verdicts
71
+
72
+ One per PR. Class (A, B, or C) = evidence; below = outcomes. DECISION wins over IN BATCH: breaking major stays out even when green. Non-security PR still inside bot release age → EXCLUDED even when green.
73
+
74
+ - **IN BATCH:** green, or class A or B, and past the bot's release age. Goes in this run's batch.
75
+ - **EXCLUDED:** class C, dropped during batch build, or still inside bot release age. Report names labels and comment text; this run does not apply them.
76
+ - **DECISION:** a breaking major, a migration, or end of life inside 90 days. Listed for a person. Not a batch item.
77
+ - **OTHER:** fits none. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
78
+
79
+ Batch verdict, in `Summary`, not per PR. The landing push's CI is the next step's result, not this run's.
80
+
81
+ - **PASS:** drift check and every local verification command exited 0.
82
+ - **CONCERNS:** a PR was dropped during bisection.
83
+ - **FAIL:** drift, or a red no single PR explains.
84
+
85
+ ### Pre-Flight / Dependencies
86
+
87
+ **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.
88
+
89
+ #### Core
90
+
91
+ Always verify.
92
+
93
+ - [ ] **Git Host:** Steps 2, 3, 11, 12 — open PRs by head-ref prefix, CI runs, behind-count, e.g. `gh`, GitLab API. Fallback: none; PR steps `Not Checked`, batch verdict `FAIL`.
94
+ - [ ] **Package Manager:** Steps 5, 8–10 — install, lockfile, registry metadata, e.g. pnpm, npm. Fallback: none; `Batch` and `Verification` `Not Checked`, batch verdict `FAIL`.
95
+ - [ ] **Clean Worktree:** Steps 8–10 — detached worktree off the integration branch, removed before the report finishes. Fallback: none; do not build the batch in the main checkout.
96
+ - [ ] **Web:** Steps 14, 15 — anchor standards, end-of-life dates, vendor support policy. Fallback: versions and days-left recorded as unread.
97
+
98
+ #### Conditional
99
+
100
+ Verify only when applicable.
101
+
102
+ - [ ] **Bot Dashboard:** Bot publishes a dashboard → Step 3 — blocked and will-not-rebase entries. Fallback: open PRs only; stopped-rebase set `Not Checked`.
103
+ - [ ] **Config Validator:** Bot ships one → Step 3 — e.g. `renovate-config-validator`, on the config as the default branch has it. Fallback: read the files; validity `Not Checked`.
104
+ - [ ] **Vulnerability Scanner:** Lockfile, image, or requirements file → Step 13 — e.g. OSV-Scanner, `npm audit`, host advisory API. Fallback: one source only; the missing source `Not Checked`.
105
+
106
+ ### 🔒 Gate 1: Prerequisites Check
107
+
108
+ **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
109
+
110
+ - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
111
+ - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
112
+
113
+ ### Probe Steps
114
+
115
+ - [ ] **Step 1 — Previous Run:** Record `git rev-parse HEAD`. Read newest prior report for this slug under `docs/audits/`. 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.
116
+ - [ ] **Step 2 — Inventory:** From previous report, list deferred PRs and why. Deferred major whose blocker cleared → first candidate. Select open PRs by head-ref prefix from updater config (`branchPrefix`, default `renovate/`; Dependabot `dependabot/`), never title or author. Token-authored PR on prefix = in scope; record author as evidence, not selector. Per PR: number, title, head ref, head SHA, mergeable, merge state, files, labels, commits behind integration branch, latest CI run (finished only; in-progress ≠ result). **Done when:** `Inventory` names prefix and config source, lists every open PR on prefix, or `none`.
117
+ - [ ] **Step 3 — Bot Health:** No dependency updater config = CRITICAL. Examples: Renovate (`.github/renovate.json` or `.github/renovate.json5`; rules example `.bkit/templates/.github/renovate.json5`, self-hosted runner example `.bkit/templates/.github/workflows/bkit-renovate.yml`) or Dependabot (`.github/dependabot.yml`; example `.bkit/templates/.github/dependabot.yml`). See `docs/deployments.md` § Dependency updaters. Both configs = finding; keep one. Bot dashboard: gather-only (bot rewrites). Record blocked entries and will-not-auto-rebase notices → stale until person acts. Bot reads presets from default branch, not integration. Fence / group on integration branch inactive until release carries it. Base-config edits on integration apply only if bot merges base-branch config — option read from default branch. PR proposes what integration config blocks → read default-branch copy before debugging rule; promotion-lag when branches differ = signal. Validate configs as default branch has them. Dashboard + logs: config errors, PRs held by concurrency / hourly limits, awaiting approval, open config-migration PRs. Broken config ≈ quiet week. **Done when:** `Bot Health` holds blocked PRs, config read branch, validator result, held / awaiting-approval items.
118
+ - [ ] **Step 4 — Supply Chain:** Read settings as default branch has them. Record each vs bot best-practice preset and package manager supply-chain page. Bot: minimum release age >= three days (e.g. Renovate `minimumReleaseAge` / `security:minimumReleaseAgeNpm` + `internalChecksFilter: "strict"`; Dependabot `cooldown`); actions / images digest-pinned; abandonment flagging (e.g. Renovate abandonments preset); config-migration PRs enabled, where bot offers them. Package manager, where offered (e.g. pnpm): trust policy no-downgrade, exotic subdeps blocked, explicit install-script allowlist, strict dependency builds; none offered → `N/A` with evidence. Release-age 0 on package manager = recorded trade-off where docs say so; re-deciding = person (`DECISION`). Gap: bot release age does not apply to lockfile-maintenance PRs (package manager makes changes; gate off → no cooldown) → batch with no cooldown; `Cooldown` stands in; `Screen` first. Missing / weaker setting → `Recommendations` row + line to add. **Done when:** `Supply Chain` row per setting: value · standard · verdict.
119
+ - [ ] **Step 5 — Cooldown:** Package-manager cooldown off or absent → lockfile-maintenance PRs: no automerge; same age wait as other updates before land. Bot opens no lockfile-maintenance PRs (e.g. Dependabot) → those checks `N/A`. Check: lockfile-maintenance block + matching rules → no automerge; each merged lockfile-maintenance since previous run waited >= bot release age (e.g. Renovate `minimumReleaseAge`; newest version publish → merge); open younger → EXCLUDED + eligible date. Same wait on other open non-security PRs: release-age check pending (e.g. `renovate/stability-days`) or newest version younger than bot release age → EXCLUDED + eligible date. Security PRs bypass (Step 13). Lockfile-maintenance automerged or landed before release age = finding. **Done when:** `Cooldown` holds automerge, each merged PR wait, each open PR eligible date.
120
+ - [ ] **Step 6 — Volume:** Each bot PR = lockfile rewrite + preview + CI; each rebase = another CI. Read on default branch; record what each setting would change; lines to add → project-owned bot config. Grouping: related packages one PR (`group:monorepos`, `group:allNonMajor`, or equivalent). List solo opens that should group + catching rule. Schedule: one window; note outside opens (non-security) + why. Limits: concurrent, hourly, branch-concurrent; record held-back PRs. Rebase policy: conflict-only rebases skip CI on every integration move; unset → record default + count rebase pushes since previous run. Lockfile PR conflicts with most dependency merges; lockfile maintenance own schedule, not every bot run. Automerge: low-risk groups passing CI via platform automerge; lockfile maintenance must not automerge while `Cooldown` off. Majors await dashboard approval; unset → major PR + CI before decision. Setting cutting PRs / CI → `Recommendations` + line + PRs saved this run. **Done when:** `Volume` row per setting: value · what it would change · PRs saved.
121
+ - [ ] **Step 7 — Classify:** Every PR that is not green. Quote the evidence line from the log. When nothing matches, the class is C.
122
+ - **A — infrastructure:** preview-deploy wait timeout, registry fetch failure, a cold service refusing, a cancelled runner. Confirm: the same job passed on a neighbouring run or a retry of the same commit.
123
+ - **B — stale:** outdated lockfile, lockfile config mismatch, a merge conflict, merge state dirty, behind the integration branch. Confirm: behind-count. Being behind says nothing about the dependency itself.
124
+ - **C — real:** the failure survives a clean rebase onto the integration branch. Confirm: reproduce it on the batch worktree. Only C keeps a PR out of the batch.
125
+
126
+ Batch = green + A + B past bot release age. C → EXCLUDED → `Excluded`. Breaking major → DECISION even if IN BATCH. Non-security inside release age → EXCLUDED even if IN BATCH (Step 5). **Done when:** `Classes` row per non-green PR: class · behind-count · quoted evidence · verdict.
127
+
128
+ - [ ] **Step 8 — Batch:** Detached worktree off integration branch; no new branch. Merge each IN BATCH PR (`git merge --no-edit`); do not push. Lockfile conflict: never text-resolve → integration copy + regenerate (`git checkout <integration> -- <lockfile>`, `git merge --continue` in worktree only). Manifest conflict between batch PRs: higher version wins if not breaking major; else drop lower, record `replaced by #N`. Higher = breaking major → DECISION out; keep lower line, record major not taken. Manifest vs integration (not another PR): higher version line by line. Other conflict → abort merge, drop PR, record why. Record merged commit; install; lockfile-only PRs → refresh exactly named packages. Traps: (1) install rewrites manifests + lockfile (e.g. pnpm catalog, root `package.json`) — uncommitted edits fail frozen CI, pass locally. (2) recursive update rewrites bot-unproposed ranges in big diff — refresh named packages only. (3) partial refresh → split workspace versions; red typecheck / build → clean integration worktree first; fix = one version everywhere incl. shared version catalog (e.g. pnpm catalog). Drift: every manifest byte-identical to merged commit; quote diff command, exit code, output. Do not commit integration branch; never skip-CI marker. Lockfile sources: integrity hash per entry; tarballs from configured registry over HTTPS; both searches empty — quote hits + pulling package. **Done when:** `Batch` holds worktree commit, PRs in/out + why, drift check, both source searches.
129
+ - [ ] **Step 9 — Screen:** Batch lockfile diff vs integration — list: new packages (transitive incl.); new install scripts + allowlist prompts; versions published < bot release age before run (lockfile-maintenance first); publisher change or less provenance (trust policy refuses when set); names one edit away from a popular package. Worms via `postinstall` — read every new script. Package still inside release age = Cooldown miss → drop PR, rebuild. Other hits → verdict unchanged; `Recommendations` row + evidence for approver. **Done when:** `Screen` lists each hit, or `none`.
130
+ - [ ] **Step 10 — Verify:** `git status --porcelain` empty first (trap (1) in dirty tree). Frozen install → static / unit / integration gate → local E2E per app (store build vs deployed env tests none of batch — use local-build substrate). Beyond green typecheck: framework dependency doctor, where the framework ships one (e.g. `expo-doctor`; SDK-out-of-range packages compile/typecheck then break native/app); single-version check for runtime packages in `Project Instructions` (two versions = trap (3) — report + one version everywhere). Red may be stale install — clear installed deps (e.g. `node_modules`, `.venv`, `target/`), frozen install, re-run before blaming bump. Red check → drop suspect PR, rebuild batch, re-run; no single PR explains → FAIL. **Done when:** `Verification` quotes every command and exit code; `Summary` has PASS, CONCERNS, or FAIL.
131
+ - [ ] **Step 11 — Plan:** Report asks and stops — no push, merge, close, label. Direct-push integration branch → batch lands without feature-branch PR. Deployed-boundary checks on push only → landing push = batch meets external services. Never merge bot PRs one-by-one: N sequential → N integration runs + rebase per open PR after each; N one push → one integration run. `Plan` table columns: `Wave`, `PRs`, `Commits`, `Why together, or why apart`, `Pushes`, `CI runs`. Rules: (1) Default one wave — all IN BATCH in one push; commit series (not squash): non-major groups, then one commit per major each with install matching manifests; each commit revert/bisect point; CI once on push head — `Verify` head; earlier commits → frozen install + typecheck. (2) Second wave only for named reason — bisectability not enough; reason = production watch before next land (SDK / framework / native major, store build/submission, DB-client major); extra wave = +push, +integration run, rebase on open PRs — cost in row. (3) Order: security → non-majors → majors; within majors dependency before dependents (language before linter; UI lib + types together). (4) Unmerged automerge group → batch; self-merge first = separate push + rebases — fold in and close at push; merged pre-landing → rebase batch, drop from plan. (5) Close carried PRs right after push with `Excluded` comment → landing commit; bot auto-close next run only — until then may rebase + CI. (6) Land after bot weekly window, no mid-landing opens/rebases, no queued integration push. (7) List excluded/deferred PRs landing will rebase + CI cost; multi-cycle exclude → rebase each later push — recommend close + dashboard when wanted. (8) No skip-CI on dependency change; required checks test batch. Then ordered landing commands: push, close PRs + comments, labels for open. Cost one-by-one vs batch + CI already spent on branch PRs. Post-land watch: error-tracker release, error-rate / crash-free revert thresholds commit-by-commit — do not invent thresholds. **Done when:** `Plan` holds table, commands, both costs, watch.
132
+ - [ ] **Step 12 — Excluded:** Report lists only — no label, comment, close. C-class + blocked stay open. Report supplies comment text (break + fix) and labels (deferred; major label on major). Comments start with marker in `Project Instructions`; next step finds marker and edits existing comment. Batch-carried PRs → close after land with batch pointer. Breaking major / migration = DECISION → `Recommendations`; real work → issue to open. DECISION evidence (not bare PR): migration guide, breaking changes vs codebase + hit counts, codemods, peer-dep matrix, rollback path. **Done when:** `Excluded` row per out-of-batch PR: verdict · labels · comment text or DECISION evidence.
133
+ - [ ] **Step 13 — Unseen:** Bot-blind surfaces. (a) New advisories vs committed baseline — delta script: not in baseline + stale entries; batch fix → remove baseline entry same commit. Security PRs bypass release-age — confirm landing not queued; same as `bkit-audit-security`, do not duplicate. (b) Second vuln source — scanner on lockfile, language requirements, shipped images + host alerts; lockfile scanners reading first doc only → empty without fail — confirm full read. Classify each advisory shipped, server-only, or dev-only, and say whether the vulnerable function is reachable. Destination for an advisory: `bkit-audit-security`. (c) Fix latency — shipped deps: publication → integration land; CRITICAL ≤7d, HIGH ≤30d; breach = finding, list first. (d) Container installing from bot-bumped manifest covered; second install line bypassing manifest = gap, back. (e) Unused deps → `bkit-audit-dead-code`; unmaintained (no release >1y or archived) on new deps since last pass → `Recommendations`. (f) Deprecated / abandoned whole tree — dashboard abandoned + frozen-install warnings. (g) Licences — new deps since last pass; copyleft (GPL, AGPL) or missing in shipped → `Recommendations`. Production tree licence diff vs previous (BSL, SSPL, commercial upgrades too). Shipped app notices regenerated on dep change; bundled fonts/icons/images — licence + ship terms. **Done when:** `Unseen` holds advisories, latency, container install path, deprecated packages, licence diffs.
134
+ - [ ] **Step 14 — End of Life:** Compare versions in use with the end-of-life catalogue and each vendor's support policy. Record days left for the runtime, the framework, the native SDK, the package manager, the language, the database major, and container base images the project ships (sources in `Project Instructions`). An end of life inside 90 days is DECISION, and the report names the issue to open. **Done when:** `End of Life` row per runtime: version · days left · verdict.
135
+ - [ ] **Step 15 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per bot preset, package-manager supply-chain setting, and Concise Guide rule → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
136
+ - [ ] **Step 16 — Anything Else:** (a) Since previous report commit — dependency-touching changes (manifests, workspace file, bot configs, workflow `uses:`, Dockerfiles, requirements, runtime-version files, build-image, hosting runtime) → one-line verdict each. (b) ~30 min bounded pass — senior supply-chain gaps no step covers; since previous run: incidents, new `docs/failures.jsonl`, `bkit-audit-logs` reports, vendor status — what no step catches? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
137
+
138
+ ### 🔒 Gate 2: Probes Check
139
+
140
+ **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
141
+
142
+ - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
143
+ - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
144
+ - [ ] **Batch local:** drift check quoted with exit code; no push; throwaway worktree removed; integration branch unchanged.
145
+ - [ ] **No landing:** no PR merged, labelled, closed, or commented on.
146
+ - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
147
+
148
+ ## Findings
149
+
150
+ <!-- prettier-ignore -->
151
+ | Severity | Use |
152
+ | --- | --- |
153
+ | `CRITICAL` | No dependency updater config; shipped dependency with a known-bad install script or a publisher change the trust policy should have refused; lockfile entry with no integrity hash, or a tarball off the configured registry; CRITICAL advisory in a shipped dependency older than 7 days |
154
+ | `HIGH` | HIGH advisory in a shipped dependency older than 30 days; lockfile-maintenance update that automerged or landed inside the release-age window; copyleft or missing licence on a shipped dependency |
155
+ | `MEDIUM` | Updater config that does not exclude `.github/workflows/bkit-cloud.yml`; supply-chain setting missing or weaker than the standard; setting that multiplies PR or CI runs; unmaintained or deprecated shipped dependency; end of life inside 90 days; two versions of one runtime package |
156
+ | `LOW` | Bot stopped rebasing a PR; grouping miss with no failure; shipped licence notice not regenerated |
157
+
158
+ Scale per `.bkit/jsonl.md` § Severity. Within a severity: shipped exposure first.
159
+
160
+ <!-- prettier-ignore -->
161
+ | ID | Severity | Verdict | Location | Evidence | Expected |
162
+ | --- | --- | --- | --- | --- | --- |
163
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
164
+
165
+ Empty and clean → one row `None`.
166
+
167
+ ## Report
168
+
169
+ ### Summary
170
+
171
+ PENDING
172
+
173
+ ### Previous Run
174
+
175
+ PENDING
176
+
177
+ ### Inventory
178
+
179
+ PENDING
180
+
181
+ ### Bot Health
182
+
183
+ PENDING
184
+
185
+ ### Supply Chain
186
+
187
+ PENDING
188
+
189
+ ### Cooldown
190
+
191
+ PENDING
192
+
193
+ ### Volume
194
+
195
+ PENDING
196
+
197
+ ### Classes
198
+
199
+ PENDING
200
+
201
+ ### Batch
202
+
203
+ PENDING
204
+
205
+ ### Screen
206
+
207
+ PENDING
208
+
209
+ ### Verification
210
+
211
+ PENDING
212
+
213
+ ### Plan
214
+
215
+ PENDING
216
+
217
+ ### Excluded
218
+
219
+ PENDING
220
+
221
+ ### Unseen
222
+
223
+ PENDING
224
+
225
+ ### End of Life
226
+
227
+ PENDING
228
+
229
+ ### Recommendations
230
+
231
+ PENDING
232
+
233
+ ### Checked
234
+
235
+ PENDING
236
+
237
+ ### Not Checked
238
+
239
+ PENDING
240
+
241
+ ### Standards Coverage
242
+
243
+ PENDING
244
+
245
+ ### Beyond the Steps
246
+
247
+ PENDING
248
+
249
+ ### Process Improvements
250
+
251
+ PENDING
252
+
253
+ ### 🔒 Gate 3: Report Check
254
+
255
+ **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
256
+
257
+ - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
258
+ - [ ] **Summary:** names count per severity, the batch verdict, and open / in-batch / excluded counts.
259
+ - [ ] **Series:** security-fix latency and end-of-life days beside previous report's numbers, or marked baseline.
260
+ - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
261
+ - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
262
+ - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
263
+
264
+ > `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.
265
+
266
+ <!-- bkit:end -->
267
+
268
+ ## Project Instructions