@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,361 @@
1
+ // shared/text.ts — engine output as plain text, and markdown tables that provably keep their data.
2
+ //
3
+ // `renderText` prints a command's output object as `key: value` lines: arrays of flat
4
+ // objects as markdown tables, nested values as indented `key:` blocks. `parseText` reads
5
+ // that text back to the value `--json` prints for the same object. Scalars keep their
6
+ // type: a string that would read as `null`, a boolean, a number, `[]`, `{}` or a quoted
7
+ // string prints inside one pair of double quotes. `markdownTable` escapes `|`,
8
+ // backslashes and line breaks, and prints a missing cell as `MISSING`; a literal
9
+ // `MISSING` value is escaped, so the two stay distinct. `checkedTable` renders an array
10
+ // of flat objects and parses the table back, refusing anything that would not read back
11
+ // as the same typed rows.
12
+
13
+ import { parseJson } from "./json.js";
14
+
15
+ /** A missing cell. A value equal to it prints escaped as `\—`. */
16
+ export const MISSING = "—";
17
+
18
+ export type Cell = string | number | boolean | null | undefined;
19
+
20
+ type Scalar = string | number | boolean | null;
21
+
22
+ const isScalar = (v: unknown): v is Scalar =>
23
+ v === null || typeof v === "string" || typeof v === "number" || typeof v === "boolean";
24
+
25
+ const isRecord = (v: unknown): v is Record<string, unknown> =>
26
+ typeof v === "object" && v !== null && !Array.isArray(v);
27
+
28
+ /** Escape backslashes and line breaks so a value stays on one line. */
29
+ const escapeLine = (s: string): string =>
30
+ s.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r");
31
+
32
+ const scalarText = (v: Scalar): string => (v === null ? "null" : String(v));
33
+
34
+ const NUMBER = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
35
+ const LITERALS = new Set(["null", "true", "false", "[]", "{}"]);
36
+
37
+ const quoted = (s: string): boolean => s.length >= 2 && s.startsWith('"') && s.endsWith('"');
38
+
39
+ /** A scalar as typed text: JSON's spelling for non-strings, a string quoted when it would read as one. */
40
+ function scalarCode(v: Scalar): string {
41
+ if (typeof v === "number") return Number.isFinite(v) ? String(v) : "null";
42
+ if (typeof v !== "string") return scalarText(v);
43
+ return v === "" || LITERALS.has(v) || NUMBER.test(v) || quoted(v) ? `"${v}"` : v;
44
+ }
45
+
46
+ /** Typed text back to its scalar. */
47
+ function readScalar(text: string): Scalar {
48
+ if (quoted(text)) return text.slice(1, -1);
49
+ if (text === "null") return null;
50
+ if (text === "true" || text === "false") return text === "true";
51
+ return NUMBER.test(text) ? Number(text) : text;
52
+ }
53
+
54
+ function escapeCell(cell: Cell): string {
55
+ if (cell === undefined) return MISSING;
56
+ const text = escapeLine(scalarText(cell)).replace(/\|/g, "\\|");
57
+ return text === MISSING ? `\\${MISSING}` : text;
58
+ }
59
+
60
+ const tableLine = (cells: string[]): string => `| ${cells.join(" | ")} |`;
61
+
62
+ /** A markdown table as lines, or nothing when there are no rows. Unpadded. */
63
+ export function markdownTable(head: string[], rows: Cell[][]): string[] {
64
+ if (rows.length === 0) return [];
65
+ return [
66
+ tableLine(head.map(escapeCell)),
67
+ tableLine(head.map(() => "---")),
68
+ ...rows.map((r) => tableLine(head.map((_, i) => escapeCell(r[i])))),
69
+ ];
70
+ }
71
+
72
+ /** Split one table line into its raw cells; null when it is not `| … |`. */
73
+ function splitLine(line: string): string[] | null {
74
+ if (!line.startsWith("| ") || !line.endsWith(" |")) return null;
75
+ const body = line.slice(2, -2);
76
+ const cells: string[] = [];
77
+ let cell = "";
78
+ for (let i = 0; i < body.length; i++) {
79
+ const ch = body[i]!;
80
+ if (ch === "\\" && i + 1 < body.length) {
81
+ cell += ch + body[i + 1];
82
+ i++;
83
+ } else if (ch === "|" && body[i - 1] === " " && body[i + 1] === " ") {
84
+ cells.push(cell.slice(0, -1));
85
+ cell = "";
86
+ i++;
87
+ } else {
88
+ cell += ch;
89
+ }
90
+ }
91
+ cells.push(cell);
92
+ return cells;
93
+ }
94
+
95
+ const UNESCAPE: Record<string, string> = {
96
+ n: "\n",
97
+ r: "\r",
98
+ "\\": "\\",
99
+ "|": "|",
100
+ [MISSING]: MISSING,
101
+ };
102
+
103
+ /** Undo `escapeLine` (plus `\|` and `\—` in a cell); null for a bad escape. */
104
+ function unescape(raw: string, escapes: Record<string, string>): string | null {
105
+ let out = "";
106
+ for (let i = 0; i < raw.length; i++) {
107
+ const ch = raw[i]!;
108
+ if (ch !== "\\") {
109
+ out += ch;
110
+ continue;
111
+ }
112
+ const next = escapes[raw[i + 1] ?? ""];
113
+ if (next === undefined) return null;
114
+ out += next;
115
+ i++;
116
+ }
117
+ return out;
118
+ }
119
+
120
+ /** One raw cell back to its value; undefined for a missing cell, null for a bad escape. */
121
+ const unescapeCell = (raw: string): string | undefined | null =>
122
+ raw === MISSING ? undefined : unescape(raw, UNESCAPE);
123
+
124
+ const LINE_ESCAPES: Record<string, string> = { n: "\n", r: "\r", "\\": "\\" };
125
+
126
+ export interface ParsedTable {
127
+ head: string[];
128
+ /** One record per row; missing cells are left out. */
129
+ rows: Record<string, string>[];
130
+ }
131
+
132
+ /** Parse a table `markdownTable` printed; null when the text is not such a table. */
133
+ export function parseMarkdownTable(text: string): ParsedTable | null {
134
+ const lines = text.split("\n");
135
+ if (lines.length < 3) return null;
136
+ const headCells = splitLine(lines[0]!);
137
+ if (!headCells || lines[1] !== tableLine(headCells.map(() => "---"))) return null;
138
+ const head: string[] = [];
139
+ for (const raw of headCells) {
140
+ const name = unescapeCell(raw);
141
+ if (typeof name !== "string") return null;
142
+ head.push(name);
143
+ }
144
+ const rows: Record<string, string>[] = [];
145
+ for (const line of lines.slice(2)) {
146
+ const cells = splitLine(line);
147
+ if (!cells || cells.length !== head.length) return null;
148
+ const row: Record<string, string> = {};
149
+ for (const [i, raw] of cells.entries()) {
150
+ const value = unescapeCell(raw);
151
+ if (value === null) return null;
152
+ if (value !== undefined) row[head[i]!] = value;
153
+ }
154
+ rows.push(row);
155
+ }
156
+ return { head, rows };
157
+ }
158
+
159
+ /** A `checkedTable` table back to its typed rows; null when it is not such a table. */
160
+ function readTable(text: string): Record<string, Scalar>[] | null {
161
+ const parsed = parseMarkdownTable(text);
162
+ if (!parsed) return null;
163
+ return parsed.rows.map((r) =>
164
+ Object.fromEntries(Object.entries(r).map(([k, v]) => [k, readScalar(v)])),
165
+ );
166
+ }
167
+
168
+ export type TableResult = { ok: true; text: string } | { ok: false; reason: string };
169
+
170
+ /** Why `value` cannot be a table, or the flat rows it holds. */
171
+ function flatRows(value: unknown): { rows: Record<string, Scalar>[] } | { reason: string } {
172
+ if (!Array.isArray(value)) return { reason: "not an array" };
173
+ if (value.length === 0) return { reason: "empty array" };
174
+ for (const [i, item] of value.entries()) {
175
+ if (!isRecord(item)) return { reason: `item ${i} is not an object` };
176
+ if (Object.keys(item).length === 0) return { reason: `item ${i} has no keys` };
177
+ for (const [key, v] of Object.entries(item)) {
178
+ if (!isScalar(v)) return { reason: `item ${i} key ${key} is nested` };
179
+ }
180
+ }
181
+ return { rows: value as Record<string, Scalar>[] };
182
+ }
183
+
184
+ /**
185
+ * An array of flat objects as a markdown table whose typed parse equals the input rows.
186
+ * Columns are the union of keys in first-seen order. Anything nested, mixed or empty,
187
+ * or a table that would not read back as the same values of the same types, is refused.
188
+ */
189
+ export function checkedTable(value: unknown): TableResult {
190
+ const flat = flatRows(value);
191
+ if ("reason" in flat) return { ok: false, reason: flat.reason };
192
+ const head = [...new Set(flat.rows.flatMap((r) => Object.keys(r)))];
193
+ const text = markdownTable(
194
+ head,
195
+ flat.rows.map((r) => head.map((k) => (Object.hasOwn(r, k) ? scalarCode(r[k]!) : undefined))),
196
+ ).join("\n");
197
+ const parsed = parseMarkdownTable(text);
198
+ const rows = readTable(text);
199
+ if (!parsed || !rows) return { ok: false, reason: "table does not parse back" };
200
+ const same =
201
+ parsed.head.length === head.length &&
202
+ parsed.head.every((h, i) => h === head[i]) &&
203
+ rows.length === flat.rows.length &&
204
+ rows.every((row, i) => {
205
+ const want = flat.rows[i]!;
206
+ const keys = Object.keys(row);
207
+ return keys.length === Object.keys(want).length && keys.every((k) => row[k] === want[k]);
208
+ });
209
+ return same ? { ok: true, text } : { ok: false, reason: "table parses back to different rows" };
210
+ }
211
+
212
+ // ---------------------------------------------------------------------------
213
+ // renderText
214
+ // ---------------------------------------------------------------------------
215
+
216
+ /** A key as printed: JSON-quoted when it would not read back as a plain key. */
217
+ const keyText = (key: string): string =>
218
+ key === "" || /[:\n\r\\]/.test(key) || /^[-|"\s]/.test(key) || /\s$/.test(key)
219
+ ? JSON.stringify(key)
220
+ : key;
221
+
222
+ const scalarLine = (v: Scalar): string => escapeLine(scalarCode(v));
223
+
224
+ function valueLines(key: string, value: unknown, pad: string): string[] {
225
+ const head = `${pad}${keyText(key)}:`;
226
+ if (isScalar(value)) return [`${head} ${scalarLine(value)}`];
227
+ if (Array.isArray(value)) {
228
+ if (value.length === 0) return [`${head} []`];
229
+ const table = checkedTable(value);
230
+ if (table.ok) return [head, ...table.text.split("\n").map((l) => pad + l)];
231
+ return [head, ...itemLines(value, `${pad} `)];
232
+ }
233
+ if (isRecord(value)) {
234
+ const inner = objectLines(value, `${pad} `);
235
+ return inner.length === 0 ? [`${head} {}`] : [head, ...inner];
236
+ }
237
+ return [`${head} ${String(value)}`];
238
+ }
239
+
240
+ function itemLines(items: unknown[], pad: string): string[] {
241
+ return items.flatMap((item) => {
242
+ if (item === undefined) return [`${pad}- null`];
243
+ if (isScalar(item)) return [`${pad}- ${scalarLine(item)}`];
244
+ if (Array.isArray(item))
245
+ return item.length === 0 ? [`${pad}- []`] : [`${pad}-`, ...itemLines(item, `${pad} `)];
246
+ if (isRecord(item)) {
247
+ const inner = objectLines(item, `${pad} `);
248
+ return inner.length === 0 ? [`${pad}- {}`] : [`${pad}-`, ...inner];
249
+ }
250
+ return [`${pad}- ${String(item)}`];
251
+ });
252
+ }
253
+
254
+ function objectLines(obj: Record<string, unknown>, pad: string): string[] {
255
+ return Object.entries(obj)
256
+ .filter(([, v]) => v !== undefined)
257
+ .flatMap(([k, v]) => valueLines(k, v, pad));
258
+ }
259
+
260
+ /** A command's output object as text: one `key: value` line per scalar, blocks for the rest. */
261
+ export function renderText(payload: Record<string, unknown>): string {
262
+ const lines = objectLines(payload, "");
263
+ return lines.length === 0 ? "" : `${lines.join("\n")}\n`;
264
+ }
265
+
266
+ // ---------------------------------------------------------------------------
267
+ // parseText
268
+ // ---------------------------------------------------------------------------
269
+
270
+ interface Cursor {
271
+ lines: string[];
272
+ i: number;
273
+ }
274
+
275
+ /** No value: the text is not something `renderText` printed. */
276
+ const BAD = Symbol("bad");
277
+ type Read<T> = T | typeof BAD;
278
+
279
+ /** The value after `key: `: an empty container or a typed scalar. */
280
+ function inlineValue(raw: string): Read<unknown> {
281
+ if (raw === "[]") return [];
282
+ if (raw === "{}") return {};
283
+ const text = unescape(raw, LINE_ESCAPES);
284
+ return text === null ? BAD : readScalar(text);
285
+ }
286
+
287
+ /** `key:` / `key: value` split into the key and what follows the colon. */
288
+ function keyLine(line: string): { key: string; rest: string } | null {
289
+ if (line.startsWith('"')) {
290
+ const m = /^"(?:[^"\\]|\\.)*"/.exec(line);
291
+ const key = m ? parseJson(m[0]) : { ok: false as const };
292
+ if (!m || !key.ok || typeof key.value !== "string") return null;
293
+ return { key: key.value, rest: line.slice(m[0].length) };
294
+ }
295
+ const colon = line.indexOf(":");
296
+ return colon <= 0 ? null : { key: line.slice(0, colon), rest: line.slice(colon) };
297
+ }
298
+
299
+ const at = (line: string | undefined, pad: string): boolean =>
300
+ line !== undefined && line.startsWith(pad) && line[pad.length] !== " ";
301
+
302
+ /** The block under a `key:` line whose key sits at `pad`. */
303
+ function readBlock(cur: Cursor, pad: string): Read<unknown> {
304
+ const next = cur.lines[cur.i];
305
+ if (at(next, pad) && next!.startsWith(`${pad}| `)) {
306
+ const table: string[] = [];
307
+ while (at(cur.lines[cur.i], pad) && cur.lines[cur.i]!.startsWith(`${pad}| `))
308
+ table.push(cur.lines[cur.i++]!.slice(pad.length));
309
+ return readTable(table.join("\n")) ?? BAD;
310
+ }
311
+ const inner = `${pad} `;
312
+ if (!at(next, inner)) return BAD;
313
+ return next!.slice(inner.length).startsWith("-") ? readList(cur, inner) : readObject(cur, inner);
314
+ }
315
+
316
+ function readObject(cur: Cursor, pad: string): Read<Record<string, unknown>> {
317
+ const obj: Record<string, unknown> = {};
318
+ while (at(cur.lines[cur.i], pad) && !/^[-|]/.test(cur.lines[cur.i]!.slice(pad.length))) {
319
+ const parsed = keyLine(cur.lines[cur.i++]!.slice(pad.length));
320
+ if (!parsed) return BAD;
321
+ let value: Read<unknown>;
322
+ if (parsed.rest === ":") value = readBlock(cur, pad);
323
+ else if (parsed.rest.startsWith(": ")) value = inlineValue(parsed.rest.slice(2));
324
+ else return BAD;
325
+ if (value === BAD) return BAD;
326
+ obj[parsed.key] = value;
327
+ }
328
+ return obj;
329
+ }
330
+
331
+ function readList(cur: Cursor, pad: string): Read<unknown[]> {
332
+ const items: unknown[] = [];
333
+ while (at(cur.lines[cur.i], pad) && cur.lines[cur.i]!.slice(pad.length).startsWith("-")) {
334
+ const rest = cur.lines[cur.i++]!.slice(pad.length + 1);
335
+ let item: Read<unknown>;
336
+ if (rest.startsWith(" ")) item = inlineValue(rest.slice(1));
337
+ else if (rest !== "") return BAD;
338
+ else {
339
+ const inner = `${pad} `;
340
+ const next = cur.lines[cur.i];
341
+ if (!at(next, inner)) return BAD;
342
+ item = next!.slice(inner.length).startsWith("-")
343
+ ? readList(cur, inner)
344
+ : readObject(cur, inner);
345
+ }
346
+ if (item === BAD) return BAD;
347
+ items.push(item);
348
+ }
349
+ return items;
350
+ }
351
+
352
+ /**
353
+ * Text `renderText` printed, read back to the value `--json` prints for the same
354
+ * object; null when the text is not such output.
355
+ */
356
+ export function parseText(text: string): Record<string, unknown> | null {
357
+ const body = text.endsWith("\n") ? text.slice(0, -1) : text;
358
+ const cur: Cursor = { lines: body === "" ? [] : body.split("\n"), i: 0 };
359
+ const obj = readObject(cur, "");
360
+ return obj === BAD || cur.i !== cur.lines.length ? null : obj;
361
+ }
@@ -24,4 +24,6 @@ export const TIMEOUTS = {
24
24
  BKIT_LATEST_RETRY_S: 3600,
25
25
  /** Seconds the registry lookup may take before it counts as failed. */
26
26
  BKIT_LATEST_LOOKUP_TIMEOUT_S: 5,
27
+ /** Seconds `worktrees setup` waits for a running disk sweep before refusing; under one agent shell call. */
28
+ DISK_SETUP_SWEEP_WAIT_S: 60,
27
29
  } as const;
@@ -0,0 +1,111 @@
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
+
8
+ import * as fs from "node:fs";
9
+ import * as path from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+
12
+ import { CLASSIC_VERB_HELP } from "../cli.js";
13
+ import type { CommandSpec, FlagSpec } from "../commands/lib.js";
14
+ import { COMMANDS } from "../commands/registry.js";
15
+
16
+ export const DOC_PATH = path.join(".bkit", "core", ".bkit", "cli.md");
17
+ export const REGION_START = "<!-- cli:start -->";
18
+ export const REGION_END = "<!-- cli:end -->";
19
+
20
+ export const USE_LABEL = { "by-hand": "by hand", workflow: "workflow" } as const;
21
+
22
+ /** A markdown table cell: pipes escaped, newlines flattened, `—` when empty. */
23
+ const cell = (text: string) => text.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ") || "—";
24
+
25
+ const flagCell = (flags: readonly FlagSpec[]) =>
26
+ flags.map((f) => (f.required ? `**\`--${f.name}\`**` : `\`--${f.name}\``)).join(" ");
27
+
28
+ function table(head: string[], rows: string[][]): string[] {
29
+ return [
30
+ "<!-- prettier-ignore -->",
31
+ `| ${head.join(" | ")} |`,
32
+ `| ${head.map(() => "---").join(" | ")} |`,
33
+ ...rows.map((r) => `| ${r.join(" | ")} |`),
34
+ ];
35
+ }
36
+
37
+ function nounSection(cmd: CommandSpec): string[] {
38
+ const rows = Object.entries(cmd.verbs).map(([verb, spec]) => [
39
+ `\`${verb}\``,
40
+ USE_LABEL[spec.use],
41
+ cell(flagCell(spec.flags)),
42
+ cell(spec.summary),
43
+ ]);
44
+ return [
45
+ `### \`${cmd.noun}\``,
46
+ "",
47
+ cell(cmd.summary),
48
+ "",
49
+ ...table(["Verb", "Use", "Flags", "What it does"], rows),
50
+ "",
51
+ ];
52
+ }
53
+
54
+ /** The generated region, markers included. */
55
+ export function renderRegion(): string {
56
+ const classic = CLASSIC_VERB_HELP.map(({ verb, args, flags, summary }) => [
57
+ `\`${["bkit", verb, ...args.split(" ").filter((w) => /^[a-z]/.test(w))].join(" ")}\``,
58
+ cell(flags.map((f) => `\`${f}\``).join(" ")),
59
+ cell(summary),
60
+ ]);
61
+ const nouns = [...COMMANDS].sort((a, b) => a.noun.localeCompare(b.noun));
62
+ return [
63
+ REGION_START,
64
+ "",
65
+ "## Commands you run",
66
+ "",
67
+ ...table(["Command", "Flags", "What it does"], classic),
68
+ "",
69
+ "## Workflow commands",
70
+ "",
71
+ "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.",
72
+ "",
73
+ ...nouns.flatMap(nounSection),
74
+ REGION_END,
75
+ ].join("\n");
76
+ }
77
+
78
+ /** Offset of `marker` standing alone on a line, else -1 (prose may quote the marker inline). */
79
+ function markerLine(text: string, marker: string): number {
80
+ return new RegExp(`^${marker}$`, "m").exec(text)?.index ?? -1;
81
+ }
82
+
83
+ /** `text` with its generated region replaced by `renderRegion()`; throws when the markers are missing. */
84
+ export function syncDoc(text: string): string {
85
+ const start = markerLine(text, REGION_START);
86
+ const end = markerLine(text, REGION_END);
87
+ if (start < 0 || end < start) {
88
+ throw new Error(`${DOC_PATH}: missing ${REGION_START} / ${REGION_END}`);
89
+ }
90
+ return text.slice(0, start) + renderRegion() + text.slice(end + REGION_END.length);
91
+ }
92
+
93
+ function main(argv: string[]): number {
94
+ const file = path.join(process.cwd(), DOC_PATH);
95
+ const text = fs.readFileSync(file, "utf-8");
96
+ const synced = syncDoc(text);
97
+ if (synced === text) return 0;
98
+ if (argv.includes("--write")) {
99
+ fs.writeFileSync(file, synced, "utf-8");
100
+ console.error(`[bkit-cli] rewrote ${DOC_PATH}`);
101
+ return 0;
102
+ }
103
+ console.error(`[bkit-cli] ${DOC_PATH}: generated region stale (run pnpm cli:sync)`);
104
+ return 1;
105
+ }
106
+
107
+ if (process.argv[1] && fs.existsSync(process.argv[1])) {
108
+ if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
109
+ process.exitCode = main(process.argv.slice(2));
110
+ }
111
+ }
@@ -0,0 +1,215 @@
1
+ // tools/grammar-density.ts — articles (`a`, `an`, `the`) per 1,000 words of agent text.
2
+ //
3
+ // The measure behind `.bkit/core/.bkit/authoring.md` § All Agent-Read Files, Plain, complete sentences: clipped text
4
+ // drops articles, plain English keeps them. `pnpm grammar:density` prints one row per
5
+ // group for the working tree, `--rev=<rev>` for a past commit, and `--diff=<base>..<head>`
6
+ // for only the lines `<head>` added. Repo-only tooling, like `tools/instructions.ts`.
7
+ //
8
+ // Counting: fence marker lines (a line starting with three backticks) are dropped; the
9
+ // rest is lowercased, every character but `a`-`z` becomes a word break.
10
+
11
+ import { spawnSync } from "node:child_process";
12
+ import * as fs from "node:fs";
13
+ import * as path from "node:path";
14
+ import { fileURLToPath } from "node:url";
15
+
16
+ export interface Count {
17
+ words: number;
18
+ articles: number;
19
+ per1k: number;
20
+ }
21
+
22
+ export interface GroupCount extends Count {
23
+ name: string;
24
+ }
25
+
26
+ /** Where files come from: the working tree or one git revision. */
27
+ export interface Source {
28
+ /** Repo-relative paths of every file under `dir`, sorted. */
29
+ list(dir: string): string[];
30
+ /** File content, or undefined when the file is absent. */
31
+ read(file: string): string | undefined;
32
+ }
33
+
34
+ interface GroupDef {
35
+ name: string;
36
+ files(src: Source): string[];
37
+ /** Indexes of the counted lines; undefined = every line. */
38
+ lines?(content: string, file: string): number[];
39
+ }
40
+
41
+ /** Minimum per-1k values for the canonical shared text (`grammar-density.test.ts`). */
42
+ export const FLOORS: Record<string, number> = { clauses: 20, rules: 16 };
43
+
44
+ const FENCE = /^```/;
45
+ const ARTICLE = new Set(["a", "an", "the"]);
46
+
47
+ export function articlesPer1k(lines: string[]): Count {
48
+ let words = 0;
49
+ let articles = 0;
50
+ for (const line of lines) {
51
+ if (FENCE.test(line)) continue;
52
+ for (const w of line.toLowerCase().split(/[^a-z]+/)) {
53
+ if (w === "") continue;
54
+ words++;
55
+ if (ARTICLE.has(w)) articles++;
56
+ }
57
+ }
58
+ return { words, articles, per1k: words === 0 ? 0 : (articles * 1000) / words };
59
+ }
60
+
61
+ /** Line indexes inside ` ```text ` blocks; with `section`, only under that `## ` heading. */
62
+ export function textBlockLines(md: string, section?: string): number[] {
63
+ const lines = md.split("\n");
64
+ const out: number[] = [];
65
+ let inSection = section === undefined;
66
+ let inBlock = false;
67
+ for (let i = 0; i < lines.length; i++) {
68
+ const line = lines[i]!;
69
+ if (!inBlock && line.startsWith("## ")) {
70
+ if (section !== undefined) inSection = line === `## ${section}`;
71
+ continue;
72
+ }
73
+ if (!inSection) continue;
74
+ if (inBlock) {
75
+ if (line === "```") inBlock = false;
76
+ else out.push(i);
77
+ } else if (line === "```text") {
78
+ inBlock = true;
79
+ }
80
+ }
81
+ return out;
82
+ }
83
+
84
+ /** New-side 0-based line indexes a `git diff -U0` output adds. */
85
+ export function addedLines(diff: string): Set<number> {
86
+ const out = new Set<number>();
87
+ for (const m of diff.matchAll(/^@@ -\S+ \+(\d+)(?:,(\d+))? @@/gm)) {
88
+ const start = Number(m[1]);
89
+ const count = m[2] === undefined ? 1 : Number(m[2]);
90
+ for (let n = 0; n < count; n++) out.add(start - 1 + n);
91
+ }
92
+ return out;
93
+ }
94
+
95
+ const STORE = ".bkit/instructions.md";
96
+
97
+ const one = (file: string) => (src: Source) => (src.read(file) === undefined ? [] : [file]);
98
+
99
+ export const GROUPS: readonly GroupDef[] = [
100
+ { name: "rules", files: one(".bkit/core/.agents/rules.md") },
101
+ { name: "prompts", files: (src) => src.list(".bkit/core/prompts") },
102
+ { name: "workflows", files: (src) => src.list(".bkit/core/workflows") },
103
+ {
104
+ // Revisions before the store kept the clauses in `.bkit/wording.md`.
105
+ name: "clauses",
106
+ files: (src) => (src.read(STORE) !== undefined ? [STORE] : one(".bkit/wording.md")(src)),
107
+ lines: (md, file) => (file === STORE ? textBlockLines(md, "Clauses") : textBlockLines(md)),
108
+ },
109
+ {
110
+ name: "store-rules",
111
+ files: one(STORE),
112
+ lines: (md) => textBlockLines(md, "Rules"),
113
+ },
114
+ ];
115
+
116
+ /**
117
+ * One count per group. `added` limits each file to the line indexes it names; a file
118
+ * missing from `added` counts nothing.
119
+ */
120
+ export function measure(src: Source, added?: Map<string, Set<number>>): GroupCount[] {
121
+ return GROUPS.map((g) => {
122
+ const counted: string[] = [];
123
+ for (const file of g.files(src)) {
124
+ const content = src.read(file);
125
+ if (content === undefined) continue;
126
+ const lines = content.split("\n");
127
+ let idx = g.lines ? g.lines(content, file) : lines.map((_, i) => i);
128
+ if (added) {
129
+ const keep = added.get(file) ?? new Set<number>();
130
+ idx = idx.filter((i) => keep.has(i));
131
+ }
132
+ for (const i of idx) counted.push(lines[i]!);
133
+ }
134
+ return { name: g.name, ...articlesPer1k(counted) };
135
+ });
136
+ }
137
+
138
+ export function workingTree(root: string): Source {
139
+ const walk = (rel: string): string[] => {
140
+ const abs = path.join(root, rel);
141
+ if (!fs.existsSync(abs)) return [];
142
+ return fs
143
+ .readdirSync(abs, { withFileTypes: true })
144
+ .flatMap((e) => (e.isDirectory() ? walk(path.join(rel, e.name)) : [path.join(rel, e.name)]));
145
+ };
146
+ return {
147
+ list: (dir) => walk(dir).sort(),
148
+ read: (file) => {
149
+ const abs = path.join(root, file);
150
+ return fs.existsSync(abs) ? fs.readFileSync(abs, "utf-8") : undefined;
151
+ },
152
+ };
153
+ }
154
+
155
+ function git(root: string, args: string[]): { ok: boolean; out: string } {
156
+ const res = spawnSync("git", args, { cwd: root, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
157
+ return { ok: res.status === 0, out: res.stdout ?? "" };
158
+ }
159
+
160
+ export function gitRev(root: string, rev: string): Source {
161
+ return {
162
+ list: (dir) =>
163
+ git(root, ["ls-tree", "-r", "--name-only", rev, "--", dir])
164
+ .out.split("\n")
165
+ .filter(Boolean)
166
+ .sort(),
167
+ read: (file) => {
168
+ const res = git(root, ["show", `${rev}:${file}`]);
169
+ return res.ok ? res.out : undefined;
170
+ },
171
+ };
172
+ }
173
+
174
+ // ---------------------------------------------------------------------------
175
+ // CLI: `pnpm grammar:density [--rev=<rev>] [--diff=<base>..<head>]`
176
+ // ---------------------------------------------------------------------------
177
+
178
+ function main(argv: string[]): number {
179
+ const root = process.cwd();
180
+ const arg = (name: string) =>
181
+ argv.find((a) => a.startsWith(`--${name}=`))?.slice(name.length + 3);
182
+ const rev = arg("rev");
183
+ const diff = arg("diff");
184
+ let groups: GroupCount[];
185
+ if (diff !== undefined) {
186
+ const [base, head] = diff.split("..");
187
+ if (!base || !head) {
188
+ console.error("[bkit-grammar] --diff takes <base>..<head>");
189
+ return 2;
190
+ }
191
+ const src = gitRev(root, head);
192
+ const added = new Map<string, Set<number>>();
193
+ for (const g of GROUPS) {
194
+ for (const file of g.files(src)) {
195
+ added.set(file, addedLines(git(root, ["diff", "-U0", base, head, "--", file]).out));
196
+ }
197
+ }
198
+ groups = measure(src, added);
199
+ } else {
200
+ groups = measure(rev === undefined ? workingTree(root) : gitRev(root, rev));
201
+ }
202
+ console.log(`${"group".padEnd(12)} ${"words".padStart(8)} ${"art/1k".padStart(7)}`);
203
+ for (const g of groups) {
204
+ console.log(
205
+ `${g.name.padEnd(12)} ${String(g.words).padStart(8)} ${g.per1k.toFixed(1).padStart(7)}`,
206
+ );
207
+ }
208
+ return 0;
209
+ }
210
+
211
+ if (process.argv[1] && fs.existsSync(process.argv[1])) {
212
+ if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
213
+ process.exitCode = main(process.argv.slice(2));
214
+ }
215
+ }