@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -30,6 +30,16 @@
30
30
  "statusMessage": "bkit ReadGuard"
31
31
  }
32
32
  ]
33
+ },
34
+ {
35
+ "matcher": "write_to_file|replace_file_content|view_file|run_command",
36
+ "hooks": [
37
+ {
38
+ "type": "command",
39
+ "command": "f=hooks/bkit-rules.cjs; test -f \"$f\" || f=.agents/plugins/bkit/$f; test -f \"$f\" && node \"$f\" || true",
40
+ "statusMessage": "bkit rules"
41
+ }
42
+ ]
33
43
  }
34
44
  ]
35
45
  }
@@ -32,6 +32,7 @@ start fast.
32
32
  #!/bin/bash
33
33
  @@CLOUD_CACHE_BUST@@
34
34
  set -euo pipefail
35
+ # bkit-toolchain:start
35
36
 
36
37
  # Every download is pinned to a version and checked against its published sha256
37
38
  # before it is unpacked or made executable. The image targets linux/amd64.
@@ -39,8 +40,8 @@ set -euo pipefail
39
40
  # `.bkit/templates/.cursor/Dockerfile`. bkit needs Node >=24 and the base image ships
40
41
  # older majors, so this one goes into /usr/local and leads PATH for every step below.
41
42
  # renovate: datasource=node-version depName=node
42
- NODE_VERSION="24.21.0"
43
- NODE_SHA256="fd8e59d5a511510f6a298afb548f18c7d2b1be404d8b4a27d94fbe49f56cb2d6"
43
+ NODE_VERSION="24.22.1"
44
+ NODE_SHA256="6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6"
44
45
  if [ "$(/usr/local/bin/node --version 2>/dev/null || true)" != "v${NODE_VERSION}" ]; then
45
46
  command -v xz >/dev/null 2>&1 || { apt-get update && apt-get install -y --no-install-recommends xz-utils; }
46
47
  cd /tmp
@@ -53,8 +54,8 @@ export PATH="/usr/local/bin:$PATH"
53
54
  hash -r
54
55
 
55
56
  # renovate: datasource=github-releases depName=errata-ai/vale
56
- VALE_VERSION="3.9.1"
57
- VALE_SHA256="fbc2eb47d0b8c50220ed1a2c5c611fbe0904ed567d638143d482016a18fd2db0"
57
+ VALE_VERSION="3.24.0"
58
+ VALE_SHA256="867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
58
59
  if ! command -v vale >/dev/null 2>&1; then
59
60
  cd /tmp
60
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"
@@ -64,8 +65,8 @@ if ! command -v vale >/dev/null 2>&1; then
64
65
  fi
65
66
 
66
67
  # renovate: datasource=github-releases depName=cli/cli
67
- GH_VERSION="2.102.0"
68
- GH_SHA256="bb766f710eef8ede859c18578c72c327597cd4c8a85b06001b1f3843c6019386"
68
+ GH_VERSION="2.103.0"
69
+ GH_SHA256="fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786"
69
70
  if ! command -v gh >/dev/null 2>&1; then
70
71
  cd /tmp
71
72
  # Pinned release tarball from github.com (same host + install style as vale above),
@@ -78,8 +79,8 @@ if ! command -v gh >/dev/null 2>&1; then
78
79
  fi
79
80
 
80
81
  # renovate: datasource=github-releases depName=jqlang/jq extractVersion=^jq-(?<version>.+)$
81
- JQ_VERSION="1.7.1"
82
- JQ_SHA256="5942c9b0934e510ee61eb3e30273f1b3fe2590df93933a93d7c58b81d19c8ff5"
82
+ JQ_VERSION="1.8.2"
83
+ JQ_SHA256="b1c22172dd303f3be49e935aa56aa48a8b7a46e0bc838b4997d3bb451495870f"
83
84
  if ! command -v jq >/dev/null 2>&1; then
84
85
  # jq is a single static binary — fetched from the jqlang release (same github.com
85
86
  # host as vale/gh above) and checked against the release's sha256sum.txt before it is
@@ -91,6 +92,7 @@ if ! command -v jq >/dev/null 2>&1; then
91
92
  install -m 0755 jq-linux-amd64 /usr/local/bin/jq
92
93
  rm -f jq-linux-amd64
93
94
  fi
95
+ # bkit-toolchain:end
94
96
 
95
97
  @@CLOUD_WORKSPACE_TRUST@@
96
98
 
@@ -100,7 +102,7 @@ fi
100
102
 
101
103
  @@CLOUD_CONTEXT_FETCH_PROVISION@@
102
104
 
103
- echo "cloud env ready: node $(node --version), $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)"
105
+ echo "cloud setup done: node $(node --version), $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)${BKIT_UNAVAILABLE:+ — UNAVAILABLE: $BKIT_UNAVAILABLE}"
104
106
  ```
105
107
 
106
108
  Keep total runtime under ~5 minutes or the snapshot won't build. `pnpm install`
@@ -124,7 +126,7 @@ per line):
124
126
  node --version && vale --version && gh --version && jq --version && pnpm -v
125
127
  ```
126
128
 
127
- `node --version` must print `v24.21.0`. An older version means the session `PATH`
129
+ `node --version` must print `v24.22.1`. An older version means the session `PATH`
128
130
  puts the image's own Node ahead of `/usr/local/bin`.
129
131
 
130
132
  Then confirm workspace trust. Unset, Claude Code ignores every `permissions.allow`
@@ -1,5 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
+ "env": {
4
+ "BKIT_LOCK_WAIT_S": "1200"
5
+ },
3
6
  "permissions": {
4
7
  "allow": [
5
8
  "Skill(*)",
@@ -0,0 +1,98 @@
1
+ <!-- GENERATED by `bkit install --codex` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
2
+
3
+ # Codex Cloud Environment — {{PROJECT_NAME}}
4
+
5
+ > 🔐 **CONTAINS REAL SECRETS**, resolved from this repo's `.envrc`. This file is
6
+ > gitignored and holds live tokens — never commit or share it. The values only
7
+ > leave your machine when you paste them into ChatGPT's Codex settings.
8
+ >
9
+ > Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
10
+ > permissions, sharing across repos): `.bkit/cloud.md`.
11
+
12
+ This is the Codex twin of `.claude/bkit-cloud.md`: the **same bkit cloud environment**,
13
+ built by Codex's mechanics — a pasted **Install script** plus the environment's
14
+ variables. Cloud tasks can't see your local direnv, user-level pnpm token, or GitHub
15
+ Actions secrets.
16
+
17
+ ## 1 · Where
18
+
19
+ ChatGPT → **Settings > Codex Cloud > Environments** → **Create environment** → pick
20
+ this repo → name it **{{PROJECT_NAME}}** (one env per repo — secrets are per-repo) →
21
+ fill the fields below → save.
22
+
23
+ ## 2 · Network access
24
+
25
+ @@CODEX_NETWORK@@
26
+
27
+ ## 3 · Install script
28
+
29
+ Paste into the **Install script** field. Same pinned, sha256-checked toolchain as the
30
+ Claude setup script, plus the repo install Claude runs from its bootstrap hook:
31
+
32
+ ```bash
33
+ #!/bin/bash
34
+ set -euo pipefail
35
+ REPO_ROOT="$(git rev-parse --show-toplevel)"
36
+ # Recorded first: the toolchain's download steps `cd /tmp`, where no repo is found.
37
+
38
+ @@CODEX_TOOLCHAIN@@
39
+
40
+ @@CLOUD_COREPACK@@
41
+
42
+ @@CLOUD_CONTEXT_FETCH_PROVISION@@
43
+
44
+ cd "$REPO_ROOT"
45
+ if [ -f pnpm-lock.yaml ]; then pnpm install --frozen-lockfile; fi
46
+ if [ -f .vale.ini ]; then vale sync; fi
47
+ if [ -n "${BKIT_GH_TOKEN:-}" ]; then
48
+ printf '%s' "$BKIT_GH_TOKEN" | gh auth login --with-token \
49
+ || echo "[cloud-setup] gh auth login failed (non-blocking); gh will be unauthenticated" >&2
50
+ fi
51
+
52
+ echo "cloud setup done: node $(node --version), $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)${BKIT_UNAVAILABLE:+ — UNAVAILABLE: $BKIT_UNAVAILABLE (see .bkit/.unavailable)}"
53
+ ```
54
+
55
+ ## 4 · Environment variables
56
+
57
+ Paste into **Environment variables** (**Paste your .env or type a key**):
58
+
59
+ ```dotenv
60
+ @@CLOUD_ENV_VARS@@
61
+ ```
62
+
63
+ @@CLOUD_ENV_NOTES@@
64
+
65
+ - **Environment variables** reach every program as-is — MCP servers, `gh`, `pnpm` and
66
+ bkit read them from the process env. Every line above goes here.
67
+ - **Network secrets** (Key, Value, **Allowed domains**) are optional hardening for a
68
+ token used ONLY over HTTP to known hosts: programs see a placeholder and the proxy
69
+ swaps in the real value for the allowed destinations, during setup and tasks. A
70
+ token a program reads directly (e.g. `printf '%s' "$BKIT_GH_TOKEN" | gh auth login`)
71
+ breaks there — keep those as environment variables.
72
+ - **Personal vault** shares a secret across **All environments** or **Selected
73
+ environments** — use it for a token several repos reuse (e.g. `BKIT_GH_TOKEN`).
74
+ - `BKIT_GH_TOKEN` PAT permissions (fine-grained for one owner, classic across owners) are
75
+ documented in `.bkit/cloud.md` § `BKIT_GH_TOKEN` — token permissions (identical scope
76
+ to the Claude side).
77
+
78
+ ## 5 · Hooks and guardrails
79
+
80
+ Repository skills (`.agents/skills/bkit-*`, invoked `$bkit-design`) load in cloud
81
+ tasks. Codex's cloud docs say nothing about **hooks**: treat GateGuard, ReadGuard and
82
+ the guardrails hook from `.codex/hooks.json` as **unproven** in cloud tasks — review
83
+ cloud diffs as unguarded. Locally those hooks fire only once the `.codex/` layer is
84
+ trusted (`.bkit/providers.md` § Codex CLI — three deviations).
85
+
86
+ ## 6 · Verify (first task)
87
+
88
+ ```bash
89
+ node --version && vale --version && gh --version && jq --version && pnpm -v && gh auth status
90
+ ```
91
+
92
+ `node --version` must print the `NODE_VERSION` from the install script. An older
93
+ version means the task `PATH` puts the image's own Node ahead of `/usr/local/bin`.
94
+
95
+ ---
96
+
97
+ `BKIT_GH_TOKEN` PAT permissions, the one-environment-per-repo rationale and the
98
+ cloud-agent support matrix all live in `.bkit/cloud.md` § Codex Cloud.
@@ -30,6 +30,26 @@
30
30
  "statusMessage": "bkit ReadGuard"
31
31
  }
32
32
  ]
33
+ },
34
+ {
35
+ "matcher": "apply_patch",
36
+ "hooks": [
37
+ {
38
+ "type": "command",
39
+ "command": "test -f .codex/hooks/bkit-rules.cjs && node .codex/hooks/bkit-rules.cjs || true",
40
+ "statusMessage": "bkit rules"
41
+ }
42
+ ]
43
+ },
44
+ {
45
+ "matcher": "Bash",
46
+ "hooks": [
47
+ {
48
+ "type": "command",
49
+ "command": "test -f .codex/hooks/bkit-rules.cjs && node .codex/hooks/bkit-rules.cjs || true",
50
+ "statusMessage": "bkit rules"
51
+ }
52
+ ]
33
53
  }
34
54
  ],
35
55
  "PreCompact": [
@@ -50,15 +50,15 @@ 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.9.1, gh, jq, python3, corepack-pinned pnpm — so both clouds run an
53
+ script** — vale 3.24.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
57
57
  `bkit toolchain` section as shipped; set Node major / Playwright / extra apt deps
58
58
  outside it).
59
59
  - `.cursor/environment.json` — per-snapshot `install` (`pnpm install
60
- --frozen-lockfile` + `vale sync`), the analogue of Claude's
61
- `.claude/hooks/bkit-cloud-bootstrap.sh`. (`install` / `start` / `terminals` are the
60
+ --frozen-lockfile` + `vale sync` + `pnpm exec bkit context provision`), the analogue
61
+ of Claude's `.claude/hooks/bkit-cloud-bootstrap.sh`. (`install` / `start` / `terminals` are the
62
62
  environment.json fields Cursor runs.)
63
63
 
64
64
  After changing either, run `pnpm bkit install` and commit — the first session
@@ -101,7 +101,7 @@
101
101
  "mcp": {
102
102
  "@@OPENCODE_TRACKER_MCP@@": {}
103
103
  },
104
- "plugin": ["./plugin/bkit-gateguard.js", "./plugin/bkit-readguard.js"],
104
+ "plugin": ["./plugin/bkit-gateguard.js", "./plugin/bkit-readguard.js", "./plugin/bkit-rules.js"],
105
105
  "provider": {
106
106
  "@@OPENCODE_PROVIDER_KEY@@": {
107
107
  "npm": "@ai-sdk/openai-compatible",
@@ -6,6 +6,10 @@
6
6
 
7
7
  - **Rules file:** Read `.agents/rules.md` → follow all rules.
8
8
 
9
- **Memory hygiene:** Claude Code auto-memories (`MEMORY.md` + `memory/*.md`) are pointers, never copies. Facts in `docs/*.md`, `.agents/rules.md`, or `CLAUDE.md` → ONLY save path, section, and one-line hook. Issue states → query tracker or `docs/roadmap.md`; NEVER snapshot into memory.
9
+ **Memory hygiene:** Claude Code auto-memories (`MEMORY.md` + `memory/*.md`) are pointers, never copies.
10
+
11
+ - For a fact in `docs/*.md`, `.agents/rules.md` or `CLAUDE.md`, save only its path, its section and a one-line hook.
12
+ - Query the tracker or `docs/roadmap.md` for an issue's state.
13
+ - Never save a snapshot of an issue's state in memory.
10
14
 
11
15
  <!-- bkit:end -->
@@ -6,6 +6,9 @@
6
6
 
7
7
  - **Rules file:** Read `.agents/rules.md` → follow all rules.
8
8
 
9
- **Memory hygiene:** durable facts live in `docs/*.md`, `.agents/rules.md`, or this file — Antigravity loads `GEMINI.md` as a workspace rule, so keep it a pointer, never a copy. Issue states → query tracker or `docs/roadmap.md`; NEVER snapshot them here.
9
+ **Memory hygiene:** Durable facts live in `docs/*.md`, `.agents/rules.md` or this file. Antigravity loads `GEMINI.md` as a workspace rule, so keep this file a pointer, never a copy.
10
+
11
+ - Query the tracker or `docs/roadmap.md` for an issue's state.
12
+ - Never save a snapshot of an issue's state here.
10
13
 
11
14
  <!-- bkit:end -->
@@ -5,15 +5,12 @@
5
5
  # Architecture
6
6
 
7
7
  > [!CAUTION]
8
- > **Purpose:** System design — service boundaries, deployment topology, integration sketch.
8
+ > **Purpose:** The system design: service boundaries, deployment topology and an integration sketch.
9
9
  >
10
10
  > **Rules:**
11
11
  >
12
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
13
- > - Notation: one job per mark — `.bkit/authoring.md` § `Notation`.
14
- > - Describe current state / rules, not reasons / history; state what to do, not why.
15
- > - Check `.agents/docs.md` index first and confirm topic belongs in this doc, not another.
16
- > - Topology / boundaries only; operational rules and library lists → domain docs.
17
- > - Update on package add / remove or boundary shift.
12
+ > - Follow `.bkit/authoring.md` § All Agent-Read Files and § Docs when you edit this file.
13
+ > - Hold topology and boundaries only. Operational rules and library lists go in the domain docs.
14
+ > - Update this file when a package is added or removed, or a boundary shifts.
18
15
 
19
16
  <!-- bkit:end -->
@@ -5,15 +5,12 @@
5
5
  # Data Schema
6
6
 
7
7
  > [!CAUTION]
8
- > **Purpose:** Active production database schema — entities / tables, fields, access policies (e.g. RLS), indices, triggers.
8
+ > **Purpose:** The active production database schema: entities / tables, fields, access policies (e.g. RLS), indices and triggers.
9
9
  >
10
10
  > **Rules:**
11
11
  >
12
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
13
- > - Notation: one job per mark — `.bkit/authoring.md` § `Notation`.
14
- > - Describe current state / rules, not reasons / history; state what to do, not why.
15
- > - Check `.agents/docs.md` index first and confirm topic belongs in this doc, not another.
16
- > - One section / table: `Field | Type | Unique | Notes`, `Indices`, `Pending`.
17
- > - Fields whose existence is a decision: link `decisions.jsonl` ADR; do not restate rationale.
12
+ > - Follow `.bkit/authoring.md` § All Agent-Read Files and § Docs when you edit this file.
13
+ > - Give each table one section, holding a `Field | Type | Unique | Notes` table, `Indices` and `Pending`.
14
+ > - For a field whose existence is a decision, link its ADR in `decisions.jsonl`, and do not restate the rationale.
18
15
 
19
16
  <!-- bkit:end -->