@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,720 @@
1
+ // tools/instructions-sources.ts — the sections of `.bkit/instructions.md` that copy a
2
+ // master elsewhere, read from that master and compared with the store.
3
+ //
4
+ // Masters: `## Rules` ← the `bkit:start` / `bkit:end` block of `.bkit/core/.agents/rules.md`;
5
+ // `## Project Rules` ← `## Project Rules` of `.agents/rules.md`; `## Hook Text` ← the
6
+ // messages built in `HOOK_SOURCES`; `## Permissions` ← the shipped Claude settings and
7
+ // opencode config; `## Special Behaviors` and `## Authoring Rules` ← `CATALOG_SOURCES`.
8
+ // Check mode runs in `tools/instructions-sources.test.ts`; `pnpm instructions:sync`
9
+ // rewrites the rule text and catalog copies. Hook text and permissions are fixed by hand.
10
+ import * as fs from "node:fs";
11
+ import * as path from "node:path";
12
+ /** One `## {heading}` section of a markdown file, heading line excluded, up to the next `## `. */
13
+ export function sectionOf(md, heading) {
14
+ const m = new RegExp(`(?:^|\\n)## ${escapeRe(heading)}\\n`).exec(md);
15
+ if (!m)
16
+ return undefined;
17
+ const rest = md.slice(m.index + m[0].length);
18
+ const end = rest.search(/^## /m);
19
+ return end === -1 ? rest : rest.slice(0, end);
20
+ }
21
+ const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
22
+ export const CARRIER_SURFACES = [
23
+ "workflow",
24
+ "prompt",
25
+ "repo-agent",
26
+ "audit",
27
+ "plan-template",
28
+ "entry",
29
+ "hook",
30
+ "permission",
31
+ ];
32
+ /** A rule's `### {name}`, which tags, clause `- rule:` / `- tags:` lines and prose cite it by. */
33
+ export const RULE_NAME = /^[a-z0-9][a-z0-9-]*/;
34
+ const CITES = /^((?:`[^`:]+:\d+`(?:, )?)+): ?(.*)$/;
35
+ /** One drift item line (` - ` dropped) with its `kept` reason. */
36
+ export function parseDriftItem(raw, kept) {
37
+ const m = CITES.exec(raw);
38
+ const cites = m
39
+ ? [...m[1].matchAll(/`([^`:]+):(\d+)`/g)].map((c) => ({ name: c[1], line: Number(c[2]) }))
40
+ : [];
41
+ const excerpt = m ? /"([^"]+)"/.exec(m[2])?.[1] : undefined;
42
+ return {
43
+ raw,
44
+ cites,
45
+ ...(excerpt === undefined ? {} : { excerpt }),
46
+ ...(kept === undefined ? {} : { kept }),
47
+ };
48
+ }
49
+ /** `- {key}:` lines of an entry, each with the lines indented under it. */
50
+ export function entryKeys(section) {
51
+ const out = [];
52
+ let inBlock = false;
53
+ for (const line of section.split("\n")) {
54
+ if (/^`{3,}/.test(line))
55
+ inBlock = !inBlock;
56
+ if (inBlock)
57
+ continue;
58
+ const top = /^- ([a-z-]+):(?: (.*))?$/.exec(line);
59
+ if (top)
60
+ out.push({ key: top[1], value: top[2] ?? "", children: [] });
61
+ else if (/^ {2,}- /.test(line) && out.length > 0)
62
+ out[out.length - 1].children.push(line);
63
+ else if (line.trim() === "")
64
+ continue;
65
+ else if (!/^ {2,}/.test(line))
66
+ out.push({ key: "", value: line, children: [] });
67
+ }
68
+ return out;
69
+ }
70
+ const RULE_SECTIONS = [
71
+ { heading: "Rules", region: "bkit" },
72
+ { heading: "Project Rules", region: "project" },
73
+ ];
74
+ /** Top-level `- ` bullets of the bkit block, or of `## Project Rules` below `bkit:end`, in file order. */
75
+ export function ruleBullets(rulesMd, region) {
76
+ const start = rulesMd.indexOf("<!-- bkit:start -->");
77
+ const end = rulesMd.indexOf("<!-- bkit:end -->");
78
+ let body;
79
+ if (region === "bkit") {
80
+ body = start === -1 || end === -1 ? "" : rulesMd.slice(start, end);
81
+ }
82
+ else {
83
+ body = sectionOf(end === -1 ? rulesMd : rulesMd.slice(end), "Project Rules") ?? "";
84
+ }
85
+ return body
86
+ .split("\n")
87
+ .filter((l) => l.startsWith("- "))
88
+ .map((l) => l.slice(2));
89
+ }
90
+ /** One entry per `### {name}` of `## {heading}` in the store. */
91
+ export function parseRuleEntries(md, heading) {
92
+ const body = sectionOf(md, heading);
93
+ if (body === undefined)
94
+ throw new Error(`[bkit-instructions] no \`## ${heading}\` section`);
95
+ return body
96
+ .split(/^### /m)
97
+ .slice(1)
98
+ .map((section) => {
99
+ const name = section.slice(0, section.indexOf("\n")).trim();
100
+ const block = (kind) => [...section.matchAll(new RegExp(`^\`\`\`${kind}\\n([\\s\\S]*?)^\`\`\`$`, "gm"))].flatMap((m) => m[1].split("\n").filter((l) => l.trim() !== ""));
101
+ const refs = [];
102
+ const refsAt = section.search(/^- refs:$/m);
103
+ if (refsAt !== -1) {
104
+ for (const line of section.slice(refsAt).split("\n").slice(1)) {
105
+ const m = /^ {2}- `([^`]+)`(?: § (.+))?$/.exec(line);
106
+ if (!m)
107
+ break;
108
+ refs.push(m[2] === undefined ? { path: m[1] } : { path: m[1], section: m[2] });
109
+ }
110
+ }
111
+ const carriers = [];
112
+ const drift = [];
113
+ let clause;
114
+ let carry;
115
+ const distinctFrom = [];
116
+ for (const k of entryKeys(section)) {
117
+ if (CARRIER_SURFACES.includes(k.key)) {
118
+ for (const c of k.children) {
119
+ const m = /^ {2}- ([a-z]+): (.+)$/.exec(c);
120
+ if (m)
121
+ carriers.push({ surface: k.key, relation: m[1], names: m[2] });
122
+ }
123
+ }
124
+ else if (k.key === "drift") {
125
+ for (let i = 0; i < k.children.length; i++) {
126
+ const item = /^ {2}- (.+)$/.exec(k.children[i]);
127
+ if (!item)
128
+ continue;
129
+ const kept = /^ {4}- kept: (.+)$/.exec(k.children[i + 1] ?? "")?.[1];
130
+ drift.push(parseDriftItem(item[1], kept));
131
+ }
132
+ }
133
+ else if (k.key === "clause") {
134
+ clause = /`([^`]+)`/.exec(k.value)?.[1];
135
+ }
136
+ else if (k.key === "carry") {
137
+ carry = k.value;
138
+ }
139
+ else if (k.key === "distinct-from") {
140
+ distinctFrom.push(...[...k.value.matchAll(/`([^`]+)`/g)].map((m) => m[1]));
141
+ }
142
+ }
143
+ return {
144
+ name,
145
+ text: block("text").join("\n"),
146
+ retired: block("retired"),
147
+ refs,
148
+ ...(clause === undefined ? {} : { clause }),
149
+ carriers,
150
+ drift,
151
+ distinctFrom,
152
+ ...(carry === undefined ? {} : { carry }),
153
+ };
154
+ });
155
+ }
156
+ const globRe = (base) => new RegExp(`^${base.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*")}$`);
157
+ /** Repo files a ref path names; a `*` in the basename matches any characters. */
158
+ function refFiles(root, ref) {
159
+ const abs = path.join(root, ref);
160
+ if (!ref.includes("*"))
161
+ return fs.existsSync(abs) ? [abs] : [];
162
+ const dir = path.dirname(abs);
163
+ if (!fs.existsSync(dir))
164
+ return [];
165
+ const re = globRe(path.basename(abs));
166
+ return fs
167
+ .readdirSync(dir)
168
+ .filter((f) => re.test(f))
169
+ .map((f) => path.join(dir, f));
170
+ }
171
+ /** True when `ref` names a repo file (or glob) and, with `section`, one of its files has that heading. */
172
+ export function refExists(root, ref, section) {
173
+ const files = refFiles(root, ref);
174
+ if (files.length === 0)
175
+ return false;
176
+ if (section === undefined)
177
+ return true;
178
+ const heading = new RegExp(`^#{1,6} ${escapeRe(section)}$`, "m");
179
+ return files.some((f) => fs.statSync(f).isFile() && heading.test(fs.readFileSync(f, "utf-8")));
180
+ }
181
+ /** Findings for `## Rules` and `## Project Rules` against their masters. */
182
+ export function checkRules(store, masters, exists) {
183
+ const out = [];
184
+ const seen = new Set();
185
+ for (const s of RULE_SECTIONS) {
186
+ const entries = parseRuleEntries(store, s.heading);
187
+ const bullets = ruleBullets(masters[s.region], s.region);
188
+ const n = Math.max(entries.length, bullets.length);
189
+ for (let i = 0; i < n; i++) {
190
+ const e = entries[i];
191
+ const bullet = bullets[i];
192
+ if (!e) {
193
+ out.push(`${s.heading} bullet ${i + 1} of rules.md has no entry — ${bullet}`);
194
+ continue;
195
+ }
196
+ const tag = `\`${e.name}\``;
197
+ if (RULE_NAME.exec(e.name)?.[0] !== e.name)
198
+ out.push(`${tag}: name must be kebab-case`);
199
+ if (seen.has(e.name))
200
+ out.push(`${tag}: name used by another rule; names are rule IDs`);
201
+ seen.add(e.name);
202
+ if (bullet === undefined) {
203
+ out.push(`${tag}: no rules.md bullet at position ${i + 1}`);
204
+ continue;
205
+ }
206
+ if (e.text !== bullet)
207
+ out.push(`${tag}: text differs from rules.md — run pnpm instructions:sync`);
208
+ for (const r of e.refs) {
209
+ if (!exists(r.path, r.section)) {
210
+ out.push(`${tag}: ref \`${r.path}\`${r.section ? ` § ${r.section}` : ""} does not exist`);
211
+ }
212
+ }
213
+ }
214
+ }
215
+ return out;
216
+ }
217
+ /**
218
+ * Copy each changed rules.md bullet into its entry's `text` block and move the old text
219
+ * to the front of its `retired` block. Entries are matched by position; a deleted or
220
+ * added bullet is fixed by hand.
221
+ */
222
+ export function syncRules(store, masters) {
223
+ const lines = store.split("\n");
224
+ for (const s of RULE_SECTIONS) {
225
+ const bullets = ruleBullets(masters[s.region], s.region);
226
+ const head = lines.indexOf(`## ${s.heading}`);
227
+ if (head === -1)
228
+ continue;
229
+ let entry = -1;
230
+ for (let i = head + 1; i < lines.length && !lines[i].startsWith("## "); i++) {
231
+ if (lines[i].startsWith("### "))
232
+ entry++;
233
+ if (lines[i] !== "```text" || entry < 0)
234
+ continue;
235
+ const close = lines.indexOf("```", i + 1);
236
+ const old = lines.slice(i + 1, close).join("\n");
237
+ const bullet = bullets[entry];
238
+ if (bullet === undefined || bullet === old) {
239
+ i = close;
240
+ continue;
241
+ }
242
+ lines.splice(i + 1, close - i - 1, bullet);
243
+ const after = i + 2;
244
+ let j = after + 1;
245
+ while (j < lines.length && lines[j] === "")
246
+ j++;
247
+ if (lines[j] === "```retired")
248
+ lines.splice(j + 1, 0, old);
249
+ else
250
+ lines.splice(after + 1, 0, "", "```retired", old, "```");
251
+ i = after;
252
+ }
253
+ }
254
+ return lines.join("\n");
255
+ }
256
+ // ---------------------------------------------------------------------------
257
+ // Hook Text ← `.bkit/core/hooks/*.js` and the per-host guardrails hooks
258
+ // ---------------------------------------------------------------------------
259
+ /** Hook files whose messages `## Hook Text` copies. */
260
+ export const HOOK_SOURCES = [
261
+ ".bkit/core/hooks/gateguard-engine.js",
262
+ ".bkit/core/hooks/guardrails-read.js",
263
+ ".bkit/core/hooks/guardrails-shell.js",
264
+ ".bkit/core/hooks/guardrails-tiers.js",
265
+ ".bkit/core/hooks/readguard-engine.js",
266
+ ".bkit/core/.claude/hooks/bkit-guardrails.cjs",
267
+ ".bkit/core/.codex/hooks/bkit-guardrails.cjs",
268
+ ".bkit/core/.cursor/hooks/bkit-guardrails.cjs",
269
+ ".bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs",
270
+ ];
271
+ const COOK = { n: "\n", t: "\t" };
272
+ const cook = (ch) => COOK[ch] ?? ch;
273
+ /** Index after the `${…}` expression opened at `i` (just past `${`), skipping nested strings. */
274
+ function skipExpr(src, i) {
275
+ let depth = 1;
276
+ while (i < src.length) {
277
+ const c = src[i];
278
+ if (c === "'" || c === '"' || c === "`") {
279
+ i = readLiteral(src, i).end;
280
+ continue;
281
+ }
282
+ if (c === "{")
283
+ depth++;
284
+ if (c === "}" && --depth === 0)
285
+ return i + 1;
286
+ i++;
287
+ }
288
+ return i;
289
+ }
290
+ function readLiteral(src, start) {
291
+ const q = src[start];
292
+ const parts = [""];
293
+ const holes = [];
294
+ let i = start + 1;
295
+ while (i < src.length && src[i] !== q) {
296
+ const c = src[i];
297
+ if (c === "\\") {
298
+ parts[parts.length - 1] += cook(src[i + 1]);
299
+ i += 2;
300
+ }
301
+ else if (q === "`" && c === "$" && src[i + 1] === "{") {
302
+ const end = skipExpr(src, i + 2);
303
+ holes.push(src.slice(i + 2, end - 1));
304
+ parts.push("");
305
+ i = end;
306
+ }
307
+ else {
308
+ parts[parts.length - 1] += c;
309
+ i++;
310
+ }
311
+ }
312
+ return { start, end: i + 1, parts, holes };
313
+ }
314
+ /** Every string literal of a JS source, comments and regex literals skipped. */
315
+ function literals(src) {
316
+ const out = [];
317
+ let prev = "";
318
+ let i = 0;
319
+ while (i < src.length) {
320
+ const c = src[i];
321
+ if (c === "/" && src[i + 1] === "/") {
322
+ i = src.indexOf("\n", i);
323
+ if (i === -1)
324
+ break;
325
+ continue;
326
+ }
327
+ if (c === "/" && src[i + 1] === "*") {
328
+ i = src.indexOf("*/", i + 2) + 2;
329
+ continue;
330
+ }
331
+ if (c === "/" && (prev === "" || "(,=:[!&|?{};+".includes(prev))) {
332
+ i++;
333
+ let inClass = false;
334
+ while (i < src.length && (src[i] !== "/" || inClass)) {
335
+ if (src[i] === "\\")
336
+ i++;
337
+ else if (src[i] === "[")
338
+ inClass = true;
339
+ else if (src[i] === "]")
340
+ inClass = false;
341
+ i++;
342
+ }
343
+ i++;
344
+ prev = "/";
345
+ continue;
346
+ }
347
+ if (c === "'" || c === '"' || c === "`") {
348
+ const lit = readLiteral(src, i);
349
+ out.push(lit);
350
+ i = lit.end;
351
+ prev = c;
352
+ continue;
353
+ }
354
+ if (!/\s/.test(c))
355
+ prev = c;
356
+ i++;
357
+ }
358
+ return out;
359
+ }
360
+ const MESSAGE_START = /^(?:\[bkit [A-Za-z]+\]|bkit (?:[A-Za-z]+ )?guardrails:|Blocked)/;
361
+ /**
362
+ * Agent-facing messages of a hook file: literals joined by `+` into one string, kept when
363
+ * the string opens with a bkit hook prefix (`[bkit GateGuard]`, `bkit … guardrails:`,
364
+ * `Blocked`), is a `fix:` value, or is the argument right after a kept message (Cursor's
365
+ * `agent_message`).
366
+ */
367
+ export function hookMessages(src, file) {
368
+ const lits = literals(src);
369
+ const fns = [...src.matchAll(/\bfunction\s+(\w+)\s*\(/g)].map((m) => ({
370
+ at: m.index,
371
+ name: m[1],
372
+ }));
373
+ const out = [];
374
+ let lastEnd = -1;
375
+ for (let k = 0; k < lits.length; k++) {
376
+ const group = [lits[k]];
377
+ while (k + 1 < lits.length && /^\s*\+\s*$/.test(src.slice(lits[k].end, lits[k + 1].start))) {
378
+ group.push(lits[++k]);
379
+ }
380
+ const parts = [""];
381
+ const holes = [];
382
+ for (const lit of group) {
383
+ parts[parts.length - 1] += lit.parts[0];
384
+ for (let h = 0; h < lit.holes.length; h++) {
385
+ holes.push(lit.holes[h]);
386
+ parts.push(lit.parts[h + 1]);
387
+ }
388
+ }
389
+ const start = group[0].start;
390
+ const isFix = /\bfix:\s*$/.test(src.slice(Math.max(0, start - 20), start));
391
+ const isNextArg = lastEnd !== -1 && /^\s*,\s*$/.test(src.slice(lastEnd, start));
392
+ if (!isFix && !isNextArg && !MESSAGE_START.test(parts[0]))
393
+ continue;
394
+ lastEnd = group[group.length - 1].end;
395
+ const text = parts.map((p, h) => (h === 0 ? p : `\${${holes[h - 1]}}${p}`)).join("");
396
+ const fn = fns.filter((f) => f.at < group[0].start).pop()?.name ?? "";
397
+ out.push({ file, fn, text, parts });
398
+ }
399
+ return out;
400
+ }
401
+ const escapeLiteral = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
402
+ function parseHookEntries(md) {
403
+ const body = sectionOf(md, "Hook Text") ?? "";
404
+ return body
405
+ .split(/^### /m)
406
+ .slice(1)
407
+ .map((section) => {
408
+ const name = section.slice(0, section.indexOf("\n")).trim();
409
+ const src = /^- source: `([^`]+)` `([^`]+)`$/m.exec(section);
410
+ const text = /^```text\n([\s\S]*?)\n```$/m.exec(section)?.[1] ?? "";
411
+ return { name, file: src?.[1] ?? "", fn: src?.[2] ?? "", texts: text.split("\n\n") };
412
+ });
413
+ }
414
+ /**
415
+ * Findings for `## Hook Text` against the hook files (`file` → content), both ways: each
416
+ * message matches one text of an entry with its file and function (`${…}` on either side
417
+ * matches anything), and each entry text matches a message.
418
+ */
419
+ export function checkHooks(store, sources) {
420
+ const out = [];
421
+ const entries = parseHookEntries(store);
422
+ for (const e of entries) {
423
+ if (!e.file || !e.fn)
424
+ out.push(`\`${e.name}\`: source must be \`{file}\` \`{function}\``);
425
+ }
426
+ const used = new Set();
427
+ for (const [file, src] of sources) {
428
+ for (const m of hookMessages(src, file)) {
429
+ const re = new RegExp(`^${m.parts.map(escapeLiteral).join("[\\s\\S]*")}$`);
430
+ const hits = new Set();
431
+ for (const e of entries) {
432
+ if (e.file !== file || e.fn !== m.fn)
433
+ continue;
434
+ e.texts.forEach((t, i) => {
435
+ if (re.test(t)) {
436
+ hits.add(t);
437
+ used.add(`${e.name}\0${i}`);
438
+ }
439
+ });
440
+ }
441
+ if (hits.size === 0) {
442
+ out.push(`${file} \`${m.fn}\`: no \`## Hook Text\` entry for ${JSON.stringify(m.text)}`);
443
+ }
444
+ else if (hits.size > 1) {
445
+ out.push(`${file} \`${m.fn}\`: ${hits.size} different entry texts match ${JSON.stringify(m.text)}`);
446
+ }
447
+ }
448
+ }
449
+ for (const e of entries) {
450
+ if (!e.file || !e.fn)
451
+ continue;
452
+ e.texts.forEach((t, i) => {
453
+ if (!used.has(`${e.name}\0${i}`)) {
454
+ out.push(`\`${e.name}\`: no longer emitted by \`${e.file}\` \`${e.fn}\` — ${JSON.stringify(t)}`);
455
+ }
456
+ });
457
+ }
458
+ return out;
459
+ }
460
+ // ---------------------------------------------------------------------------
461
+ // Permissions ← `.bkit/shared/.claude/settings.json` and `.bkit/shared/.opencode/opencode.json`
462
+ // ---------------------------------------------------------------------------
463
+ const TIERS = ["deny", "ask", "allow"];
464
+ /** Findings for `## Permissions` against the shipped Claude settings and opencode config. */
465
+ export function checkPermissions(store, settings, opencode) {
466
+ const out = [];
467
+ const body = sectionOf(store, "Permissions") ?? "";
468
+ const groupsOf = new Map();
469
+ const stored = {
470
+ deny: new Map(),
471
+ ask: new Map(),
472
+ allow: new Map(),
473
+ };
474
+ let opencodeSeen = false;
475
+ for (const section of body.split(/^### /m).slice(1)) {
476
+ const name = section.slice(0, section.indexOf("\n")).trim();
477
+ const tier = /^- tier: (.+)$/m.exec(section)?.[1] ?? "";
478
+ if (tier === "opencode `permission`") {
479
+ opencodeSeen = true;
480
+ const json = /^```json\n([\s\S]*?)\n```$/m.exec(section)?.[1] ?? "null";
481
+ if (JSON.stringify(JSON.parse(json)) !== JSON.stringify(opencode.permission ?? null)) {
482
+ out.push(`\`${name}\`: differs from \`.bkit/shared/.opencode/opencode.json\` \`permission\``);
483
+ }
484
+ continue;
485
+ }
486
+ if (!TIERS.includes(tier)) {
487
+ out.push(`\`${name}\`: tier must be deny, ask, allow or opencode \`permission\``);
488
+ continue;
489
+ }
490
+ const patterns = (/^```text\n([\s\S]*?)\n```$/m.exec(section)?.[1] ?? "")
491
+ .split("\n")
492
+ .filter((l) => l !== "");
493
+ const count = Number(/^- count: (\d+)$/m.exec(section)?.[1] ?? NaN);
494
+ if (count !== patterns.length)
495
+ out.push(`\`${name}\`: count ${count}, holds ${patterns.length}`);
496
+ for (const p of patterns) {
497
+ groupsOf.set(p, [...(groupsOf.get(p) ?? []), name]);
498
+ stored[tier].set(p, name);
499
+ }
500
+ }
501
+ for (const [p, groups] of groupsOf) {
502
+ if (groups.length > 1)
503
+ out.push(`\`${p}\` is in ${groups.length} groups: ${groups.join(", ")}`);
504
+ }
505
+ for (const tier of TIERS) {
506
+ const shipped = new Set(settings.permissions?.[tier] ?? []);
507
+ for (const p of shipped) {
508
+ if (!stored[tier].has(p))
509
+ out.push(`${tier}: \`${p}\` is shipped but in no group`);
510
+ }
511
+ for (const [p, group] of stored[tier]) {
512
+ if (!shipped.has(p))
513
+ out.push(`${tier}: \`${p}\` is in \`${group}\` but not shipped`);
514
+ }
515
+ }
516
+ if (!opencodeSeen)
517
+ out.push("no `opencode-permission` group");
518
+ return out;
519
+ }
520
+ // ---------------------------------------------------------------------------
521
+ // Special Behaviors ← `.bkit/core/.bkit/prompts.md`; Authoring Rules ← `workflows.md`
522
+ // ---------------------------------------------------------------------------
523
+ /** Catalog files the two sections copy. `authoring.md` is read in place, never copied. */
524
+ export const CATALOG_SOURCES = [".bkit/core/.bkit/prompts.md", ".bkit/core/.bkit/workflows.md"];
525
+ const FENCE_OPEN = /^(`{3,})/;
526
+ /** Per line: true when the line is a fence marker or inside a fenced block. */
527
+ function fencedLines(lines) {
528
+ let fence = "";
529
+ return lines.map((l) => {
530
+ if (fence) {
531
+ if (l === fence)
532
+ fence = "";
533
+ return true;
534
+ }
535
+ const m = FENCE_OPEN.exec(l);
536
+ if (m)
537
+ fence = m[1];
538
+ return Boolean(m);
539
+ });
540
+ }
541
+ /**
542
+ * Body of the heading named `heading` (any level), up to the next heading of the same or
543
+ * a higher level outside a fenced block; blank lines at both ends dropped.
544
+ */
545
+ export function catalogSection(md, heading) {
546
+ const lines = md.split("\n");
547
+ const fenced = fencedLines(lines);
548
+ const level = (l) => /^(#{1,6}) /.exec(l)?.[1].length ?? 0;
549
+ const at = lines.findIndex((l, i) => !fenced[i] && level(l) > 0 && l.replace(/^#+ /, "") === heading);
550
+ if (at === -1)
551
+ return undefined;
552
+ const own = level(lines[at]);
553
+ let end = at + 1;
554
+ while (end < lines.length &&
555
+ !(level(lines[end]) > 0 && !fenced[end] && level(lines[end]) <= own))
556
+ end++;
557
+ const body = lines.slice(at + 1, end);
558
+ while (body.length > 0 && body[0].trim() === "")
559
+ body.shift();
560
+ while (body.length > 0 && body[body.length - 1].trim() === "")
561
+ body.pop();
562
+ return body.join("\n");
563
+ }
564
+ /** Cells of each `| … |` row of a section's table, header and separator dropped. */
565
+ function tableRows(body) {
566
+ return body
567
+ .split("\n")
568
+ .filter((l) => l.startsWith("| ") && l.endsWith(" |"))
569
+ .map((l) => l.slice(2, -2).split(" | "))
570
+ .slice(2);
571
+ }
572
+ function catalogEntries(lines, section) {
573
+ const fenced = fencedLines(lines);
574
+ const head = lines.findIndex((l, i) => !fenced[i] && l === `## ${section}`);
575
+ if (head === -1)
576
+ return [];
577
+ const out = [];
578
+ let cur;
579
+ for (let i = head + 1; i < lines.length; i++) {
580
+ const l = lines[i];
581
+ if (!fenced[i] && l.startsWith("## "))
582
+ break;
583
+ if (!fenced[i] && l.startsWith("### ")) {
584
+ cur = {
585
+ name: l.slice(4).trim(),
586
+ keys: new Map(),
587
+ file: "",
588
+ heading: "",
589
+ text: "",
590
+ open: -1,
591
+ close: -1,
592
+ };
593
+ out.push(cur);
594
+ continue;
595
+ }
596
+ if (!cur)
597
+ continue;
598
+ const key = /^- ([a-z]+): (.+)$/.exec(l);
599
+ if (key && !fenced[i]) {
600
+ cur.keys.set(key[1], { value: key[2], line: i });
601
+ const src = /^`([^`]+)` § (.+)$/.exec(key[2]);
602
+ if (key[1] === "source" && src)
603
+ [cur.file, cur.heading] = [src[1], src[2]];
604
+ }
605
+ const open = /^(`{3,})text$/.exec(l);
606
+ if (open && cur.open === -1) {
607
+ cur.open = i;
608
+ cur.close = lines.indexOf(open[1], i + 1);
609
+ cur.text = lines.slice(i + 1, cur.close).join("\n");
610
+ }
611
+ }
612
+ return out;
613
+ }
614
+ const BEHAVIORS = "Special Behaviors";
615
+ const AUTHORING = "Authoring Rules";
616
+ /** What each entry should hold, and findings for rows and sections without one. */
617
+ function catalogWants(lines, catalogs) {
618
+ const out = [];
619
+ const wants = [];
620
+ const behaviors = catalogEntries(lines, BEHAVIORS);
621
+ const byTable = new Map();
622
+ for (const e of behaviors) {
623
+ const k = `${e.file}\0${e.heading}`;
624
+ byTable.set(k, [...(byTable.get(k) ?? []), e]);
625
+ }
626
+ for (const [k, entries] of byTable) {
627
+ const [file, heading] = k.split("\0");
628
+ const body = catalogs.has(file) ? catalogSection(catalogs.get(file), heading) : undefined;
629
+ if (body === undefined) {
630
+ out.push(`\`${file}\` § ${heading}: not found`);
631
+ continue;
632
+ }
633
+ const rows = tableRows(body);
634
+ rows.forEach((row, i) => {
635
+ const e = entries[i];
636
+ if (!e)
637
+ out.push(`${row[0]}: no \`## ${BEHAVIORS}\` entry`);
638
+ else
639
+ wants.push({
640
+ entry: e,
641
+ text: row[2] ?? "",
642
+ keys: { behavior: row[0] ?? "", agents: row[1] ?? "" },
643
+ });
644
+ });
645
+ for (const e of entries.slice(rows.length))
646
+ out.push(`\`${e.name}\`: no row in \`${file}\` § ${heading}`);
647
+ }
648
+ for (const e of catalogEntries(lines, AUTHORING)) {
649
+ const body = catalogs.has(e.file)
650
+ ? catalogSection(catalogs.get(e.file), e.heading)
651
+ : undefined;
652
+ if (body === undefined)
653
+ out.push(`\`${e.name}\`: \`${e.file}\` § ${e.heading} not found`);
654
+ else
655
+ wants.push({ entry: e, text: body, keys: {} });
656
+ }
657
+ for (const e of behaviors) {
658
+ if (!e.file)
659
+ out.push(`\`${e.name}\`: source must be \`{file}\` § {heading}`);
660
+ }
661
+ return { wants, out };
662
+ }
663
+ /** Findings for `## Special Behaviors` and `## Authoring Rules` against the catalogs (`file` → content). */
664
+ export function checkCatalogs(store, catalogs) {
665
+ const { wants, out } = catalogWants(store.split("\n"), catalogs);
666
+ for (const w of wants) {
667
+ for (const [k, v] of Object.entries(w.keys)) {
668
+ if (w.entry.keys.get(k)?.value !== v)
669
+ out.push(`\`${w.entry.name}\`: ${k} differs`);
670
+ }
671
+ if (w.entry.text !== w.text) {
672
+ out.push(`\`${w.entry.name}\`: ${Object.keys(w.keys).length > 0 ? "notes" : "text"} differ${Object.keys(w.keys).length > 0 ? "" : "s"} — run pnpm instructions:sync`);
673
+ }
674
+ }
675
+ return out;
676
+ }
677
+ /** The store with each Special Behaviors and Authoring Rules copy refreshed from its catalog. */
678
+ export function syncCatalogs(store, catalogs) {
679
+ const lines = store.split("\n");
680
+ const { wants } = catalogWants(lines, catalogs);
681
+ // Bottom-up, so earlier indexes stay valid.
682
+ wants.sort((a, b) => b.entry.open - a.entry.open);
683
+ for (const w of wants) {
684
+ const text = w.text ?? "";
685
+ if (w.entry.open !== -1 && w.entry.text !== text) {
686
+ const fence = text.includes("```") ? "````" : "```";
687
+ lines.splice(w.entry.open, w.entry.close - w.entry.open + 1, `${fence}text`, ...text.split("\n"), fence);
688
+ }
689
+ for (const [k, v] of Object.entries(w.keys)) {
690
+ const at = w.entry.keys.get(k);
691
+ if (at && at.value !== v)
692
+ lines[at.line] = `- ${k}: ${v}`;
693
+ }
694
+ }
695
+ return lines.join("\n");
696
+ }
697
+ // ---------------------------------------------------------------------------
698
+ // Every copied section, read from `root`
699
+ // ---------------------------------------------------------------------------
700
+ const readAt = (root, rel) => fs.readFileSync(path.join(root, rel), "utf-8");
701
+ export function ruleMasters(root) {
702
+ return {
703
+ bkit: readAt(root, ".bkit/core/.agents/rules.md"),
704
+ project: readAt(root, ".agents/rules.md"),
705
+ };
706
+ }
707
+ const catalogsAt = (root) => new Map(CATALOG_SOURCES.map((f) => [f, readAt(root, f)]));
708
+ /** Findings for every store section that copies a master, read from `root`. */
709
+ export function checkSources(root, store) {
710
+ return [
711
+ ...checkRules(store, ruleMasters(root), (ref, section) => refExists(root, ref, section)),
712
+ ...checkHooks(store, new Map(HOOK_SOURCES.map((f) => [f, readAt(root, f)]))),
713
+ ...checkPermissions(store, JSON.parse(readAt(root, ".bkit/shared/.claude/settings.json")), JSON.parse(readAt(root, ".bkit/shared/.opencode/opencode.json"))),
714
+ ...checkCatalogs(store, catalogsAt(root)),
715
+ ];
716
+ }
717
+ /** The store with every generated copy refreshed from its master. */
718
+ export function syncSources(root, store) {
719
+ return syncCatalogs(syncRules(store, ruleMasters(root)), catalogsAt(root));
720
+ }