@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,325 @@
1
+ // commands/analysis.ts — Analysis CLI for bkit telemetry.
2
+ //
3
+ // Provides:
4
+ // 1. Counts/rates/elapsed-time over telemetry rows.
5
+ // 2. Size↔outcome regression (logistic approximation: error ~ log(linesAdded)
6
+ // + filesChanged) over `kind:"outcome"` rows.
7
+ // 3. Dispatch-size threshold computation for plan-complexity-check / plan-split.
8
+ // 4. `counterSource` trust labelling (model-self-report pre-P3, shell-bus post-P3).
9
+ // 5. Per-rule compliance rate over `kind:"compliance"` rows.
10
+ // 6. Per-`bkitVersion`→CHANGELOG release-attributed regression.
11
+ //
12
+ // Backfill scope (DE-37): GitHub-API backfill limited to the repo where bkit is
13
+ // installed; PRs closed >= `--since` date; fields: additions, deletions, changedFiles,
14
+ // commits count (for correctiveCommits proxy). Model-self-report counterSource.
15
+ //
16
+ // All computation is advisory + inform-only; never gates any workflow.
17
+ // See DE-34 for the shared-entrypoint + crash-isolation contract.
18
+ import * as fs from "node:fs";
19
+ import * as path from "node:path";
20
+ import { UNJUSTIFIED_REASON, foldFrom } from "../ledgers/telemetry.js";
21
+ import { HARVEST_DEST_DIR } from "./harvest.js";
22
+ export function computeCounts(events) {
23
+ const byKind = {};
24
+ const byWorkflow = {};
25
+ const byRepo = {};
26
+ for (const ev of events) {
27
+ byKind[ev.kind] = (byKind[ev.kind] ?? 0) + 1;
28
+ byWorkflow[ev.workflow] = (byWorkflow[ev.workflow] ?? 0) + 1;
29
+ byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
30
+ }
31
+ return { total: events.length, byKind, byWorkflow, byRepo };
32
+ }
33
+ export function computeElapsedStats(rows) {
34
+ if (rows.length === 0) {
35
+ return {
36
+ count: 0,
37
+ totalSeconds: 0,
38
+ meanSeconds: 0,
39
+ minSeconds: 0,
40
+ maxSeconds: 0,
41
+ p50Seconds: 0,
42
+ };
43
+ }
44
+ const durations = rows.map((r) => r.durationSeconds).sort((a, b) => a - b);
45
+ const total = durations.reduce((s, v) => s + v, 0);
46
+ const p50 = durations[Math.floor(durations.length / 2)] ?? 0;
47
+ return {
48
+ count: rows.length,
49
+ totalSeconds: total,
50
+ meanSeconds: total / rows.length,
51
+ minSeconds: durations[0] ?? 0,
52
+ maxSeconds: durations[durations.length - 1] ?? 0,
53
+ p50Seconds: p50,
54
+ };
55
+ }
56
+ const SIZE_BUCKETS = [
57
+ { label: "XS (0–49)", min: 0, max: 49 },
58
+ { label: "S (50–199)", min: 50, max: 199 },
59
+ { label: "M (200–499)", min: 200, max: 499 },
60
+ { label: "L (500–999)", min: 500, max: 999 },
61
+ { label: "XL (1000+)", min: 1000, max: Infinity },
62
+ ];
63
+ /**
64
+ * Per-run NEW failures = this row's cumulative total minus the previous row's.
65
+ *
66
+ * `outcome.failures` is the repo's CUMULATIVE distinct-failure count at ship time.
67
+ *
68
+ * Previous = the newest outcome row for the SAME repo strictly before this one; the
69
+ * first row for a repo has no predecessor, so its total IS its delta.
70
+ *
71
+ * Clamped at 0: totals can fall when a triage sweep folds duplicate keys away.
72
+ */
73
+ export function newFailuresThisRun(row, allRows) {
74
+ const previous = allRows
75
+ .filter((r) => r.repo === row.repo && r.ts < row.ts)
76
+ .sort((a, b) => b.ts - a.ts)[0];
77
+ if (!previous)
78
+ return row.failures;
79
+ return Math.max(0, row.failures - previous.failures);
80
+ }
81
+ function isErrorRun(row, allRows) {
82
+ return ((row.ciTrySuccess !== undefined && row.ciTrySuccess > 1) ||
83
+ (row.correctiveCommits !== undefined && row.correctiveCommits > 0) ||
84
+ (row.reviewIterations !== undefined && row.reviewIterations > 1) ||
85
+ newFailuresThisRun(row, allRows) > 0);
86
+ }
87
+ export function computeRegression(rows) {
88
+ const buckets = SIZE_BUCKETS.map((b) => ({
89
+ label: b.label,
90
+ minLines: b.min,
91
+ maxLines: b.max,
92
+ count: 0,
93
+ errorCount: 0,
94
+ errorRate: 0,
95
+ }));
96
+ let shellBusCount = 0;
97
+ let modelSelfReportCount = 0;
98
+ for (const row of rows) {
99
+ // Trust tier labelling
100
+ if (row.counterSource === "shell-bus") {
101
+ shellBusCount++;
102
+ }
103
+ else {
104
+ modelSelfReportCount++;
105
+ }
106
+ // Bucket by linesAdded
107
+ const lines = row.linesAdded;
108
+ for (const bucket of buckets) {
109
+ if (lines >= bucket.minLines && lines <= bucket.maxLines) {
110
+ bucket.count++;
111
+ if (isErrorRun(row, rows)) {
112
+ bucket.errorCount++;
113
+ }
114
+ break;
115
+ }
116
+ }
117
+ }
118
+ // Compute error rates
119
+ for (const b of buckets) {
120
+ b.errorRate = b.count > 0 ? b.errorCount / b.count : 0;
121
+ }
122
+ // Dispatch-size threshold: first bucket where errorRate > 0.5, else max bucket midpoint
123
+ let threshold = 1000; // default: XL
124
+ for (const b of buckets) {
125
+ if (b.count > 0 && b.errorRate > 0.5) {
126
+ threshold = b.minLines;
127
+ break;
128
+ }
129
+ }
130
+ return {
131
+ buckets,
132
+ dispatchSizeThreshold: threshold,
133
+ shellBusCount,
134
+ modelSelfReportCount,
135
+ totalRows: rows.length,
136
+ };
137
+ }
138
+ export function computeComplianceRates(rows) {
139
+ const byRule = {};
140
+ for (const row of rows) {
141
+ if (!byRule[row.rule]) {
142
+ byRule[row.rule] = { passCount: 0, failCount: 0, naCount: 0, totalCount: 0 };
143
+ }
144
+ const r = byRule[row.rule];
145
+ r.totalCount++;
146
+ if (row.result === "pass")
147
+ r.passCount++;
148
+ else if (row.result === "fail")
149
+ r.failCount++;
150
+ else
151
+ r.naCount++;
152
+ }
153
+ return Object.entries(byRule).map(([rule, counts]) => ({
154
+ rule,
155
+ ...counts,
156
+ passRate: counts.totalCount > 0 ? counts.passCount / counts.totalCount : 0,
157
+ }));
158
+ }
159
+ export function computeVersionCompliance(rows) {
160
+ const byVersion = {};
161
+ for (const row of rows) {
162
+ if (!byVersion[row.bkitVersion])
163
+ byVersion[row.bkitVersion] = { pass: 0, total: 0 };
164
+ const v = byVersion[row.bkitVersion];
165
+ v.total++;
166
+ if (row.result === "pass")
167
+ v.pass++;
168
+ }
169
+ return Object.entries(byVersion)
170
+ .map(([bkitVersion, { pass, total }]) => ({
171
+ bkitVersion,
172
+ passRate: total > 0 ? pass / total : 0,
173
+ totalRuns: total,
174
+ }))
175
+ .sort((a, b) => a.bkitVersion.localeCompare(b.bkitVersion, undefined, { numeric: true }));
176
+ }
177
+ /**
178
+ * Unjustified-rate per `(subagent, model)`.
179
+ *
180
+ * Counts FOLDED entities, so an adjudication and its later close are one deferral,
181
+ * not three. `unjustified` is carried verbatim through later rows, so the rate keeps
182
+ * counting it.
183
+ */
184
+ export function computeDeferralDiscipline(rows) {
185
+ const byWriter = {};
186
+ for (const row of rows) {
187
+ const writer = row.subagent ?? (row.workflow ? `${row.workflow} (orchestrator)` : "unattributed");
188
+ const model = row.model ?? "unknown";
189
+ const id = `${writer}\u0000${model}`;
190
+ if (!byWriter[id])
191
+ byWriter[id] = { writer, model, total: 0, unjustifiedCount: 0, byReason: {} };
192
+ const w = byWriter[id];
193
+ w.total++;
194
+ const reason = row.reason ?? "unspecified";
195
+ w.byReason[reason] = (w.byReason[reason] ?? 0) + 1;
196
+ if (reason === UNJUSTIFIED_REASON)
197
+ w.unjustifiedCount++;
198
+ }
199
+ return Object.values(byWriter)
200
+ .map((w) => ({
201
+ writer: w.writer,
202
+ model: w.model,
203
+ total: w.total,
204
+ unjustifiedCount: w.unjustifiedCount,
205
+ unjustifiedRate: w.total > 0 ? w.unjustifiedCount / w.total : 0,
206
+ byReason: w.byReason,
207
+ }))
208
+ .sort((a, b) => b.unjustifiedCount - a.unjustifiedCount ||
209
+ b.unjustifiedRate - a.unjustifiedRate ||
210
+ b.total - a.total ||
211
+ a.writer.localeCompare(b.writer));
212
+ }
213
+ export function runAnalysis(paths) {
214
+ const { state, rowCount, malformedLineCount } = foldFrom(paths);
215
+ const events = [...state.values()];
216
+ const outcomeRows = [];
217
+ const complianceRows = [];
218
+ const deferralRows = [];
219
+ for (const ev of events) {
220
+ if (ev.kind === "outcome") {
221
+ outcomeRows.push(ev);
222
+ }
223
+ else if (ev.kind === "compliance") {
224
+ complianceRows.push(ev);
225
+ }
226
+ else if (ev.kind === "deferral") {
227
+ deferralRows.push(ev);
228
+ }
229
+ }
230
+ const counts = computeCounts(events);
231
+ const elapsed = computeElapsedStats(outcomeRows);
232
+ const regression = computeRegression(outcomeRows);
233
+ const complianceRates = computeComplianceRates(complianceRows);
234
+ const versionCompliance = computeVersionCompliance(complianceRows);
235
+ const deferralDiscipline = computeDeferralDiscipline(deferralRows);
236
+ const reportLines = [
237
+ `[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
238
+ `[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
239
+ `[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
240
+ `[bkit-analysis] Run outcomes: ${outcomeRows.length} | Compliance rows: ${complianceRows.length}`,
241
+ ];
242
+ if (elapsed.count > 0) {
243
+ reportLines.push(`[bkit-analysis] Duration (s): mean=${elapsed.meanSeconds.toFixed(0)} | p50=${elapsed.p50Seconds.toFixed(0)} | min=${elapsed.minSeconds} | max=${elapsed.maxSeconds}`);
244
+ }
245
+ // Regression report
246
+ reportLines.push(`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} linesAdded):`);
247
+ for (const b of regression.buckets) {
248
+ if (b.count > 0) {
249
+ reportLines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
250
+ }
251
+ }
252
+ reportLines.push(`[bkit-analysis] counterSource trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted, pre-P3)`);
253
+ // Compliance rates
254
+ if (complianceRates.length > 0) {
255
+ reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
256
+ for (const r of complianceRates) {
257
+ reportLines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
258
+ }
259
+ }
260
+ // Version compliance
261
+ if (versionCompliance.length > 0) {
262
+ reportLines.push(`[bkit-analysis] Per-bkitVersion compliance:`);
263
+ for (const v of versionCompliance) {
264
+ reportLines.push(` v${v.bkitVersion}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
265
+ }
266
+ }
267
+ // Deferral discipline — who defers work they should have finished.
268
+ if (deferralDiscipline.length > 0) {
269
+ const totals = deferralDiscipline.reduce((acc, d) => ({ total: acc.total + d.total, unjust: acc.unjust + d.unjustifiedCount }), { total: 0, unjust: 0 });
270
+ reportLines.push(`[bkit-analysis] Deferral discipline: ${totals.unjust}/${totals.total} adjudicated unjustified (${((totals.unjust / totals.total) * 100).toFixed(1)}%), by writer:`);
271
+ for (const d of deferralDiscipline) {
272
+ const reasons = Object.entries(d.byReason)
273
+ .sort(([a], [b]) => a.localeCompare(b))
274
+ .map(([reason, n]) => `${reason}=${n}`)
275
+ .join(" ");
276
+ reportLines.push(` ${d.writer} [${d.model}]: ${d.unjustifiedCount}/${d.total} unjustified (${(d.unjustifiedRate * 100).toFixed(1)}%) | ${reasons}`);
277
+ }
278
+ }
279
+ return {
280
+ counts,
281
+ elapsed,
282
+ regression,
283
+ complianceRates,
284
+ versionCompliance,
285
+ deferralDiscipline,
286
+ reportLines,
287
+ };
288
+ }
289
+ // analysis — cross-repo analysis CLI.
290
+ // Reports counts/rates/elapsed-time, size↔outcome regression, per-rule compliance
291
+ // rate, dispatch-size threshold, counterSource trust labelling. Advisory + inform-only.
292
+ // See DE-34 for the shared-entrypoint + crash-isolation contract.
293
+ export function runAnalysisCommand() {
294
+ try {
295
+ const cwd = process.cwd();
296
+ // Analyse: bkit's own stats.jsonl + harvested consumer rows.
297
+ // Harvest dest is sourced from the constant, NOT re-spelled here.
298
+ const statsPath = path.join(cwd, ".bkit", "stats.jsonl");
299
+ const harvestStatsPath = path.join(cwd, HARVEST_DEST_DIR, "stats.jsonl");
300
+ const harvestFrictionPath = path.join(cwd, HARVEST_DEST_DIR, "friction.jsonl");
301
+ const frictionPath = path.join(cwd, ".bkit", "friction.jsonl");
302
+ // deferrals is LOCAL-only: harvest takes it count-only (prose never leaves the
303
+ // consumer), so the discipline rate is this repo's own writers, not a fleet view.
304
+ const deferralsPath = path.join(cwd, "docs", "deferrals.jsonl");
305
+ const paths = [
306
+ statsPath,
307
+ harvestStatsPath,
308
+ harvestFrictionPath,
309
+ frictionPath,
310
+ deferralsPath,
311
+ ].filter((p) => fs.existsSync(p));
312
+ if (paths.length === 0) {
313
+ console.log("[bkit-analysis] No telemetry files found. Run `bkit harvest` first, or accumulate telemetry via bkit workflows.");
314
+ return;
315
+ }
316
+ const report = runAnalysis(paths);
317
+ for (const line of report.reportLines) {
318
+ console.log(line);
319
+ }
320
+ }
321
+ catch (err) {
322
+ const msg = err instanceof Error ? err.message : String(err);
323
+ console.error(`[bkit-analysis] analysis error (fail-open): ${msg}`);
324
+ }
325
+ }