@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # bkit Adoption Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,140 +11,149 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Read-only audit; never edit code, config, or data.
15
- > - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
16
- > - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
17
- > - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
18
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
19
- > - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
20
- > - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
21
- > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
- > - NEVER print or copy a token, key, or secret value; names and presence only.
23
- > - never run `bkit install` / `bkit upgrade`; bkit commands = `bkit check`, `bkit doctor` only.
24
- > - NEVER run a hook, script, or tool that writes, commits, pushes, or calls a remote write API; syntax checks and read-only modes only.
25
- > - No skip record exists: every unadopted template is re-listed each run, with the previous verdict and its age.
14
+ > - NEVER print or copy a token, key or secret value. Record names and presence only.
15
+ > - Do not run `bkit install` / `bkit upgrade`.
16
+ > - Run only `bkit check` and `bkit doctor` among the bkit commands.
17
+ > - NEVER run a hook, script or tool that writes, commits, pushes or calls a remote write API.
18
+ > - Run hooks, scripts and tools only as syntax checks or in read-only modes.
19
+ > - Re-list every unadopted template on each run, with the previous verdict and its age, because no skip record exists.
26
20
 
27
21
  ## Universal Instructions
28
22
 
29
23
  ### Context & Goals
30
24
 
31
- bkit ships three folders. Path inside a folder = path it lands at in the repo.
25
+ bkit ships three folders. A file's path inside its folder is the path it lands at in the repo.
32
26
 
33
27
  <!-- prettier-ignore -->
34
28
  | Package folder | Install does | Repo gets |
35
29
  | --- | --- | --- |
36
- | `.bkit/core/` | Writes, keeps current; `engine/`, `workflows/`, `prompts/` never written as-is (workflows + prompts render to host agent and command copies) | Whole files, managed blocks, hooks, reference docs in `.bkit/`, audit and plan templates |
37
- | `.bkit/shared/` | Writes, keeps current | bkit blocks and keys inside files you also edit (`docs/*.md`, `.gitignore`, settings, tool-server config) |
38
- | `.bkit/templates/` | Never writes into the repo; raw copy at `.bkit/templates/`, `bkit upgrade` lists changed paths | Nothing until you copy one and own it |
30
+ | `.bkit/core/` | Writes its files and keeps them current. It never writes `engine/`, `workflows/` or `prompts/` as they are: workflows and prompts render to host agent and command copies | Whole files, managed blocks, hooks, reference docs in `.bkit/`, audit and plan templates |
31
+ | `.bkit/shared/` | Writes its files and keeps them current | bkit blocks and keys inside files you also edit (`docs/*.md`, `.gitignore`, settings, tool-server config) |
32
+ | `.bkit/templates/` | Never writes them into the repo. It keeps a raw copy at `.bkit/templates/`, and `bkit upgrade` lists the changed paths | Nothing until you copy one and own it |
39
33
 
40
- `bkit check` proves written files match the package. Nothing proves the rest: a template never copied, a copy whose tool never runs, a written doc holding only bkit's block, a shipped audit never run. Target failure: **a shipped piece that would have caught something sits unused or half-wired, and every check stays green** — e.g. `.husky/pre-push` never copied, tests run only in CI; `.lintstagedrc.json` copied but `pre-commit` never calls lint-staged; `{{NODE_VERSION}}` left raw in `bkit-ci.yml`; `bkit-cloud.yml` waits on a workflow name that no longer exists; `docs/security.md` holds bkit's block and nothing else; `bkit-audit-security` never run; three releases behind with hand edits inside managed blocks.
34
+ `bkit check` proves that the written files match the package. Nothing proves the rest: a template never copied, a copy whose tool never runs, a written doc that holds only bkit's block, or a shipped audit never run. The failure this audit targets is a shipped piece that would have caught something but sits unused or half-wired, while every check stays green. Examples: `.husky/pre-push` was never copied, so tests run only in CI; `.lintstagedrc.json` was copied, but `pre-commit` never calls lint-staged; `{{NODE_VERSION}}` was left raw in `bkit-ci.yml`; `bkit-cloud.yml` waits on a workflow name that no longer exists; `docs/security.md` holds bkit's block and nothing else; `bkit-audit-security` was never run; or the install is three releases behind, with hand edits inside managed blocks.
41
35
 
42
- **Applies when:** `.bkit/version` present. Absent → one `N/A` row with evidence, never "clean".
36
+ **Applies when:** `.bkit/version` is present. **If** it is absent → write one `N/A` row with its evidence, and never report the surface as "clean".
43
37
 
44
- **Cadence:** monthly. Extra pass after `bkit upgrade`, after adopting or dropping a template, and after adding an agent host.
38
+ **Cadence:** Run once a month. Run an extra pass after `bkit upgrade`, after adopting or dropping a template, and after adding an agent host.
45
39
 
46
- **Anchor Standards:** record bkit version and date read. Newer version → `Standards` step reads what changed.
40
+ **Anchor Standards:** Record the bkit version and the date read.
47
41
 
48
- - bkit, at the installed version: `.bkit/templates.md` (Contract, placeholders, Context-fetch blocks), `.bkit/README.md` § File ownership and § Ongoing CLI, `.bkit/install.md`; release notes since pinned version.
49
- - Config reference of each tool behind an adopted template (e.g. Husky, lint-staged, Vale, Prettier, Renovate, Dependabot, Trivy, GitHub Actions workflow syntax, direnv); record version read.
42
+ - bkit, at the installed version: `.bkit/templates.md` (Contract, placeholders, Context-fetch blocks), `.bkit/README.md` § File ownership and § Ongoing CLI, `.bkit/install.md`, and the release notes since the pinned version.
43
+ - Config reference of each tool behind an adopted template (e.g., Husky, lint-staged, Vale, Prettier, Renovate, Dependabot, Trivy, GitHub Actions workflow syntax, direnv). Record the version read.
50
44
 
51
45
  ### Scope
52
46
 
53
- - Inventory: every file in the package's `core/`, `shared/`, `templates/` vs `.bkit/version` `canonicalHashes` vs the repo's `.bkit/templates/` copy.
54
- - Version: pinned vs installed vs registry latest.
55
- - `bkit check` drift; `bkit doctor` advisories.
56
- - Hosts: agent hosts in use vs bkit hosts installed; host agent, command, and hook copies per host.
57
- - Written files: managed blocks and owned keys untouched; files bkit shares with you carry your part.
58
- - Audit templates: each run within its cadence.
59
- - Templates: each adopted, or not and why; adopted copies filled, reconciled, merged after upgrade, wired, running.
60
- - Context-fetch blocks: one per context with a lane; each matches the lane it names.
47
+ - Inventory every file in the package's `core/`, `shared/` and `templates/` against `.bkit/version` `canonicalHashes` and against the repo's `.bkit/templates/` copy.
48
+ - Compare the pinned, installed and registry-latest versions.
49
+ - Read the `bkit check` drift.
50
+ - Read the `bkit doctor` advisories.
51
+ - Compare the agent hosts in use with the bkit hosts installed.
52
+ - Check the agent, command and hook copies for each host.
53
+ - Check that the managed blocks and owned keys in written files are untouched.
54
+ - Check that each file bkit shares with you carries your part.
55
+ - Check that each audit template was run within its cadence.
56
+ - Record whether each template is adopted, and why when it is not.
57
+ - Check that each adopted copy is filled, reconciled, merged after upgrade, wired and running.
58
+ - Check that there is one context-fetch block per context with a lane, and that each matches the lane it names.
61
59
 
62
60
  ### Out of Scope
63
61
 
64
62
  <!-- prettier-ignore -->
65
63
  | Excluded item | Why | Where it belongs |
66
64
  | --- | --- | --- |
67
- | Agent permissions, hooks firing, tool servers, parity across hosts — bkit-shipped gates included | Agent config sweep | `bkit-audit-agents` |
68
- | Whether a doc's content is true | Documentation sweep | `bkit-audit-documentation` |
69
- | Branch protection, required checks, hosted variables | Config sweep | `bkit-audit-config` |
70
- | CI token permissions, action pinning, secret rotation | Security sweep | `bkit-audit-security` |
71
- | Lint and scanner suppressions inside adopted configs | Slop sweep | `bkit-audit-slop` |
72
- | Whether a sweep here should become a gate | Gate sweep | `bkit-audit-gates` |
73
- | Copying, editing, or merging a template; running `bkit install` / `bkit upgrade` | Audit reports only | Plan from this report |
65
+ | Agent permissions, hooks firing, tool servers, parity across hosts — bkit-shipped gates included | The agent config sweep owns them | `bkit-audit-agents` |
66
+ | Whether a doc's content is true | The documentation sweep owns it | `bkit-audit-documentation` |
67
+ | Branch protection, required checks, hosted variables | The config sweep owns them | `bkit-audit-config` |
68
+ | CI token permissions, action pinning, secret rotation | The security sweep owns them | `bkit-audit-security` |
69
+ | Lint and scanner suppressions inside adopted configs | The slop sweep owns them | `bkit-audit-slop` |
70
+ | Whether a sweep here should become a gate | The gate sweep owns it | `bkit-audit-gates` |
71
+ | Copying, editing or merging a template; running `bkit install` / `bkit upgrade` | The audit only reports | A plan made from this report |
74
72
 
75
73
  ### Pre-Flight / Dependencies
76
74
 
77
- **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.
78
-
79
- **Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
80
-
81
75
  #### Core
82
76
 
83
- Always verify.
84
-
85
- - [ ] **Permissions:** Before Step 1 — one cheap read-only call per tool this run uses (every item below, every rule under `Project Instructions` `Permissions`), e.g. `gh run list --limit 1`, one MCP read, one anchor-standard fetch. Blocked / denied (here or in any step) → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`; run every step the remaining tools allow; work needing blocked call → `Not Checked`. never stop the run for a blocked call; never retry or reword a blocked call to get past it.
86
- - [ ] **Checkout:** Steps 2–11 — repo with `.bkit/version`. Fallback: none; absent → `N/A` and STOP.
87
- - [ ] **Package:** Step 2 — installed package root (e.g. `node_modules/@cbartens/bkit/.bkit/`, resolved via the package manager). Fallback: unpack the pinned version (e.g. `npm pack @cbartens/bkit@<pinnedVersion>` into a throwaway dir); else inventory from `.bkit/templates/` + `canonicalHashes` only, `core/` + `shared/` unwritten files `Not Checked`.
88
- - [ ] **bkit CLI:** Steps 4, 5 — `bkit check`, `bkit doctor` (or `pnpm bkit …`). Fallback: hash written files against `canonicalHashes` by hand; advisories `Not Checked`.
89
- - [ ] **Registry:** Step 3 — latest version and release notes (e.g. `npm view @cbartens/bkit version`, release page). Fallback: pinned vs installed only; currency `Not Checked`.
77
+ - [ ] **Permissions:** every blocked call is recorded.
78
+ - [ ] **Checkout:** Steps 2-11 — a repo with `.bkit/version`. Fallback: none. **If** it is absent → write one `N/A` row, then **STOP**.
79
+ - [ ] **Package:** Step 2 — the installed package root (e.g., `node_modules/@cbartens/bkit/.bkit/`, resolved through the package manager). Fallback: unpack the pinned version into a throwaway directory (e.g., `npm pack @cbartens/bkit@<pinnedVersion>`). **If** that fails → inventory from `.bkit/templates/` and `canonicalHashes` only, and mark the unwritten `core/` and `shared/` files `Not Checked`.
80
+ - [ ] **bkit CLI:** Steps 4, 5 — `bkit check` and `bkit doctor` (or `pnpm bkit …`). Fallback: hash the written files against `canonicalHashes` by hand, and mark the advisories `Not Checked`.
81
+ - [ ] **Registry:** Step 3 — the latest version and its release notes (e.g., `npm view @cbartens/bkit version`, the release page). Fallback: compare the pinned and installed versions only, and mark currency `Not Checked`.
90
82
 
91
83
  #### Conditional
92
84
 
93
- Verify only when applicable.
94
-
95
- - [ ] **CI Host Read:** Repo has CI → Steps 8, 9 — workflow list, job names, recent runs, artifact names (e.g. `gh workflow list`, `gh run list`, `gh run view --json jobs`). Fallback: workflow files only; lane matching `Not Checked`.
96
- - [ ] **Template Tools:** ≥1 adopted template → Step 9 — each tool behind one, installed version (e.g. `npx husky --version`, `vale --version`, `npx lint-staged --version`). Fallback: version from lockfile; runs `Not Checked`.
97
- - [ ] **Machine Config:** Audit runs on a developer machine → Step 9 — local git config (e.g. `git config core.hooksPath`), direnv allow state. Fallback: repo-level only; machine wiring `Not Checked`.
85
+ - [ ] **CI Host Read:** **If** the repo has CI → Steps 8, 9 — the workflow list, job names, recent runs and artifact names (e.g., `gh workflow list`, `gh run list`, `gh run view --json jobs`). Fallback: read the workflow files only, and mark lane matching `Not Checked`.
86
+ - [ ] **Template Tools:** **If** at least one template is adopted → Step 9 — the installed version of each tool behind one (e.g., `npx husky --version`, `vale --version`, `npx lint-staged --version`). Fallback: take the version from the lockfile, and mark runs `Not Checked`.
87
+ - [ ] **Machine Config:** **If** the audit runs on a developer machine → Step 9 — the local git config (e.g., `git config core.hooksPath`) and the direnv allow state. Fallback: check the repo level only, and mark machine wiring `Not Checked`.
98
88
 
99
89
  ### 🔒 Gate 1: Prerequisites Check
100
90
 
101
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
102
-
103
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
104
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
91
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
92
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
105
93
 
106
94
  ### Probe Steps
107
95
 
108
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. Carry each `Adoption` verdict forward with its age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
109
- - [ ] **Step 2 — Inventory:** List every file in the package's `core/`, `shared/`, `templates/`. Landing path = path inside the folder; `core/engine/`, `core/workflows/`, `core/prompts/` → no landing (workflows + prompts → Step 5 host copies). Join: package file · landing path present · in `canonicalHashes` · repo `.bkit/templates/` copy matches package `templates/`. Kind per file: whole file / managed block / owned keys / template. Findings: `core/` or `shared/` file with landing path absent; `canonicalHashes` entry the package no longer ships; repo `.bkit/templates/` differing from package. Group a folder into one row only when every file shares one verdict. **Done when:** `Inventory` row per shipped file or uniform folder: folder · landing path · kind · present · recorded.
110
- - [ ] **Step 3 — Version:** `pinnedVersion` vs installed package vs registry latest; pinned ≠ installed = package bumped without `bkit upgrade`. Behind → release count; release-note changes touching this repo; template paths changed since pinned version. **Done when:** `Version` names all three versions and every relevant release-note change.
111
- - [ ] **Step 4 — Check and Doctor:** `bkit check`: exit code, each drift line → cause. `bkit doctor`: each advisory → adopt / reject (why) / not applicable; previous report's reject carried forward, re-raised only when the advisory text changed. **Done when:** `Check and Doctor` row per drift line and advisory.
112
- - [ ] **Step 5 — Hosts:** Agent hosts in use (repo config dirs, team use; newest `bkit-audit-agents` `Hosts` as cross-check, not source) vs bkit hosts installed. Per installed host: one agent copy per `core/prompts/` source, one command copy per `core/workflows/` source, every `core/` hook file present, executable, and wired in that host's settings. Findings: host in use with no bkit install (agents there run without bkit gates); missing or extra copy; hook file present but unwired, or wired but absent. Whether hooks fire and agree across hosts → `bkit-audit-agents`. **Done when:** `Hosts` row per host: in use · installed · agent copies · command copies · hooks wired.
113
- - [ ] **Step 6 — Written Files:** (a) Every `bkit:start` / `bkit:end` block and owned key: untouched (Step 4 drift). Hand edit → move below `bkit:end` / to `Project Instructions`; bkit-shipped defect → upstream bkit fix. (b) Files bkit shares with you (`shared/docs/*.md`, `AGENTS.md`, `CLAUDE.md`, `.agents/*.md`, `.gitignore`, `.gitattributes`, settings, tool-server config): your part present for every block that expects one — a doc holding only bkit's block is unadopted. `.bkit/.env.example` → `.bkit/.env` present, git-ignored, every listed key set (names only). Tracker or tool-server entry bkit wrote → credential env var it names is set. Whether your part is true → `bkit-audit-documentation`. **Done when:** `Written Files` row per shared file: block untouched · your part present · verdict.
114
- - [ ] **Step 7 — Audits:** Per `docs/templates/bkit-audit-*.md`: `**Applies when:**` met yes / no (evidence); `**Cadence:**`; newest report under `docs/audits/` by commit date (never run = due; same rule as `bkit-utility-update-roadmap`). `N/A` report with evidence = run. Findings: applies and never run; overdue past one cadence; `Process Improvements` `Project` edits proposed in a report and absent from that template's `Project Instructions`. **Done when:** `Audits` row per template: applies · cadence · last run · overdue by · verdict.
115
- - [ ] **Step 8 — Adoption:** Per file in package `templates/`, joined to `.bkit/templates.md` § Contract (file missing from Contract → upstream bkit doc fix): adopted (copy at landing path, or at the destination the Contract names) / not adopted. Not adopted → `gap` (fits this stack, nothing else does the job) / `covered` (name the tool that does) / `not applicable` (evidence, e.g. no GitHub Actions, no markdown docs). Two templates for one job (e.g. Renovate and Dependabot) → one adopted, or `bkit.depUpdater` recorded. Context-fetch: per context (`ci`, `diff`, `e2e`, `runtime`, `web`) the repo has a lane or provider for → block below `bkit:end` in `.agents/context.md`, or `<!-- context-fetch:none … -->` naming it; provider in use (dependency, config, CI step) with a shipped `templates/context/` file and no block → `gap`. Re-list every row each run; diff vs previous report: newly adopted, newly dropped, unchanged with age. **Done when:** `Adoption` row per template file and per context: adopted · verdict · evidence · age.
116
- - [ ] **Step 9 — Templates:** Per adopted template: (a) Filled: no raw `{{…}}` placeholder; default branch and runner real; no stub sentinel left. (b) Reconciled: `diff .bkit/templates/<path> <path>` → each difference adopt / reject (why); placeholder lines differ by design. (c) Merged: package changed the template after the copy's last change (Step 3, `git log` on `.bkit/templates/<path>`) → merged / rejected (why) / pending. (d) Wired: tool behind it installed, and invoked where the template expects — e.g. hook manager installed by a `prepare` script, hooks executable, `core.hooksPath` set; `pre-commit` calls lint-staged; prose linter styles synced and its config loads them; scanner plugin path resolves; tool-server snippet merged into the host's server config; secrets config names real stores; cloud workflow waits on a workflow `name:` that exists; CI template's job names are the ones the repo requires. (e) Runs: one read-only invocation where one exists (e.g. `sh -n` on a hook, `prettier --check`, `vale` on one doc, `actionlint` on a workflow). (f) Ignored: every repo-wide gate (formatter, prose linter, scanner, linter, type checker) skips `.bkit/templates/`. Context-fetch block → job regex and artifact name match exactly the lane it names (CI Host Read); widened regex catching another lane = finding. **Done when:** `Templates` row per adopted template: (a)–(f) verdict each.
117
- - [ ] **Step 10 — Standards:** Confirm anchor versions; read changes since previous report's version. `Standards Coverage`: one row per Contract row, per context-fetch file, and per tool reference read → checked (name step) / not applicable (why) / finding. Deprecated key or option in an adopted config per its tool reference → finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
118
- - [ ] **Step 11 — Anything Else:** (a) Everything changed since previous report's commit touching bkit-written files, `.bkit/templates/`, adopted copies, `.agents/context.md`, or `package.json` `bkit.*` → one-line verdict each. (b) Bounded ~30 min pass: what a senior engineer adopting bkit flags that no step asks; read what happened since previous run (`bkit upgrade` output, new `docs/failures.jsonl` rows, `.bkit/friction.jsonl`) — 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`.
96
+ - [ ] **Step 1 — Previous Run:** Carry each `Adoption` verdict forward with its age. **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
97
+ - [ ] **Step 2 — Inventory:** List every file in the package's `core/`, `shared/` and `templates/`. A file's landing path is its path inside the folder. `core/engine/`, `core/workflows/` and `core/prompts/` have no landing path: workflows and prompts are checked as host copies in Step 5. For each file, join: the package file · landing path present · in `canonicalHashes` · the repo's `.bkit/templates/` copy matches the package's `templates/`. Give each file one kind: whole file / managed block / owned keys / template. Record these as findings: a `core/` or `shared/` file whose landing path is absent; a `canonicalHashes` entry the package no longer ships; and a repo `.bkit/templates/` that differs from the package. Group a folder into one row only when every file in it shares one verdict. **Done when:** `Inventory` holds one row per shipped file or uniform folder: folder · landing path · kind · present · recorded.
98
+ - [ ] **Step 3 — Version:** Compare `pinnedVersion`, the installed package and the registry latest. **If** pinned != installed → the package was bumped without `bkit upgrade`. **If** the repo is behind → record the release count, the release-note changes that touch this repo, and the template paths changed since the pinned version. **Done when:** `Version` names all three versions and every relevant release-note change.
99
+ - [ ] **Step 4 — Check and Doctor:** Run `bkit check`, and record its exit code and the cause of each drift line. Run `bkit doctor`, and mark each advisory adopt, reject (saying why) or not applicable. Carry the previous report's rejects forward, and re-raise one only when the advisory text changed. **Done when:** `Check and Doctor` holds one row per drift line and per advisory.
100
+ - [ ] **Step 5 — Hosts:** Compare the agent hosts in use with the bkit hosts installed. Find the hosts in use from the repo's config directories and from team use. Use the `Hosts` section of the newest `bkit-audit-agents` report as a cross-check, not as the source. For each installed host, check for one agent copy per `core/prompts/` source, one command copy per `core/workflows/` source, and every `core/` hook file present, executable and wired in that host's settings. Record these as findings: a host in use with no bkit install, because agents there run without bkit gates; a missing or extra copy; and a hook file present but unwired, or wired but absent. Whether hooks fire and agree across hosts goes to `bkit-audit-agents`. **Done when:** `Hosts` holds one row per host: in use · installed · agent copies · command copies · hooks wired.
101
+ - [ ] **Step 6 — Written Files:** (a) Check that every `bkit:start` / `bkit:end` block and owned key is untouched (the Step 4 drift). **If** one holds a hand edit → the fix moves the edit below `bkit:end` or to `Project Instructions`. **If** the defect is in what bkit shipped → the fix is upstream in bkit. (b) In each file bkit shares with you (`shared/docs/*.md`, `AGENTS.md`, `CLAUDE.md`, `.agents/*.md`, `.gitignore`, `.gitattributes`, settings, tool-server config), check that your part is present for every block that expects one. A doc that holds only bkit's block is unadopted. **If** `.bkit/.env.example` exists → check that `.bkit/.env` is present and git-ignored, and that every listed key is set (names only). **If** bkit wrote a tracker or tool-server entry → check that the credential env var it names is set. Whether your part is true goes to `bkit-audit-documentation`. **Done when:** `Written Files` holds one row per shared file: block untouched · your part present · verdict.
102
+ - [ ] **Step 7 — Audits:** For each `docs/templates/bkit-audit-*.md`, record whether its `**Applies when:**` is met, yes or no, with evidence; its `**Cadence:**`; and its newest report under `docs/audits/` by commit date. An audit never run is due, by the same rule as `bkit-utility-update-roadmap`. An `N/A` report with evidence counts as a run. Record these as findings: an audit that applies and was never run; an audit overdue by more than one cadence; and `Process Improvements` `Project` edits that a report proposed and that are absent from that template's `Project Instructions`. **Done when:** `Audits` holds one row per template: applies · cadence · last run · overdue by · verdict.
103
+ - [ ] **Step 8 — Adoption:** Join each file in the package's `templates/` to `.bkit/templates.md` § Contract.
104
+ - **If** a file is missing from the Contract → the fix is an upstream bkit doc fix.
105
+ - Mark each file adopted (a copy at its landing path, or at the destination the Contract names) or not adopted.
106
+ - Give each file not adopted one verdict: `gap` (it fits this stack, and nothing else does the job), `covered` (naming the tool that does) or `not applicable` (with evidence, e.g., no GitHub Actions or no markdown docs).
107
+ - **If** two templates do one job (e.g., Renovate and Dependabot) → check that one is adopted, or that `bkit.dependencies.updater` is recorded.
108
+ - For each context (`ci`, `diff`, `e2e`, `runtime`, `web`) that the repo has a lane or provider for, check for a context-fetch block below `bkit:end` in `.agents/context.md`, or a `<!-- context-fetch:none … -->` naming it.
109
+ - **If** a provider is in use (a dependency, config or CI step), a shipped `templates/context/` file exists for it, **and** there is no block → `gap`.
110
+ - Re-list every row on each run, and diff against the previous report: newly adopted, newly dropped, and unchanged with its age.
111
+
112
+ **Done when:** `Adoption` holds one row per template file and per context: adopted · verdict · evidence · age.
113
+
114
+ - [ ] **Step 9 — Templates:** For each adopted template, check:
115
+ - (a) Filled: no raw `{{…}}` placeholder is left, the default branch and runner are real, and no stub sentinel is left.
116
+ - (b) Reconciled: run `diff .bkit/templates/<path> <path>`, and mark each difference adopt or reject (saying why). Placeholder lines differ by design.
117
+ - (c) Merged:
118
+ - **If** the package changed the template after the copy's last change (Step 3, `git log` on `.bkit/templates/<path>`) → mark it merged, rejected (saying why) or pending.
119
+ - (d) Wired: the tool behind it is installed, and invoked where the template expects. For example, the hook manager is installed by a `prepare` script, the hooks are executable and `core.hooksPath` is set; `pre-commit` calls lint-staged; the prose linter's styles are synced and its config loads them; the scanner plugin path resolves; the tool-server snippet is merged into the host's server config; the secrets config names real stores; the cloud workflow waits on a workflow `name:` that exists; and the CI template's job names are the ones the repo requires.
120
+ - (e) Runs: one read-only invocation, where one exists (e.g., `sh -n` on a hook, `prettier --check`, `vale` on one doc, `actionlint` on a workflow).
121
+ - (f) Ignored: every repo-wide gate (formatter, prose linter, scanner, linter, type checker) skips `.bkit/templates/`.
122
+ - For each context-fetch block, check that its job regex and artifact name match exactly the lane it names (CI Host Read). A widened regex that catches another lane is a finding.
123
+
124
+ **Done when:** `Templates` holds one row per adopted template, with a verdict for each of (a)-(f).
125
+
126
+ - [ ] **Step 10 — 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 Contract row, one per context-fetch file and one per tool reference read, each marked checked (naming the step), not applicable (saying why) or finding. A key or option in an adopted config that its tool reference deprecates is a 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.
127
+ - [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches bkit-written files, `.bkit/templates/`, adopted copies, `.agents/context.md` or `package.json` `bkit.*`. (b) In a bounded pass of about 30 minutes, note what a senior engineer adopting bkit would flag that no step asks about. Read what happened since the previous run (`bkit upgrade` output, new `docs/failures.jsonl` rows, `.bkit/friction.jsonl`), 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`.
119
128
 
120
129
  ### 🔒 Gate 2: Probes Check
121
130
 
122
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
123
-
124
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
125
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
126
- - [ ] **No secrets:** no token, key, or secret value anywhere in the report.
127
- - [ ] **Repo untouched:** no template copied or edited, no bkit-written file changed, no `bkit install` / `bkit upgrade` run, no writing hook or script run.
128
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
131
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
132
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
133
+ - [ ] **No secrets:** no token, key, or secret value appears anywhere in the report.
134
+ - [ ] **Repo untouched:** no template was copied or edited, and no bkit-written file changed.
135
+ - [ ] **No install:** no `bkit install` / `bkit upgrade` was run.
136
+ - [ ] **No writing runs:** no hook or script that writes was run.
137
+ - [ ] **Gate 2 — Verified:** every item above holds.
129
138
 
130
139
  ## Findings
131
140
 
132
141
  <!-- prettier-ignore -->
133
142
  | Severity | Use |
134
143
  | --- | --- |
135
- | `CRITICAL` | Secret value in a tracked adopted copy or a tracked `.bkit/.env` (rotation → `bkit-audit-security`) |
136
- | `HIGH` | `bkit check` failing; pinned ≠ installed; host in use with no bkit install; adopted template whose tool is not installed or never invoked; raw placeholder in an executed file (workflow, hook); cloud workflow waiting on a workflow name that does not exist; context-fetch block matching the wrong lane |
137
- | `MEDIUM` | Template `gap`; edits inside a bkit managed block; unaddressed `bkit doctor` advisory; package change to an adopted template unmerged; unreviewed difference from the template; written doc holding only bkit's block; `.bkit/.env` key unset; audit that applies never run or overdue; repo-wide gate scanning `.bkit/templates/`; context with a lane and no block or opt-out; bkit behind with relevant fix |
138
- | `LOW` | bkit behind, no relevant fix; shipped file missing from the Contract; two updaters adopted with one idle; naming drift, no behaviour change |
144
+ | `CRITICAL` | A secret value in a tracked adopted copy or a tracked `.bkit/.env`. Rotation goes to `bkit-audit-security` |
145
+ | `HIGH` | `bkit check` fails. Pinned != installed. A host in use with no bkit install. An adopted template whose tool is not installed or never invoked. A raw placeholder in an executed file (workflow, hook). A cloud workflow waiting on a workflow name that does not exist. A context-fetch block that matches the wrong lane |
146
+ | `MEDIUM` | A template `gap`. Edits inside a bkit managed block. An unaddressed `bkit doctor` advisory. A package change to an adopted template left unmerged. An unreviewed difference from the template. A written doc that holds only bkit's block. A `.bkit/.env` key unset. An audit that applies and was never run, or is overdue. A repo-wide gate that scans `.bkit/templates/`. A context with a lane and no block or opt-out. bkit behind with a relevant fix |
147
+ | `LOW` | bkit behind with no relevant fix. A shipped file missing from the Contract. Two updaters adopted, with one idle. Naming drift with no behaviour change |
139
148
 
140
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: missing gates, then unwired copies, then drift.
149
+ Within a severity, list missing gates first, then unwired copies, then drift.
141
150
 
142
151
  <!-- prettier-ignore -->
143
152
  | ID | Severity | Folder | Location | Evidence | Expected |
144
153
  | --- | --- | --- | --- | --- | --- |
145
154
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
146
155
 
147
- Empty and clean → one row `None`.
156
+ **If** the run finds nothing → write one row: `None`.
148
157
 
149
158
  ## Report
150
159
 
@@ -217,17 +226,18 @@ PENDING
217
226
 
218
227
  ### 🔒 Gate 3: Report Check
219
228
 
220
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
221
-
222
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
223
- - [ ] **Summary:** names count per severity, bkit version, hosts, and templates adopted / `gap` / `covered` / `not applicable`.
224
- - [ ] **Series:** `Adoption` diffed against previous report's, or marked baseline.
225
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway package unpack removed.
226
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
227
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
228
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
229
-
230
- > `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.
229
+ - [ ] **No placeholders:** no `PENDING` is left.
230
+ - [ ] **Summary:** `Summary` gives the count per severity.
231
+ - [ ] **bkit version:** `Summary` gives the bkit version.
232
+ - [ ] **Hosts:** `Summary` names the hosts.
233
+ - [ ] **Template counts:** `Summary` gives the count of templates adopted / `gap` / `covered` / `not applicable`.
234
+ - [ ] **Series:** `Adoption` is diffed against the previous report's, or the run is marked baseline.
235
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
236
+ - [ ] **Throwaways removed:** the throwaway package unpack is removed.
237
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
238
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
239
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
240
+ - [ ] **Gate 3 — Verified:** every item above holds.
231
241
 
232
242
  <!-- bkit:end -->
233
243