@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,393 @@
1
+ // checks/status-holes.ts — Tier-3 advisory status-hole detector.
2
+ //
3
+ // A fail-open advisory that compares the set of ship steps RECORDED in a
4
+ // status.jsonl against the set of steps the workflow PROSE says should be
5
+ // there. It derives its expected set from .bkit/workflows/bkit-ship.md at
6
+ // runtime (headings + step:"ship-*" literals) — NEVER a hand-maintained table
7
+ // (decision 384-tier3-promotion).
8
+ //
9
+ // ADVISORY / FAIL-OPEN: the CLI exits 0 unconditionally — even when holes are
10
+ // found (decision 384-tier3-promotion).
11
+ //
12
+ // Path-conditional expectations:
13
+ // - Path A (dev is ancestor): skips ship-conflict-resolve.
14
+ // - Path B (dev moved): includes ship-conflict-resolve.
15
+ // - MERGED-on-entry (Step 2 detects state=MERGED → Step 13): skips the entire
16
+ // middle (base check, integrate, deferred-sweep, the pre-merge docs /
17
+ // summary / prune / bookkeeping-push steps, merge-pr).
18
+ // - Aborted (workflow-failed row present): no post-abort holes expected.
19
+ // - ship-failure-diagnose / ship-failure-remediate are NEVER mandatory — they
20
+ // appear only in the merge-retry loop.
21
+ //
22
+ // Usage (advisory CI step or manual):
23
+ // npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl> [--ship-md <path>]
24
+ // # exits 0 always; prints advisory report to stdout
25
+ import * as fs from "node:fs";
26
+ import * as path from "node:path";
27
+ import { fileURLToPath } from "node:url";
28
+ import { getWorkflowsRoot } from "../shared/package-roots.js";
29
+ // ---------------------------------------------------------------------------
30
+ // Canonical ship step order (mirrors audits/workflows/ship-invariants.test.ts
31
+ // CANONICAL_SHIP_STEP_KEYS — the frozen schema). The detector cross-checks its
32
+ // source-derived set against this. Renaming a key resets attempt counters across
33
+ // three repos and orphans the detector corpus.
34
+ // ---------------------------------------------------------------------------
35
+ export const SHIP_STEP_ORDER = [
36
+ "ship-start-workflow",
37
+ "ship-worktree-setup",
38
+ "ship-regression-guard",
39
+ "ship-conflict-resolve",
40
+ "ship-deferred-sweep",
41
+ "ship-update-docs",
42
+ "ship-summary",
43
+ "ship-prune-skills",
44
+ "ship-bookkeeping-push",
45
+ "ship-merge-pr",
46
+ "ship-failure-diagnose",
47
+ "ship-failure-remediate",
48
+ "ship-switch-to-dev",
49
+ "ship-worktree-cleanup",
50
+ "ship-close-workflow",
51
+ ];
52
+ /** Steps that appear only in the merge-retry loop — never mandatory, never holes. */
53
+ const RETRY_LOOP_STEPS = new Set(["ship-failure-diagnose", "ship-failure-remediate"]);
54
+ /** The step that Path A skips (dev is ancestor → no integration needed). */
55
+ const PATH_B_ONLY_STEPS = new Set(["ship-conflict-resolve"]);
56
+ /**
57
+ * The steps a MERGED-on-entry resume skips entirely.
58
+ *
59
+ * bkit-ship.md Step 2 routes to Step 13 at sub-step 5 (`state` = MERGED), which
60
+ * is BEFORE sub-step 8 writes `ship-worktree-setup` + `ship-regression-guard` —
61
+ * so those two are absent too, not just the middle. The pre-merge docs,
62
+ * summary, prune and bookkeeping-push steps (6-8) ride the PR, so a PR that is
63
+ * already merged skips them too.
64
+ */
65
+ const MERGED_ON_ENTRY_SKIP = new Set([
66
+ "ship-worktree-setup",
67
+ "ship-regression-guard",
68
+ "ship-conflict-resolve",
69
+ "ship-deferred-sweep",
70
+ "ship-update-docs",
71
+ "ship-summary",
72
+ "ship-prune-skills",
73
+ "ship-bookkeeping-push",
74
+ "ship-merge-pr",
75
+ // failure-diagnose/remediate are already in RETRY_LOOP_STEPS (never expected)
76
+ ]);
77
+ // ---------------------------------------------------------------------------
78
+ // Source derivation — parse bkit-ship.md to find the expected step universe.
79
+ // ---------------------------------------------------------------------------
80
+ /**
81
+ * Derive the universe of ship step keys from the workflow markdown.
82
+ *
83
+ * Strategy:
84
+ * 1. Extract every `step:"ship-..."` literal from fenced code blocks.
85
+ * 2. Extract every `## … Step N — Name` heading and map the heading's section
86
+ * to the step key(s) found within it.
87
+ * 3. Return the union of all unique step keys.
88
+ *
89
+ * The two passes scan the SAME `step:"ship-*"` regex and the heading pass only
90
+ * narrows the line range, so `headingSteps` is always a subset of `literalSteps`.
91
+ * The detector reports `orphanSteps`: a status write that appears in the file but NOT
92
+ * inside any `## … Step N` section.
93
+ */
94
+ export function deriveExpectedStepSetFromSource(shipMd) {
95
+ const lines = shipMd.split("\n");
96
+ // 1. Collect every `step:"ship-..."` / `--step=ship-...` literal (anywhere — fenced or prose).
97
+ const literalSet = new Set();
98
+ const literalRe = /(?:step:"|--step=)(ship-[a-z-]+)/g;
99
+ for (const line of lines) {
100
+ let m;
101
+ while ((m = literalRe.exec(line)) !== null) {
102
+ literalSet.add(m[1]);
103
+ }
104
+ literalRe.lastIndex = 0; // reset per-line
105
+ }
106
+ // 2. Collect heading-derived steps. A `## … Step N` heading opens a section;
107
+ // the step key(s) within that section's body (until the next `## ` heading)
108
+ // belong to that step.
109
+ const headingSet = new Set();
110
+ let inStep = false;
111
+ for (const line of lines) {
112
+ if (/^##\s+.*Step\s+\d+/i.test(line)) {
113
+ inStep = true;
114
+ continue;
115
+ }
116
+ if (/^##\s+/m.test(line) && !/Step\s+\d+/i.test(line)) {
117
+ inStep = false;
118
+ continue;
119
+ }
120
+ if (inStep) {
121
+ let m;
122
+ const re = /(?:step:"|--step=)(ship-[a-z-]+)/g;
123
+ while ((m = re.exec(line)) !== null) {
124
+ headingSet.add(m[1]);
125
+ }
126
+ re.lastIndex = 0;
127
+ }
128
+ }
129
+ // 3. Union + the one asymmetry that carries signal (see the docstring).
130
+ const all = new Set([...literalSet, ...headingSet]);
131
+ const orphanSteps = [...literalSet].filter((s) => !headingSet.has(s)).sort();
132
+ return {
133
+ steps: [...all].sort(),
134
+ headingSteps: [...headingSet].sort(),
135
+ literalSteps: [...literalSet].sort(),
136
+ orphanSteps,
137
+ };
138
+ }
139
+ /**
140
+ * Cross-check the source-derived set against the frozen canonical set.
141
+ * Returns the keys that disagree (present in one but not the other).
142
+ */
143
+ export function checkSourceCanonicalDrift(sourceSteps) {
144
+ const sourceSet = new Set(sourceSteps);
145
+ const canonicalSet = new Set(SHIP_STEP_ORDER);
146
+ const drift = [];
147
+ for (const k of canonicalSet)
148
+ if (!sourceSet.has(k))
149
+ drift.push(`canonical-but-not-source:${k}`);
150
+ for (const k of sourceSet)
151
+ if (!canonicalSet.has(k))
152
+ drift.push(`source-but-not-canonical:${k}`);
153
+ return drift;
154
+ }
155
+ // ---------------------------------------------------------------------------
156
+ // Run classification + path-conditional expected sets
157
+ // ---------------------------------------------------------------------------
158
+ /**
159
+ * Classify a run based on the observed step set and whether a workflow-failed
160
+ * row was emitted. Classification logic mirrors bkit-ship.md's routing:
161
+ *
162
+ * - close-workflow present → completed (sub-classify by the Step 2 marker)
163
+ * - no regression-guard → MERGED_ON_ENTRY (Step 2 jumped to 13)
164
+ * - conflict-resolve present → PATH_B
165
+ * - else → PATH_A
166
+ * - workflow-failed present (and no close-workflow) → ABORTED
167
+ * - else → IN_PROGRESS
168
+ *
169
+ * MERGED_ON_ENTRY is decided by the explicit `ship-merged-on-entry` row that
170
+ * bkit-ship.md Step 2 sub-step 5 writes on the `state` = MERGED route. It does NOT
171
+ * key on the absence of `ship-merge-pr` / `ship-deferred-sweep`.
172
+ *
173
+ * For corpus rows without the marker, it falls back to requiring BOTH
174
+ * `ship-worktree-setup` and `ship-regression-guard` to be absent (Step 2 writes those
175
+ * two in a single fenced block); a run that dropped only one stays Path A/B.
176
+ */
177
+ export function classifyRun(observedSteps, hasWorkflowFailed, hasMergedOnEntryMarker = false) {
178
+ if (observedSteps.has("ship-close-workflow")) {
179
+ if (hasMergedOnEntryMarker)
180
+ return "MERGED_ON_ENTRY";
181
+ if (!observedSteps.has("ship-worktree-setup") && !observedSteps.has("ship-regression-guard")) {
182
+ return "MERGED_ON_ENTRY";
183
+ }
184
+ if (observedSteps.has("ship-conflict-resolve")) {
185
+ return "PATH_B";
186
+ }
187
+ return "PATH_A";
188
+ }
189
+ if (hasWorkflowFailed)
190
+ return "ABORTED";
191
+ return "IN_PROGRESS";
192
+ }
193
+ /**
194
+ * Compute the set of MANDATORY steps for a given path. Steps NOT in this set
195
+ * are optional and their absence is never a hole.
196
+ */
197
+ export function computeMandatoryForPath(path, sourceUniverse) {
198
+ const universe = new Set(sourceUniverse);
199
+ switch (path) {
200
+ case "PATH_A":
201
+ // Skip conflict-resolve + retry-loop steps
202
+ return new Set([...universe].filter((s) => !PATH_B_ONLY_STEPS.has(s) && !RETRY_LOOP_STEPS.has(s)));
203
+ case "PATH_B":
204
+ // Include conflict-resolve, skip retry-loop steps
205
+ return new Set([...universe].filter((s) => !RETRY_LOOP_STEPS.has(s)));
206
+ case "MERGED_ON_ENTRY":
207
+ // Skip the entire middle + retry-loop steps
208
+ return new Set([...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s) && !RETRY_LOOP_STEPS.has(s)));
209
+ case "ABORTED":
210
+ // No mandatory steps — the run terminated; post-abort absences are expected
211
+ return new Set();
212
+ case "IN_PROGRESS":
213
+ // Run not done — can't determine holes
214
+ return new Set();
215
+ }
216
+ }
217
+ // ---------------------------------------------------------------------------
218
+ // Hole detection
219
+ // ---------------------------------------------------------------------------
220
+ /**
221
+ * Detect holes: missing mandatory steps + unexpected (invented) steps.
222
+ *
223
+ * For ABORTED runs, the expected set is every step at or before the last
224
+ * observed step in canonical order (minus path-conditional skips). This catches
225
+ * holes BEFORE the abort point (e.g. a run that aborted at merge-pr but skipped
226
+ * regression-guard earlier).
227
+ */
228
+ export function detectHoles(observed, sourceUniverse, path) {
229
+ const universeSet = new Set(sourceUniverse);
230
+ // Unexpected = observed but not in the source universe
231
+ const unexpected = [...observed].filter((s) => !universeSet.has(s)).sort();
232
+ // Missing = mandatory but not observed
233
+ if (path === "ABORTED") {
234
+ // Determine the last observed step in canonical order
235
+ const lastObservedIdx = SHIP_STEP_ORDER.reduce((lastIdx, key, idx) => {
236
+ if (observed.has(key))
237
+ return idx;
238
+ return lastIdx;
239
+ }, -1);
240
+ if (lastObservedIdx < 0)
241
+ return { missing: [], unexpected };
242
+ // For aborted runs, expected = everything before the last step, minus
243
+ // retry-loop steps and minus conflict-resolve (unless it was observed)
244
+ const skipSet = new Set([...RETRY_LOOP_STEPS]);
245
+ if (!observed.has("ship-conflict-resolve"))
246
+ skipSet.add("ship-conflict-resolve");
247
+ const missing = [];
248
+ for (let i = 0; i <= lastObservedIdx; i++) {
249
+ const key = SHIP_STEP_ORDER[i];
250
+ if (skipSet.has(key))
251
+ continue;
252
+ if (!observed.has(key))
253
+ missing.push(key);
254
+ }
255
+ return { missing, unexpected };
256
+ }
257
+ if (path === "IN_PROGRESS") {
258
+ return { missing: [], unexpected };
259
+ }
260
+ const mandatory = computeMandatoryForPath(path, sourceUniverse);
261
+ const missing = [...mandatory].filter((s) => !observed.has(s)).sort();
262
+ return { missing, unexpected };
263
+ }
264
+ // ---------------------------------------------------------------------------
265
+ // Full audit — parse status.jsonl + ship md, classify, detect, report
266
+ // ---------------------------------------------------------------------------
267
+ export function auditStatusJsonl(statusJsonl, shipMd) {
268
+ // Derive expected set from source
269
+ const { steps: sourceUniverse, orphanSteps } = deriveExpectedStepSetFromSource(shipMd);
270
+ const sourceCanonicalDrift = checkSourceCanonicalDrift(sourceUniverse);
271
+ // Parse status rows
272
+ const rows = [];
273
+ for (const line of statusJsonl.split("\n")) {
274
+ const trimmed = line.trim();
275
+ if (!trimmed)
276
+ continue;
277
+ try {
278
+ rows.push(JSON.parse(trimmed));
279
+ }
280
+ catch (_e) {
281
+ void _e; // skip unparseable lines (advisory — never throw)
282
+ }
283
+ }
284
+ // Filter to ship step-done rows + workflow-failed rows
285
+ const shipStepRows = rows.filter((r) => r.type === "step-done" && r.workflow === "ship" && typeof r.step === "string");
286
+ const hasWorkflowFailed = rows.some((r) => r.type === "workflow-failed" && r.workflow === "ship");
287
+ const hasMergedOnEntryMarker = rows.some((r) => r.type === "ship-merged-on-entry" && r.workflow === "ship");
288
+ // Collect observed steps
289
+ const observed = new Set();
290
+ for (const r of shipStepRows) {
291
+ if (r.step)
292
+ observed.add(r.step);
293
+ }
294
+ // Classify + detect
295
+ const runPath = classifyRun(observed, hasWorkflowFailed, hasMergedOnEntryMarker);
296
+ const { missing, unexpected } = detectHoles(observed, sourceUniverse, runPath);
297
+ return {
298
+ missing,
299
+ unexpected,
300
+ path: runPath,
301
+ observed: [...observed].sort(),
302
+ sourceUniverse: [...sourceUniverse].sort(),
303
+ sourceCanonicalDrift,
304
+ orphanSteps,
305
+ };
306
+ }
307
+ // ---------------------------------------------------------------------------
308
+ // Advisory report formatter
309
+ // ---------------------------------------------------------------------------
310
+ export function formatAdvisoryReport(report) {
311
+ const lines = [];
312
+ lines.push("[bkit-status-holes] ADVISORY — fail-open (exit 0 regardless)");
313
+ lines.push(` path: ${report.path}`);
314
+ lines.push(` observed: ${report.observed.length} step(s)`);
315
+ if (report.sourceCanonicalDrift.length > 0) {
316
+ lines.push(` ⚠ source/canonical drift: ${report.sourceCanonicalDrift.join(", ")}`);
317
+ }
318
+ if (report.orphanSteps.length > 0) {
319
+ lines.push(` ⚠ recorded outside any numbered step: ${report.orphanSteps.join(", ")}`);
320
+ }
321
+ if (report.missing.length > 0) {
322
+ lines.push(` missing (mandatory for ${report.path}): ${report.missing.join(", ")}`);
323
+ }
324
+ else {
325
+ lines.push(` missing: none`);
326
+ }
327
+ if (report.unexpected.length > 0) {
328
+ lines.push(` unexpected (invented names): ${report.unexpected.join(", ")}`);
329
+ }
330
+ else {
331
+ lines.push(` unexpected: none`);
332
+ }
333
+ return lines.join("\n");
334
+ }
335
+ // ---------------------------------------------------------------------------
336
+ // CLI entry — always exits 0 (advisory / fail-open)
337
+ // ---------------------------------------------------------------------------
338
+ export function main(argv) {
339
+ const args = argv.slice(2);
340
+ // Resolve the ship-md override FIRST so its VALUE is never mistaken for a
341
+ // positional. `args.find(a => !a.startsWith("--"))` alone picks up the value
342
+ // of `--ship-md` when the flag is passed before the status path.
343
+ const mdFlagIdx = args.indexOf("--ship-md");
344
+ const shipMdOverride = mdFlagIdx >= 0 ? args[mdFlagIdx + 1] : undefined;
345
+ const consumed = new Set();
346
+ if (mdFlagIdx >= 0) {
347
+ consumed.add(mdFlagIdx);
348
+ if (shipMdOverride)
349
+ consumed.add(mdFlagIdx + 1);
350
+ }
351
+ // Every remaining positional is a status.jsonl to audit — one report each, so
352
+ // a whole corpus can be swept in one advisory CI step.
353
+ const statusPaths = args.filter((a, i) => !consumed.has(i) && !a.startsWith("--"));
354
+ if (statusPaths.length === 0) {
355
+ process.stdout.write("[bkit-status-holes] no status.jsonl path given — skipping (advisory)\n");
356
+ return; // exit 0
357
+ }
358
+ const shipMdPath = shipMdOverride || path.join(getWorkflowsRoot(), "bkit-ship.md");
359
+ let shipMd = "";
360
+ try {
361
+ shipMd = fs.readFileSync(shipMdPath, "utf-8");
362
+ }
363
+ catch {
364
+ process.stdout.write(`[bkit-status-holes] ${shipMdPath} not found — skipping (advisory)\n`);
365
+ return; // exit 0
366
+ }
367
+ for (const statusPath of statusPaths) {
368
+ // Read inputs (advisory — missing files = skip, never fail)
369
+ let statusJsonl = "";
370
+ try {
371
+ statusJsonl = fs.readFileSync(statusPath, "utf-8");
372
+ }
373
+ catch {
374
+ process.stdout.write(`[bkit-status-holes] ${statusPath} not found — skipping (advisory)\n`);
375
+ continue; // exit 0
376
+ }
377
+ const report = auditStatusJsonl(statusJsonl, shipMd);
378
+ process.stdout.write(`\n${statusPath}\n`);
379
+ process.stdout.write(formatAdvisoryReport(report) + "\n");
380
+ }
381
+ // ALWAYS exit 0 — this is advisory / fail-open
382
+ }
383
+ // Run if invoked directly (ESM-compatible main-module detection)
384
+ if (process.argv[1]) {
385
+ try {
386
+ if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
387
+ main(process.argv);
388
+ }
389
+ }
390
+ catch (_e) {
391
+ void _e; // realpathSync can fail on symlinks — skip (advisory, never crash)
392
+ }
393
+ }