@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,467 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import {
4
+ updateManagedBlock,
5
+ extractFullManagedBlock,
6
+ extractManagedBlock,
7
+ findLineAnchoredMarkers,
8
+ selectMarkers,
9
+ type MarkerStyle,
10
+ } from "./managed-block.js";
11
+ import { readTemplate } from "../render/parts.js";
12
+ import { applyTokens, type TokenMap } from "./placeholders.js";
13
+
14
+ // ---------------------------------------------------------------------------
15
+ // JsonValue — generic JSON type used throughout Tier-2 JSON helpers
16
+ // ---------------------------------------------------------------------------
17
+
18
+ export type JsonValue = string | number | boolean | null | JsonValue[] | { [k: string]: JsonValue };
19
+
20
+ // ---------------------------------------------------------------------------
21
+ // deepContains — deep-containment check (BAR-167 Phase 1)
22
+ //
23
+ // Returns { ok, missing, mismatched } where:
24
+ // ok — true if every path in `template` is present and equal in `consumer`
25
+ // missing — paths present in template but absent from consumer
26
+ // mismatched — paths present in both but with incompatible values
27
+ //
28
+ // Semantics:
29
+ // - Objects: for each key in template, consumer must have the same key with a
30
+ // deep-containing value. Consumer may have extra keys (superset is ok).
31
+ // - Arrays of primitives: template elements must all appear in consumer (subset semantics).
32
+ // - Arrays of objects: for each template element, at least one consumer element must
33
+ // deep-equal it (order-insensitive, asymmetric-size ok: consumer may have more).
34
+ // - Mixed arrays: element-wise containment by type.
35
+ // - Leaf primitives / null: exact equality required.
36
+ // - null template at any path → ok (template owns "nothing").
37
+ // - non-null template, null consumer → missing path.
38
+ // ---------------------------------------------------------------------------
39
+
40
+ export interface DeepContainsResult {
41
+ ok: boolean;
42
+ missing: string[];
43
+ mismatched: string[];
44
+ }
45
+
46
+ export function deepContains(
47
+ template: JsonValue,
48
+ consumer: JsonValue,
49
+ pathPrefix = "",
50
+ ): DeepContainsResult {
51
+ const missing: string[] = [];
52
+ const mismatched: string[] = [];
53
+
54
+ // null template: owns nothing → ok
55
+ if (template === null) {
56
+ return { ok: true, missing, mismatched };
57
+ }
58
+
59
+ // non-null template, null consumer → missing
60
+ if (consumer === null) {
61
+ missing.push(pathPrefix || "<root>");
62
+ return { ok: false, missing, mismatched };
63
+ }
64
+
65
+ // Both are arrays
66
+ if (Array.isArray(template) && Array.isArray(consumer)) {
67
+ _deepContainsArray(template, consumer, pathPrefix, missing);
68
+ return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
69
+ }
70
+
71
+ // Type mismatch (one is array, other is not, or different primitive types)
72
+ if (Array.isArray(template) !== Array.isArray(consumer)) {
73
+ mismatched.push(pathPrefix || "<root>");
74
+ return { ok: false, missing, mismatched };
75
+ }
76
+
77
+ // Both are plain objects
78
+ if (typeof template === "object" && typeof consumer === "object") {
79
+ const tObj = template as Record<string, JsonValue>;
80
+ const cObj = consumer as Record<string, JsonValue>;
81
+ for (const key of Object.keys(tObj)) {
82
+ const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
83
+ const tVal = tObj[key]!;
84
+ const cVal = cObj[key];
85
+ if (cVal === undefined) {
86
+ // If template has null for this key, still ok
87
+ if (tVal === null) continue;
88
+ missing.push(childPath);
89
+ } else {
90
+ const sub = deepContains(tVal, cVal, childPath);
91
+ missing.push(...sub.missing);
92
+ mismatched.push(...sub.mismatched);
93
+ }
94
+ }
95
+ return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
96
+ }
97
+
98
+ // Both are primitives — exact equality
99
+ if (template !== consumer) {
100
+ mismatched.push(pathPrefix || "<root>");
101
+ return { ok: false, missing, mismatched };
102
+ }
103
+
104
+ return { ok: true, missing, mismatched };
105
+ }
106
+
107
+ function _deepContainsArray(
108
+ template: JsonValue[],
109
+ consumer: JsonValue[],
110
+ pathPrefix: string,
111
+ missing: string[],
112
+ ): void {
113
+ // Classify template elements as primitive or object
114
+ for (let i = 0; i < template.length; i++) {
115
+ const tEl = template[i]!;
116
+ const elPath = pathPrefix ? `${pathPrefix}[${i}]` : `[${i}]`;
117
+
118
+ if (tEl === null || typeof tEl !== "object") {
119
+ // Primitive — subset: consumer must contain this value
120
+ if (!consumer.includes(tEl)) {
121
+ missing.push(elPath);
122
+ }
123
+ } else if (Array.isArray(tEl)) {
124
+ // Nested array element — must find an equal consumer element
125
+ const found = consumer.some((cEl) => Array.isArray(cEl) && deepContains(tEl, cEl, "").ok);
126
+ if (!found) {
127
+ missing.push(elPath);
128
+ }
129
+ } else {
130
+ // Object element — order-insensitive deep-equal containment
131
+ const found = consumer.some(
132
+ (cEl) =>
133
+ cEl !== null &&
134
+ typeof cEl === "object" &&
135
+ !Array.isArray(cEl) &&
136
+ deepContains(tEl, cEl, "").ok,
137
+ );
138
+ if (!found) {
139
+ missing.push(elPath);
140
+ }
141
+ }
142
+ }
143
+ }
144
+
145
+ // ---------------------------------------------------------------------------
146
+ // deepMergeJson — recursive JSON merge primitive (P3.T1)
147
+ //
148
+ // Semantics (from DE-8 contract spec):
149
+ // - Objects: merge recursively (override keys win; base keys retained if absent from override)
150
+ // - Arrays: override replaces base (no concat — arrays are treated as atomic values)
151
+ // - Primitives / null: override replaces base
152
+ // ---------------------------------------------------------------------------
153
+
154
+ export function deepMergeJson(base: JsonValue, override: JsonValue): JsonValue {
155
+ if (override === null || typeof override !== "object" || Array.isArray(override)) {
156
+ return override;
157
+ }
158
+ if (base === null || typeof base !== "object" || Array.isArray(base)) {
159
+ // base is not a plain object — override wins wholesale
160
+ return override;
161
+ }
162
+ // Both are plain objects — recursive merge.
163
+ //
164
+ // Key ORDER follows `override` (the bkit template) for keys it defines, then appends
165
+ // base-only (consumer) keys. Order-significant maps like opencode's last-match-wins
166
+ // `permission.bash` keep the template's order (`git push --force-with-lease*: allow`
167
+ // stays after `git push --force*: deny`).
168
+ const baseObj = base as { [k: string]: JsonValue };
169
+ const overrideObj = override as { [k: string]: JsonValue };
170
+ const result: { [k: string]: JsonValue } = {};
171
+ // 1. Template keys first, in template order (recurse where both sides are plain objects).
172
+ for (const [key, val] of Object.entries(overrideObj)) {
173
+ const baseVal = baseObj[key];
174
+ if (
175
+ key in baseObj &&
176
+ baseVal !== null &&
177
+ typeof baseVal === "object" &&
178
+ !Array.isArray(baseVal) &&
179
+ val !== null &&
180
+ typeof val === "object" &&
181
+ !Array.isArray(val)
182
+ ) {
183
+ result[key] = deepMergeJson(baseVal, val);
184
+ } else {
185
+ result[key] = val;
186
+ }
187
+ }
188
+ // 2. Consumer-only keys preserved, appended after the template's keys.
189
+ for (const [key, val] of Object.entries(baseObj)) {
190
+ if (!(key in result)) {
191
+ result[key] = val;
192
+ }
193
+ }
194
+ return result;
195
+ }
196
+
197
+ // ---------------------------------------------------------------------------
198
+ // writeTier2JsonContained — deep-containment JSON helper (BAR-167 Phase 1)
199
+ //
200
+ // Contract:
201
+ // - dest absent → write template as-is (first install)
202
+ // - dest present, valid JSON, template contained → no-op (idempotent)
203
+ // - dest present, valid JSON, containment fails → deepMergeJson(existing, template)
204
+ // (template wins on key collisions; consumer-only keys outside template tree preserved)
205
+ // - dest present, malformed JSON → overwrite with template
206
+ // - schemaFlipped: true when a path value changed type during deep-merge
207
+ // ---------------------------------------------------------------------------
208
+
209
+ export function writeTier2JsonContained(
210
+ srcPath: string,
211
+ dstPath: string,
212
+ dryRun: boolean,
213
+ ws: WriteSet,
214
+ ): void {
215
+ const srcRaw = fs.readFileSync(srcPath, "utf-8");
216
+ let template: Record<string, JsonValue>;
217
+ try {
218
+ template = JSON.parse(srcRaw) as Record<string, JsonValue>;
219
+ } catch {
220
+ throw new Error(`writeTier2JsonContained: template at ${srcPath} is not valid JSON`);
221
+ }
222
+
223
+ if (!fs.existsSync(dstPath)) {
224
+ // First install — write template as-is
225
+ ensureDir(path.dirname(dstPath));
226
+ if (!dryRun) {
227
+ fs.writeFileSync(dstPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
228
+ const srcMode = fs.statSync(srcPath).mode;
229
+ fs.chmodSync(dstPath, srcMode);
230
+ }
231
+ ws.writes.push({ path: dstPath, action: "write" });
232
+ return;
233
+ }
234
+
235
+ // dest exists — read and check containment
236
+ const dstRaw = fs.readFileSync(dstPath, "utf-8");
237
+ let existing: Record<string, JsonValue>;
238
+ try {
239
+ existing = JSON.parse(dstRaw) as Record<string, JsonValue>;
240
+ } catch {
241
+ // Malformed destination — refuse to overwrite; require manual fix (matches malformed-package-json blocker discipline)
242
+ throw new Error(
243
+ `[bkit] ${dstPath} is malformed JSON — fix manually before running bkit install`,
244
+ );
245
+ }
246
+
247
+ // Check if existing already contains the template
248
+ const containsResult = deepContains(template as JsonValue, existing as JsonValue);
249
+ if (containsResult.ok) {
250
+ return; // idempotent — no change needed
251
+ }
252
+
253
+ // Deep-merge: existing base, template override (template wins on conflicts)
254
+ const merged = deepMergeJson(existing as JsonValue, template as JsonValue);
255
+ const mergedStr = JSON.stringify(merged, null, 2) + "\n";
256
+ if (mergedStr === dstRaw) return; // idempotent guard
257
+
258
+ if (!dryRun) {
259
+ fs.writeFileSync(dstPath, mergedStr, "utf-8");
260
+ }
261
+ ws.writes.push({ path: dstPath, action: "update" });
262
+ }
263
+
264
+ // ---------------------------------------------------------------------------
265
+ // Internal helpers
266
+ // ---------------------------------------------------------------------------
267
+
268
+ export function ensureDir(dir: string): void {
269
+ fs.mkdirSync(dir, { recursive: true });
270
+ }
271
+
272
+ // ---------------------------------------------------------------------------
273
+ // fully-managed format — idempotent rewrite of whole file after token substitution
274
+ //
275
+ // Semantics: always writes the src content (with tokens applied) to dst.
276
+ // If dst exists with identical content, no-op (no double-count in WriteSet).
277
+ // ---------------------------------------------------------------------------
278
+
279
+ export function writeTier1(
280
+ srcPath: string,
281
+ dstPath: string,
282
+ tokens: TokenMap,
283
+ dryRun: boolean,
284
+ ws: WriteSet,
285
+ ): void {
286
+ const srcRaw = readTemplate(srcPath);
287
+ const srcContent = applyTokens(srcRaw, tokens);
288
+
289
+ if (fs.existsSync(dstPath)) {
290
+ const existing = fs.readFileSync(dstPath, "utf-8");
291
+ if (existing === srcContent) return; // identical — no-op
292
+ }
293
+
294
+ ensureDir(path.dirname(dstPath));
295
+ if (!dryRun) {
296
+ fs.writeFileSync(dstPath, srcContent, "utf-8");
297
+ // Preserve executable bit from src
298
+ const srcMode = fs.statSync(srcPath).mode;
299
+ fs.chmodSync(dstPath, srcMode);
300
+ }
301
+
302
+ ws.writes.push({ path: dstPath, action: "write" });
303
+ }
304
+
305
+ // ---------------------------------------------------------------------------
306
+ // markered-text format — managed-block (bkit owns content between markers; consumer owns rest)
307
+ //
308
+ // Semantics:
309
+ // - dest absent → write whole file (with token substitution)
310
+ // - dest has markers → update only the bkit block (tokens applied to new block content)
311
+ // - dest present, no marks → append full block at EOF; preserve consumer content above
312
+ //
313
+ // markerStyle: "html-comment" for markdown, shell and `.gitignore` (`# ` prefix allowed);
314
+ // "slash-comment" for JS.
315
+ // ---------------------------------------------------------------------------
316
+
317
+ export function writeTier2(
318
+ srcPath: string,
319
+ dstPath: string,
320
+ tokens: TokenMap,
321
+ markerStyle: MarkerStyle,
322
+ dryRun: boolean,
323
+ ws: WriteSet,
324
+ ): void {
325
+ const srcRaw = readTemplate(srcPath);
326
+
327
+ if (!fs.existsSync(dstPath)) {
328
+ // dest missing → write whole template (with tokens applied)
329
+ const content = applyTokens(srcRaw, tokens);
330
+ ensureDir(path.dirname(dstPath));
331
+ if (!dryRun) {
332
+ fs.writeFileSync(dstPath, content, "utf-8");
333
+ const srcMode = fs.statSync(srcPath).mode;
334
+ fs.chmodSync(dstPath, srcMode);
335
+ }
336
+ ws.writes.push({ path: dstPath, action: "write" });
337
+ return;
338
+ }
339
+
340
+ const destContent = fs.readFileSync(dstPath, "utf-8");
341
+ const fullBlock = extractFullManagedBlock(srcRaw, markerStyle);
342
+
343
+ if (fullBlock === null) {
344
+ // Template has no block for this marker style — nothing to manage
345
+ return;
346
+ }
347
+
348
+ // Check if dest already has markers
349
+ const blockContent = extractManagedBlock(destContent, markerStyle);
350
+
351
+ if (blockContent === null) {
352
+ // extractManagedBlock returns null for BOTH "no markers" and "ambiguous markers"
353
+ // (duplicates / inverted). Only the former should append — appending on the latter
354
+ // compounds corruption (dogfood docs grew a second stamped block every install).
355
+ const [startMarker, endMarker] = selectMarkers(markerStyle);
356
+ const starts = findLineAnchoredMarkers(destContent, startMarker);
357
+ const ends = findLineAnchoredMarkers(destContent, endMarker);
358
+ if (starts.length > 0 || ends.length > 0) {
359
+ console.warn(
360
+ `[bkit] Managed block markers present but unparseable in ${dstPath} — skipping (expected exactly one start/end)`,
361
+ );
362
+ return;
363
+ }
364
+
365
+ // dest has no markers → append full block at EOF (with tokens applied)
366
+ const appliedBlock = applyTokens(fullBlock, tokens);
367
+ const sep =
368
+ destContent.length === 0
369
+ ? ""
370
+ : destContent.endsWith("\n\n")
371
+ ? ""
372
+ : destContent.endsWith("\n")
373
+ ? "\n"
374
+ : "\n\n";
375
+ const tail = appliedBlock.endsWith("\n") ? "" : "\n";
376
+ if (!dryRun) {
377
+ fs.writeFileSync(dstPath, destContent + sep + appliedBlock + tail, "utf-8");
378
+ }
379
+ ws.writes.push({ path: dstPath, action: "append" });
380
+ return;
381
+ }
382
+
383
+ // dest has markers → update managed block with new content (tokens applied)
384
+ const newBlockContent = extractManagedBlock(srcRaw, markerStyle);
385
+ if (newBlockContent === null) return;
386
+
387
+ const appliedNewContent = applyTokens(newBlockContent, tokens);
388
+ if (updateManagedBlock(dstPath, appliedNewContent, dryRun, markerStyle)) {
389
+ ws.writes.push({ path: dstPath, action: "update" });
390
+ }
391
+ }
392
+
393
+ // ---------------------------------------------------------------------------
394
+ // Managed package.json scripts — add-if-missing with consumer ownership
395
+ //
396
+ // Semantics:
397
+ // - File absent → no-op, returns missingPkg: true
398
+ // - File malformed JSON → no-op, returns malformed: true
399
+ // - script key absent → add with default value (recorded as one update)
400
+ // - script key exists → preserve consumer value (never overwrite)
401
+ //
402
+ // One WriteSet entry per call when any script was added. Drift
403
+ // surfaces in `bkit check` because `dryRun=true` still pushes to ws.writes.
404
+ // ---------------------------------------------------------------------------
405
+
406
+ export function ensurePackageJsonScripts(
407
+ scripts: Record<string, string>,
408
+ dryRun: boolean,
409
+ ws: WriteSet,
410
+ ): {
411
+ added: string[];
412
+ preserved: string[];
413
+ missingPkg: boolean;
414
+ malformed: boolean;
415
+ } {
416
+ const pkgPath = "package.json";
417
+ if (!fs.existsSync(pkgPath)) {
418
+ return { added: [], preserved: [], missingPkg: true, malformed: false };
419
+ }
420
+ const raw = fs.readFileSync(pkgPath, "utf-8");
421
+ let pkg: Record<string, unknown>;
422
+ try {
423
+ pkg = JSON.parse(raw) as Record<string, unknown>;
424
+ } catch {
425
+ return { added: [], preserved: [], missingPkg: false, malformed: true };
426
+ }
427
+
428
+ let pkgScripts = (pkg.scripts as Record<string, string> | undefined) ?? undefined;
429
+ const added: string[] = [];
430
+ const preserved: string[] = [];
431
+
432
+ for (const [name, value] of Object.entries(scripts)) {
433
+ if (pkgScripts && Object.prototype.hasOwnProperty.call(pkgScripts, name)) {
434
+ preserved.push(name);
435
+ } else {
436
+ if (!pkgScripts) {
437
+ pkgScripts = {};
438
+ pkg.scripts = pkgScripts;
439
+ }
440
+ pkgScripts[name] = value;
441
+ added.push(name);
442
+ }
443
+ }
444
+
445
+ if (added.length > 0) {
446
+ ws.writes.push({ path: pkgPath, action: "update" });
447
+ if (!dryRun) {
448
+ // Preserve indent style and trailing newline of the original file.
449
+ const indentMatch = raw.match(/\n([ \t]+)"/);
450
+ const indent = indentMatch ? indentMatch[1] : " ";
451
+ const trailingNewline = raw.endsWith("\n") ? "\n" : "";
452
+ fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
453
+ }
454
+ }
455
+ return { added, preserved, missingPkg: false, malformed: false };
456
+ }
457
+
458
+ // Shared WriteSet accumulator — both check and install paths populate this identically,
459
+ // ensuring parity by construction (eliminates future dry-run divergence).
460
+ export interface WriteEntry {
461
+ path: string;
462
+ action: "write" | "update" | "append";
463
+ }
464
+
465
+ export interface WriteSet {
466
+ writes: WriteEntry[];
467
+ }
@@ -0,0 +1,32 @@
1
+ // The clamp record log: one JSON line per artifact `bkit context clamp` trimmed,
2
+ // read back into the step's status row (`clamped`) by `bkit context finalise` and
3
+ // `bkit steps finish --clamp-log`. Lives outside commands/workflow so both read it
4
+ // without importing each other.
5
+
6
+ import * as fs from "node:fs";
7
+ import * as path from "node:path";
8
+
9
+ import { git, parseJson } from "../commands/lib.js";
10
+
11
+ /** `tmp/bkit-clamp-{fid}-{step}[-{attempt}].jsonl` in the checkout `cwd` sits in. */
12
+ export function clampLogPath(cwd: string, fid: string, step: string, attempt?: number): string {
13
+ const top = git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
14
+ return path.join(top, "tmp", `bkit-clamp-${fid}-${step}${attempt ? `-${attempt}` : ""}.jsonl`);
15
+ }
16
+
17
+ /** Every record in the log; reading never drains it, so a retried status block sees the same array. */
18
+ export function readRecords(
19
+ log: string,
20
+ onBad: (line: string) => void = () => undefined,
21
+ ): unknown[] {
22
+ if (!fs.existsSync(log)) return [];
23
+ return fs
24
+ .readFileSync(log, "utf-8")
25
+ .split("\n")
26
+ .filter((l) => l.trim() !== "")
27
+ .flatMap((l) => {
28
+ const parsed = parseJson(l);
29
+ if (!parsed.ok) onBad(l);
30
+ return parsed.ok ? [parsed.value] : [];
31
+ });
32
+ }