@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,600 @@
1
+ // install/modules/core.ts — the core module: the core payload blocks, the canonical
2
+ // `.bkit/*.md` docs, package.json gate scripts and `.bkit/version` (written last, in
3
+ // postDispatch). Also the file helpers every host renderer shares.
4
+
5
+ import * as fs from "node:fs";
6
+ import * as path from "node:path";
7
+ import { writeTier1, writeTier2, ensurePackageJsonScripts, type WriteSet } from "../write.js";
8
+ import {
9
+ readBkitVersion,
10
+ writeBkitVersion,
11
+ hashFile,
12
+ mergeCanonicalHashes,
13
+ } from "../version-file.js";
14
+ import type { TokenMap } from "../placeholders.js";
15
+ import { listFilesRecursive, syncTemplateCopies } from "../template-copies.js";
16
+ import type { PreflightFinding } from "../../checks/before/index.js";
17
+ import {
18
+ getPkgRoot,
19
+ getCoreRoot,
20
+ getSharedRoot,
21
+ getBkitDocsRoot,
22
+ TEMPLATE_COPIES_DIR,
23
+ } from "../../shared/package-roots.js";
24
+ import { getInstallManifest, BKIT_GATE_SCRIPTS, BKIT_OPTIONAL_GATES } from "../manifest.js";
25
+ import type { ModuleContext } from "./index.js";
26
+
27
+ export function listMdFiles(dir: string, prefix?: string): string[] {
28
+ if (!fs.existsSync(dir)) return [];
29
+ return fs
30
+ .readdirSync(dir)
31
+ .filter((f) => f.endsWith(".md"))
32
+ .filter((f) => (prefix ? f.startsWith(prefix) : true));
33
+ }
34
+
35
+ export function installFile(
36
+ srcPath: string,
37
+ destPath: string,
38
+ transform: ((content: string) => string) | null,
39
+ dryRun: boolean,
40
+ ): boolean {
41
+ if (!transform) {
42
+ if (fs.existsSync(destPath)) {
43
+ const src = fs.readFileSync(srcPath);
44
+ const dest = fs.readFileSync(destPath);
45
+ if (src.equals(dest)) return false;
46
+ }
47
+ if (!dryRun) fs.copyFileSync(srcPath, destPath);
48
+ return true;
49
+ }
50
+
51
+ const src = fs.readFileSync(srcPath, "utf-8");
52
+ const transformed = transform(src);
53
+ if (fs.existsSync(destPath)) {
54
+ const existing = fs.readFileSync(destPath, "utf-8");
55
+ if (existing === transformed) return false;
56
+ }
57
+ if (!dryRun) fs.writeFileSync(destPath, transformed, "utf-8");
58
+ return true;
59
+ }
60
+
61
+ // Hard allowlist: orphan pruning may ONLY remove files from these generated IDE
62
+ // mirror dirs. Mirror SOURCES live package-side under `.bkit/{workflows,prompts}`.
63
+ const ORPHAN_PRUNE_DIRS = [
64
+ ".claude/agents",
65
+ ".claude/commands",
66
+ ".cursor/agents",
67
+ ".cursor/commands",
68
+ ] as const;
69
+
70
+ export function removeOrphans(
71
+ destDir: string,
72
+ sourceFiles: Set<string>,
73
+ dryRun: boolean,
74
+ prefix?: string,
75
+ ): string[] {
76
+ const resolved = path.resolve(destDir);
77
+ if (!ORPHAN_PRUNE_DIRS.some((d) => path.resolve(d) === resolved)) {
78
+ throw new Error(`removeOrphans: refusing orphan removal outside allowlist: ${destDir}`);
79
+ }
80
+ if (!fs.existsSync(destDir)) return [];
81
+ const removed: string[] = [];
82
+ for (const f of fs.readdirSync(destDir)) {
83
+ if (!f.endsWith(".md")) continue;
84
+ if (prefix && !f.startsWith(prefix)) continue;
85
+ if (!sourceFiles.has(f)) {
86
+ if (!dryRun) fs.rmSync(path.join(destDir, f));
87
+ removed.push(f);
88
+ }
89
+ }
90
+ return removed;
91
+ }
92
+
93
+ // ---------------------------------------------------------------------------
94
+ // Core payload — the files install writes from `core/`, at their
95
+ // folder-relative dest paths. The package-only subtrees (engine/, workflows/,
96
+ // prompts/, .bkit/, hooks/), the root LICENSE.md and the shared/ and
97
+ // templates/ payloads are NOT part of this walk: the host modules write their
98
+ // own hook files (sourced from `core/`), and `runBkitDocs` mirrors the
99
+ // reference docs.
100
+ // ---------------------------------------------------------------------------
101
+
102
+ /** A core-owned payload file and how install writes it. */
103
+ interface CoreTemplateFile {
104
+ /** Absolute source path. */
105
+ src: string;
106
+ /** Consumer-relative destination. */
107
+ dst: string;
108
+ /** `block`: writeTier2 refreshes the managed block. `whole`: writeTier1. */
109
+ scope: "block" | "whole";
110
+ /** Block-scope marker style. */
111
+ marker: "html-comment" | "slash-comment";
112
+ }
113
+
114
+ /** The markered-text `.agents/*.md` blocks core owns. */
115
+ const CORE_AGENT_FILES = ["context.md", "docs.md", "rules.md", "skills.md"] as const;
116
+
117
+ // The two shared-root files core writes: stored in `shared/`, owned by the core
118
+ // manifest, written as html-comment managed blocks.
119
+ const CORE_SHARED_FILES: ReadonlyArray<readonly [rel: string, dst: string]> = [
120
+ ["gitignore", ".gitignore"],
121
+ [".gitattributes", ".gitattributes"],
122
+ ];
123
+
124
+ // ---------------------------------------------------------------------------
125
+ // guardCoreRoot — fail-loud guard for the resolved core payload root.
126
+ // Exported so tests can inject an arbitrary (non-existent) path and assert
127
+ // the guard fires for ANY missing root — not just the literal ".bkit/core"
128
+ // string. This keeps the assertion valid across any future path changes.
129
+ //
130
+ // Called by runCoreTemplates (below) before any FS access.
131
+ // ---------------------------------------------------------------------------
132
+
133
+ export function guardCoreRoot(root: string, logPrefix = "[bkit-modules]"): void {
134
+ if (!fs.existsSync(root)) {
135
+ console.error(`${logPrefix} Core root not found at ${root} — package corrupt?`);
136
+ process.exit(1);
137
+ }
138
+ }
139
+
140
+ /**
141
+ * The core-owned payload files, sourced from `root` (defaults to the resolved
142
+ * core root). Every file under `core/docs/templates/` is included; `AGENTS.md`
143
+ * and the `.agents/*.md` doctrine files are the block-merged rest.
144
+ */
145
+ export function listCoreTemplateFiles(root: string = getCoreRoot()): CoreTemplateFile[] {
146
+ const out: CoreTemplateFile[] = [];
147
+ const agentsDir = path.join(root, ".agents");
148
+ for (const name of CORE_AGENT_FILES) {
149
+ const src = path.join(agentsDir, name);
150
+ if (fs.existsSync(src)) {
151
+ out.push({ src, dst: path.join(".agents", name), scope: "block", marker: "html-comment" });
152
+ }
153
+ }
154
+ const agentsMd = path.join(root, "AGENTS.md");
155
+ if (fs.existsSync(agentsMd)) {
156
+ out.push({ src: agentsMd, dst: "AGENTS.md", scope: "block", marker: "html-comment" });
157
+ }
158
+ for (const abs of listFilesRecursive(path.join(root, "docs", "templates"))) {
159
+ out.push({
160
+ src: abs,
161
+ dst: path.relative(root, abs),
162
+ scope: "block",
163
+ marker: "html-comment",
164
+ });
165
+ }
166
+ return out;
167
+ }
168
+
169
+ /**
170
+ * The shared payload files core writes, sourced from `root` (defaults to the
171
+ * resolved shared root): the `docs/*.md` managed blocks and the two shared-root
172
+ * files the core manifest owns.
173
+ */
174
+ export function listSharedTemplateFiles(root: string = getSharedRoot()): CoreTemplateFile[] {
175
+ const out: CoreTemplateFile[] = [];
176
+ for (const [rel, dst] of CORE_SHARED_FILES) {
177
+ const src = path.join(root, rel);
178
+ if (fs.existsSync(src)) out.push({ src, dst, scope: "block", marker: "html-comment" });
179
+ }
180
+ for (const name of listMdFiles(path.join(root, "docs"))) {
181
+ out.push({
182
+ src: path.join(root, "docs", name),
183
+ dst: path.join("docs", name),
184
+ scope: "block",
185
+ marker: "html-comment",
186
+ });
187
+ }
188
+ return out;
189
+ }
190
+
191
+ function runCoreTemplates(
192
+ dryRun: boolean,
193
+ tokens: TokenMap,
194
+ ws: WriteSet,
195
+ logPrefix: string,
196
+ ): void {
197
+ const root = getCoreRoot();
198
+ guardCoreRoot(root, logPrefix);
199
+ const tag = dryRun ? "[dry-run] " : "";
200
+ const files = [...listCoreTemplateFiles(root), ...listSharedTemplateFiles()];
201
+ for (const { src, dst, scope, marker } of files) {
202
+ const prevLen = ws.writes.length;
203
+ if (scope === "whole") writeTier1(src, dst, tokens, dryRun, ws);
204
+ else writeTier2(src, dst, tokens, marker, dryRun, ws);
205
+ if (ws.writes.length > prevLen) {
206
+ console.log(`${logPrefix} ${tag}core: ${dst}`);
207
+ }
208
+ }
209
+ }
210
+
211
+ // ---------------------------------------------------------------------------
212
+ // runCoreModule — core templates + .bkit/version (LAST)
213
+ // ---------------------------------------------------------------------------
214
+
215
+ // Canonical bkit-authored reference docs that live package-side under
216
+ // `.bkit/core/.bkit/`. They are read from there at runtime (getBkitDocsRoot) AND
217
+ // mirrored into the consumer's `.bkit/` on every install so a consumer can read them
218
+ // in-repo without spelunking node_modules. Force-overwritten (Tier 1) — bkit owns
219
+ // them, so a consumer edit is replaced. Source of truth is the package's own
220
+ // `.bkit/core/.bkit/<name>`. (`advisories.md` is a regenerated runtime artifact,
221
+ // `wording.md` is repo-only tooling and `friction.md` is a consumer-owned seed —
222
+ // none belongs here. `LICENSE.md` is the PolyForm notice that travels with every
223
+ // file bkit writes: PolyForm's Notices section requires a passed-on copy to carry
224
+ // the terms or their URL and the Required Notice line.)
225
+ export const BKIT_CANONICAL_DOCS = [
226
+ "cloud.md",
227
+ "comparison.md",
228
+ "install.md",
229
+ "jsonl.md",
230
+ "LICENSE.md",
231
+ "providers.md",
232
+ "prompts.md",
233
+ "templates.md",
234
+ "trackers.md",
235
+ "workflows.md",
236
+ "README.md",
237
+ ] as const;
238
+
239
+ // Mirror the package's canonical `.bkit/*.md` docs into the consumer's `.bkit/`.
240
+ // Tier 1 (force-overwrite + ws-tracked for dry-run/install parity). Each source carries
241
+ // the `{{BKIT_MANAGED_MARKER}}` token. Skipped in dogfood: the consumer destination
242
+ // resolves to the repo's own installed copies, never the package source.
243
+ export function runBkitDocs(
244
+ dryRun: boolean,
245
+ tokens: TokenMap,
246
+ ws: WriteSet,
247
+ logPrefix: string,
248
+ ): void {
249
+ const tag = dryRun ? "[dry-run] " : "";
250
+ const docsRoot = getBkitDocsRoot();
251
+ // Per-doc write strategy from the manifest: markered-text docs (e.g. prompts.md,
252
+ // which carries the consumer-owned `## Model Overrides` section below `bkit:end`)
253
+ // are block-merged so consumer content survives; the rest are force-overwritten.
254
+ const formatByPath = new Map(getInstallManifest().map((e) => [e.path, e.format]));
255
+ for (const name of BKIT_CANONICAL_DOCS) {
256
+ const srcPath = path.join(docsRoot, name);
257
+ // A doc missing from a partial/corrupt package is skipped (writeTier1 throws on a
258
+ // missing src).
259
+ if (!fs.existsSync(srcPath)) continue;
260
+ const dstPath = path.join(".bkit", name);
261
+ const prevLen = ws.writes.length;
262
+ if (formatByPath.get(path.join(".bkit", name)) === "markered-text") {
263
+ writeTier2(srcPath, dstPath, tokens, "html-comment", dryRun, ws);
264
+ } else {
265
+ writeTier1(srcPath, dstPath, tokens, dryRun, ws);
266
+ }
267
+ if (ws.writes.length > prevLen) {
268
+ console.log(`${logPrefix} ${tag}core: ${dstPath}`);
269
+ }
270
+ }
271
+ }
272
+
273
+ // ---------------------------------------------------------------------------
274
+ // Source-rendered host outputs — agents (.agents/prompts source) and commands
275
+ // (.bkit/workflows source). Extracted from the host module functions so BOTH
276
+ // `bkit install` (via the modules) AND `bkit upgrade` (via renderManagedOutputs)
277
+ // render them identically — a single source of truth that can never diverge.
278
+ //
279
+ // These are bkit-OWNED output files: force-overwritten (installFile), never
280
+ // drift-detected, never consumer config. They are NOT recorded in canonicalHashes
281
+ // (installFile does not touch ws), matching the install path exactly. Each returns
282
+ // the consumer-relative dest paths it wrote (for the upgrade summary).
283
+ // ---------------------------------------------------------------------------
284
+
285
+ // ---------------------------------------------------------------------------
286
+ // Managed-version stamping. The marker shape (stampManagedVersion + regexes) lives
287
+ // in install/version-file.ts, shared by the renderer and the `bkit check` detector. Here we
288
+ // only resolve WHICH version to stamp: ctx.version (set by install/upgrade) with a
289
+ // package-root fallback.
290
+ // ---------------------------------------------------------------------------
291
+
292
+ /**
293
+ * Best-effort read of the installing bkit version from the package root's
294
+ * package.json. Mirrors getInstallingVersion in commands/install/install.ts; duplicated here
295
+ * (not imported) to avoid a modules → install dependency cycle. Returns "0.0.0"
296
+ * when unreadable — the same non-fatal fallback the install side uses.
297
+ */
298
+ export function readInstallingVersion(): string {
299
+ try {
300
+ const pkgPath = path.join(getPkgRoot(), "package.json");
301
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as { version?: string };
302
+ return pkg.version ?? "0.0.0";
303
+ } catch {
304
+ return "0.0.0";
305
+ }
306
+ }
307
+
308
+ /** Record a host mirror would-write so `bkit check` exits 1 on content drift. */
309
+ export function trackMirrorWrite(ctx: ModuleContext, relPath: string, written: string[]): void {
310
+ written.push(relPath);
311
+ ctx.ws.writes.push({ path: relPath, action: "write" });
312
+ }
313
+
314
+ /**
315
+ * The package.json scripts core keeps: the `bkit:gate:*` / `bkit:deps:*` names every
316
+ * workflow, prompt and hook runs, seeded add-if-missing (a name already declared is
317
+ * never touched, whatever its value). Install (runCoreModule) and upgrade
318
+ * (renderManagedOutputs) both run it, so a
319
+ * clean upgrade leaves `bkit check` nothing to write. A missing gate name is a write,
320
+ * so `bkit check` reports it. A missing or malformed package.json is preflight's to
321
+ * report. Returns the paths written.
322
+ */
323
+ export function seedCorePackageJsonScripts(
324
+ ctx: Pick<ModuleContext, "dryRun" | "ws" | "logPrefix">,
325
+ ): string[] {
326
+ const { dryRun, ws, logPrefix } = ctx;
327
+ const tag = dryRun ? "[dry-run] " : "";
328
+ const written: string[] = [];
329
+
330
+ const gates = ensurePackageJsonScripts({ ...BKIT_GATE_SCRIPTS }, dryRun, ws);
331
+ if (gates.added.length > 0) {
332
+ written.push("package.json");
333
+ console.log(`${logPrefix} ${tag}core: package.json scripts added [${gates.added.join(", ")}]`);
334
+ }
335
+ return written;
336
+ }
337
+
338
+ // Tokens that follow `pnpm` in a gate value but are not package.json scripts: the
339
+ // package manager's own subcommands (`install` in bkit:gate:install-static-unit-build,
340
+ // `audit` / `outdated` in the bkit:deps:* pair) and node_modules binaries pnpm resolves
341
+ // directly (`lint-staged` in bkit:gate:format). None can be "missing" as a script.
342
+ const PNPM_NOT_A_SCRIPT = new Set([
343
+ "install",
344
+ "run",
345
+ "exec",
346
+ "dlx",
347
+ "audit",
348
+ "outdated",
349
+ "lint-staged",
350
+ ]);
351
+
352
+ /**
353
+ * Advisories for the `bkit:gate:*` scripts: the scripts a still-default gate
354
+ * chains that package.json does not declare, and the deeper test tiers the repo has
355
+ * but no gate runs. Read-only; an absent or unparseable package.json yields none.
356
+ */
357
+ export function detectGateAdvisories(cwd: string): PreflightFinding[] {
358
+ let declared: Record<string, string>;
359
+ try {
360
+ const pkg = JSON.parse(fs.readFileSync(path.join(cwd, "package.json"), "utf-8")) as {
361
+ scripts?: Record<string, string>;
362
+ };
363
+ declared = pkg.scripts ?? {};
364
+ } catch {
365
+ // Absent or malformed package.json — preflight's no-package-json /
366
+ // malformed-package-json blockers already report it.
367
+ return [];
368
+ }
369
+ const findings: PreflightFinding[] = [];
370
+
371
+ // Every script a seeded gate default chains MUST exist, or the gate dies on the first
372
+ // missing one and the workflow reads that as a real failure. Checked only where the
373
+ // value is still bkit's default — a consumer who rewrote the gate owns what it calls.
374
+ const missing = new Set<string>();
375
+ for (const [name, seeded] of Object.entries(BKIT_GATE_SCRIPTS)) {
376
+ if (declared[name] !== seeded) continue;
377
+ for (const [, called] of seeded.matchAll(/\bpnpm ([\w:-]+)/g)) {
378
+ if (PNPM_NOT_A_SCRIPT.has(called)) continue;
379
+ if (!(called in declared) && !(called in BKIT_GATE_SCRIPTS)) missing.add(called);
380
+ }
381
+ }
382
+ if (missing.size > 0) {
383
+ const names = [...missing].sort().map((n) => `\`${n}\``);
384
+ findings.push({
385
+ id: "gate-missing-called-scripts",
386
+ severity: "advisory",
387
+ detect: `The bkit:gate scripts call scripts package.json does not declare: ${names.join(", ")}.`,
388
+ action: `Every bkit workflow runs a \`bkit:gate*\` script, so a missing link fails the whole gate. Add ${names.join(", ")} to package.json (\`.bkit/templates.md\` lists the tool scripts and the devDeps they need), or edit the \`bkit:gate*\` scripts to drop what this repo does not have.`,
389
+ });
390
+ }
391
+
392
+ // A repo that HAS a deeper tier but declares no gate for it is gated at
393
+ // bkit:gate:static-unit by both /bkit-build and /bkit-debug. bkit does not seed these
394
+ // gates; it detects the mismatch and hands over the line to paste.
395
+ const unwired: string[] = [];
396
+ for (const { gate, parent, declaredBy } of BKIT_OPTIONAL_GATES) {
397
+ const tierCall = declaredBy.find((s) => s in declared);
398
+ if (tierCall === undefined || gate in declared) continue;
399
+ unwired.push(` "${gate}": "pnpm ${parent} && pnpm ${tierCall}"`);
400
+ }
401
+ if (unwired.length > 0) {
402
+ findings.push({
403
+ id: "gate-tier-not-wired",
404
+ severity: "advisory",
405
+ detect:
406
+ "package.json declares deeper test tiers than any `bkit:gate*` script runs, so `/bkit-build` and `/bkit-debug` gate at `bkit:gate:static-unit` and never execute them.",
407
+ action:
408
+ "Each workflow runs the DEEPEST gate you declare; an undeclared one is skipped, never guessed. Add the gates you want the agent loop to run:\n\n" +
409
+ unwired.join("\n") +
410
+ "\n\nOrder matters — each chains the one above it. Omit a level deliberately to keep it CI-only (E2E in the build loop costs a production build on every remediation attempt). `.bkit/templates.md` lists the tool scripts the gates chain.",
411
+ });
412
+ }
413
+ return findings;
414
+ }
415
+
416
+ /** One command that cannot fail: `true`, `:`, `exit 0`, or an `echo`. */
417
+ const NOOP_COMMAND = /^(?:true|:|exit 0|echo(?:\s.*)?)$/;
418
+
419
+ /** Whether a script value checks nothing: empty, or only no-op commands chained. */
420
+ export function isNoopScript(value: string): boolean {
421
+ return value
422
+ .split(/&&|\|\||;|\n/)
423
+ .map((part) => part.trim())
424
+ .every((part) => part === "" || NOOP_COMMAND.test(part));
425
+ }
426
+
427
+ /**
428
+ * Advisory for every `bkit:gate:*` script that is empty or a no-op: it checks nothing,
429
+ * so every agent run and push passes it. Warn-only, at install and `bkit check`, on
430
+ * every branch. Read-only; an absent or unparseable package.json yields none.
431
+ */
432
+ export function detectNoopGates(cwd: string): PreflightFinding[] {
433
+ let declared: Record<string, unknown>;
434
+ try {
435
+ const pkg = JSON.parse(fs.readFileSync(path.join(cwd, "package.json"), "utf-8")) as {
436
+ scripts?: Record<string, unknown>;
437
+ };
438
+ declared = pkg.scripts ?? {};
439
+ } catch {
440
+ // Absent or malformed package.json — preflight's blockers already report it.
441
+ return [];
442
+ }
443
+ const noop = Object.entries(declared)
444
+ .filter(([name, value]) => name.startsWith("bkit:gate:") && typeof value === "string")
445
+ .filter(([, value]) => isNoopScript(value as string))
446
+ .map(([name, value]) => `\`${name}\` (\`${String(value).trim() || "empty"}\`)`)
447
+ .sort();
448
+ if (noop.length === 0) return [];
449
+ return [
450
+ {
451
+ id: "gate-noop",
452
+ severity: "advisory",
453
+ detect: `These bkit:gate scripts are empty or cannot fail, so they check nothing: ${noop.join(", ")}.`,
454
+ action:
455
+ 'Every bkit workflow and the pre-push hook trust a green `bkit:gate*` script, so a no-op gate passes every agent run and push. Point each at the checks it should run (e.g. `"bkit:gate:static": "pnpm typecheck && pnpm lint"`), or delete it from package.json and run `bkit upgrade` to get bkit\'s default back.',
456
+ },
457
+ ];
458
+ }
459
+
460
+ export function runCoreModule(ctx: ModuleContext): void {
461
+ const { dryRun, ws, advisories, logPrefix, postDispatch } = ctx;
462
+ const tag = dryRun ? "[dry-run] " : "";
463
+ const cwd = process.cwd();
464
+ const PKG_ROOT = getPkgRoot();
465
+ const PKG_PACKAGE_JSON = path.join(PKG_ROOT, "package.json");
466
+
467
+ if (!fs.existsSync(PKG_PACKAGE_JSON)) {
468
+ console.error(`${logPrefix} package.json not found at ${PKG_PACKAGE_JSON} — package corrupt?`);
469
+ process.exit(1);
470
+ }
471
+
472
+ const pkgVersion = JSON.parse(fs.readFileSync(PKG_PACKAGE_JSON, "utf-8")).version as string;
473
+
474
+ // Capture first-install signal NOW (before any writes) — used for the post-install banner.
475
+ // The .bkit/version write happens in postDispatch, so a mid-install crash in a later
476
+ // module leaves no .bkit/version on disk.
477
+ const versionFile = path.join(cwd, ".bkit", "version");
478
+ const isFirstInstall = !fs.existsSync(versionFile);
479
+
480
+ // 2. Core payload pass (AGENTS.md, `.agents/*.md`, `docs/templates/**`, the two
481
+ // shared-root files core owns). Each host module writes its own hook files.
482
+ console.log(`${logPrefix} ${tag}Running core payload pass`);
483
+ runCoreTemplates(dryRun, ctx.tokens, ws, logPrefix);
484
+
485
+ // 3b. bkit canonical docs pass — mirror the package's reference docs
486
+ // (cloud/IDEs/prompts/trackers/workflows/README/install/comparison) into the
487
+ // consumer's `.bkit/` so they are readable in-repo. Force-overwrite (Tier 1).
488
+ console.log(`${logPrefix} ${tag}Running bkit docs pass`);
489
+ runBkitDocs(dryRun, ctx.tokens, ws, logPrefix);
490
+
491
+ // 3b2. Template copies — the whole templates root into the consumer's
492
+ // `.bkit/templates/` (never applied to the repo; no-op in dogfood).
493
+ console.log(`${logPrefix} ${tag}Running template copies pass`);
494
+ const templateChanges = syncTemplateCopies(cwd, { dryRun, ws });
495
+ for (const [verb, paths] of Object.entries(templateChanges)) {
496
+ for (const p of paths) {
497
+ console.log(`${logPrefix} ${tag}template ${verb}: ${path.join(TEMPLATE_COPIES_DIR, p)}`);
498
+ }
499
+ }
500
+
501
+ // 3c. The bkit:gate:* / bkit:deps:* package.json scripts (add-if-missing). The
502
+ // advisories read the result.
503
+ seedCorePackageJsonScripts(ctx);
504
+ if (!dryRun) advisories.push(...detectGateAdvisories(cwd));
505
+ advisories.push(...detectNoopGates(cwd));
506
+
507
+ // 4. .bkit/version write — deferred to postDispatch so it only persists when ALL modules succeed.
508
+ // This ensures a mid-install crash in a subsequent module does not suppress the first-install
509
+ // banner on retry (MED-4).
510
+ // C3 fix: write JSON format with canonicalHashes populated from ws.writes (fully populated
511
+ // by the time postDispatch runs — all modules have completed). canonicalHashes records the
512
+ // sha256 of each bkit-managed consumer file as written, enabling drift detection on upgrade.
513
+ postDispatch.push(() => {
514
+ // Read existing file to check whether an update is needed.
515
+ const existingVersion = readBkitVersion(versionFile);
516
+ const existingCanonical = existingVersion?.canonicalHashes ?? {};
517
+
518
+ // Build new canonicalHashes entries from ws.writes (files written in this run).
519
+ // ws.writes is fully populated by the time postDispatch runs.
520
+ // Exclude .bkit/version itself and .agents/ internal files (not consumer-facing).
521
+ const newCanonicalEntries: Record<string, string> = {};
522
+ for (const entry of ws.writes) {
523
+ const absPath = path.isAbsolute(entry.path) ? entry.path : path.resolve(cwd, entry.path);
524
+ const relPath = path.relative(cwd, absPath);
525
+ if (relPath === path.join(".bkit", "version")) continue;
526
+ if (relPath.startsWith(".agents" + path.sep)) continue;
527
+ // Template copies carry no hash.
528
+ if (relPath.startsWith(TEMPLATE_COPIES_DIR + path.sep)) continue;
529
+ if (!fs.existsSync(absPath)) continue;
530
+ const hash = hashFile(absPath);
531
+ if (hash) newCanonicalEntries[relPath] = hash;
532
+ }
533
+
534
+ // Merge: existing hashes preserved, new writes overwrite (hashes stay current),
535
+ // and entries whose path is gone are pruned (mergeCanonicalHashes).
536
+ const { canonicalHashes, pruned } = mergeCanonicalHashes(
537
+ cwd,
538
+ existingCanonical,
539
+ newCanonicalEntries,
540
+ );
541
+
542
+ // Decide whether a write is needed: version mismatch, first install, new canonical
543
+ // entries, a pruned stale entry, or a changed claudeAllowDerived record.
544
+ const versionChanged = !existingVersion || existingVersion.pinnedVersion !== pkgVersion;
545
+ const hasNewEntries = Object.keys(newCanonicalEntries).length > 0;
546
+ const claudeAllowDerived = ctx.claudeAllowRecorded ?? existingVersion?.claudeAllowDerived ?? [];
547
+ const derivedChanged =
548
+ JSON.stringify(claudeAllowDerived) !==
549
+ JSON.stringify(existingVersion?.claudeAllowDerived ?? []);
550
+ const needsWrite = versionChanged || hasNewEntries || pruned > 0 || derivedChanged;
551
+
552
+ if (needsWrite) {
553
+ console.log(
554
+ `${logPrefix} ${tag}write version pin: ${path.relative(cwd, versionFile)} (${pkgVersion})`,
555
+ );
556
+ ws.writes.push({ path: versionFile, action: "write" });
557
+ if (!dryRun) {
558
+ writeBkitVersion(versionFile, {
559
+ pinnedVersion: pkgVersion,
560
+ canonicalHashes,
561
+ claudeAllowDerived: [...claudeAllowDerived],
562
+ });
563
+ }
564
+ }
565
+ });
566
+
567
+ // 5. First-run extra logging (only when .bkit/version was absent at start of install)
568
+ if (isFirstInstall) {
569
+ advisories.push({
570
+ id: "first-install-postinstall-steps",
571
+ severity: "advisory",
572
+ detect: "First install detected (.bkit/version was absent).",
573
+ action:
574
+ "Post-install steps:\n\n" +
575
+ "1. Add BKIT_GH_TOKEN_INSTALL to your GitHub Actions repository secrets:\n" +
576
+ " - Create a classic PAT with `read:packages` scope (fine-grained PATs are\n" +
577
+ " not currently supported by GitHub Packages npm registry).\n" +
578
+ " - GitHub Settings → Secrets and variables → Actions → New repository secret\n" +
579
+ " - Name: BKIT_GH_TOKEN_INSTALL\n" +
580
+ " - See README.md ## Consumer CI auth for full setup.\n\n" +
581
+ "2. Add a `.npmrc` at your repo root with the @cbartens registry mapping (the\n" +
582
+ " auth token is NOT stored here — it goes in pnpm's user-level config):\n" +
583
+ " @cbartens:registry=https://npm.pkg.github.com\n\n" +
584
+ "3. Write the token into pnpm's user-level config (run once; CI does this in its\n" +
585
+ " install step). pnpm >=10.34.3 401s on a project-.npmrc ${BKIT_GH_TOKEN_INSTALL} ref:\n" +
586
+ ' pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"\n\n' +
587
+ "4. Run `pnpm install` to refresh the lockfile, then commit.\n\n" +
588
+ "Note: bkit seeded the bkit:gate:* / bkit:deps:* package.json scripts every workflow\n" +
589
+ "runs (existing values are never touched). The tool scripts they chain (typecheck,\n" +
590
+ "lint, format:check, lint:prose, slop:delta) and the devDeps those need are yours to\n" +
591
+ "add: see .bkit/templates.md.",
592
+ });
593
+ }
594
+ }
595
+
596
+ // ---------------------------------------------------------------------------
597
+ // runClaudeModule — byte-identical mirror from .agents/ → .claude/
598
+ // ---------------------------------------------------------------------------
599
+
600
+ export const BKIT_PREFIX = "bkit-";