@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,61 @@
1
+ // commands/install/check.ts — `bkit check`: the parts only check runs. Check is install in
2
+ // dry-run mode (commands/install/install.ts runInstall); this file holds the installed-module
3
+ // detection that scopes its drift gate and the drift verdict.
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+ import { describeMissingOwnedHook } from "../../checks/after/managed.js";
7
+ import { LOG_PREFIX } from "../../shared/log-prefix.js";
8
+ /**
9
+ * Installed-module set, detected by sentinel-file presence. Always core, plus the installed
10
+ * subset of {claude, cursor, opencode, codex}. Two callers:
11
+ * - `bkit check` — scopes the drift gate, so a `--cursor`-only repo does not
12
+ * report `.claude/**` as drift.
13
+ * - `bkit upgrade` — scopes the template walk, so upgrade does NOT force-create files for a
14
+ * module the consumer never installed.
15
+ *
16
+ * opencode IS gated: the render inputs fall back to the INSTALLED provider/tracker
17
+ * (renderOpencodeProvider + the package.json tracker resolution), so an openrouter/opencode/…
18
+ * consumer is checked against its own config, and the dry-run path is read-only (installFile /
19
+ * writeTier1 / reconcileOpencodeJson honour dryRun; ensureDir is dryRun-gated). The remaining
20
+ * opt-in (cloud) stays out of the gate.
21
+ * Dependency-updater files are not modules: bkit never drift-checks them.
22
+ */
23
+ export function detectInstalledModules(cwd) {
24
+ const mods = new Set(["core"]);
25
+ if (fs.existsSync(path.join(cwd, ".claude", "agents")))
26
+ mods.add("claude");
27
+ if (fs.existsSync(path.join(cwd, ".cursor", "agents")))
28
+ mods.add("cursor");
29
+ if (fs.existsSync(path.join(cwd, ".opencode", "agents")))
30
+ mods.add("opencode");
31
+ if (fs.existsSync(path.join(cwd, ".codex", "agents")))
32
+ mods.add("codex");
33
+ return mods;
34
+ }
35
+ // Check mode: exit-1 on drift (totalWrites > 0). runInstall emits the banner first.
36
+ // Host agent/command mirrors push would-writes into ws.writes (content drift OR
37
+ // orphan delete). A stale managed-version marker on any stamped file ALSO surfaces as
38
+ // the bkit-managed-stale Phase-3 blocker, which counts as drift here. A missing owned
39
+ // hook file (owned-hook-missing) fails check too, by name. Other Phase-3 blockers
40
+ // are install-only.
41
+ //
42
+ // Gate on `severity === "blocker"`, NOT mere id-presence: detectManagedStale is
43
+ // branch-scoped (downgraded to `advisory` off main/dev), so on a feature branch the
44
+ // finding still surfaces in the checklist but does not exit-1. On main/dev (or a PR
45
+ // into them) it stays a blocker and hard-fails.
46
+ export function reportCheckDrift(postFindings, totalWrites, missingHooks) {
47
+ const managedStale = postFindings.some((f) => f.id === "bkit-managed-stale" && f.severity === "blocker");
48
+ if (totalWrites > 0 || managedStale || missingHooks.length > 0) {
49
+ if (totalWrites > 0) {
50
+ console.error(`${LOG_PREFIX} check: ${totalWrites} write(s) would occur — DRIFT DETECTED`);
51
+ }
52
+ if (managedStale) {
53
+ console.error(`${LOG_PREFIX} check: bkit-managed files are stale (managed-version marker drift) — ` +
54
+ `see the bkit-managed-stale blocker above. Run \`pnpm bkit upgrade\` (or re-run install) and commit.`);
55
+ }
56
+ for (const hook of missingHooks) {
57
+ console.error(`${LOG_PREFIX} check: ${describeMissingOwnedHook(hook)}`);
58
+ }
59
+ process.exit(1);
60
+ }
61
+ }
@@ -0,0 +1,207 @@
1
+ // commands/install/doctor.ts — `bkit doctor` (advisory scan, no managed-file writes) and
2
+ // `bkit status` (read-only host/provider status).
3
+ import * as fs from "node:fs";
4
+ import * as path from "node:path";
5
+ import { detectOpencodeProvider, detectOpencodeProviders, getInstallingVersion, } from "./install.js";
6
+ import { OPENCODE_PROVIDERS } from "../../shared/egress.js";
7
+ import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
8
+ import { getCoreRoot, getSharedRoot, getTemplatesRoot } from "../../shared/package-roots.js";
9
+ import { runPreflight } from "../../checks/before/index.js";
10
+ import { runPostInstallCheck, formatChecklist, writeAdvisoriesArtifact, } from "../../checks/after/index.js";
11
+ import { parseDotenv } from "../../install/cloud-env.js";
12
+ /**
13
+ * `bkit status` — read-only host/provider status.
14
+ * Reports current host+provider sampled from .opencode/opencode.json,
15
+ * .claude/, and .cursor/ presence. Writes nothing.
16
+ */
17
+ export function runStatus(cwd, logPrefix) {
18
+ console.log(`${logPrefix} Host/provider status (read-only — no writes)`);
19
+ console.log(`${logPrefix} Working directory: ${cwd}`);
20
+ // --- claude host ---
21
+ const claudeDir = path.join(cwd, ".claude");
22
+ const claudePresent = fs.existsSync(claudeDir);
23
+ const claudeSettingsPath = path.join(claudeDir, "settings.json");
24
+ let claudeModel = "claude (default)";
25
+ if (claudePresent && fs.existsSync(claudeSettingsPath)) {
26
+ try {
27
+ const settings = JSON.parse(fs.readFileSync(claudeSettingsPath, "utf-8"));
28
+ if (settings.model)
29
+ claudeModel = settings.model;
30
+ }
31
+ catch {
32
+ // best-effort
33
+ }
34
+ }
35
+ console.log(`${logPrefix} claude: ${claudePresent ? "INSTALLED" : "absent"} (provider: anthropic / ${claudeModel})`);
36
+ // --- cursor host ---
37
+ const cursorDir = path.join(cwd, ".cursor");
38
+ const cursorPresent = fs.existsSync(cursorDir);
39
+ console.log(`${logPrefix} cursor: ${cursorPresent ? "INSTALLED" : "absent"}`);
40
+ // --- opencode host ---
41
+ const opencodeDir = path.join(cwd, ".opencode");
42
+ const opencodePresent = fs.existsSync(opencodeDir);
43
+ // Resolve active provider (manifest-first; covers managed-auth gateways like opencode).
44
+ const activeOpencodeProvider = detectOpencodeProvider(cwd);
45
+ // All installed providers.
46
+ const allOpencodeProviders = detectOpencodeProviders(cwd);
47
+ let opencodeModel = "unknown";
48
+ const opencodeJsonPath = path.join(opencodeDir, "opencode.json");
49
+ if (opencodePresent && fs.existsSync(opencodeJsonPath)) {
50
+ try {
51
+ const cfg = JSON.parse(fs.readFileSync(opencodeJsonPath, "utf-8"));
52
+ if (cfg.model)
53
+ opencodeModel = cfg.model;
54
+ // Fallback: look for non-empty models map
55
+ if (opencodeModel === "unknown" && cfg.models) {
56
+ const modelKeys = Object.keys(cfg.models);
57
+ if (modelKeys.length > 0)
58
+ opencodeModel = `${modelKeys.length} model(s) configured`;
59
+ }
60
+ }
61
+ catch {
62
+ opencodeModel = "parse-error";
63
+ }
64
+ }
65
+ let opencodeProviderDisplay;
66
+ let providerLabel;
67
+ if (allOpencodeProviders.length > 1) {
68
+ // Multi-provider: list all, mark active
69
+ const activeKey = activeOpencodeProvider ?? allOpencodeProviders[0];
70
+ opencodeProviderDisplay = allOpencodeProviders
71
+ .map((p) => (p === activeKey ? `${p} (active)` : p))
72
+ .join(", ");
73
+ providerLabel = "providers";
74
+ }
75
+ else {
76
+ // Single provider: use singular label
77
+ opencodeProviderDisplay = activeOpencodeProvider ?? allOpencodeProviders[0] ?? "unknown";
78
+ providerLabel = "provider";
79
+ }
80
+ // --- codex host ---
81
+ const codexDir = path.join(cwd, ".codex");
82
+ const codexPresent = fs.existsSync(codexDir);
83
+ const opencodeStatus = opencodePresent
84
+ ? `INSTALLED (${providerLabel}: ${opencodeProviderDisplay} / model: ${opencodeModel})`
85
+ : "absent (run: bkit install --opencode=<provider>)";
86
+ console.log(`${logPrefix} opencode: ${opencodeStatus}`);
87
+ console.log(`${logPrefix} codex: ${codexPresent ? "INSTALLED (provider: openai)" : "absent (run: bkit install --codex)"}`);
88
+ // --- summary ---
89
+ const installedHosts = [
90
+ claudePresent ? "claude" : null,
91
+ cursorPresent ? "cursor" : null,
92
+ opencodePresent ? "opencode" : null,
93
+ codexPresent ? "codex" : null,
94
+ ].filter(Boolean);
95
+ console.log(`${logPrefix} Installed hosts: ${installedHosts.length > 0 ? installedHosts.join(", ") : "none"}`);
96
+ }
97
+ export async function runDoctor(modules, opencodeProvider) {
98
+ setLogPrefix("[bkit-doctor]");
99
+ console.log(`${LOG_PREFIX} Running advisory scan (no managed-file writes)`);
100
+ console.log(`${LOG_PREFIX} Payload roots: core=${getCoreRoot()} shared=${getSharedRoot()} templates=${getTemplatesRoot()}`);
101
+ const { blockers, advisories: preflightAdvisories } = runPreflight(modules, process.cwd());
102
+ const allFindings = runPostInstallCheck([...preflightAdvisories, ...blockers], process.cwd());
103
+ // Broken install: the opencode host is on disk but neither provider signal survives.
104
+ // `bkit check` and `bkit upgrade` exit 1 with the fix; doctor reports it here and does
105
+ // not enforce.
106
+ if (fs.existsSync(path.join(process.cwd(), ".opencode"))) {
107
+ if (detectOpencodeProvider(process.cwd()) === null) {
108
+ allFindings.push({
109
+ id: "opencode-provider-missing",
110
+ severity: "blocker",
111
+ detect: "`.opencode/` is present but no provider is recorded — neither package.json `bkit.opencodeProvider` nor an `opencode.json` provider block.",
112
+ action: `Re-run \`bkit install --opencode=<provider>\` (${OPENCODE_PROVIDERS.join(", ")}). Until then \`bkit check\` and \`bkit upgrade\` exit 1 rather than render every agent pin against a substitute provider.`,
113
+ });
114
+ }
115
+ }
116
+ const banner = formatChecklist(allFindings);
117
+ if (banner) {
118
+ console.log(banner);
119
+ }
120
+ else {
121
+ console.log(`${LOG_PREFIX} No advisories found.`);
122
+ }
123
+ writeAdvisoriesArtifact(allFindings, {
124
+ cwd: process.cwd(),
125
+ mode: "doctor",
126
+ version: getInstallingVersion(),
127
+ logPrefix: LOG_PREFIX,
128
+ });
129
+ // opencode host diagnostics: report required tools and cred presence per provider.
130
+ // Never echoes key values — only reports present/absent.
131
+ const opencodeDir = path.join(process.cwd(), ".opencode");
132
+ if (fs.existsSync(opencodeDir) || modules.has("opencode")) {
133
+ console.log(`${LOG_PREFIX} --- opencode host diagnostics ---`);
134
+ // Check opencode binary
135
+ const { spawnSync: spawnSyncLocal } = await import("node:child_process");
136
+ const whichResult = spawnSyncLocal("which", ["opencode"], { encoding: "utf-8" });
137
+ const opencodeInstalled = whichResult.status === 0 && whichResult.stdout.trim().length > 0;
138
+ console.log(`${LOG_PREFIX} opencode binary: ${opencodeInstalled ? "FOUND (" + whichResult.stdout.trim() + ")" : "NOT FOUND (install opencode first)"}`);
139
+ // Resolve provider: manifest-first (detectOpencodeProvider) so managed-auth gateways
140
+ // (opencode — no provider block beyond the minimal apiKey entry) are still detected;
141
+ // the `--opencode=` flag, if given this run, overrides.
142
+ let detectedProvider = detectOpencodeProvider(process.cwd());
143
+ if (opencodeProvider)
144
+ detectedProvider = opencodeProvider;
145
+ // Multi-provider: all installed providers. bkit.opencodeProviders when populated,
146
+ // else the single detected provider.
147
+ const allProviders = detectOpencodeProviders(process.cwd());
148
+ const activeProvider = detectedProvider ?? allProviders[0] ?? null;
149
+ const providersToCheck = allProviders.length > 0 ? allProviders : activeProvider ? [activeProvider] : [];
150
+ // Per-provider cred check (present/absent only — no value echoed).
151
+ // Every provider names one API key. Any provider absent here falls back to
152
+ // `BKIT_${PROVIDER}_API_KEY` (see below).
153
+ const PROVIDER_KEYS = {
154
+ openrouter: ["BKIT_OPENROUTER_API_KEY"],
155
+ ollama: ["BKIT_OLLAMA_API_KEY"], // Ollama cloud endpoint (ollama.com)
156
+ "opencode-zen": ["BKIT_OPENCODE_API_KEY"], // opencode-native gateway (Zen; https://opencode.ai/zen/v1)
157
+ "opencode-go": ["BKIT_OPENCODE_API_KEY"], // opencode-native gateway (Go; https://opencode.ai/zen/go/v1)
158
+ };
159
+ if (providersToCheck.length === 0) {
160
+ console.log(`${LOG_PREFIX} Provider not detected — run \`bkit install --opencode=<provider>\` first`);
161
+ }
162
+ else {
163
+ for (const provider of providersToCheck) {
164
+ const roleLabel = provider === activeProvider ? "(active)" : "(installed)";
165
+ console.log(`${LOG_PREFIX} --- ${provider} ${roleLabel} ---`);
166
+ const keys = PROVIDER_KEYS[provider] ?? [`BKIT_${provider.toUpperCase()}_API_KEY`];
167
+ for (const key of keys) {
168
+ const present = Boolean(process.env[key] && process.env[key].trim().length > 0);
169
+ console.log(`${LOG_PREFIX} ${key}: ${present ? "PRESENT" : "ABSENT (required for provider " + provider + ")"}`);
170
+ }
171
+ }
172
+ }
173
+ }
174
+ // GUI-isolation check: flag any .bkit/.env keys that are set (non-empty) in the
175
+ // file but absent or empty in process.env. This happens when the app was launched
176
+ // via Dock/Finder (launchd) rather than from a direnv-active terminal — the env
177
+ // vars never make it into the process. The finding points at `bkit cursor` /
178
+ // `bkit opencode`.
179
+ const bkitEnvPath = path.join(process.cwd(), ".bkit", ".env");
180
+ if (fs.existsSync(bkitEnvPath)) {
181
+ const fileVars = new Map(parseDotenv(fs.readFileSync(bkitEnvPath, "utf-8")));
182
+ const guiMissing = [];
183
+ for (const [key, value] of fileVars) {
184
+ if (!value || value.trim() === "")
185
+ continue; // skip blank placeholders
186
+ const inProcess = process.env[key] && process.env[key].trim().length > 0;
187
+ if (!inProcess)
188
+ guiMissing.push(key);
189
+ }
190
+ if (guiMissing.length > 0) {
191
+ console.log(`${LOG_PREFIX} --- GUI-isolation advisory ---\n` +
192
+ `${LOG_PREFIX} The following keys are set in .bkit/.env but are NOT present in this\n` +
193
+ `${LOG_PREFIX} process environment (GUI apps launched from Dock/Finder do not\n` +
194
+ `${LOG_PREFIX} inherit the login shell / direnv env):\n` +
195
+ guiMissing.map((k) => `${LOG_PREFIX} ${k}`).join("\n") +
196
+ "\n" +
197
+ `${LOG_PREFIX} Fix: launch the app via \`bkit cursor\` or \`bkit opencode\` — these\n` +
198
+ `${LOG_PREFIX} verbs exec the binary directly with .bkit/.env merged in.`);
199
+ }
200
+ else {
201
+ const nonBlankCount = [...fileVars.values()].filter((v) => v.trim() !== "").length;
202
+ if (nonBlankCount > 0) {
203
+ console.log(`${LOG_PREFIX} GUI-isolation: all .bkit/.env keys are present in this process env (OK)`);
204
+ }
205
+ }
206
+ }
207
+ }