@cbartens/bkit 0.0.0-stage → 5.0.1

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 +417 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +867 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +924 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,86 @@
1
+ # .bkit/.env — local secrets for MCP servers and agent tooling, shipped by bkit.
2
+ # {{BKIT_MANAGED_MARKER}}
3
+ #
4
+ # Copy this file to .bkit/.env (gitignored), fill in your values, then run:
5
+ # direnv allow
6
+ # direnv will auto-export these into your shell whenever you cd into this repo.
7
+ #
8
+ # Cloud sessions (Claude on the web, Cursor Background Agents) set the SAME
9
+ # variable names in their respective dashboards — never in this file.
10
+
11
+ # Optional examples — not required bkit tooling. Listed so direnv has a name to
12
+ # load if you use that surface; leave blank otherwise.
13
+
14
+ # BKIT_GH_TOKEN — the general-purpose bkit GitHub token (fine-grained PAT). One token
15
+ # for every GitHub *API* operation bkit tooling performs:
16
+ # - the GitHub MCP server (api.githubcopilot.com/mcp/) via the Authorization header
17
+ # in .mcp.json / .cursor/mcp.json;
18
+ # - self-hosted Renovate's PLATFORM auth (repo Actions secret) when you copy
19
+ # the example `.github/workflows/bkit-renovate.yml` — opens PRs,
20
+ # pushes renovate/* branches, edits workflow SHAs, maintains the dashboard issue.
21
+ # Required Repository permissions (as labelled in the fine-grained-PAT UI; scope to the
22
+ # repos you work on): Contents: Read and write · Pull requests: Read and write · Issues:
23
+ # Read and write · Workflows: Read and write · Commit statuses: Read and write (Renovate
24
+ # reads a commit's CI state to open the PR + posts its own stability checks; without it it
25
+ # creates the renovate/* branch but 403s on /commits/{sha}/statuses and never opens the PR)
26
+ # · Dependabot alerts: Read (GitHub's vulnerability feed, for security-fix PRs) · Metadata:
27
+ # Read-only. (Actions: Read for the MCP server's run-status queries.) There is NO "Checks"
28
+ # permission on fine-grained PATs — check-run writes are App-only, so a PAT-based Renovate
29
+ # uses commit statuses instead.
30
+ # Self-hosted Renovate commit authorship: on a PERSONAL-account token also add the Account
31
+ # permission "Email addresses: Read" so commits use your verified email. ORG-owned tokens
32
+ # have NO Email-addresses permission — instead set the repo variable RENOVATE_GIT_AUTHOR
33
+ # (Settings -> Secrets and variables -> Actions -> Variables), e.g. `Renovate Bot <renovate@your-domain>`.
34
+ # This is a WRITE token — do NOT put it on read-only surfaces (Vercel env / project
35
+ # .npmrc).
36
+ # Generate at: https://github.com/settings/personal-access-tokens
37
+ BKIT_GH_TOKEN=
38
+
39
+ # BKIT_LINEAR_API_KEY — Linear personal API key. Used by the Linear MCP server
40
+ # (mcp.linear.app/mcp) and by the Linear preflight hook in
41
+ # .claude/hooks/bkit-preflight.sh and .cursor/hooks/bkit-preflight.sh.
42
+ # Generate at: https://linear.app/settings/api
43
+ BKIT_LINEAR_API_KEY=
44
+
45
+ # BKIT_ANTHROPIC_API_KEY — Anthropic API key. Only needed if you run Claude Code
46
+ # without a Claude subscription (pay-per-token mode). Subscription users leave
47
+ # blank.
48
+ # Generate at: https://console.anthropic.com/settings/keys
49
+ BKIT_ANTHROPIC_API_KEY=
50
+
51
+ # BKIT_CURSOR_API_KEY — Cursor API key. Only needed if you dispatch Cursor cloud
52
+ # agents from this shell (programmatic POST /v0/agents, model catalog queries
53
+ # via `curl https://api.cursor.com/v0/models -u "$BKIT_CURSOR_API_KEY:"`). The
54
+ # Cursor desktop IDE does NOT use this — it authenticates via its own login.
55
+ # Generate at: https://cursor.com/settings → API Keys
56
+ BKIT_CURSOR_API_KEY=
57
+
58
+ # BKIT_OPENCODE_API_KEY — OpenCode gateway API key (one key covers both plans). Used with
59
+ # `bkit install --opencode=opencode-zen` or `--opencode=opencode-go`. Zen is the full gateway
60
+ # (https://opencode.ai/zen/v1; ids `opencode-zen/<id>`); Go is the budget open-weight-only plan
61
+ # (https://opencode.ai/zen/go/v1; ids `opencode-go/<id>`). Default Go pins: minimax-m3 (opus),
62
+ # qwen3.7-plus (sonnet), deepseek-v4-pro/-flash — prefer pins that stay within the Go 5h usage window.
63
+ # Generate at: https://opencode.ai/auth (sign in → Create API Key).
64
+ BKIT_OPENCODE_API_KEY=
65
+
66
+ # BKIT_OPENROUTER_API_KEY — OpenRouter API key. Used with `bkit install --opencode=openrouter`.
67
+ # One key → every model (incl. :free variants) via openrouter.ai/api/v1. Key format: sk-or-…
68
+ # Generate at: https://openrouter.ai/keys
69
+ BKIT_OPENROUTER_API_KEY=
70
+
71
+ # BKIT_OLLAMA_API_KEY — Ollama API key. Used with `bkit install --opencode=ollama`
72
+ # (ollama.com/v1). Generate at: https://ollama.com/settings/keys
73
+ BKIT_OLLAMA_API_KEY=
74
+
75
+ # BKIT_TAVILY_API_KEY — preferred example for the `context=web` context-fetch block in
76
+ # .agents/context.md. Swap that block for any search API that returns url + snippet;
77
+ # rename this key to match. No key → the example self-skips. Cloud: same name in
78
+ # the dashboard. Generate at: https://app.tavily.com
79
+ BKIT_TAVILY_API_KEY=
80
+
81
+ # Add your own secrets below. This file is what direnv exports into every local
82
+ # agent shell (`dotenv_if_exists .bkit/.env` in `.envrc`) and what `bkit install`
83
+ # copies into the cloud dashboard paste block — so a key here reaches `/bkit-debug`
84
+ # (and any other agent bash) locally, and the same name is waiting in the dashboard
85
+ # for headless runs. App env (`.env.local`, Vercel/Supabase) is NOT on that path
86
+ # unless you append another `dotenv_if_exists` in `.envrc`. Gitignored; never commit.
@@ -0,0 +1,117 @@
1
+ <!-- GENERATED by `bkit install --claude` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
2
+
3
+ # Claude Code 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 claude.ai.
8
+ >
9
+ > Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
10
+ > permissions, auth flows, sharing across repos): `.bkit/cloud.md`.
11
+
12
+ Cloud sessions can't see your local direnv, user-level pnpm token, or GitHub
13
+ Actions secrets. Paste the blocks below into a new environment at claude.ai/code.
14
+
15
+ ## 1 · Where
16
+
17
+ [claude.ai/code](https://claude.ai/code) → environment selector → **+ Add
18
+ environment** → name it **{{PROJECT_NAME}}** (one env per repo — secrets are
19
+ per-repo) → fill the fields below → **Save**.
20
+
21
+ ## 2 · Network access
22
+
23
+ @@CLOUD_NETWORK_ALLOWLIST@@
24
+
25
+ ## 3 · Environment variables
26
+
27
+ Paste into the **Environment variables** field (`.env` format, one `KEY=value`
28
+ per line):
29
+
30
+ ```dotenv
31
+ @@CLOUD_ENV_VARS@@
32
+ ```
33
+
34
+ @@CLOUD_ENV_NOTES@@
35
+
36
+ ## 4 · Setup script
37
+
38
+ Paste into the **Setup script** field. Runs once as root before the first
39
+ session; the resulting filesystem is snapshotted and reused, so later sessions
40
+ start fast.
41
+
42
+ ```bash
43
+ #!/bin/bash
44
+ @@CLOUD_CACHE_BUST@@
45
+ set -euo pipefail
46
+
47
+ VALE_VERSION="3.9.1"
48
+ if ! command -v vale >/dev/null 2>&1; then
49
+ cd /tmp
50
+ 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"
51
+ tar -xzf "vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -C /usr/local/bin vale
52
+ chmod +x /usr/local/bin/vale
53
+ fi
54
+
55
+ if ! command -v gh >/dev/null 2>&1; then
56
+ cd /tmp
57
+ # Resolve the latest gh tag via the /releases/latest redirect, then download the
58
+ # binary — same github.com host + install style as vale above (a setup script is
59
+ # snapshotted once, so "latest" is fine and needs no pin). Reliable regardless of
60
+ # the base image's apt repos; `apt install gh` is not (gh isn't in default repos).
61
+ GH_VERSION=$(curl -fsSL -o /dev/null -w '%{url_effective}' "https://github.com/cli/cli/releases/latest" | sed -E 's#.*/tag/v##')
62
+ curl -fsSLO --retry 3 --retry-all-errors "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.tar.gz"
63
+ tar -xzf "gh_${GH_VERSION}_linux_amd64.tar.gz" -C /usr/local/bin --strip-components=2 "gh_${GH_VERSION}_linux_amd64/bin/gh"
64
+ chmod +x /usr/local/bin/gh
65
+ fi
66
+
67
+ if ! command -v jq >/dev/null 2>&1; then
68
+ # jq is a single static binary — fetch it from the jqlang release (same github.com
69
+ # host + snapshot-once rationale as vale/gh above). context-fetch blocks, including the
70
+ # .bkit/templates/context/ ones, pipe their output through `| jq …` and assume it is
71
+ # present; the base image may not ship it.
72
+ curl -fsSL --retry 3 --retry-all-errors "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64" -o /usr/local/bin/jq
73
+ chmod +x /usr/local/bin/jq
74
+ fi
75
+
76
+ @@CLOUD_WORKSPACE_TRUST@@
77
+
78
+ @@CLOUD_USER_SETTINGS@@
79
+
80
+ @@CLOUD_COREPACK@@
81
+
82
+ @@CLOUD_CONTEXT_FETCH_PROVISION@@
83
+
84
+ echo "cloud env ready: $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)"
85
+ ```
86
+
87
+ Keep total runtime under ~5 minutes or the snapshot won't build. `pnpm install`
88
+ and `vale sync` are **not** here — they belong in `.claude/hooks/bkit-cloud-bootstrap.sh`
89
+ (installed by `bkit install --auto=claude`) so they re-run on resumed sessions.
90
+
91
+ ## 5 · Verify (first session)
92
+
93
+ ```bash
94
+ vale --version && gh --version && jq --version && pnpm -v
95
+ ```
96
+
97
+ Then confirm workspace trust. Unset, Claude Code ignores every `permissions.allow`
98
+ row in `.claude/settings.json` and reports it on stderr only, where no cloud
99
+ session shows it:
100
+
101
+ ```bash
102
+ jq -r --arg p "$(git rev-parse --show-toplevel)" \
103
+ '.projects[$p].hasTrustDialogAccepted // "MISSING"' "${CLAUDE_CONFIG_DIR:-$HOME}/.claude.json"
104
+ ```
105
+
106
+ `true` = allow rows apply. `MISSING` = this container clones to a different path
107
+ than the setup script baked in; `.claude/hooks/bkit-cloud-bootstrap.sh` warns each
108
+ session — re-paste the setup script to fix the snapshot.
109
+
110
+ Your `/bkit-*` skills and bkit subagents load automatically from the committed
111
+ `.claude/` mirror — nothing to configure for those.
112
+
113
+ ---
114
+
115
+ `BKIT_GH_TOKEN` fine-grained PAT permissions, the `gh auth login --with-token`
116
+ step, MCP OAuth flow, and the one-environment-per-repo rationale all live in
117
+ `.bkit/cloud.md` § Claude Code on the web.
@@ -0,0 +1,88 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
+ "permissions": {
4
+ "allow": [
5
+ "Skill(*)",
6
+ "Bash(*)",
7
+ "mcp__github__*",
8
+ "mcp__claude_ai_Linear__*",
9
+ "WebSearch",
10
+ "Bash(git push --force-with-lease:*)",
11
+ "Read(./.env.example)",
12
+ "Read(./**/.env.example)"
13
+ ],
14
+ "deny": [
15
+ "Bash(rm -rf /*)",
16
+ "Bash(rm -rf ~/*)",
17
+ "Bash(rm -rf $HOME/*)",
18
+ "Bash(chmod -R 777 /:*)",
19
+ "Bash(git push --force)",
20
+ "Bash(git push --force *)",
21
+ "Bash(git push -f)",
22
+ "Bash(git push -f *)",
23
+ "Read(./**/*.pem)",
24
+ "Read(./**/*.p12)",
25
+ "Read(./**/id_rsa)"
26
+ ],
27
+ "ask": [
28
+ "Bash(sudo:*)",
29
+ "Bash(brew install:*)",
30
+ "Bash(pnpm publish:*)",
31
+ "Bash(npm publish:*)",
32
+ "Bash(bun publish:*)",
33
+ "Bash(git reset --hard:*)",
34
+ "Bash(git clean -fd:*)",
35
+ "Bash(git clean -fdx:*)",
36
+ "Bash(git filter-branch:*)",
37
+ "Bash(git checkout -- .:*)",
38
+ "Bash(git restore .:*)",
39
+ "Bash(git stash drop:*)",
40
+ "Bash(git rebase -i:*)",
41
+ "Bash(gh repo delete:*)",
42
+ "Bash(gh pr close:*)",
43
+ "Bash(gh release delete:*)",
44
+ "Read(./.env)",
45
+ "Read(./.env.*)",
46
+ "Read(./**/.env)",
47
+ "Read(./**/.env.*)",
48
+ "Read(./.bkit/.env)"
49
+ ],
50
+ "defaultMode": "acceptEdits"
51
+ },
52
+ "hooks": {
53
+ "SessionStart": [
54
+ {
55
+ "hooks": [
56
+ {
57
+ "type": "command",
58
+ "command": "bash .claude/hooks/bkit-preflight.sh"
59
+ },
60
+ {
61
+ "type": "command",
62
+ "command": "test -f .claude/hooks/bkit-cloud-bootstrap.sh && bash .claude/hooks/bkit-cloud-bootstrap.sh || true"
63
+ }
64
+ ]
65
+ }
66
+ ],
67
+ "PreToolUse": [
68
+ {
69
+ "matcher": "Edit|Write|MultiEdit",
70
+ "hooks": [
71
+ {
72
+ "type": "command",
73
+ "command": "test -f .claude/hooks/bkit-gateguard.cjs && node .claude/hooks/bkit-gateguard.cjs || true"
74
+ }
75
+ ]
76
+ },
77
+ {
78
+ "matcher": "Bash",
79
+ "hooks": [
80
+ {
81
+ "type": "command",
82
+ "command": "test -f .claude/hooks/bkit-guardrails.cjs && node .claude/hooks/bkit-guardrails.cjs || true"
83
+ }
84
+ ]
85
+ }
86
+ ]
87
+ }
88
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "hooks": {
3
+ "PreToolUse": [
4
+ {
5
+ "matcher": "apply_patch",
6
+ "hooks": [
7
+ {
8
+ "type": "command",
9
+ "command": "test -f .codex/hooks/bkit-gateguard.cjs && node .codex/hooks/bkit-gateguard.cjs || true",
10
+ "statusMessage": "bkit GateGuard"
11
+ }
12
+ ]
13
+ },
14
+ {
15
+ "matcher": "Bash",
16
+ "hooks": [
17
+ {
18
+ "type": "command",
19
+ "command": "test -f .codex/hooks/bkit-guardrails.cjs && node .codex/hooks/bkit-guardrails.cjs || true",
20
+ "statusMessage": "bkit guardrails"
21
+ }
22
+ ]
23
+ }
24
+ ]
25
+ }
26
+ }
@@ -0,0 +1,84 @@
1
+ <!-- GENERATED by `bkit install --cursor` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
2
+
3
+ # Cursor Cloud Agent 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 Cursor's dashboard.
8
+ >
9
+ > Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
10
+ > permissions, tracker dispatch, sharing across repos): `.bkit/cloud.md`.
11
+
12
+ This is the Cursor twin of `.claude/bkit-cloud.md`: the **same bkit cloud environment**,
13
+ built by a different mechanic. Cursor **Cloud Agents**
14
+ bake the toolchain (vale, gh, jq, python3, corepack pnpm) into `.cursor/Dockerfile`,
15
+ and run the per-snapshot install from `.cursor/environment.json` — both ship in the
16
+ repo, nothing to paste. The only thing you add in the dashboard is the **secrets**
17
+ below.
18
+
19
+ ## 1 · Where
20
+
21
+ Cloud Agents dashboard → **https://cursor.com/dashboard/cloud-agents** → your
22
+ environment → **Secrets** tab. (Secrets are scoped per environment — one set does not
23
+ leak to another. See `.bkit/cloud.md` § Sharing across repos → Cursor.)
24
+
25
+ ## 2 · Secrets
26
+
27
+ Add **each** line below as a secret (Name = the key, Value = the value). Set the
28
+ **type** per the rule below — for bkit's tokens use **Runtime Secret**:
29
+
30
+ - **Runtime Secret** — loaded into the agent's environment **but redacted from the
31
+ agent's transcript/commits**. Use this for every token below: MCP servers, `gh`,
32
+ `pnpm`, and `bkit-preflight.sh` read them from the process env, while the agent never
33
+ sees the raw value. (Still visible to a human in the Terminal — that's expected.)
34
+ - **Environment Variable** — visible to the agent; only for non-secret config.
35
+ - **Build Secret** — Docker-build-time only; not needed unless you move the
36
+ `pnpm` auth into the Dockerfile (bkit runs it in `environment.json` `install`).
37
+
38
+ ```dotenv
39
+ @@CLOUD_ENV_VARS@@
40
+ ```
41
+
42
+ @@CLOUD_ENV_NOTES@@
43
+
44
+ - `LINEAR_ISSUE_ID` (Linear tracker) / `GITHUB_ISSUE_ID` (GitHub tracker) are injected
45
+ **per session** by the Cursor integration — do **not** add them here.
46
+ - `BKIT_GH_TOKEN` fine-grained PAT permissions are documented in `.bkit/cloud.md`
47
+ § BKIT_GH_TOKEN permissions (identical scope to the Claude side).
48
+ - Secrets are encrypted at rest and in transit and scoped to the environment.
49
+
50
+ ## 3 · Toolchain (in-repo — nothing to paste)
51
+
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
54
+ identical bkit toolchain:
55
+
56
+ - `.cursor/Dockerfile` — image build, your copy of the template (keep its
57
+ `bkit toolchain` section as shipped; set Node major / Playwright / extra apt deps
58
+ outside it).
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
62
+ environment.json fields Cursor runs.)
63
+
64
+ After changing either, run `pnpm bkit install` and commit — the first session
65
+ rebuilds the image; later sessions reuse cached layers.
66
+
67
+ ## 4 · Network access
68
+
69
+ @@CURSOR_NETWORK@@
70
+ @@CURSOR_CONTEXT_FETCH@@
71
+ ## 5 · Verify (first session)
72
+
73
+ ```bash
74
+ vale --version && gh --version && jq --version && pnpm -v && python3 --version
75
+ ```
76
+
77
+ Your `/bkit-*` commands and bkit subagents load automatically from the committed
78
+ `.cursor/` mirror — nothing to configure for those.
79
+
80
+ ---
81
+
82
+ Tracker dispatch (Linear `@cursor` mention / GitHub PR-label automation), the
83
+ `BKIT_GH_TOKEN` PAT permission table, and the one-environment-per-repo rationale all
84
+ live in `.bkit/cloud.md` § Cursor Cloud Agents.
@@ -0,0 +1,26 @@
1
+ {
2
+ "version": 1,
3
+ "hooks": {
4
+ "sessionStart": [
5
+ { "command": ".cursor/hooks/bkit-preflight.sh", "failClosed": true }
6
+ ],
7
+ "sessionStop": [{ "command": "echo '[bkit] session stopped'" }],
8
+ "beforeShellExecution": [
9
+ {
10
+ "command": "node .cursor/hooks/bkit-guardrails.cjs",
11
+ "failClosed": true
12
+ }
13
+ ],
14
+ "preToolUse": [
15
+ {
16
+ "command": "node .cursor/hooks/bkit-guardrails.cjs",
17
+ "matcher": "Read|TabRead",
18
+ "failClosed": true
19
+ },
20
+ {
21
+ "command": "node .cursor/hooks/bkit-gateguard.cjs",
22
+ "matcher": "Write"
23
+ }
24
+ ]
25
+ }
26
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "mcpServers": {
3
+ "linear": {
4
+ "type": "http",
5
+ "url": "https://mcp.linear.app/mcp"
6
+ },
7
+ "github": {
8
+ "type": "http",
9
+ "url": "https://api.githubcopilot.com/mcp/",
10
+ "headers": {
11
+ "Authorization": "Bearer ${BKIT_GH_TOKEN}"
12
+ }
13
+ }
14
+ }
15
+ }
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: Cross-IDE shared rules reference
3
+ alwaysApply: true
4
+ ---
5
+
6
+ <!-- bkit:start -->
7
+
8
+ {{BKIT_MANAGED_MARKER}}
9
+
10
+ - **Rules:** Read `.agents/rules.md` → FOLLOW ALL rules.
11
+
12
+ <!-- bkit:end -->
@@ -0,0 +1,37 @@
1
+ # <!-- bkit:start -->
2
+
3
+ # {{BKIT_MANAGED_MARKER}}
4
+
5
+ # Append-only ledgers: union merge auto-concatenates both sides on conflict.
6
+ # EVERY ledger bkit workflows append to is listed — one left out blocks a merge
7
+ # over data that never conflicted, two branches having simply appended different
8
+ # rows. JSONL rows dedupe by identity tuple (kind, repo, key); union may interleave
9
+ # or duplicate lines, resolved by the reader — never a blocking merge conflict.
10
+ #
11
+ # Union makes append-only LOAD-BEARING, not a convention. It keeps both sides of a
12
+ # conflicting hunk, so editing a row in place leaves the stale copy alive beside its
13
+ # replacement — and the reader folds last-wins by `ts`, so the stale row wins
14
+ # whenever its `ts` is the later one. Correct a row by APPENDING one with the same
15
+ # `key` and a CURRENT `ts`; never edit or delete a line, and never write a future
16
+ # `ts` (it outranks every correction that follows it, permanently).
17
+ docs/knowledge.jsonl merge=union
18
+ docs/decisions.jsonl merge=union
19
+ docs/deferrals.jsonl merge=union
20
+ docs/failures.jsonl merge=union
21
+ .bkit/issues.jsonl merge=union
22
+ docs/roadmap.md merge=union
23
+ .bkit/stats.jsonl merge=union
24
+
25
+ # `.bkit/friction.jsonl` is deliberately absent: it is the one ledger rows are
26
+ # REMOVED from (`bkit harvest` drains it). Union would resurrect rows a drain
27
+ # deleted, so a conflict there carries real information and must stay blocking.
28
+
29
+ # Append-only NDJSON workflow status logs: union auto-concatenates both branches'
30
+ # appended lines server-side so a per-FID status log never blocks a merge.
31
+ # Safe iff strictly append-only (prior lines never mutated); the reader folds + dedupes
32
+ # by (workflow, step, parentSha, at) and orders by `at`, tolerating interleave/duplication.
33
+ # Scoped to bkit's status files only — NOT a blanket *.jsonl (union would corrupt a
34
+ # consumer's non-append-only .jsonl data on merge).
35
+ docs/plans/**/status.jsonl merge=union
36
+
37
+ # <!-- bkit:end -->
@@ -0,0 +1,16 @@
1
+ {
2
+ "mcpServers": {
3
+ "linear": {
4
+ "type": "http",
5
+ "url": "https://mcp.linear.app/mcp"
6
+ },
7
+ "github": {
8
+ "type": "http",
9
+ "url": "https://api.githubcopilot.com/mcp/",
10
+ "headers": {
11
+ "Authorization": "Bearer ${BKIT_GH_TOKEN}",
12
+ "X-MCP-Toolsets": "context,issues,pull_requests,repos,users,projects,actions"
13
+ }
14
+ }
15
+ }
16
+ }
@@ -0,0 +1,62 @@
1
+ {
2
+ "$schema": "https://opencode.ai/config.json",
3
+ "permission": {
4
+ "read": {
5
+ "*": "allow",
6
+ "*.env": "ask",
7
+ "*.env.*": "ask",
8
+ "*.env.example": "allow",
9
+ "*.pem": "deny",
10
+ "*.p12": "deny",
11
+ "*id_rsa": "deny"
12
+ },
13
+ "edit": "allow",
14
+ "grep": "allow",
15
+ "glob": "allow",
16
+ "task": "allow",
17
+ "websearch": "allow",
18
+ "webfetch": "ask",
19
+ "bash": {
20
+ "*": "allow",
21
+ "sudo *": "ask",
22
+ "brew install*": "ask",
23
+ "pnpm publish*": "ask",
24
+ "npm publish*": "ask",
25
+ "bun publish*": "ask",
26
+ "curl *": "ask",
27
+ "wget *": "ask",
28
+ "git reset --hard*": "ask",
29
+ "git clean -fd*": "ask",
30
+ "git clean -fdx*": "ask",
31
+ "git filter-branch*": "ask",
32
+ "git checkout -- .*": "ask",
33
+ "git restore .*": "ask",
34
+ "git stash drop*": "ask",
35
+ "git rebase -i*": "ask",
36
+ "gh repo delete*": "ask",
37
+ "gh pr close*": "ask",
38
+ "gh release delete*": "ask",
39
+ "chmod -R 777 /*": "deny",
40
+ "rm -rf /*": "deny",
41
+ "rm -rf ~/*": "deny",
42
+ "rm -rf $HOME/*": "deny",
43
+ "git push --force*": "deny",
44
+ "git push -f*": "deny",
45
+ "git push --force-with-lease*": "allow"
46
+ }
47
+ },
48
+ "mcp": {
49
+ "@@OPENCODE_TRACKER_MCP@@": {}
50
+ },
51
+ "plugin": ["./plugin/bkit-gateguard.js"],
52
+ "provider": {
53
+ "@@OPENCODE_PROVIDER_KEY@@": {
54
+ "npm": "@ai-sdk/openai-compatible",
55
+ "name": "@@OPENCODE_PROVIDER_KEY@@",
56
+ "options": {
57
+ "baseURL": "@@OPENCODE_PROVIDER_BASE_URL@@",
58
+ "apiKey": "{env:@@OPENCODE_PROVIDER_ENV_VAR@@}"
59
+ }
60
+ }
61
+ }
62
+ }
@@ -0,0 +1,11 @@
1
+ # CLAUDE.md
2
+
3
+ <!-- bkit:start -->
4
+
5
+ {{BKIT_MANAGED_MARKER}}
6
+
7
+ - **Rules:** Read `.agents/rules.md` → FOLLOW ALL rules.
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.
10
+
11
+ <!-- bkit:end -->
@@ -0,0 +1,22 @@
1
+ # Licence for `.bkit/shared/`
2
+
3
+ Everything in this folder is licensed under the MIT No Attribution License (MIT-0) below. You can use, copy, change and share these files for any purpose, without keeping this notice.
4
+
5
+ ---
6
+
7
+ MIT No Attribution
8
+
9
+ Copyright 2026 Christian Bartens
10
+
11
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this
12
+ software and associated documentation files (the "Software"), to deal in the Software
13
+ without restriction, including without limitation the rights to use, copy, modify,
14
+ merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
15
+ permit persons to whom the Software is furnished to do so.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
18
+ INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
19
+ PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
20
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22
+ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,19 @@
1
+ <!-- bkit:start -->
2
+
3
+ {{BKIT_MANAGED_MARKER}}
4
+
5
+ # Architecture
6
+
7
+ > [!CAUTION]
8
+ > **Purpose:** System design — service boundaries, deployment topology, integration sketch.
9
+ >
10
+ > **Rules:**
11
+ >
12
+ > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
13
+ > - Notation: one job per mark — `.bkit/prompts.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.
18
+
19
+ <!-- bkit:end -->
@@ -0,0 +1,19 @@
1
+ <!-- bkit:start -->
2
+
3
+ {{BKIT_MANAGED_MARKER}}
4
+
5
+ # Data Schema
6
+
7
+ > [!CAUTION]
8
+ > **Purpose:** Active production database schema — entities / tables, fields, access policies (e.g. RLS), indices, triggers.
9
+ >
10
+ > **Rules:**
11
+ >
12
+ > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
13
+ > - Notation: one job per mark — `.bkit/prompts.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.
18
+
19
+ <!-- bkit:end -->