@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
@@ -71,9 +71,17 @@ function judge(cwd, wt, fid) {
71
71
  const git = (...args) => spawnSync("git", ["-C", wt, ...args], { encoding: "utf8" });
72
72
  if (fs.globSync(path.join(cwd, "docs/plans/*/logs", fid, ".lock")).length > 0)
73
73
  return { keep: "a bkit workflow holds its lock" };
74
+ // git in a plain folder inside the checkout answers for the checkout itself, so a folder is
75
+ // a worktree only when git names it as its own top.
76
+ if (
77
+ !fs.existsSync(wt) ||
78
+ git("rev-parse", "--show-toplevel").stdout.trim() !== fs.realpathSync(wt)
79
+ )
80
+ return { note: "not a git worktree; delete the folder if unneeded" };
74
81
  if (idleDays(wt) < 2) return { keep: "committed to in the last 2 days" };
75
82
  const status = git("status", "--porcelain");
76
- if (status.status !== 0) return { note: "not a git worktree; delete the folder if unneeded" };
83
+ if (status.status !== 0)
84
+ return { note: `git status failed (\`git -C .worktrees/${fid} status\`)` };
77
85
  if (status.stdout.trim() !== "")
78
86
  return { note: `uncommitted or untracked files (\`git -C .worktrees/${fid} status\`)` };
79
87
  if (git("rev-list", "HEAD", "--not", "--remotes").stdout.trim() !== "") {
@@ -5,7 +5,7 @@
5
5
  #!/usr/bin/env python3
6
6
  """Compute per-capability drift status by literal-pattern scan, for the generated diagram.
7
7
 
8
- Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Reads
8
+ Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Reads
9
9
  bkit-graph-drift-rules.json, walks the source tree once, and writes an overlay JSON
10
10
  that bkit-graphify-rollup.py paints onto the Mermaid nodes.
11
11
 
@@ -5,7 +5,7 @@
5
5
  #!/usr/bin/env python3
6
6
  """Find modules that do work when they are imported, and count who pays for it.
7
7
 
8
- Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON that
8
+ Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON that
9
9
  bkit-graphify-rollup.py renders as the import-time side-effect table in
10
10
  docs/capabilities.md.
11
11
 
@@ -135,7 +135,7 @@ def inside_callable(path, line):
135
135
  # --- who imports this, transitively -------------------------------------------
136
136
  # graph.json already carries the imports graphify cannot resolve — a `.js`
137
137
  # specifier never reaching a `.tsx` file, and workspace subpaths through an
138
- # `exports` map. bkit-graph-repair.py injects them during `pnpm graph`, so they are
138
+ # `exports` map. bkit-graph-repair.py injects them during `pnpm bkit:graph`, so they are
139
139
  # read here like any other edge; warns if graph.json lacks any of them.
140
140
  INBOUND = collections.defaultdict(set)
141
141
  for link in raw["links"]:
@@ -232,5 +232,5 @@ print(f"[eager] {REPAIRED} of those edges came from bkit-graph-repair.py — imp
232
232
  f"graphify cannot resolve (.js -> .tsx, workspace exports subpaths)")
233
233
  if ungraphed:
234
234
  print(f"[eager] {ungraphed} scanned files absent from graph.json (column-0 filter only) "
235
- f"— run 'pnpm graph:update' to close the gap", file=sys.stderr)
235
+ f"— run 'pnpm bkit:graph:update' to close the gap", file=sys.stderr)
236
236
  print(f"[eager] wrote {args.eager_out}", file=sys.stderr)
@@ -0,0 +1,63 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ # List the docs to embed into in GRAPH_EMBED_DOCS (bkit-graphify.sh).
4
+
5
+ #!/usr/bin/env python3
6
+ """Copy the packages diagram from the capability register into other docs.
7
+
8
+ Called by `pnpm bkit:graph:rollup`, `:register` and `:refresh` (write) and by
9
+ `pnpm bkit:graph:check` (--check), scripts/graphify/bkit-graphify.sh, for every doc in
10
+ GRAPH_EMBED_DOCS. Runs on system python (stdlib only).
11
+
12
+ bkit-graph-embed.py <capabilities.md> <doc>... [--check]
13
+
14
+ Each doc holds one block between the two markers below. Write mode replaces what
15
+ is between them with the fenced Mermaid block under `## Architecture — packages`
16
+ in the register, byte for byte. --check writes nothing and exits 1 when any doc's
17
+ block differs. A doc without both markers exits 2: a listed doc that cannot take
18
+ the diagram is a setup error, not a clean result.
19
+ """
20
+
21
+ import argparse
22
+ import re
23
+ import sys
24
+
25
+ START, END = "<!-- graph:packages:start -->", "<!-- graph:packages:end -->"
26
+ HEADING = "## Architecture — packages"
27
+
28
+ ap = argparse.ArgumentParser()
29
+ ap.add_argument("capabilities_doc")
30
+ ap.add_argument("docs", nargs="+")
31
+ ap.add_argument("--check", action="store_true")
32
+ args = ap.parse_args()
33
+
34
+ register = open(args.capabilities_doc, encoding="utf-8").read()
35
+ if HEADING not in register:
36
+ sys.exit(f"[graph] {args.capabilities_doc}: no `{HEADING}` section — run pnpm bkit:graph:rollup first")
37
+ m = re.search(r"```mermaid\n.*?\n```", register.split(HEADING, 1)[1], re.S)
38
+ if not m:
39
+ sys.exit(f"[graph] {args.capabilities_doc}: `{HEADING}` has no ```mermaid block")
40
+ block = f"{START}\n\n{m.group(0)}\n\n{END}"
41
+
42
+ stale = []
43
+ for doc in args.docs:
44
+ text = open(doc, encoding="utf-8").read()
45
+ if text.count(START) != 1 or text.count(END) != 1 or text.index(START) > text.index(END):
46
+ print(f"[graph] {doc}: needs exactly one {START} … {END} pair", file=sys.stderr)
47
+ sys.exit(2)
48
+ head, rest = text.split(START, 1)
49
+ tail = rest.split(END, 1)[1]
50
+ fresh = head + block + tail
51
+ if fresh == text:
52
+ continue
53
+ if args.check:
54
+ stale.append(doc)
55
+ else:
56
+ with open(doc, "w", encoding="utf-8") as fh:
57
+ fh.write(fresh)
58
+ print(f"[graph] {doc}: packages diagram rewritten")
59
+
60
+ if stale:
61
+ print(f"[graph] DRIFT: the packages diagram in {', '.join(stale)} is not the one in "
62
+ f"{args.capabilities_doc}.", file=sys.stderr)
63
+ sys.exit(1)
@@ -9,7 +9,7 @@ the sibling `graph-*.py` scripts, which are standalone and cannot be imported
9
9
  themselves.
10
10
 
11
11
  ONE WRITER. `bkit-graph-repair.py` is the only script that writes
12
- `resolved_import_edges()` into graph.json, during `pnpm graph`, so `graphify affected` /
12
+ `resolved_import_edges()` into graph.json, during `pnpm bkit:graph`, so `graphify affected` /
13
13
  `explain` / `path` / `query` see the same edges these scripts do. bkit-graph-eager.py
14
14
  and bkit-graphify-rollup.py call `warn_if_unrepaired()`, which compares the same set
15
15
  against graph.json, and otherwise just read the graph.
@@ -147,7 +147,7 @@ def warn_if_unrepaired(graph, who, stream=None):
147
147
  if missing:
148
148
  print(f"[{who}] WARNING: graph.json lacks {len(missing)} imports that "
149
149
  f"bkit-graph-repair.py adds, so reachability and blast-radius numbers "
150
- f"below are UNDERSTATED. Run 'pnpm graph:update'.",
150
+ f"below are UNDERSTATED. Run 'pnpm bkit:graph:update'.",
151
151
  file=stream or _sys.stderr)
152
152
  return repair_state(graph)
153
153
 
@@ -4,39 +4,90 @@
4
4
  # copy lacks that call → re-copy the "Capability register" block from the template.
5
5
  # bkit install does not write this file and does not overwrite a copy.
6
6
  #
7
- # Capability register current on dev. BLOCKS a push to dev when docs/capabilities.md is not
8
- # what the pushed commit builds. Reads PUSH_DEV_SHA (commit pushed to dev), set by the bkit
9
- # pre-push template while reading git's ref list on stdin; stdin is consumed by now.
7
+ # Capability register current wherever CI checks it. BLOCKS a push to dev, and a push of a
8
+ # branch with an open PR into dev, when docs/capabilities.md is not what the pushed commit
9
+ # builds: CI's Check Capability Register fails both. Reads PUSH_DEV_SHA (commit pushed to dev),
10
+ # BRANCH (the checked-out branch) and PUSH_BRANCH_SHA (commit pushed to that branch, empty when
11
+ # the push does not update it), set by the bkit pre-push template while reading git's ref list
12
+ # on stdin; stdin is consumed by now. An older hook copy sets no BRANCH / PUSH_BRANCH_SHA → the
13
+ # checked-out branch and HEAD stand in.
10
14
  #
11
15
  # graphify reads the working tree → check runs in a throwaway checkout of the pushed commit
12
16
  # (`check-at`): uncommitted edits, a concurrent session's included, cannot change the answer.
13
17
  # Other graphify release → blocked, with the install command. graphify NOT INSTALLED → warn
14
18
  # only, saying the check did not run: a cloud session without it must still push; CI's Check
15
- # Capability Register runs the same check on every push to dev. Revert pushes (IS_REVERT=1)
16
- # skip it, as they skip the test tiers. Other branches → warn-only staleness note.
19
+ # Capability Register runs the same check on every push to dev and every pull request. The
20
+ # open-PR lookup needs gh: gh NOT INSTALLED, or its call FAILING (offline, not signed in) →
21
+ # warn only, as with graphify; a lookup that cannot answer is never read as "no PR". Revert pushes
22
+ # (IS_REVERT=1) skip it, as they skip the test tiers. A branch with no open PR → warn-only
23
+ # staleness note.
17
24
  CAP_DOC="docs/capabilities.md"
18
25
  if [ -f scripts/graphify/bkit-graphify.sh ] && [ -f "$CAP_DOC" ]; then
19
- if [ -n "${PUSH_DEV_SHA:-}" ] && [ "${IS_REVERT:-0}" != "1" ]; then
26
+ # The commit to check, and what the push is; empty → the warn-only note.
27
+ CAP_GATE_SHA=""
28
+ CAP_GATE_WHAT=""
29
+ if [ "${IS_REVERT:-0}" = "1" ]; then
30
+ :
31
+ elif [ -n "${PUSH_DEV_SHA:-}" ]; then
32
+ CAP_GATE_SHA="$PUSH_DEV_SHA"
33
+ CAP_GATE_WHAT="this push to dev"
34
+ else
35
+ CAP_BRANCH="${BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")}"
36
+ if [ -n "${PUSH_BRANCH_SHA+set}" ]; then
37
+ CAP_PUSHED="$PUSH_BRANCH_SHA"
38
+ else
39
+ CAP_PUSHED=$(git rev-parse HEAD 2>/dev/null || echo "")
40
+ fi
41
+ case "$CAP_BRANCH" in
42
+ "" | HEAD | dev | main) ;;
43
+ *)
44
+ if [ -z "$CAP_PUSHED" ]; then
45
+ :
46
+ else
47
+ # Why the lookup could not answer; empty → it answered (a PR number, or none).
48
+ CAP_UNKNOWN=""
49
+ if ! command -v gh >/dev/null 2>&1; then
50
+ CAP_UNKNOWN="gh is not installed"
51
+ # strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
52
+ elif CAP_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$CAP_BRANCH" --base dev --state open --json number --jq '.[0].number' 2>/dev/null); then
53
+ if [ -n "$CAP_PR" ]; then
54
+ CAP_GATE_SHA="$CAP_PUSHED"
55
+ CAP_GATE_WHAT="PR #$CAP_PR into dev"
56
+ fi
57
+ else
58
+ CAP_UNKNOWN="gh pr list failed (offline, or gh not signed in)"
59
+ fi
60
+ if [ -n "$CAP_UNKNOWN" ]; then
61
+ echo "[pre-push] WARNING: $CAP_DOC was NOT checked — $CAP_UNKNOWN, so whether '$CAP_BRANCH' has an open PR is unknown." >&2
62
+ echo "[pre-push] If a PR is open, CI's Check Capability Register fails it on a stale register; run" >&2
63
+ echo "[pre-push] pnpm bkit:graph:refresh, commit, and push again." >&2
64
+ fi
65
+ fi
66
+ ;;
67
+ esac
68
+ fi
69
+ if [ -n "$CAP_GATE_SHA" ]; then
20
70
  if ! command -v graphify >/dev/null 2>&1; then
21
71
  echo "[pre-push] WARNING: $CAP_DOC was NOT checked — graphify is not installed." >&2
22
- echo "[pre-push] CI's Check Capability Register checks it on this push; if it reds there, run" >&2
23
- echo "[pre-push] pnpm graph:refresh, commit, and push again. Install graphify to check before pushing:" >&2
72
+ echo "[pre-push] CI's Check Capability Register checks it for $CAP_GATE_WHAT; if it reds there, run" >&2
73
+ echo "[pre-push] pnpm bkit:graph:refresh, commit, and push again. Install graphify to check before pushing:" >&2
24
74
  echo "[pre-push] brew install uv && uv tool install '$(bash scripts/graphify/bkit-graphify.sh spec)'" >&2
25
- elif ! bash scripts/graphify/bkit-graphify.sh check-at "$PUSH_DEV_SHA" < /dev/null; then
26
- echo "[pre-push] BLOCKED: $CAP_DOC is not what the pushed commit builds (diff above)." >&2
27
- echo "[pre-push] Fix: pnpm graph:refresh && git add $CAP_DOC && git commit, then push again." >&2
75
+ elif ! bash scripts/graphify/bkit-graphify.sh check-at "$CAP_GATE_SHA" < /dev/null; then
76
+ echo "[pre-push] BLOCKED: $CAP_DOC is not what the pushed commit builds (diff above); CI fails $CAP_GATE_WHAT on it." >&2
77
+ echo "[pre-push] Fix: pnpm bkit:graph:refresh, git add the files it rewrote, git commit, then push again." >&2
28
78
  exit 1
29
79
  fi
30
80
  else
31
- # Warn-only. A fresh register is stamped at the parent of its commit → staleness =
32
- # source files changed since that stamp.
33
- CAP_SHA=$(sed -n 's/.*Diagrams from `graph\.json` @ `\([0-9a-f]\{7,\}\)`.*/\1/p' "$CAP_DOC" | head -1)
34
- if [ -n "$CAP_SHA" ] && git cat-file -e "$CAP_SHA^{commit}" 2>/dev/null; then
81
+ # Warn-only. Staleness = source files changed since the last commit that changed the
82
+ # register. A rebuild that changes nothing commits nothing, so the count can include
83
+ # files that left the register as it was.
84
+ CAP_SHA=$(git log -1 --format=%h -- "$CAP_DOC" 2>/dev/null || true)
85
+ if [ -n "$CAP_SHA" ]; then
35
86
  CAP_CHANGED=$(git diff --name-only "$CAP_SHA..HEAD" -- '*.ts' '*.tsx' 2>/dev/null | wc -l | tr -d ' ')
36
87
  if [ "${CAP_CHANGED:-0}" -gt 0 ]; then
37
- echo "[pre-push] NOTE: $CAP_DOC diagrams were built at $CAP_SHA; $CAP_CHANGED source files changed since." >&2
38
- echo "[pre-push] Refresh when convenient: pnpm graph:refresh" >&2
39
- echo "[pre-push] Not a gate on this branch. A push to dev is blocked until it is current." >&2
88
+ echo "[pre-push] NOTE: $CAP_DOC last changed in $CAP_SHA; $CAP_CHANGED source files changed since." >&2
89
+ echo "[pre-push] Refresh when convenient: pnpm bkit:graph:refresh" >&2
90
+ echo "[pre-push] Not a gate on this branch until it has an open PR into dev; a push to dev is blocked until it is current." >&2
40
91
  fi
41
92
  fi
42
93
  fi
@@ -5,7 +5,7 @@
5
5
  #!/usr/bin/env python3
6
6
  """Inject the import edges graphify could not resolve back into graph.json.
7
7
 
8
- Called by `pnpm graph`, `:clean` and `:update` (scripts/graphify/bkit-graphify.sh),
8
+ Called by `pnpm bkit:graph`, `:clean` and `:update` (scripts/graphify/bkit-graphify.sh),
9
9
  between `extract` and `cluster-only`.
10
10
 
11
11
  bkit-graph-repair.py <graph.json> [--rules R] [--quiet]
@@ -16,9 +16,9 @@ checks, the generated doc, and `graphify affected`, `god-nodes`, `explain`,
16
16
  this step says so.
17
17
 
18
18
  `graphify update` rewrites graph.json without the injected edges, so every
19
- wrapper command that writes the file (`pnpm graph`, `:clean`, `:update`) runs
19
+ wrapper command that writes the file (`pnpm bkit:graph`, `:clean`, `:update`) runs
20
20
  this step at the end. The step is idempotent: after a raw `graphify update .`,
21
- run `pnpm graph:update`.
21
+ run `pnpm bkit:graph:update`.
22
22
 
23
23
  ORDER MATTERS: this runs BEFORE clustering, so communities, the god-node
24
24
  ranking and the cycle list in graph-report.md are computed from the repaired graph.
@@ -5,7 +5,7 @@
5
5
  #!/usr/bin/env python3
6
6
  """Link user-facing routes to the backend capabilities they reach.
7
7
 
8
- Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
8
+ Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
9
9
  capabilities doc renders as its route layer.
10
10
 
11
11
  bkit-graph-surface.py <graph.json> <surface-out.json> [--quiet]
@@ -5,7 +5,7 @@
5
5
  #!/usr/bin/env python3
6
6
  """Export the full symbol graph to GraphML for Gephi / yEd.
7
7
 
8
- Called by `pnpm graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
8
+ Called by `pnpm bkit:graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
9
9
  OWN interpreter — it imports graphify itself.
10
10
 
11
11
  bkit-graphify-graphml.py <graph.json> <out.graphml>