@cbartens/bkit 0.0.0-stage → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +417 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +867 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +924 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,415 @@
1
+ // commands/comply.ts — compliance grader for the bkit workflow suite.
2
+ //
3
+ // Grader:
4
+ // - Pure functions over `git diff parentSha..HEAD` + filesystem state.
5
+ // - Deterministic, advisory (NEVER gating). Fail-open: callers use the idiom
6
+ // `pnpm bkit comply --phase={p} || echo "[bkit-comply] grader unavailable, skipping"`.
7
+ // - Emits one `kind:"compliance"` row per run×rule into `.bkit/stats.jsonl`.
8
+ // - Surfaces violations in ship-summary.md.
9
+ //
10
+ // Smallest-first rule set:
11
+ // `no-mirror-edit` — .claude/* and .cursor/* must not appear in the diff
12
+ // `skip-ci-not-head` — the HEAD commit must carry `[skip ci]` if the workflow
13
+ // close convention requires it (advisory only)
14
+ //
15
+ // See DE-34 for the shared-entrypoint + crash-isolation contract.
16
+
17
+ import { execFileSync } from "node:child_process";
18
+ import * as fs from "node:fs";
19
+ import * as path from "node:path";
20
+ import { getPkgRoot } from "../shared/package-roots.js";
21
+ import { isMirrorPath } from "../shared/protected-paths.js";
22
+ import {
23
+ resolveGitSha,
24
+ resolveRepoSlug,
25
+ type TelemetryEnvelope,
26
+ type CompliancePayload,
27
+ } from "../ledgers/telemetry.js";
28
+ import type { ComplyPhase } from "../cli.js";
29
+
30
+ // ---------------------------------------------------------------------------
31
+ // Rule IDs
32
+ // ---------------------------------------------------------------------------
33
+
34
+ export type RuleId = "no-mirror-edit" | "skip-ci-not-head";
35
+
36
+ // ---------------------------------------------------------------------------
37
+ // Violation shape
38
+ // ---------------------------------------------------------------------------
39
+
40
+ export interface Violation {
41
+ ruleId: RuleId;
42
+ /** Human-readable description of what was found. */
43
+ description: string;
44
+ /** Relevant file path(s) or context. */
45
+ evidence: string;
46
+ /** "fail" | "n/a" — n/a means the rule did not apply (e.g. no commits to check). */
47
+ result: "fail" | "n/a";
48
+ }
49
+
50
+ // ---------------------------------------------------------------------------
51
+ // Git helpers (pure wrappers — replaceable in tests)
52
+ // ---------------------------------------------------------------------------
53
+
54
+ export interface GitAdapter {
55
+ /** Returns the diff stat paths (one per line, POSIX) for parentSha..HEAD. */
56
+ diffPaths(parentSha: string, cwd: string): string[];
57
+ /** Returns the subject line of HEAD. */
58
+ headSubject(cwd: string): string;
59
+ }
60
+
61
+ /** SHA charset guard — only raw hex SHAs from the ledger are accepted. */
62
+ const SHA_RE = /^[0-9a-f]{7,40}$/;
63
+
64
+ export const realGitAdapter: GitAdapter = {
65
+ diffPaths(parentSha: string, cwd: string): string[] {
66
+ if (!SHA_RE.test(parentSha)) {
67
+ console.error(
68
+ `[bkit-comply] diffPaths: parentSha "${parentSha}" does not match /^[0-9a-f]{7,40}$/ — skipping diff`,
69
+ );
70
+ return [];
71
+ }
72
+ try {
73
+ const output = execFileSync("git", ["diff", "--name-only", `${parentSha}..HEAD`], {
74
+ cwd,
75
+ encoding: "utf8",
76
+ stdio: ["ignore", "pipe", "ignore"],
77
+ });
78
+ return output
79
+ .split("\n")
80
+ .map((l) => l.trim())
81
+ .filter(Boolean);
82
+ } catch (e) {
83
+ console.error("[bkit-comply] git diff failed (fail-open):", e);
84
+ return [];
85
+ }
86
+ },
87
+
88
+ headSubject(cwd: string): string {
89
+ try {
90
+ return execFileSync("git", ["log", "-1", "--format=%s"], {
91
+ cwd,
92
+ encoding: "utf8",
93
+ stdio: ["ignore", "pipe", "ignore"],
94
+ }).trim();
95
+ } catch (e) {
96
+ console.error("[bkit-comply] git log failed (fail-open):", e);
97
+ return "";
98
+ }
99
+ },
100
+ };
101
+
102
+ // ---------------------------------------------------------------------------
103
+ // Individual rules (pure functions)
104
+ // ---------------------------------------------------------------------------
105
+
106
+ /**
107
+ * no-mirror-edit — flags any path in the diff that falls inside a bkit-managed
108
+ * mirror directory. Mirror dirs must never be hand-edited; edits belong in the
109
+ * canonical `.bkit/` source and are regenerated by `bkit install` / `bkit upgrade`.
110
+ */
111
+ export function ruleNoMirrorEdit(diffPaths: readonly string[]): Violation | null {
112
+ const mirrored = diffPaths.filter((p) => isMirrorPath(p));
113
+ if (mirrored.length === 0) return null;
114
+ return {
115
+ ruleId: "no-mirror-edit",
116
+ description:
117
+ "One or more bkit-managed mirror files were hand-edited. " +
118
+ "Mirror files must only be regenerated by `bkit install` / `bkit upgrade`, " +
119
+ "not edited directly.",
120
+ evidence: mirrored.join(", "),
121
+ result: "fail",
122
+ };
123
+ }
124
+
125
+ /**
126
+ * skip-ci-not-head — advisory check that the final commit before ship does NOT
127
+ * carry `[skip ci]` (which would leave the PR's statusCheckRollup empty and admit
128
+ * a vacuously green PR). Fires only for the `ship` phase.
129
+ *
130
+ * Advisory: a `[skip ci]` HEAD is legitimate for worktree-setup / create-pr commits
131
+ * (DE-21 D2); the ship close step's CI-Dispatch Gate is the deterministic guard. This
132
+ * rule adds a grader-level record.
133
+ */
134
+ export function ruleSkipCiNotHead(headSubject: string, phase: string): Violation | null {
135
+ if (phase !== "ship") return null;
136
+ const hasSkipCi = headSubject.includes("[skip ci]");
137
+ if (!hasSkipCi) return null;
138
+ return {
139
+ ruleId: "skip-ci-not-head",
140
+ description:
141
+ "HEAD commit carries `[skip ci]` at ship close. " +
142
+ "This leaves the PR statusCheckRollup empty, admitting a vacuously green PR. " +
143
+ "The CI-Dispatch Gate (#261) handles recovery, but this advisory records the occurrence.",
144
+ evidence: `HEAD subject: ${headSubject}`,
145
+ result: "fail",
146
+ };
147
+ }
148
+
149
+ // ---------------------------------------------------------------------------
150
+ // Main grader entry point
151
+ // ---------------------------------------------------------------------------
152
+
153
+ export interface GraderInput {
154
+ /** Git SHA of the parent commit (design-start / plan-start / etc.). */
155
+ parentSha: string;
156
+ /** Workflow phase: design | plan | build | debug | ship */
157
+ phase: string;
158
+ /** Working directory for git commands. Defaults to process.cwd(). */
159
+ cwd?: string;
160
+ /** Inject a custom git adapter (for integration tests). */
161
+ gitAdapter?: GitAdapter;
162
+ }
163
+
164
+ /**
165
+ * Run all rules and return the Violation array.
166
+ * Returns an empty array on any unexpected error (fail-open).
167
+ */
168
+ export function runGrader(input: GraderInput): Violation[] {
169
+ try {
170
+ const cwd = input.cwd ?? process.cwd();
171
+ const adapter = input.gitAdapter ?? realGitAdapter;
172
+ const diffPaths = adapter.diffPaths(input.parentSha, cwd);
173
+ const headSubject = adapter.headSubject(cwd);
174
+
175
+ const violations: Violation[] = [];
176
+
177
+ const noMirrorViolation = ruleNoMirrorEdit(diffPaths);
178
+ if (noMirrorViolation) violations.push(noMirrorViolation);
179
+
180
+ const skipCiViolation = ruleSkipCiNotHead(headSubject, input.phase);
181
+ if (skipCiViolation) violations.push(skipCiViolation);
182
+
183
+ return violations;
184
+ } catch {
185
+ // Fail-open: unhandled errors yield no violations rather than crashing.
186
+ return [];
187
+ }
188
+ }
189
+
190
+ // ---------------------------------------------------------------------------
191
+ // Row emitter — builds telemetry rows ready to append to .bkit/stats.jsonl
192
+ // ---------------------------------------------------------------------------
193
+
194
+ export interface ComplianceRowInput {
195
+ violations: Violation[];
196
+ phase: string;
197
+ parentSha: string;
198
+ repo: string;
199
+ bkitVersion: string;
200
+ /** Additional envelope fields (step, subagent, etc.). */
201
+ extra?: Partial<TelemetryEnvelope>;
202
+ }
203
+
204
+ export type ComplianceRow = TelemetryEnvelope & CompliancePayload;
205
+
206
+ /**
207
+ * Build one `kind:"compliance"` row per rule.
208
+ * Rules that produced no violation emit a "pass" row.
209
+ * Every row carries `bkitVersion`.
210
+ *
211
+ * Called by the CLI dispatch after `runGrader`.
212
+ */
213
+ export function buildComplianceRows(input: ComplianceRowInput): ComplianceRow[] {
214
+ const ts = Date.now();
215
+ const { violations, phase, parentSha, repo, bkitVersion, extra } = input;
216
+
217
+ const violationByRule = new Map<RuleId, Violation>();
218
+ for (const v of violations) {
219
+ violationByRule.set(v.ruleId, v);
220
+ }
221
+
222
+ const ALL_RULES: RuleId[] = ["no-mirror-edit", "skip-ci-not-head"];
223
+ const rows: ComplianceRow[] = [];
224
+
225
+ for (const ruleId of ALL_RULES) {
226
+ const violation = violationByRule.get(ruleId);
227
+ const result: "pass" | "fail" | "n/a" = violation != null ? violation.result : "pass";
228
+ const evidence = violation?.evidence;
229
+
230
+ const envelope: TelemetryEnvelope = {
231
+ ts: ts + rows.length, // micro-offset so each row has a unique ts within the batch
232
+ kind: "compliance",
233
+ repo,
234
+ bkitVersion,
235
+ workflow: phase,
236
+ step: "close-gate",
237
+ ...(extra ?? {}),
238
+ };
239
+
240
+ const payload: CompliancePayload = {
241
+ rule: ruleId,
242
+ result,
243
+ ...(evidence != null ? { evidence } : {}),
244
+ phase,
245
+ parentSha,
246
+ };
247
+
248
+ rows.push({ ...envelope, ...payload });
249
+ }
250
+
251
+ return rows;
252
+ }
253
+
254
+ // ---------------------------------------------------------------------------
255
+ // Append helper — writes rows to .bkit/stats.jsonl (best-effort)
256
+ // ---------------------------------------------------------------------------
257
+
258
+ /**
259
+ * Append compliance rows to the stats ledger.
260
+ * Best-effort: prints `[bkit-comply] append failed: …` on error, never throws.
261
+ */
262
+ export function appendComplianceRows(rows: ComplianceRow[], statsPath: string): void {
263
+ try {
264
+ const ndjson = rows.map((r) => JSON.stringify(r)).join("\n") + "\n";
265
+ fs.appendFileSync(statsPath, ndjson, "utf8");
266
+ } catch (err: unknown) {
267
+ const msg = err instanceof Error ? err.message : String(err);
268
+ console.error(`[bkit-comply] append failed: ${statsPath} — ${msg}`);
269
+ }
270
+ }
271
+
272
+ // ---------------------------------------------------------------------------
273
+ // One grading pass, as `bkit workflows close` runs it before its report
274
+ // ---------------------------------------------------------------------------
275
+
276
+ /**
277
+ * Grade `phase` over HEAD~1..HEAD (HEAD alone in a one-commit repo) and append
278
+ * its compliance rows to `<cwd>/.bkit/stats.jsonl`. Fail-open: any error is
279
+ * logged and returns null, so a close never stops on the grader.
280
+ */
281
+ export function gradeCompliance(
282
+ cwd: string,
283
+ phase: string,
284
+ log: (m: string) => void,
285
+ ): Violation[] | null {
286
+ try {
287
+ const parentSha = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
288
+ if (!parentSha) {
289
+ log("[bkit-comply] cannot resolve a parent SHA (no commits?) — skipping grade");
290
+ return null;
291
+ }
292
+ const violations = runGrader({ parentSha, phase, cwd });
293
+ const rows = buildComplianceRows({
294
+ violations,
295
+ phase,
296
+ parentSha,
297
+ repo: resolveRepoSlug(cwd) || "unknown/repo",
298
+ bkitVersion: readBkitVersion(),
299
+ });
300
+ appendComplianceRows(rows, path.join(cwd, ".bkit", "stats.jsonl"));
301
+ log(
302
+ violations.length > 0
303
+ ? `[bkit-comply] Compliance violations found:\n${formatComplianceSummary(violations)}`
304
+ : "[bkit-comply] All rules pass.",
305
+ );
306
+ return violations;
307
+ } catch (err) {
308
+ // Fail-open: the grader is advisory and never gates a close.
309
+ log(`[bkit-comply] grader error (fail-open): ${(err as Error).message}`);
310
+ return null;
311
+ }
312
+ }
313
+
314
+ // ---------------------------------------------------------------------------
315
+ // Summarise violations for surfacing in ship-summary.md
316
+ // ---------------------------------------------------------------------------
317
+
318
+ /**
319
+ * Format a human-readable compliance summary block for inclusion in
320
+ * ship-summary.md. Empty string when all rules pass.
321
+ */
322
+ export function formatComplianceSummary(violations: Violation[]): string {
323
+ if (violations.length === 0) return "";
324
+ const lines = [
325
+ "## Compliance Violations",
326
+ "",
327
+ ...violations.map(
328
+ (v) => `- **${v.ruleId}** (${v.result}): ${v.description}\n Evidence: ${v.evidence}`,
329
+ ),
330
+ "",
331
+ "_Advisory — these violations are recorded in `.bkit/stats.jsonl` and do NOT block the workflow._",
332
+ ];
333
+ return lines.join("\n");
334
+ }
335
+
336
+ // ---------------------------------------------------------------------------
337
+ // bkitVersion reader (used by CLI dispatch and tests)
338
+ // ---------------------------------------------------------------------------
339
+
340
+ /**
341
+ * Read the bkit version from the package.json nearest to `searchFrom` (default: the
342
+ * running bkit package's root). Returns "0.0.0" on any read/parse error (fail-open).
343
+ */
344
+ export function readBkitVersion(searchFrom?: string): string {
345
+ try {
346
+ // Walk up looking for a package.json with a `version` field; stop at the filesystem root.
347
+ let dir = path.resolve(searchFrom ?? getPkgRoot());
348
+ for (let i = 0; i < 8; i++) {
349
+ const candidate = path.join(dir, "package.json");
350
+ if (fs.existsSync(candidate)) {
351
+ const pkg = JSON.parse(fs.readFileSync(candidate, "utf8")) as {
352
+ version?: string;
353
+ };
354
+ if (typeof pkg.version === "string") return pkg.version;
355
+ }
356
+ const parent = path.dirname(dir);
357
+ if (parent === dir) break;
358
+ dir = parent;
359
+ }
360
+ } catch (_e) {
361
+ void _e; // fail-open: version read errors return default
362
+ }
363
+ return "0.0.0";
364
+ }
365
+
366
+ // comply — compliance grader (advisory, never gating, fail-open).
367
+ // Runs `runGrader` over `git diff parentSha..HEAD`, appends `kind:"compliance"`
368
+ // rows to `.bkit/stats.jsonl`, and logs violations. Always exits 0 (fail-open);
369
+ // callers MUST use the pinned idiom:
370
+ // `pnpm bkit comply --phase=<phase> || echo "[bkit-comply] grader unavailable, skipping"`
371
+ // See DE-34 for the shared-entrypoint + crash-isolation contract.
372
+ export function runComplyCommand(complyPhase: ComplyPhase | null): void {
373
+ try {
374
+ const cwd = process.cwd();
375
+ const phase = complyPhase ?? "unknown";
376
+ const logPrefix = "[bkit-comply]";
377
+
378
+ // parentSha MUST be a resolved hex SHA: diffPaths returns [] for anything not
379
+ // matching /^[0-9a-f]{7,40}$/, and parentSha is part of the compliance identity().
380
+ // Resolves HEAD~1, else HEAD; neither → skip the grade.
381
+ const statsPath = path.join(cwd, ".bkit", "stats.jsonl");
382
+ const parentSha = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
383
+ if (!parentSha) {
384
+ console.log(`${logPrefix} cannot resolve a parent SHA (no commits?) — skipping grade`);
385
+ return;
386
+ }
387
+
388
+ console.log(`${logPrefix} Running compliance grader (phase=${phase}, parentSha=${parentSha})`);
389
+
390
+ const violations = runGrader({ parentSha, phase, cwd });
391
+
392
+ // The origin remote's owner/repo, the same slug every other telemetry writer uses.
393
+ const repo = resolveRepoSlug(cwd) || "unknown/repo";
394
+
395
+ const bkitVersion = readBkitVersion();
396
+
397
+ const rows = buildComplianceRows({ violations, phase, parentSha, repo, bkitVersion });
398
+ appendComplianceRows(rows, statsPath);
399
+
400
+ if (violations.length > 0) {
401
+ const summary = formatComplianceSummary(violations);
402
+ console.log(`${logPrefix} Compliance violations found:\n${summary}`);
403
+ } else {
404
+ console.log(`${logPrefix} All rules pass.`);
405
+ }
406
+
407
+ console.log(
408
+ `${logPrefix} Appended ${rows.length} compliance row(s) to .bkit/stats.jsonl (advisory — not gating).`,
409
+ );
410
+ } catch (err: unknown) {
411
+ // Fail-open: any unexpected error in the dispatch body must not gate the workflow.
412
+ const msg = err instanceof Error ? err.message : String(err);
413
+ console.error(`[bkit-comply] grader error (fail-open): ${msg}`);
414
+ }
415
+ }