@cbartens/bkit 6.1.1 → 6.2.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 (313) hide show
  1. package/.bkit/README.md +14 -12
  2. package/.bkit/core/.agents/docs.md +1 -11
  3. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +30 -9
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +25 -27
  5. package/.bkit/core/.agents/rules.md +22 -9
  6. package/.bkit/core/.bkit/README.md +13 -11
  7. package/.bkit/core/.bkit/authoring.md +58 -13
  8. package/.bkit/core/.bkit/cli.md +42 -32
  9. package/.bkit/core/.bkit/cloud.md +93 -30
  10. package/.bkit/core/.bkit/install.md +55 -16
  11. package/.bkit/core/.bkit/jsonl.md +24 -7
  12. package/.bkit/core/.bkit/pipeline.md +8 -8
  13. package/.bkit/core/.bkit/prompts.md +160 -43
  14. package/.bkit/core/.bkit/providers.md +97 -36
  15. package/.bkit/core/.bkit/templates.md +162 -34
  16. package/.bkit/core/.bkit/trackers.md +39 -6
  17. package/.bkit/core/.bkit/workflows.md +344 -136
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +50 -27
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +11 -11
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +13 -8
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +14 -25
  22. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +20 -9
  23. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +8 -8
  24. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +14 -4
  25. package/.bkit/core/.opencode/plugin/bkit-guardrails.js +114 -0
  26. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +1 -1
  27. package/.bkit/core/docs/templates/bkit-audit-adoption.md +30 -6
  28. package/.bkit/core/docs/templates/bkit-audit-agents.md +1 -1
  29. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +1 -1
  30. package/.bkit/core/docs/templates/bkit-audit-analytics.md +1 -1
  31. package/.bkit/core/docs/templates/bkit-audit-annotations.md +1 -1
  32. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +1 -1
  33. package/.bkit/core/docs/templates/bkit-audit-app-store.md +1 -1
  34. package/.bkit/core/docs/templates/bkit-audit-architecture.md +1 -1
  35. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +2 -2
  36. package/.bkit/core/docs/templates/bkit-audit-config.md +3 -2
  37. package/.bkit/core/docs/templates/bkit-audit-cost.md +1 -1
  38. package/.bkit/core/docs/templates/bkit-audit-coverage.md +1 -1
  39. package/.bkit/core/docs/templates/bkit-audit-database.md +3 -3
  40. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +1 -1
  41. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +1 -1
  42. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +3 -3
  43. package/.bkit/core/docs/templates/bkit-audit-documentation.md +32 -2
  44. package/.bkit/core/docs/templates/bkit-audit-duplication.md +1 -1
  45. package/.bkit/core/docs/templates/bkit-audit-failures.md +1 -1
  46. package/.bkit/core/docs/templates/bkit-audit-flakes.md +2 -2
  47. package/.bkit/core/docs/templates/bkit-audit-gates.md +5 -3
  48. package/.bkit/core/docs/templates/bkit-audit-issues.md +1 -1
  49. package/.bkit/core/docs/templates/bkit-audit-llm.md +2 -2
  50. package/.bkit/core/docs/templates/bkit-audit-logs.md +1 -1
  51. package/.bkit/core/docs/templates/bkit-audit-models.md +2 -2
  52. package/.bkit/core/docs/templates/bkit-audit-privacy.md +1 -1
  53. package/.bkit/core/docs/templates/bkit-audit-prompts.md +1 -1
  54. package/.bkit/core/docs/templates/bkit-audit-red-team.md +2 -2
  55. package/.bkit/core/docs/templates/bkit-audit-reliability.md +3 -2
  56. package/.bkit/core/docs/templates/bkit-audit-repo.md +1 -1
  57. package/.bkit/core/docs/templates/bkit-audit-security.md +1 -1
  58. package/.bkit/core/docs/templates/bkit-audit-slop.md +1 -1
  59. package/.bkit/core/docs/templates/bkit-audit-testing.md +3 -2
  60. package/.bkit/core/docs/templates/bkit-audit-usability.md +1 -1
  61. package/.bkit/core/docs/templates/bkit-plan.md +38 -8
  62. package/.bkit/core/engine/checks/after/auth.ts +118 -47
  63. package/.bkit/core/engine/checks/after/github.ts +89 -37
  64. package/.bkit/core/engine/checks/after/index.ts +15 -3
  65. package/.bkit/core/engine/checks/after/tools.ts +245 -1
  66. package/.bkit/core/engine/checks/before/files.ts +59 -1
  67. package/.bkit/core/engine/checks/before/index.ts +8 -0
  68. package/.bkit/core/engine/checks/status-holes.ts +20 -26
  69. package/.bkit/core/engine/checks/tips/catalogue.ts +107 -10
  70. package/.bkit/core/engine/checks/tips/detect.ts +36 -3
  71. package/.bkit/core/engine/checks/tips/index.ts +1 -1
  72. package/.bkit/core/engine/cli.ts +13 -13
  73. package/.bkit/core/engine/commands/ci/ci.ts +64 -11
  74. package/.bkit/core/engine/commands/ci/push-gate.ts +101 -43
  75. package/.bkit/core/engine/commands/install/install.ts +28 -25
  76. package/.bkit/core/engine/commands/install/uninstall.ts +42 -30
  77. package/.bkit/core/engine/commands/install/upgrade.ts +14 -2
  78. package/.bkit/core/engine/commands/land.ts +2 -3
  79. package/.bkit/core/engine/commands/lib.ts +394 -39
  80. package/.bkit/core/engine/commands/registry.ts +1 -1
  81. package/.bkit/core/engine/commands/workflow/branches.ts +351 -78
  82. package/.bkit/core/engine/commands/workflow/challenge.ts +63 -14
  83. package/.bkit/core/engine/commands/workflow/context.ts +71 -10
  84. package/.bkit/core/engine/commands/workflow/counters.ts +298 -23
  85. package/.bkit/core/engine/commands/workflow/decisions.ts +260 -125
  86. package/.bkit/core/engine/commands/workflow/disk.ts +2 -1
  87. package/.bkit/core/engine/commands/workflow/feature-base.ts +66 -0
  88. package/.bkit/core/engine/commands/workflow/issues.ts +312 -17
  89. package/.bkit/core/engine/commands/workflow/junit.ts +204 -0
  90. package/.bkit/core/engine/commands/workflow/ledgers.ts +904 -99
  91. package/.bkit/core/engine/commands/workflow/locks.ts +186 -29
  92. package/.bkit/core/engine/commands/workflow/loops.ts +87 -0
  93. package/.bkit/core/engine/commands/workflow/open-decision.ts +251 -0
  94. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +8 -0
  95. package/.bkit/core/engine/commands/workflow/plans.ts +1 -1
  96. package/.bkit/core/engine/commands/workflow/prs.ts +311 -16
  97. package/.bkit/core/engine/commands/workflow/repo.ts +1 -1
  98. package/.bkit/core/engine/commands/workflow/run-facts.ts +6 -0
  99. package/.bkit/core/engine/commands/workflow/runs.ts +877 -174
  100. package/.bkit/core/engine/commands/workflow/runtime.ts +12 -4
  101. package/.bkit/core/engine/commands/workflow/status.ts +324 -11
  102. package/.bkit/core/engine/commands/workflow/step-table.ts +41 -15
  103. package/.bkit/core/engine/commands/workflow/steps.ts +604 -29
  104. package/.bkit/core/engine/commands/workflow/summary-findings.ts +1 -1
  105. package/.bkit/core/engine/commands/workflow/summary.ts +314 -8
  106. package/.bkit/core/engine/commands/workflow/tasks.ts +400 -27
  107. package/.bkit/core/engine/commands/workflow/tests-base.ts +319 -0
  108. package/.bkit/core/engine/commands/workflow/tests-changed.ts +138 -74
  109. package/.bkit/core/engine/commands/workflow/tests-jump.ts +93 -0
  110. package/.bkit/core/engine/commands/workflow/tests.ts +815 -182
  111. package/.bkit/core/engine/commands/workflow/tracker.ts +1134 -137
  112. package/.bkit/core/engine/commands/workflow/workflows.ts +100 -72
  113. package/.bkit/core/engine/commands/workflow/worktrees.ts +421 -57
  114. package/.bkit/core/engine/install/cloud-env.ts +38 -10
  115. package/.bkit/core/engine/install/managed-block.ts +105 -0
  116. package/.bkit/core/engine/install/manifest.ts +7 -1
  117. package/.bkit/core/engine/install/modules/claude.ts +6 -2
  118. package/.bkit/core/engine/install/modules/cloud.ts +84 -95
  119. package/.bkit/core/engine/install/modules/codex.ts +10 -2
  120. package/.bkit/core/engine/install/modules/core.ts +148 -14
  121. package/.bkit/core/engine/install/modules/opencode.ts +18 -23
  122. package/.bkit/core/engine/install/network-allowlist.ts +8 -3
  123. package/.bkit/core/engine/install/project-docs.ts +650 -0
  124. package/.bkit/core/engine/install/template-copies.ts +58 -5
  125. package/.bkit/core/engine/install/write.ts +128 -7
  126. package/.bkit/core/engine/ledgers/journal.ts +18 -10
  127. package/.bkit/core/engine/ledgers/migrate.ts +20 -8
  128. package/.bkit/core/engine/ledgers/status.ts +604 -8
  129. package/.bkit/core/engine/ledgers/telemetry.ts +115 -13
  130. package/.bkit/core/engine/render/trackers.ts +3 -1
  131. package/.bkit/core/engine/shared/package-manager.ts +7 -3
  132. package/.bkit/core/engine/shared/settings.ts +12 -1
  133. package/.bkit/core/engine/shared/text.ts +14 -0
  134. package/.bkit/core/engine/tools/instructions-sources.ts +1 -0
  135. package/.bkit/core/engine/tools/instructions.ts +116 -20
  136. package/.bkit/core/hooks/antigravity-hook.js +20 -4
  137. package/.bkit/core/hooks/gateguard-edit-payload.js +8 -5
  138. package/.bkit/core/hooks/gateguard-engine.js +249 -23
  139. package/.bkit/core/hooks/guardrails-deny.js +167 -0
  140. package/.bkit/core/hooks/guardrails-read.js +3 -3
  141. package/.bkit/core/hooks/guardrails-shell.js +1122 -167
  142. package/.bkit/core/hooks/guardrails-tiers.js +247 -176
  143. package/.bkit/core/hooks/preflight-tracker.sh +219 -0
  144. package/.bkit/core/prompts/bkit-audit-generate.md +23 -6
  145. package/.bkit/core/prompts/bkit-build-challenge-1.md +5 -4
  146. package/.bkit/core/prompts/bkit-build-challenge-2.md +6 -5
  147. package/.bkit/core/prompts/bkit-build-install-skills.md +2 -2
  148. package/.bkit/core/prompts/bkit-build-plan-convert.md +21 -7
  149. package/.bkit/core/prompts/bkit-build-plan-current.md +5 -4
  150. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +22 -17
  151. package/.bkit/core/prompts/bkit-build-plan-tasks.md +16 -12
  152. package/.bkit/core/prompts/bkit-build-plan-tests.md +14 -10
  153. package/.bkit/core/prompts/bkit-build-plan-verify.md +21 -8
  154. package/.bkit/core/prompts/bkit-debug-abort-handover.md +10 -5
  155. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +22 -6
  156. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +19 -3
  157. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +22 -6
  158. package/.bkit/core/prompts/bkit-debug-failure-soak.md +10 -7
  159. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +3 -3
  160. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +4 -4
  161. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +3 -3
  162. package/.bkit/core/prompts/bkit-design-generate.md +6 -4
  163. package/.bkit/core/prompts/bkit-design-organise.md +4 -3
  164. package/.bkit/core/prompts/bkit-design-review-1.md +5 -4
  165. package/.bkit/core/prompts/bkit-design-review-2.md +6 -5
  166. package/.bkit/core/prompts/bkit-design-spike.md +4 -3
  167. package/.bkit/core/prompts/bkit-design-update.md +6 -4
  168. package/.bkit/core/prompts/bkit-plan-generate.md +35 -14
  169. package/.bkit/core/prompts/bkit-plan-review-1.md +9 -7
  170. package/.bkit/core/prompts/bkit-plan-review-2.md +9 -7
  171. package/.bkit/core/prompts/bkit-plan-scope-check.md +8 -6
  172. package/.bkit/core/prompts/bkit-plan-update.md +22 -8
  173. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +11 -8
  174. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +9 -5
  175. package/.bkit/core/prompts/bkit-ship-update-docs.md +26 -4
  176. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +3 -3
  177. package/.bkit/core/prompts/bkit-utility-update-decisions.md +10 -7
  178. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +8 -5
  179. package/.bkit/core/prompts/bkit-utility-update-documentation.md +31 -7
  180. package/.bkit/core/prompts/bkit-utility-update-failures.md +8 -5
  181. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +10 -7
  182. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -4
  183. package/.bkit/core/prompts/bkit-utility-update-tracker.md +4 -4
  184. package/.bkit/core/workflows/bkit-auto.md +23 -11
  185. package/.bkit/core/workflows/bkit-build.md +331 -100
  186. package/.bkit/core/workflows/bkit-debug.md +135 -64
  187. package/.bkit/core/workflows/bkit-design.md +58 -32
  188. package/.bkit/core/workflows/bkit-plan.md +73 -45
  189. package/.bkit/core/workflows/bkit-ship.md +233 -167
  190. package/.bkit/shared/.agents/plugins/bkit/hooks.json +1 -1
  191. package/.bkit/shared/.bkit/.env.example +5 -0
  192. package/.bkit/shared/.claude/bkit-cloud.md +7 -7
  193. package/.bkit/shared/.claude/settings.json +5 -1
  194. package/.bkit/shared/.cursor/bkit-cloud.md +1 -1
  195. package/.bkit/shared/.cursor/hooks.json +1 -1
  196. package/.bkit/shared/.opencode/opencode.json +11 -2
  197. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +27 -0
  198. package/.bkit/templates/.cursor/Dockerfile +7 -7
  199. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +1 -1
  200. package/.bkit/templates/.github/dependabot.yml +5 -0
  201. package/.bkit/templates/.github/renovate.json5 +5 -3
  202. package/.bkit/templates/.github/workflows/bkit-ci.yml +11 -11
  203. package/.bkit/templates/.github/workflows/bkit-cloud.yml +525 -161
  204. package/.bkit/templates/.github/workflows/bkit-renovate.yml +2 -2
  205. package/.bkit/templates/.husky/pre-push +123 -6
  206. package/.bkit/templates/context/bkit-serena.md +1 -1
  207. package/.bkit/templates/docs/architecture.md +98 -0
  208. package/.bkit/templates/docs/capabilities.md +33 -37
  209. package/.bkit/templates/docs/components.md +142 -0
  210. package/.bkit/templates/docs/data-schema.md +87 -0
  211. package/.bkit/{shared → templates}/docs/deployments.md +128 -142
  212. package/.bkit/templates/docs/design.md +117 -0
  213. package/.bkit/templates/docs/noise.md +54 -0
  214. package/.bkit/templates/docs/observability.md +99 -0
  215. package/.bkit/templates/docs/security.md +137 -0
  216. package/.bkit/templates/docs/setup.md +93 -0
  217. package/.bkit/templates/docs/technology.md +70 -0
  218. package/.bkit/{shared → templates}/docs/testing.md +200 -87
  219. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +511 -103
  220. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +228 -35
  221. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +270 -2
  222. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  223. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +92 -63
  224. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +59 -11
  225. package/.bkit/templates/slop-scan.config.json +2 -0
  226. package/CHANGELOG.md +64 -0
  227. package/DETAILS.md +24 -19
  228. package/README.md +1 -1
  229. package/dist/checks/after/auth.js +114 -46
  230. package/dist/checks/after/github.js +77 -35
  231. package/dist/checks/after/index.js +12 -3
  232. package/dist/checks/after/tools.js +224 -1
  233. package/dist/checks/before/files.js +59 -1
  234. package/dist/checks/before/index.js +7 -1
  235. package/dist/checks/status-holes.js +20 -21
  236. package/dist/checks/tips/catalogue.js +99 -10
  237. package/dist/checks/tips/detect.js +35 -3
  238. package/dist/checks/tips/index.js +1 -1
  239. package/dist/cli.js +13 -13
  240. package/dist/commands/ci/ci.js +56 -12
  241. package/dist/commands/ci/push-gate.js +79 -44
  242. package/dist/commands/install/install.js +23 -22
  243. package/dist/commands/install/uninstall.js +36 -30
  244. package/dist/commands/install/upgrade.js +10 -2
  245. package/dist/commands/land.js +2 -3
  246. package/dist/commands/lib.js +323 -25
  247. package/dist/commands/workflow/branches.js +312 -72
  248. package/dist/commands/workflow/challenge.js +66 -13
  249. package/dist/commands/workflow/context.js +46 -10
  250. package/dist/commands/workflow/counters.js +231 -23
  251. package/dist/commands/workflow/decisions.js +221 -106
  252. package/dist/commands/workflow/disk.js +2 -1
  253. package/dist/commands/workflow/feature-base.js +60 -0
  254. package/dist/commands/workflow/issues.js +243 -15
  255. package/dist/commands/workflow/junit.js +137 -0
  256. package/dist/commands/workflow/ledgers.js +726 -112
  257. package/dist/commands/workflow/locks.js +150 -29
  258. package/dist/commands/workflow/loops.js +67 -0
  259. package/dist/commands/workflow/open-decision.js +199 -0
  260. package/dist/commands/workflow/plan-blocks.js +6 -0
  261. package/dist/commands/workflow/plans.js +1 -1
  262. package/dist/commands/workflow/prs.js +272 -16
  263. package/dist/commands/workflow/repo.js +1 -1
  264. package/dist/commands/workflow/run-facts.js +6 -0
  265. package/dist/commands/workflow/runs.js +747 -155
  266. package/dist/commands/workflow/runtime.js +8 -4
  267. package/dist/commands/workflow/status.js +259 -13
  268. package/dist/commands/workflow/step-table.js +41 -15
  269. package/dist/commands/workflow/steps.js +530 -26
  270. package/dist/commands/workflow/summary-findings.js +1 -1
  271. package/dist/commands/workflow/summary.js +289 -8
  272. package/dist/commands/workflow/tasks.js +294 -27
  273. package/dist/commands/workflow/tests-base.js +266 -0
  274. package/dist/commands/workflow/tests-changed.js +130 -56
  275. package/dist/commands/workflow/tests-jump.js +77 -0
  276. package/dist/commands/workflow/tests.js +608 -131
  277. package/dist/commands/workflow/tracker.js +920 -112
  278. package/dist/commands/workflow/workflows.js +80 -59
  279. package/dist/commands/workflow/worktrees.js +387 -58
  280. package/dist/install/cloud-env.js +32 -10
  281. package/dist/install/managed-block.js +101 -0
  282. package/dist/install/manifest.js +7 -1
  283. package/dist/install/modules/claude.js +6 -2
  284. package/dist/install/modules/cloud.js +73 -86
  285. package/dist/install/modules/codex.js +9 -2
  286. package/dist/install/modules/core.js +133 -14
  287. package/dist/install/modules/opencode.js +18 -23
  288. package/dist/install/network-allowlist.js +8 -3
  289. package/dist/install/project-docs.js +551 -0
  290. package/dist/install/template-copies.js +55 -5
  291. package/dist/install/write.js +117 -5
  292. package/dist/ledgers/journal.js +10 -8
  293. package/dist/ledgers/migrate.js +20 -9
  294. package/dist/ledgers/status.js +461 -8
  295. package/dist/ledgers/telemetry.js +71 -13
  296. package/dist/render/trackers.js +3 -1
  297. package/dist/shared/package-manager.js +7 -2
  298. package/dist/shared/settings.js +8 -0
  299. package/dist/shared/text.js +13 -0
  300. package/dist/tools/instructions-sources.js +1 -0
  301. package/dist/tools/instructions.js +97 -24
  302. package/package.json +22 -15
  303. package/.bkit/core/hooks/preflight-linear.sh +0 -73
  304. package/.bkit/shared/docs/architecture.md +0 -16
  305. package/.bkit/shared/docs/data-schema.md +0 -16
  306. package/.bkit/shared/docs/design.md +0 -38
  307. package/.bkit/shared/docs/noise.md +0 -20
  308. package/.bkit/shared/docs/observability.md +0 -22
  309. package/.bkit/shared/docs/security.md +0 -62
  310. package/.bkit/shared/docs/setup.md +0 -52
  311. package/.bkit/shared/docs/technology.md +0 -15
  312. /package/.bkit/templates/{.lintstagedrc.json → lintstagedrc.example.json} +0 -0
  313. /package/.bkit/templates/{.prettierignore → prettierignore.example} +0 -0
@@ -2,7 +2,7 @@
2
2
  "hooks": {
3
3
  "PreToolUse": [
4
4
  {
5
- "matcher": "write_to_file|replace_file_content",
5
+ "matcher": "write_to_file|replace_file_content|multi_replace_file_content",
6
6
  "hooks": [
7
7
  {
8
8
  "type": "command",
@@ -85,6 +85,11 @@ BKIT_JIRA_API_KEY=
85
85
  # Generate at: https://console.anthropic.com/settings/keys
86
86
  BKIT_ANTHROPIC_API_KEY=
87
87
 
88
+ # BKIT_OPENAI_API_KEY — OpenAI API key for the Codex cloud router job.
89
+ # Add the same name as a repo Actions secret when using `bkit install --auto=codex`.
90
+ # Generate at: https://platform.openai.com/api-keys
91
+ BKIT_OPENAI_API_KEY=
92
+
88
93
  # BKIT_CURSOR_API_KEY — Cursor API key. Only needed if you dispatch Cursor cloud
89
94
  # agents from this shell (programmatic POST /v0/agents, model catalog queries
90
95
  # via `curl https://api.cursor.com/v0/models -u "$BKIT_CURSOR_API_KEY:"`). The
@@ -40,8 +40,8 @@ set -euo pipefail
40
40
  # `.bkit/templates/.cursor/Dockerfile`. bkit needs Node >=24 and the base image ships
41
41
  # older majors, so this one goes into /usr/local and leads PATH for every step below.
42
42
  # renovate: datasource=node-version depName=node
43
- NODE_VERSION="24.22.1"
44
- NODE_SHA256="6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6"
43
+ NODE_VERSION="24.22.2"
44
+ NODE_SHA256="48cc0e21e048790e54c0cf5749c2725005313d652651c40b7a21feb9697aaf75"
45
45
  if [ "$(/usr/local/bin/node --version 2>/dev/null || true)" != "v${NODE_VERSION}" ]; then
46
46
  command -v xz >/dev/null 2>&1 || { apt-get update && apt-get install -y --no-install-recommends xz-utils; }
47
47
  cd /tmp
@@ -54,8 +54,8 @@ export PATH="/usr/local/bin:$PATH"
54
54
  hash -r
55
55
 
56
56
  # renovate: datasource=github-releases depName=errata-ai/vale
57
- VALE_VERSION="3.24.0"
58
- VALE_SHA256="867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
57
+ VALE_VERSION="3.26.0"
58
+ VALE_SHA256="22aa69a556558e4a9dfc63c17030777383d8d3c48dcdfad655fa98e839d666ed"
59
59
  if ! command -v vale >/dev/null 2>&1; then
60
60
  cd /tmp
61
61
  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"
@@ -65,8 +65,8 @@ if ! command -v vale >/dev/null 2>&1; then
65
65
  fi
66
66
 
67
67
  # renovate: datasource=github-releases depName=cli/cli
68
- GH_VERSION="2.103.0"
69
- GH_SHA256="fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786"
68
+ GH_VERSION="2.103.3"
69
+ GH_SHA256="4c806978ffce1cec70853302a56d70ac6da4f19bae7adca4e1a8ab00633dd91d"
70
70
  if ! command -v gh >/dev/null 2>&1; then
71
71
  cd /tmp
72
72
  # Pinned release tarball from github.com (same host + install style as vale above),
@@ -126,7 +126,7 @@ per line):
126
126
  node --version && vale --version && gh --version && jq --version && pnpm -v
127
127
  ```
128
128
 
129
- `node --version` must print `v24.22.1`. An older version means the session `PATH`
129
+ `node --version` must print `v24.22.2`. An older version means the session `PATH`
130
130
  puts the image's own Node ahead of `/usr/local/bin`.
131
131
 
132
132
  Then confirm workspace trust. Unset, Claude Code ignores every `permissions.allow`
@@ -64,6 +64,7 @@
64
64
  ],
65
65
  "ask": [
66
66
  "Bash(sudo:*)",
67
+ "Bash(doas:*)",
67
68
  "Bash(brew install:*)",
68
69
  "Bash(pnpm publish:*)",
69
70
  "Bash(npm publish:*)",
@@ -95,6 +96,9 @@
95
96
  "Bash(git commit -n*)",
96
97
  "Bash(git commit * -n)",
97
98
  "Bash(git commit * -n *)",
99
+ "Bash(*bkit*tests jump*)",
100
+ "Bash(*cli.js tests jump*)",
101
+ "Bash(*cli.ts tests jump*)",
98
102
  "Read(./.env)",
99
103
  "Read(./.env.*)",
100
104
  "Read(./**/.env)",
@@ -120,7 +124,7 @@
120
124
  ],
121
125
  "PreToolUse": [
122
126
  {
123
- "matcher": "Edit|Write|MultiEdit",
127
+ "matcher": "Edit|Write|MultiEdit|NotebookEdit",
124
128
  "hooks": [
125
129
  {
126
130
  "type": "command",
@@ -50,7 +50,7 @@ Add **each** line below as a secret (Name = the key, Value = the value). Set the
50
50
  ## 3 · Toolchain (in-repo — nothing to paste)
51
51
 
52
52
  The base image bakes the **same tools at the same versions as the Claude setup
53
- script** — vale 3.24.0, gh, jq, python3, corepack-pinned pnpm — so both clouds run an
53
+ script** — vale 3.26.0, gh, jq, python3, corepack-pinned pnpm — so both clouds run an
54
54
  identical bkit toolchain:
55
55
 
56
56
  - `.cursor/Dockerfile` — image build, your copy of the template (keep its
@@ -19,7 +19,7 @@
19
19
  },
20
20
  {
21
21
  "command": "node .cursor/hooks/bkit-gateguard.cjs",
22
- "matcher": "Write"
22
+ "matcher": "Write|Delete"
23
23
  },
24
24
  {
25
25
  "command": "node .cursor/hooks/bkit-readguard.cjs",
@@ -21,6 +21,7 @@
21
21
  "bash": {
22
22
  "*": "allow",
23
23
  "sudo *": "ask",
24
+ "doas *": "ask",
24
25
  "brew install*": "ask",
25
26
  "pnpm publish*": "ask",
26
27
  "npm publish*": "ask",
@@ -95,13 +96,21 @@
95
96
  "git push* -4f*": "deny",
96
97
  "git -* push* -4f*": "deny",
97
98
  "git push* -6f*": "deny",
98
- "git -* push* -6f*": "deny"
99
+ "git -* push* -6f*": "deny",
100
+ "*bkit*tests jump*": "ask",
101
+ "*cli.js tests jump*": "ask",
102
+ "*cli.ts tests jump*": "ask"
99
103
  }
100
104
  },
101
105
  "mcp": {
102
106
  "@@OPENCODE_TRACKER_MCP@@": {}
103
107
  },
104
- "plugin": ["./plugin/bkit-gateguard.js", "./plugin/bkit-readguard.js", "./plugin/bkit-rules.js"],
108
+ "plugin": [
109
+ "./plugin/bkit-gateguard.js",
110
+ "./plugin/bkit-readguard.js",
111
+ "./plugin/bkit-rules.js",
112
+ "./plugin/bkit-guardrails.js"
113
+ ],
105
114
  "provider": {
106
115
  "@@OPENCODE_PROVIDER_KEY@@": {
107
116
  "npm": "@ai-sdk/openai-compatible",
@@ -18,6 +18,8 @@
18
18
  #
19
19
  # The `bkit baseline install` section below is bkit's starting point; the whole
20
20
  # file is yours now — add your own steps anywhere (examples at the bottom).
21
+ # Customise: the BKIT_CLOUD_ALLOWLIST_FINGERPRINT block compares the pasted network
22
+ # allowlist's fingerprint with .bkit/allowlist.json; keep it or compare your own way.
21
23
 
22
24
  set -euo pipefail
23
25
 
@@ -54,6 +56,31 @@ if [ "${CLAUDE_CODE_REMOTE:-}" = "true" ] && command -v jq >/dev/null 2>&1; then
54
56
  fi
55
57
  fi
56
58
 
59
+ # Allowlist fingerprint compare. The operator pastes the network allowlist from
60
+ # .claude/bkit-cloud.md into the cloud dashboard and copies its fingerprint into the
61
+ # BKIT_CLOUD_ALLOWLIST_FINGERPRINT env var. This compares that value with the
62
+ # `fingerprint` in .bkit/allowlist.json. A match is an operator assertion only: the
63
+ # deployed dashboard allowlist stays unverified. Every outcome warns or reports and
64
+ # continues; the hook never exits non-zero here.
65
+ # Stdout reaches the session's context (stderr does not), so a warning prints on both.
66
+ fp_warn() { log "$*"; printf '[cloud-bootstrap] %s\n' "$*"; }
67
+ EXPECTED_FP=""
68
+ if command -v jq >/dev/null 2>&1; then
69
+ EXPECTED_FP=$(jq -r '.fingerprint // empty' .bkit/allowlist.json 2>/dev/null || printf '')
70
+ fi
71
+ FP_REFRESH="Refresh: run 'bkit upgrade', re-paste the list from .claude/bkit-cloud.md section Network access into the cloud environment, then set BKIT_CLOUD_ALLOWLIST_FINGERPRINT to the fingerprint printed there."
72
+ if ! [[ "$EXPECTED_FP" =~ ^[0-9a-f]{8}$ ]]; then
73
+ fp_warn "WARNING: the expected fingerprint is unavailable (.bkit/allowlist.json has no valid 8-hex fingerprint, is not valid JSON, or jq is missing), so the cloud network allowlist cannot be compared. Fix: run 'bkit upgrade' in the repo and install jq."
74
+ elif [ -z "${BKIT_CLOUD_ALLOWLIST_FINGERPRINT:-}" ]; then
75
+ fp_warn "WARNING: BKIT_CLOUD_ALLOWLIST_FINGERPRINT is not set, so the cloud network allowlist cannot be checked for staleness. Expected fingerprint: $EXPECTED_FP. $FP_REFRESH"
76
+ elif ! [[ "$BKIT_CLOUD_ALLOWLIST_FINGERPRINT" =~ ^[0-9a-f]{8}$ ]]; then
77
+ fp_warn "WARNING: BKIT_CLOUD_ALLOWLIST_FINGERPRINT is not an 8-hex fingerprint (value not shown). Expected fingerprint: $EXPECTED_FP. $FP_REFRESH"
78
+ elif [ "$BKIT_CLOUD_ALLOWLIST_FINGERPRINT" != "$EXPECTED_FP" ]; then
79
+ fp_warn "WARNING: the cloud network allowlist is stale: BKIT_CLOUD_ALLOWLIST_FINGERPRINT is $BKIT_CLOUD_ALLOWLIST_FINGERPRINT, the repo expects $EXPECTED_FP. $FP_REFRESH"
80
+ else
81
+ log "allowlist fingerprint $EXPECTED_FP: operator-asserted match; the deployed dashboard allowlist is unverified"
82
+ fi
83
+
57
84
  if [ -f pnpm-lock.yaml ] && command -v pnpm >/dev/null 2>&1; then
58
85
  log "pnpm install --frozen-lockfile"
59
86
  pnpm install --frozen-lockfile --prefer-offline || log "pnpm install failed (non-blocking)"
@@ -27,8 +27,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
27
27
  && rm -rf /var/lib/apt/lists/*
28
28
  # Node — nodejs.org tarball checked against SHASUMS256.txt (linux-x64).
29
29
  # renovate: datasource=node-version depName=node
30
- ARG NODE_VERSION=24.22.1
31
- ARG NODE_SHA256=6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6
30
+ ARG NODE_VERSION=24.22.2
31
+ ARG NODE_SHA256=48cc0e21e048790e54c0cf5749c2725005313d652651c40b7a21feb9697aaf75
32
32
  RUN cd /tmp \
33
33
  && curl -fsSLO --retry 3 --retry-all-errors "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz" \
34
34
  && echo "${NODE_SHA256} node-v${NODE_VERSION}-linux-x64.tar.xz" | sha256sum -c - \
@@ -47,8 +47,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
47
47
 
48
48
  # gh CLI — git push, PR ops, CI cache lookup. Release tarball checked against the release's checksums.txt.
49
49
  # renovate: datasource=github-releases depName=cli/cli
50
- ARG GH_VERSION=2.103.0
51
- ARG GH_SHA256=fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786
50
+ ARG GH_VERSION=2.103.3
51
+ ARG GH_SHA256=4c806978ffce1cec70853302a56d70ac6da4f19bae7adca4e1a8ab00633dd91d
52
52
  RUN cd /tmp \
53
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" \
54
54
  && echo "${GH_SHA256} gh_${GH_VERSION}_linux_amd64.tar.gz" | sha256sum -c - \
@@ -57,8 +57,8 @@ RUN cd /tmp \
57
57
 
58
58
  # vale — `pnpm bkit:lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
59
59
  # renovate: datasource=github-releases depName=errata-ai/vale
60
- ARG VALE_VERSION=3.24.0
61
- ARG VALE_SHA256=867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214
60
+ ARG VALE_VERSION=3.26.0
61
+ ARG VALE_SHA256=22aa69a556558e4a9dfc63c17030777383d8d3c48dcdfad655fa98e839d666ed
62
62
  RUN cd /tmp \
63
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" \
64
64
  && echo "${VALE_SHA256} vale_${VALE_VERSION}_Linux_64-bit.tar.gz" | sha256sum -c - \
@@ -68,7 +68,7 @@ RUN cd /tmp \
68
68
 
69
69
  # pnpm — corepack-pinned to match `packageManager` in package.json.
70
70
  # renovate: datasource=npm depName=pnpm
71
- ARG PNPM_VERSION=10.34.7
71
+ ARG PNPM_VERSION=10.34.9
72
72
  RUN corepack enable && corepack prepare "pnpm@${PNPM_VERSION}" --activate
73
73
 
74
74
  # --- Consumer extensions ---------------------------------------------------
@@ -52,5 +52,5 @@ body:
52
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
- Docs: docs/architecture.md § Sync
55
+ Docs: docs/architecture.md § Containers
56
56
  Ledger: docs/decisions.jsonl key `offline-first-sync`
@@ -27,6 +27,10 @@ updates:
27
27
  # pulled before it reaches the queue. Security updates skip the cooldown.
28
28
  cooldown:
29
29
  default-days: 7
30
+ # Dependabot does not rebase open PRs by itself, so each update runs CI once.
31
+ # Every rebase re-runs the full CI. PRs open before this line lands keep
32
+ # rebasing until they are 30 days old.
33
+ rebase-strategy: disabled
30
34
  commit-message:
31
35
  prefix: "chore(deps)"
32
36
  include: scope
@@ -46,6 +50,7 @@ updates:
46
50
  # open-pull-requests-limit: 10
47
51
  # cooldown:
48
52
  # default-days: 7
53
+ # rebase-strategy: disabled
49
54
  # commit-message:
50
55
  # prefix: "chore(deps)"
51
56
  # prefix-development: "chore(deps-dev)"
@@ -83,9 +83,11 @@
83
83
  schedule: ["* * 1 * *"],
84
84
  },
85
85
 
86
- // Rebase a Renovate PR only when it conflicts. The default re-bases every open PR
87
- // each time the base branch moves, which re-runs CI on PRs that auto-merge.
88
- rebaseWhen: "conflicted",
86
+ // Renovate never rebases or updates an open PR by itself, so each update runs CI
87
+ // once. Every rebase re-runs the full CI, and most PRs touch `pnpm-lock.yaml`, so
88
+ // each merge would make the others conflict and rebuild. A PR that conflicts with
89
+ // `dev` waits until you tick its rebase checkbox.
90
+ rebaseWhen: "never",
89
91
 
90
92
  // A repo-level `ignorePaths` REPLACES the list from `:ignoreModulesAndTests`
91
93
  // (pulled in by `config:best-practices`), so that preset's entries are repeated
@@ -39,7 +39,7 @@ jobs:
39
39
  # [force build] / [force full] / [force cache] / [skip ci] (independent contains() per marker).
40
40
  # Markers are bare substrings — bkit-emitted commits prepend `bkit ` for attribution
41
41
  # (e.g. `bkit [verbose ci]`); substring match honours both forms.
42
- # See docs/deployments.md § "Commit-message force tags" for where to put the marker
42
+ # See .bkit/workflows.md § "Test and release mechanics" (Commit-message force tags) for where to put the marker
43
43
  # (PR title for feature-branch pushes vs commit message for direct dev/main pushes)
44
44
  # and docs/testing.md § "CI verbosity" for the full knob list.
45
45
  #
@@ -70,7 +70,7 @@ jobs:
70
70
 
71
71
  # Pnpm version is resolved from the consumer's package.json#packageManager (single SoT).
72
72
  # Do NOT add `with: version:` here — pnpm/action-setup errors when both are set.
73
- - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
73
+ - uses: pnpm/action-setup@73e46992e05b19abd31f2f3c20e0e7370d762115 # v6.1.1
74
74
 
75
75
  # Under [verbose ci]: propagate DEBUG to all subsequent steps via $GITHUB_ENV. Note
76
76
  # that steps with their own `env:` block override $GITHUB_ENV — those steps must
@@ -196,10 +196,10 @@ jobs:
196
196
  - name: Install Vale
197
197
  env:
198
198
  # renovate: datasource=github-releases depName=errata-ai/vale
199
- VALE_VERSION: "3.24.0"
199
+ VALE_VERSION: "3.26.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: "867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
202
+ VALE_SHA256: "22aa69a556558e4a9dfc63c17030777383d8d3c48dcdfad655fa98e839d666ed"
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 -
@@ -278,9 +278,9 @@ jobs:
278
278
  # and the register judged all come from that one tree.
279
279
  - name: Setup uv
280
280
  if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
281
- uses: astral-sh/setup-uv@18d369b23da25a81e9458561248e1aafff6a70fa # v10.3.1
281
+ uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
282
282
  with:
283
- version: "0.13.4"
283
+ version: "0.13.7"
284
284
 
285
285
  - name: Check Capability Register
286
286
  if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
@@ -322,7 +322,7 @@ jobs:
322
322
  with:
323
323
  node-version: {{NODE_VERSION}}
324
324
 
325
- - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
325
+ - uses: pnpm/action-setup@73e46992e05b19abd31f2f3c20e0e7370d762115 # v6.1.1
326
326
 
327
327
  # NODE_OPTIONS is a job-level `env:` key above, never a $GITHUB_ENV write — the runner
328
328
  # rejects that write and still reports success. See bkit-tests-static's block comment.
@@ -491,7 +491,7 @@ jobs:
491
491
  # # the floor as its target, to the job summary; comments on same-repo PRs only. No floor yet → drop
492
492
  # # vite-config-path (a missing file only warns, on every run).
493
493
  # if: ${{ !cancelled() && hashFiles('coverage/unit/coverage-summary.json') != '' }}
494
- # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
494
+ # uses: davelosert/vitest-coverage-report-action@74c2d9210b4fc44c84d8213f61d7ec99837b7aa0 # v2.13.2
495
495
  # with:
496
496
  # name: unit
497
497
  # json-summary-path: coverage/unit/coverage-summary.json
@@ -503,7 +503,7 @@ jobs:
503
503
  # - name: Report Integration Coverage on PR
504
504
  # # hashFiles guard: skip cleanly when the repo has no integration tier (no coverage/integration report produced).
505
505
  # if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/integration/coverage-summary.json') != ''
506
- # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
506
+ # uses: davelosert/vitest-coverage-report-action@74c2d9210b4fc44c84d8213f61d7ec99837b7aa0 # v2.13.2
507
507
  # with:
508
508
  # name: integration
509
509
  # json-summary-path: coverage/integration/coverage-summary.json
@@ -595,7 +595,7 @@ jobs:
595
595
  # - name: Report E2E Coverage on PR
596
596
  # # Same gate as Run E2E Tests (coverage exists only if E2E ran); hashFiles skips repos that produced no E2E report.
597
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') != ''
598
- # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
598
+ # uses: davelosert/vitest-coverage-report-action@74c2d9210b4fc44c84d8213f61d7ec99837b7aa0 # v2.13.2
599
599
  # with:
600
600
  # name: e2e
601
601
  # json-summary-path: coverage/e2e/coverage-summary.json
@@ -745,7 +745,7 @@ jobs:
745
745
  # # § One run per branch or pull request.
746
746
  # bkit-stub:affected-graph — [M] turbo changed-packages. Stdout ≠ stderr. deployments.md § turbo `//`.
747
747
  # - name: Detect Affected Packages # [M] sets web_affected / global_dep_changed
748
- # - name: Read Markers # [U] one parse; lanes read plan.markers_present. deployments.md § Commit-message force tags.
748
+ # - name: Read Markers # [U] one parse; lanes read plan.markers_present. .bkit/workflows.md § Test and release mechanics (Commit-message force tags).
749
749
  # - name: Decide Run # [U] Layer 1 (whether): [skip ci] or affected-empty -> run_level=none
750
750
  # - name: Decide Run Level # [U] force-build / PR / dispatch / push to default -> full.
751
751
  # # push to dev from a merged PR -> partial. Direct dev push (no PR) -> full. api-error/403 -> full.