@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
@@ -14,34 +14,76 @@
14
14
  # Revert-branch bypass: on a revert branch the unit and integration tiers are skipped; lint +
15
15
  # typecheck still run.
16
16
  #
17
- # Min push: every changed file matches `bkit.minPushPaths` (package.json; default plan logs,
18
- # ledgers) → `bkit:gate:min` replaces the full gate; MIN_PUSH=1 for repo extras. Files decide,
19
- # never `[skip ci]`.
17
+ # Min push: every changed file is one bkit writes or one that `bkit.testing.minPushPaths`
18
+ # adds (package.json; .bkit/templates.md § Git hooks — Husky) → `bkit:gate:min` replaces the
19
+ # full gate; MIN_PUSH=1 for repo extras. Files decide, never `[skip ci]`.
20
20
  set -e
21
21
 
22
+ # Log: the hook runs itself once more with everything it prints copied to tmp/pre-push.log,
23
+ # rewritten each push, so a reader whose output was cut short, or who pushed in the
24
+ # background, still has the whole run. The path is printed first (tail -f it while the push
25
+ # runs) and last, with the exit code. Git's ref list on stdin reaches the inner run unchanged,
26
+ # and the hook exits with the inner run's code. Output goes to stderr, where git sends a
27
+ # hook's output anyway. `git push --no-verify`, and a checkout without husky installed (a
28
+ # linked worktree), run no hook and write no log.
29
+ if [ -z "${BKIT_PRE_PUSH_LOGGED:-}" ]; then
30
+ PRE_PUSH_LOG=tmp/pre-push.log
31
+ PRE_PUSH_RC_FILE=$(mktemp)
32
+ mkdir -p tmp
33
+ {
34
+ echo "[pre-push] log: $PRE_PUSH_LOG"
35
+ pre_push_rc=0
36
+ BKIT_PRE_PUSH_LOGGED=1 FORCE_COLOR=1 sh "$0" "$@" 2>&1 || pre_push_rc=$?
37
+ echo "[pre-push] log: $PRE_PUSH_LOG (exit $pre_push_rc)"
38
+ echo "$pre_push_rc" > "$PRE_PUSH_RC_FILE"
39
+ } | tee "$PRE_PUSH_LOG" >&2
40
+ pre_push_rc=$(cat "$PRE_PUSH_RC_FILE")
41
+ rm -f "$PRE_PUSH_RC_FILE"
42
+ exit "$pre_push_rc"
43
+ fi
44
+
45
+ # Git exports GIT_DIR to a hook and everything it starts (from a linked worktree:
46
+ # <main>/.git/worktrees/<name>). It beats a child's cwd and -C, so a test's `git -C "$tmp" init`
47
+ # re-initialises this repo (core.bare=true in the shared .git/config) and a fixture's
48
+ # `git config user.email` lands here too. The hook runs from the work tree root, so git finds
49
+ # the repo without them.
50
+ unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE
51
+
22
52
  # ── delete-only push: nothing leaves this machine, so there is nothing to gate ──
23
53
  # `git push origin --delete <branch>` runs this hook too. Git feeds one line per ref on
24
54
  # stdin — "<local-ref> <local-sha> <remote-ref> <remote-sha>" — and a deleted ref has an
25
55
  # all-zero local sha. When EVERY line is a delete, the push carries no commits. A push
26
56
  # mixing a delete with a real update still gates, and so does an empty ref list. Reading
27
57
  # stdin here is safe: every later command redirects from /dev/null. `[ -t 0 ]` keeps a
28
- # hand-run hook from hanging. The loop also sets PUSH_DEV_SHA (commit pushed to dev) for
29
- # repo extras that gate only dev pushes (e.g. scripts/graphify/bkit-graph-pre-push.sh),
30
- # PUSH_SHAS (every pushed commit) and PUSH_SHARED_SHAS (those pushed to dev / main).
58
+ # hand-run hook from hanging. The loop also sets PUSH_DEV_SHA (commit pushed to dev) and
59
+ # PUSH_BRANCH_SHA (commit pushed to the current branch, empty when the push does not update
60
+ # it) for repo extras (e.g. scripts/graphify/bkit-graph-pre-push.sh), PUSH_SHAS (every pushed
61
+ # commit), PUSH_SHARED_SHAS (those pushed to dev / main) and PUSH_BRANCH_REMOTE_SHA (the head
62
+ # the remote holds for the current branch, empty when it holds none), which the CI-suppressor
63
+ # guard below hands to `bkit ci bookkeeping-push`.
64
+ BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
31
65
  PUSH_SAW_REF=0
32
66
  PUSH_HAS_COMMITS=0
33
67
  PUSH_DEV_SHA=""
68
+ PUSH_BRANCH_SHA=""
34
69
  PUSH_SHAS=""
70
+ PUSH_UPDATES=""
35
71
  PUSH_SHARED_SHAS=""
72
+ PUSH_BRANCH_REMOTE_SHA=""
36
73
  if [ ! -t 0 ]; then
37
- while read -r _push_local_ref push_local_sha push_remote_ref _push_remote_sha; do
74
+ while read -r _push_local_ref push_local_sha push_remote_ref push_remote_sha; do
38
75
  [ -n "$push_local_sha" ] || continue
39
76
  PUSH_SAW_REF=1
40
77
  case "$push_local_sha" in
41
78
  *[!0]*)
42
79
  PUSH_HAS_COMMITS=1
43
80
  PUSH_SHAS="$PUSH_SHAS $push_local_sha"
81
+ PUSH_UPDATES="$PUSH_UPDATES --update=$push_remote_sha:$push_local_sha"
44
82
  [ "$push_remote_ref" = "refs/heads/dev" ] && PUSH_DEV_SHA="$push_local_sha"
83
+ if [ "$push_remote_ref" = "refs/heads/$BRANCH" ]; then
84
+ PUSH_BRANCH_SHA="$push_local_sha"
85
+ case "$push_remote_sha" in *[!0]*) PUSH_BRANCH_REMOTE_SHA="$push_remote_sha" ;; esac
86
+ fi
45
87
  case "$push_remote_ref" in
46
88
  refs/heads/dev|refs/heads/main) PUSH_SHARED_SHAS="$PUSH_SHARED_SHAS $push_local_sha" ;;
47
89
  esac
@@ -55,7 +97,6 @@ if [ "$PUSH_SAW_REF" = "1" ] && [ "$PUSH_HAS_COMMITS" = "0" ]; then
55
97
  fi
56
98
  # ── end delete-only push
57
99
 
58
- BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
59
100
  HEAD_SUBJECT=$(git log -1 --pretty=%s 2>/dev/null || echo "")
60
101
  IS_REVERT=0
61
102
  case "$BRANCH" in
@@ -71,6 +112,12 @@ esac
71
112
  # -> allowed ([skip ci] pushes for mid-loop status, abort handover). dev/main exempt;
72
113
  # gh absent -> allow. `bkit ci skip-token` exits 0 when HEAD's message carries one of
73
114
  # the tokens GitHub honours; bkit owns that list.
115
+ # Exception, the same one ship's merge gate makes: a push that adds only files on ship's
116
+ # `--scope=pr` allow-list (.bkit/workflows.md § `/bkit-ship` — 14 steps) on top of the
117
+ # head the remote already holds leaves nothing new for CI to test, so the PR's checks at
118
+ # that head still cover the code. `bkit ci bookkeeping-push` exits 0 for exactly that
119
+ # shape. A rewritten head (force-push) or any code file still blocks. The merge gate
120
+ # (`bkit runs gate --validated=`) stays the authority on what merges.
74
121
  case "$BRANCH" in
75
122
  dev|main) ;;
76
123
  *)
@@ -79,9 +126,14 @@ case "$BRANCH" in
79
126
  # strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
80
127
  OPEN_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$BRANCH" --state open --json number --jq '.[0].number' 2>/dev/null || echo "")
81
128
  if [ -n "$OPEN_PR" ]; then
82
- echo "[pre-push] BLOCKED: HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open — its checks would stay vacuously green." >&2
83
- echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
84
- exit 1
129
+ if [ -n "$PUSH_BRANCH_REMOTE_SHA" ] &&
130
+ pnpm -s bkit ci bookkeeping-push --from="$PUSH_BRANCH_REMOTE_SHA" < /dev/null > /dev/null; then
131
+ echo "[pre-push] HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open, but every file changed since the remote head $PUSH_BRANCH_REMOTE_SHA is bookkeeping — the PR's checks at that head still cover the code; allowing." >&2
132
+ else
133
+ echo "[pre-push] BLOCKED: HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open — its checks would stay vacuously green." >&2
134
+ echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
135
+ exit 1
136
+ fi
85
137
  fi
86
138
  else
87
139
  echo "[pre-push] WARN: HEAD on '$BRANCH' carries a CI-suppressing token but gh is unavailable to check for an open PR; allowing. If a PR is open, ensure HEAD triggers CI." >&2
@@ -90,16 +142,13 @@ case "$BRANCH" in
90
142
  ;;
91
143
  esac
92
144
 
93
- # Min push: `bkit ci min-push` exits 0 only when every file changed since each pushed
94
- # commit left origin/dev (else origin/main) matches `bkit.minPushPaths`. Anything else
95
- # (code, no files, unreadable range, no refs) → MIN_PUSH=0, full gate: a skip on no
96
- # evidence reads as a pass.
145
+ # Min push: every outgoing ref is either bookkeeping since its integration base,
146
+ # or a bookkeeping increment over a locally checked ancestor of its remote head.
147
+ # Missing evidence, code or rewritten history keeps the full gate.
97
148
  MIN_PUSH=0
98
- if [ -n "$PUSH_SHAS" ]; then
99
- MIN_PUSH_REFS=""
100
- for push_sha in $PUSH_SHAS; do MIN_PUSH_REFS="$MIN_PUSH_REFS --ref=$push_sha"; done
149
+ if [ -n "$PUSH_UPDATES" ]; then
101
150
  # shellcheck disable=SC2086 # hex SHAs only: word-splitting is the point
102
- if pnpm -s bkit ci min-push $MIN_PUSH_REFS < /dev/null > /dev/null; then
151
+ if pnpm -s bkit ci min-push $PUSH_UPDATES < /dev/null > /dev/null; then
103
152
  MIN_PUSH=1
104
153
  fi
105
154
  fi
@@ -109,9 +158,8 @@ fi
109
158
  # the open-PR guard above (workflows push `[skip ci]` code heads mid-run).
110
159
  for push_sha in $PUSH_SHARED_SHAS; do
111
160
  if pnpm -s bkit ci skip-token --ref="$push_sha" < /dev/null > /dev/null; then
112
- if [ "$MIN_PUSH" != "1" ] &&
113
- ! pnpm -s bkit ci min-push --ref="$push_sha" < /dev/null > /dev/null; then
114
- echo "[pre-push] BLOCKED: $push_sha carries a CI-suppressing token and changes files outside bkit.minPushPaths — that code would land on dev / main with no CI run." >&2
161
+ if ! pnpm -s bkit ci min-push --ref="$push_sha" < /dev/null > /dev/null; then
162
+ echo "[pre-push] BLOCKED: $push_sha carries a CI-suppressing token and changes files outside the min-push paths (what bkit writes, plus bkit.testing.minPushPaths) — that code would land on dev / main with no CI run." >&2
115
163
  echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
116
164
  exit 1
117
165
  fi
@@ -129,14 +177,25 @@ done
129
177
  # Fix: `pnpm bkit install`, stage the regenerated files, commit, push.
130
178
  pnpm bkit check < /dev/null
131
179
 
180
+ # Dependency audit — the same gate CI's static lane runs. A high or critical advisory
181
+ # stops the push here, so a remote run is not spent on a red this machine could have
182
+ # caught. It reads the advisory registry: the push it precedes needs the network anyway.
183
+ # Fails closed — a blocking advisory, an unusable answer or an unreachable registry stops
184
+ # the push, never a pass on no answer. `--unreachable=warn` relaxes only the last of those.
185
+ # A recommendation: adopt it, and CI stops being the first place an advisory is seen.
186
+ # Skipped until scripts/ci/ holds the script (bkit install never writes it).
187
+ if [ -f scripts/ci/bkit-check-dependency-audit.mjs ]; then
188
+ node scripts/ci/bkit-check-dependency-audit.mjs < /dev/null
189
+ fi
190
+
132
191
  # Slop base on a dev push — the commit CI's slop scan compares against: the head of the last
133
- # green CI push run on dev, else origin/dev (scripts/ci/lanes/resolve-push-base.mjs, the
192
+ # green CI push run on dev, else origin/dev (scripts/ci/lanes/bkit-resolve-push-base.mjs, the
134
193
  # script CI's planner runs, in local mode). Exported as SLOP_BASE_REF, which `bkit ci slop`
135
194
  # reads, so a finding a red push already landed on dev fails here as it does in CI. Other
136
195
  # branches keep the merge-base default. Skipped until scripts/ci/lanes/ holds the script.
137
- if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/resolve-push-base.mjs ]; then
196
+ if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/bkit-resolve-push-base.mjs ]; then
138
197
  PUSH_BASE_SOURCE_FILE=$(mktemp)
139
- CI_PUSH_BASE=$(SOURCE_FILE="$PUSH_BASE_SOURCE_FILE" node scripts/ci/lanes/resolve-push-base.mjs \
198
+ CI_PUSH_BASE=$(SOURCE_FILE="$PUSH_BASE_SOURCE_FILE" node scripts/ci/lanes/bkit-resolve-push-base.mjs \
140
199
  --local --branch=dev --head="$PUSH_DEV_SHA" < /dev/null || echo "")
141
200
  CI_PUSH_BASE_SOURCE=$(cat "$PUSH_BASE_SOURCE_FILE" 2>/dev/null || echo "unknown")
142
201
  rm -f "$PUSH_BASE_SOURCE_FILE"
@@ -155,12 +214,13 @@ if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/resolve-push-base.mjs ]; then
155
214
  fi
156
215
  fi
157
216
 
158
- # Capability register (graphify, .bkit/templates.md § graphify) — blocks a push to dev when
159
- # docs/capabilities.md is not what the pushed commit builds (~30s); warn-only on other
160
- # branches. Skipped until scripts/graphify/ holds the script, and on a min push: it changes
161
- # no source the register is built from.
217
+ # Capability register (graphify, .bkit/templates.md § graphify) — blocks a push to dev, and a
218
+ # push of a branch with an open PR into dev, when docs/capabilities.md is not what the pushed
219
+ # commit builds (~30s); warn-only on other branches. Skipped until scripts/graphify/ holds the
220
+ # script, and on a min push: it changes no source the register is built from.
162
221
  if [ "$MIN_PUSH" != "1" ] && [ -f scripts/graphify/bkit-graph-pre-push.sh ]; then
163
- PUSH_DEV_SHA="$PUSH_DEV_SHA" IS_REVERT="$IS_REVERT" bash scripts/graphify/bkit-graph-pre-push.sh < /dev/null
222
+ PUSH_DEV_SHA="$PUSH_DEV_SHA" BRANCH="$BRANCH" PUSH_BRANCH_SHA="$PUSH_BRANCH_SHA" IS_REVERT="$IS_REVERT" \
223
+ bash scripts/graphify/bkit-graph-pre-push.sh < /dev/null
164
224
  fi
165
225
 
166
226
  # tmp/ prune — deletes files under tmp/ untouched for 7+ days. Not a gate: a failed
@@ -174,17 +234,17 @@ fi
174
234
  # the bkit agent workflows and prompts dispatch through. Edit the scripts, not this
175
235
  # hook. Fast repo extras go ABOVE, with `bkit check`; slow ones BELOW.
176
236
  # Min push: `bkit:gate:min` only. Revert path drops the suite only: prose
177
- # and slop:delta still run. Otherwise the deepest push gate package.json declares.
237
+ # and bkit:slop:delta still run. Otherwise the deepest push gate package.json declares.
178
238
  if [ "$MIN_PUSH" = "1" ]; then
179
239
  echo "[pre-push] min push — bkit:gate:min instead of the full gate" >&2
180
- pnpm bkit:gate:min < /dev/null
240
+ pnpm -s bkit ci push-gate --gate=bkit:gate:min < /dev/null
181
241
  elif [ "$IS_REVERT" = "1" ]; then
182
242
  echo "[pre-push] revert branch/commit detected — skipping the test suite"
183
- pnpm bkit:gate:static < /dev/null
243
+ pnpm -s bkit ci push-gate --gate=bkit:gate:static < /dev/null
184
244
  elif grep -q '"bkit:gate:static-unit-integration"[[:space:]]*:' package.json 2>/dev/null; then
185
- pnpm bkit:gate:static-unit-integration < /dev/null
245
+ pnpm -s bkit ci push-gate --gate=bkit:gate:static-unit-integration < /dev/null
186
246
  else
187
- pnpm bkit:gate:static-unit < /dev/null
247
+ pnpm -s bkit ci push-gate --gate=bkit:gate:static-unit < /dev/null
188
248
  fi
189
249
 
190
250
  # Slow repo extras go here, above the disk prune. Ones that need Docker, a database or a
@@ -193,7 +253,7 @@ fi
193
253
 
194
254
  # disk prune — keep this block last, so it runs only once every gate above passed. Starts
195
255
  # your max cleanup steps (`bkit disk prune`, .bkit/templates.md § Disk prune) in the
196
- # background, at most once a day, or hourly while free disk is under bkit.disk.minFreeGb;
256
+ # background, at most once a day, or hourly while free disk is under bkit.workflows.minFreeGb;
197
257
  # with no step files it does nothing. Not a gate: a failure warns and the push goes on.
198
258
  pnpm -s bkit disk prune --mode=max --auto < /dev/null > /dev/null ||
199
259
  echo "[pre-push] WARN: disk prune failed; push continues" >&2
@@ -39,6 +39,12 @@ pnpm-lock.yaml
39
39
  # never be byte-equal to what the renderer emits and every close would carry a
40
40
  # formatting-only diff. The fold's output is the source of truth.
41
41
  docs/roadmap.md
42
+ # Workflow run logs — gate output (`bkit tests run` / `red` / `green`), the
43
+ # `bkit context diff` / `brief` records, step reports and the run's
44
+ # `status.jsonl`, committed beside a run's artifacts. The text is a run record,
45
+ # not hand-written markdown: prettier would escape and reflow it, and a gate's
46
+ # format check would then fail on another feature's log merged in from the base.
47
+ docs/plans/*/logs/**
42
48
  # bkit's reference copies of its templates — refreshed by `bkit upgrade`, never
43
49
  # formatted by this repo.
44
50
  .bkit/templates/
@@ -5,38 +5,38 @@ MinAlertLevel = warning
5
5
  Packages = write-good
6
6
 
7
7
  [.agents/**]
8
- BasedOnStyles = House
8
+ BasedOnStyles = Bkit
9
9
 
10
10
  # Vendored skill content — third-party docs loaded under multiple paths
11
11
  # depending on harness. Each path needs its own scope block.
12
12
  [**/.agents/skills/**/*.md]
13
- House.LLMSlop = NO
14
- House.Hedging = NO
15
- House.Filler = NO
16
- House.Verbose = NO
13
+ Bkit.LLMSlop = NO
14
+ Bkit.Hedging = NO
15
+ Bkit.Filler = NO
16
+ Bkit.Verbose = NO
17
17
 
18
18
  [**/.claude/skills/**/*.md]
19
- House.LLMSlop = NO
20
- House.Hedging = NO
21
- House.Filler = NO
22
- House.Verbose = NO
19
+ Bkit.LLMSlop = NO
20
+ Bkit.Hedging = NO
21
+ Bkit.Filler = NO
22
+ Bkit.Verbose = NO
23
23
 
24
24
  [**/.cursor/skills/**/*.md]
25
- House.LLMSlop = NO
26
- House.Hedging = NO
27
- House.Filler = NO
28
- House.Verbose = NO
25
+ Bkit.LLMSlop = NO
26
+ Bkit.Hedging = NO
27
+ Bkit.Filler = NO
28
+ Bkit.Verbose = NO
29
29
 
30
30
  # Meta-prompt about prose compression: enumerates hedging/verbose phrases
31
- # verbatim as examples of what to strip, so House rules self-trigger.
31
+ # verbatim as examples of what to strip, so Bkit rules self-trigger.
32
32
  [**/bkit-utility-compress-markdown.md]
33
- House.LLMSlop = NO
34
- House.Hedging = NO
35
- House.Filler = NO
36
- House.Verbose = NO
33
+ Bkit.LLMSlop = NO
34
+ Bkit.Hedging = NO
35
+ Bkit.Filler = NO
36
+ Bkit.Verbose = NO
37
37
 
38
38
  [*.md]
39
- BasedOnStyles = write-good, House
39
+ BasedOnStyles = write-good, Bkit
40
40
  write-good.ThereIs = warning
41
41
  write-good.Passive = NO
42
42
  write-good.TooWordy = NO
@@ -49,19 +49,19 @@ write-good.Weasel = NO
49
49
  # disabling, so each rule must be turned off explicitly. Leading `**/` so
50
50
  # lint-staged's absolute paths also match.
51
51
  [**/docs/plans/**/*.md]
52
- House.LLMSlop = NO
53
- House.Hedging = NO
54
- House.Filler = NO
55
- House.Verbose = NO
52
+ Bkit.LLMSlop = NO
53
+ Bkit.Hedging = NO
54
+ Bkit.Filler = NO
55
+ Bkit.Verbose = NO
56
56
  write-good.ThereIs = NO
57
57
  write-good.So = NO
58
58
 
59
59
  # bkit's reference copies of its templates (.bkit/templates/) — refreshed by
60
60
  # `bkit upgrade`, not this repo's prose. Every rule off, as for docs/plans above.
61
61
  [**/.bkit/templates/**/*.md]
62
- House.LLMSlop = NO
63
- House.Hedging = NO
64
- House.Filler = NO
65
- House.Verbose = NO
62
+ Bkit.LLMSlop = NO
63
+ Bkit.Hedging = NO
64
+ Bkit.Filler = NO
65
+ Bkit.Verbose = NO
66
66
  write-good.ThereIs = NO
67
67
  write-good.So = NO
@@ -3,29 +3,35 @@
3
3
 
4
4
  # Google Cloud Run — container logs
5
5
 
6
- Fits: services running on Google Cloud Run. `context=runtime`: `gcloud logging read` on `cloud_run_revision` — `severity>=ERROR` plus the platform's `Memory limit … exceeded` lines. Those are container kills (503 / SIGKILL exit 137) the app itself never logs and an error tracker never sees: the container dies before its SDK flushes.
6
+ Fits: services running on Google Cloud Run. The `context=runtime` block runs `gcloud logging read` on `cloud_run_revision` and returns the `severity>=ERROR` lines plus the platform's `Memory limit … exceeded` lines. Those lines are container kills (503 / SIGKILL exit 137). The app itself never logs them, and an error tracker never sees them, because the container dies before its SDK flushes.
7
7
 
8
- - Secret: none locally after `gcloud auth login`. Headless (cloud agents): `GCP_CLIENT_EMAIL` + `GCP_PRIVATE_KEY` of a service account with `roles/logging.viewer`; the block activates it only when the gcloud login cannot mint a token (none, or a stale one), in a throwaway gcloud config it deletes on exit, so your own gcloud config is never switched.
9
- - Non-secret: `GCP_PROJECT_ID` — uncomment the line in the block so cloud agents inherit it. Separate dev / prod projects: use the id whose logs you want. Optional `GCP_SERVICE` narrows to one service; `SINCE`, `GCP_N`, `GCP_FILTER`.
10
- - CLI: `gcloud`; the provision block installs it in cloud (GitHub-hosted Ubuntu runners already ship it). Uses `node` to build the key file.
8
+ - Secret: none locally after `gcloud auth login`.
9
+ - Secret in headless runs (cloud agents): `GCP_CLIENT_EMAIL` and `GCP_PRIVATE_KEY` of a service account with `roles/logging.viewer`. The block activates the service account only when the gcloud login cannot mint a token (no login, or a stale one). It does so in a throwaway gcloud config that it deletes on exit, so your own gcloud config is never switched.
10
+ - Non-secret: `GCP_PROJECT_ID`. Uncomment its line in the block so cloud agents inherit it.
11
+ - **If** dev and prod are separate projects → use the `GCP_PROJECT_ID` whose logs you want.
12
+ - Optional non-secret: `GCP_SERVICE` narrows the read to one service. The other knobs are `SINCE`, `GCP_N` and `GCP_FILTER`.
13
+ - CLI: `gcloud`. The provision block installs it in cloud, and GitHub-hosted Ubuntu runners already ship it. The block also uses `node` to build the key file.
11
14
 
12
15
  Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`.
13
16
 
14
17
  <!-- context-fetch:start cloudrun context=runtime -->
15
18
 
16
19
  ```bash
17
- # GCP Cloud Run CONTAINER logs — platform / container errors (read-only), incl. OOM kills
20
+ # GCP Cloud Run container logs (read-only): platform and container errors, including OOM kills
18
21
  # ("Memory limit of NNNN MiB exceeded" → 503 / SIGKILL exit 137) that never reach the app's own
19
22
  # logs or its error tracker.
20
- # GCP_PROJECT_ID is non-secret — uncomment + set the line below so cloud agents inherit it.
21
- # Optional GCP_SERVICE narrows to one service; unset = every cloud_run_revision in the project:
23
+ # GCP_PROJECT_ID is non-secret. Uncomment and set the line below so cloud agents inherit it.
24
+ # Optional GCP_SERVICE narrows the read to one service. Unset, the block reads every
25
+ # cloud_run_revision in the project:
22
26
  # GCP_PROJECT_ID="your-gcp-project-id"
23
27
  # GCP_SERVICE="your-service-name"
24
- # Headless auth: active gcloud login used ONLY when `print-access-token` works; a stale user
25
- # login lists ACTIVE yet fails every read with reauth. No working login → service account from
26
- # GCP_CLIENT_EMAIL + GCP_PRIVATE_KEY (`\n`-escaped PEM un-escaped) in a throwaway CLOUDSDK_CONFIG;
27
- # operator's gcloud config untouched. Locally: `gcloud auth login` once, skip both. Failed
28
- # `gcloud logging read` → `skipped`. PII-safe: scalar / id fields only, never the raw payload.
28
+ # Headless auth: the block uses the active gcloud login only when `print-access-token` works. A
29
+ # stale user login still lists as ACTIVE, yet fails every read with reauth. With no working
30
+ # login, the block uses a service account built from GCP_CLIENT_EMAIL and GCP_PRIVATE_KEY (the
31
+ # `\n`-escaped PEM, un-escaped) in a throwaway CLOUDSDK_CONFIG, and leaves the operator's gcloud
32
+ # config untouched. Locally, run `gcloud auth login` once and skip both variables.
33
+ # A failed `gcloud logging read` → `skipped`.
34
+ # PII-safe: the block prints scalar and id fields only, never the raw payload.
29
35
  # Customise: GCP_SERVICE; SINCE freshness; GCP_N; GCP_FILTER (add textPayload:"<prefix>" for app stdout). Positive control (suggested): run once with GCP_FILTER widened to a known log line; nothing back = reader broken, not clean.
30
36
  command -v gcloud >/dev/null 2>&1 \
31
37
  || { echo "[context-fetch:cloudrun] skipped — gcloud CLI missing" >&2; exit 0; }
@@ -76,9 +82,11 @@ jq '[.[] | {timestamp, severity,
76
82
  <!-- context-fetch:provision cloudrun -->
77
83
 
78
84
  ```bash
79
- # Install the gcloud CLI in cloud if absent (self-guarded; no-op when present).
80
- # The install script needs no root or apt; --disable-prompts writes the SDK to $HOME and appends
81
- # it to the shell profile, so later context-fetch shells (profile-sourced) find it.
85
+ # Install the gcloud CLI in cloud if it is absent. The block guards itself and does nothing when
86
+ # the CLI is present.
87
+ # The install script needs no root and no apt. With --disable-prompts it writes the SDK to $HOME
88
+ # and appends it to the shell profile, so later context-fetch shells, which source the profile,
89
+ # find it.
82
90
  command -v gcloud >/dev/null 2>&1 \
83
91
  || curl -sSL https://sdk.cloud.google.com | bash -s -- --disable-prompts >/dev/null 2>&1
84
92
  ```