@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,57 +1,51 @@
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
  # Issue Prioritisation
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** A size and a priority for every open tracker issue, on two rules a later run can re-apply and get the same answer; plus board membership, parent, milestone, and blocked-by links the rules read.
10
+ > **Purpose:** A size and a priority for every open tracker issue, set by two rules that a later run can re-apply and get the same answer. The audit also checks board membership, and the parent, milestone and blocked-by links the rules read.
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 write tracker fields, labels, or comments; NEVER close, merge, or open issues. The report proposes size and priority.
23
- > - never copy a personal-data value from an issue body into the report.
14
+ > - NEVER write tracker fields, labels or comments.
15
+ > - NEVER close, merge or open issues.
16
+ > - The report proposes size and priority.
17
+ > - NEVER copy a personal-data value into the report.
24
18
 
25
19
  ## Universal Instructions
26
20
 
27
21
  ### Context & Goals
28
22
 
29
- Board with no stated rule = filing order. Search feature and authorisation bypass share a band; next pass reshuffles both. Target failure: **a ranking that cannot be re-derived**. Rule 1 picks the band. Rule 2 moves it. Rule lives in this template beside the ranking → later run, same board, same answer.
23
+ A board with no stated rule is ordered by filing order. Example: a search feature and an authorisation bypass share a band, and the next pass reshuffles both. The failure this audit targets is a ranking that cannot be re-derived. Rule 1 picks the band, and Rule 2 moves it. The rules live in this template beside the ranking, so a later run on the same board gets the same answer.
30
24
 
31
- **Applies when:** tracker holds open issues. None → one `N/A` row with evidence, never "clean".
25
+ **Applies when:** the tracker holds open issues. **If** it holds none → write one `N/A` row with its evidence, and never report the surface as "clean".
32
26
 
33
- **Cadence:** monthly for clocks. Steps 1, 4, 11, 12 always; 2 membership only; 3 stale only; 5 in-flight age and launch target; 6 eight-week launch move and stuck-item lifts only. Other issues carry previous proposal. Full rank (Steps 2–10) when milestone opens/closes, ship cycle lands cluster, lane contents turn over, or audit files follow-up batch. Mini-pass when issue filed since previous report has gone a week with no size/priority or off-board (anchor-standard triage): Steps 3–8 and 10, plus 1, 2 membership, 11, 12; same two rules.
27
+ **Cadence:** Run once a month for the clocks. A monthly pass always runs Steps 1, 4, 11 and 12. It runs Step 2 for membership only, Step 3 for stale issues only, Step 5 for in-flight age and the launch target, and Step 6 for eight-week launch moves and stuck-item lifts only. Other issues carry the previous proposal. Run a full rank (Steps 2-10) when a milestone opens or closes, a ship cycle lands a cluster, lane contents turn over, or an audit files a batch of follow-ups. Run a mini-pass when an issue filed since the previous report has gone a week with no size or priority, or off the board (anchor-standard triage). A mini-pass runs Steps 3-8 and 10, plus Steps 1, 11 and 12 and Step 2 for membership, with the same two rules.
34
28
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
29
+ **Anchor Standards:**
36
30
 
37
- - Weighted Shortest Job First and cost of delay (e.g. SAFe WSJF, after Reinertsen, _The Principles of Product Development Flow_).
38
- - RICE and ICE scoring (e.g. Intercom RICE).
39
- - The Kanban Guide (WIP, work-item age, service level expectation); record the edition (e.g. May 2025).
31
+ - Weighted Shortest Job First and cost of delay (e.g., SAFe WSJF, after Reinertsen, _The Principles of Product Development Flow_).
32
+ - RICE and ICE scoring (e.g., Intercom RICE).
33
+ - The Kanban Guide (WIP, work-item age, service level expectation); record the edition (e.g., May 2025).
40
34
  - Kanban classes of service (Expedite, Fixed date, Standard, Intangible).
41
- - Definition of Ready: the Scrum Guide's description of ready items under Product Backlog refinement; record the edition (e.g. November 2020). No separate published standard exists.
42
- - Severity is not priority (e.g. Mozilla defect-severity guide and Bugzilla triage policy).
43
- - Tracker dependency links (e.g. GitHub blocked-by / blocking).
35
+ - Definition of Ready: the Scrum Guide's description of ready items under Product Backlog refinement; record the edition (e.g., November 2020). No separate published standard exists.
36
+ - Severity is not priority (e.g., Mozilla defect-severity guide and Bugzilla triage policy).
37
+ - Tracker dependency links (e.g., GitHub blocked-by / blocking).
44
38
  - bkit issue shapes (bkit version from `.bkit/version`): `.bkit/trackers.md` § Issue shapes; example forms `.bkit/templates/.github/ISSUE_TEMPLATE/` (`.bkit/templates.md` § Issue forms)
45
39
 
46
40
  ### Scope
47
41
 
48
- - Every open issue, every open lane, one rule.
49
- - Rule 1 band from the work, not the label.
50
- - Rule 2 move from in flight, launch-gating, and waits on data that does not exist yet.
51
- - Size of the work.
52
- - Order inside a band. Tracker fields do not store order.
53
- - Proposed size and priority per issue. This run does not write them.
54
- - Board membership, parent, milestone, blocked-by: missing, stale, or contradicting → finding.
42
+ - Apply one rule set to every open issue in every open lane.
43
+ - Take the Rule 1 band from the work, not the label.
44
+ - Take the Rule 2 move from work in flight, launch-gating, and waits on data that does not exist yet.
45
+ - Size the work.
46
+ - Order the issues inside each band. Tracker fields do not store order.
47
+ - Propose a size and a priority for each issue. This run does not write them.
48
+ - Record a finding for board membership, a parent, a milestone or a blocked-by link that is missing, stale or contradicting.
55
49
 
56
50
  ### Out of Scope
57
51
 
@@ -67,9 +61,9 @@ Board with no stated rule = filing order. Search feature and authorisation bypas
67
61
 
68
62
  ### Ranking Rules
69
63
 
70
- Both rules load-bearing. Rule 1 decides band. Rule 2 moves one band. Re-apply; do not vote.
64
+ Both rules are load-bearing. Rule 1 decides the band, and Rule 2 moves it one band. Re-apply the rules; do not vote.
71
65
 
72
- **Rule 1 — what kind of work it is.** Security issues, then error fixing, then design issues, then everything else.
66
+ **Rule 1 — what kind of work it is:** security issues come first, then error fixing, then design issues, then everything else.
73
67
 
74
68
  <!-- prettier-ignore -->
75
69
  | Category | Priority | What lands here |
@@ -79,41 +73,41 @@ Both rules load-bearing. Rule 1 decides band. Rule 2 moves one band. Re-apply; d
79
73
  | Design | `Medium` | Layout, copy, icons, parity, accessibility, anything about how it looks or reads |
80
74
  | Everything else | `Low` | New features, test coverage, CI, and tooling, dependency debt, trackers, and milestones |
81
75
 
82
- Defect label = starting point, not answer. Read body. Presentation work and missing tests often labelled bugs. Record every override — those rows most likely wrong. Name label correction to match body (e.g. drop defect label from presentation work).
76
+ A defect label is a starting point, not the answer. Read the body, because presentation work and missing tests are often labelled as bugs. Record every override, because those rows are the most likely to be wrong. Name the label correction that matches the body (e.g., drop the defect label from presentation work).
83
77
 
84
- **Rule 2 — when it can be done.** In-flight neighbours move up. Lifecycle-later work moves down.
78
+ **Rule 2 — when it can be done:** in-flight neighbours move up, and lifecycle-later work moves down.
85
79
 
86
80
  <!-- prettier-ignore -->
87
81
  | Signal | Move |
88
82
  | --- | --- |
89
83
  | Parent, child, or sibling of something in progress or in review | Up one band |
90
84
  | Split out of an in-flight issue, or touching the same harness | Up one band |
91
- | Launch-gating: must ship before launch or before first production deploy | Never down. Up one band when the recorded launch or milestone target is eight weeks away or less. No target recorded → keep the Rule 1 band |
85
+ | Launch-gating: must ship before launch or before first production deploy | Never down. Up one band when the recorded launch or milestone target is eight weeks away or less. **If** no target is recorded → keep the Rule 1 band |
92
86
  | Says "once we have usage data" or "when thresholds are hit" | Down one band |
93
87
  | Protects data that does not exist yet | Down one band, except a critical path named in Project Instructions |
94
88
 
95
- Launch-gating = fixed-date class of service. Cost of delay grows as date approaches → never down. Step 5 records target each run.
89
+ Launch-gating work is the fixed-date class of service. Its cost of delay grows as the date approaches, so it never moves down. Step 5 records the target on each run.
96
90
 
97
- **Blockers take the band of what they block**, when that band is higher than their own. Non-security blocker of `Urgent` stops at `High`, first in `High` order (Step 8).
91
+ **Blockers:** a blocker takes the band of what it blocks, when that band is higher than its own. A non-security blocker of an `Urgent` issue stops at `High`, and goes first in the `High` order (Step 8).
98
92
 
99
93
  Two guards:
100
94
 
101
- 1. Non-security work does not reach `Urgent`, however hot. No up-move and no blocker lifts past `High`. Exception: defect that loses or silently corrupts user data may be `Urgent`.
102
- 2. Security drops at most one band, never for launch timing. Launch-gating security never down. Security on named critical path never takes "data does not exist yet" down-move. Security never `Low` on "no users yet" alone.
95
+ 1. Non-security work does not reach `Urgent`, however hot. No up-move and no blocker lifts it past `High`. The exception: a defect that loses or silently corrupts user data may be `Urgent`.
96
+ 2. Security work drops at most one band, and never for launch timing. Launch-gating security work never moves down. Security work on a named critical path never takes the "data does not exist yet" down-move. Security work is never `Low` on "no users yet" alone.
103
97
 
104
98
  **Traps:**
105
99
 
106
- - Do not rank by label alone — main wrong-answer source.
107
- - `Urgent` inflation kills the band. Long `Urgent` list = category, not queue. If all protective work is `Urgent`, ask which matter in current lifecycle (Project Instructions: users?).
108
- - Standing issues split across bands by subject. Shared process does not put them in one band.
109
- - An auto-generated checklist is not work (e.g. a dependency-bot dashboard).
110
- - Every open lane, same two rules. Two lanes ranked differently → unread across boundary.
100
+ - Do not rank by label alone. It is the main source of wrong answers.
101
+ - `Urgent` inflation kills the band. A long `Urgent` list is a category, not a queue. **If** all protective work is `Urgent` → ask which items matter in the current lifecycle (Project Instructions: are there users?).
102
+ - Standing issues split across bands by subject. A shared process does not put them in one band.
103
+ - An auto-generated checklist is not work (e.g., a dependency-bot dashboard).
104
+ - Rank every open lane by the same two rules. **If** two lanes are ranked differently → the ranking did not read across the boundary.
111
105
 
112
- Finding `CRITICAL`–`LOW` in another audit does not set priority. Two rules do. Severity orders inside `High` only (Step 8).
106
+ A `CRITICAL`-`LOW` finding in another audit does not set priority; the two rules do. Severity orders issues inside `High` only (Step 8).
113
107
 
114
108
  ### Size Scale
115
109
 
116
- Size work, not body. Long evidence write-up can be one-file fix.
110
+ Size the work, not the issue body. A long evidence write-up can describe a one-file fix.
117
111
 
118
112
  <!-- prettier-ignore -->
119
113
  | Size | Work |
@@ -124,86 +118,91 @@ Size work, not body. Long evidence write-up can be one-file fix.
124
118
  | `L` | Several packages, more than one client, or roughly a week |
125
119
  | `XL` | Milestone, full-product inventory, or subsystem not yet built |
126
120
 
127
- Multi-client change never sized as one. Standing/umbrella sized for one run, not series. Milestone sized for contents.
121
+ Never size a multi-client change as one. Size a standing or umbrella issue for one run, not for the series. Size a milestone for its contents.
128
122
 
129
123
  ### Pre-Flight / Dependencies
130
124
 
131
- **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.
132
-
133
- **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.
134
-
135
125
  #### Core
136
126
 
137
- Always verify.
138
-
139
- - [ ] **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.
140
- - [ ] **Tracker Read:** Steps 2, 5, 10 — every board item with lane, size, and priority, via tracker MCP, e.g. GitHub MCP `projects_list` (project items), Linear MCP `list_issues`, Jira MCP `searchJiraIssuesUsingJql`; `gh` only as fallback. Fallback: none; unread items `Not Checked`, proposal does not cover them.
141
- - [ ] **Open-Issue List:** Steps 2, 10 — every open issue, every repo / team board draws from, read separately from board, e.g. GitHub MCP `list_issues`, Linear MCP `list_issues` per team, Jira MCP JQL per project. Fallback: none; membership `Not Checked`, proposal covers board items only.
142
- - [ ] **Issue Bodies:** Steps 3, 4, 6, 8 — title, labels, body, parent, milestone, blocked-by, e.g. GitHub MCP `issue_read`, Linear MCP `get_issue`, Jira MCP `getJiraIssue`. Fallback: titles only; each such rank low-confidence in `Judgement Calls`, links from structured fields only.
143
- - [ ] **Web:** Step 11 — fetch anchor standards. Fallback: versions recorded as unread.
127
+ - [ ] **Permissions:** every blocked call is recorded.
128
+ - [ ] **Tracker Read:** Steps 2, 5, 10 — every board item with its lane, size and priority, read through the tracker MCP (e.g., GitHub MCP `projects_list` for project items, Linear MCP `list_issues`, Jira MCP `searchJiraIssuesUsingJql`). Use `gh` only as a fallback. Fallback: none. Mark unread items `Not Checked`; the proposal does not cover them.
129
+ - [ ] **Open-Issue List:** Steps 2, 10 — every open issue in every repo or team the board draws from, read separately from the board (e.g., GitHub MCP `list_issues`, Linear MCP `list_issues` per team, Jira MCP JQL per project). Fallback: none. Mark membership `Not Checked`; the proposal covers board items only.
130
+ - [ ] **Issue Bodies:** Steps 3, 4, 6, 8 — the title, labels, body, parent, milestone and blocked-by of each issue (e.g., GitHub MCP `issue_read`, Linear MCP `get_issue`, Jira MCP `getJiraIssue`). Fallback: read titles only, mark each such rank low-confidence in `Judgement Calls`, and take links from structured fields only.
131
+ - [ ] **Web:** Step 11 — fetch the anchor standards. Fallback: record the versions as unread.
144
132
 
145
133
  #### Conditional
146
134
 
147
- Verify only when applicable.
148
-
149
- - [ ] **Ship Ledger:** Ship outcomes recorded → Step 9 — e.g. `.bkit/stats.jsonl` `outcome` rows. Fallback: size table unchecked against what shipped; say so.
150
- - [ ] **Link API:** Tracker exposes structured blocked-by or parent links → Step 4 — e.g. GitHub MCP `issue_read` sub-issues / parent, Linear `relations` / `parent`, Jira issue links / `parent`. Fallback: body text only; say so.
135
+ - [ ] **Ship Ledger:** **If** ship outcomes are recorded → Step 9 — the outcomes (e.g., `.bkit/stats.jsonl` `outcome` rows). Fallback: say that the size table was not checked against what shipped.
136
+ - [ ] **Link API:** **If** the tracker exposes structured blocked-by or parent links → Step 4 — those links (e.g., GitHub MCP `issue_read` sub-issues / parent, Linear `relations` / `parent`, Jira issue links / `parent`). Fallback: read the body text only, and say so.
151
137
 
152
138
  ### 🔒 Gate 1: Prerequisites Check
153
139
 
154
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
155
-
156
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
157
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
140
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
141
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
158
142
 
159
143
  ### Probe Steps
160
144
 
161
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
162
- - [ ] **Step 2 — Board:** Read every item. Assert read not truncated (count below limit; at limit → raise and re-read). Record lane names, size and priority field ids and option ids from live field list. Unused numeric estimate stays unused; size = estimate. Membership: diff open-issue list vs board. Open issue not on board = off-board; closed issue outside done lane = stale card; list each by number. Off-board stays in scope: Steps 3–10 treat as item with no lane, size, priority. **Done when:** item count, lanes, field ids, off-board, stale cards in `Board`, or `N/A` and STOP.
163
- - [ ] **Step 3 — Triage:** Read every open issue, not titles only. Short body prefix OK when summary front-loaded; open umbrella/milestone issues in full. While reading: stale = no activity 90 days and body no longer true of code/plan (standing issue never stale for age); duplicate = same change twice or one wholly inside another; `Low` on 3+ passes and still true = won't-do candidate (standing excluded); ready-lane item missing acceptance criteria, defect reproduction, or test to write = not ready (still gets size/priority). Note each Rule 1 override for Step 6 with label correction. List stale/duplicate with merge target or stale reason. Closing = owner; this run does not close. Monthly clock → stale only. **Done when:** `Triage` lists stale, duplicates, won't-do, not-ready, overrides to rank.
164
- - [ ] **Step 4 — Links:** Per open issue record parent, milestone, blocked-by. Blocked-by: read all three — structured links (`Link API`), body block build gates on (e.g. GitHub `###### bkit:blocked-by start` / `end`), body prose ("blocked by #N", "after #N"). Flag: (1) Parent — child listed in parent body, no link (or reverse); open child, closed parent; open non-standing parent, all children closed → `Judgement Calls`. (2) Milestone — closed / past-due milestone with open issues; child with no or later milestone than parent; body / title names milestone, field empty; open milestone, no open issues. (3) Blocked-by — prose only; structured link vs body block disagree; closed blocker still listed; blocked issue in ready or later lane, blocker open; blocker off-board; cycle. Edges → Step 5 blocker rule, Step 6 parent / child moves. **Done when:** `Links` holds per-kind counts (with / without parent, milestone, blocker) and every flag, or `none`.
165
- - [ ] **Step 5 — In Flight:** Three sources: lanes in progress/review; open PRs; issues closed recently (shipped cluster still warm — next issue in cluster cheap). Record launch/milestone target and where written. None → say so; launch-gating keeps Rule 1 band. Count in-progress/in-review; age and last activity (commit, PR, comment). Flag older than service level expectation: 85th-percentile cycle time of issues closed last 90 days, start of work to close. Record how start taken. <20 closed → two weeks, say so. Stuck item lifts parent/children/siblings; list each lift as judgement call. Apply blocker rule to every Step 4 edge. **Done when:** `In Flight` holds counts, ages, target, blocker moves, stuck lifts.
166
- - [ ] **Step 6 — Rank:** Apply `Ranking Rules` to every in-scope issue. Record every Rule 1 override (label vs body) and label correction. Record every Rule 2 move with signal and launch target read. Band change since previous report without body/labels/in-flight change → one pass misapplied rule — say which. Maintenance check belonging as gate → `bkit-audit-gates`, not band here. Mini-pass → this step on unsized/unprioritised subset only. Monthly clock → eight-week launch moves and stuck lifts only. **Done when:** `Ranking` lists every override, move, band change.
167
- - [ ] **Step 7 — Size:** Apply `Size Scale` to every in-scope issue. **Done when:** `Sizes` row per in-scope issue.
168
-
169
- - [ ] **Step 8 — Order:** Four bands tie issues. Order each ready-lane band; report top ten. Proposal does not invent order field. (1) Inside `High`: blockers of `Urgent` first, then severity. Defect with ledger/audit `CRITICAL` before `HIGH`, both before rest. Severity orders in band; never moves band. (2) Cost of delay ÷ size (WSJF). Score 1–3: user/business value, time-criticality, risk reduced/work unblocked. Sum ÷ size: XS 1, S 2, M 3, L 5, XL 8. Tie → older issue. Simplified WSJF; standard uses modified Fibonacci per part and job size. (3) Demand when any: error-tracker volume, store reviews, analytics, support, previous-product users → raise value score; name source. Empty → say so; do not guess. **Done when:** `Order` holds top ten with scores.
170
- - [ ] **Step 9 — Shipped:** Issues closed since previous report → join ship outcome via closing PR (lines changed, duration). Compare with size given. Sizes overlapping heavily in lines/time → size table no longer means what it says; propose change in `Process Improvements`. **Done when:** `Shipped` holds comparison, or no outcomes and say so.
171
- - [ ] **Step 10 — Propose:** One proposed size and priority per open item outside done lane, off-board included, from Steps 6–7. Assert set-equality proposal vs open-issue list (Step 2) before report finished. Missing issue = silent otherwise. This run does not write fields. Distribution before (fields as read) and after (proposal) leads `Summary`. `Judgement Calls`: every call owner should overturn — stuck lifts, won't-do, stale, duplicate closes, uncertain bands — recommendation and what would settle each. **Done when:** `Proposal` covers every in-scope item; `Judgement Calls` holds calls.
172
- - [ ] **Step 11 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per anchor-standard practice (within-band order, classes of service, WIP, and work-item age, definition of ready, severity against priority, dependencies) → checked (name step) / not applicable (why) / finding. Per bkit anchor (doc section, rule, or issue shape): one row → followed (name step or evidence) / not applicable (why) / finding; departure with no recorded reason (e.g. `docs/decisions.jsonl` row, accepted-divergence entry) = finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
173
- - [ ] **Step 12 — Anything Else:** (a) Everything changed since previous report's commit touching prioritisation (board fields/options, lanes, labels, milestones, issue templates, two rules) → one-line verdict each. (b) Bounded ~30 min pass: what senior delivery lead flags that no step asks; read since previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status) — 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`.
145
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
146
+ - [ ] **Step 2 — Board:** Read every item. Check that the read was not truncated: the count is below the limit. **If** the count is at the limit → raise the limit and read again. Record the lane names, and the size and priority field ids and option ids, from the live field list. An unused numeric estimate field stays unused, and the size field is the estimate. For membership, diff the open-issue list against the board. An open issue not on the board is off-board. A closed issue outside the done lane is a stale card. List each one by number. Off-board issues stay in scope: Steps 3-10 treat each one as an item with no lane, size or priority. **Done when:** the item count, lanes, field ids, off-board issues and stale cards are in `Board`, or `N/A` is recorded → **STOP**.
147
+ - [ ] **Step 3 — Triage:** Read every open issue, not only its title. A short prefix of the body is enough when the summary comes first. Read umbrella and milestone issues in full. While reading, mark these. Stale: no activity for 90 days, and the body is no longer true of the code or plan. A standing issue is never stale for age. Duplicate: the same change filed twice, or one change wholly inside another. Won't-do candidate: `Low` on 3 or more passes and still true, standing issues excluded. Not ready: a ready-lane item missing acceptance criteria, a defect reproduction or a test to write. A not-ready item still gets a size and a priority. Note each Rule 1 override, with its label correction, for Step 6. List each stale or duplicate issue with its merge target or stale reason. Closing is the owner's decision, and this run does not close. **If** this is a monthly clock pass → check stale issues only. **Done when:** `Triage` lists the stale, duplicate, won't-do and not-ready issues, and the overrides to rank.
148
+ - [ ] **Step 4 — Links:** For each open issue, record its parent, milestone and blocked-by links.
149
+ - For blocked-by, read all three sources: structured links (`Link API`), the body block the build gates on (e.g., GitHub `###### bkit:blocked-by start` / `end`), and body prose ("blocked by #N", "after #N").
150
+ - Flag these:
151
+ - (1) Parent: a child listed in the parent body with no link, or the reverse; an open child with a closed parent.
152
+ - **If** an open non-standing parent has all its children closed → put it in `Judgement Calls`.
153
+ - (2) Milestone: a closed or past-due milestone with open issues; a body or title that names a milestone while the field is empty; a milestone that breaks how the repo assigns them, read from open and recently closed issues.
154
+ - **If** there is no clear pattern → do not flag it.
155
+ - (3) Blocked-by: a link in prose only; a structured link and a body block that disagree; a closed blocker still listed; a blocked issue in a ready or later lane while its blocker is open; an off-board blocker; a cycle.
156
+ - Feed the edges to the Step 5 blocker rule and the Step 6 parent and child moves.
157
+
158
+ **Done when:** `Links` holds the counts per kind (with and without a parent, a milestone and a blocker) and every flag, or `none`.
159
+
160
+ - [ ] **Step 5 — In Flight:** Read three sources: the in-progress and in-review lanes, open PRs, and recently closed issues. A shipped cluster is still warm, so the next issue in it is cheap. Record the launch or milestone target, and where it is written. **If** there is none → say so; launch-gating work keeps its Rule 1 band. Count the in-progress and in-review items, with each one's age and last activity (commit, PR, comment). Flag each item older than the service level expectation: the 85th-percentile cycle time of issues closed in the last 90 days, from start of work to close. Record how the start was taken. **If** fewer than 20 issues closed → use two weeks, and say so. A stuck item lifts its parent, its children or its siblings. List each lift as a judgement call. Apply the blocker rule to every Step 4 edge. **Done when:** `In Flight` holds the counts, ages, target, blocker moves and stuck lifts.
161
+ - [ ] **Step 6 — Rank:** Apply `Ranking Rules` to every in-scope issue. Record every Rule 1 override (label against body) and its label correction. Record every Rule 2 move with its signal and the launch target read. **If** a band changed since the previous report while none of the body, labels or in-flight neighbours changed → one of the two passes misapplied a rule; say which. **If** a maintenance check belongs as a gate → send it to `bkit-audit-gates`, and give it no band here. **If** this is a mini-pass → run this step on the unsized or unprioritised subset only. **If** this is a monthly clock pass → apply the eight-week launch moves and stuck lifts only. **Done when:** `Ranking` lists every override, move and band change.
162
+ - [ ] **Step 7 — Size:** Apply `Size Scale` to every in-scope issue. **Done when:** `Sizes` has a row per in-scope issue.
163
+
164
+ - [ ] **Step 8 — Order:** The four bands leave issues tied. Order each ready-lane band, and report the top ten. The proposal does not invent an order field. (1) Inside `High`, blockers of `Urgent` issues go first, then severity decides. A defect with a ledger or audit `CRITICAL` goes before one with `HIGH`, and both go before the rest. Severity orders issues within a band, and never moves the band. (2) Order by cost of delay ÷ size (WSJF). Score each of these 1-3: user or business value, time-criticality, and risk reduced or work unblocked. Divide the sum by the size: XS 1, S 2, M 3, L 5, XL 8. **If** two issues tie → the older issue goes first. This is a simplified WSJF; the standard uses modified Fibonacci for each part and for job size. (3) **If** any demand signal exists (error-tracker volume, store reviews, analytics, support, previous-product users) → raise the value score, and name the source. **If** none exists → say so, and do not guess. **Done when:** `Order` holds the top ten with their scores.
165
+ - [ ] **Step 9 — Shipped:** For each issue closed since the previous report, join its ship outcome through the closing PR (lines changed, duration). Compare it with the size given. **If** sizes overlap heavily in lines or time → the size table no longer means what it says; propose a change in `Process Improvements`. **Done when:** `Shipped` holds the comparison, or says there are no outcomes.
166
+ - [ ] **Step 10 — Propose:** Propose one size and one priority for each open item outside the done lane, off-board items included, from Steps 6-7. Before the report is finished, check that the proposal set equals the open-issue list (Step 2), because otherwise a missing issue goes unnoticed. This run does not write fields. The distribution before (fields as read) and after (the proposal) leads `Summary`. Put every call the owner might overturn in `Judgement Calls` (stuck lifts, won't-do, stale, duplicate closes, uncertain bands), each with a recommendation and what would settle it. **Done when:** `Proposal` covers every in-scope item, and `Judgement Calls` holds the calls.
167
+ - [ ] **Step 11 — 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 anchor-standard practice (within-band order, classes of service, WIP, and work-item age, definition of ready, severity against priority, dependencies), each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) 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.
168
+ - [ ] **Step 12 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches prioritisation: board fields and options, lanes, labels, milestones, issue templates, and the two rules. (b) In a bounded pass of about 30 minutes, note what a senior delivery lead would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status), 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`.
174
169
 
175
170
  ### 🔒 Gate 2: Probes Check
176
171
 
177
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
178
-
179
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent. Monthly clock pass → Steps 7, 8, 9, and 10 explicit skip; Step 2 membership only.
180
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
181
- - [ ] **Membership:** open-issue list read separately from board; every off-board issue, stale card listed.
182
- - [ ] **Links:** parent, milestone, blocked-by recorded per open issue; blocked-by from all three Step 4 sources.
183
- - [ ] **Proposal complete:** every open item outside Done has proposed size and priority; proposal set equals open-issue list. Monthly clock pass → previous proposal stands, plus stale calls, stuck lifts, eight-week moves.
172
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
173
+ - [ ] **Clock pass skips:** a monthly clock pass skips Steps 7, 8, 9 and 10 explicitly.
174
+ - [ ] **Clock pass membership:** in a monthly clock pass, Step 2 covers membership only.
175
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
176
+ - [ ] **Membership:** the open-issue list was read separately from the board.
177
+ - [ ] **Off-board listed:** every off-board issue and every stale card is listed.
178
+ - [ ] **Links:** each open issue has its parent, milestone and blocked-by recorded.
179
+ - [ ] **Blocked-by sources:** blocked-by links come from all three Step 4 sources.
180
+ - [ ] **Proposal complete:** every open item outside Done has a proposed size and priority, or this is a monthly clock pass.
181
+ - [ ] **Proposal set:** the proposal set equals the open-issue list, or this is a monthly clock pass.
182
+ - [ ] **Clock pass proposal:** a monthly clock pass keeps the previous proposal, plus the stale calls, stuck lifts and eight-week moves.
184
183
  - [ ] **Tracker untouched:** no tracker field, label, comment, or issue was written.
185
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
184
+ - [ ] **Gate 2 — Verified:** every item above holds.
186
185
 
187
186
  ## Findings
188
187
 
189
188
  <!-- prettier-ignore -->
190
189
  | Severity | Use |
191
190
  | --- | --- |
192
- | `CRITICAL` | Security issue proposed more than one band down, or non-security proposed as `Urgent` (the data-loss exception in `Ranking Rules` is allowed) |
193
- | `HIGH` | Launch-gating work the rules forbid moving down; blocker left below the issue it blocks; security issue moved down for "no users yet" |
194
- | `MEDIUM` | Rule 1 override with no label correction; ready-lane item not ready; stale or duplicate still treated as open work; band change whose body, labels, and in-flight neighbours did not change; in-flight item older than the service level expectation; off-board issue; blocked-by prose only, or structured link vs body block disagree; blocked issue in ready or later lane, blocker open; blocked-by cycle; open child, closed parent; closed / past-due milestone with open issues |
195
- | `LOW` | Won't-do candidate; label correction that changes no band; within-band order only; stale card; closed blocker still listed; parent named in body, no link; child outside parent's milestone; milestone named in body, field empty; empty open milestone |
191
+ | `CRITICAL` | A security issue proposed more than one band down, or non-security work proposed as `Urgent` (the data-loss exception in `Ranking Rules` is allowed) |
192
+ | `HIGH` | Launch-gating work the rules forbid moving down. A blocker left below the issue it blocks. A security issue moved down for "no users yet" |
193
+ | `MEDIUM` | A Rule 1 override with no label correction. A ready-lane item that is not ready. A stale or duplicate issue still treated as open work. A band change whose body, labels, and in-flight neighbours did not change. An in-flight item older than the service level expectation. An off-board issue. A blocked-by link in prose only, or a structured link and body block that disagree. A blocked issue in a ready or later lane while its blocker is open. A blocked-by cycle. An open child with a closed parent. A closed / past-due milestone with open issues |
194
+ | `LOW` | A won't-do candidate. A label correction that changes no band. Within-band order only. A stale card. A closed blocker still listed. A parent named in the body with no link. A milestone named in the body while the field is empty. A milestone that breaks the repo's own milestone pattern |
196
195
 
197
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: security-band mistakes first.
196
+ Within a severity, list security-band mistakes first.
198
197
 
199
- Ranked issues are not findings. Their output is the proposed priority. Findings are stale, duplicate, not-ready, mis-ranked, stuck, off-board, and broken links.
198
+ Ranked issues are not findings; their output is the proposed priority. The findings are stale, duplicate, not-ready, mis-ranked, stuck and off-board issues, and broken links.
200
199
 
201
200
  <!-- prettier-ignore -->
202
201
  | ID | Severity | Location | Evidence | Expected |
203
202
  | --- | --- | --- | --- | --- |
204
203
  | PENDING | PENDING | PENDING | PENDING | PENDING |
205
204
 
206
- Empty and clean → one row `None`.
205
+ **If** the run finds nothing → write one row: `None`.
207
206
 
208
207
  ## Report
209
208
 
@@ -284,17 +283,18 @@ PENDING
284
283
 
285
284
  ### 🔒 Gate 3: Report Check
286
285
 
287
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
288
-
289
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
290
- - [ ] **Summary:** names count per severity, the size and priority distribution before and after the proposal; off-board and broken-link counts.
291
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
292
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
293
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
294
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
295
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
296
-
297
- > `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.
286
+ - [ ] **No placeholders:** no `PENDING` is left.
287
+ - [ ] **Summary:** `Summary` gives the count per severity.
288
+ - [ ] **Distribution:** `Summary` gives the size and priority distribution before and after the proposal.
289
+ - [ ] **Off-board count:** `Summary` gives the off-board count.
290
+ - [ ] **Broken-link count:** `Summary` gives the broken-link count.
291
+ - [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
292
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
293
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
294
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
295
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
296
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
297
+ - [ ] **Gate 3 — Verified:** every item above holds.
298
298
 
299
299
  <!-- bkit:end -->
300
300