@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,30 @@
1
+ #!/usr/bin/env bash
2
+ # Example. Copy into the repo and own it.
3
+ # bkit install does not write this file and does not overwrite a copy.
4
+ # Adapt app roots, the workspace package scope, and the rules JSON to this repo.
5
+ # Locates the serena binary without relying on an inherited PATH.
6
+ #
7
+ # .mcp.json invokes this instead of a bare `serena` because macOS apps
8
+ # launched from the Dock/Finder run under launchd, which does not inherit
9
+ # login-shell PATH — `~/.local/bin` (local's uv-tool-install target) is
10
+ # invisible there (.bkit/templates.md § Serena;
11
+ # .bkit/providers.md § macOS GUI-isolation covers the same root cause for
12
+ # Cursor/opencode). Checked in the order each environment actually
13
+ # installs it: local (uv tool install default) first, then cloud
14
+ # (.agents/context.md's `context-fetch:provision serena` — root-run setup
15
+ # script, world-readable override), then PATH as a last resort for any
16
+ # other install location.
17
+ set -euo pipefail
18
+
19
+ for candidate in "$HOME/.local/bin/serena" /usr/local/bin/serena; do
20
+ if [ -x "$candidate" ]; then
21
+ exec "$candidate" "$@"
22
+ fi
23
+ done
24
+
25
+ if command -v serena >/dev/null 2>&1; then
26
+ exec serena "$@"
27
+ fi
28
+
29
+ echo "bkit-serena-mcp.sh: serena not found in \$HOME/.local/bin, /usr/local/bin, or PATH" >&2
30
+ exit 127
@@ -0,0 +1,9 @@
1
+ {
2
+ "mcpServers": {
3
+ "serena": {
4
+ "type": "stdio",
5
+ "command": "${CLAUDE_PROJECT_DIR:-.}/scripts/serena/bkit-serena-mcp.sh",
6
+ "args": ["start-mcp-server", "--context", "claude-code", "--project-from-cwd"]
7
+ }
8
+ }
9
+ }
@@ -0,0 +1,286 @@
1
+ // Example. Copy into the repo and own it.
2
+ // bkit install does not write this file and does not overwrite a copy.
3
+ // slop-scan plugin: boundary/type-suppression + boundary/gate-suppression
4
+ //
5
+ // Flags constructs that silence the TypeScript type system at a boundary. Two families:
6
+ // - escape-hatch casts: the double cast (`<expr> as unknown as <T>`) and the
7
+ // any cast (`<expr> as any`). The object-literal target form of the double
8
+ // cast carries the highest weight.
9
+ // - compiler-suppression directives: the ts-ignore / ts-nocheck /
10
+ // ts-expect-error pragma comments (ts-nocheck disables a whole file).
11
+ // Enforces docs/testing.md § "Validated means executed".
12
+ //
13
+ // Design notes:
14
+ // - Zero imports. The only coupling to slop-scan is the finding object shape and
15
+ // meta.apiVersion. apiVersion is hard-pinned (not imported); an engine API bump
16
+ // fails at load.
17
+ // - `delta` is omitted: slop-scan then matches per location, so a pure line-shift
18
+ // of a pre-existing hit nets to zero and only new hits register as added.
19
+ // - Cast patterns use `\s+` (never a literal single space), and the directive
20
+ // pattern is split by an alternation group, so this file never flags its own
21
+ // pattern literals when the tool scans itself; slop-scan.config.json also
22
+ // carries a self-override.
23
+ // - Casts are comment-skipped (a cast inside a comment is inert); directives are
24
+ // NOT comment-skipped, because they ARE comments. Casts err toward
25
+ // under-flagging (a cast sharing a line with `//` is skipped).
26
+
27
+ const DOUBLE_CAST = /\bas\s+unknown\s+as\b/g;
28
+ const ANY_CAST = /\bas\s+any\b/g;
29
+ const TS_SUPPRESS = /@ts-(ignore|expect-error|nocheck)\b/g;
30
+
31
+ const WEIGHT = {
32
+ "object-cast": 1.5,
33
+ "double-cast": 1,
34
+ "any-cast": 1,
35
+ "ts-nocheck": 2,
36
+ "ts-ignore": 1.5,
37
+ "ts-expect-error": 1,
38
+ };
39
+
40
+ // gate-suppression: silencing a NON-type gate inline — a skipped/focused test (the
41
+ // test runner's gate) or a BLANKET linter disable. The targeted, per-rule next-line
42
+ // form is NOT flagged — only blanket disables (whole-file, or naming no rule) are.
43
+ // Each pattern puts a group right after the test fn's dot / the directive keyword (and a
44
+ // char class for the x/f prefix) so this file never matches its own pattern literals —
45
+ // same self-evasion trick as DOUBLE_CAST / TS_SUPPRESS.
46
+ const TEST_SUFFIX = /\b(?:describe|context|it|test|suite|bench)\.(skip|only)\b/g;
47
+ const TEST_GLOBAL = /(?<!\.)\b([xf])(?:it|describe|test|context)\s*\(/g;
48
+ // Blanket linter disable: a whole-file disable block or a bare directive naming no rule.
49
+ // The hyphen-group + lookahead keep it from matching this very line.
50
+ const BLANKET_LINT = /\beslint-(disable(?:-next-line|-line)?)[ \t]*(?=\*\/|\r?$)/gm;
51
+
52
+ const WEIGHT_GATE = {
53
+ "test-only": 2, // .only / f-prefixed focus — silently disables every sibling test
54
+ "test-skip": 1.5, // .skip / x-prefixed — disables this test
55
+ "lint-blanket": 1.5, // blanket eslint disable (whole-file or naming no rule)
56
+ };
57
+
58
+ /** Byte offsets where each line begins, for O(log n) index -> line/column. */
59
+ function buildLineStarts(text) {
60
+ const starts = [0];
61
+ for (let i = 0; i < text.length; i += 1) {
62
+ if (text.charCodeAt(i) === 10) {
63
+ starts.push(i + 1);
64
+ }
65
+ }
66
+ return starts;
67
+ }
68
+
69
+ /** Greatest line whose start is <= index (0-based line, 1-based column). */
70
+ function locate(lineStarts, index) {
71
+ let lo = 0;
72
+ let hi = lineStarts.length - 1;
73
+ let line = 0;
74
+ while (lo <= hi) {
75
+ const mid = (lo + hi) >> 1;
76
+ if (lineStarts[mid] <= index) {
77
+ line = mid;
78
+ lo = mid + 1;
79
+ } else {
80
+ hi = mid - 1;
81
+ }
82
+ }
83
+ return { line, column: index - lineStarts[line] + 1 };
84
+ }
85
+
86
+ /** True when the match sits inside a line comment or a block/JSDoc continuation. */
87
+ function isCommented(lineText, column) {
88
+ const before = lineText.slice(0, column - 1);
89
+ if (before.includes("//")) {
90
+ return true;
91
+ }
92
+ const trimmed = lineText.trimStart();
93
+ return trimmed.startsWith("*") || trimmed.startsWith("/*");
94
+ }
95
+
96
+ /** True when the first non-whitespace char after the cast is `{` (object-literal target). */
97
+ function targetsObjectLiteral(text, endIndex) {
98
+ let i = endIndex;
99
+ while (i < text.length && /\s/.test(text[i])) {
100
+ i += 1;
101
+ }
102
+ return text[i] === "{";
103
+ }
104
+
105
+ function collectMatches(text, regex, classify) {
106
+ const out = [];
107
+ regex.lastIndex = 0;
108
+ let match = regex.exec(text);
109
+ while (match !== null) {
110
+ out.push({ index: match.index, kind: classify(text, regex.lastIndex, match) });
111
+ match = regex.exec(text);
112
+ }
113
+ return out;
114
+ }
115
+
116
+ export default {
117
+ meta: {
118
+ name: "slop-scan-plugin-boundary",
119
+ namespace: "boundary",
120
+ // Hard-pinned (not imported) so an engine API change fails loud at load.
121
+ apiVersion: 1,
122
+ },
123
+ rules: {
124
+ "type-suppression": {
125
+ id: "boundary/type-suppression",
126
+ family: "boundary",
127
+ severity: "medium",
128
+ scope: "file",
129
+ requires: ["file.text"],
130
+ supports(context) {
131
+ return context.scope === "file" && Boolean(context.file);
132
+ },
133
+ evaluate(context) {
134
+ const file = context.file;
135
+ const text = context.runtime.store.getFileFact(file.path, "file.text") ?? "";
136
+ if (text.length === 0) {
137
+ return [];
138
+ }
139
+
140
+ const options = context.ruleConfig?.options ?? {};
141
+ const objectShapeOnly = options.objectShapeOnly === true;
142
+ const includeAnyCast = options.includeAnyCast !== false;
143
+ const includeTsSuppress = options.includeTsSuppress !== false;
144
+
145
+ // Casts — comment-skipped (a cast inside a comment is inert).
146
+ const doubles = collectMatches(text, DOUBLE_CAST, (t, end) =>
147
+ targetsObjectLiteral(t, end) ? "object-cast" : "double-cast",
148
+ );
149
+ const anys =
150
+ !objectShapeOnly && includeAnyCast
151
+ ? collectMatches(text, ANY_CAST, () => "any-cast")
152
+ : [];
153
+ const castMatches = [...doubles, ...anys].filter((m) =>
154
+ objectShapeOnly ? m.kind === "object-cast" : true,
155
+ );
156
+
157
+ // Suppression directives — NOT comment-skipped (they are comments).
158
+ const directiveMatches =
159
+ !objectShapeOnly && includeTsSuppress
160
+ ? collectMatches(text, TS_SUPPRESS, (_t, _end, match) => `ts-${match[1]}`)
161
+ : [];
162
+
163
+ if (castMatches.length === 0 && directiveMatches.length === 0) {
164
+ return [];
165
+ }
166
+
167
+ const lineStarts = buildLineStarts(text);
168
+ const lines = text.split("\n");
169
+ const toHit = (m, skipComments) => {
170
+ const { line, column } = locate(lineStarts, m.index);
171
+ const lineText = lines[line] ?? "";
172
+ if (skipComments && isCommented(lineText, column)) {
173
+ return null;
174
+ }
175
+ return { kind: m.kind, line: line + 1, column, snippet: lineText.trim().slice(0, 120) };
176
+ };
177
+
178
+ const hits = [
179
+ ...castMatches.map((m) => toHit(m, true)),
180
+ ...directiveMatches.map((m) => toHit(m, false)),
181
+ ].filter(Boolean);
182
+ if (hits.length === 0) {
183
+ return [];
184
+ }
185
+
186
+ hits.sort((a, b) => a.line - b.line || a.column - b.column);
187
+ const score = Math.min(
188
+ 10,
189
+ hits.reduce((total, h) => total + (WEIGHT[h.kind] ?? 1), 0),
190
+ );
191
+
192
+ return [
193
+ {
194
+ ruleId: "boundary/type-suppression",
195
+ family: "boundary",
196
+ severity: "medium",
197
+ scope: "file",
198
+ path: file.path,
199
+ message: `Found ${hits.length} boundary type-suppression${hits.length === 1 ? "" : "s"} (unsafe cast / ts-suppress directive); assert a real boundary signal — see docs/testing.md § "Validated means executed"`,
200
+ evidence: hits.map((h) => `line ${h.line}: ${h.kind} — ${h.snippet}`),
201
+ score,
202
+ locations: hits.map((h) => ({ path: file.path, line: h.line, column: h.column })),
203
+ },
204
+ ];
205
+ },
206
+ },
207
+ "gate-suppression": {
208
+ id: "boundary/gate-suppression",
209
+ family: "boundary",
210
+ severity: "medium",
211
+ scope: "file",
212
+ requires: ["file.text"],
213
+ supports(context) {
214
+ return context.scope === "file" && Boolean(context.file);
215
+ },
216
+ evaluate(context) {
217
+ const file = context.file;
218
+ const text = context.runtime.store.getFileFact(file.path, "file.text") ?? "";
219
+ if (text.length === 0) {
220
+ return [];
221
+ }
222
+
223
+ // Test skip/focus markers — comment-skipped (a `.skip` named in a comment is inert).
224
+ const testMatches = [
225
+ ...collectMatches(text, TEST_SUFFIX, (_t, _end, m) => `test-${m[1]}`),
226
+ ...collectMatches(text, TEST_GLOBAL, (_t, _end, m) =>
227
+ m[1] === "f" ? "test-only" : "test-skip",
228
+ ),
229
+ ];
230
+ // Blanket linter disables — NOT comment-skipped (they ARE comments).
231
+ const lintMatches = collectMatches(text, BLANKET_LINT, () => "lint-blanket");
232
+
233
+ if (testMatches.length === 0 && lintMatches.length === 0) {
234
+ return [];
235
+ }
236
+
237
+ const lineStarts = buildLineStarts(text);
238
+ const lines = text.split("\n");
239
+ const toHit = (m, skipComments) => {
240
+ const { line, column } = locate(lineStarts, m.index);
241
+ const lineText = lines[line] ?? "";
242
+ if (skipComments && isCommented(lineText, column)) {
243
+ return null;
244
+ }
245
+ return { kind: m.kind, line: line + 1, column, snippet: lineText.trim().slice(0, 120) };
246
+ };
247
+
248
+ const hits = [
249
+ ...testMatches.map((m) => toHit(m, true)),
250
+ ...lintMatches.map((m) => toHit(m, false)),
251
+ ].filter(Boolean);
252
+ if (hits.length === 0) {
253
+ return [];
254
+ }
255
+
256
+ hits.sort((a, b) => a.line - b.line || a.column - b.column);
257
+ const score = Math.min(
258
+ 10,
259
+ hits.reduce((total, h) => total + (WEIGHT_GATE[h.kind] ?? 1), 0),
260
+ );
261
+
262
+ return [
263
+ {
264
+ ruleId: "boundary/gate-suppression",
265
+ family: "boundary",
266
+ severity: "medium",
267
+ scope: "file",
268
+ path: file.path,
269
+ message: `Found ${hits.length} gate-suppression${hits.length === 1 ? "" : "s"} (skipped/focused test or blanket lint disable); fix the cause, never silence the gate — see .agents/rules.md § "Fix the code, never the gate"`,
270
+ evidence: hits.map((h) => `line ${h.line}: ${h.kind} — ${h.snippet}`),
271
+ score,
272
+ locations: hits.map((h) => ({ path: file.path, line: h.line, column: h.column })),
273
+ },
274
+ ];
275
+ },
276
+ },
277
+ },
278
+ configs: {
279
+ recommended: {
280
+ rules: {
281
+ "boundary/type-suppression": { enabled: true },
282
+ "boundary/gate-suppression": { enabled: true },
283
+ },
284
+ },
285
+ },
286
+ };
@@ -0,0 +1,120 @@
1
+ {
2
+ "ignores": [
3
+ "**/dist/**",
4
+ "**/coverage/**",
5
+ "**/node_modules/**",
6
+ "**/.next/**",
7
+ "**/.turbo/**",
8
+ "**/*.generated.ts",
9
+ "**/.agents/skills/**",
10
+ "**/.claude/skills/**",
11
+ "**/.cursor/skills/**",
12
+ "**/.bkit/templates/**"
13
+ ],
14
+ "plugins": {
15
+ "boundary": "./scripts/slop/bkit-slop-type-suppression.mjs"
16
+ },
17
+ "rules": {
18
+ "comments.placeholder-comments": {
19
+ "enabled": true,
20
+ "weight": 1.5
21
+ },
22
+ "boundary/type-suppression": {
23
+ "enabled": true
24
+ },
25
+ "boundary/gate-suppression": {
26
+ "enabled": true
27
+ },
28
+ "structure.over-fragmentation": {
29
+ "enabled": true
30
+ },
31
+ "structure.directory-fanout-hotspot": {
32
+ "enabled": true
33
+ },
34
+ "structure.duplicate-function-signatures": {
35
+ "enabled": true
36
+ },
37
+ "structure.barrel-density": {
38
+ "enabled": true
39
+ },
40
+ "structure.pass-through-wrappers": {
41
+ "enabled": true
42
+ },
43
+ "defensive.empty-catch": {
44
+ "enabled": true
45
+ },
46
+ "defensive.error-swallowing": {
47
+ "enabled": true
48
+ },
49
+ "defensive.error-obscuring": {
50
+ "enabled": true
51
+ },
52
+ "defensive.async-noise": {
53
+ "enabled": true
54
+ }
55
+ },
56
+ "overrides": [
57
+ {
58
+ "files": [
59
+ "**/*.test.ts",
60
+ "**/*.test.tsx",
61
+ "**/*.test.js",
62
+ "**/*.spec.ts",
63
+ "**/*.spec.tsx",
64
+ "**/*.spec.js"
65
+ ],
66
+ "rules": {
67
+ "tests.duplicate-mock-setup": {
68
+ "enabled": false
69
+ }
70
+ }
71
+ },
72
+ {
73
+ "files": ["scripts/slop/bkit-slop-type-suppression.mjs"],
74
+ "rules": {
75
+ "boundary/type-suppression": {
76
+ "enabled": false
77
+ },
78
+ "boundary/gate-suppression": {
79
+ "enabled": false
80
+ }
81
+ }
82
+ },
83
+ {
84
+ "files": [".opencode/plugin/bkit-gateguard.js"],
85
+ "rules": {
86
+ "defensive.empty-catch": {
87
+ "enabled": false
88
+ }
89
+ }
90
+ },
91
+ {
92
+ "files": [
93
+ "**/.claude/hooks/bkit-gateguard.cjs",
94
+ "**/.cursor/hooks/bkit-gateguard.cjs",
95
+ "**/.codex/hooks/bkit-gateguard.cjs",
96
+ "**/.opencode/plugin/bkit-gateguard.js"
97
+ ],
98
+ "rules": {
99
+ "structure.duplicate-function-signatures": {
100
+ "enabled": false
101
+ }
102
+ }
103
+ },
104
+ {
105
+ "files": [
106
+ "**/.claude/hooks/bkit-guardrails.cjs",
107
+ "**/.cursor/hooks/bkit-guardrails.cjs",
108
+ "**/.codex/hooks/bkit-guardrails.cjs"
109
+ ],
110
+ "rules": {
111
+ "defensive.empty-catch": {
112
+ "enabled": false
113
+ },
114
+ "structure.duplicate-function-signatures": {
115
+ "enabled": false
116
+ }
117
+ }
118
+ }
119
+ ]
120
+ }