@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,232 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ # Adapt app roots, the workspace package scope, and the rules JSON to this repo.
4
+
5
+ #!/usr/bin/env python3
6
+ """Link user-facing routes to the backend capabilities they reach.
7
+
8
+ Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
9
+ capabilities doc renders as its route layer.
10
+
11
+ bkit-graph-surface.py <graph.json> <surface-out.json> [--quiet]
12
+
13
+ THE CHAIN:
14
+
15
+ apps/web/src/app/[locale]/items/page.tsx filesystem — one page.tsx per route
16
+ -> api.v1.items | "/api/v1/items" literal at the CALLING SYMBOL
17
+ -> v1.ts .route("/v1/items", itemsRouter) + its import line
18
+ -> routes/items.ts imports @scope/services/items
19
+ -> services/items, already a lane in the register
20
+
21
+ Replace `apps/web`, `apps/mobile`, `packages/api`, and `@scope` with this repo.
22
+
23
+ Hop 1 is a literal scan (the static import graph does NOT cross the HTTP
24
+ boundary). Both call styles are read — Hono's typed RPC (`api.v1.items.$get`)
25
+ and raw URL strings (`/api/v1/items`).
26
+
27
+ ATTRIBUTION IS SYMBOL-LEVEL, NOT FILE-LEVEL. Whole-line comments are stripped,
28
+ and a literal counts for the symbol whose line range contains it. graphify gives
29
+ one line per symbol, so a symbol's range runs to the next symbol's line in the
30
+ same file.
31
+ """
32
+
33
+ import argparse
34
+ import collections
35
+ import json
36
+ import os
37
+ import re
38
+
39
+ ap = argparse.ArgumentParser()
40
+ ap.add_argument("graph_json")
41
+ ap.add_argument("surface_out")
42
+ ap.add_argument("--quiet", action="store_true")
43
+ ap.add_argument("--max-hops", type=int, default=3)
44
+ ap.add_argument("--external-rules")
45
+ args = ap.parse_args()
46
+
47
+ raw = json.load(open(args.graph_json))
48
+ ns = {n["id"]: n for n in raw["nodes"]}
49
+ WALKABLE = {"calls", "imports_from", "imports", "references", "method", "indirect_call"}
50
+
51
+ # --- symbol line ranges -----------------------------------------------------
52
+ lines_by_file = collections.defaultdict(list)
53
+ for n in raw["nodes"]:
54
+ f, loc = str(n.get("source_file") or ""), str(n.get("source_location") or "")
55
+ m = re.fullmatch(r"L(\d+)", loc)
56
+ if f and m:
57
+ lines_by_file[f].append((int(m.group(1)), n["id"]))
58
+ ranges = {}
59
+ for f, entries in lines_by_file.items():
60
+ entries.sort()
61
+ for i, (ln, nid) in enumerate(entries):
62
+ end = entries[i + 1][0] if i + 1 < len(entries) else 10**9
63
+ ranges[nid] = (ln, end)
64
+
65
+ # --- endpoint literals, comments stripped -----------------------------------
66
+ EP = re.compile(r"/api/v1/([a-z][a-z-]*)|[\"'`]/v1/([a-z][a-z-]*)|\bapi\.v1\.([a-z][a-zA-Z-]*)|\bapi\.v1\[[\"']([a-z][a-z-]*)")
67
+ _file_eps = {}
68
+
69
+
70
+ def endpoints_in(path):
71
+ """Endpoint segment -> sorted line numbers, for one file, comments removed."""
72
+ if path not in _file_eps:
73
+ out = collections.defaultdict(list)
74
+ if os.path.exists(path):
75
+ for i, line in enumerate(open(path, encoding="utf-8", errors="ignore"), 1):
76
+ s = line.strip()
77
+ if s.startswith(("//", "*", "/*")):
78
+ continue
79
+ for m in EP.finditer(line):
80
+ out[next(g for g in m.groups() if g)].append(i)
81
+ _file_eps[path] = dict(out)
82
+ return _file_eps[path]
83
+
84
+
85
+ # --- hop 1: walk out of each route file, symbol by symbol -------------------
86
+ out_edges = collections.defaultdict(list)
87
+ for l in raw["links"]:
88
+ if l.get("relation") in WALKABLE:
89
+ out_edges[l["source"]].append(l["target"])
90
+
91
+ IN_APP = ("apps/web", "apps/mobile", "packages/ui")
92
+ ROUTE_GLOBS = (
93
+ (re.compile(r"^apps/web/src/app/(.+)/page\.tsx$"), "web"),
94
+ (re.compile(r"^apps/mobile/app/(.+)\.tsx$"), "native"),
95
+ )
96
+
97
+
98
+ def route_label(path):
99
+ for rx, platform in ROUTE_GLOBS:
100
+ m = rx.match(path)
101
+ if m:
102
+ r = "/" + m.group(1)
103
+ r = re.sub(r"^/\[locale\]", "", r) or "/"
104
+ # __tests__/ and *.test.tsx sit inside apps/mobile/app, so the route
105
+ # glob matches them; they are not routes a user can navigate to.
106
+ if (r.endswith(("/_layout", ".test")) or "/+" in r or "__tests__" in r
107
+ or "/_" in r):
108
+ return None, None
109
+ return r, platform
110
+ return None, None
111
+
112
+
113
+ routes = {}
114
+ for path in sorted({str(n.get("source_file") or "") for n in raw["nodes"]}):
115
+ label, platform = route_label(path)
116
+ if label:
117
+ routes[path] = (label, platform)
118
+
119
+ surface = {}
120
+ for path, (label, platform) in routes.items():
121
+ seeds = [nid for nid, (f, _) in
122
+ ((nid, (str(ns[nid].get("source_file") or ""), 0)) for nid in ns)
123
+ if f == path]
124
+ seen, frontier = set(seeds), set(seeds)
125
+ for _ in range(args.max_hops):
126
+ nxt = set()
127
+ for nid in frontier:
128
+ for t in out_edges.get(nid, ()):
129
+ tf = str(ns.get(t, {}).get("source_file") or "")
130
+ if t not in seen and tf.startswith(IN_APP):
131
+ seen.add(t)
132
+ nxt.add(t)
133
+ frontier = nxt
134
+ hits = collections.defaultdict(set)
135
+ for nid in seen:
136
+ f = str(ns.get(nid, {}).get("source_file") or "")
137
+ lo, hi = ranges.get(nid, (0, 0))
138
+ for seg, lns in endpoints_in(f).items():
139
+ for ln in lns:
140
+ if lo <= ln < hi:
141
+ hits[seg].add(f"{f}:{ln}")
142
+ if hits:
143
+ surface[label] = {"platform": platform, "file": path,
144
+ "endpoints": {k: sorted(v) for k, v in sorted(hits.items())}}
145
+
146
+ # --- hops 2 and 3: endpoint -> router file -> service domains ---------------
147
+ v1 = open("packages/api/src/v1.ts", encoding="utf-8").read() if os.path.exists("packages/api/src/v1.ts") else ""
148
+ router_file = dict(re.findall(r'import\s*\{\s*(\w+)\s*\}\s*from\s*"\./routes/([\w-]+)\.js"', v1))
149
+ seg_router = collections.defaultdict(set)
150
+ for seg, var in re.findall(r'\.route\("/v1/([a-z][a-z-]*)",\s*(\w+)\)', v1):
151
+ if var in router_file:
152
+ seg_router[seg].add(router_file[var])
153
+
154
+ seg_services = {}
155
+ for seg, files in seg_router.items():
156
+ doms = set()
157
+ for rf in files:
158
+ p = f"packages/api/src/routes/{rf}.ts"
159
+ if os.path.exists(p):
160
+ # Replace @scope with this repo's workspace services scope.
161
+ doms |= set(re.findall(r"@scope/services/([a-z-]+)", open(p, encoding="utf-8").read()))
162
+ seg_services[seg] = {"routers": sorted(files), "services": sorted(doms)}
163
+
164
+
165
+
166
+ # --- hop 4: backend modules -> external providers ---------------------------
167
+ # SDK-first, URL-fallback: a provider is matched by SDK import, else discovered from
168
+ # a URL hostname even when no rule names it. Test code's callers are dropped by
169
+ # bkit-graphify-rollup.py's is_test_code, and social links and example hosts by
170
+ # hide_nodes in the doc, not here.
171
+ BY_MODULE = lambda p: "/".join(p.split("/")[:-1][:4]) or p.split("/")[0]
172
+ SKIP_DIR = {"node_modules", "dist", ".next", ".turbo", "coverage", "build", ".git"}
173
+ SKIP_FILE = (".test.", ".spec.", ".d.ts", ".config.")
174
+ URL = re.compile(r"https://([a-z0-9.-]+\.[a-z]{2,})(/[A-Za-z0-9/_.:-]*)?")
175
+
176
+
177
+ def scan_external(rules_path):
178
+ providers = json.load(open(rules_path))["providers"] if rules_path and os.path.exists(rules_path) else []
179
+ host_owner, sdk_owner, env_owner = {}, {}, {}
180
+ for r in providers:
181
+ for h in r.get("hosts", []):
182
+ host_owner[h] = r["provider"]
183
+ for m in r.get("sdk", []):
184
+ sdk_owner[m] = r["provider"]
185
+ for e in r.get("env", []):
186
+ env_owner[e] = r["provider"]
187
+ found = collections.defaultdict(lambda: {"endpoints": collections.defaultdict(set),
188
+ "callers": set(), "via": set()})
189
+ for root in ("packages", "apps"):
190
+ for dp, dn, fn in os.walk(root):
191
+ dn[:] = [d for d in dn if d not in SKIP_DIR]
192
+ if "/e2e" in dp or "/tests" in dp or "__tests__" in dp or "__fixtures__" in dp:
193
+ continue
194
+ for f in fn:
195
+ if not f.endswith((".ts", ".tsx")) or any(x in f for x in SKIP_FILE):
196
+ continue
197
+ path = os.path.join(dp, f)
198
+ mod = BY_MODULE(path)
199
+ for i, line in enumerate(open(path, encoding="utf-8", errors="ignore"), 1):
200
+ if line.strip().startswith(("//", "*", "/*")):
201
+ continue
202
+ for spec, prov in sdk_owner.items():
203
+ if f'from "{spec}"' in line:
204
+ found[prov]["callers"].add(mod)
205
+ found[prov]["via"].add("sdk")
206
+ for var, prov in env_owner.items():
207
+ if f"env.{var}" in line:
208
+ found[prov]["callers"].add(mod)
209
+ found[prov]["via"].add("env")
210
+ for m in URL.finditer(line):
211
+ host, sub = m.group(1), (m.group(2) or "/").rstrip("/") or "/"
212
+ prov = host_owner.get(host, host)
213
+ found[prov]["endpoints"][sub].add(f"{path}:{i}")
214
+ found[prov]["callers"].add(mod)
215
+ found[prov]["via"].add("url")
216
+ return {p: {"endpoints": {k: sorted(v) for k, v in sorted(d["endpoints"].items())},
217
+ "callers": sorted(d["callers"]), "via": sorted(d["via"])}
218
+ for p, d in sorted(found.items())}
219
+
220
+
221
+ EXTERNAL = scan_external(args.external_rules)
222
+
223
+ json.dump({"routes": surface, "endpoints": seg_services, "external": EXTERNAL},
224
+ open(args.surface_out, "w"), indent=1)
225
+
226
+ if not args.quiet:
227
+ for label, d in sorted(surface.items()):
228
+ svc = sorted({s for seg in d["endpoints"] for s in seg_services.get(seg, {}).get("services", [])})
229
+ print(f"[surface] {d['platform']:6} {label:32} {','.join(sorted(d['endpoints'])) or '—'}"
230
+ + (f" -> {','.join(svc)}" if svc else ""))
231
+ print(f"[surface] {len(surface)} routes, {len(seg_services)} endpoints, "
232
+ f"{len(EXTERNAL)} external providers -> {args.surface_out}")
@@ -0,0 +1,36 @@
1
+ # Example. Copy into the repo and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ # Adapt app roots, the workspace package scope, and the rules JSON to this repo.
4
+
5
+ #!/usr/bin/env python3
6
+ """Export the full symbol graph to GraphML for Gephi / yEd.
7
+
8
+ Called by `pnpm graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
9
+ OWN interpreter — it imports graphify itself.
10
+
11
+ bkit-graphify-graphml.py <graph.json> <out.graphml>
12
+
13
+ The graphify CLI has no --graphml flag (only the /graphify skill has one, which
14
+ this repo does not install; see docs/setup.md § Code Graph, "Never run"), so this
15
+ calls to_graphml() directly. Community IDs are carried through so Gephi can
16
+ partition on them.
17
+ """
18
+
19
+ import collections
20
+ import sys
21
+ from pathlib import Path
22
+
23
+ from graphify.affected import load_graph
24
+ from graphify.export import to_graphml
25
+
26
+ GRAPH_JSON, OUT_GRAPHML = sys.argv[1:3]
27
+
28
+ G = load_graph(Path(GRAPH_JSON))
29
+ comms = collections.defaultdict(list)
30
+ for nid, attrs in G.nodes(data=True):
31
+ c = attrs.get("community")
32
+ if c is not None:
33
+ comms[c].append(nid)
34
+ Path(OUT_GRAPHML).parent.mkdir(parents=True, exist_ok=True)
35
+ to_graphml(G, dict(comms), OUT_GRAPHML)
36
+ print(f"[graph] {G.number_of_nodes()} nodes, {G.number_of_edges()} edges, {len(comms)} communities")