@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -0,0 +1,97 @@
1
+ // tools/cli-doc.ts — check and sync the generated region of `.bkit/cli.md`.
2
+ //
3
+ // The region lists every `bkit <verb>` (`cli.ts` `CLASSIC_VERB_HELP`) and every
4
+ // `bkit <noun> <verb>` (`commands/registry.ts`), rendered from the same specs `--help`
5
+ // prints. Check mode runs in the test suite (`tools/cli-doc.test.ts`); write mode is
6
+ // `pnpm cli:sync`. Text outside the region is hand-written and kept as is.
7
+ import * as fs from "node:fs";
8
+ import * as path from "node:path";
9
+ import { fileURLToPath } from "node:url";
10
+ import { CLASSIC_VERB_HELP } from "../cli.js";
11
+ import { COMMANDS } from "../commands/registry.js";
12
+ export const DOC_PATH = path.join(".bkit", "core", ".bkit", "cli.md");
13
+ export const REGION_START = "<!-- cli:start -->";
14
+ export const REGION_END = "<!-- cli:end -->";
15
+ export const USE_LABEL = { "by-hand": "by hand", workflow: "workflow" };
16
+ /** A markdown table cell: pipes escaped, newlines flattened, `—` when empty. */
17
+ const cell = (text) => text.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ") || "—";
18
+ const flagCell = (flags) => flags.map((f) => (f.required ? `**\`--${f.name}\`**` : `\`--${f.name}\``)).join(" ");
19
+ function table(head, rows) {
20
+ return [
21
+ "<!-- prettier-ignore -->",
22
+ `| ${head.join(" | ")} |`,
23
+ `| ${head.map(() => "---").join(" | ")} |`,
24
+ ...rows.map((r) => `| ${r.join(" | ")} |`),
25
+ ];
26
+ }
27
+ function nounSection(cmd) {
28
+ const rows = Object.entries(cmd.verbs).map(([verb, spec]) => [
29
+ `\`${verb}\``,
30
+ USE_LABEL[spec.use],
31
+ cell(flagCell(spec.flags)),
32
+ cell(spec.summary),
33
+ ]);
34
+ return [
35
+ `### \`${cmd.noun}\``,
36
+ "",
37
+ cell(cmd.summary),
38
+ "",
39
+ ...table(["Verb", "Use", "Flags", "What it does"], rows),
40
+ "",
41
+ ];
42
+ }
43
+ /** The generated region, markers included. */
44
+ export function renderRegion() {
45
+ const classic = CLASSIC_VERB_HELP.map(({ verb, args, flags, summary }) => [
46
+ `\`${["bkit", verb, ...args.split(" ").filter((w) => /^[a-z]/.test(w))].join(" ")}\``,
47
+ cell(flags.map((f) => `\`${f}\``).join(" ")),
48
+ cell(summary),
49
+ ]);
50
+ const nouns = [...COMMANDS].sort((a, b) => a.noun.localeCompare(b.noun));
51
+ return [
52
+ REGION_START,
53
+ "",
54
+ "## Commands you run",
55
+ "",
56
+ ...table(["Command", "Flags", "What it does"], classic),
57
+ "",
58
+ "## Workflow commands",
59
+ "",
60
+ "Use: `by hand` = safe and useful outside a workflow run; `workflow` = a workflow step only (writes run state, takes locks, commits, pushes or posts). **Bold** flag = required.",
61
+ "",
62
+ ...nouns.flatMap(nounSection),
63
+ REGION_END,
64
+ ].join("\n");
65
+ }
66
+ /** Offset of `marker` standing alone on a line, else -1 (prose may quote the marker inline). */
67
+ function markerLine(text, marker) {
68
+ return new RegExp(`^${marker}$`, "m").exec(text)?.index ?? -1;
69
+ }
70
+ /** `text` with its generated region replaced by `renderRegion()`; throws when the markers are missing. */
71
+ export function syncDoc(text) {
72
+ const start = markerLine(text, REGION_START);
73
+ const end = markerLine(text, REGION_END);
74
+ if (start < 0 || end < start) {
75
+ throw new Error(`${DOC_PATH}: missing ${REGION_START} / ${REGION_END}`);
76
+ }
77
+ return text.slice(0, start) + renderRegion() + text.slice(end + REGION_END.length);
78
+ }
79
+ function main(argv) {
80
+ const file = path.join(process.cwd(), DOC_PATH);
81
+ const text = fs.readFileSync(file, "utf-8");
82
+ const synced = syncDoc(text);
83
+ if (synced === text)
84
+ return 0;
85
+ if (argv.includes("--write")) {
86
+ fs.writeFileSync(file, synced, "utf-8");
87
+ console.error(`[bkit-cli] rewrote ${DOC_PATH}`);
88
+ return 0;
89
+ }
90
+ console.error(`[bkit-cli] ${DOC_PATH}: generated region stale (run pnpm cli:sync)`);
91
+ return 1;
92
+ }
93
+ if (process.argv[1] && fs.existsSync(process.argv[1])) {
94
+ if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
95
+ process.exitCode = main(process.argv.slice(2));
96
+ }
97
+ }
@@ -1,6 +1,6 @@
1
1
  // tools/grammar-density.ts — articles (`a`, `an`, `the`) per 1,000 words of agent text.
2
2
  //
3
- // The measure behind `.bkit/core/.bkit/authoring.md` § Notation, Grammar: clipped text
3
+ // The measure behind `.bkit/core/.bkit/authoring.md` § All Agent-Read Files, Plain, complete sentences: clipped text
4
4
  // drops articles, plain English keeps them. `pnpm grammar:density` prints one row per
5
5
  // group for the working tree, `--rev=<rev>` for a past commit, and `--diff=<base>..<head>`
6
6
  // for only the lines `<head>` added. Repo-only tooling, like `tools/instructions.ts`.
@@ -29,6 +29,8 @@ export const CARRIER_SURFACES = [
29
29
  "hook",
30
30
  "permission",
31
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-]*/;
32
34
  const CITES = /^((?:`[^`:]+:\d+`(?:, )?)+): ?(.*)$/;
33
35
  /** One drift item line (` - ` dropped) with its `kept` reason. */
34
36
  export function parseDriftItem(raw, kept) {
@@ -66,8 +68,8 @@ export function entryKeys(section) {
66
68
  return out;
67
69
  }
68
70
  const RULE_SECTIONS = [
69
- { heading: "Rules", prefix: "R", region: "bkit" },
70
- { heading: "Project Rules", prefix: "P", region: "project" },
71
+ { heading: "Rules", region: "bkit" },
72
+ { heading: "Project Rules", region: "project" },
71
73
  ];
72
74
  /** Top-level `- ` bullets of the bkit block, or of `## Project Rules` below `bkit:end`, in file order. */
73
75
  export function ruleBullets(rulesMd, region) {
@@ -95,7 +97,6 @@ export function parseRuleEntries(md, heading) {
95
97
  .slice(1)
96
98
  .map((section) => {
97
99
  const name = section.slice(0, section.indexOf("\n")).trim();
98
- const id = /^- rule: ([RP]\d+)/m.exec(section)?.[1] ?? "";
99
100
  const block = (kind) => [...section.matchAll(new RegExp(`^\`\`\`${kind}\\n([\\s\\S]*?)^\`\`\`$`, "gm"))].flatMap((m) => m[1].split("\n").filter((l) => l.trim() !== ""));
100
101
  const refs = [];
101
102
  const refsAt = section.search(/^- refs:$/m);
@@ -141,7 +142,6 @@ export function parseRuleEntries(md, heading) {
141
142
  }
142
143
  return {
143
144
  name,
144
- id,
145
145
  text: block("text").join("\n"),
146
146
  retired: block("retired"),
147
147
  refs,
@@ -181,21 +181,24 @@ export function refExists(root, ref, section) {
181
181
  /** Findings for `## Rules` and `## Project Rules` against their masters. */
182
182
  export function checkRules(store, masters, exists) {
183
183
  const out = [];
184
+ const seen = new Set();
184
185
  for (const s of RULE_SECTIONS) {
185
186
  const entries = parseRuleEntries(store, s.heading);
186
187
  const bullets = ruleBullets(masters[s.region], s.region);
187
188
  const n = Math.max(entries.length, bullets.length);
188
189
  for (let i = 0; i < n; i++) {
189
- const want = `${s.prefix}${String(i + 1).padStart(2, "0")}`;
190
190
  const e = entries[i];
191
191
  const bullet = bullets[i];
192
192
  if (!e) {
193
- out.push(`${want}: rules.md bullet has no \`## ${s.heading}\` entry — ${bullet}`);
193
+ out.push(`${s.heading} bullet ${i + 1} of rules.md has no entry — ${bullet}`);
194
194
  continue;
195
195
  }
196
- const tag = `${e.id || want} \`${e.name}\``;
197
- if (e.id !== want)
198
- out.push(`${tag}: id should be ${want} (file order of rules.md)`);
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);
199
202
  if (bullet === undefined) {
200
203
  out.push(`${tag}: no rules.md bullet at position ${i + 1}`);
201
204
  continue;
@@ -515,14 +518,10 @@ export function checkPermissions(store, settings, opencode) {
515
518
  return out;
516
519
  }
517
520
  // ---------------------------------------------------------------------------
518
- // Special Behaviors ← `.bkit/core/.bkit/prompts.md`; Authoring Rules ← `authoring.md`, `workflows.md`
521
+ // Special Behaviors ← `.bkit/core/.bkit/prompts.md`; Authoring Rules ← `workflows.md`
519
522
  // ---------------------------------------------------------------------------
520
- /** Catalog files the two sections copy. */
521
- export const CATALOG_SOURCES = [
522
- ".bkit/core/.bkit/prompts.md",
523
- ".bkit/core/.bkit/workflows.md",
524
- ".bkit/core/.bkit/authoring.md",
525
- ];
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"];
526
525
  const FENCE_OPEN = /^(`{3,})/;
527
526
  /** Per line: true when the line is a fence marker or inside a fenced block. */
528
527
  function fencedLines(lines) {
@@ -16,7 +16,7 @@ import * as fs from "node:fs";
16
16
  import * as path from "node:path";
17
17
  import { fileURLToPath } from "node:url";
18
18
  import { findLineAnchoredMarkers, selectMarkers } from "../install/managed-block.js";
19
- import { checkSources, parseDriftItem, parseRuleEntries, sectionOf, syncSources, } from "./instructions-sources.js";
19
+ import { checkSources, parseDriftItem, parseRuleEntries, RULE_NAME, sectionOf, syncSources, } from "./instructions-sources.js";
20
20
  export { sectionOf };
21
21
  /** Near-copy threshold: a sentence this similar to a clause but not equal to it is drift. */
22
22
  export const NEAR_COPY = 0.8;
@@ -24,7 +24,7 @@ export const NEAR_COPY = 0.8;
24
24
  export const SHARED_MIN = {
25
25
  prompt: 2,
26
26
  workflow: 2,
27
- audit: 5,
27
+ audit: 2,
28
28
  doc: 2,
29
29
  };
30
30
  /** Surfaces a clause can set a mode for. */
@@ -121,7 +121,7 @@ export function parseClauses(md) {
121
121
  clause.fullyRetired = value === "yes";
122
122
  }
123
123
  else if (key === "rule") {
124
- clause.rule = /^[RP]\d+/.exec(value)?.[0];
124
+ clause.rule = RULE_NAME.exec(value)?.[0];
125
125
  }
126
126
  else if (key === "tags") {
127
127
  clause.tags = value.split(",").map((t) => t.trim());
@@ -281,6 +281,23 @@ export function loadCorpus(root) {
281
281
  * to check or rewrite.
282
282
  */
283
283
  export function proseLineIndexes(file) {
284
+ return memoLines(proseCache, file, computeProseLineIndexes);
285
+ }
286
+ /** Line-index memo keyed by surface and content; every clause asks for the same file's lines. */
287
+ function memoLines(cache, file, compute) {
288
+ const key = `${file.surface}\u0000${file.content}`;
289
+ let hit = cache.get(key);
290
+ if (!hit) {
291
+ if (cache.size > 5_000)
292
+ cache.clear();
293
+ hit = compute(file);
294
+ cache.set(key, hit);
295
+ }
296
+ return hit;
297
+ }
298
+ const proseCache = new Map();
299
+ const clauseLineCache = new Map();
300
+ function computeProseLineIndexes(file) {
284
301
  const lines = file.content.split("\n");
285
302
  let from = 0;
286
303
  let to = lines.length;
@@ -321,9 +338,11 @@ export function proseLineIndexes(file) {
321
338
  * `**Rules:**` block, whose lines are rules.md copies the `- carry:` check owns.
322
339
  */
323
340
  export function clauseLineIndexes(file) {
324
- const prose = proseLineIndexes(file);
325
- const block = file.surface === "prompt" ? ruleBlock(file.content.split("\n")) : undefined;
326
- return block ? prose.filter((i) => i < block.from || i >= block.to) : prose;
341
+ return memoLines(clauseLineCache, file, (f) => {
342
+ const prose = proseLineIndexes(f);
343
+ const block = f.surface === "prompt" ? ruleBlock(f.content.split("\n")) : undefined;
344
+ return block ? prose.filter((i) => i < block.from || i >= block.to) : prose;
345
+ });
327
346
  }
328
347
  /** Lines a clause is matched against: a `block: rules` clause also sees the prompt's `**Rules:**` block it sits in. */
329
348
  function linesFor(clause, file) {
@@ -424,28 +443,34 @@ export function compileText(text) {
424
443
  if (hit)
425
444
  return hit;
426
445
  const slots = [];
446
+ const literals = [];
427
447
  let source = "";
428
448
  let last = 0;
429
449
  for (const m of text.matchAll(SLOT)) {
430
- source += escapeRe(text.slice(last, m.index));
450
+ const segment = text.slice(last, m.index);
451
+ literals.push(segment);
452
+ source += escapeRe(segment);
431
453
  source += m[2] ? "(.*?)" : "(.+?)";
432
454
  slots.push(m[1]);
433
455
  last = m.index + m[0].length;
434
456
  }
435
457
  const tail = text.slice(last);
436
458
  // A closing `.` also matches `;`: the line continues the sentence with local text.
437
- source += tail.endsWith(".") ? `${escapeRe(tail.slice(0, -1))}[.;]` : escapeRe(tail);
459
+ const tailLiteral = tail.endsWith(".") ? tail.slice(0, -1) : tail;
460
+ literals.push(tailLiteral);
461
+ source += tail.endsWith(".") ? `${escapeRe(tailLiteral)}[.;]` : escapeRe(tail);
438
462
  const first = text.search(SLOT);
439
463
  const compiled = {
440
464
  re: new RegExp(source, "g"),
441
465
  slots,
442
466
  prefix: first === -1 ? text : text.slice(0, first),
467
+ literal: literals.reduce((a, b) => (b.length > a.length ? b : a), ""),
443
468
  slotted: slots.length > 0,
444
469
  };
445
470
  compiledCache.set(text, compiled);
446
471
  return compiled;
447
472
  }
448
- const countIn = (line, c) => [...line.matchAll(c.re)].length;
473
+ const countIn = (line, c) => line.includes(c.literal) ? [...line.matchAll(c.re)].length : 0;
449
474
  /** Drop the blockquote, list marker, step number, or checkbox in front of a line's text. */
450
475
  export const stripLinePrefix = (line) => line.replace(/^[ \t]*(?:>[ \t]?)?(?:[ \t]*(?:[-*]|\d+\.)[ \t]+)?(?:\[[ xX]\][ \t]+)?/, "");
451
476
  /** Split after `.` or `;` (bold close allowed between), never after `e.g.`; the punctuation stays on the sentence. */
@@ -557,13 +582,15 @@ function nearCopies(clause, lineIdx, line, allTexts) {
557
582
  window = window.replace(LABEL, "");
558
583
  // A clause can close a sentence that opens with local text (`**If** {cond} → {clause}`): also compare the tail.
559
584
  const words = window.split(/\s+/);
560
- const candidates = [window];
585
+ const candidates = [[window, words]];
561
586
  for (const n of [cw - 1, cw, cw + 1]) {
562
- if (n > 0 && n < words.length)
563
- candidates.push(words.slice(-n).join(" "));
587
+ if (n > 0 && n < words.length) {
588
+ const tail = words.slice(-n);
589
+ candidates.push([tail.join(" "), tail]);
590
+ }
564
591
  }
565
- for (const found of candidates) {
566
- if (allTexts.has(found) || !nearCandidate(found.split(/\s+/), canonicalWords))
592
+ for (const [found, foundWords] of candidates) {
593
+ if (allTexts.has(found) || !nearCandidate(foundWords, canonicalWords, counts))
567
594
  continue;
568
595
  const score = similarity(found, canonical);
569
596
  if (score >= NEAR_COPY && (!best || score > best.score))
@@ -744,20 +771,23 @@ export function checkClauses(clauses, files) {
744
771
  return findings.concat(unlistedShared(clauses, files));
745
772
  }
746
773
  /** Could two sentences be NEAR_COPY-similar? Cheap word-count and shared-word bounds before `similarity`. */
747
- function nearCandidate(a, b) {
774
+ function nearCandidate(a, b, bCounts) {
748
775
  const longer = Math.max(a.length, b.length);
749
776
  const need = Math.ceil(NEAR_COPY * longer);
750
777
  if (Math.min(a.length, b.length) < need)
751
778
  return false;
752
- const pool = new Map();
753
- for (const w of b)
754
- pool.set(w, (pool.get(w) ?? 0) + 1);
779
+ // `bCounts` is read-only (a caller's memoised counts): track the words of `b` used up so far.
780
+ const counts = bCounts ?? wordCounts(b);
781
+ const used = new Map();
755
782
  let shared = 0;
756
783
  for (const w of a) {
757
- const n = pool.get(w) ?? 0;
758
- if (n > 0) {
784
+ const n = counts.get(w);
785
+ if (n === undefined)
786
+ continue;
787
+ const u = used.get(w) ?? 0;
788
+ if (u < n) {
759
789
  shared++;
760
- pool.set(w, n - 1);
790
+ used.set(w, u + 1);
761
791
  }
762
792
  }
763
793
  return shared >= need;
@@ -804,6 +834,7 @@ export function unlistedShared(clauses, files) {
804
834
  /** Group each sentence with its near-copies; report every group reaching `min` files. */
805
835
  function sharedGroups(seen, min, noun) {
806
836
  const words = new Map([...seen.keys()].map((s) => [s, s.split(/\s+/)]));
837
+ const counts = new Map([...words].map(([s, w]) => [s, wordCounts(w)]));
807
838
  const reported = new Set();
808
839
  const findings = [];
809
840
  // Seeds: every sentence, widest first, so a group is reported once under its most-copied wording.
@@ -814,7 +845,7 @@ function sharedGroups(seen, min, noun) {
814
845
  continue;
815
846
  const near = [...seen.keys()].filter((s) => s !== seed &&
816
847
  !reported.has(s) &&
817
- nearCandidate(words.get(seed), words.get(s)) &&
848
+ nearCandidate(words.get(seed), words.get(s), counts.get(s)) &&
818
849
  similarity(seed, s) >= NEAR_COPY);
819
850
  const group = new Set([...ids.keys(), ...near.flatMap((s) => [...seen.get(s).keys()])]);
820
851
  if (group.size < min)
@@ -1010,8 +1041,8 @@ export const LOCAL_SECTION = {
1010
1041
  "plan-template": "Plan template",
1011
1042
  entry: "Entry file",
1012
1043
  };
1013
- const LOCAL_TAG = /^(?:[RP]\d+|fit `[^`]+` [\d.]+)$/;
1014
- /** `[R01; fit `x` 0.8; keep: {reason}] {text}`; a bracket holding anything but tags stays text. */
1044
+ const LOCAL_TAG = /^(?:[a-z0-9][a-z0-9-]*|fit `[^`]+` [\d.]+)$/;
1045
+ /** `[scope-discipline; fit `x` 0.8; keep: {reason}] {text}`; a bracket holding anything but tags stays text. */
1015
1046
  export function parseLocalLine(line) {
1016
1047
  const m = /^\[([^\]]+)\] (.+)$/.exec(line);
1017
1048
  if (m) {
@@ -1159,7 +1190,7 @@ function ruleCarriers(ix, r, relations, out) {
1159
1190
  if (file)
1160
1191
  found.push({ relation: c.relation, file });
1161
1192
  else
1162
- out?.push(`${r.id} \`${r.name}\`: ${c.relation} carrier \`${n}\` is no ${surface} file`);
1193
+ out?.push(`\`${r.name}\`: ${c.relation} carrier \`${n}\` is no ${surface} file`);
1163
1194
  }
1164
1195
  }
1165
1196
  return found;
@@ -1232,13 +1263,25 @@ export function checkCoverage(store, corpus) {
1232
1263
  out.push(`${f.name}: local entry no longer in the file: ${e.text}`);
1233
1264
  }
1234
1265
  }
1266
+ // Every rule name a tag or clause cites is a rule.
1267
+ const ruleNames = new Set(ix.rules.map((r) => r.name));
1268
+ for (const e of ix.local) {
1269
+ for (const t of e.tags.filter((t) => !ruleNames.has(t))) {
1270
+ out.push(`${e.file ?? `shared (${e.carriers})`}: tag \`${t}\` names no rule: ${e.text}`);
1271
+ }
1272
+ }
1273
+ for (const c of ix.clauses) {
1274
+ for (const t of [c.rule ?? [], c.tags ?? []].flat().filter((t) => !ruleNames.has(t))) {
1275
+ out.push(`clause \`${c.name}\`: \`${t}\` names no rule`);
1276
+ }
1277
+ }
1235
1278
  // Nothing extra: rule carriers.
1236
1279
  for (const r of ix.rules) {
1237
1280
  const sentences = splitSentences(r.text);
1238
1281
  for (const { relation, file } of ruleCarriers(ix, r, ["verbatim", "partial", "condensed", "specialised", "applies", "cites"], out)) {
1239
1282
  const prose = ix.prose.get(file.id);
1240
- const tag = `${r.id} \`${r.name}\``;
1241
- const linked = ix.clauses.filter((c) => c.rule === r.id || c.name === r.clause);
1283
+ const tag = `\`${r.name}\``;
1284
+ const linked = ix.clauses.filter((c) => c.rule === r.name || c.name === r.clause);
1242
1285
  const viaClause = linked.some((c) => c.texts.some((t) => prose.some((l) => plain(compileText(t).re).test(l))));
1243
1286
  if (relation === "verbatim") {
1244
1287
  if (viaClause)
@@ -1253,11 +1296,11 @@ export function checkCoverage(store, corpus) {
1253
1296
  }
1254
1297
  continue;
1255
1298
  }
1256
- const tagged = (localOf.get(file.id) ?? []).some((e) => e.tags.includes(r.id));
1257
- const viaTaggedClause = ix.clauses.some((c) => c.tags?.includes(r.id) &&
1299
+ const tagged = (localOf.get(file.id) ?? []).some((e) => e.tags.includes(r.name));
1300
+ const viaTaggedClause = ix.clauses.some((c) => c.tags?.includes(r.name) &&
1258
1301
  c.texts.some((t) => prose.some((l) => plain(compileText(t).re).test(l))));
1259
1302
  if (!tagged && !viaClause && !viaTaggedClause) {
1260
- out.push(`${tag}: ${relation} carrier \`${file.name}\` has no local line or clause tagged ${r.id}`);
1303
+ out.push(`${tag}: ${relation} carrier \`${file.name}\` has no local line or clause tagged \`${r.name}\``);
1261
1304
  }
1262
1305
  }
1263
1306
  // Drift: each cite holds its excerpt.
@@ -1266,20 +1309,20 @@ export function checkCoverage(store, corpus) {
1266
1309
  if (entry) {
1267
1310
  const heading = entry[1] === "hook" ? "Hook Text" : "Permissions";
1268
1311
  if (!new RegExp(`^### ${escapeRe(entry[2])}$`, "m").test(sectionOf(store, heading) ?? "")) {
1269
- out.push(`${r.id} \`${r.name}\`: drift names no \`## ${heading}\` entry \`${entry[2]}\``);
1312
+ out.push(`\`${r.name}\`: drift names no \`## ${heading}\` entry \`${entry[2]}\``);
1270
1313
  }
1271
1314
  continue;
1272
1315
  }
1273
1316
  if (d.cites.length === 0 || d.excerpt === undefined) {
1274
- out.push(`${r.id} \`${r.name}\`: drift item needs \`{file}:{line}\` cites and a "quoted excerpt": ${d.raw}`);
1317
+ out.push(`\`${r.name}\`: drift item needs \`{file}:{line}\` cites and a "quoted excerpt": ${d.raw}`);
1275
1318
  continue;
1276
1319
  }
1277
1320
  for (const c of d.cites) {
1278
1321
  const candidates = citeFiles(ix, c.name);
1279
1322
  if (candidates.length === 0)
1280
- out.push(`${r.id} \`${r.name}\`: drift \`${c.name}:${c.line}\` names no file`);
1323
+ out.push(`\`${r.name}\`: drift \`${c.name}:${c.line}\` names no file`);
1281
1324
  else if (!candidates.some((f) => lineHolds(f, c.line, d.excerpt))) {
1282
- out.push(`${r.id} \`${r.name}\`: drift \`${c.name}:${c.line}\` does not hold "${d.excerpt}"`);
1325
+ out.push(`\`${r.name}\`: drift \`${c.name}:${c.line}\` does not hold "${d.excerpt}"`);
1283
1326
  }
1284
1327
  }
1285
1328
  }
@@ -1294,7 +1337,7 @@ export function openFits(store) {
1294
1337
  }
1295
1338
  /** Drift items with no `kept` reason. */
1296
1339
  export function openDrift(store) {
1297
- return [...parseRuleEntries(store, "Rules"), ...parseRuleEntries(store, "Project Rules")].flatMap((r) => r.drift.filter((d) => d.kept === undefined).map((d) => `${r.id} \`${r.name}\`: ${d.raw}`));
1340
+ return [...parseRuleEntries(store, "Rules"), ...parseRuleEntries(store, "Project Rules")].flatMap((r) => r.drift.filter((d) => d.kept === undefined).map((d) => `\`${r.name}\`: ${d.raw}`));
1298
1341
  }
1299
1342
  /** Label line opening a prompt's block of rule copies. */
1300
1343
  export const RULES_BLOCK = BLOCK_LABEL.rules;
@@ -1327,7 +1370,7 @@ export function checkRuleCopies(store, corpus) {
1327
1370
  rules.find((r) => nearCandidate(text.split(/\s+/), r.text.split(/\s+/)) &&
1328
1371
  similarity(text, r.text) >= NEAR_COPY);
1329
1372
  if (rule) {
1330
- out.push(`${rule.id} \`${rule.name}\`: \`${f.id}:${i + 1}\` copies the rule in its ${BLOCK_LABEL[b]} block; it belongs in the ${RULES_BLOCK} block`);
1373
+ out.push(`\`${rule.name}\`: \`${f.id}:${i + 1}\` copies the rule in its ${BLOCK_LABEL[b]} block; it belongs in the ${RULES_BLOCK} block`);
1331
1374
  }
1332
1375
  }
1333
1376
  }
@@ -1354,14 +1397,14 @@ export function checkCarry(store, corpus) {
1354
1397
  for (const n of named) {
1355
1398
  carried.add(n);
1356
1399
  if (!standing.get(n)?.some((l) => l.text === r.text)) {
1357
- missing.push(`${r.id} \`${r.name}\`: carry \`${n}\` lacks the whole rule bullet`);
1400
+ missing.push(`\`${r.name}\`: carry \`${n}\` lacks the whole rule bullet`);
1358
1401
  }
1359
1402
  }
1360
1403
  if (!bkit.includes(r))
1361
1404
  continue;
1362
1405
  for (const f of prompts) {
1363
1406
  if (!named.has(f.name) && standing.get(f.name).some((l) => l.text.includes(r.text))) {
1364
- undeclared.push(`${r.id} \`${r.name}\`: \`${f.name}\` holds the rule but no carry line names it`);
1407
+ undeclared.push(`\`${r.name}\`: \`${f.name}\` holds the rule but no carry line names it`);
1365
1408
  }
1366
1409
  }
1367
1410
  }
@@ -1422,12 +1465,13 @@ export function similarEntries(store) {
1422
1465
  }
1423
1466
  const out = [];
1424
1467
  const words = entries.map((e) => e.text.split(/\s+/));
1468
+ const counts = words.map(wordCounts);
1425
1469
  for (let i = 0; i < entries.length; i++) {
1426
1470
  for (let j = i + 1; j < entries.length; j++) {
1427
1471
  const [a, b] = [entries[i], entries[j]];
1428
1472
  if (a.name === b.name || a.distinct.has(b.name) || b.distinct.has(a.name))
1429
1473
  continue;
1430
- if (!nearCandidate(words[i], words[j]))
1474
+ if (!nearCandidate(words[i], words[j], counts[j]))
1431
1475
  continue;
1432
1476
  const score = similarity(a.text, b.text);
1433
1477
  if (score >= NEAR_COPY) {