@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
@@ -89,19 +89,20 @@ const CORE_MANIFEST = [
89
89
  // `.bkit/core/.bkit/` and are read from there at runtime (getBkitDocsRoot); these
90
90
  // consumer copies are force-overwritten mirrors (writeTier1) so a consumer can read
91
91
  // them in-repo. Whole file is bkit-owned → byte-equal-text (refreshed every install);
92
- // prompts.md and lite.md are markered-text, keeping the consumer section below `bkit:end`.
92
+ // prompts.md is markered-text, keeping the consumer section below `bkit:end`.
93
93
  { path: ".bkit/authoring.md", format: "byte-equal-text", module: "core" },
94
94
  { path: ".bkit/cloud.md", format: "byte-equal-text", module: "core" },
95
+ { path: ".bkit/cli.md", format: "byte-equal-text", module: "core" },
95
96
  { path: ".bkit/comparison.md", format: "byte-equal-text", module: "core" },
96
97
  { path: ".bkit/install.md", format: "byte-equal-text", module: "core" },
97
98
  { path: ".bkit/jsonl.md", format: "byte-equal-text", module: "core" },
98
99
  // The MIT notice that travels with the files bkit writes: the full text and copyright
99
100
  // notice. Sourced from `.bkit/core/.bkit/LICENSE.md`.
100
101
  { path: ".bkit/LICENSE.md", format: "byte-equal-text", module: "core" },
101
- { path: ".bkit/lite.md", format: "markered-text", module: "core" },
102
102
  { path: ".bkit/pipeline.md", format: "byte-equal-text", module: "core" },
103
103
  { path: ".bkit/providers.md", format: "byte-equal-text", module: "core" },
104
104
  { path: ".bkit/prompts.md", format: "markered-text", module: "core" },
105
+ { path: ".bkit/router.md", format: "byte-equal-text", module: "core" },
105
106
  { path: ".bkit/templates.md", format: "byte-equal-text", module: "core" },
106
107
  { path: ".bkit/trackers.md", format: "byte-equal-text", module: "core" },
107
108
  { path: ".bkit/workflows.md", format: "byte-equal-text", module: "core" },
@@ -159,7 +160,7 @@ const CLAUDE_MANIFEST = [
159
160
  // (bkit-tests-static / -unit / -integration / -e2e / -live). Where a step is not a
160
161
  // tier (`format`, the ship gate) the name spells out the actual steps. One exception:
161
162
  // `min` sits off the chain: the least a push runs, on a push that changes no code
162
- // (`bkit.testing.minPushPaths`); its steps are whatever that push can still break.
163
+ // (what bkit writes, plus `bkit.testing.minPushPaths`); its steps are whatever that push can still break.
163
164
  //
164
165
  // The consumer owns every value: a turbo monorepo writes `turbo run … --filter`,
165
166
  // a Python repo writes `ruff check && pytest`. bkit never reads a value — only
@@ -168,7 +169,7 @@ const CLAUDE_MANIFEST = [
168
169
  // Seeded by core on every install and upgrade (seedCorePackageJsonScripts,
169
170
  // install/modules/index.ts): add-if-missing, so a name already present is never touched,
170
171
  // and uninstall leaves every name in place. The tool scripts the defaults chain
171
- // (typecheck, lint, format:check, lint:prose, slop:delta, lint-staged) are the
172
+ // (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta, lint-staged) are the
172
173
  // consumer's to add — `.bkit/templates.md` lists them; the
173
174
  // `gate-missing-called-scripts` advisory names any that are missing.
174
175
  //
@@ -177,7 +178,7 @@ const CLAUDE_MANIFEST = [
177
178
  // directly, one step each.
178
179
  //
179
180
  // `lint:slop` is in no gate: `slop-scan scan` is report-only and never fails. The gate
180
- // that fails on new findings is `slop:delta`.
181
+ // that fails on new findings is `bkit:slop:delta`.
181
182
  //
182
183
  // NOT SEEDED: the three deeper gates (…-integration, …-integration-e2e,
183
184
  // …-integration-e2e-live) are absent unless the consumer writes them. Each is one line
@@ -189,16 +190,16 @@ export const BKIT_GATE_SCRIPTS = {
189
190
  // `.husky/pre-commit`: prettier --write over staged files, and nothing else —
190
191
  // seconds, not minutes. Prose is a whole-repo scan, so it gates at pre-push.
191
192
  "bkit:gate:format": "pnpm lint-staged",
192
- // `.husky/pre-push` on a min push (every file matches `bkit.testing.minPushPaths`): no code, so
193
+ // `.husky/pre-push` on a min push (every file is one bkit writes or `bkit.testing.minPushPaths` adds): no code, so
193
194
  // no typecheck, lint or tests. Off the chain. Add any test that reads a min-push file.
194
- "bkit:gate:min": "pnpm format:check && pnpm lint:prose && pnpm slop:delta",
195
+ "bkit:gate:min": "pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
195
196
  // Everything that needs no test runner. Every part has a matching step in the
196
197
  // bkit-tests-static CI job; audits/templates/template-ci-yml.test.ts fails when one is missing.
197
198
  // Callers: build's plan-execute loop between tasks, and the `.husky/pre-push` revert
198
199
  // path.
199
- "bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm lint:prose && pnpm slop:delta",
200
+ "bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
200
201
  // The default local gate: `.husky/pre-push` (when no `…-integration` gate is declared),
201
- // build Step 11, the remediates. `pnpm test` is the unit tier only: a test file the
202
+ // build Steps 8 and 12, the remediates. `pnpm test` is the unit tier only: a test file the
202
203
  // integration gate also runs must not match it.
203
204
  "bkit:gate:static-unit": "pnpm bkit:gate:static && pnpm test",
204
205
  // Ship's conflict-resolve, the only caller whose dependency graph may have just
@@ -229,17 +230,23 @@ export const BKIT_DEBUG_GATES = [
229
230
  "bkit:gate:static-unit",
230
231
  ];
231
232
  /**
232
- * What `/bkit-build` Step 11 will run, in DESCENDING order — first one declared wins.
233
+ * What `/bkit-build` Step 12 will run, in DESCENDING order — first one declared wins.
234
+ * The Step 8 group gate runs `BKIT_GROUP_GATES` instead.
233
235
  *
234
236
  * Build stops at integration; E2E and live are not in this list.
235
237
  *
236
- * Neither entry is seeded: declaring `bkit:gate:static-unit-integration` opts the build
237
- * loop and the pre-push hook into the integration tier.
238
+ * Declaring `bkit:gate:static-unit-integration` (never seeded) opts Step 12 and the
239
+ * pre-push hook into the integration tier.
238
240
  */
239
241
  export const BKIT_BUILD_GATES = [
240
242
  "bkit:gate:static-unit-integration",
241
243
  "bkit:gate:static-unit",
242
244
  ];
245
+ /**
246
+ * What `/bkit-build` Step 8 runs after every group but the last, and hands the Step 9 fix
247
+ * round: static checks and the unit tier. Integration runs once, at Step 12.
248
+ */
249
+ export const BKIT_GROUP_GATES = ["bkit:gate:static-unit"];
243
250
  /**
244
251
  * What `.husky/pre-push` runs on a full push, in DESCENDING order — first one declared wins.
245
252
  *
@@ -257,6 +264,21 @@ export const BKIT_PUSH_GATES = [
257
264
  * upgrade advise when it is missing (detectGateAdvisories).
258
265
  */
259
266
  export const BKIT_TEST_FILE_SCRIPT = "bkit:test:file";
267
+ /**
268
+ * Lints ONE test file — `pnpm bkit:lint:file <repo-relative path>`, exit 0 when clean.
269
+ * `bkit tests red` runs it before recording a red, so a lint rewrite never lands after
270
+ * the red. Never seeded: install, check and upgrade advise when `bkit:test:file` is
271
+ * declared and this is not (detectGateAdvisories).
272
+ */
273
+ export const BKIT_LINT_FILE_SCRIPT = "bkit:lint:file";
274
+ /**
275
+ * Checks only what changed — `pnpm bkit:gate:changed <repo-relative path>...`, exit 0
276
+ * when clean: the tests that import the files, the tests that name their paths, and
277
+ * static checks on the files. `bkit tests changed` passes the files and falls back to a
278
+ * whole gate when this is undeclared. Never seeded: install, check and upgrade advise
279
+ * when it is missing (detectGateAdvisories).
280
+ */
281
+ export const BKIT_GATE_CHANGED_SCRIPT = "bkit:gate:changed";
260
282
  /**
261
283
  * The deeper gates, shallowest first, with what declaring each one costs.
262
284
  *
@@ -349,6 +371,13 @@ export const OPENCODE_MANIFEST = [
349
371
  format: "markered-text",
350
372
  module: "opencode",
351
373
  },
374
+ // bkit-rules.js — same split as bkit-gateguard.js. Delivers the rules-read advisory
375
+ // on the session's first tool call (opencode has no session-start event).
376
+ {
377
+ path: ".opencode/plugin/bkit-rules.js",
378
+ format: "markered-text",
379
+ module: "opencode",
380
+ },
352
381
  // Agent and command mirrors are managed dynamically (not listed individually here —
353
382
  // the exact set depends on the bkit-prefix prompt/workflow files at install time).
354
383
  // Uninstall uses the BKIT_PREFIX filter for .opencode/agents/ and .opencode/commands/.
@@ -385,6 +414,14 @@ export const CODEX_MANIFEST = [
385
414
  format: "markered-text",
386
415
  module: "codex",
387
416
  },
417
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
418
+ // session as `additionalContext` on the first tool call (Codex has no session-start
419
+ // event). Registered on two single-value matchers, `apply_patch` and `Bash`.
420
+ {
421
+ path: ".codex/hooks/bkit-rules.cjs",
422
+ format: "markered-text",
423
+ module: "codex",
424
+ },
388
425
  // Agent mirrors (.codex/agents/*.toml) and workflow skills (.agents/skills/bkit-*/) are
389
426
  // managed dynamically — the set follows the bkit-prefix prompt/workflow files at install.
390
427
  ];
@@ -421,6 +458,14 @@ export const ANTIGRAVITY_MANIFEST = [
421
458
  format: "markered-text",
422
459
  module: "antigravity",
423
460
  },
461
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
462
+ // session by denying the first tool call with the advisory as the reason (Antigravity's
463
+ // only channel to the model); the identical retry is allowed.
464
+ {
465
+ path: ".agents/plugins/bkit/hooks/bkit-rules.cjs",
466
+ format: "markered-text",
467
+ module: "antigravity",
468
+ },
424
469
  // Root GEMINI.md — Antigravity workspace-rule redirect to .agents/rules.md, owned by the
425
470
  // antigravity module: `uninstall --antigravity` removes it; other installs leave it.
426
471
  { path: "GEMINI.md", format: "markered-text", module: "antigravity" },
@@ -161,8 +161,9 @@ export function runAntigravityModule(ctx) {
161
161
  console.log(`${logPrefix} ${tag}antigravity: ${jsonDst}`);
162
162
  }
163
163
  }
164
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude/Codex hooks ---
165
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
164
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
165
+ // twins of the Claude/Codex hooks ---
166
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
166
167
  const hookSrc = path.join(pluginHooksSrc, hook);
167
168
  const hookDst = path.join(ANTIGRAVITY_HOOKS_DIR, hook);
168
169
  if (fs.existsSync(hookSrc)) {
@@ -53,7 +53,7 @@ function setConsumerBkitField(field, value, dryRun) {
53
53
  }
54
54
  // The cloud workflow is a template (`.bkit/templates.md`). Shared first step of the
55
55
  // claude and opencode setup advisories.
56
- const CLOUD_WORKFLOW_ADOPT_STEP = " - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
56
+ const CLOUD_WORKFLOW_ADOPT_STEP = " - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file after you copy it. The one exception is a brand migration: `bkit upgrade` rewrites exact shipped old names in it and leaves any edited line. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
57
57
  // ---------------------------------------------------------------------------
58
58
  // runCloudModule — opt-in cloud-agent integration
59
59
  // ---------------------------------------------------------------------------
@@ -99,7 +99,7 @@ export function runCloudModule(ctx) {
99
99
  severity: "advisory",
100
100
  detect: "Cloud env config splits across the repo (`.claude/hooks/bkit-cloud-bootstrap.sh`, a copy-and-own template you adopt) and the Claude app dashboard (setup script + env vars + auth tokens, manual).",
101
101
  action: "Two locations to touch — full recipe in bkit's `cloud.md`.\n\n" +
102
- "IN REPO (copy-and-own; bkit never writes it):\n" +
102
+ "IN REPO (copy-and-own; bkit never writes it, apart from brand migrations that rewrite exact shipped old names):\n" +
103
103
  " - Adopt `.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh` as `.claude/hooks/bkit-cloud-bootstrap.sh` and edit it freely — the baseline runs `pnpm install` / `vale sync` and the gh login on each cloud session; add your own repo-specific steps (Supabase start, turbo prebuild, etc. — examples inlined). The `.claude/settings.json` SessionStart entry runs it only when present (`test -f … || true`).\n\n" +
104
104
  "IN CLAUDE APP (claude.ai/code → environment selector → + Add environment):\n" +
105
105
  " - Name: the repo name (e.g. `acme-web`) — one environment per repo, since secrets are per-repo.\n" +
@@ -146,7 +146,7 @@ export function runCloudModule(ctx) {
146
146
  " - Allowed concurrency: latest-supersedes.\n" +
147
147
  " - Set `BKIT_LINEAR_API_KEY` as a **Runtime Secret** in the Cloud Agents dashboard (https://cursor.com/dashboard/cloud-agents) → your environment → Secrets tab.\n" +
148
148
  " - Label the issue `bkit:auto` in Linear before pushing the build commit.\n\n" +
149
- "IN REPO (copy each template and own it; bkit never writes or overwrites these files — see `.bkit/templates.md`):\n" +
149
+ "IN REPO (copy each template and own it; bkit never writes or overwrites these files, apart from brand migrations that rewrite exact shipped old names — see `.bkit/templates.md`):\n" +
150
150
  " - `.bkit/templates/.cursor/Dockerfile` → `.cursor/Dockerfile`: change Node major if `engines.node` differs from 20; add Playwright / Supabase CLI / extra apt deps.\n" +
151
151
  " - `.bkit/templates/.cursor/environment.json` → `.cursor/environment.json`: set `install` / `start` / `terminals[]` / `env` for your stack.",
152
152
  });
@@ -8,6 +8,7 @@ import { getCoreRoot, getSharedRoot, getWorkflowsRoot, getPromptsRoot, } from ".
8
8
  import { DEFAULT_ISSUE_TRACKER } from "../manifest.js";
9
9
  import { substituteWorkflow } from "../../render/trackers.js";
10
10
  import { readInstallingVersion } from "../../shared/package-json.js";
11
+ import { writeCodexCloudDoc } from "../cloud-env.js";
11
12
  import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
12
13
  /**
13
14
  * Convert a workflow orchestrator (`.bkit/core/workflows/*.md`) into a Codex SKILL.md.
@@ -141,8 +142,9 @@ export function runCodexModule(ctx) {
141
142
  console.log(`${logPrefix} ${tag}codex: ${jsonDst}`);
142
143
  }
143
144
  }
144
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude hooks ---
145
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
145
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
146
+ // twins of the Claude hooks ---
147
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
146
148
  const hookSrc = path.join(codexHooks, hook);
147
149
  const hookDst = `.codex/hooks/${hook}`;
148
150
  if (fs.existsSync(hookSrc)) {
@@ -170,6 +172,14 @@ export function runCodexModule(ctx) {
170
172
  console.log(`${logPrefix} ${tag}codex: ${railDst}`);
171
173
  }
172
174
  }
175
+ // Generated copy-paste-ready Codex Cloud setup doc — `.codex/bkit-cloud.md`. Twin of
176
+ // `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL secret
177
+ // values resolved from `.envrc`, never enters ws.writes / canonicalHashes / `bkit check`
178
+ // drift. Skipped on dry-run (`bkit check`), which never writes secrets. Upgrade
179
+ // regenerates it via the same helper (see runUpgrade caller).
180
+ if (!dryRun && writeCodexCloudDoc(process.cwd(), ctx.tokens)) {
181
+ console.log(`${logPrefix} ${tag}codex: .codex/bkit-cloud.md (generated — gitignored, holds resolved secrets)`);
182
+ }
173
183
  advisories.push({
174
184
  id: "codex-setup",
175
185
  severity: "advisory",