@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -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 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 builds from this issue.
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>` builds straight from this issue and, when Tasks keep the exact shape below, proves each **Test first** test fails before its code exists. **Done when** guides rather than gates.
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,16 +55,50 @@ body:
56
55
  attributes:
57
56
  label: Tasks
58
57
  description: |
59
- In build order, one line each, in exactly this shape. **Done when** = a check you can verify in the code (file exists, test passes, behaviour observable). **Test first** = the matrix test that fails before the code exists, as `` `test file` `test name` fails on what it asserts ``; or `n/a — reason` for docs, config, a pure refactor, or E2E / @live only.
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
- - [ ] **Task 1:** What changes. **Done when:** what you can check. **Test first:** `path/to/list.test` `rejects an empty name` fails on the thrown error.
73
+ <!-- bkit:group 1 start -->
74
+ ### TASK GROUP 1: Saving items
75
+ <!-- bkit:task 1 start -->
76
+ - [ ] **TASK 1:** Refuse an empty item name
77
+ - **UPDATE:** `saveItem` in `path/to/items`: refuse an empty name
78
+ - **READ:** `path/to/list`: where saved items show
79
+ - **DONE WHEN:** saving an empty name stores nothing and shows why
80
+ - **TEST FIRST:**
81
+ - `path/to/list.test` `rejects an empty name` fails on an empty name being saved
82
+ <!-- bkit:task 1 end -->
83
+ <!-- bkit:task 2 start -->
84
+ - [ ] **TASK 2:** Show saved items in the list
85
+ - **CREATE:** `path/to/list-row`: one row per saved item
86
+ - **DELETE:** `ItemPreview` in `path/to/list`: replaced by the new row
87
+ - **DEPENDS ON:** 1
88
+ - **DONE WHEN:** a saved item appears in the list
89
+ - **TEST FIRST:**
90
+ - `path/to/list.test` `shows a saved item` fails on the list staying empty
91
+ - **TEST EXCEPTION:**
92
+ - `path/to/list.test` `shows a saved item` — the old preview already shows saved items, so it cannot fail first
93
+ <!-- bkit:task 2 end -->
94
+ <!-- bkit:group 1 end -->
62
95
  validations:
63
96
  required: true
64
97
  - type: textarea
65
98
  id: open-questions
66
99
  attributes:
67
100
  label: Open Questions & Assumptions
68
- 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.
69
102
  - type: textarea
70
103
  id: breaking-changes
71
104
  attributes:
@@ -81,7 +114,7 @@ body:
81
114
  attributes:
82
115
  label: References
83
116
  description: |
84
- 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.
85
118
  placeholder: |
86
119
  **Parent design:** [42-offline-sync-design.md](https://github.com/<owner>/<repo>/blob/dev/docs/plans/202610/42-offline-sync-design.md)
87
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.