@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,107 @@
1
+ # Example self-hosted Renovate runner. Copy it to `.github/workflows/bkit-renovate.yml`
2
+ # and own it.
3
+ # bkit install does not write this file and does not overwrite a copy.
4
+ # Rules live in `.github/renovate.json5` (Renovate clones the repo and reads that file).
5
+ #
6
+ # Runs `renovatebot/github-action` on `ubuntu-latest` (~16 GB).
7
+ # Edit `runs-on` yourself (a GitHub larger runner, a Depot label, or a self-hosted
8
+ # alias). Keep ≥16 GB of headroom.
9
+ #
10
+ # MUTUAL EXCLUSION: suspend the Mend Renovate App for this repo, or both open the
11
+ # same `renovate/*` PRs. GitHub UI → Settings → Applications → Renovate → Configure
12
+ # → remove this repo. No `gh api` equivalent.
13
+ #
14
+ # SHA-pin the action. This file is yours, so Renovate may bump the pin. Do NOT add
15
+ # this path to renovate.json5 `ignorePaths`.
16
+ name: Renovate
17
+
18
+ on:
19
+ workflow_dispatch:
20
+ inputs:
21
+ logLevel:
22
+ description: "Renovate log level (info | debug)"
23
+ required: false
24
+ default: "info"
25
+ type: string
26
+ dryRun:
27
+ description: "Dry-run mode (full | null)"
28
+ required: false
29
+ default: "null"
30
+ type: string
31
+ schedule:
32
+ # Wake the bot once a day, at an off-hour minute. Renovate's OWN schedule in
33
+ # renovate.json5 ("before 6am on Monday") gates when normal update PRs open;
34
+ # osvVulnerabilityAlerts CVE PRs bypass it and open on the next daily wake.
35
+ # Do NOT narrow this cron to Monday-only.
36
+ - cron: "17 6 * * *"
37
+
38
+ # Least privilege: Renovate authenticates EVERY GitHub operation with BKIT_GH_TOKEN
39
+ # below (a fine-grained PAT or App token — NOT GITHUB_TOKEN). The job GITHUB_TOKEN
40
+ # needs no write scope.
41
+ permissions:
42
+ contents: read
43
+
44
+ # Serialise runs — one Renovate process at a time on the renovate/* branches and the
45
+ # Dependency Dashboard issue. Queue, never cancel.
46
+ concurrency:
47
+ group: renovate
48
+ cancel-in-progress: false
49
+
50
+ jobs:
51
+ renovate:
52
+ runs-on: ubuntu-latest # ~16 GB. Edit this label in your copy.
53
+ timeout-minutes: 30
54
+ steps:
55
+ # No checkout / configurationFile: Renovate clones the repo itself and
56
+ # autodiscovers `.github/renovate.json5` as the repo config from the default
57
+ # branch — the same file Mend reads. (For a MULTI-repo self-hosted bot instead,
58
+ # split a global config.js and pass it via `configurationFile:`.)
59
+ #
60
+ # HARDENING (durable, no annual expiry) — mint a GitHub App token instead of a
61
+ # PAT. Add before this step:
62
+ # - uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
63
+ # id: app-token
64
+ # with:
65
+ # app-id: ${{ secrets.RENOVATE_APP_ID }}
66
+ # private-key: ${{ secrets.RENOVATE_APP_PRIVATE_KEY }}
67
+ # then set `token: ${{ steps.app-token.outputs.token }}` below.
68
+ - uses: renovatebot/github-action@dd5302ec17783b2fc721b19ae7209b57b1587765 # v46.1.17
69
+ with:
70
+ # Fine-grained PAT secret (default). Repository permissions (this repo):
71
+ # Contents: Read and write · Pull requests: Read and write ·
72
+ # Workflows: Read and write (the github-actions manager edits
73
+ # .github/workflows/* SHAs) · Issues: Read and write (Dependency Dashboard) ·
74
+ # Dependabot alerts: Read (GitHub's vulnerability feed) · Metadata: Read-only.
75
+ # (Personal-account tokens only: Account permission "Email addresses: Read" lets
76
+ # Renovate use your verified email as the git author — org-owned tokens have no
77
+ # such permission, so set RENOVATE_GIT_AUTHOR below instead.)
78
+ token: ${{ secrets.BKIT_GH_TOKEN }}
79
+ env:
80
+ # Scope to THIS repo only — never org-wide autodiscover.
81
+ RENOVATE_REPOSITORIES: ${{ github.repository }}
82
+ RENOVATE_AUTODISCOVER: "false"
83
+ RENOVATE_PLATFORM: github
84
+ # Commit author for Renovate's branches. Optional but recommended on ORG repos:
85
+ # org-owned fine-grained PATs cannot grant "Email addresses", so Renovate can't
86
+ # read your email and falls back to the Mend bot author (Unverified commits).
87
+ # Set the repo variable RENOVATE_GIT_AUTHOR (Settings -> Secrets and variables ->
88
+ # Actions -> Variables), e.g. `Renovate Bot <renovate@your-domain>`. Leave the
89
+ # variable unset on personal-account repos where the token has Email addresses: Read.
90
+ RENOVATE_GIT_AUTHOR: ${{ vars.RENOVATE_GIT_AUTHOR }}
91
+ # allowedEnv is a GLOBAL-only Renovate option (security): it allow-lists which
92
+ # env-var names the repo config's `env:` block may set. renovate.json5 ships
93
+ # `env: { PNPM_WORKERS, PNPM_MAX_WORKERS }` — without this the config
94
+ # is REJECTED ("Env variable name PNPM_WORKERS is not allowed by this bot's
95
+ # allowedEnv") and Renovate does nothing. Mend allows these via its safeEnv
96
+ # preset; self-hosted must set it explicitly. Glob covers any future PNPM_* var.
97
+ RENOVATE_ALLOWED_ENV: "PNPM_*"
98
+ # Private-registry read auth for the restricted @cbartens/bkit package.
99
+ # Leave the hostRules token line in renovate.json5 commented. BKIT_GH_TOKEN_INSTALL
100
+ # (read:packages) is a repo Actions secret. See docs/deployments.md § Dependency updaters.
101
+ RENOVATE_HOST_RULES: >-
102
+ [{"matchHost":"npm.pkg.github.com","hostType":"npm","token":"${{ secrets.BKIT_GH_TOKEN_INSTALL }}"}]
103
+ LOG_LEVEL: ${{ inputs.logLevel || 'info' }}
104
+ RENOVATE_DRY_RUN: ${{ inputs.dryRun || 'null' }}
105
+ # This env block declares NO ANTHROPIC_API_KEY / BKIT_LINEAR_API_KEY
106
+ # — the Renovate runner must never see them (docs/security.md § Supply-Chain
107
+ # token isolation). Do not add them.
@@ -0,0 +1,108 @@
1
+ # Example. Copy to `.graphifyignore` and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ # graphify corpus scope. Same syntax as .gitignore.
4
+ # .gitignore is read automatically and merged with this file; patterns here are
5
+ # evaluated last and only ever exclude more. Everything already ignored by
6
+ # .gitignore (node_modules/, dist/, migration/, *.csv, tmp/, .worktrees/) needs
7
+ # no entry here.
8
+
9
+ # ---------------------------------------------------------------------------
10
+ # 1. Everything an LLM would have to read.
11
+ #
12
+ # graphify parses code locally with tree-sitter and never calls a model for it.
13
+ # Docs, PDFs, images, office files and video are the ONLY paths that reach a
14
+ # backend. `--code-only` skips them per run, but that flag is per-invocation and
15
+ # there is no persistent equivalent — .graphifyrc supports only viz_node_limit
16
+ # and no GRAPHIFY_CODE_ONLY env var exists. Excluding the file types here makes
17
+ # the corpus structurally code-only, so a bare `graphify extract .` or
18
+ # `/graphify .` has nothing to send even without the flag.
19
+ #
20
+ # Counts at time of writing: 4148 .md, 52 .png, 27 .html, 22 .yaml/.yml, 8 .pdf,
21
+ # 7 .txt, 5 .jpg/.jpeg, 2 .xlsx, 2 .docx. `*.md` alone leaves 125 files behind.
22
+ *.md
23
+ *.mdx
24
+ *.qmd
25
+ *.rst
26
+ *.txt
27
+ *.html
28
+ *.yaml
29
+ *.yml
30
+ *.pdf
31
+ *.docx
32
+ *.xlsx
33
+ *.png
34
+ *.jpg
35
+ *.jpeg
36
+ *.webp
37
+ *.gif
38
+ # graphify's image detection is wider than the extensions its README lists.
39
+ # With only the four documented types excluded, a run still reported
40
+ # "7 non-code file(s) (0 docs, 0 papers, 7 images)" — 3 .svg, 2 .heic, 2 .avif.
41
+ # The rest of the raster set is listed so the guarantee survives someone
42
+ # committing a .bmp rather than breaking silently.
43
+ *.svg
44
+ *.heic
45
+ *.avif
46
+ *.bmp
47
+ *.tif
48
+ *.tiff
49
+ *.ico
50
+ *.heif
51
+ *.mp4
52
+ *.mov
53
+ *.mp3
54
+ *.wav
55
+
56
+ # Four binary image fixtures (photo.heic / photo.avif under
57
+ # packages/services/src/inbound/__fixtures__/attachments/ and
58
+ # apps/run/docling/benchmark/corpus/) still appear on the extract's
59
+ # "skipping N non-code file(s)" line and do NOT respond to any ignore rule,
60
+ # including excluding their directory outright. That counter is computed before
61
+ # ignore filtering for the image class; graphify's source contains no reference
62
+ # to "heic" or "avif", so it classifies them from the OS mime database. They
63
+ # never enter manifest.json, so nothing reads them. Do NOT exclude those two
64
+ # directories to zero the counter — both contain real TypeScript (corpus.ts,
65
+ # expected.ts, manifest.ts) and dropping them costs 23 code nodes.
66
+
67
+ # ---------------------------------------------------------------------------
68
+ # 2. Agent harness — config, hooks and tool state, not application code.
69
+ # Left in, these contributed ~450 nodes and dominated the god-node ranking:
70
+ # .opencode/opencode.json alone yielded 112 nodes and .claude/settings.json 71.
71
+ # .serena/ self-ignores only its cache and project.local.yml, so the rest of it
72
+ # is visible to graphify; it is another agent's working state either way.
73
+ .agents/skills/
74
+ .bkit/
75
+ .claude/
76
+ .codex/
77
+ .cursor/
78
+ .opencode/
79
+ .serena/
80
+
81
+ # Generated plan and design artefacts. The markdown is already covered above;
82
+ # this line is for the 27 .json and 59 .jsonl files under the same tree, which
83
+ # graphify treats as code.
84
+ docs/plans/
85
+
86
+ # ---------------------------------------------------------------------------
87
+ # 3. Build and tooling JSON. `.json` is a code extension to graphify, so these
88
+ # are parsed as source and every top-level key becomes a node with no manifest
89
+ # semantics behind it — 206 nodes of task and env-var names for turbo.json,
90
+ # whose `globalEnv` key ranks as a god node at 41 edges when parsed.
91
+ #
92
+ # package.json is NOT excluded, and must never be. graphify reads the workspace
93
+ # `name` fields out of the CORPUS to resolve a workspace package specifier;
94
+ # excluding package.json silently destroys cross-package resolution. Measured on
95
+ # this repo with identical tsconfigs: 104 cross-package edges over 4 package
96
+ # pairs with it excluded, 217 over 35 with it present. It is worth the two noise
97
+ # nodes it costs (`scripts` and `test`, the JSON keys shared by 22 workspaces).
98
+ #
99
+ # tsconfig.json IS excluded and that is safe — graphify reads tsconfig `paths`
100
+ # whether or not the file is in the corpus. Verified by A/B: identical
101
+ # cross-package edge counts either way.
102
+ **/turbo.json
103
+ **/tsconfig.json
104
+
105
+ # ---------------------------------------------------------------------------
106
+ # Deliberately NOT excluded: apps/web/e2e/ (321 nodes) and **/*.test.ts. They
107
+ # are real code with real call edges, and dropping them would blind the
108
+ # `graphify affected` blast-radius query to its test callers.
@@ -0,0 +1,16 @@
1
+ #!/usr/bin/env sh
2
+ # bkit pre-commit. Example. Copy into the repo and own it.
3
+ # bkit install does not write this file and does not overwrite a copy.
4
+ #
5
+ # FAST local gate only: format staged files (seconds). Heavier gates
6
+ # (typecheck/unit/format:check/prose) and the enforcing slop gate (slop:delta) are in
7
+ # pre-push; integration/E2E/@live run ONLY in CI (bkit-tests / bkit-tests-live, enforced
8
+ # by bkit-tests-check) — see bkit-ci.yml § FULL CI SCAFFOLD REFERENCE. Rule: anything needing
9
+ # a deployed URL, a DB, or >a few seconds belongs in a CI tier, not a hook. (lint:slop is `slop-scan scan` — report-only, never
10
+ # fails; the gate that fails on NEW findings is `slop:delta`, which runs in pre-push.)
11
+ #
12
+ # WHAT it runs lives in package.json `bkit:gate:format`, not here — the same script
13
+ # the bkit agent workflows dispatch through; change the gate there. Add repo-specific
14
+ # extras BELOW this line.
15
+ set -e
16
+ pnpm bkit:gate:format
@@ -0,0 +1,91 @@
1
+ #!/usr/bin/env sh
2
+ # bkit pre-push. Example. Copy into the repo and own it.
3
+ # bkit install does not write this file and does not overwrite a copy.
4
+ #
5
+ # FAST deterministic gates only: the `bkit:gate` script (typecheck + unit tests +
6
+ # format:check + prose + the enforcing slop gate) plus the bkit drift gate (no
7
+ # Docker/network) — the full deterministic mirror of CI. Heavier tiers run in CI, NOT
8
+ # here: integration + E2E -> bkit-tests (gated on web_affected / run_e2e); @live ->
9
+ # bkit-tests-live; "did the planned tiers run?" -> bkit-tests-check. See bkit-ci.yml § FULL
10
+ # CI SCAFFOLD REFERENCE — keep slow/network/deploy checks OUT. Turbo monorepos: scope
11
+ # tests inside the `bkit:gate*` scripts with
12
+ # `--filter="...[origin/<default>]"`; never add integration/E2E/@live.
13
+ #
14
+ # Revert-branch bypass: on a revert branch the suite is skipped; lint + typecheck still run.
15
+ set -e
16
+
17
+ # ── delete-only push: nothing leaves this machine, so there is nothing to gate ──
18
+ # `git push origin --delete <branch>` runs this hook too. Git feeds one line per ref on
19
+ # stdin — "<local-ref> <local-sha> <remote-ref> <remote-sha>" — and a deleted ref has an
20
+ # all-zero local sha. When EVERY line is a delete, the push carries no commits. A push
21
+ # mixing a delete with a real update still gates, and so does an empty ref list. Reading
22
+ # stdin here is safe: every later command redirects from /dev/null. `[ -t 0 ]` keeps a
23
+ # hand-run hook from hanging.
24
+ PUSH_SAW_REF=0
25
+ PUSH_HAS_COMMITS=0
26
+ if [ ! -t 0 ]; then
27
+ while read -r _push_local_ref push_local_sha _push_remote_ref _push_remote_sha; do
28
+ [ -n "$push_local_sha" ] || continue
29
+ PUSH_SAW_REF=1
30
+ case "$push_local_sha" in
31
+ *[!0]*) PUSH_HAS_COMMITS=1 ;;
32
+ esac
33
+ done
34
+ fi
35
+ if [ "$PUSH_SAW_REF" = "1" ] && [ "$PUSH_HAS_COMMITS" = "0" ]; then
36
+ echo "[pre-push] delete-only push — no commits to check, gates skipped" >&2
37
+ exit 0
38
+ fi
39
+ # ── end delete-only push
40
+
41
+ BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
42
+ HEAD_SUBJECT=$(git log -1 --pretty=%s 2>/dev/null || echo "")
43
+ IS_REVERT=0
44
+ case "$BRANCH" in
45
+ revert-*) IS_REVERT=1 ;;
46
+ esac
47
+ case "$HEAD_SUBJECT" in
48
+ 'Revert "'*) IS_REVERT=1 ;;
49
+ esac
50
+
51
+ # CI-suppressor HEAD guard: blocks a push whose HEAD commit carries a [skip ci]-class
52
+ # token while the branch has an OPEN PR (that token silences GitHub's pull_request
53
+ # trigger). Covers manual pushes (rebase + force-push, post-close commits). No open PR
54
+ # -> allowed ([skip ci] pushes for mid-loop status, abort handover). dev/main exempt;
55
+ # gh absent -> allow. `bkit ci skip-token` exits 0 when HEAD's message carries one of
56
+ # the tokens GitHub honours; bkit owns that list.
57
+ case "$BRANCH" in
58
+ dev|main) ;;
59
+ *)
60
+ if pnpm -s bkit ci skip-token < /dev/null > /dev/null; then
61
+ if command -v gh >/dev/null 2>&1; then
62
+ # strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
63
+ OPEN_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$BRANCH" --state open --json number --jq '.[0].number' 2>/dev/null || echo "")
64
+ if [ -n "$OPEN_PR" ]; then
65
+ echo "[pre-push] BLOCKED: HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open — its checks would stay vacuously green." >&2
66
+ echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
67
+ exit 1
68
+ fi
69
+ else
70
+ echo "[pre-push] WARN: HEAD on '$BRANCH' carries a CI-suppressing token but gh is unavailable to check for an open PR; allowing. If a PR is open, ensure HEAD triggers CI." >&2
71
+ fi
72
+ fi
73
+ ;;
74
+ esac
75
+
76
+ # WHAT each gate runs lives in package.json, not here — the same `bkit:gate*` scripts
77
+ # the bkit agent workflows and prompts dispatch through. Edit the scripts, not this
78
+ # hook. Repo-specific extras go BELOW this block.
79
+ # Revert path drops the suite only: prose and slop:delta still run.
80
+ if [ "$IS_REVERT" = "1" ]; then
81
+ echo "[pre-push] revert branch/commit detected — skipping the test suite"
82
+ pnpm bkit:gate:static < /dev/null
83
+ else
84
+ pnpm bkit:gate:static-unit < /dev/null
85
+ fi
86
+
87
+ # bkit mirror-drift gate — fails fast if `.agents/*` was edited without `bkit install`
88
+ # regenerating the `.claude/*`/`.cursor/*` mirrors (same check CI runs).
89
+ # Outside the gate scripts: it validates the bkit install, not your source.
90
+ # Fix: `pnpm bkit install`, stage the regenerated files, commit, push.
91
+ pnpm bkit check < /dev/null
@@ -0,0 +1,3 @@
1
+ {
2
+ "*": "prettier --write --ignore-unknown"
3
+ }
@@ -0,0 +1,41 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+
4
+ node_modules/
5
+ dist/
6
+ .agents/skills/
7
+ # Canonical-overwrite content (CANONICAL_OVERWRITE_RELPATHS in bkit's install engine):
8
+ # bkit force-overwrites these on every install, so consumer prettier must not
9
+ # lint them. Width-sensitive rewrites would be reverted next install. The
10
+ # .opencode agent + command mirrors are force-overwritten just like .claude /
11
+ # .cursor (the managed-version marker and transform output are the source of
12
+ # truth, not a prettier rewrite). .opencode/plugin/ is listed for the same
13
+ # reason as .claude/ and .cursor/: its hook is a render of the template, and
14
+ # leaving it lintable would let prettier reformat the mirror but not the two ignored
15
+ # twins, silently diverging three copies that must stay byte-identical.
16
+ .claude/
17
+ .cursor/
18
+ .codex/
19
+ .opencode/agents/
20
+ .opencode/commands/
21
+ .opencode/plugin/
22
+ .github/
23
+ .husky/_/
24
+ *.tsbuildinfo
25
+ pnpm-lock.yaml
26
+ # bkit-written / reconciled files — bkit writes these with its own JSON.stringify
27
+ # layout (2-space, expanded arrays) and consumers have no prettier at install
28
+ # time, so prettier must not reformat them or the next install / `bkit check`
29
+ # would just revert the rewrite (permanent drift).
30
+ .mcp.json
31
+ .bkit/.env.example
32
+ .opencode/opencode.json
33
+ # Generated projection — `bkit roadmap fold` FULLY regenerates the
34
+ # `roadmap-status` marker block on every workflow close, emitting unpadded
35
+ # markdown tables. Prettier would re-pad them, so the committed board would
36
+ # never be byte-equal to what the renderer emits and every close would carry a
37
+ # formatting-only diff. The fold's output is the source of truth.
38
+ docs/roadmap.md
39
+ # bkit's reference copies of its templates — refreshed by `bkit upgrade`, never
40
+ # formatted by this repo.
41
+ .bkit/templates/
@@ -0,0 +1,243 @@
1
+ # Example. Copy to `.serena/project.yml` and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ # Set project_name and typescript_version to this repo.
4
+ # typescript_version must match package.json, not Serena's bundled compiler.
5
+ # the name by which the project can be referenced within Serena/when chatting with the LLM.
6
+ project_name: "your-repo"
7
+
8
+ # list of language servers to start when using the LSP backend; choose from:
9
+ # ada al angular ansible bash
10
+ # bsl clojure cpp cpp_ccls crystal
11
+ # csharp csharp_omnisharp cue dart deno
12
+ # elixir elm erlang fortran fsharp
13
+ # gdscript gleam go groovy haskell
14
+ # haxe hlsl html java json
15
+ # julia kotlin latex lean4 lua
16
+ # luau markdown matlab msl nextflow
17
+ # nix ocaml pascal perl php
18
+ # php_phpactor php_phpantom powershell python python_basedpyright
19
+ # python_jedi python_pyrefly python_ty qml r
20
+ # rego ruby ruby_solargraph rust scala
21
+ # scss solidity svelte swift systemverilog
22
+ # terraform toml typescript typescript_vts vue
23
+ # wolfram yaml zig
24
+ # (This list may be outdated; generated with scripts/print_language_list.py;
25
+ # For the current list, see values of the LanguageServerId enum here:
26
+ # https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py)
27
+ # For some languages, there are several alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
28
+ # Note:
29
+ # - For C, use cpp
30
+ # - For JavaScript, use typescript
31
+ # - For Angular projects, use angular (subsumes typescript+html; requires `npm install` in the project root)
32
+ # - For Svelte projects, use svelte (subsumes typescript/javascript for .svelte projects; requires npm)
33
+ # - For Deno projects, use deno (serves the same .ts/.js files as typescript; requires the deno CLI on PATH)
34
+ # - For SCSS / Sass / plain CSS, use scss (some-sass-language-server handles all three)
35
+ # - For Free Pascal/Lazarus, use pascal
36
+ # Special requirements:
37
+ # Some language servers require additional setup/installations.
38
+ # See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
39
+ # When using multiple language servers, the first language server that supports a given file will be used for that file.
40
+ # The first language server is the default language and the respective language server will be used as a fallback.
41
+ # Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
42
+ language_servers:
43
+ - typescript
44
+
45
+ # the encoding used by text files in the project
46
+ # For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
47
+ encoding: "utf-8"
48
+
49
+ # optional shell command to run before the language backend (LSP or JetBrains) is initialised.
50
+ # the command runs in the project root directory and is only executed if the project is trusted
51
+ # (see trusted_project_path_patterns in the global configuration).
52
+ # serena waits for the command to exit: a non-zero exit code is logged as an error but does not
53
+ # abort activation. a per-project timeout (activation_command_timeout, default 180s) is the safety
54
+ # backstop for non-terminating commands; on expiry the process is killed and activation continues.
55
+ # example: activation_command: "npx nx run-many -t build"
56
+ activation_command:
57
+
58
+ # maximum time in seconds to wait for activation_command to complete before killing it (default 180s).
59
+ # must be a positive number.
60
+ activation_command_timeout: 180
61
+
62
+ # line ending convention to use when writing source files.
63
+ # Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default)
64
+ # This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings.
65
+ line_ending:
66
+
67
+ # The language backend to use for this project.
68
+ # If not set, the global setting from serena_config.yml is used.
69
+ # Valid values: LSP, JetBrains
70
+ # Note: the backend is fixed at startup. If a project with a different backend
71
+ # is activated post-init, an error will be returned.
72
+ language_backend:
73
+
74
+ # whether to use project's .gitignore files to ignore files
75
+ ignore_all_files_in_gitignore: true
76
+
77
+ # advanced configuration option allowing to configure language server-specific options.
78
+ # Maps the language key to the options.
79
+ # The settings are considered only if the project is trusted (see global configuration to define trusted projects).
80
+ # See https://oraios.github.io/serena/02-usage/050_configuration.html#language-server-specific-settings
81
+ ls_specific_settings:
82
+ typescript:
83
+ # tsserver has to resolve the whole project graph before it emits its first
84
+ # $/progress token, and on a repo this size that takes longer than Serena's
85
+ # 5s default grace — past which Serena assumes no indexing was needed and
86
+ # answers a cross-file reference query from a half-built graph.
87
+ indexing_start_grace: 30.0
88
+ indexing_timeout: 180.0
89
+ # Match the repo's own TypeScript (package.json) instead of Serena's bundled
90
+ # 5.9.3, so the server analyses the code with the compiler that compiles it.
91
+ # TypeScript 7+ ships no tsserver and the server will not start on it: keep
92
+ # 5.9.3 there. Ignored unless this project is trusted (see above).
93
+ typescript_version: "5.9.3"
94
+
95
+ # list of workspace folder paths (LSP backend only).
96
+ # These folders will be used to build up Serena's symbol index.
97
+ # Paths must be within the project root and should thus be relative to the project root.
98
+ # Furthermore, the paths should not be filtered by ignore settings.
99
+ # Default setting: The entire project root folder (".") is considered.
100
+ # In (large) monorepos, this can be used to index only subfolders of the project root, e.g.
101
+ # ls_workspace_folders:
102
+ # - "./subproject1"
103
+ # - "./subproject2"
104
+ ls_workspace_folders: ["."]
105
+
106
+ # list of additional workspace folder paths for cross-package reference support.
107
+ # Paths can be absolute or relative to the project root.
108
+ # Each folder is registered as an LSP workspace folder, enabling language servers to discover
109
+ # symbols and references across package boundaries, but these folders are not indexed by Serena,
110
+ # i.e. the respective symbols will not be found using Serena's symbol search tools.
111
+ # Example:
112
+ # additional_workspace_folders:
113
+ # - ../sibling-package
114
+ # - ../shared-lib
115
+ ls_additional_workspace_folders: []
116
+
117
+ # list of additional paths to ignore in this project.
118
+ # Same syntax as gitignore, so you can use * and **.
119
+ # Important: quote patterns that start with `*`, otherwise YAML treats them as aliases.
120
+ # Example:
121
+ # ignored_paths:
122
+ # - "examples/**"
123
+ # - ".worktrees/**"
124
+ # - "**/bin/**"
125
+ # - "**/obj/**"
126
+ # Note: global ignored_paths from serena_config.yml are also applied additively.
127
+ ignored_paths:
128
+ # Anything gitignored is already out (ignore_all_files_in_gitignore above), so
129
+ # docs/graphify-out/, graph.json, node_modules/, packages/*/dist/, migration/ and
130
+ # coverage/ need no entry here. What follows is tracked code that still must
131
+ # not be indexed.
132
+ #
133
+ # Full-tree checkouts of this same repo. Gitignored too, listed anyway because
134
+ # indexing them would return every symbol twice from find_referencing_symbols.
135
+ - ".worktrees/**"
136
+ - ".slop-scan-base/**"
137
+ - ".claude/worktrees/**"
138
+ # Agent harness, not application code. gateguard exists three times over —
139
+ # .claude/hooks/bkit-gateguard.cjs and .cursor/hooks/bkit-gateguard.cjs are byte-
140
+ # identical and .opencode/plugin/bkit-gateguard.js is the same logic as an ES
141
+ # module — so one symbol answers three times. Left in, this is also what the
142
+ # language server reaches first: `serena project health-check` picked
143
+ # alreadyWarned() out of gateguard as the repo's sample symbol.
144
+ - ".claude/**"
145
+ - ".cursor/**"
146
+ - ".opencode/**"
147
+ - ".bkit/**"
148
+ - ".agents/skills/**"
149
+ # Committed compiler output that duplicates TypeScript source. Drop the
150
+ # line if this repo has none.
151
+ - "apps/mobile/dist-plugins/**"
152
+
153
+ # whether the project is in read-only mode
154
+ # If set to true, all editing tools will be disabled and attempts to use them will result in an error
155
+ # Added on 2025-04-18
156
+ read_only: true
157
+
158
+ # list of tool names to exclude.
159
+ # This extends the existing exclusions (e.g. from the global configuration)
160
+ # Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
161
+ # bkit agents are granted every Serena tool (`mcp__serena__*`), so this list is
162
+ # what keeps Serena read-only for them: it excludes every tool that writes files,
163
+ # memories or project config, runs code or commands, or opens a browser, across
164
+ # all contexts (claude-code, ide, codex). Serena edits bypass the Edit/Write hooks
165
+ # that gate every other agent edit. read_only above refuses the editing tools at
166
+ # call time but does NOT remove them from the tools/list the client sees (measured
167
+ # on 1.7.0). Remove an entry only to let agents use that tool.
168
+ excluded_tools:
169
+ - "activate_project"
170
+ - "create_text_file"
171
+ - "delete_lines"
172
+ - "delete_memory"
173
+ - "edit_memory"
174
+ - "execute_shell_command"
175
+ - "insert_after_symbol"
176
+ - "insert_at_line"
177
+ - "insert_before_symbol"
178
+ - "jet_brains_debug"
179
+ - "jet_brains_inline_symbol"
180
+ - "jet_brains_move"
181
+ - "jet_brains_rename"
182
+ - "jet_brains_safe_delete"
183
+ - "onboarding"
184
+ - "open_dashboard"
185
+ - "remove_project"
186
+ - "rename_memory"
187
+ - "rename_symbol"
188
+ - "replace_content"
189
+ - "replace_in_files"
190
+ - "replace_lines"
191
+ - "replace_symbol_body"
192
+ - "safe_delete_symbol"
193
+ - "write_memory"
194
+
195
+ # list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default).
196
+ # This extends the existing inclusions (e.g. from the global configuration).
197
+ # Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
198
+ included_optional_tools: []
199
+
200
+ # fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
201
+ # This cannot be combined with non-empty excluded_tools or included_optional_tools.
202
+ # Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
203
+ fixed_tools: []
204
+
205
+ # list of mode names that are to be activated by default, overriding the setting in the global configuration.
206
+ # The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
207
+ # If the setting is undefined/empty, the default_modes from the global configuration (serena_config.yml) apply.
208
+ # Otherwise, this overrides the setting from the global configuration (serena_config.yml).
209
+ # Therefore, you can set this to [] if you do not want the default modes defined in the global config to apply
210
+ # for this project.
211
+ # This setting can, in turn, be overridden by CLI parameters (--mode).
212
+ # See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
213
+ default_modes:
214
+
215
+ # list of mode names to be activated additionally for this project, e.g. ["query-projects"]
216
+ # The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
217
+ # See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
218
+ # no-memories: this repo's knowledge lives in docs/*.md and the append-only
219
+ # docs/*.jsonl ledgers. A second, unmanaged store under .serena/memories/ would
220
+ # drift from them with nothing keeping the two consistent.
221
+ added_modes: ["no-memories"]
222
+
223
+ # initial prompt for the project. It will always be given to the LLM upon activating the project
224
+ # (contrary to the memories, which are loaded on demand).
225
+ initial_prompt: ""
226
+
227
+ # time budget (seconds) per tool call for the retrieval of additional symbol information
228
+ # such as docstrings or parameter information.
229
+ # This overrides the corresponding setting in the global configuration; see the documentation there.
230
+ # If null or missing, use the setting from the global configuration.
231
+ symbol_info_budget:
232
+
233
+ # list of regex patterns which, when matched, mark a memory entry as read‑only.
234
+ # Extends the list from the global configuration, merging the two lists.
235
+ read_only_memory_patterns: []
236
+
237
+ # list of regex patterns for memories to completely ignore.
238
+ # Matching memories will not appear in list_memories or activate_project output
239
+ # and cannot be accessed via read_memory or write_memory.
240
+ # To access ignored memory files, use the read_file tool on the raw file path.
241
+ # Extends the list from the global configuration, merging the two lists.
242
+ # Example: ["_archive/.*", "_episodes/.*"]
243
+ ignored_memory_patterns: []
@@ -0,0 +1,11 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ extends: existence
4
+ message: "Filler: '%s' — delete."
5
+ level: warning
6
+ tokens:
7
+ - basically
8
+ - essentially
9
+ - as mentioned
10
+ - it should be noted
11
+ - as a matter of fact
@@ -0,0 +1,12 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ extends: existence
4
+ message: "Hedging: '%s' — remove or commit to a position."
5
+ level: warning
6
+ tokens:
7
+ - it seems like
8
+ - perhaps
9
+ - might be
10
+ - arguably
11
+ - it's worth noting
12
+ - it could be argued
@@ -0,0 +1,13 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ extends: existence
4
+ message: "LLM slop: '%s' — rewrite in direct voice."
5
+ level: error
6
+ tokens:
7
+ - I'd be happy to
8
+ - great question
9
+ - I hope this helps
10
+ - feel free to
11
+ - don't hesitate to
12
+ - let me know if
13
+ - let me explain
@@ -0,0 +1,12 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ extends: substitution
4
+ message: "Verbose: use '%s' instead of '%s'."
5
+ level: warning
6
+ swap:
7
+ in the event that: if
8
+ at this point in time: now
9
+ in order to: to
10
+ due to the fact that: because
11
+ for the purpose of: to
12
+ on a daily basis: daily