@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,148 +1,166 @@
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
  # Architecture Review
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Judgment on codebase shape — package graph, intended layers, server, and client boundary, and coupling the import graph cannot see.
10
+ > **Purpose:** A judgment on the codebase's shape: the package graph, the intended layers, the server and client boundary, and the coupling the import graph cannot see.
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
- > - A code graph confirms presence; a missing edge proves nothing. Corroborate every load-bearing claim with a language server or text search before it is a finding.
23
- > - Build the graph locally and code-only; NEVER send the corpus or credentials to a model backend.
14
+ > - A code graph confirms presence. A missing edge proves nothing.
15
+ > - Corroborate every load-bearing claim with a language server or text search before it becomes a finding.
16
+ > - Build the graph locally, from code only.
17
+ > - NEVER send the corpus or credentials to a model backend.
24
18
 
25
19
  ## Universal Instructions
26
20
 
27
21
  ### Context & Goals
28
22
 
29
- File reading cannot answer acyclic package graph, hub modules, or copied types. Code graph + language server fail differently: graph edges may be false; omitted edges prove nothing. Target failure: **shape enforced in a diagram or clean graph but not in source** — type-only cycle treated as runtime, manifest edge as package dependency, privileged module reachable from client bundle.
23
+ Reading files cannot show whether the package graph is acyclic, which modules are hubs, or where types were copied. A code graph and a language server fail in different ways: graph edges can be false, and edges the graph omits prove nothing. The failure this audit targets is a shape enforced in a diagram or a clean graph, but not in source. Examples: a type-only cycle treated as a runtime cycle, a manifest edge treated as a package dependency, or a privileged module reachable from the client bundle.
30
24
 
31
- **Applies when:** more than one package, or a written layer model. None → one `N/A` row with evidence, never "clean".
25
+ **Applies when:** the repo has more than one package, or a written layer model. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
32
26
 
33
- **Cadence:** quarterly. Extra pass when a cycle adds a package, moves a module, or changes path aliases or project references. Production-checklist walk = part of quarterly pass.
27
+ **Cadence:** Run once a quarter. Run an extra pass when a cycle adds a package, moves a module, or changes path aliases or project references. The walk through the production checklists is part of the quarterly pass.
34
28
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
29
+ **Anchor Standards:**
36
30
 
37
31
  - C4 model (System Context, Container, Component).
38
- - Architecture decision records (e.g. adr.github.io) and architectural fitness functions (e.g. _Building Evolutionary Architectures_).
39
- - Product quality model, nine characteristics (e.g. ISO/IEC 25010:2023).
40
- - Quality-attribute scenarios (e.g. ATAM utility tree).
41
- - Package metrics: afferent coupling (Ca), efferent coupling (Ce), instability, abstractness, Stable Dependencies Principle (e.g. Robert C. Martin).
42
- - Compiler-resolving dependency linter (e.g. dependency-cruiser, import-linter); record version.
43
- - Workspace boundary checker (e.g. `turbo boundaries`, Nx module boundaries); record version.
44
- - Layer-boundary linter (e.g. eslint-plugin-boundaries, ArchUnit).
45
- - Well-architected pillars as a lens (e.g. AWS Well-Architected, Azure Well-Architected).
46
- - Server and client component boundary, including a build-failing server-only guard (e.g. Next.js Server and Client Components, `server-only`).
47
- - Host production checklists (e.g. Vercel, Supabase, Fly).
32
+ - Architecture decision records (e.g., adr.github.io) and architectural fitness functions (e.g., _Building Evolutionary Architectures_).
33
+ - Product quality model, nine characteristics (e.g., ISO/IEC 25010:2023).
34
+ - Quality-attribute scenarios (e.g., ATAM utility tree).
35
+ - Package metrics: afferent coupling (Ca), efferent coupling (Ce), instability, abstractness, Stable Dependencies Principle (e.g., Robert C. Martin).
36
+ - Compiler-resolving dependency linter (e.g., dependency-cruiser, import-linter); record version.
37
+ - Workspace boundary checker (e.g., `turbo boundaries`, Nx module boundaries); record version.
38
+ - Layer-boundary linter (e.g., eslint-plugin-boundaries, ArchUnit).
39
+ - Well-architected pillars as a lens (e.g., AWS Well-Architected, Azure Well-Architected).
40
+ - Server and client component boundary, including a build-failing server-only guard (e.g., Next.js Server and Client Components, `server-only`).
41
+ - Host production checklists (e.g., Vercel, Supabase, Fly).
48
42
 
49
43
  ### Scope
50
44
 
51
- - Package dependency graph: cycles, back-edges, coupling metrics, fan-in, fan-out, duplicate symbols.
52
- - Conformance to a written layer matrix, public entry points, and deep imports.
53
- - Server and client boundary, and privileged modules.
54
- - Coupling with no import edge: events, data ownership, change coupling.
55
- - Shape against recorded decisions, context, and container views, and quality-attribute scenarios.
56
- - Production-checklist gaps, routed to the audit that owns each.
45
+ - Check the package dependency graph: cycles, back-edges, coupling metrics, fan-in, fan-out and duplicate symbols.
46
+ - Check conformance to a written layer matrix, public entry points and deep imports.
47
+ - Check the server and client boundary, and the privileged modules.
48
+ - Find the coupling that has no import edge: events, data ownership and change coupling.
49
+ - Compare the shape with the recorded decisions, the context and container views, and the quality-attribute scenarios.
50
+ - Find production-checklist gaps, and route each one to the audit that owns it.
57
51
 
58
52
  ### Out of Scope
59
53
 
60
54
  <!-- prettier-ignore -->
61
55
  | Excluded item | Why | Where it belongs |
62
56
  | --- | --- | --- |
63
- | Whether a symbol is reachable | Reachability, not shape | `bkit-audit-dead-code` |
64
- | Confirmed same-name copies, once named | Duplication sweep | `bkit-audit-duplication` |
65
- | Auth holes and secret exposure in depth | Security sweep | `bkit-audit-security` |
66
- | A table written from several places, in depth | Database sweep | `bkit-audit-database` |
67
- | Cold-start time and request latency | Hot paths | `bkit-audit-app-performance` |
68
- | Job retries and idempotency in depth | Reliability sweep | `bkit-audit-reliability` |
69
- | Changing packages, layers, or the graph | Audit reports only | Plan from this report |
57
+ | Whether a symbol is reachable | It is about reachability, not shape | `bkit-audit-dead-code` |
58
+ | Confirmed same-name copies, once named | The duplication audit owns them | `bkit-audit-duplication` |
59
+ | Auth holes and secret exposure in depth | The security audit owns them | `bkit-audit-security` |
60
+ | A table written from several places, in depth | The database audit owns it | `bkit-audit-database` |
61
+ | Cold-start time and request latency | The performance audit owns hot paths | `bkit-audit-app-performance` |
62
+ | Job retries and idempotency in depth | The reliability audit owns them | `bkit-audit-reliability` |
63
+ | Changing packages, layers, or the graph | The audit only reports | A plan made from this report |
70
64
 
71
65
  ### Pre-Flight / Dependencies
72
66
 
73
- **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.
74
-
75
- **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.
76
-
77
67
  #### Core
78
68
 
79
- Always verify.
80
-
81
- - [ ] **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.
82
- - [ ] **Code Graph:** Steps 2–4 — local code-only extractor, e.g. graphify via a wrapper that strips API keys. Fallback: dependency linter and text search; graph counts `Not Checked`.
83
- - [ ] **Dependency Linter:** Steps 5–6 — resolves through the compiler, e.g. dependency-cruiser, import-linter. Fallback: read import statements; say so per claim.
84
- - [ ] **Git History:** Steps 1, 9, 13 — change coupling and the diff since the previous report. Fallback: change coupling `Not Checked`.
85
- - [ ] **Web:** Step 12 — fetch anchor standards. Fallback: versions recorded as unread.
69
+ - [ ] **Permissions:** every blocked call is recorded.
70
+ - [ ] **Code Graph:** Steps 2-4 — a local, code-only extractor (e.g., graphify through a wrapper that strips API keys). Fallback: use the dependency linter and text search, and mark the graph counts `Not Checked`.
71
+ - [ ] **Dependency Linter:** Steps 5-6 — a linter that resolves through the compiler (e.g., dependency-cruiser, import-linter). Fallback: read the import statements, and say so for each claim.
72
+ - [ ] **Git History:** Steps 1, 9, 13 — change coupling and the diff since the previous report. Fallback: mark change coupling `Not Checked`.
73
+ - [ ] **Web:** Step 12 — fetch the anchor standards. Fallback: record the versions as unread.
86
74
 
87
75
  #### Conditional
88
76
 
89
- Verify only when applicable.
90
-
91
- - [ ] **Language Server:** Typed language → Steps 7, 11 — references, e.g. Serena, `tsserver`, gopls. Fallback: text search; name it per claim. Repeat any surprising low count.
92
- - [ ] **Workspace Boundaries:** Monorepo task runner with a boundaries command → Step 5 — e.g. `turbo boundaries`, Nx. Fallback: layer matrix by hand.
93
- - [ ] **Host Checklists:** Managed host → Step 10 — production checklist, e.g. vendor docs, dashboard. Fallback: docs only; live settings `Not Checked`.
77
+ - [ ] **Language Server:** **If** the language is typed → Steps 7, 11 — references (e.g., Serena, `tsserver`, gopls). Fallback: text search, and name the tool for each claim. Repeat any surprisingly low count.
78
+ - [ ] **Workspace Boundaries:** **If** a monorepo task runner has a boundaries command → Step 5 — its boundary check (e.g., `turbo boundaries`, Nx). Fallback: check the layer matrix by hand.
79
+ - [ ] **Host Checklists:** **If** the app runs on a managed host → Step 10 — the production checklist (e.g., vendor docs, dashboard). Fallback: use the docs only, and mark live settings `Not Checked`.
94
80
 
95
81
  ### 🔒 Gate 1: Prerequisites Check
96
82
 
97
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
98
-
99
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
100
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
83
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
84
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
101
85
 
102
86
  ### Probe Steps
103
87
 
104
- - [ ] **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.
105
- - [ ] **Step 2 — Graph:** Build locally, code-only, credentials stripped, via project wrapper (never bare extract). Record tool version, `built_at_commit`, node count, edge count, cross-package edge count. Graph commit ≠ reviewed `HEAD` → findings invalid; rebuild. Derived output untracked; clean rebuild deletes only that output. After path-alias change → clean rebuild — force flag that does not clear module-resolution cache keeps stale unresolved edges. Syntax-only graph (e.g. tree-sitter) does not consult language server: path aliases and manifest names are separate inputs; losing either drops edges with no error. Keep manifests in corpus so workspace imports resolve → drop manifest-to-manifest edges before matrix. Skip whole-repo render; use package and module rollups. Dated extractor backups (if the tool keeps them) accumulate; clean rebuild clears them. **Done when:** commit, counts, tool list in `Graph`, or absent tool in `Not Checked`.
106
- - [ ] **Step 3 — Report:** Read extractor report. Every finding-like section checked against source before it counts. Import cycles: type-only edges erased at compile time ≠ runtime cycle — check every edge. Cross-package edges: do not dismiss as impossible once aliases resolve; do dismiss manifest-to-manifest. God nodes: high degree = look, not defect. Community dump with numbered labels and near-zero cohesion → clustering found no structure — skip. **Done when:** each section dispositioned in `Graph`.
107
- - [ ] **Step 4 — Structure:** Query built graph, then graph file. Filters first: code only (source extensions; drop manifests and config); tests separated with repo's one test-path rule — do not type a shorter list. Test files cross boundaries; counting them as product hides shape. Views with/without test code can both be correct — record which. Dependency-shaped edges only (import, re-export, dynamic import). Nesting ≠ dependency. Name-matching edges (e.g. `indirect_call`) can invent links between unrelated files sharing a function name — exclude. Blast-radius under-reports: missed callers in anonymous callbacks, calls in module-level initialisers. Blast-radius set = starting set, never complete. Checks (each a series): (1) package dependency matrix, code-only, back-edges (library→app, leaf→consumer) — should be DAG; per workspace Ca, Ce, instability I = Ce/(Ca+Ce), abstractness (share of exported types and interfaces); flag package depending on less stable one. (2) File-level cycles (SCC over import edges); component >1 file = candidate → type-only check. (3) Fan-in: files everything imports. (4) Fan-out: most imports — barrels and god modules. (5) Duplicate symbol names: group callables by label across distinct non-test source files; ≥3 definitions = prompt. False positives: per-directory handlers, platform splits (e.g. `.native` / `.web`). Signal = type/component duplicated where canonical exists. Same grouping over test code alone. Copies without shared name → text search. Confirmed hits → `bkit-audit-duplication`. **Done when:** matrix, cycles, rankings, duplicates in `Structure`.
108
- - [ ] **Step 5 — Layers:** Back-edge hunt with no written model lets legal wrong dependency pass. Carry allowed package-layer matrix from previous report. No matrix → draft from recorded architecture decisions, mark proposed. Diff code-only matrix; every disallowed edge = candidate. Encode matrix as forbidden rules for compiler-resolving linter, config under repo-root `tmp/` only, type-only edges excluded; check extractor import cycles. Clean rule = fitness function to propose under `Process Improvements`. Run workspace boundary checker; record version; clean result = candidate for package-DAG gate, not proof. Native/restricted app: every package it imports transitively has no server-only or host-only module (e.g. `fs`, server-only import, service-role client) — forbidden rule so bundle break or client secret caught by structure. Public entry points: every workspace package declares them where the ecosystem supports it (e.g. Node `exports` map, Go `internal/`); deep imports past them = candidates. Name enforcing rule each would need. **Done when:** every disallowed edge in `Layers`, with rule that would forbid it.
109
- - [ ] **Step 6 — Boundary:** List modules importing privileged data client, service-role secret, or non-public secret; confirm each imports guard that turns client import into build error (e.g. `server-only`), where the stack has one; none → reach check alone, say so. Confirm no client-entry module reaches one transitively — client entry pulls imports into client bundle. Text search → list; linter or blast-radius → reach; `Cross-Check` confirms. **Done when:** every privileged module in `Boundary` with guard, reach, verdict.
110
- - [ ] **Step 7 — Cross-Check:** Language server answers from disk — no mid-edit staleness; resolves what tree-sitter graph cannot. Graph misses anonymous-callback callers; language server misses what project graph cannot reach. Confirm fan-in and blast-radius with references before write-up. Pace reference queries — back-to-back calls can return partial count indistinguishable from real; repeat surprising low count after pause. Empty = inconclusive. Blind spots neither tool sees: middleware guards, config-referenced files, runtime-registered handlers, mock-factory keys, packages outside language-server project graph. Text search for non-source files, string literals, unknown names. **Done when:** every load-bearing claim in `Cross-Check` names both tools, or the blind spot.
111
- - [ ] **Step 8 — References:** Pick 2–3 well-regarded OSS repos on same stack; compare shape: package boundaries, shared code location, config/env split, client code sharing. Record repo name, commit/tag, comparison. Difference = soft signal, not finding alone: report only with problem it would solve here, low-confidence, never rank above graph finding. **Done when:** repos, revisions, comparisons in `References`, or `none`.
112
- - [ ] **Step 9 — Coupling:** Three couplings carry no import edge. Events/runtime wiring: every event sent vs handler registered, plus schedules, DB triggers, outbound DB HTTP, edge functions, inbound webhooks. Flag producer without consumer, consumer without producer, two packages coupled only via event. Data ownership: table and routine call sites per package and app. Flag table written from >1 module/app; table written via privileged client from >1 place. Change coupling: file pairs in commits since previous report, different packages or clients, co-change in >half commits with no import edge. Confirmed pairs → `bkit-audit-duplication`. **Done when:** events, tables, pairs in `Coupling`.
113
- - [ ] **Step 10 — Judgment:** Four criteria. Decisions vs code: every architecture-scoped decision still honoured + what enforces it (lint, dependency rule, test). Unenforced decision = finding. Shape with no decision = undocumented architecture. Context/containers: C4 System Context and Container as Mermaid, from previous report corrected. Every external service in code and env schema appears; nothing retired on diagram. Capability register = package-level view only. Quality attributes: pick product-quality characteristics that matter; one scenario each (stimulus, environment, response, response measure); carry forward; judge shape meets each. Production checklists (quarterly): walk host checklists → route each gap to owning audit. **Done when:** decisions, views, scenarios, routed gaps in `Judgment`.
114
- - [ ] **Step 11 — Verify:** No finding without opening file. Confirm: cycle is runtime not type-only; cross-package edge is real source import not shared manifest name; privileged call site unguarded not middleware-blind; duplicated name is real duplication not platform split/local handler. Cite `file:line`. Destinations (name; do not file): confirmed copies and change-coupled pairs → `bkit-audit-duplication`; reachability or event without producer/consumer → `bkit-audit-dead-code`; server-only from client or secret in native bundle → `bkit-audit-security`; table multi-writer → `bkit-audit-database`; production-checklist gap → owning audit (`bkit-audit-security`, `bkit-audit-app-performance`, `bkit-audit-database`, `bkit-audit-reliability`); else → slug this report names. **Done when:** every surviving candidate has `file:line`, tool, destination.
115
- - [ ] **Step 12 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per anchor standard and product-quality characteristic → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
116
- - [ ] **Step 13 — Anything Else:** (a) Everything since previous report's commit touching shape (workspaces add/remove, manifest deps between workspaces, export maps, path aliases and project references, moved modules, new jobs/events, migrations adding tables, new external services in env schema) → one-line verdict each. (b) Bounded ~30 min: what senior architect flags that no step asks; read since previous run (incidents, `bkit-audit-logs`, new `docs/failures.jsonl`, 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`.
88
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
89
+ - [ ] **Step 2 — Graph:** Build the graph locally, from code only, with credentials stripped, through the project wrapper (never a bare extract). Record the tool version, `built_at_commit`, the node count, the edge count and the cross-package edge count. **If** the graph commit != the reviewed `HEAD` → the findings are invalid, so rebuild. Keep the derived output untracked. A clean rebuild deletes only that output. **If** path aliases changed → do a clean rebuild, because a force flag that does not clear the module-resolution cache keeps stale unresolved edges. A syntax-only graph (e.g., tree-sitter) does not consult the language server. Path aliases and manifest names are separate inputs, and losing either one drops edges with no error. Keep the manifests in the corpus so workspace imports resolve, then drop manifest-to-manifest edges before building the matrix. Skip the whole-repo render, and use package and module rollups. **If** the tool keeps dated extractor backups → they accumulate, and a clean rebuild clears them. **Done when:** `Graph` holds the commit, the counts and the tool list, or `Not Checked` names the absent tool.
90
+ - [ ] **Step 3 — Report:** Read the extractor's report. Check every finding-like section against source before it counts. Import cycles: a type-only edge is erased at compile time, so it is not a runtime cycle. Check every edge. Cross-package edges: once aliases resolve, do not dismiss them as impossible, but do dismiss manifest-to-manifest edges. God nodes: a high degree is a reason to look, not a defect. **If** a community dump has numbered labels and near-zero cohesion → the clustering found no structure, so skip it. **Done when:** `Graph` gives each section a disposition.
91
+ - [ ] **Step 4 — Structure:** Query the built graph first, then the graph file.
92
+ - Apply the filters first: code only (source extensions; drop manifests and config), with tests separated by the repo's one test-path rule. Do not type a shorter list.
93
+ - Test files cross boundaries, so counting them as product hides the shape. Views with and without test code can both be correct, so record which one you use.
94
+ - Keep dependency-shaped edges only (import, re-export, dynamic import). Nesting is not dependency.
95
+ - Exclude name-matching edges (e.g., `indirect_call`), because they can invent links between unrelated files that share a function name.
96
+ - Blast radius under-reports: it misses callers in anonymous callbacks and calls in module-level initialisers. A blast-radius set is a starting set, never a complete one.
97
+ - Run these checks, each as a series:
98
+ - (1) Package dependencies:
99
+ - Build the package dependency matrix, code only, and find the back-edges (library→app, leaf→consumer). It should be a DAG.
100
+ - For each workspace, compute Ca, Ce, instability I = Ce/(Ca+Ce) and abstractness (the share of exported types and interfaces).
101
+ - Flag a package that depends on a less stable one.
102
+ - (2) Find file-level cycles (SCC over import edges). A component of more than 1 file is a candidate for the type-only check.
103
+ - (3) Fan-in: rank the files everything imports.
104
+ - (4) Fan-out: rank the files with the most imports, which are barrels and god modules.
105
+ - (5) Duplicate symbol names:
106
+ - Group callables by label across distinct non-test source files. A name with >=3 definitions is a prompt to look. Per-directory handlers and platform splits (e.g., `.native` / `.web`) are false positives. The signal is a type or component duplicated where a canonical one exists.
107
+ - Run the same grouping over test code alone.
108
+ - Find copies without a shared name with text search.
109
+ - Confirmed hits go to `bkit-audit-duplication`.
110
+
111
+ **Done when:** `Structure` holds the matrix, the cycles, the rankings and the duplicates.
112
+
113
+ - [ ] **Step 5 — Layers:** A back-edge hunt with no written model lets a legal but wrong dependency pass.
114
+ - Carry the allowed package-layer matrix forward from the previous report.
115
+ - **If** there is no matrix → draft one from the recorded architecture decisions, and mark it proposed.
116
+ - Diff the code-only matrix against it. Every disallowed edge is a candidate.
117
+ - Encode the matrix as forbidden rules for the compiler-resolving linter, with its config under the repo-root `tmp/` only and type-only edges excluded.
118
+ - Check the extractor's import cycles. A rule that runs clean is a fitness function to propose under `Process Improvements`.
119
+ - Run the workspace boundary checker, and record its version. A clean result is a candidate for a package-DAG gate, not proof.
120
+ - **If** there is a native or restricted app →
121
+ - Check that no package it imports transitively has a server-only or host-only module (e.g., `fs`, a server-only import, a service-role client).
122
+ - Write a forbidden rule for it, so a bundle break or a client secret is caught by structure.
123
+ - Public entry points:
124
+ - Check that every workspace package declares them where the ecosystem supports it (e.g., the Node `exports` map, Go `internal/`). Deep imports past them are candidates.
125
+ - Name the enforcing rule each one would need.
126
+
127
+ **Done when:** `Layers` holds every disallowed edge, with the rule that would forbid it.
128
+
129
+ - [ ] **Step 6 — Boundary:** List the modules that import a privileged data client, a service-role secret or a non-public secret. Confirm that each one imports a guard that turns a client import into a build error (e.g., `server-only`), where the stack has one. **If** the stack has none → the reach check stands alone, so say so. Confirm that no client-entry module reaches one transitively, because a client entry pulls its imports into the client bundle. Compute that reach over runtime edges only: a type-only import is erased at compile time. Use text search for the list, the linter or blast radius for reach, and `Cross-Check` to confirm. **Done when:** `Boundary` holds every privileged module, with its guard, reach and verdict.
130
+ - [ ] **Step 7 — Cross-Check:** The language server answers from disk, so it shows no mid-edit staleness, and it resolves what the tree-sitter graph cannot. The graph misses callers in anonymous callbacks. The language server misses what the project graph cannot reach. Confirm fan-in and blast radius with references before the write-up. Pace the reference queries, because back-to-back calls can return a partial count that looks the same as a real one. **If** a count is surprisingly low → repeat it after a pause. An empty result is inconclusive. Neither tool sees these blind spots: middleware guards, config-referenced files, runtime-registered handlers, mock-factory keys, packages outside the language server's project graph, and dynamic imports whose specifier is not a literal (e.g., a variable or cast string, or a bundler ignore comment). Use text search for non-source files, string literals and unknown names. **Done when:** every load-bearing claim in `Cross-Check` names both tools, or the blind spot.
131
+ - [ ] **Step 8 — References:** Pick 2-3 well-regarded OSS repos on the same stack, and compare their shape: package boundaries, where shared code lives, the config and env split, and how client code is shared. Record the repo name, the commit or tag, and the comparison. A difference is a soft signal, not a finding on its own. Report it only with the problem it would solve here, mark it low-confidence, and never rank it above a graph finding. **Done when:** `References` holds the repos, revisions and comparisons, or `none`.
132
+ - [ ] **Step 9 — Coupling:** Three kinds of coupling carry no import edge. Events and runtime wiring: compare every event sent with the handlers registered, plus schedules, DB triggers, outbound DB HTTP, edge functions and inbound webhooks. Flag a producer without a consumer, a consumer without a producer, and two packages coupled only through an event. Data ownership: list the table and routine call sites per package, app, and script or CLI directory. Flag a table written from more than 1 module or app, and a table written through a privileged client from more than 1 place. Change coupling: find the file pairs, in commits since the previous report, that sit in different packages or clients and change together in more than half of the commits, with no import edge. Confirmed pairs go to `bkit-audit-duplication`. **Done when:** `Coupling` holds the events, tables and pairs.
133
+ - [ ] **Step 10 — Judgment:** Judge the shape on four criteria. Decisions against code: check that every architecture-scoped decision is still honoured, and name what enforces it (a lint, a dependency rule, a test). A decision nothing enforces is a finding. Shape with no decision behind it is undocumented architecture. Context and containers: draw the C4 System Context and Container views in Mermaid, from the previous report's views, corrected. Every external service in the code and the env schema appears, and nothing retired stays on the diagram. The capability register is a package-level view only. Annotate the Container view with each compute and data region, read live. A request that crosses regions on every call is a finding. Quality attributes: pick the product-quality characteristics that matter, and write one scenario for each (stimulus, environment, response, response measure). Carry them forward, and judge whether the shape meets each one. Production checklists (quarterly): walk the host checklists, and route each gap to the audit that owns it. **Done when:** `Judgment` holds the decisions, the views, the scenarios and the routed gaps.
134
+ - [ ] **Step 11 — Verify:** Give no finding without opening the file. Confirm that a cycle is runtime, not type-only; that a cross-package edge is a real source import, not a shared manifest name; that a privileged call site is unguarded, not guarded by middleware the tools cannot see; and that a duplicated name is real duplication, not a platform split or a local handler. Cite `file:line`. Destinations (name; do not file): confirmed copies and change-coupled pairs go to `bkit-audit-duplication`; reachability, or an event without a producer or consumer, goes to `bkit-audit-dead-code`; a server-only module reached from the client, or a secret in the native bundle, goes to `bkit-audit-security`; a table with several writers goes to `bkit-audit-database`; a production-checklist gap goes to the audit that owns it (`bkit-audit-security`, `bkit-audit-app-performance`, `bkit-audit-database`, `bkit-audit-reliability`); anything else goes to the slug this report names. **Done when:** every surviving candidate has its `file:line`, tool and destination.
135
+ - [ ] **Step 12 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per anchor standard and one per product-quality characteristic, 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.
136
+ - [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches shape: workspaces added or removed, manifest dependencies between workspaces, export maps, path aliases and project references, moved modules, new jobs and events, migrations that add tables, and new external services in the env schema. (b) Spend a bounded pass of about 30 minutes on what a senior architect would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs`, 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`.
117
137
 
118
138
  ### 🔒 Gate 2: Probes Check
119
139
 
120
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
121
-
122
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
123
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
140
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
141
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
124
142
  - [ ] **Presence only:** no finding rests on a missing edge alone.
125
- - [ ] **Graph commit:** graph was built from the reviewed commit, or the mismatch is itself a finding.
126
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
143
+ - [ ] **Graph commit:** the graph was built from the reviewed commit, or the mismatch is itself a finding.
144
+ - [ ] **Gate 2 — Verified:** every item above holds.
127
145
 
128
146
  ## Findings
129
147
 
130
148
  <!-- prettier-ignore -->
131
149
  | Severity | Use |
132
150
  | --- | --- |
133
- | `CRITICAL` | Privileged or secret-bearing module reachable from a client bundle or a native app |
134
- | `HIGH` | Runtime cycle or back-edge across the intended layers; privileged call site unguarded by anything either tool can see |
135
- | `MEDIUM` | Architecture decision nothing enforces; confirmed duplicate where a canonical symbol exists; event with no producer or no consumer |
136
- | `LOW` | Low-confidence shape difference versus a reference repo; diagram drift that changes no boundary |
151
+ | `CRITICAL` | A privileged or secret-bearing module is reachable from a client bundle or a native app |
152
+ | `HIGH` | A runtime cycle or a back-edge across the intended layers. A privileged call site that nothing either tool can see guards |
153
+ | `MEDIUM` | An architecture decision that nothing enforces. A confirmed duplicate where a canonical symbol exists. An event with no producer or no consumer |
154
+ | `LOW` | A low-confidence shape difference from a reference repo. Diagram drift that changes no boundary |
137
155
 
138
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: boundary / secrets first.
156
+ Within a severity, list boundary and secrets findings first.
139
157
 
140
158
  <!-- prettier-ignore -->
141
159
  | ID | Severity | Location | Evidence | Expected |
142
160
  | --- | --- | --- | --- | --- |
143
161
  | PENDING | PENDING | PENDING | PENDING | PENDING |
144
162
 
145
- Empty and clean → one row `None`.
163
+ **If** the run finds nothing → write one row: `None`.
146
164
 
147
165
  ## Report
148
166
 
@@ -215,17 +233,17 @@ PENDING
215
233
 
216
234
  ### 🔒 Gate 3: Report Check
217
235
 
218
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
219
-
220
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
221
- - [ ] **Summary:** names count per severity, tools available, and the graph commit.
222
- - [ ] **Series:** node, edge, and cross-package counts, and the coupling table, beside previous report's numbers, or marked baseline.
223
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
224
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
225
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
226
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
227
-
228
- > `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.
236
+ - [ ] **No placeholders:** no `PENDING` is left.
237
+ - [ ] **Summary:** `Summary` gives the count per severity.
238
+ - [ ] **Tools:** `Summary` names the tools available.
239
+ - [ ] **Graph commit named:** `Summary` names the graph commit.
240
+ - [ ] **Series:** the report shows node, edge, and cross-package counts, and the coupling table, beside the previous report's numbers, or marks the run as baseline.
241
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
242
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
243
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
244
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
245
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
246
+ - [ ] **Gate 3 — Verified:** every item above holds.
229
247
 
230
248
  <!-- bkit:end -->
231
249