@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,135 +1,159 @@
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
  # Deferrals Triage
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Verdict on every open deferral — already done, superseded, tracked, parked, or in-scope work that should have been finished.
10
+ > **Purpose:** A verdict on every open deferral: already done, superseded, tracked, parked, or in-scope work that should have been finished.
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - NEVER append or edit a ledger line. Correction and close rows live in `Expected` only. `ts` is minted at append (`.bkit/jsonl.md` § Write Idiom), never written in this report.
15
- > - A winning row whose `ts` is in the future outranks every correction. Name its `key`. Do not invent a later `ts`.
14
+ > - NEVER append or edit a ledger line. Write each correction and close row in `Expected` only.
15
+ > - Leave `ts` out of every row in this report. The writer mints it when it appends the row (`.bkit/jsonl.md` § Write Idiom).
16
+ > - A winning row whose `ts` is in the future outranks every correction. Name its `key` rather than inventing a later `ts`.
16
17
 
17
18
  ## Universal Instructions
18
19
 
19
20
  ### Context & Goals
20
21
 
21
- Deferred work appends rows; nothing re-reads them. Three drifts: silently done (landed, row still not `CLOSED`); superseded (surface rewritten or removed); genuinely deferred and untracked (real work, no tracker issue). Target failure: **an open row the code has already finished, or a real deferral with nothing carrying it** — e.g. `RESOLVED` or `SUPERSEDED` left open because only `CLOSED` is done, or a deferral whose only record is a comment on a closed issue. Deliberate debt only (prudent and deliberate quadrant).
22
+ Deferred work adds rows to `docs/deferrals.jsonl`, and nothing reads them again. Rows drift in three ways: the work is silently done (it landed, but the row is still not `CLOSED`), superseded (its surface was rewritten or removed), or genuinely deferred and untracked (real work with no tracker issue). The failure this audit targets is an open row whose work the code has already finished, or a real deferral that nothing carries. Examples: a row left at `RESOLVED` or `SUPERSEDED` because only `CLOSED` counts as done, or a deferral whose only record is a comment on a closed issue. The register holds deliberate debt only (the prudent and deliberate quadrant).
22
23
 
23
- **Applies when:** `docs/deferrals.jsonl` exists, or a workflow writes `kind: "deferral"`. None → one `N/A` row with evidence, never "clean".
24
+ **Applies when:** `docs/deferrals.jsonl` exists, or a workflow writes `kind: "deferral"`. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
24
25
 
25
- **Cadence:** once per ship cycle; at least monthly when no cycle ships. Extra pass after release, or after another audit records deferred items (e.g. `bkit-audit-app-performance`).
26
+ **Cadence:** Run once per ship cycle, and at least once a month when no cycle ships. Run an extra pass after a release, or after another audit records deferred items (e.g., `bkit-audit-app-performance`).
26
27
 
27
28
  **Anchor Standards:**
28
29
 
29
- - Technical debt, principal, and interest, and the Technical Debt Quadrant (e.g. Martin Fowler).
30
- - Hotspot analysis, churn against code health (e.g. CodeScene).
31
- - Review of deferred problem records on a schedule and on release: activate, keep deferred, or close (e.g. ITIL-aligned known-error monitoring).
30
+ - Technical debt, principal, and interest, and the Technical Debt Quadrant (e.g., Martin Fowler).
31
+ - Hotspot analysis, churn against code health (e.g., CodeScene).
32
+ - Review of deferred problem records on a schedule and on release: activate, keep deferred, or close (e.g., ITIL-aligned known-error monitoring).
32
33
  - `.bkit/jsonl.md` § Deferral Reason — `reason` enum and the four `unjustified` tests, at the installed bkit version.
33
34
 
34
35
  ### Scope
35
36
 
36
- - Fold `docs/deferrals.jsonl` last-row-wins. Open = winning `status != "CLOSED"`.
37
- - Data defects on the winning row: `ts`, `status`, `reason`. The row to append goes in `Expected`.
37
+ - Fold `docs/deferrals.jsonl` last-row-wins. A row is open when its winning row has `status != "CLOSED"`.
38
+ - Check the winning row for data defects in `ts`, `status` and `reason`, and put the row to append in `Expected`.
38
39
  - Verify every open row against source before any verdict.
39
40
  - Re-test each `reason`, and each `KEEP` trigger.
40
- - Carrying cost: 90-day churn, related `docs/failures.jsonl` and `.bkit/friction.jsonl` rows.
41
- - Tracker issues rows point at. Deferrals that exist only as comments on closed issues.
42
- - `unjustified` adjudication (four tests). Report the row. Do not append.
43
- - Trend: open count, inflow, outflow, age, missing `severity` or `reason`, rows verified / rows open.
41
+ - Measure the carrying cost: 90-day churn, and the related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl`.
42
+ - Check the tracker issues that rows point at.
43
+ - Find the deferrals that exist only as comments on closed issues.
44
+ - Adjudicate `unjustified` with the four tests, and report the row without appending it.
45
+ - Track the trend: open count, inflow, outflow, age, rows missing `severity` or `reason`, and rows verified / rows open.
44
46
 
45
47
  ### Out of Scope
46
48
 
47
49
  <!-- prettier-ignore -->
48
50
  | Excluded item | Why | Where it belongs |
49
51
  | --- | --- | --- |
50
- | Reckless and inadvertent debt | Not in this register | `bkit-audit-slop`, `bkit-audit-architecture`, `bkit-audit-dead-code` |
51
- | Known bugs | Failure ledger | `bkit-audit-failures` |
52
- | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | Ledger writes. Utility reads every winning row not `CLOSED` | `@bkit-utility-update-deferrals` |
53
- | Doing the deferred work; opening tracker issues | Audit reports only | Plan from this report |
52
+ | Reckless and inadvertent debt | It is not in this register | `bkit-audit-slop`, `bkit-audit-architecture`, `bkit-audit-dead-code` |
53
+ | Known bugs | They belong in the failure ledger | `bkit-audit-failures` |
54
+ | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | These are ledger writes. The utility reads every winning row that is not `CLOSED` | `@bkit-utility-update-deferrals` |
55
+ | Doing the deferred work; opening tracker issues | The audit only reports | A plan made from this report |
54
56
 
55
57
  ### Verdicts
56
58
 
57
- One per verified row.
59
+ Give each verified row one verdict.
58
60
 
59
- - **DONE:** already landed. `Expected` = `CLOSED` same-`key` row. Cite `file:line`.
60
- - **SUPERSEDED:** no longer applies (moved, rewritten, removed, or N/A). `Expected` = `CLOSED` row and the reason.
61
- - **TRACKED:** genuinely deferred, an open issue already covers it. `Expected` = the issue to point the row at, or the acceptance criteria to extend.
62
- - **NEEDS ISSUE:** genuinely deferred, real work, untracked. `Expected` = the issue to open.
63
- - **KEEP:** genuinely deferred, correctly parked, not worth an issue yet (tripwire or contingent). `Expected` = no action, and the trigger.
64
- - **SMALL:** small enough for the next cycle. This run does not do it.
65
- - **ACCEPTED:** still true, and deliberately never to be done. `Expected` = who decides, and the `CLOSED` row to append once signed off. Record it. Do not wait.
66
- - **UNJUSTIFIED:** all four tests hold. `Expected` = same-`key` row, `reason: "unjustified"`, the failed test named in `description`, `status: "TRIAGED"`. Later rows carry `reason` verbatim. Work goes back in scope via a plan.
67
- - **OTHER:** fits none. Say what it is, why, and where it goes. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
61
+ - **DONE:** the work already landed. `Expected` = the `CLOSED` row with the same `key`. Cite `file:line`.
62
+ - **SUPERSEDED:** the row no longer applies (its surface moved, was rewritten or removed, or is N/A). `Expected` = the `CLOSED` row and the reason.
63
+ - **TRACKED:** the work is genuinely deferred, and an open issue already covers it. `Expected` = the issue to point the row at, or the acceptance criteria to extend.
64
+ - **NEEDS ISSUE:** the work is genuinely deferred, real and untracked. `Expected` = the issue to open.
65
+ - **KEEP:** the work is genuinely deferred, correctly parked, and not yet worth an issue (a tripwire or a contingent item). `Expected` = no action, and the trigger.
66
+ - **SMALL:** the work is small enough for the next cycle. This run does not do it.
67
+ - **ACCEPTED:** the row is still true, and the work is deliberately never to be done. `Expected` = who decides, and the `CLOSED` row to append once they sign off. Record the verdict without waiting for the sign-off.
68
+ - **UNJUSTIFIED:** all four tests hold. `Expected` = a row with the same `key`, `reason: "unjustified"`, the failed test named in `description`, and `status: "TRIAGED"`. Later rows carry `reason` word for word. The work goes back in scope through a plan.
69
+ - **OTHER:** it fits no other verdict. Say what it is, why, and where it goes. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
68
70
 
69
- **DONE is the verdict most likely to be wrong.** Plausible commit message != evidence. DONE or SUPERSEDED needs positive reason — commit, deleted file, or new owner module. Empty query is not absence.
71
+ **Close evidence:** DONE is the verdict most likely to be wrong, and a plausible commit message is not evidence. Give each DONE or SUPERSEDED a positive reason: a commit, a deleted file or a new owner module. An empty query does not prove absence.
70
72
 
71
- **UNJUSTIFIED** when all four hold (`.bkit/jsonl.md` § Deferral Reason):
73
+ Set UNJUSTIFIED when all four tests hold (`.bkit/jsonl.md` § Deferral Reason):
72
74
 
73
75
  1. `remediation` names specific files and a bounded edit, not a new architecture.
74
76
  2. The surface is inside files the cycle already touched.
75
- 3. No external blocker: no missing decision, credential, upstream fix, or confirmation.
76
- 4. `reason` is `scope-declared`, and the row is the only place it was called out of scope. Test 4 carries the weight.
77
+ 3. No external blocker exists: no missing decision, credential, upstream fix or confirmation.
78
+ 4. `reason` is `scope-declared`, and the row is the only place the work was called out of scope. Test 4 carries the most weight.
79
+
80
+ When you repair a missing or illegal `reason`, use one of the first four enum values, never `unjustified`. Set `unjustified` in Step 9 only.
81
+
82
+ **KEEP needs a trigger:** Each KEEP row names its trigger, such as "before launch", "when N users" or a dependency version.
77
83
 
78
- Never set `unjustified` while repairing a missing or illegal `reason`. That repair uses one of the first four enum values. This step is the only place `unjustified` is set.
84
+ - **If** the row has no trigger, **or** its trigger has fired → give it another verdict.
85
+ - **If** the row is on its third KEEP in a row → give it NEEDS ISSUE or ACCEPTED.
79
86
 
80
- **KEEP needs a trigger** ("before launch", "when N users", a dependency version). No trigger, or trigger fired → another verdict. Row on third consecutive KEEP → NEEDS ISSUE or ACCEPTED.
87
+ **Cluster:** Group the open rows by package and `category`.
81
88
 
82
- **Cluster** open rows by package and `category`. 3+ in one group → one `own-cycle` issue in `Expected`, not one per row.
89
+ - **If** a group holds 3 or more rows → propose one `own-cycle` issue for the group in `Expected`, not one per row.
83
90
 
84
91
  ### Pre-Flight / Dependencies
85
92
 
86
93
  #### Core
87
94
 
88
- - [ ] **Permissions:** blocked calls recorded
89
- - [ ] **Ledger:** Steps 3-9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
90
- - [ ] **Git History:** Steps 2, 7 — commits since the previous report, 90-day churn. Fallback: closures and churn `Not Checked`.
91
- - [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
95
+ - [ ] **Permissions:** every blocked call is recorded.
96
+ - [ ] **Ledger:** Steps 3-9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: **If** the file is absent → write one `N/A` row after Step 3, then **STOP**.
97
+ - [ ] **Git History:** Steps 2, 7 — the commits since the previous report, and 90-day churn. Fallback: mark closures and churn `Not Checked`.
98
+ - [ ] **Web:** Step 10 — fetch the anchor standards. Fallback: record the versions as unread.
92
99
 
93
100
  #### Conditional
94
101
 
95
- - [ ] **Language Server:** Typed language → Steps 5, 6 — symbol location and callers, e.g. Serena, `tsserver`. Fallback: text search. A close that needs a caller set stays a hypothesis until corroborated.
96
- - [ ] **Tracker:** Issues wired → Steps 6, 8 — open issue, acceptance criteria, comments on issues closed since the previous report. Fallback: tracker pointers `Not Checked`.
97
- - [ ] **Run Stats:** `.bkit/stats.jsonl` has `outcome` rows → Step 3 — sum `deferralsAdded`. Fallback: inflow `Not Checked`.
102
+ - [ ] **Language Server:** **If** the language is typed → Steps 5, 6 — symbol location and callers (e.g., Serena, `tsserver`). Fallback: text search. A close that needs a caller set stays a hypothesis until something corroborates it.
103
+ - [ ] **Tracker:** **If** issues are wired → Steps 6, 8 — open issues, acceptance criteria, and comments on the issues closed since the previous report. Fallback: mark tracker pointers `Not Checked`.
104
+ - [ ] **Run Stats:** **If** `.bkit/stats.jsonl` has `outcome` rows → Step 3 — sum `deferralsAdded`. Fallback: mark inflow `Not Checked`.
98
105
 
99
106
  ### 🔒 Gate 1: Prerequisites Check
100
107
 
101
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
102
- - [ ] **Gate 1 — Verified:** All Core items checked. All applicable Conditional items checked.
108
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
109
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
103
110
 
104
111
  ### Probe Steps
105
112
 
106
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
107
- - [ ] **Step 2 — Closures:** Re-verify every DONE and SUPERSEDED row from the previous report at `HEAD`. Each that no longer holds = finding, with what changed. **Done when:** `Closures` holds every row, each failure, and the failure rate, or run marked baseline.
108
- - [ ] **Step 3 — Fold:** Last-row-wins per `key`, not per line. Append-only (`.gitattributes` `merge=union`); editing a line keeps stale copy beside replacement. Highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row). Non-numeric `ts` on a `key` → last line in file is latest. Open = every winning row with `status != "CLOSED"`, including `TRIAGED`, `RESOLVED`, `BLOCKED`, `SUPERSEDED`, `CANCELLED`, free text after the word, missing `status`, and any value outside the enum. Finished-looking words != done. Order: `CRITICAL`, then `HIGH`, then oldest `ts`. Compare `severity` case-insensitively. No `severity` → assign with verdict. Trend vs previous report: open count; inflow = sum `deferralsAdded` on `outcome` rows in `.bkit/stats.jsonl` since previous run where field exists; outflow = rows that became `CLOSED` since; age histogram by `ts`; share of open rows missing `severity` or `reason`. Large open set may be partial pass → record rows verified / rows open. Invisible to fold: deferral with no `key`, or recorded only in a PR description. **Done when:** `Trend` holds counts, histogram, inflow, outflow, missing-field share, verified / open, and those limits, or `N/A` and STOP.
109
- - [ ] **Step 4 — Defects:** Winning row of each `key`. Do not append. `Expected` = row writer appends: copy latest row, change only defective field, same `key`, `ts` minted at append, never literal and never in the future.
113
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
114
+ - [ ] **Step 2 — Closures:** Re-verify at `HEAD` every DONE and SUPERSEDED row from the previous report. Record each one that no longer holds as a finding, with what changed. **Done when:** `Closures` holds every row, each failure and the failure rate, or the run is marked baseline.
115
+ - [ ] **Step 3 — Fold:** Fold the ledger last-row-wins per `key`, not per line. The ledger is append-only (`.gitattributes` `merge=union`), so editing a line leaves the stale copy beside its replacement.
116
+ - The row with the highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row).
117
+ - **If** a `key` has a non-numeric `ts` → the last line in the file is the latest.
118
+ - A row is open when its winning row has `status != "CLOSED"`. That includes `TRIAGED`, `RESOLVED`, `BLOCKED`, `SUPERSEDED`, `CANCELLED`, free text after the word, a missing `status` and any value outside the enum, because a word that looks finished does not mean done.
119
+ - Order the open rows `CRITICAL` first, then `HIGH`, then oldest `ts`.
120
+ - Compare `severity` case-insensitively.
121
+ - **If** a row has no `severity` → assign one with its verdict.
122
+ - Compare each of these figures with the previous report:
123
+ - The open count.
124
+ - Inflow: the sum of `deferralsAdded` on `outcome` rows in `.bkit/stats.jsonl` since the previous run, where the field exists.
125
+ - Outflow: the rows that became `CLOSED` since the previous run.
126
+ - An age histogram by `ts`.
127
+ - The share of open rows missing `severity` or `reason`.
128
+ - Record rows verified / rows open on every run, because a large open set may get only a partial pass.
129
+ - Record the fold's limits: it cannot see a deferral with no `key`, or one recorded only in a PR description.
130
+
131
+ **Done when:** `Trend` holds the counts, the histogram, inflow, outflow, the missing-field share, verified / open and those limits, or `N/A` is recorded → **STOP**.
132
+
133
+ - [ ] **Step 4 — Defects:** Check the winning row of each `key`, without appending. `Expected` = the row the writer appends: a copy of the latest row with only the defective field changed, the same `key`, and a `ts` minted at append, never a literal and never in the future.
110
134
 
111
135
  <!-- prettier-ignore -->
112
136
  | Field | Defect | Expected row |
113
137
  | --- | --- | --- |
114
- | `ts` | Not numeric Unix milliseconds: a string, seconds, or missing. Fold order is then undefined | The same row with a fresh `ts` |
115
- | `status` | Outside `OPEN` / `TRIAGED` / `CLOSED` (`RESOLVED`, `BLOCKED`, `SUPERSEDED`, free text) | `TRIAGED` where the row records analysis, otherwise `OPEN`, old word kept in `description`. `CLOSED` comes only from a verdict |
116
- | `reason` | Missing, or outside `scope-declared` / `hard-blocked` / `needs-decision` / `own-cycle` / `low-severity` / `unjustified` | One of the first four the row's text supports, old text kept in `description`. Never `unjustified`; `low-severity` only on a `LOW` row |
138
+ | `ts` | Not numeric Unix milliseconds: a string, seconds, or missing. The fold order is then undefined | The same row with a fresh `ts` |
139
+ | `status` | Outside `OPEN` / `TRIAGED` / `CLOSED` (`RESOLVED`, `BLOCKED`, `SUPERSEDED`, free text) | `TRIAGED` where the row records analysis, otherwise `OPEN`, with the old word kept in `description`. `CLOSED` comes only from a verdict |
140
+ | `reason` | Missing, or outside `scope-declared` / `hard-blocked` / `needs-decision` / `own-cycle` / `low-severity` / `unjustified` | One of the first four values that the row's text supports, with the old text kept in `description`. Never `unjustified`, and `low-severity` only on a `LOW` row |
117
141
 
118
- Winning row with future `ts` → finding names `key` for owner. No correction row. **Done when:** count of each defect, and each `Expected` row, in `Defects`, or `none`.
142
+ **If** a winning row has a future `ts` → name its `key` in a finding for the owner, and propose no correction row. **Done when:** `Defects` holds the count of each defect and each `Expected` row, or `none`.
119
143
 
120
- - [ ] **Step 5 — Source:** No verdict before this step. Outstanding-work claims as unreliable as done claims.
144
+ - [ ] **Step 5 — Source:** Give no verdict before this step. Claims of outstanding work are as unreliable as claims of done work.
121
145
 
122
146
  <!-- prettier-ignore -->
123
147
  | Row claims | Check with |
124
148
  | --- | --- |
125
- | "`X` should be extracted, renamed, or consolidated" | Language server, symbol lookup. Exists, and at what path now? A symbol that moved is SUPERSEDED |
126
- | "Every caller of `Y` still does Z" | Language server, references, then read the callers. This is DONE evidence |
149
+ | "`X` should be extracted, renamed, or consolidated" | Language server symbol lookup: does it exist, and at what path now? A symbol that moved is SUPERSEDED |
150
+ | "Every caller of `Y` still does Z" | Language server references, then read the callers. This is DONE evidence |
127
151
  | "The guard is missing at N sites" | Text search for the literal signature. Counting sites is a pattern question |
128
152
  | Migrations, workflows, SQL, docs, or other ledgers | Text search. A language server reads one language |
129
153
 
130
- Pace reference queries. Re-run empty or surprisingly low results before close verdict. Partial answer indistinguishable from real. Empty is inconclusive, not absence. **Done when:** every row verified this pass has evidence and the tool on its finding. Unverified rows stay counted in `Trend` and are not passed.
154
+ Pace the reference queries. Re-run an empty or surprisingly low result before giving a close verdict, because a partial answer looks the same as a real one. An empty result is inconclusive, not proof of absence. **Done when:** every row verified this pass has its evidence and the tool on its finding. Unverified rows stay counted in `Trend`, and are not passed.
131
155
 
132
- - [ ] **Step 6 — Reasons:** `reason` = why deferred. Each value implies a check. Re-test enum value Step 4 assigned the same way. UNJUSTIFIED replaces it only when Step 9's four tests hold.
156
+ - [ ] **Step 6 — Reasons:** `reason` records why the row was deferred, and each value implies a check. Re-test the enum value that Step 4 assigned in the same way. UNJUSTIFIED replaces a value only when Step 9's four tests hold.
133
157
 
134
158
  <!-- prettier-ignore -->
135
159
  | `reason` | Check |
@@ -137,14 +161,14 @@ Pace reference queries. Re-run empty or surprisingly low results before close ve
137
161
  | `hard-blocked` | Is the blocker the row names still there? |
138
162
  | `needs-decision` | Was the decision made since? Search `docs/decisions.jsonl` |
139
163
  | `own-cycle` | Does a plan or an issue for it exist? |
140
- | `low-severity` | Still `LOW`? Never `unjustified` by the four tests |
164
+ | `low-severity` | Is it still `LOW`? The four tests never make it `unjustified` |
141
165
  | `scope-declared` | Does the cited doc section exist, and does it predate the row? |
142
166
 
143
- Blocker lifted = highest-yield finding. Flag on verdict. Apply KEEP trigger rule. **Done when:** every verified row's reason, and every KEEP trigger, has a result on the finding.
167
+ A lifted blocker is the highest-yield finding, so flag it on the verdict. Apply the KEEP trigger rule. **Done when:** every verified row's reason and every KEEP trigger has a result on its finding.
144
168
 
145
- - [ ] **Step 7 — Cost:** Severity = gap badness, not carry cost. Each row still open after Step 6: churn = commits touching surface in last 90 days (e.g. `git log --since=90.days --oneline -- <path>`); related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl` on same symbol or path. High churn + related failures → raise severity. Risk already a failure row = live bug: pair failure `key`, raise severity, name `bkit-audit-failures` for bug triage. **Done when:** `Cost` row per surviving open row: churn, related keys, severity change.
146
- - [ ] **Step 8 — Pointers:** (a) TRACKED: open issue acceptance criteria include deferred scope; issue not stale and not `Low` across 3+ `bkit-audit-issues` passes. Either fails → say which: extend criteria, or verdict NEEDS ISSUE. (b) Row pointing at closed issue: read what closed it. DONE if scope landed, NEEDS ISSUE if dropped. (c) Deferrals with no row: each issue closed since previous report → read closing comments for deferred items. No row keyed → `Expected` = row to append. **Done when:** `Pointers` lists issue checks and comment-only deferrals, or `none`.
147
- - [ ] **Step 9 — Classify:** Every row as Step 5 left it gets one verdict. Adjudicate `unjustified` here, and only here. Cluster before naming issues. `needs-decision` and every ACCEPTED row → `Decisions` with who decides. This run does not append, open issues, or do the work.
169
+ - [ ] **Step 7 — Cost:** Severity measures how bad the gap is, not what it costs to carry. For each row still open after Step 6, measure churn: the commits touching its surface in the last 90 days (e.g., `git log --since=90.days --oneline -- <path>`). Find the related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl` on the same symbol or path. **If** churn is high **and** related failures exist → raise the severity. **If** the risk is already a failure row → treat it as a live bug: pair the failure `key`, raise the severity, and name `bkit-audit-failures` for the bug triage. **Done when:** `Cost` holds one row per surviving open row, with its churn, related keys and severity change.
170
+ - [ ] **Step 8 — Pointers:** (a) For each TRACKED row, check that the open issue's acceptance criteria include the deferred scope, and that the issue is not stale and has not been `Low` across 3 or more `bkit-audit-issues` passes. **If** either check fails → say which fix applies: extend the criteria, or give the verdict NEEDS ISSUE. (b) For each row that points at a closed issue, read what closed it. **If** the scope landed → DONE. **If** the scope was dropped → NEEDS ISSUE. (c) For each issue closed since the previous report, read its closing comments for deferred items. **If** a deferred item has no row keyed to it → `Expected` = the row to append. **Done when:** `Pointers` lists the issue checks and the comment-only deferrals, or `none`.
171
+ - [ ] **Step 9 — Classify:** Give every row, as Step 5 left it, one verdict. Adjudicate `unjustified` here, and only here. Cluster the rows before naming issues. Put every `needs-decision` row and every ACCEPTED row in `Decisions`, with who decides. This run does not append rows, open issues or do the work.
148
172
 
149
173
  <!-- prettier-ignore -->
150
174
  | Finding | Expected |
@@ -163,37 +187,38 @@ Blocker lifted = highest-yield finding. Flag on verdict. Apply KEEP trigger rule
163
187
  | Data defect | The correction row, or the future-`ts` key for the owner |
164
188
  | OTHER | Where it goes |
165
189
 
166
- **Done when:** every verified row has one verdict. `Decisions` lists each `needs-decision` and ACCEPTED row with who decides, or `none`.
190
+ **Done when:** every verified row has one verdict, and `Decisions` lists each `needs-decision` and ACCEPTED row with who decides, or `none`.
167
191
 
168
- - [ ] **Step 10 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per practice (principal and interest, debt quadrant, hotspots, review triggers for deferred records) and per `reason` value → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
169
- - [ ] **Step 11 — Anything Else:** (a) Everything changed since previous report's commit touching deferrals (schema and writers in `.bkit/jsonl.md`, design, plan, build, and ship steps that write rows, ship deferral check `@bkit-ship-deferred-sweep`, issues rows point at) → one-line verdict each. (b) Bounded ~30 min pass: what a senior EM owning a technical-debt register flags that no step asks; read since previous run (incidents, `bkit-audit-logs` sweeps, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
192
+ - [ ] **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 practice (principal and interest, the debt quadrant, hotspots, review triggers for deferred records) and one per `reason` value, each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
193
+ - [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches deferrals: the schema and writers in `.bkit/jsonl.md`, the design, plan, build and ship steps that write rows, the ship deferral check `@bkit-ship-deferred-sweep`, and the issues that rows point at. (b) In a bounded pass of about 30 minutes, note what a senior EM owning a technical-debt register would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` sweeps, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
170
194
 
171
195
  ### 🔒 Gate 2: Probes Check
172
196
 
173
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
174
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
175
- - [ ] **Read-only:** no ledger line, code, or config changed. Every correction and close row is `Expected` only.
176
- - [ ] **Positive close:** every DONE and SUPERSEDED cites a positive reason, never an empty query.
177
- - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
197
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
198
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
199
+ - [ ] **Read-only:** no ledger line, code or config changed.
200
+ - [ ] **Rows proposed only:** every correction and close row is marked `Expected`.
201
+ - [ ] **Positive close:** every `DONE` and `SUPERSEDED` cites a positive reason, never an empty query.
202
+ - [ ] **Gate 2 — Verified:** every item above holds.
178
203
 
179
204
  ## Findings
180
205
 
181
206
  <!-- prettier-ignore -->
182
207
  | Severity | Use |
183
208
  | --- | --- |
184
- | `CRITICAL` | Deferred gap is data loss, a security hole, or a broken workflow with no workaround. Risk already showing as a `CRITICAL` failure |
185
- | `HIGH` | Blocker has lifted on work that still does real damage. Deferral paired with a failure row. Unjustified in-scope work that has a workaround |
186
- | `MEDIUM` | Data defect (`ts`, `status`, `reason`). KEEP whose trigger has fired. Real work with no issue. Reason no longer holds |
187
- | `LOW` | KEEP with no trigger. Missing `severity`. Locator drift. Superseded surface that changes no result |
209
+ | `CRITICAL` | The deferred gap is data loss, a security hole, or a broken workflow with no workaround. The risk already shows as a `CRITICAL` failure |
210
+ | `HIGH` | A blocker has lifted on work that still does real damage. A deferral is paired with a failure row. Unjustified in-scope work has a workaround |
211
+ | `MEDIUM` | A data defect (`ts`, `status`, `reason`). A KEEP whose trigger has fired. Real work with no issue. A reason that no longer holds |
212
+ | `LOW` | A KEEP with no trigger. A missing `severity`. Locator drift. A superseded surface that changes no result |
188
213
 
189
- Within a severity: oldest `ts` first. Finding keeps severity when it becomes a ledger row or an issue. Row bucket = ledger severity, or verdict-assigned.
214
+ Within a severity, list the oldest `firstTs` first, using `ts` where `firstTs` is absent. A finding keeps its severity when it becomes a ledger row or an issue. A row's severity is its ledger `severity`, or the one its verdict assigned.
190
215
 
191
216
  <!-- prettier-ignore -->
192
217
  | ID | Severity | Verdict | Location | Evidence | Expected |
193
218
  | --- | --- | --- | --- | --- | --- |
194
219
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
195
220
 
196
- Empty and clean → one row `None`.
221
+ **If** the run finds nothing → write one row: `None`.
197
222
 
198
223
  ## Report
199
224
 
@@ -258,13 +283,17 @@ PENDING
258
283
 
259
284
  ### 🔒 Gate 3: Report Check
260
285
 
261
- - [ ] **No placeholders:** no `PENDING` left
262
- - [ ] **Summary:** names count per severity, count per verdict, and rows verified / rows open.
263
- - [ ] **Series:** `Trend` open count, inflow, and outflow beside previous report's numbers, or marked baseline.
264
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
265
- - [ ] **Process Improvements:** `Universal` and `Project` filled
266
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
267
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
286
+ - [ ] **No placeholders:** no `PENDING` is left.
287
+ - [ ] **Summary:** `Summary` gives the count per severity.
288
+ - [ ] **Verdict counts:** `Summary` gives the count per verdict.
289
+ - [ ] **Coverage:** `Summary` gives rows verified / rows open.
290
+ - [ ] **Series:** the report shows `Trend` open count, inflow, and outflow beside the previous report's numbers, or marks the run as baseline.
291
+ - [ ] **Writes:** this run changed only this report and the template's `Project Instructions`.
292
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
293
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
294
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
295
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
296
+ - [ ] **Gate 3 — Verified:** every item above holds.
268
297
 
269
298
  <!-- bkit:end -->
270
299