@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
@@ -50,6 +50,9 @@ docs/plans/*/logs/**/.rebase-failed
50
50
  # Cursor background-agent runtime marker
51
51
  .bkit/.runtime-cursor
52
52
 
53
+ # Provision recipes that failed in this cloud environment (`bkit context provision`)
54
+ .bkit/.unavailable
55
+
53
56
  .bkit/.roadmap-shortlist.json
54
57
  .bkit/.roadmap-reverse-sync.json
55
58
 
@@ -57,12 +60,13 @@ docs/plans/*/logs/**/.rebase-failed
57
60
  .claude/scheduled_tasks.lock
58
61
 
59
62
  # Cloud setup docs — `bkit install` inlines resolved .envrc secrets; never commit.
60
- # One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor Background Agents)
63
+ # One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor Cloud Agents), .codex/bkit-cloud.md (Codex Cloud)
61
64
  .claude/bkit-cloud.md
62
65
  .cursor/bkit-cloud.md
66
+ .codex/bkit-cloud.md
63
67
 
64
68
  # Claude native worktrees (isolation:worktree / EnterWorktree) — transient full-tree
65
- # copies; ignore or slop:delta double-counts the checkout
69
+ # copies; ignore or bkit:slop:delta double-counts the checkout
66
70
  .claude/worktrees/
67
71
 
68
72
  # cursor / opencode — no project-local worktree or runtime dir to ignore.
@@ -128,28 +128,27 @@ fi
128
128
  # bkit runs whatever `context-fetch:provision` recipe each block carries (self-guarded with
129
129
  # `command -v <cli> || <install>`), so no stack name is baked into bkit. Runs every session
130
130
  # (a no-op once the CLI is present); the web setup script bakes the same recipes into its
131
- # snapshot, so this is the gh-runner + resumed-session path. `bkit context list-blocks`
132
- # returns each block's bash body below `bkit:end` as `provision`; bkit (installed by the
133
- # `pnpm install` above) lists them and jq (installed by the cloud setup script) reads the
134
- # JSON. See .agents/context.md.
131
+ # snapshot, so this is the gh-runner + resumed-session path. `bkit context provision`
132
+ # (installed by the `pnpm install` above) runs the same region the setup scripts inline:
133
+ # each recipe on its own, a failure named with its last error line, and the failures listed
134
+ # in .bkit/.unavailable. See .agents/context.md.
135
135
  if [ -f .agents/context.md ]; then
136
136
  BKIT="$REPO_ROOT/node_modules/.bin/bkit"
137
- if [ ! -x "$BKIT" ] || ! command -v jq >/dev/null 2>&1; then
138
- log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit) or jq is missing. Fix: a working 'pnpm install' and the cloud setup script from .claude/bkit-cloud.md."
137
+ if [ ! -x "$BKIT" ]; then
138
+ log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit) is missing. Fix: a working 'pnpm install'."
139
139
  else
140
- PROVISION=$("$BKIT" context list-blocks --json 2>/dev/null | jq -r '.provision[]' 2>/dev/null || true)
141
- if [ -n "$PROVISION" ]; then
142
- log "provisioning context-fetch CLIs from .agents/context.md"
143
- # pnpm refuses `add -g` unless its global-bin dir is on PATH (corepack pnpm skips
144
- # `pnpm setup`); export it so `pnpm add -g` provision recipes don't self-skip. Mirrors
145
- # the web setup script's provision region, which bkit's install engine renders.
146
- export PNPM_HOME="${PNPM_HOME:-$HOME/.local/share/pnpm}"
147
- export PATH="$PNPM_HOME:$PNPM_HOME/bin:$PATH"
148
- printf '%s\n' "$PROVISION" | bash || log "context-fetch CLI provisioning failed (non-blocking)"
149
- fi
140
+ log "provisioning from .agents/context.md (bkit context provision)"
141
+ "$BKIT" context provision >/dev/null || log "bkit context provision did not run (non-blocking)"
150
142
  fi
151
143
  fi
152
144
 
145
+ # SessionStart stdout is added to the session's context: tell the agent what setup could
146
+ # not provide, so it treats those as absent instead of retrying their install.
147
+ if [ -s .bkit/.unavailable ]; then
148
+ printf 'Cloud setup could not provide these in this session (setup failed; treat them as absent, do not retry the install):\n'
149
+ cat .bkit/.unavailable
150
+ fi
151
+
153
152
  # --- Per-repo install steps -------------------------------------------------
154
153
  # Add your own steps here. Examples:
155
154
  #
@@ -18,13 +18,17 @@ FROM ubuntu:26.04@sha256:2260313b31c8c011cd2eebe728008efac1b3982be73eb71348ea264
18
18
  # --- Consumer-owned: base system + Node ------------------------------------
19
19
  # bkit's toolchain assumes curl, ca-certificates, and Node >=24 are on PATH
20
20
  # before the bkit toolchain section runs. Pin Node to match your repo's `engines.node`.
21
+ # apt packages here and below carry no version: they track the pinned base release,
22
+ # security updates included. `pkg=<version>` pins break rebuilds once Ubuntu drops
23
+ # the superseded version from its mirrors; tools whose version matters are pinned
24
+ # and checksum-checked outside apt.
21
25
  RUN apt-get update && apt-get install -y --no-install-recommends \
22
26
  curl ca-certificates xz-utils \
23
27
  && rm -rf /var/lib/apt/lists/*
24
28
  # Node — nodejs.org tarball checked against SHASUMS256.txt (linux-x64).
25
29
  # renovate: datasource=node-version depName=node
26
- ARG NODE_VERSION=24.21.0
27
- ARG NODE_SHA256=fd8e59d5a511510f6a298afb548f18c7d2b1be404d8b4a27d94fbe49f56cb2d6
30
+ ARG NODE_VERSION=24.22.1
31
+ ARG NODE_SHA256=6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6
28
32
  RUN cd /tmp \
29
33
  && curl -fsSLO --retry 3 --retry-all-errors "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz" \
30
34
  && echo "${NODE_SHA256} node-v${NODE_VERSION}-linux-x64.tar.xz" | sha256sum -c - \
@@ -43,18 +47,18 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
43
47
 
44
48
  # gh CLI — git push, PR ops, CI cache lookup. Release tarball checked against the release's checksums.txt.
45
49
  # renovate: datasource=github-releases depName=cli/cli
46
- ARG GH_VERSION=2.102.0
47
- ARG GH_SHA256=bb766f710eef8ede859c18578c72c327597cd4c8a85b06001b1f3843c6019386
50
+ ARG GH_VERSION=2.103.0
51
+ ARG GH_SHA256=fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786
48
52
  RUN cd /tmp \
49
53
  && curl -fsSLO --retry 3 --retry-all-errors "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.tar.gz" \
50
54
  && echo "${GH_SHA256} gh_${GH_VERSION}_linux_amd64.tar.gz" | sha256sum -c - \
51
55
  && tar -xzf "gh_${GH_VERSION}_linux_amd64.tar.gz" -C /usr/local/bin --strip-components=2 "gh_${GH_VERSION}_linux_amd64/bin/gh" \
52
56
  && rm -f "gh_${GH_VERSION}_linux_amd64.tar.gz"
53
57
 
54
- # vale — `pnpm lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
58
+ # vale — `pnpm bkit:lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
55
59
  # renovate: datasource=github-releases depName=errata-ai/vale
56
- ARG VALE_VERSION=3.9.1
57
- ARG VALE_SHA256=fbc2eb47d0b8c50220ed1a2c5c611fbe0904ed567d638143d482016a18fd2db0
60
+ ARG VALE_VERSION=3.24.0
61
+ ARG VALE_SHA256=867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214
58
62
  RUN cd /tmp \
59
63
  && curl -fsSLO --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" \
60
64
  && echo "${VALE_SHA256} vale_${VALE_VERSION}_Linux_64-bit.tar.gz" | sha256sum -c - \
@@ -64,7 +68,7 @@ RUN cd /tmp \
64
68
 
65
69
  # pnpm — corepack-pinned to match `packageManager` in package.json.
66
70
  # renovate: datasource=npm depName=pnpm
67
- ARG PNPM_VERSION=10.34.6
71
+ ARG PNPM_VERSION=10.34.7
68
72
  RUN corepack enable && corepack prepare "pnpm@${PNPM_VERSION}" --activate
69
73
 
70
74
  # --- Consumer extensions ---------------------------------------------------
@@ -2,5 +2,5 @@
2
2
  "build": {
3
3
  "dockerfile": "Dockerfile"
4
4
  },
5
- "install": "pnpm install --frozen-lockfile && ([ ! -f .vale.ini ] || vale sync)"
5
+ "install": "pnpm install --frozen-lockfile && ([ ! -f .vale.ini ] || vale sync) && pnpm exec bkit context provision"
6
6
  }
@@ -9,10 +9,12 @@ body:
9
9
  attributes:
10
10
  value: |
11
11
  Next step:
12
- - A test or CI run already fails → `/bkit-debug #<issue number>`, on the branch the fix should land on (debug commits to the branch it runs on).
13
- - Nothing fails yet → `/bkit-debug #<issue number> [repro]`: writes a test that fails the way this report describes, then fixes the code until it passes; no test fails → stops and says so.
12
+ - **If** a test or CI run already fails → run `/bkit-debug #<issue number>` on the branch the fix should land on. Debug commits to the branch it runs on.
13
+ - **If** nothing fails yet → run `/bkit-debug #<issue number> [repro]`. It writes a test that fails the way this report describes, then fixes the code until the test passes. **If** no test fails → it stops and says so.
14
14
 
15
- Intermittent? Add `[soak]`; with `[repro]`, the test repeats the scenario until it fails.
15
+ **If** the bug is intermittent → add `[soak]`. Debug then works one step per attempt, either adding logging or trying one fix, instead of one diagnosis and one fix:
16
+ - With `[repro]` → the test it writes repeats the scenario until it fails.
17
+ - Without `[repro]` → soak starts only from a test or CI run that already fails. **If** every test passes → the run writes its summary and changes no code.
16
18
  - type: textarea
17
19
  id: failing
18
20
  attributes:
@@ -37,7 +39,7 @@ body:
37
39
  id: steps
38
40
  attributes:
39
41
  label: Steps to reproduce
40
- description: Numbered, from a clean start.
42
+ description: Numbered steps from a clean start.
41
43
  placeholder: |
42
44
  1.
43
45
  2.
@@ -56,22 +58,22 @@ body:
56
58
  id: area
57
59
  attributes:
58
60
  label: Affected area
59
- description: The route, command, file or module that misbehaves. Files named here are treated as what to fix; files only seen in a stack trace are not.
61
+ description: The route, command, file or module that misbehaves. Files named here are treated as what to fix. Files seen only in a stack trace are not.
60
62
  - type: textarea
61
63
  id: where
62
64
  attributes:
63
65
  label: Where and when
64
- description: Environment (for example production or preview), version or commit, first and last seen in UTC, and the last version that worked.
66
+ description: The environment (for example production or preview), the version or commit, when it was first and last seen in UTC, and the last version that worked.
65
67
  - type: textarea
66
68
  id: evidence
67
69
  attributes:
68
70
  label: Evidence
69
- description: Logs, error-tracker IDs or links, screenshots.
71
+ description: Logs, error-tracker IDs or links, and screenshots.
70
72
  - type: textarea
71
73
  id: references
72
74
  attributes:
73
75
  label: References
74
- description: Related issues with their title, the feature that introduced it, ledger rows by `key`. Nothing fetches these, so write exact keys and numbers agents can search for.
76
+ description: Related issues with their titles, the feature that introduced the bug, and ledger rows by `key`. Nothing fetches these, so write exact keys and numbers that agents can search for.
75
77
  placeholder: |
76
78
  Related: #<number> — <its title>
77
79
  Introduced by: 41-csv-import
@@ -8,24 +8,23 @@ body:
8
8
  - type: markdown
9
9
  attributes:
10
10
  value: |
11
- Write this as the plan: a build with no plan converts this issue into one.
12
- - `/bkit-plan #<issue number>` turns it into a checked plan; the build then proves each **TEST FIRST** test fails before its code exists.
13
- - `/bkit-build #<issue number>` converts this issue into a plan, then builds it and proves each **TEST FIRST** test fails before its code exists.
14
- - `build:lite` builds from this issue too but checks nothing: no failing-test proof, gates, PR or CI.
11
+ Write this issue as the plan. A build with no plan converts this issue into one.
12
+ - `/bkit-plan #<issue number>` turns this issue into a checked plan. The build then proves each **TEST FIRST** test fails before its code exists.
13
+ - `/bkit-build #<issue number>` converts this issue into a plan, then builds it. It proves each **TEST FIRST** test fails before its code exists.
15
14
 
16
- Keep the title short: it names the feature folder. Nothing ticks boxes in an issue.
15
+ Keep the title short, because it names the feature folder. Nothing ticks boxes in an issue.
17
16
  - type: textarea
18
17
  id: narrative
19
18
  attributes:
20
19
  label: Narrative
21
- description: One or two sentences from the user's side. What they do and what they get back.
20
+ description: One or two sentences from the user's side, saying what they do and what they get back.
22
21
  validations:
23
22
  required: true
24
23
  - type: textarea
25
24
  id: success-criteria
26
25
  attributes:
27
26
  label: Success Criteria
28
- description: Up to five outcomes you can observe that prove it works. Outcomes, not steps.
27
+ description: Up to five outcomes you can observe that prove it works. List outcomes, not steps.
29
28
  placeholder: |
30
29
  - A user who saves an item sees it in the list within 2s
31
30
  validations:
@@ -44,7 +43,7 @@ body:
44
43
  attributes:
45
44
  label: Derived Test Matrix
46
45
  description: |
47
- One row per behaviour above, each covered by exactly one task. Type = the lowest tier that really exercises it, named as in `docs/testing.md`: Unit, Integration, E2E, @live (golden) or fresh-DB replay. The test must fail when the behaviour breaks.
46
+ One row per behaviour above, each covered by exactly one task. The type is the lowest tier that really exercises the behaviour, named as in `docs/testing.md`: Unit, Integration, E2E, @live (golden) or fresh-DB replay. The test must fail when the behaviour breaks.
48
47
  placeholder: |
49
48
  | Test description | Type | Target file |
50
49
  | --- | --- | --- |
@@ -56,10 +55,23 @@ body:
56
55
  attributes:
57
56
  label: Tasks
58
57
  description: |
59
- In build order, preferably in this shape, the same group and task blocks a plan uses: groups of up to `bkit.workflows.tasks.maxPerGroup` tasks (default 3) and `bkit.workflows.tasks.maxTestsPerGroup` **TEST FIRST** tests (default 15), each task a block, task numbers unique across the issue. **CREATE** / **READ** / **UPDATE** / **DELETE** = one line per file the task touches, as `` `symbol` in `file`: what to do `` or `` `file`: what to do ``. **DEPENDS ON** = the numbers of tasks it builds on, in the same or an earlier group. **DONE WHEN** = a check you can verify in the code (file exists, test passes, behaviour observable). **TEST FIRST** = the matrix tests that fail before the code exists, 1 to `bkit.workflows.tasks.maxTestsPerTask` per task (default 10) across up to `bkit.workflows.tasks.maxTestFilesPerTask` test files (default 3), one line each as `` `test file` `test name` fails on what goes wrong ``; or `n/a — reason` for docs, config, a pure refactor, or E2E / @live only. **TEST EXCEPTION** = written only by the owner: tests whose test-order gap you accept, each as in **TEST FIRST** ending `— reason`; it counts once committed alone in the plan. A **TEST EXCEPTION** written here is a request: the build copies it word for word, stops on it, and the owner confirms it at the build's Decision Pause, where Accept rewrites it with the owner's reason and date. Free text works too: the build converts it. A plan file for this issue wins: once one exists, the build reads its tasks only from the plan, never from here.
58
+ List the tasks in build order. The preferred shape is the same group and task blocks a plan uses:
59
+ - Each group holds up to `bkit.workflows.tasks.maxPerGroup` tasks (default 5) and `bkit.workflows.tasks.maxTestsPerGroup` **TEST FIRST** tests (default 25).
60
+ - Each task is a block. Task numbers are unique across the issue.
61
+ - **CREATE** / **READ** / **UPDATE** / **DELETE**: one line per file the task touches, as `` `symbol` in `file`: what to do `` or `` `file`: what to do ``.
62
+ - **DEPENDS ON**: the numbers of the tasks it builds on, in the same group or an earlier one.
63
+ - **DONE WHEN**: a check you can verify in the code. For example, a file exists, a test passes, or a behaviour is observable.
64
+ - **TEST FIRST**: the matrix tests that fail before the code exists. A task has 1 to `bkit.workflows.tasks.maxTestsPerTask` tests (default 10), across up to `bkit.workflows.tasks.maxTestFilesPerTask` test files (default 3). Write one line each, as `` `test file` `test name` fails on what goes wrong ``.
65
+ - **If** the task is docs, config, a pure refactor, or covered by E2E / @live only → write `n/a — reason` under **TEST FIRST**.
66
+ - **TEST EXCEPTION**: written only by the owner. It lists the tests you accept without a proven red, each written as in **TEST FIRST** and ending `— reason`. It counts once it is committed alone in the plan.
67
+ - A **TEST EXCEPTION** written here is a request. The build copies it word for word and does not honour it until the owner confirms it at the build's Decision Pause, where Accept rewrites it with the owner's reason and date.
68
+
69
+ Free text works too. The build converts it.
70
+
71
+ A plan file for this issue wins. Once one exists, the build reads its tasks only from the plan, never from here.
60
72
  placeholder: |
61
73
  <!-- bkit:group 1 start -->
62
- ### GROUP 1: Saving items
74
+ ### TASK GROUP 1: Saving items
63
75
  <!-- bkit:task 1 start -->
64
76
  - [ ] **TASK 1:** Refuse an empty item name
65
77
  - **UPDATE:** `saveItem` in `path/to/items`: refuse an empty name
@@ -86,7 +98,7 @@ body:
86
98
  id: open-questions
87
99
  attributes:
88
100
  label: Open Questions & Assumptions
89
- description: Each with its options, your recommendation, and the default if nobody answers.
101
+ description: List each one with its options, your recommendation, and the default if nobody answers.
90
102
  - type: textarea
91
103
  id: breaking-changes
92
104
  attributes:
@@ -102,7 +114,7 @@ body:
102
114
  attributes:
103
115
  label: References
104
116
  description: |
105
- The plan reads `**Parent design:**` and `**Audit reports:**` lines; the build refuses to start while an issue in the blocked-by block is open. Write them exactly as shown. Other references are not fetched, so use exact paths, ledger `key`s and issue numbers with titles.
117
+ The plan reads the `**Parent design:**` and `**Audit reports:**` lines. The build refuses to start while an issue in the blocked-by block is open. Write these lines and the blocked-by block exactly as shown. Nothing fetches the other references, so use exact paths, ledger `key`s, and issue numbers with their titles.
106
118
  placeholder: |
107
119
  **Parent design:** [42-offline-sync-design.md](https://github.com/<owner>/<repo>/blob/dev/docs/plans/202610/42-offline-sync-design.md)
108
120
  **Audit reports:** docs/audits/202610/security.md (findings security-3, security-5)
@@ -8,7 +8,7 @@ body:
8
8
  - type: markdown
9
9
  attributes:
10
10
  value: |
11
- Next step: `/bkit-design #<issue number>`. Design asks only what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short: it names the feature folder and is not read as input.
11
+ Next step: `/bkit-design #<issue number>`. Design asks only about what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short. It names the feature folder, and it is not read as input.
12
12
  - type: textarea
13
13
  id: problem
14
14
  attributes:
@@ -27,7 +27,7 @@ body:
27
27
  id: success-criteria
28
28
  attributes:
29
29
  label: Success criteria
30
- description: Up to five outcomes you could measure. Outcomes, not steps.
30
+ description: Up to five outcomes you could measure. List outcomes, not steps.
31
31
  placeholder: |
32
32
  - A user who saves an item sees it in the list within 2s
33
33
  - type: textarea
@@ -49,7 +49,7 @@ body:
49
49
  id: references
50
50
  attributes:
51
51
  label: References
52
- description: Related issues with their title, earlier attempts, docs paths, ledger rows by `key`. Nothing fetches these, so write exact paths and keys agents can search for.
52
+ description: Related issues with their titles, earlier attempts, docs paths, and ledger rows by `key`. Nothing fetches these, so write exact paths and keys that agents can search for.
53
53
  placeholder: |
54
54
  Related: #<number> — <its title>
55
55
  Docs: docs/architecture.md § Sync
@@ -35,12 +35,17 @@
35
35
  // `dev`'s config over `main`'s for dev-targeted runs, so config edits on `dev`
36
36
  // apply to them. This option is itself read from `main`, so it needs one merge
37
37
  // to `main` before dev-side config edits apply.
38
+ // The merge appends list options (`customManagers`, `packageRules`) instead of
39
+ // replacing them: each custom manager runs twice, so the dashboard lists its
40
+ // files twice and the run logs "Cannot find replaceString" for the second pass.
41
+ // PRs still open once. A rule deleted on `dev` keeps applying until `main` drops it.
38
42
  // See docs/deployments.md § Dependency updaters.
39
43
  useBaseBranchConfig: "merge",
40
44
 
41
- // Weekly batched runs. CVE-driven updates are not held to this schedule
42
- // (`osvVulnerabilityAlerts` below).
43
- schedule: ["before 6am on Monday"],
45
+ // Weekly batched runs: every hour of Monday (UTC). The daily bkit-renovate.yml cron
46
+ // can start hours after its set time, so a window of a few hours would miss it.
47
+ // CVE-driven updates are not held to this schedule (`osvVulnerabilityAlerts` below).
48
+ schedule: ["* * * * 1"],
44
49
  timezone: "UTC",
45
50
 
46
51
  // CVE alerts → Renovate opens a PR immediately, outside the weekly schedule.
@@ -71,10 +76,11 @@
71
76
 
72
77
  // Lockfile maintenance — picks up indirect-dependency updates that a
73
78
  // direct-dependency bump alone wouldn't catch. Monthly: it rewrites the whole
74
- // lockfile, so a weekly PR is mostly churn.
79
+ // lockfile, so a weekly PR is mostly churn. Every hour of the 1st (UTC), for the
80
+ // same late-start reason as `schedule` above.
75
81
  lockFileMaintenance: {
76
82
  enabled: true,
77
- schedule: ["before 6am on the first day of the month"],
83
+ schedule: ["* * 1 * *"],
78
84
  },
79
85
 
80
86
  // Rebase a Renovate PR only when it conflicts. The default re-bases every open PR
@@ -123,7 +129,8 @@
123
129
  // bash "$RUNNER_TEMP/download-actionlint.bash" 1.7.12 (installer-script version argument)
124
130
  // Pins paired with a checksum (Vale, gh, jq, Node, actionlint) get the new VERSION
125
131
  // from Renovate, but the sha256 beside it stays old: update it by hand in the same
126
- // PR, or the install fails closed. See the NOTE in the docker images rule below.
132
+ // PR, or the install fails closed. CI's Check Pinned Checksums step (`bkit ci pins`)
133
+ // fails the PR until it matches. See the NOTE in the docker images rule below.
127
134
  // ─────────────────────────────────────────────────────────────────────
128
135
  customManagers: [
129
136
  {
@@ -294,6 +301,27 @@
294
301
  groupName: "docker images",
295
302
  automerge: false,
296
303
  },
304
+
305
+ // ─────────────────────────────────────────────────────────────────────
306
+ // Pins the `customManagers` entry finds (Dockerfile, bkit-cloud.md, workflows,
307
+ // scripts) land in ONE reviewed PR, so their hand-edited checksums are fixed
308
+ // once. The Dockerfile pnpm pin instead joins the non-major group, so it moves
309
+ // in the same PR as `packageManager` in package.json.
310
+ // ─────────────────────────────────────────────────────────────────────
311
+ {
312
+ matchManagers: ["custom.regex"],
313
+ groupName: "pinned tools",
314
+ automerge: false,
315
+ },
316
+ {
317
+ matchManagers: ["custom.regex"],
318
+ matchDepNames: ["pnpm"],
319
+ matchUpdateTypes: ["minor", "patch"],
320
+ groupName: "non-major dependencies",
321
+ automerge: true,
322
+ automergeType: "pr",
323
+ platformAutomerge: true,
324
+ },
297
325
  ],
298
326
 
299
327
  // Where to send PRs. `dev` per baseBranchPatterns above.
@@ -58,7 +58,7 @@ jobs:
58
58
  steps:
59
59
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
60
60
  with:
61
- # Full history so slop:delta can materialise the PR base ref as a worktree.
61
+ # Full history so bkit:slop:delta can materialise the PR base ref as a worktree.
62
62
  fetch-depth: 0
63
63
 
64
64
  # Node/TS toolchain region. On a non-Node repo, replace these steps with your
@@ -191,15 +191,15 @@ jobs:
191
191
  run: pnpm format:check
192
192
 
193
193
  # vale is not on the runner and .vale/styles/ is gitignored, so without this step
194
- # `pnpm lint:prose` guard-skips (write-good missing) and the prose gate is silently
194
+ # `pnpm bkit:lint:prose` guard-skips (write-good missing) and the prose gate is silently
195
195
  # dead. Pinned tarball + `vale sync` (else E100: write-good missing).
196
196
  - name: Install Vale
197
197
  env:
198
198
  # renovate: datasource=github-releases depName=errata-ai/vale
199
- VALE_VERSION: "3.9.1"
199
+ VALE_VERSION: "3.24.0"
200
200
  # sha256 of vale_${VALE_VERSION}_Linux_64-bit.tar.gz (from the release's checksums.txt).
201
201
  # Bump alongside VALE_VERSION; verified before extract so a tampered/CDN-swapped tarball fails closed.
202
- VALE_SHA256: "fbc2eb47d0b8c50220ed1a2c5c611fbe0904ed567d638143d482016a18fd2db0"
202
+ VALE_SHA256: "867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
203
203
  run: |
204
204
  curl -fsSL --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o "$RUNNER_TEMP/vale.tar.gz"
205
205
  echo "${VALE_SHA256} $RUNNER_TEMP/vale.tar.gz" | sha256sum -c -
@@ -213,7 +213,7 @@ jobs:
213
213
  done
214
214
 
215
215
  - name: Run Vale Prose Lint
216
- run: pnpm lint:prose
216
+ run: pnpm bkit:lint:prose
217
217
 
218
218
  - name: Run Slop Scan
219
219
  run: pnpm lint:slop
@@ -225,7 +225,7 @@ jobs:
225
225
  if: github.event_name == 'pull_request'
226
226
  env:
227
227
  BASE_SHA: ${{ github.event.pull_request.base.sha }}
228
- run: pnpm slop:delta "$BASE_SHA"
228
+ run: pnpm bkit:slop:delta "$BASE_SHA"
229
229
 
230
230
  # actionlint validates .github/workflows/* with GitHub-Actions-aware rules
231
231
  # (${{ }} expression syntax, shellcheck on run: blocks). A YAML linter accepts
@@ -247,36 +247,55 @@ jobs:
247
247
  - name: Run bkit Check
248
248
  run: pnpm bkit check
249
249
 
250
+ # Version + sha256 pins: Renovate bumps a *_VERSION and leaves its *_SHA256, so the
251
+ # break shows only when the image is rebuilt. This downloads each pinned tool and fails
252
+ # the PR naming the tool whose hash differs. deployments.md § Dependency updaters.
253
+ # Self-skips when the repo has no .cursor/Dockerfile.
254
+ - name: Check Pinned Checksums
255
+ if: hashFiles('.cursor/Dockerfile') != ''
256
+ run: pnpm bkit ci pins --file=.cursor/Dockerfile
257
+
250
258
  # Dependency-audit gate: fails on a high or critical advisory in the lockfile that
251
- # scripts/ci/accepted-advisories.json does not accept with a reason and an in-date expiry.
259
+ # scripts/ci/bkit-accepted-advisories.json does not accept with a reason and an in-date expiry.
252
260
  # Self-skips when the guard is absent — a repo that did not adopt
253
- # scripts/ci/check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
261
+ # scripts/ci/bkit-check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
254
262
  - name: Check Dependency Audit
255
- if: hashFiles('scripts/ci/check-dependency-audit.mjs') != ''
256
- run: node scripts/ci/check-dependency-audit.mjs
263
+ if: hashFiles('scripts/ci/bkit-check-dependency-audit.mjs') != ''
264
+ run: node scripts/ci/bkit-check-dependency-audit.mjs
257
265
 
258
266
  # Capability-register freshness gate: rebuild the graph with graphify and fail when
259
267
  # docs/capabilities.md is not what this tree produces, so the register cannot drift
260
268
  # silently. Self-skips when the graphify wrapper is absent — a repo that did not adopt
261
269
  # scripts/graphify/ is a no-op. graphify is pinned because its output must match the
262
270
  # committed register to the byte: bump GRAPHIFY_SPEC (bkit-graphify.sh) and refresh the register together.
263
- # Push events only — a pull_request checkout is the MERGE ref, whose tree (base + head)
264
- # can differ from the head the register was built against: a false red no author can clear.
271
+ # Every event, PRs included, judging the tree that lands. A pull_request checkout is
272
+ # GitHub's test merge of the PR into its base: the tree a squash merge puts on the base,
273
+ # so its verdict is the post-merge push run's verdict. A PR behind its base can red here
274
+ # with a clean head, when two branches' registers merge line by line into a file no
275
+ # rebuild produces; merging the base into the branch, `pnpm bkit:graph:refresh` and a commit
276
+ # clear it. `check-at HEAD` rebuilds in a throwaway worktree of the checked-out commit —
277
+ # the same primitive the pre-push gate runs — so the release installed, the script run
278
+ # and the register judged all come from that one tree.
265
279
  - name: Setup uv
266
- if: github.event_name == 'push' && hashFiles('scripts/graphify/bkit-graphify.sh') != ''
267
- uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
280
+ if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
281
+ uses: astral-sh/setup-uv@18d369b23da25a81e9458561248e1aafff6a70fa # v10.3.1
268
282
  with:
269
- version: "0.13.0"
283
+ version: "0.13.4"
270
284
 
271
285
  - name: Check Capability Register
272
- if: github.event_name == 'push' && hashFiles('scripts/graphify/bkit-graphify.sh') != ''
286
+ if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
273
287
  # graphify release pinned once: GRAPHIFY_SPEC in bkit-graphify.sh. Same release here,
274
288
  # in the pre-push gate and by hand.
275
289
  run: |
276
290
  uv tool install "$(bash scripts/graphify/bkit-graphify.sh spec)"
277
291
  # `uv tool install` drops the shim in ~/.local/bin, not on this step's PATH.
278
292
  export PATH="$HOME/.local/bin:$PATH"
279
- pnpm graph:check
293
+ if ! bash scripts/graphify/bkit-graphify.sh check-at HEAD; then
294
+ if [ "$GITHUB_EVENT_NAME" = pull_request ]; then
295
+ echo "::error title=Capability register::Checked this PR merged into $GITHUB_BASE_REF. If the branch is behind $GITHUB_BASE_REF, merge $GITHUB_BASE_REF into it first, then pnpm bkit:graph:refresh, commit and push."
296
+ fi
297
+ exit 1
298
+ fi
280
299
 
281
300
  # ── bkit-tests-unit ───────────────────────────────────────────────────────
282
301
  # Unit lane. Parallel sibling of bkit-tests-static. Integration, E2E, deploy-await,
@@ -472,7 +491,7 @@ jobs:
472
491
  # # the floor as its target, to the job summary; comments on same-repo PRs only. No floor yet → drop
473
492
  # # vite-config-path (a missing file only warns, on every run).
474
493
  # if: ${{ !cancelled() && hashFiles('coverage/unit/coverage-summary.json') != '' }}
475
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
494
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
476
495
  # with:
477
496
  # name: unit
478
497
  # json-summary-path: coverage/unit/coverage-summary.json
@@ -484,7 +503,7 @@ jobs:
484
503
  # - name: Report Integration Coverage on PR
485
504
  # # hashFiles guard: skip cleanly when the repo has no integration tier (no coverage/integration report produced).
486
505
  # if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/integration/coverage-summary.json') != ''
487
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
506
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
488
507
  # with:
489
508
  # name: integration
490
509
  # json-summary-path: coverage/integration/coverage-summary.json
@@ -576,7 +595,7 @@ jobs:
576
595
  # - name: Report E2E Coverage on PR
577
596
  # # Same gate as Run E2E Tests (coverage exists only if E2E ran); hashFiles skips repos that produced no E2E report.
578
597
  # if: (steps.detect.outputs.should_run_full == 'true' || steps.e2e-paths.outputs.needs_e2e == 'true') && github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/e2e/coverage-summary.json') != ''
579
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
598
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
580
599
  # with:
581
600
  # name: e2e
582
601
  # json-summary-path: coverage/e2e/coverage-summary.json
@@ -610,7 +629,7 @@ jobs:
610
629
  # always(): a concurrency cancel must not stamp a failure. Each lane must succeed; a failed,
611
630
  # skipped or cancelled lane reds it. A lane that writes an executed-test count must have run
612
631
  # more than 0 tests. Each lane you adopt from the reference below joins needs: and the assert.
613
- # The assert is scripts/ci/check-capstone.mjs, required with this file (copy it from
632
+ # The assert is scripts/ci/bkit-check-capstone.mjs, required with this file (copy it from
614
633
  # .bkit/templates/scripts/ci/); the step reds when the script is missing.
615
634
  bkit-tests-check:
616
635
  needs: [bkit-tests-static, bkit-tests-unit]
@@ -624,8 +643,8 @@ jobs:
624
643
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
625
644
 
626
645
  - name: Assert Lanes Passed
627
- # The verdict is scripts/ci/check-capstone.mjs (copy it with this file from
628
- # .bkit/templates/scripts/ci/; check-capstone.test.mjs tests it). Every lane in LANES
646
+ # The verdict is scripts/ci/bkit-check-capstone.mjs (copy it with this file from
647
+ # .bkit/templates/scripts/ci/; bkit-check-capstone.test.mjs tests it). Every lane in LANES
629
648
  # must succeed; a lane with a *_RAN variable must have run more than 0 tests.
630
649
  # EMPTY_COUNT=warn: a lane that writes no count yet warns instead of failing; delete it
631
650
  # once every counted lane writes one. Add each lane you adopt to LANES and to its
@@ -637,26 +656,11 @@ jobs:
637
656
  UNIT_RESULT: ${{ needs.bkit-tests-unit.result }}
638
657
  UNIT_RAN: ${{ needs.bkit-tests-unit.outputs.tests_ran }}
639
658
  run: |
640
- if [ ! -f scripts/ci/check-capstone.mjs ]; then
641
- echo "::error::scripts/ci/check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
659
+ if [ ! -f scripts/ci/bkit-check-capstone.mjs ]; then
660
+ echo "::error::scripts/ci/bkit-check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
642
661
  exit 1
643
662
  fi
644
- node scripts/ci/check-capstone.mjs
645
-
646
- # bkit-stub:smoke — Post-CI smoke triggered by workflow_run on {{DEFAULT_BRANCH}}. To enable: copy the YAML below into .github/workflows/smoke.yml (separate file — workflow_run cannot share a file with push/pull_request) and delete this stub header.
647
- # name: Smoke
648
- # on:
649
- # workflow_run:
650
- # workflows: ["CI"]
651
- # types: [completed]
652
- # branches: [{{DEFAULT_BRANCH}}]
653
- # jobs:
654
- # smoke:
655
- # if: github.event.workflow_run.conclusion == 'success'
656
- # runs-on: ubuntu-latest
657
- # steps:
658
- # - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
659
- # - run: ./scripts/ci/smoke-test.sh
663
+ node scripts/ci/bkit-check-capstone.mjs
660
664
 
661
665
  # =============================================================================
662
666
  # FULL CI SCAFFOLD REFERENCE — job graph, needs, if, step names. This is the target.
@@ -737,7 +741,7 @@ jobs:
737
741
  # # package.json, which pins turbo EXACTLY — never typed here, or this lane drifts from every
738
742
  # # install-bearing lane: npm i -g "turbo@$(node -p "require('./package.json').devDependencies.turbo")"
739
743
  # - name: Resolve Base Ref # [M] push base = the branch's last green run; shipped:
740
- # # scripts/ci/lanes/resolve-push-base.mjs (falls back to github.event.before). deployments.md
744
+ # # scripts/ci/lanes/bkit-resolve-push-base.mjs (falls back to github.event.before). deployments.md
741
745
  # # § One run per branch or pull request.
742
746
  # bkit-stub:affected-graph — [M] turbo changed-packages. Stdout ≠ stderr. deployments.md § turbo `//`.
743
747
  # - name: Detect Affected Packages # [M] sets web_affected / global_dep_changed
@@ -791,13 +795,13 @@ jobs:
791
795
  # - name: Run Lint # [U] static checks FAIL-FAST before env pull; PRs scope --filter=...[origin/<base>]
792
796
  # - name: Run Typecheck # [U]
793
797
  # - name: Run Prettier # [U] CI-side format gate (hook-bypass net)
794
- # - name: Run Vale Prose Lint # [U] same root lint:prose pre-push runs (local==CI)
798
+ # - name: Run Vale Prose Lint # [U] same root bkit:lint:prose pre-push runs (local==CI)
795
799
  # - name: Run Slop Scan (full) # [U] advisory baseline
796
800
  # - name: Run Slop Scan (delta) # every event, against the planner base. deployments.md § One run.
797
801
  # - name: Tear Down Base Worktree # if: always()
798
802
  # - name: Run bkit Check # [U] drift gate (same as pre-push); catches --no-verify/web-edit/cloud drift
799
- # - name: Check Accepted Divergences # [U] node scripts/ci/check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
800
- # - name: Check Dependency Audit # [U] node scripts/ci/check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
803
+ # - name: Check Accepted Divergences # [U] node scripts/ci/bkit-check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
804
+ # - name: Check Dependency Audit # [U] node scripts/ci/bkit-check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
801
805
  # - name: Pull Vercel Env Vars # [D] preview vs prod env by branch; set CI_ENV_FILE; FAIL-FAST if critical secrets empty
802
806
  # - name: Assert Environment Shape # [D] env-shape checker (e.g. env-check.sh)
803
807
  # # Resolve URL and remote db push are NOT steps in this catalogue.
@@ -1008,11 +1012,10 @@ jobs:
1008
1012
  # setting (e.g. Vercel Deployment Checks) stays empty — this job is the promotion.
1009
1013
  #
1010
1014
  # === JOB 6 — health (separate workflow) ===
1011
- # bkit-stub:health — copy into .github/workflows/health.yml. workflow_run cannot share a file with
1012
- # push / pull_request. WHEN: you have a live URL to smoke after CI. Trigger on CI completed, default
1013
- # branch only, if the CI run succeeded. Then hit the health URL of the deployment this SHA promoted.
1014
- # e.g. poll the host until that deployment is ready, then GET /health. Not a required check.
1015
- # DROP if you have no deployed health URL.
1015
+ # bkit-stub:health — copy .bkit/templates/.github/workflows/bkit-health.yml to
1016
+ # .github/workflows/bkit-health.yml. WHEN: bkit-tests-deploy promotes and you have a live health URL.
1017
+ # Runs after every finished CI run on {{DEFAULT_BRANCH}}, green or red, and probes only when production
1018
+ # serves that run's commit. Not a required check. DROP if you have no deployed health URL.
1016
1019
  #
1017
1020
  # COMPOSES WITH bkit-cloud.yml: it routes on workflow_run.conclusion (success->ship, failure->debug);
1018
1021
  # a red bkit-tests-check turns the whole run red, so the router reads the capstone for free. See .bkit/cloud.md.