@cbartens/bkit 0.0.0-stage → 5.0.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 (373) hide show
  1. package/.bkit/README.md +421 -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 +421 -0
  8. package/.bkit/core/.bkit/cloud.md +502 -0
  9. package/.bkit/core/.bkit/comparison.md +318 -0
  10. package/.bkit/core/.bkit/install.md +496 -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 +471 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1546 -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 +247 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +556 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  70. package/.bkit/core/engine/checks/after/vercel.ts +101 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +201 -0
  73. package/.bkit/core/engine/checks/before/files.ts +202 -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 +871 -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 +247 -0
  86. package/.bkit/core/engine/commands/install/install.ts +528 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +494 -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 +925 -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 +174 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +600 -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/placeholders.ts +108 -0
  124. package/.bkit/core/engine/install/template-copies.ts +119 -0
  125. package/.bkit/core/engine/install/version-file.ts +284 -0
  126. package/.bkit/core/engine/install/write.ts +467 -0
  127. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  128. package/.bkit/core/engine/ledgers/status.ts +213 -0
  129. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  130. package/.bkit/core/engine/render/hosts.ts +372 -0
  131. package/.bkit/core/engine/render/models.ts +323 -0
  132. package/.bkit/core/engine/render/parts.ts +38 -0
  133. package/.bkit/core/engine/render/trackers.ts +170 -0
  134. package/.bkit/core/engine/shared/egress.ts +345 -0
  135. package/.bkit/core/engine/shared/json.ts +16 -0
  136. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  137. package/.bkit/core/engine/shared/package-json.ts +29 -0
  138. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  139. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  140. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  141. package/.bkit/core/engine/shared/settings.ts +72 -0
  142. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  143. package/.bkit/core/engine/tools/wording.ts +748 -0
  144. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  145. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  146. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  147. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  148. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  149. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  150. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  155. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  156. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  157. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  158. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  159. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  160. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  161. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  162. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  165. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  166. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  169. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  170. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  171. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  172. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  173. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  174. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  175. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  176. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  178. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  179. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  180. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  181. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  182. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  185. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  186. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  187. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  188. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  189. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  190. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  191. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  192. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  193. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  194. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  195. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  196. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  197. package/.bkit/core/workflows/bkit-auto.md +121 -0
  198. package/.bkit/core/workflows/bkit-build.md +802 -0
  199. package/.bkit/core/workflows/bkit-debug.md +642 -0
  200. package/.bkit/core/workflows/bkit-design.md +495 -0
  201. package/.bkit/core/workflows/bkit-plan.md +510 -0
  202. package/.bkit/core/workflows/bkit-ship.md +650 -0
  203. package/.bkit/shared/.bkit/.env.example +108 -0
  204. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  205. package/.bkit/shared/.claude/settings.json +88 -0
  206. package/.bkit/shared/.codex/hooks.json +26 -0
  207. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  208. package/.bkit/shared/.cursor/hooks.json +26 -0
  209. package/.bkit/shared/.cursor/mcp.json +15 -0
  210. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  211. package/.bkit/shared/.gitattributes +37 -0
  212. package/.bkit/shared/.mcp.json +16 -0
  213. package/.bkit/shared/.opencode/opencode.json +62 -0
  214. package/.bkit/shared/CLAUDE.md +11 -0
  215. package/.bkit/shared/LICENSE.md +22 -0
  216. package/.bkit/shared/docs/architecture.md +19 -0
  217. package/.bkit/shared/docs/data-schema.md +19 -0
  218. package/.bkit/shared/docs/deployments.md +438 -0
  219. package/.bkit/shared/docs/design.md +39 -0
  220. package/.bkit/shared/docs/noise.md +19 -0
  221. package/.bkit/shared/docs/observability.md +25 -0
  222. package/.bkit/shared/docs/security.md +42 -0
  223. package/.bkit/shared/docs/setup.md +30 -0
  224. package/.bkit/shared/docs/technology.md +18 -0
  225. package/.bkit/shared/docs/testing.md +413 -0
  226. package/.bkit/shared/gitignore +92 -0
  227. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
  228. package/.bkit/templates/.cursor/Dockerfile +68 -0
  229. package/.bkit/templates/.cursor/environment.json +6 -0
  230. package/.bkit/templates/.cursor/settings.json +11 -0
  231. package/.bkit/templates/.envrc +7 -0
  232. package/.bkit/templates/.github/dependabot.yml +52 -0
  233. package/.bkit/templates/.github/renovate.json5 +239 -0
  234. package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
  235. package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
  236. package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
  237. package/.bkit/templates/.graphifyignore +108 -0
  238. package/.bkit/templates/.husky/pre-commit +16 -0
  239. package/.bkit/templates/.husky/pre-push +91 -0
  240. package/.bkit/templates/.lintstagedrc.json +3 -0
  241. package/.bkit/templates/.prettierignore +41 -0
  242. package/.bkit/templates/.serena/project.yml +243 -0
  243. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  244. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  245. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  246. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  247. package/.bkit/templates/.vale.ini +67 -0
  248. package/.bkit/templates/LICENSE.md +22 -0
  249. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  250. package/.bkit/templates/context/bkit-expo.md +186 -0
  251. package/.bkit/templates/context/bkit-github.md +79 -0
  252. package/.bkit/templates/context/bkit-inngest.md +45 -0
  253. package/.bkit/templates/context/bkit-maestro.md +76 -0
  254. package/.bkit/templates/context/bkit-playwright.md +62 -0
  255. package/.bkit/templates/context/bkit-resend.md +36 -0
  256. package/.bkit/templates/context/bkit-sentry.md +65 -0
  257. package/.bkit/templates/context/bkit-serena.md +33 -0
  258. package/.bkit/templates/context/bkit-stripe.md +36 -0
  259. package/.bkit/templates/context/bkit-supabase.md +59 -0
  260. package/.bkit/templates/context/bkit-tavily.md +49 -0
  261. package/.bkit/templates/context/bkit-vercel.md +64 -0
  262. package/.bkit/templates/docs/capabilities.md +72 -0
  263. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  264. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  266. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  268. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  280. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  281. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  282. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  283. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  284. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  286. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  288. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  289. package/.bkit/templates/slop-scan.config.json +120 -0
  290. package/CHANGELOG.md +1486 -0
  291. package/LICENSE.md +161 -0
  292. package/README.md +185 -2
  293. package/dist/checks/after/auth.js +232 -0
  294. package/dist/checks/after/ci-yml.js +718 -0
  295. package/dist/checks/after/github.js +400 -0
  296. package/dist/checks/after/index.js +447 -0
  297. package/dist/checks/after/managed.js +187 -0
  298. package/dist/checks/after/tools.js +351 -0
  299. package/dist/checks/after/vercel.js +102 -0
  300. package/dist/checks/before/context-fetch.js +426 -0
  301. package/dist/checks/before/env.js +173 -0
  302. package/dist/checks/before/files.js +185 -0
  303. package/dist/checks/before/index.js +162 -0
  304. package/dist/checks/before/mcp.js +111 -0
  305. package/dist/checks/before/repo.js +71 -0
  306. package/dist/checks/before/version.js +60 -0
  307. package/dist/checks/status-holes.js +393 -0
  308. package/dist/cli.js +692 -0
  309. package/dist/commands/analysis.js +325 -0
  310. package/dist/commands/ci/ci.js +438 -0
  311. package/dist/commands/comply.js +310 -0
  312. package/dist/commands/harvest.js +354 -0
  313. package/dist/commands/install/check.js +61 -0
  314. package/dist/commands/install/doctor.js +207 -0
  315. package/dist/commands/install/install.js +461 -0
  316. package/dist/commands/install/uninstall.js +815 -0
  317. package/dist/commands/install/upgrade.js +771 -0
  318. package/dist/commands/launch.js +118 -0
  319. package/dist/commands/lib.js +362 -0
  320. package/dist/commands/registry.js +50 -0
  321. package/dist/commands/setup/setup.js +158 -0
  322. package/dist/commands/telemetry.js +29 -0
  323. package/dist/commands/workflow/branches.js +1265 -0
  324. package/dist/commands/workflow/context.js +846 -0
  325. package/dist/commands/workflow/counters.js +227 -0
  326. package/dist/commands/workflow/fids.js +224 -0
  327. package/dist/commands/workflow/issues.js +585 -0
  328. package/dist/commands/workflow/ledgers.js +472 -0
  329. package/dist/commands/workflow/locks.js +364 -0
  330. package/dist/commands/workflow/prs.js +904 -0
  331. package/dist/commands/workflow/repo.js +199 -0
  332. package/dist/commands/workflow/roadmap.js +495 -0
  333. package/dist/commands/workflow/runs.js +1717 -0
  334. package/dist/commands/workflow/runtime.js +257 -0
  335. package/dist/commands/workflow/skills.js +110 -0
  336. package/dist/commands/workflow/status.js +392 -0
  337. package/dist/commands/workflow/steps.js +1093 -0
  338. package/dist/commands/workflow/tests.js +144 -0
  339. package/dist/commands/workflow/workflows.js +1342 -0
  340. package/dist/commands/workflow/workstreams.js +141 -0
  341. package/dist/commands/workflow/worktrees.js +473 -0
  342. package/dist/install/cloud-env.js +819 -0
  343. package/dist/install/managed-block.js +182 -0
  344. package/dist/install/manifest.js +376 -0
  345. package/dist/install/modules/claude.js +288 -0
  346. package/dist/install/modules/cloud.js +152 -0
  347. package/dist/install/modules/codex.js +193 -0
  348. package/dist/install/modules/core.js +511 -0
  349. package/dist/install/modules/cursor.js +186 -0
  350. package/dist/install/modules/index.js +152 -0
  351. package/dist/install/modules/opencode.js +504 -0
  352. package/dist/install/placeholders.js +87 -0
  353. package/dist/install/template-copies.js +106 -0
  354. package/dist/install/version-file.js +204 -0
  355. package/dist/install/write.js +342 -0
  356. package/dist/ledgers/clamp-log.js +27 -0
  357. package/dist/ledgers/status.js +156 -0
  358. package/dist/ledgers/telemetry.js +637 -0
  359. package/dist/render/hosts.js +339 -0
  360. package/dist/render/models.js +288 -0
  361. package/dist/render/parts.js +33 -0
  362. package/dist/render/trackers.js +135 -0
  363. package/dist/shared/egress.js +299 -0
  364. package/dist/shared/json.js +16 -0
  365. package/dist/shared/log-prefix.js +7 -0
  366. package/dist/shared/package-json.js +22 -0
  367. package/dist/shared/package-manager.js +32 -0
  368. package/dist/shared/package-roots.js +145 -0
  369. package/dist/shared/protected-paths.js +153 -0
  370. package/dist/shared/settings.js +44 -0
  371. package/dist/shared/timeouts.js +19 -0
  372. package/dist/tools/wording.js +680 -0
  373. package/package.json +101 -4
@@ -0,0 +1,186 @@
1
+ // install/modules/cursor.ts — the cursor host module: `.cursor/` agents, commands and config.
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { writeTier2, writeTier2JsonContained, ensureDir } from "../write.js";
5
+ import { stampManagedVersion } from "../version-file.js";
6
+ import { applyT1, applyT2, applyT3 } from "../../render/hosts.js";
7
+ import { getCoreRoot, getSharedRoot, getWorkflowsRoot, getPromptsRoot, } from "../../shared/package-roots.js";
8
+ import { DEFAULT_ISSUE_TRACKER } from "../manifest.js";
9
+ import { substituteWorkflow } from "../../render/trackers.js";
10
+ import { writeCursorCloudDoc, writeNetworkAllowlistArtifact, writeCursorCliPermissionsArtifact, } from "../cloud-env.js";
11
+ import { BKIT_PREFIX, installFile, listMdFiles, readInstallingVersion, removeOrphans, trackMirrorWrite, } from "./core.js";
12
+ import { reconcileMcpJson } from "./claude.js";
13
+ export function renderCursorAgentsCommands(ctx) {
14
+ const { dryRun, modelLookup, effortMap, logPrefix } = ctx;
15
+ const tag = dryRun ? "[dry-run] " : "";
16
+ const issueTracker = ctx.issueTracker ?? DEFAULT_ISSUE_TRACKER;
17
+ const version = ctx.version ?? readInstallingVersion();
18
+ const written = [];
19
+ // Commands: tracker block resolution → T1 → T2 → managed-version stamp (last)
20
+ {
21
+ const src = getWorkflowsRoot();
22
+ const dest = ".cursor/commands";
23
+ ensureDir(dest);
24
+ const files = listMdFiles(src, BKIT_PREFIX);
25
+ const sourceSet = new Set(files);
26
+ for (const f of files) {
27
+ const transform = (c) => stampManagedVersion(applyT2(applyT1(substituteWorkflow(c, issueTracker).output)), version);
28
+ if (installFile(path.join(src, f), path.join(dest, f), transform, dryRun)) {
29
+ const rel = path.join(dest, f);
30
+ console.log(`${logPrefix} ${tag}write: ${rel}`);
31
+ trackMirrorWrite(ctx, rel, written);
32
+ }
33
+ }
34
+ for (const f of removeOrphans(dest, sourceSet, dryRun, BKIT_PREFIX)) {
35
+ const rel = path.join(dest, f);
36
+ console.log(`${logPrefix} ${tag}delete orphan: ${rel}`);
37
+ trackMirrorWrite(ctx, rel, written);
38
+ }
39
+ }
40
+ // Agents: tracker block resolution → T3
41
+ {
42
+ const src = getPromptsRoot();
43
+ const dest = ".cursor/agents";
44
+ ensureDir(dest);
45
+ const files = listMdFiles(src, BKIT_PREFIX);
46
+ const sourceSet = new Set(files);
47
+ for (const f of files) {
48
+ const transform = (c) => stampManagedVersion(applyT3(substituteWorkflow(c, issueTracker).output, modelLookup, effortMap), version);
49
+ if (installFile(path.join(src, f), path.join(dest, f), transform, dryRun)) {
50
+ const rel = path.join(dest, f);
51
+ console.log(`${logPrefix} ${tag}write: ${rel}`);
52
+ trackMirrorWrite(ctx, rel, written);
53
+ }
54
+ }
55
+ for (const f of removeOrphans(dest, sourceSet, dryRun, BKIT_PREFIX)) {
56
+ const rel = path.join(dest, f);
57
+ console.log(`${logPrefix} ${tag}delete orphan: ${rel}`);
58
+ trackMirrorWrite(ctx, rel, written);
59
+ }
60
+ }
61
+ return written;
62
+ }
63
+ // ---------------------------------------------------------------------------
64
+ // runCursorModule — T1/T2/T3 transforms from .agents/ → .cursor/
65
+ // ---------------------------------------------------------------------------
66
+ export function runCursorModule(ctx) {
67
+ const { dryRun, tokens, advisories, ws, logPrefix } = ctx;
68
+ const tag = dryRun ? "[dry-run] " : "";
69
+ const issueTracker = ctx.issueTracker ?? DEFAULT_ISSUE_TRACKER;
70
+ // Source-rendered agents/commands (.cursor/agents T3 from .bkit/prompts, .cursor/commands
71
+ // T1/T2 from .bkit/workflows). Extracted to renderCursorAgentsCommands so `bkit upgrade`
72
+ // re-renders them identically — bkit-owned output, force-overwritten.
73
+ renderCursorAgentsCommands(ctx);
74
+ // Tier 2 JSON (contained) — deep-containment: hooks.json
75
+ const cursorShared = path.join(getSharedRoot(), ".cursor");
76
+ const cursorHooks = path.join(getCoreRoot(), ".cursor", "hooks");
77
+ const hooksSrc = path.join(cursorShared, "hooks.json");
78
+ const hooksDst = ".cursor/hooks.json";
79
+ if (fs.existsSync(hooksSrc)) {
80
+ const prevLen = ws.writes.length;
81
+ writeTier2JsonContained(hooksSrc, hooksDst, dryRun, ws);
82
+ if (ws.writes.length > prevLen) {
83
+ console.log(`${logPrefix} ${tag}cursor: ${hooksDst}`);
84
+ }
85
+ }
86
+ // Markered-text — manifest format: "markered-text" — preflight hook + shared rules.
87
+ // All use html-comment markers (# <!-- bkit:start --> / # <!-- bkit:end -->).
88
+ // Uses writeTier2 to update only the bkit-managed block; consumer content outside
89
+ // markers is preserved. `.cursor/Dockerfile` is a template (`.bkit/templates.md`).
90
+ {
91
+ const markeredFiles = [
92
+ [path.join(cursorHooks, "bkit-preflight.sh"), ".cursor/hooks/bkit-preflight.sh"],
93
+ [path.join(cursorShared, "rules", "bkit-rules.mdc"), ".cursor/rules/bkit-rules.mdc"],
94
+ ];
95
+ for (const [src, dst] of markeredFiles) {
96
+ if (!fs.existsSync(src))
97
+ continue;
98
+ const prevLen = ws.writes.length;
99
+ writeTier2(src, dst, tokens, "html-comment", dryRun, ws);
100
+ if (ws.writes.length > prevLen) {
101
+ console.log(`${logPrefix} ${tag}cursor: ${dst}`);
102
+ }
103
+ }
104
+ }
105
+ // markered-text (slash-comment) — Cursor destructive-op / secret-exposure guardrails
106
+ // (parity with Claude permissions deny/ask and OpenCode permission map). bkit owns
107
+ // only the decision engine between the markers; consumers own the stdin/stdout driver
108
+ // from first install onward, same split as the two GateGuard hooks.
109
+ {
110
+ const src = path.join(cursorHooks, "bkit-guardrails.cjs");
111
+ const dst = ".cursor/hooks/bkit-guardrails.cjs";
112
+ if (fs.existsSync(src)) {
113
+ const prevLen = ws.writes.length;
114
+ writeTier2(src, dst, tokens, "slash-comment", dryRun, ws);
115
+ if (ws.writes.length > prevLen) {
116
+ console.log(`${logPrefix} ${tag}cursor: ${dst}`);
117
+ }
118
+ }
119
+ }
120
+ // markered-text (slash-comment) — GateGuard advisory PreToolUse hook for Cursor.
121
+ // Same managed block as the Claude twin; the driver outside it adapts Cursor's
122
+ // payload (relative file_path, no subagent marker) and emits Cursor's shape.
123
+ {
124
+ const src = path.join(cursorHooks, "bkit-gateguard.cjs");
125
+ const dst = ".cursor/hooks/bkit-gateguard.cjs";
126
+ if (fs.existsSync(src)) {
127
+ const prevLen = ws.writes.length;
128
+ writeTier2(src, dst, tokens, "slash-comment", dryRun, ws);
129
+ if (ws.writes.length > prevLen) {
130
+ console.log(`${logPrefix} ${tag}cursor: ${dst}`);
131
+ }
132
+ }
133
+ }
134
+ // .cursor/mcp.json — same per-entry ownership as .mcp.json (reconcileMcpJson).
135
+ {
136
+ const cursorMcpSrc = path.join(cursorShared, "mcp.json");
137
+ const cursorMcpDst = path.join(".cursor", "mcp.json");
138
+ if (fs.existsSync(cursorMcpSrc)) {
139
+ const prevLen = ws.writes.length;
140
+ reconcileMcpJson(cursorMcpSrc, cursorMcpDst, issueTracker, dryRun, ws);
141
+ if (ws.writes.length > prevLen) {
142
+ console.log(`${logPrefix} ${tag}cursor: ${cursorMcpDst}`);
143
+ }
144
+ }
145
+ }
146
+ // Cursor-only runtime curl/wget allowlist (bkit-guardrails.cjs reads `.cursor/allowlist.json`).
147
+ // Same domain set as Claude WebFetch / OpenCode bash allows — sourced from tooling
148
+ // defaults ∪ consumer `allowed-domains`. Not under `.bkit/` (IDE-scoped artifact).
149
+ // Cursor CLI / cloud-agent MCP allows (`.cursor/cli.json`) from consumer `mcp-servers` —
150
+ // same server set as Claude `mcp__…` allows / OpenCode `<server>_*` permission rows.
151
+ for (const art of [
152
+ writeNetworkAllowlistArtifact(process.cwd(), dryRun),
153
+ writeCursorCliPermissionsArtifact(process.cwd(), dryRun),
154
+ ]) {
155
+ if (art.wrote) {
156
+ ws.writes.push({ path: art.path, action: "write" });
157
+ console.log(`${logPrefix} ${tag}cursor: ${art.path}`);
158
+ }
159
+ }
160
+ // Post-install advisory: macOS GUI-isolation note.
161
+ // MCP token placeholders (${BKIT_GH_TOKEN}, ${BKIT_LINEAR_API_KEY}, …) in .cursor/mcp.json are
162
+ // expanded by Cursor from the process environment. When Cursor is launched from the
163
+ // Dock/Finder (launchd), it does NOT inherit the login-shell / direnv env — tokens
164
+ // resolve empty and MCP calls fail with auth errors.
165
+ advisories.push({
166
+ id: "cursor-gui-isolation",
167
+ severity: "advisory",
168
+ detect: "Cursor's MCP token placeholders (${BKIT_GH_TOKEN}, …) resolve from process.env. " +
169
+ "Dock/Finder-launched Cursor does not inherit the login-shell / direnv env.",
170
+ action: "[cursor] Use `bkit cursor` to launch Cursor — it execs the binary directly with " +
171
+ ".bkit/.env merged into the environment so MCP tokens resolve correctly. " +
172
+ "Quit Cursor first (a running instance will not see the new env). " +
173
+ 'Alternative: `launchctl setenv BKIT_GH_TOKEN "$BKIT_GH_TOKEN"` (session-scoped; must re-run after reboot) ' +
174
+ "then relaunch from Dock.",
175
+ });
176
+ // Generated copy-paste-ready Cursor Background Agents setup doc — `.cursor/bkit-cloud.md`.
177
+ // Twin of `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL
178
+ // secret values resolved from `.envrc` under the Cursor env-var policy (Linear tracker
179
+ // adds BKIT_LINEAR_API_KEY, no autocompact knob). Never enters ws.writes / canonicalHashes /
180
+ // `bkit check` drift — values are machine-local and expected to differ. Skipped on
181
+ // dry-run (`bkit check`) so a read-only check never writes secrets. Upgrade regenerates
182
+ // it via the same helper (see runUpgrade caller).
183
+ if (!dryRun && writeCursorCloudDoc(process.cwd(), tokens, issueTracker)) {
184
+ console.log(`${logPrefix} ${tag}cursor: .cursor/bkit-cloud.md (generated — gitignored, holds resolved secrets)`);
185
+ }
186
+ }
@@ -0,0 +1,152 @@
1
+ // install/modules/index.ts — Module registry and per-module install functions.
2
+ // Each module function receives { dryRun, tokens, modelLookup, advisories, ws, … } (ModuleContext)
3
+ // and emits writes into the shared WriteSet.
4
+ //
5
+ // Dispatch order: core → claude → cursor → opencode → codex → cloud
6
+ // .bkit/version is written LAST — in postDispatch after ALL modules complete (MED-4).
7
+ import * as fs from "node:fs";
8
+ import * as path from "node:path";
9
+ import { getCoreRoot, getSharedRoot } from "../../shared/package-roots.js";
10
+ import { getInstallManifest } from "../manifest.js";
11
+ import { BKIT_PREFIX, listCoreTemplateFiles, listSharedTemplateFiles, runBkitDocs, runCoreModule, seedCorePackageJsonScripts, } from "./core.js";
12
+ import { renderClaudeAgentsCommands, runClaudeModule } from "./claude.js";
13
+ import { renderCursorAgentsCommands, runCursorModule } from "./cursor.js";
14
+ import { renderOpencodeAgentsCommands, runOpencodeModule } from "./opencode.js";
15
+ import { CODEX_SKILLS_DIR, renderCodexAgentsSkills, runCodexModule } from "./codex.js";
16
+ import { runCloudModule } from "./cloud.js";
17
+ // ---------------------------------------------------------------------------
18
+ // renderManagedOutputs — re-render the bkit-managed OUTPUT files that the
19
+ // `bkit upgrade` payload walk does NOT cover:
20
+ // host agents/commands (source-rendered), the `.bkit/*.md` canonical docs
21
+ // (runBkitDocs) and core's package.json scripts (seedCorePackageJsonScripts).
22
+ // `.bkit/prompts.md` is markered → runBkitDocs block-merges it (managed block
23
+ // refreshed, consumer `## Model Overrides` below bkit:end preserved).
24
+ //
25
+ // CRITICAL: docs stay single-source PACKAGE-side and are mirrored from
26
+ // getBkitDocsRoot() — they are NEVER relocated into the payload folders.
27
+ //
28
+ // Doc writes land in ctx.ws (runBkitDocs uses the tier writers) so the caller can
29
+ // refresh their canonicalHashes. Agent/command mirrors also push to ws.writes on
30
+ // would-write so `bkit check` exits 1 on content drift (not only managed-version
31
+ // marker stale). They are still re-rendered from source (not the template walk).
32
+ // `modules` should contain only hosts the consumer actually has installed.
33
+ // Returns every consumer-relative path written (for the upgrade summary).
34
+ // ---------------------------------------------------------------------------
35
+ export function renderManagedOutputs(modules, ctx) {
36
+ const written = [];
37
+ // Canonical .bkit/*.md docs — always (core is always present once installed).
38
+ const docsBefore = ctx.ws.writes.length;
39
+ runBkitDocs(ctx.dryRun, ctx.tokens, ctx.ws, ctx.logPrefix);
40
+ for (let i = docsBefore; i < ctx.ws.writes.length; i++) {
41
+ written.push(String(ctx.ws.writes[i].path));
42
+ }
43
+ // Core package.json scripts — the same pass install runs, so `bkit check` after a
44
+ // clean upgrade finds no missing gate name and no superseded script value.
45
+ written.push(...seedCorePackageJsonScripts(ctx));
46
+ // Host agents/commands — only for hosts the consumer has installed.
47
+ if (modules.has("claude"))
48
+ written.push(...renderClaudeAgentsCommands(ctx));
49
+ if (modules.has("cursor"))
50
+ written.push(...renderCursorAgentsCommands(ctx));
51
+ if (modules.has("opencode"))
52
+ written.push(...renderOpencodeAgentsCommands(ctx));
53
+ if (modules.has("codex"))
54
+ written.push(...renderCodexAgentsSkills(ctx));
55
+ return written;
56
+ }
57
+ /** Rendered mirror dirs: every `bkit-*` file of the given extension in each is bkit's. */
58
+ const RENDERED_MIRRORS = [
59
+ [".claude/agents", ".md"],
60
+ [".claude/commands", ".md"],
61
+ [".cursor/agents", ".md"],
62
+ [".cursor/commands", ".md"],
63
+ [".opencode/agents", ".md"],
64
+ [".opencode/commands", ".md"],
65
+ [".codex/agents", ".toml"],
66
+ ];
67
+ /**
68
+ * Every file bkit writes into `cwd` that carries the managed-version marker: the core
69
+ * payload (listCoreTemplateFiles), the non-JSON non-generated manifest entries of every
70
+ * module, and the rendered mirrors present on disk (agents, commands, the codex workflow
71
+ * skills). JSON files carry none. Paths only; whether each exists is the caller's to
72
+ * check.
73
+ */
74
+ export function listStampedFiles(cwd) {
75
+ const byPath = new Map();
76
+ const add = (p, scope) => {
77
+ const rel = path.normalize(p);
78
+ if (!byPath.has(rel))
79
+ byPath.set(rel, { path: rel, scope });
80
+ };
81
+ for (const { dst, scope } of listCoreTemplateFiles(getCoreRoot()))
82
+ add(dst, scope);
83
+ for (const { dst, scope } of listSharedTemplateFiles(getSharedRoot()))
84
+ add(dst, scope);
85
+ for (const entry of getInstallManifest()) {
86
+ if (entry.format === "json" || entry.generated)
87
+ continue;
88
+ if (entry.path === path.join(".bkit", "version"))
89
+ continue;
90
+ add(entry.path, entry.format === "markered-text" ? "block" : "whole");
91
+ }
92
+ for (const [dir, ext] of RENDERED_MIRRORS) {
93
+ const abs = path.join(cwd, dir);
94
+ if (!fs.existsSync(abs))
95
+ continue;
96
+ for (const f of fs.readdirSync(abs)) {
97
+ if (f.startsWith(BKIT_PREFIX) && f.endsWith(ext))
98
+ add(path.join(dir, f), "whole");
99
+ }
100
+ }
101
+ const skills = path.join(cwd, CODEX_SKILLS_DIR);
102
+ if (fs.existsSync(skills)) {
103
+ for (const d of fs.readdirSync(skills)) {
104
+ if (!d.startsWith(BKIT_PREFIX))
105
+ continue;
106
+ if (fs.existsSync(path.join(skills, d, "SKILL.md"))) {
107
+ add(path.join(CODEX_SKILLS_DIR, d, "SKILL.md"), "whole");
108
+ }
109
+ }
110
+ }
111
+ return [...byPath.values()];
112
+ }
113
+ // ---------------------------------------------------------------------------
114
+ // MODULE_REGISTRY — maps ModuleFlag → ModuleFn
115
+ // ---------------------------------------------------------------------------
116
+ export const MODULE_REGISTRY = {
117
+ core: runCoreModule,
118
+ claude: runClaudeModule,
119
+ cursor: runCursorModule,
120
+ opencode: runOpencodeModule,
121
+ codex: runCodexModule,
122
+ cloud: runCloudModule,
123
+ // "full" is never directly in the registry — resolveModules expands it to all modules
124
+ };
125
+ // Canonical dispatch order
126
+ export const MODULE_DISPATCH_ORDER = [
127
+ "core",
128
+ "claude",
129
+ "cursor",
130
+ "opencode",
131
+ "codex",
132
+ "cloud",
133
+ ];
134
+ /**
135
+ * Dispatch modules in canonical order.
136
+ * ctx.ws is populated by each module fn; ctx.advisories accumulates findings flushed by caller.
137
+ * After all modules complete, ctx.postDispatch callbacks are run in order.
138
+ */
139
+ export function dispatchModules(modules, ctx) {
140
+ for (const flag of MODULE_DISPATCH_ORDER) {
141
+ if (!modules.has(flag))
142
+ continue;
143
+ const fn = MODULE_REGISTRY[flag];
144
+ if (!fn)
145
+ continue;
146
+ fn(ctx);
147
+ }
148
+ // Run deferred finalisation callbacks (e.g. .bkit/version write) only after all modules succeed.
149
+ for (const cb of ctx.postDispatch) {
150
+ cb();
151
+ }
152
+ }