@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
@@ -0,0 +1,194 @@
1
+ // Local full-gate receipts, shared by linked worktrees and bound to committed trees.
2
+ import { spawnSync } from "node:child_process";
3
+ import { createHash, randomUUID } from "node:crypto";
4
+ import * as fs from "node:fs";
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import { gitEnv } from "../../ledgers/telemetry.js";
8
+ import { parseJson, readJsonFile } from "../../shared/json.js";
9
+ import { readPackageJson } from "../../shared/package-json.js";
10
+ import { scriptCommand, testCommand } from "../../shared/package-manager.js";
11
+ import { EXIT, git, outboxRoot, runGit } from "../lib.js";
12
+ import { changedOutside } from "../workflow/ledgers.js";
13
+ const UNIT = "bkit:gate:static-unit";
14
+ const INTEGRATION = "bkit:gate:static-unit-integration";
15
+ const SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
16
+ function scriptsOf(pkg) {
17
+ if (!pkg || typeof pkg !== "object" || !("scripts" in pkg))
18
+ return null;
19
+ const scripts = pkg.scripts;
20
+ if (!scripts || typeof scripts !== "object" || Array.isArray(scripts))
21
+ return null;
22
+ return scripts;
23
+ }
24
+ function gateDefinition(pkg) {
25
+ const values = scriptsOf(pkg);
26
+ if (!values)
27
+ return null;
28
+ const gate = typeof values[INTEGRATION] === "string" ? INTEGRATION : UNIT;
29
+ if (typeof values[gate] !== "string" || values[gate].trim() === "")
30
+ return null;
31
+ const fingerprint = createHash("sha256")
32
+ .update(JSON.stringify(Object.entries(values).sort(([a], [b]) => a.localeCompare(b))))
33
+ .digest("hex");
34
+ return { gate, fingerprint };
35
+ }
36
+ /** The deepest full push gate declared by this checkout. */
37
+ export function requiredPushGate(cwd) {
38
+ const pkg = readPackageJson(cwd);
39
+ return pkg.ok ? (gateDefinition(pkg.pkg)?.gate ?? null) : null;
40
+ }
41
+ const receiptPath = (cwd, sha) => {
42
+ const outbox = outboxRoot(cwd);
43
+ return outbox ? path.join(outbox, "push-gates", `${sha}.json`) : null;
44
+ };
45
+ function cleanHead(cwd) {
46
+ const status = git(cwd, [
47
+ "status",
48
+ "--porcelain",
49
+ "--untracked-files=all",
50
+ "--ignore-submodules=none",
51
+ ]);
52
+ if (status !== "")
53
+ return null;
54
+ const sha = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
55
+ const tree = git(cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
56
+ return sha && tree ? { sha, tree } : null;
57
+ }
58
+ /** Execute a consumer gate; only a successful deepest full gate on an unchanged clean tree earns proof. */
59
+ export function runPushGate(cwd, gate, log) {
60
+ const pkg = readPackageJson(cwd);
61
+ const script = pkg.ok ? scriptsOf(pkg.pkg)?.[gate] : null;
62
+ if (typeof script !== "string" || script.trim() === "") {
63
+ log(`package.json must declare a non-empty ${gate} script`);
64
+ return EXIT.USAGE;
65
+ }
66
+ const definition = pkg.ok ? gateDefinition(pkg.pkg) : null;
67
+ const before = cleanHead(cwd);
68
+ const head = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
69
+ const file = head ? receiptPath(cwd, head) : null;
70
+ const attempt = file && definition?.gate === gate ? path.join(`${file}.running`, randomUUID()) : null;
71
+ const fail = () => {
72
+ if (!attempt || !file)
73
+ return;
74
+ fs.mkdirSync(path.dirname(file), { recursive: true });
75
+ fs.writeFileSync(`${file}.failed`, JSON.stringify({ version: 1, sha: head, gate, passed: false }) + "\n");
76
+ fs.rmSync(file, { force: true });
77
+ };
78
+ if (attempt) {
79
+ fs.mkdirSync(path.dirname(attempt), { recursive: true });
80
+ fs.writeFileSync(attempt, JSON.stringify({ pid: process.pid, sha: head }) + "\n");
81
+ fail();
82
+ }
83
+ const finish = (code) => {
84
+ if (attempt)
85
+ fs.rmSync(attempt, { force: true });
86
+ return code;
87
+ };
88
+ const argv = testCommand(scriptCommand(gate));
89
+ log(`running ${scriptCommand(gate).join(" ")}`);
90
+ const result = spawnSync(argv[0], argv.slice(1), {
91
+ cwd,
92
+ env: gitEnv(),
93
+ stdio: ["ignore", 2, 2],
94
+ });
95
+ const status = result.error
96
+ ? 127
97
+ : (result.status ??
98
+ 128 + ((result.signal ? os.constants.signals[result.signal] : undefined) ?? 1));
99
+ if (result.error)
100
+ log(result.error.message);
101
+ if (status !== 0 || !before || definition?.gate !== gate) {
102
+ fail();
103
+ return finish(status);
104
+ }
105
+ const after = cleanHead(cwd);
106
+ const afterPkg = readPackageJson(cwd);
107
+ if (after?.sha !== before.sha ||
108
+ after.tree !== before.tree ||
109
+ !afterPkg.ok ||
110
+ gateDefinition(afterPkg.pkg)?.fingerprint !== definition.fingerprint) {
111
+ log("full gate passed, but the checkout changed — no reusable push receipt");
112
+ fail();
113
+ return finish(status);
114
+ }
115
+ if (file) {
116
+ fs.mkdirSync(path.dirname(file), { recursive: true });
117
+ fs.writeFileSync(file, JSON.stringify({ version: 1, ...before, ...definition, passed: true }) + "\n");
118
+ fs.rmSync(`${file}.failed`, { force: true });
119
+ log(`recorded full push gate for ${before.sha}`);
120
+ }
121
+ return finish(status);
122
+ }
123
+ /** Pending files survive interrupted runners; one read suffices to block earlier proof. */
124
+ function pendingAttempt(file) {
125
+ const dir = `${file}.running`;
126
+ if (!fs.existsSync(dir))
127
+ return false;
128
+ const handle = fs.opendirSync(dir);
129
+ try {
130
+ return handle.readSync() !== null;
131
+ }
132
+ finally {
133
+ handle.closeSync();
134
+ }
135
+ }
136
+ function validReceipt(cwd, file, sha, definition) {
137
+ const read = readJsonFile(file);
138
+ if (!read.ok || !read.value || typeof read.value !== "object")
139
+ return false;
140
+ const receipt = read.value;
141
+ return (receipt.version === 1 &&
142
+ receipt.passed === true &&
143
+ receipt.sha === sha &&
144
+ receipt.gate === definition.gate &&
145
+ receipt.fingerprint === definition.fingerprint &&
146
+ receipt.tree === git(cwd, ["rev-parse", `${sha}^{tree}`]));
147
+ }
148
+ /** Every commit not covered by this success must be free of failed or unreadable gate evidence. */
149
+ function noLaterFailure(cwd, dir, sha, newSha, definition) {
150
+ const range = git(cwd, ["rev-list", "--max-count=129", newSha, `^${sha}`]);
151
+ if (range === null)
152
+ return false;
153
+ const commits = range ? range.split("\n") : [];
154
+ if (commits.length > 128)
155
+ return false;
156
+ for (const commit of [sha, ...commits]) {
157
+ const file = path.join(dir, `${commit}.json`);
158
+ if (fs.existsSync(`${file}.failed`) ||
159
+ pendingAttempt(file) ||
160
+ (fs.existsSync(file) && !validReceipt(cwd, file, commit, definition)))
161
+ return false;
162
+ }
163
+ return true;
164
+ }
165
+ /** A bounded ancestor search; absent, malformed or stale proof always requires the full gate. */
166
+ export function hasVerifiedIncrement(cwd, oldSha, newSha, paths) {
167
+ if (!SHA.test(oldSha) ||
168
+ !SHA.test(newSha) ||
169
+ /^0+$/.test(oldSha) ||
170
+ !runGit(cwd, ["merge-base", "--is-ancestor", oldSha, newSha]).ok)
171
+ return false;
172
+ const raw = git(cwd, ["show", `${newSha}:package.json`]);
173
+ const parsed = raw === null ? null : parseJson(raw);
174
+ const definition = parsed?.ok ? gateDefinition(parsed.value) : null;
175
+ const localPkg = readPackageJson(cwd);
176
+ if (!definition ||
177
+ !localPkg.ok ||
178
+ gateDefinition(localPkg.pkg)?.fingerprint !== definition.fingerprint)
179
+ return false;
180
+ const ancestors = git(cwd, ["rev-list", "--max-count=128", oldSha]);
181
+ const firstFile = receiptPath(cwd, oldSha);
182
+ if (!ancestors || !firstFile)
183
+ return false;
184
+ const dir = path.dirname(firstFile);
185
+ for (const sha of ancestors.split("\n")) {
186
+ const file = path.join(dir, `${sha}.json`);
187
+ if (!validReceipt(cwd, file, sha, definition))
188
+ continue;
189
+ const diff = changedOutside(cwd, sha, newSha, paths);
190
+ if (diff.ok && diff.outside.length === 0 && noLaterFailure(cwd, dir, sha, newSha, definition))
191
+ return true;
192
+ }
193
+ return false;
194
+ }
@@ -14,12 +14,10 @@
14
14
  //
15
15
  // See DE-34 for the shared-entrypoint + crash-isolation contract.
16
16
  import { execFileSync } from "node:child_process";
17
- import * as fs from "node:fs";
18
17
  import * as path from "node:path";
19
- import { readJsonFile } from "../shared/json.js";
20
- import { getPkgRoot } from "../shared/package-roots.js";
21
18
  import { isMirrorPath } from "../shared/protected-paths.js";
22
- import { gitEnv, resolveGitSha, resolveRepoSlug, } from "../ledgers/telemetry.js";
19
+ import { gitEnv, resolveGitSha, } from "../ledgers/telemetry.js";
20
+ import { appendLedgerRows } from "./workflow/ledgers.js";
23
21
  /** SHA charset guard — only raw hex SHAs from the ledger are accepted. */
24
22
  const SHA_RE = /^[0-9a-f]{7,40}$/;
25
23
  export const realGitAdapter = {
@@ -134,89 +132,74 @@ export function runGrader(input) {
134
132
  /**
135
133
  * Build one `kind:"compliance"` row per rule.
136
134
  * Rules that produced no violation emit a "pass" row.
137
- * Every row carries `bkitVersion`.
138
- *
139
- * Called by the CLI dispatch after `runGrader`.
140
135
  */
141
136
  export function buildComplianceRows(input) {
142
- const ts = Date.now();
143
- const { violations, phase, parentSha, repo, bkitVersion, extra } = input;
137
+ const { violations, workflow, parentSha, step } = input;
144
138
  const violationByRule = new Map();
145
139
  for (const v of violations) {
146
140
  violationByRule.set(v.ruleId, v);
147
141
  }
148
142
  const ALL_RULES = ["no-mirror-edit", "skip-ci-not-head"];
149
- const rows = [];
150
- for (const ruleId of ALL_RULES) {
143
+ return ALL_RULES.map((ruleId) => {
151
144
  const violation = violationByRule.get(ruleId);
152
- const result = violation != null ? violation.result : "pass";
145
+ const verdict = violation != null ? violation.result : "pass";
153
146
  const evidence = violation?.evidence;
154
- const envelope = {
155
- ts: ts + rows.length, // micro-offset so each row has a unique ts within the batch
147
+ return {
156
148
  kind: "compliance",
157
- repo,
158
- bkitVersion,
159
- workflow: phase,
160
- step: "close-gate",
161
- ...(extra ?? {}),
162
- };
163
- const payload = {
164
- rule: ruleId,
165
- result,
166
- ...(evidence != null ? { evidence } : {}),
167
- phase,
168
- parentSha,
149
+ by: { workflow, step },
150
+ run: { parentSha },
151
+ rule: { id: ruleId, verdict, ...(evidence != null ? { evidence } : {}) },
169
152
  };
170
- rows.push({ ...envelope, ...payload });
171
- }
172
- return rows;
153
+ });
173
154
  }
174
155
  // ---------------------------------------------------------------------------
175
156
  // Append helper — writes rows to .bkit/stats.jsonl (best-effort)
176
157
  // ---------------------------------------------------------------------------
177
158
  /**
178
- * Append compliance rows to the stats ledger.
179
- * Best-effort: prints `[bkit-comply] append failed: …` on error, never throws.
159
+ * Append compliance rows to `<root>/.bkit/stats.jsonl` through `bkit ledgers append`.
160
+ * Best-effort: prints `[bkit-comply] append failed: …` and returns false on error,
161
+ * never throws.
180
162
  */
181
- export function appendComplianceRows(rows, statsPath) {
163
+ export function appendComplianceRows(rows, root, log = (m) => console.error(m)) {
164
+ if (rows.length === 0)
165
+ return false;
182
166
  try {
183
- const ndjson = rows.map((r) => JSON.stringify(r)).join("\n") + "\n";
184
- fs.appendFileSync(statsPath, ndjson, "utf8");
167
+ appendLedgerRows(root, "stats", rows);
168
+ return true;
185
169
  }
186
170
  catch (err) {
187
171
  const msg = err instanceof Error ? err.message : String(err);
188
- console.error(`[bkit-comply] append failed: ${statsPath} — ${msg}`);
172
+ log(`[bkit-comply] append failed: ${path.join(root, ".bkit", "stats.jsonl")} — ${msg}`);
173
+ return false;
189
174
  }
190
175
  }
191
- // ---------------------------------------------------------------------------
192
- // One grading pass, as `bkit workflows close` runs it before its report
193
- // ---------------------------------------------------------------------------
194
176
  /**
195
177
  * Grade `phase` over HEAD~1..HEAD (HEAD alone in a one-commit repo) and append
196
178
  * its compliance rows to `<cwd>/.bkit/stats.jsonl`. With `squashSha` (ship's
197
179
  * close, run in the feature worktree) the squash commit is graded instead —
198
180
  * its subject and `squash~1..squash` — so the grade covers the whole feature
199
- * as it reaches main, not the worktree's last commit. Fail-open: any
200
- * error is logged and returns null, so a close never stops on the grader.
181
+ * as it reaches main, not the worktree's last commit. The rows carry `run`'s
182
+ * `parentSha` and step (default: HEAD and `close-gate`), so they join the
183
+ * close's other rows. Fail-open: any error is logged and returns null, so a
184
+ * close never stops on the grader.
201
185
  */
202
- export function gradeCompliance(cwd, phase, log, squashSha) {
186
+ export function gradeCompliance(cwd, phase, log, squashSha, run) {
203
187
  try {
204
188
  const squashParent = squashSha === undefined ? "" : resolveGitSha(`${squashSha}~1`, cwd);
205
- const parentSha = squashParent || resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
206
- if (!parentSha) {
189
+ const base = squashParent || resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
190
+ if (!base) {
207
191
  log("[bkit-comply] cannot resolve a parent SHA (no commits?) — skipping grade");
208
192
  return null;
209
193
  }
210
194
  const headSha = squashParent ? squashSha : undefined;
211
- const violations = runGrader({ parentSha, phase, cwd, ...(headSha ? { headSha } : {}) });
195
+ const violations = runGrader({ parentSha: base, phase, cwd, ...(headSha ? { headSha } : {}) });
212
196
  const rows = buildComplianceRows({
213
197
  violations,
214
- phase,
215
- parentSha,
216
- repo: resolveRepoSlug(cwd) || "unknown/repo",
217
- bkitVersion: readBkitVersion(),
198
+ workflow: phase,
199
+ parentSha: run?.parentSha ?? resolveGitSha("HEAD", cwd),
200
+ step: run?.step ?? "close-gate",
218
201
  });
219
- appendComplianceRows(rows, path.join(cwd, ".bkit", "stats.jsonl"));
202
+ appendComplianceRows(rows, cwd, log);
220
203
  log(violations.length > 0
221
204
  ? `[bkit-comply] Compliance violations found:\n${formatComplianceSummary(violations)}`
222
205
  : "[bkit-comply] All rules pass.");
@@ -247,34 +230,6 @@ export function formatComplianceSummary(violations) {
247
230
  ];
248
231
  return lines.join("\n");
249
232
  }
250
- // ---------------------------------------------------------------------------
251
- // bkitVersion reader (used by CLI dispatch and tests)
252
- // ---------------------------------------------------------------------------
253
- /**
254
- * Read the bkit version from the package.json nearest to `searchFrom` (default: the
255
- * running bkit package's root). Returns "0.0.0" on any read/parse error (fail-open).
256
- */
257
- export function readBkitVersion(searchFrom) {
258
- // Walk up looking for a package.json with a `version` field; stop at the filesystem root.
259
- let dir = path.resolve(searchFrom ?? getPkgRoot());
260
- for (let i = 0; i < 8; i++) {
261
- const candidate = path.join(dir, "package.json");
262
- if (fs.existsSync(candidate)) {
263
- const read = readJsonFile(candidate);
264
- // Fail-open: a package.json that cannot be read ends the search with the default.
265
- if (!read.ok || read.value === null)
266
- return "0.0.0";
267
- const pkg = read.value;
268
- if (typeof pkg.version === "string")
269
- return pkg.version;
270
- }
271
- const parent = path.dirname(dir);
272
- if (parent === dir)
273
- break;
274
- dir = parent;
275
- }
276
- return "0.0.0";
277
- }
278
233
  // comply — compliance grader (advisory, never gating, fail-open).
279
234
  // Runs `runGrader` over `git diff parentSha..HEAD`, appends `kind:"compliance"`
280
235
  // rows to `.bkit/stats.jsonl`, and logs violations. Always exits 0 (fail-open);
@@ -286,22 +241,25 @@ export function runComplyCommand(complyPhase) {
286
241
  const cwd = process.cwd();
287
242
  const phase = complyPhase ?? "unknown";
288
243
  const logPrefix = "[bkit-comply]";
289
- // parentSha MUST be a resolved hex SHA: diffPaths returns [] for anything not
290
- // matching /^[0-9a-f]{7,40}$/, and parentSha is part of the compliance identity().
291
- // Resolves HEAD~1, else HEAD; neither → skip the grade.
292
- const statsPath = path.join(cwd, ".bkit", "stats.jsonl");
293
- const parentSha = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
294
- if (!parentSha) {
244
+ // The grade's diff base MUST be a resolved hex SHA: diffPaths returns [] for anything
245
+ // not matching /^[0-9a-f]{7,40}$/. Resolves HEAD~1, else HEAD; neither → skip the grade.
246
+ const base = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
247
+ if (!base) {
295
248
  console.log(`${logPrefix} cannot resolve a parent SHA (no commits?) — skipping grade`);
296
249
  return;
297
250
  }
298
- console.log(`${logPrefix} Running compliance grader (phase=${phase}, parentSha=${parentSha})`);
299
- const violations = runGrader({ parentSha, phase, cwd });
300
- // The origin remote's owner/repo, the same slug every other telemetry writer uses.
301
- const repo = resolveRepoSlug(cwd) || "unknown/repo";
302
- const bkitVersion = readBkitVersion();
303
- const rows = buildComplianceRows({ violations, phase, parentSha, repo, bkitVersion });
304
- appendComplianceRows(rows, statsPath);
251
+ console.log(`${logPrefix} Running compliance grader (phase=${phase}, base=${base})`);
252
+ const violations = runGrader({ parentSha: base, phase, cwd });
253
+ // A row names the closing workflow it grades: without one, the grade is printed only.
254
+ const rows = complyPhase === null
255
+ ? []
256
+ : buildComplianceRows({
257
+ violations,
258
+ workflow: complyPhase,
259
+ parentSha: resolveGitSha("HEAD", cwd),
260
+ step: "close-gate",
261
+ });
262
+ const written = complyPhase !== null && appendComplianceRows(rows, cwd);
305
263
  if (violations.length > 0) {
306
264
  const summary = formatComplianceSummary(violations);
307
265
  console.log(`${logPrefix} Compliance violations found:\n${summary}`);
@@ -309,7 +267,12 @@ export function runComplyCommand(complyPhase) {
309
267
  else {
310
268
  console.log(`${logPrefix} All rules pass.`);
311
269
  }
312
- console.log(`${logPrefix} Appended ${rows.length} compliance row(s) to .bkit/stats.jsonl (advisory — not gating).`);
270
+ if (complyPhase === null) {
271
+ console.log(`${logPrefix} no --phase: rows not written to .bkit/stats.jsonl.`);
272
+ }
273
+ else if (written) {
274
+ console.log(`${logPrefix} Appended ${rows.length} compliance row(s) to .bkit/stats.jsonl (advisory — not gating).`);
275
+ }
313
276
  }
314
277
  catch (err) {
315
278
  // Fail-open: any unexpected error in the dispatch body must not gate the workflow.
@@ -147,7 +147,7 @@ export async function runDoctor(modules, opencodeProvider) {
147
147
  allFindings.push({
148
148
  id: "opencode-provider-missing",
149
149
  severity: "blocker",
150
- detect: "`.opencode/` is present but no provider is recorded — neither package.json `bkit.opencodeProvider` nor an `opencode.json` provider block.",
150
+ detect: "`.opencode/` is present but no provider is recorded — neither package.json `bkit.providers.opencode.default` nor an `opencode.json` provider block.",
151
151
  action: `Re-run \`bkit install --opencode=<provider>\` (${OPENCODE_PROVIDERS.join(", ")}). Until then \`bkit check\` and \`bkit upgrade\` exit 1 rather than render every agent pin against a substitute provider.`,
152
152
  });
153
153
  }
@@ -185,7 +185,7 @@ export async function runDoctor(modules, opencodeProvider) {
185
185
  let detectedProvider = detectOpencodeProvider(process.cwd());
186
186
  if (opencodeProvider)
187
187
  detectedProvider = opencodeProvider;
188
- // Multi-provider: all installed providers. bkit.opencodeProviders when populated,
188
+ // Multi-provider: all installed providers. bkit.providers.opencode.installed when populated,
189
189
  // else the single detected provider.
190
190
  const allProviders = detectOpencodeProviders(process.cwd());
191
191
  const activeProvider = detectedProvider ?? allProviders[0] ?? null;
@@ -15,8 +15,9 @@ import { formatChecklist, readChangelogVersionDelta, runPostInstallCheck, writeA
15
15
  import { collectTips } from "../../checks/tips/index.js";
16
16
  import { findMissingOwnedHooks, detectOwnedHookMissing } from "../../checks/after/managed.js";
17
17
  import { resolveTokens } from "../../install/placeholders.js";
18
- import { parseModelLookup, applyModelOverrides, buildOpencodeModelLookup, buildAntigravityModelLookup, parseEffortMap, } from "../../render/models.js";
18
+ import { parseModelLookup, applyModelOverrides, unknownModelOverrides, buildOpencodeModelLookup, buildAntigravityModelLookup, parseEffortMap, } from "../../render/models.js";
19
19
  import { getBkitDocsRoot } from "../../shared/package-roots.js";
20
+ import { migrateBkitLayout, migrateGithubProjectKey, migrateLinearTeamKey, } from "../../install/modules/core.js";
20
21
  import { removeUnusedTrackerMcpEntries, runUninstall } from "./uninstall.js";
21
22
  // ---------------------------------------------------------------------------
22
23
  // Staging scratch area
@@ -43,7 +44,7 @@ export function discardAllStaging(cwd = process.cwd()) {
43
44
  * The installed opencode provider, or exit(1) with the fix.
44
45
  *
45
46
  * `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
46
- * consumer actually installed (package.json `bkit.opencodeProvider`, else the opencode.json
47
+ * consumer actually installed (package.json `bkit.providers.opencode.default`, else the opencode.json
47
48
  * provider block). There is no default: a repo carrying `.opencode/` with no recorded
48
49
  * provider is a broken install.
49
50
  *
@@ -53,7 +54,7 @@ export function requireOpencodeProvider(cwd, context) {
53
54
  const detected = detectOpencodeProvider(cwd);
54
55
  if (!detected) {
55
56
  console.error(`${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
56
- `(package.json \`bkit.opencodeProvider\` and .opencode/opencode.json are both silent). ` +
57
+ `(package.json \`bkit.providers.opencode.default\` and .opencode/opencode.json are both silent). ` +
57
58
  `Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`);
58
59
  process.exit(1);
59
60
  }
@@ -99,11 +100,20 @@ export function validateCloudTrackerMatch(cloudVariant, hasCloudModule, issueTra
99
100
  ? `Set the tracker first: bkit install --tracker=${requiredTracker} --auto=${cloudVariant}`
100
101
  : `Re-run with the matching tracker: bkit install --tracker=${requiredTracker} --auto=${cloudVariant} (tracker switching is free).`));
101
102
  }
103
+ /** `parent[key]` as an object, set to a fresh `{}` first when it is absent or not an object. */
104
+ function section(parent, key) {
105
+ const v = parent[key];
106
+ if (v !== null && typeof v === "object" && !Array.isArray(v))
107
+ return v;
108
+ const fresh = {};
109
+ parent[key] = fresh;
110
+ return fresh;
111
+ }
102
112
  /**
103
113
  * Detect the bkit opencode provider key a consumer installed.
104
114
  *
105
115
  * Resolution order:
106
- * 1. `package.json` `bkit.opencodeProvider` — the authoritative record written on install.
116
+ * 1. `package.json` `bkit.providers.opencode.default` — the authoritative record written on install.
107
117
  * This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
108
118
  * custom provider block.
109
119
  * 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
@@ -136,7 +146,7 @@ export function detectOpencodeProvider(cwd) {
136
146
  }
137
147
  /**
138
148
  * Returns all bkit-installed opencode providers from the consumer package.json
139
- * `bkit.opencodeProviders` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
149
+ * `bkit.providers.opencode.installed` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
140
150
  * the field is absent.
141
151
  */
142
152
  export function detectOpencodeProviders(cwd) {
@@ -183,6 +193,17 @@ export async function runInstall(args, upgradeReport = false) {
183
193
  console.log(`${LOG_PREFIX} Checking advisories (read-only)`);
184
194
  else if (dryRun)
185
195
  console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
196
+ // The package.json key moves run before anything below reads `bkit` settings: the tracker,
197
+ // the opencode provider and the cloud agent are read from the new paths only, so a 5.x
198
+ // layout read first renders every host as if no tracker were set. The core module runs
199
+ // the same moves again; each is a no-op once applied. Check moves nothing and reports
200
+ // the old keys as drift.
201
+ const ws = { writes: [] };
202
+ if (!dryRun) {
203
+ migrateLinearTeamKey(false, ws, LOG_PREFIX);
204
+ migrateGithubProjectKey(false, ws, LOG_PREFIX);
205
+ migrateBkitLayout(false, ws, LOG_PREFIX);
206
+ }
186
207
  // `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
187
208
  // not to a fixed full set. `install` keeps its explicit resolved set, plus every installed
188
209
  // host when `--tracker=` is given: each host renders tracker-specific commands, agents and
@@ -194,13 +215,13 @@ export async function runInstall(args, upgradeReport = false) {
194
215
  : modules;
195
216
  // RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
196
217
  // `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
197
- // (package.json `bkit.opencodeProvider`, else the opencode.json provider block). On install
218
+ // (package.json `bkit.providers.opencode.default`, else the opencode.json provider block). On install
198
219
  // `?? detect` fires only when opencode joins as an installed host under `--tracker=`; with
199
220
  // `--opencode=<provider>` the flag wins. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
200
221
  // below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
201
222
  // so the tracker-dependent opencode mcp block renders the same way on check.
202
223
  const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
203
- // Resolve issueTracker: --tracker= flag overrides; else read bkit.issueTracker from consumer
224
+ // Resolve issueTracker: --tracker= flag overrides; else read bkit.tracker.default from consumer
204
225
  // package.json; else default to "none".
205
226
  // A `--tracker=` value always applies, whether first-set or a re-set of an
206
227
  // already-recorded tracker.
@@ -294,7 +315,17 @@ export async function runInstall(args, upgradeReport = false) {
294
315
  }
295
316
  // Seed preflight advisories into ctx so modules can accumulate into the same list.
296
317
  const advisories = [...preflightAdvisories];
297
- const ws = { writes: [] };
318
+ const deadOverrides = modelLookup.size > 0
319
+ ? unknownModelOverrides(consumerPromptsMdPath, new Set(modelLookup.keys()))
320
+ : [];
321
+ if (deadOverrides.length > 0) {
322
+ advisories.push({
323
+ id: "model-override-unknown-agent",
324
+ severity: "advisory",
325
+ detect: `.bkit/prompts.md § Model Overrides names agents bkit no longer ships: ${deadOverrides.join(", ")}. Those rows are not applied.`,
326
+ action: "Delete the rows, or move each pin to the agent that now does that work (see .bkit/prompts.md § Models).",
327
+ });
328
+ }
298
329
  const postDispatch = [];
299
330
  // Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
300
331
  // validateCloudTrackerMatch for the full rationale. Checked BEFORE any
@@ -316,8 +347,8 @@ export async function runInstall(args, upgradeReport = false) {
316
347
  }
317
348
  // Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
318
349
  // This preserves the "no files written on mismatch" invariant. Two fields are recorded:
319
- // - issueTracker: when a `--tracker=` value was given this run.
320
- // - opencodeProvider: when an `--opencode=<provider>` value was given this run. This is
350
+ // - tracker.default: when a `--tracker=` value was given this run.
351
+ // - providers.opencode.default: when an `--opencode=<provider>` value was given this run. This is
321
352
  // the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
322
353
  // for managed-auth gateways (opencode), whose opencode.json carries no provider block to
323
354
  // detect from. Both are merged in one read-modify-write to avoid double-writing.
@@ -332,30 +363,30 @@ export async function runInstall(args, upgradeReport = false) {
332
363
  const parsed = parseJson(raw);
333
364
  if (parsed.ok) {
334
365
  const pkg = parsed.value;
335
- const bkit = (pkg.bkit ?? {});
366
+ const bkit = section(pkg, "bkit");
336
367
  if (persistTracker)
337
- bkit.issueTracker = tracker;
368
+ section(bkit, "tracker").default = tracker;
338
369
  if (persistProvider) {
339
- bkit.opencodeProvider = opencodeProvider; // active (drives agent frontmatter)
370
+ const opencode = section(section(bkit, "providers"), "opencode");
371
+ opencode.default = opencodeProvider; // active (drives agent frontmatter)
340
372
  // Update providers array (deduped).
341
- const existingArr = Array.isArray(bkit.opencodeProviders)
342
- ? [...bkit.opencodeProviders]
373
+ const existingArr = Array.isArray(opencode.installed)
374
+ ? [...opencode.installed]
343
375
  : [];
344
376
  if (!existingArr.includes(opencodeProvider)) {
345
377
  existingArr.push(opencodeProvider);
346
378
  }
347
- bkit.opencodeProviders = existingArr;
379
+ opencode.installed = existingArr;
348
380
  }
349
- pkg.bkit = bkit;
350
381
  const indentMatch = raw.match(/\n([ \t]+)"/);
351
382
  const indent = indentMatch ? indentMatch[1] : " ";
352
383
  const trailingNewline = raw.endsWith("\n") ? "\n" : "";
353
384
  fs.writeFileSync(consumerPkgPath2, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
354
385
  if (persistTracker) {
355
- console.log(`${LOG_PREFIX} Set bkit.issueTracker = "${tracker}" in package.json`);
386
+ console.log(`${LOG_PREFIX} Set bkit.tracker.default = "${tracker}" in package.json`);
356
387
  }
357
388
  if (persistProvider) {
358
- console.log(`${LOG_PREFIX} Set bkit.opencodeProvider = "${opencodeProvider}" and updated bkit.opencodeProviders in package.json`);
389
+ console.log(`${LOG_PREFIX} Set bkit.providers.opencode.default = "${opencodeProvider}" and updated bkit.providers.opencode.installed in package.json`);
359
390
  }
360
391
  }
361
392
  }