@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,483 @@
1
+ // bkit ci — the gates CI and the git hooks run.
2
+ //
3
+ // `slop` — the enforcing slop gate (`slop:delta`). `lint:slop` (`slop-scan scan`) only
4
+ // reports. This gate checks the base ref out as a detached worktree, runs
5
+ // `slop-scan delta` against the working tree, and fails when the change makes the repo
6
+ // worse on NET: more findings, or a higher score. It gates on the net figures, not on
7
+ // "added": slop-scan's delta is keyed by position, so editing above a pre-existing
8
+ // finding reports it as resolved at the old line and added at the new one, netting to
9
+ // zero. The pre-existing baseline is never the change's to fix.
10
+ //
11
+ // `prose` — the prose gate (`lint:prose`): Vale over the markdown files the globs
12
+ // select. Skips with a log line when vale is not installed; restores the gitignored
13
+ // write-good package from the main worktree (else `vale sync`) when it is missing.
14
+ //
15
+ // `skip-token` — whether a commit message carries a GitHub skip-CI token
16
+ // (`SKIP_CI_TOKEN`), for the `.husky/pre-push` CI-suppressor guard.
17
+
18
+ import { spawnSync, type SpawnSyncReturns } from "node:child_process";
19
+ import * as fs from "node:fs";
20
+ import * as os from "node:os";
21
+ import * as path from "node:path";
22
+
23
+ import {
24
+ CommandError,
25
+ commitMessage,
26
+ EXIT,
27
+ git,
28
+ parseJson,
29
+ runGit,
30
+ SKIP_CI_TOKEN,
31
+ type CommandSpec,
32
+ type RunContext,
33
+ } from "../lib.js";
34
+
35
+ /** Exit code: slop-scan could not be started (not installed, not executable). */
36
+ export const EXIT_SLOP_UNAVAILABLE = 3;
37
+ /** Exit code: slop-scan ran but failed, or its JSON lacks the fields the gate reads. */
38
+ export const EXIT_SLOP_FAILED = 4;
39
+ /** Exit code: the base ref could not be checked out as a worktree. */
40
+ export const EXIT_NO_WORKTREE = 5;
41
+ /** Exit code: vale could not run, or ended with a runtime error (its exit 2). */
42
+ export const EXIT_VALE_FAILED = 6;
43
+
44
+ /** Branches whose merge-base with HEAD is the default base, in order. */
45
+ const BASE_CANDIDATES = ["origin/dev", "origin/main"];
46
+
47
+ /** A net score at or below this is float noise, not worsening. */
48
+ const SCORE_EPSILON = 0.001;
49
+
50
+ /**
51
+ * Printed on failure: names the fixes to avoid (deleting files, rewiring callers,
52
+ * casting to any). The casts are named in words; spelled as code, this string would
53
+ * itself be a type-suppression finding.
54
+ */
55
+ export const FAIL_GUIDANCE = [
56
+ "FAIL — change adds/worsens slop on net.",
57
+ "- ONLY fix net-new, NEVER the baseline. New lines matching existing patterns are consistent, NOT slop.",
58
+ "- Type-suppression (any casts, double casts through unknown, @ts-* directives): Assert real type, else Record<string, unknown>, NEVER any; suppress only with written reason.",
59
+ "- Structure/defensive (over-fragmentation, pass-through-wrapper, empty-catch, ...): Fix in place; NEVER delete/move/merge files or rewire callers to satisfy — refactors are separate decisions, NOT lint side effects.",
60
+ "Inspect: slop-scan delta --base <base-worktree> --head .",
61
+ ];
62
+
63
+ /** The `summary` fields the gate reads; each must be present. */
64
+ const SUMMARY_FIELDS = [
65
+ "addedCount",
66
+ "resolvedCount",
67
+ "worsenedCount",
68
+ "netFindingCount",
69
+ "netRepoScore",
70
+ ] as const;
71
+ type Summary = Record<(typeof SUMMARY_FIELDS)[number], number>;
72
+
73
+ const CLEANUP_SIGNALS: NodeJS.Signals[] = ["SIGINT", "SIGTERM"];
74
+
75
+ /** First of `--base`, `$SLOP_BASE_REF`, merge-base with origin/dev or origin/main, `HEAD~1`, HEAD. */
76
+ export function resolveBaseRef(cwd: string, given: string | undefined): string {
77
+ if (given) return given;
78
+ for (const cand of BASE_CANDIDATES) {
79
+ if (!runGit(cwd, ["rev-parse", "--verify", "--quiet", cand]).ok) continue;
80
+ const mb = runGit(cwd, ["merge-base", "HEAD", cand]);
81
+ if (mb.ok && mb.stdout) return mb.stdout;
82
+ }
83
+ const parent = runGit(cwd, ["rev-parse", "--verify", "--quiet", "HEAD~1"]);
84
+ return parent.ok ? parent.stdout : runGit(cwd, ["rev-parse", "HEAD"]).stdout;
85
+ }
86
+
87
+ /**
88
+ * `slop-scan` from PATH (a package script puts `node_modules/.bin` there), else the
89
+ * locally installed package through npx; `--no-install` never reaches the network.
90
+ */
91
+ export function slopScanArgv(env: NodeJS.ProcessEnv = process.env): string[] {
92
+ return onPath("slop-scan", env) ? ["slop-scan"] : ["npx", "--no-install", "slop-scan"];
93
+ }
94
+
95
+ /** Whether `bin` resolves on PATH (`command -v`). */
96
+ function onPath(bin: string, env: NodeJS.ProcessEnv = process.env): boolean {
97
+ return spawnSync("/bin/sh", ["-c", `command -v ${bin}`], { env }).status === 0;
98
+ }
99
+
100
+ /** The gate's figures from `slop-scan delta --json`, or the first field it lacks. */
101
+ export function readSummary(raw: string): Summary | { missing: string } {
102
+ const parsed = parseJson(raw);
103
+ // Not JSON at all: reported as the whole summary missing, same exit as a dropped field.
104
+ if (!parsed.ok) return { missing: "summary (output is not JSON)" };
105
+ const summary = (parsed.value as { summary?: unknown } | null)?.summary;
106
+ if (typeof summary !== "object" || summary === null) return { missing: "summary" };
107
+ const s = summary as Record<string, unknown>;
108
+ const out = {} as Summary;
109
+ for (const field of SUMMARY_FIELDS) {
110
+ if (typeof s[field] !== "number") return { missing: `summary.${field}` };
111
+ out[field] = s[field];
112
+ }
113
+ return out;
114
+ }
115
+
116
+ export const gateFails = (s: Summary): boolean =>
117
+ s.netFindingCount > 0 || s.netRepoScore > SCORE_EPSILON;
118
+
119
+ /** Whether a failed slop-scan run means it never started, rather than that it failed. */
120
+ function couldNotRun(res: ReturnType<typeof spawnSync>, viaNpx: boolean): boolean {
121
+ if ((res.error as NodeJS.ErrnoException | undefined)?.code === "ENOENT") return true;
122
+ if (res.status === 126 || res.status === 127) return true;
123
+ // npx exits 1 with this message when the package is not installed locally.
124
+ return viaNpx && /could not determine executable/i.test(String(res.stderr ?? ""));
125
+ }
126
+
127
+ /** The last 20 lines of `text`. */
128
+ const tail = (text: string) => text.trim().split("\n").slice(-20).join("\n");
129
+
130
+ /**
131
+ * Run `body`, then `cleanup` even if SIGINT / SIGTERM arrives meanwhile, then terminate as
132
+ * the signal would. Without the listeners Node dies on the signal and leaves the base
133
+ * worktree registered in the repo.
134
+ */
135
+ async function withCleanup<T>(body: () => T, cleanup: () => void): Promise<T> {
136
+ const received: NodeJS.Signals[] = [];
137
+ const onSignal = (sig: NodeJS.Signals) => received.push(sig);
138
+ for (const sig of CLEANUP_SIGNALS) process.on(sig, onSignal);
139
+ try {
140
+ return body();
141
+ } finally {
142
+ cleanup();
143
+ // A signal that arrived during a blocking spawn is dispatched on a later loop turn, and
144
+ // one turn is not always enough: on Node 20 the first `setImmediate` runs before the
145
+ // listener is called, so the signal looks absent and the process would run to completion
146
+ // (reproduced on node:20). Give the loop a bounded number of turns to deliver a pending
147
+ // signal before deciding.
148
+ for (let turn = 0; turn < 10 && received.length === 0; turn++) {
149
+ await new Promise((resolve) => setTimeout(resolve, 0));
150
+ }
151
+ for (const sig of CLEANUP_SIGNALS) process.off(sig, onSignal);
152
+ if (received[0]) {
153
+ // Exit with the conventional 128+signo rather than re-raising: Node keeps the libuv
154
+ // signal watcher installed after the last listener is removed, so `process.kill(self,
155
+ // sig)` is swallowed and the process runs to completion. A shell reads the same 143.
156
+ process.exit(128 + (os.constants.signals[received[0]] ?? 0));
157
+ }
158
+ }
159
+ }
160
+
161
+ function slop(ctx: RunContext): Promise<number> | number {
162
+ const top = runGit(ctx.cwd, ["rev-parse", "--show-toplevel"]);
163
+ if (!top.ok) throw new CommandError(EXIT.USAGE, `not inside a git repository: ${ctx.cwd}`);
164
+ const given = typeof ctx.flags.base === "string" ? ctx.flags.base : undefined;
165
+ const baseRef = resolveBaseRef(ctx.cwd, given || process.env.SLOP_BASE_REF || undefined);
166
+ const empty = { added: 0, resolved: 0, worsened: 0, netFindingCount: 0, netScore: 0 };
167
+
168
+ const sha = runGit(ctx.cwd, ["rev-parse", "--verify", "--quiet", `${baseRef}^{commit}`]);
169
+ if (!sha.ok) {
170
+ ctx.log(
171
+ `base ref '${baseRef}' not found locally — fetch it (CI needs fetch-depth: 0). Skipping.`,
172
+ );
173
+ ctx.emit({ passed: true, skipped: "base-not-found", baseRef, base: null, ...empty });
174
+ return EXIT.OK;
175
+ }
176
+ const base = sha.stdout;
177
+ if (base === runGit(ctx.cwd, ["rev-parse", "HEAD"]).stdout) {
178
+ ctx.log("base resolves to HEAD — no committed delta to check; skipping.");
179
+ ctx.emit({ passed: true, skipped: "base-is-head", baseRef, base, ...empty });
180
+ return EXIT.OK;
181
+ }
182
+
183
+ const wt = fs.mkdtempSync(path.join(os.tmpdir(), "slop-delta."));
184
+ const outDir = fs.mkdtempSync(path.join(os.tmpdir(), "slop-delta-out."));
185
+ const outFile = path.join(outDir, "delta.json");
186
+ const removeWorktree = () => {
187
+ runGit(ctx.cwd, ["worktree", "remove", "--force", wt]);
188
+ fs.rmSync(wt, { recursive: true, force: true });
189
+ fs.rmSync(outDir, { recursive: true, force: true });
190
+ };
191
+
192
+ return withCleanup(() => {
193
+ const added = runGit(ctx.cwd, ["worktree", "add", "-q", "--detach", wt, base]);
194
+ if (!added.ok) {
195
+ ctx.log(`could not check out base ${base} as a worktree: ${added.stderr}`);
196
+ return EXIT_NO_WORKTREE;
197
+ }
198
+ ctx.log(`base ${base} (${baseRef}) vs working tree`);
199
+
200
+ const argv = slopScanArgv();
201
+ const viaNpx = argv[0] === "npx";
202
+ // slop-scan calls process.exit right after writing its JSON. Into a pipe that
203
+ // drops whatever is still buffered (about 64 KB survives); into a file the
204
+ // write is synchronous, so the whole report lands.
205
+ const outFd = fs.openSync(outFile, "w");
206
+ let res: SpawnSyncReturns<string>;
207
+ try {
208
+ res = spawnSync(
209
+ argv[0]!,
210
+ [...argv.slice(1), "delta", "--base", wt, "--head", ".", "--json"],
211
+ {
212
+ cwd: top.stdout,
213
+ encoding: "utf-8",
214
+ stdio: ["ignore", outFd, "pipe"],
215
+ maxBuffer: 1 << 28,
216
+ },
217
+ );
218
+ } finally {
219
+ fs.closeSync(outFd);
220
+ }
221
+ const stdout = fs.readFileSync(outFile, "utf-8");
222
+ if (res.status !== 0) {
223
+ if (couldNotRun(res, viaNpx)) {
224
+ ctx.log(
225
+ `slop-scan could not run (${argv.join(" ")}): install it as a dev dependency, or put it on PATH`,
226
+ );
227
+ return EXIT_SLOP_UNAVAILABLE;
228
+ }
229
+ ctx.log(
230
+ `slop-scan delta failed (exit ${res.status ?? res.signal}):\n${tail(res.stderr ?? "")}`,
231
+ );
232
+ return EXIT_SLOP_FAILED;
233
+ }
234
+ const s = readSummary(stdout);
235
+ if ("missing" in s) {
236
+ ctx.log(
237
+ `slop-scan delta --json has no ${s.missing} — its output format changed; refusing to pass a gate that would check nothing`,
238
+ );
239
+ return EXIT_SLOP_FAILED;
240
+ }
241
+
242
+ ctx.log(
243
+ `added ${s.addedCount}, resolved ${s.resolvedCount}, worsened ${s.worsenedCount}; ` +
244
+ `net findings ${s.netFindingCount}, net score ${s.netRepoScore.toFixed(2)}`,
245
+ );
246
+ const failed = gateFails(s);
247
+ for (const line of failed
248
+ ? FAIL_GUIDANCE
249
+ : ["OK — no net-new or worsened findings (baseline line-shifts ignored)."]) {
250
+ ctx.log(line);
251
+ }
252
+ ctx.emit({
253
+ passed: !failed,
254
+ skipped: null,
255
+ baseRef,
256
+ base,
257
+ added: s.addedCount,
258
+ resolved: s.resolvedCount,
259
+ worsened: s.worsenedCount,
260
+ netFindingCount: s.netFindingCount,
261
+ netScore: s.netRepoScore,
262
+ });
263
+ return failed ? EXIT.NO : EXIT.OK;
264
+ }, removeWorktree);
265
+ }
266
+
267
+ // ---------------------------------------------------------------------------
268
+ // prose
269
+ // ---------------------------------------------------------------------------
270
+
271
+ /** What `bkit ci prose` lints when no `--glob` is given. */
272
+ export const DEFAULT_PROSE_GLOBS = ["**/*.md"];
273
+
274
+ /** Folders the file walk never enters. */
275
+ const WALK_SKIP = new Set(["node_modules", ".git"]);
276
+
277
+ /** Vale's write-good package: gitignored, so absent in every fresh checkout and worktree. */
278
+ const WRITE_GOOD = path.join(".vale", "styles", "write-good");
279
+
280
+ /** A `/`-separated glob (`*`, `**`, `?`) as an anchored regex over `/`-separated paths. */
281
+ export function globToRegExp(glob: string): RegExp {
282
+ let re = "";
283
+ for (let i = 0; i < glob.length; i++) {
284
+ const c = glob[i]!;
285
+ if (c === "*" && glob[i + 1] === "*") {
286
+ const slash = glob[i + 2] === "/";
287
+ re += slash ? "(?:.*/)?" : ".*";
288
+ i += slash ? 2 : 1;
289
+ } else if (c === "*") re += "[^/]*";
290
+ else if (c === "?") re += "[^/]";
291
+ else re += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
292
+ }
293
+ return new RegExp(`^${re}$`);
294
+ }
295
+
296
+ /**
297
+ * Where a glob's walk starts — its literal leading folders, `.` when it starts with a
298
+ * wildcard — and how many levels below that it can match (unbounded with `**`).
299
+ */
300
+ function globWalk(glob: string): { root: string; depth: number } {
301
+ const parts = glob.split("/");
302
+ const literal: string[] = [];
303
+ for (const part of parts.slice(0, -1)) {
304
+ if (/[*?]/.test(part)) break;
305
+ literal.push(part);
306
+ }
307
+ return {
308
+ root: literal.length > 0 ? literal.join("/") : ".",
309
+ depth: glob.includes("**") ? Infinity : parts.length - literal.length,
310
+ };
311
+ }
312
+
313
+ /**
314
+ * Every file under `root` down to `depth` levels (relative to `cwd`, `/`-separated).
315
+ * Skips WALK_SKIP folders and never follows a symlinked folder.
316
+ */
317
+ function walkFiles(cwd: string, root: string, depth: number): string[] {
318
+ const out: string[] = [];
319
+ const visit = (rel: string, level: number) => {
320
+ const abs = path.join(cwd, rel);
321
+ if (!fs.existsSync(abs)) return;
322
+ for (const ent of fs.readdirSync(abs, { withFileTypes: true })) {
323
+ const child = rel === "." ? ent.name : `${rel}/${ent.name}`;
324
+ if (ent.isDirectory()) {
325
+ if (level < depth && !WALK_SKIP.has(ent.name)) visit(child, level + 1);
326
+ } else if (ent.isFile() || ent.isSymbolicLink()) {
327
+ out.push(child);
328
+ }
329
+ }
330
+ };
331
+ visit(root, 1);
332
+ return out;
333
+ }
334
+
335
+ /** The files the globs select under `cwd`, `/`-separated, sorted, each once. */
336
+ export function proseFiles(cwd: string, globs: readonly string[]): string[] {
337
+ const files = new Set<string>();
338
+ for (const given of globs) {
339
+ const glob = given.replace(/^\.\//, "");
340
+ const re = globToRegExp(glob);
341
+ const { root, depth } = globWalk(glob);
342
+ for (const rel of walkFiles(cwd, root, depth)) {
343
+ if (re.test(rel)) files.add(rel);
344
+ }
345
+ }
346
+ return [...files].sort();
347
+ }
348
+
349
+ /**
350
+ * Put write-good back when it is missing: copy it from the main worktree (no network),
351
+ * else `vale sync`. True when it is present afterwards.
352
+ */
353
+ function restoreWriteGood(ctx: RunContext): boolean {
354
+ const target = path.join(ctx.cwd, WRITE_GOOD);
355
+ if (fs.existsSync(target)) return true;
356
+ ctx.log(".vale/styles/write-good absent (fresh checkout or worktree) - restoring");
357
+ const common = git(ctx.cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
358
+ const main = common ? path.join(path.dirname(common), WRITE_GOOD) : null;
359
+ if (main && path.resolve(main) !== path.resolve(target) && fs.existsSync(main)) {
360
+ fs.mkdirSync(path.dirname(target), { recursive: true });
361
+ fs.cpSync(main, target, { recursive: true });
362
+ return true;
363
+ }
364
+ // vale's own report goes to stderr: stdout carries this command's one JSON object.
365
+ spawnSync("vale", ["sync"], { cwd: ctx.cwd, stdio: ["ignore", 2, 2] });
366
+ return fs.existsSync(target);
367
+ }
368
+
369
+ function prose(ctx: RunContext): number {
370
+ const given = ctx.flags.glob;
371
+ const globs = Array.isArray(given) && given.length > 0 ? given : DEFAULT_PROSE_GLOBS;
372
+ const skip = (skipped: string, message: string) => {
373
+ ctx.log(message);
374
+ ctx.emit({ passed: true, skipped, files: 0 });
375
+ return EXIT.OK;
376
+ };
377
+ if (!onPath("vale")) {
378
+ return skip(
379
+ "vale-missing",
380
+ "vale not installed - skipping prose lint (install vale, then run vale sync, to enable)",
381
+ );
382
+ }
383
+ if (!restoreWriteGood(ctx)) {
384
+ return skip(
385
+ "write-good-missing",
386
+ "WARNING - PROSE LINT SKIPPED: vale is installed but .vale/styles/write-good could not be restored (main-worktree copy and vale sync both failed). The prose gate is NOT enforcing here - run: vale sync",
387
+ );
388
+ }
389
+ const files = proseFiles(ctx.cwd, globs);
390
+ if (files.length === 0) {
391
+ return skip("no-files", `no files match ${globs.join(" ")} - nothing to lint`);
392
+ }
393
+ const res = spawnSync("vale", files, { cwd: ctx.cwd, stdio: ["ignore", 2, 2] });
394
+ if (res.error || (res.status !== 0 && res.status !== 1)) {
395
+ ctx.log(`vale failed (${res.error?.message ?? `exit ${res.status ?? res.signal}`})`);
396
+ return EXIT_VALE_FAILED;
397
+ }
398
+ const passed = res.status === 0;
399
+ ctx.emit({ passed, skipped: null, files: files.length });
400
+ return passed ? EXIT.OK : EXIT.NO;
401
+ }
402
+
403
+ // ---------------------------------------------------------------------------
404
+ // skip-token
405
+ // ---------------------------------------------------------------------------
406
+
407
+ function skipToken(ctx: RunContext): number {
408
+ const ref = typeof ctx.flags.ref === "string" && ctx.flags.ref !== "" ? ctx.flags.ref : "HEAD";
409
+ const sha = git(ctx.cwd, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]);
410
+ const message = sha ? commitMessage(ctx.cwd, sha) : null;
411
+ if (!sha || message === null) {
412
+ throw new CommandError(EXIT.USAGE, `cannot read commit '${ref}' in ${ctx.cwd}`);
413
+ }
414
+ const token = SKIP_CI_TOKEN.exec(message)?.[0] ?? null;
415
+ ctx.emit({ ref, sha, token });
416
+ return token === null ? EXIT.NO : EXIT.OK;
417
+ }
418
+
419
+ export const ciCommand: CommandSpec = {
420
+ noun: "ci",
421
+ summary: "Gates CI and the git hooks run.",
422
+ verbs: {
423
+ slop: {
424
+ summary: "Fail when the working tree adds or worsens slop on net against a base ref.",
425
+ flags: [
426
+ {
427
+ name: "base",
428
+ type: "string",
429
+ positional: true,
430
+ help: "base ref (default: $SLOP_BASE_REF, else merge-base with origin/dev or origin/main, else HEAD~1)",
431
+ },
432
+ ],
433
+ output: {
434
+ passed: "false when the change adds or worsens slop on net",
435
+ skipped: "base-not-found | base-is-head when there was nothing to compare, else null",
436
+ baseRef: "the ref compared against, as resolved",
437
+ base: "its commit SHA (null when not found)",
438
+ added: "findings added (raw; a line-shift counts here)",
439
+ resolved: "findings resolved (raw)",
440
+ worsened: "findings worsened",
441
+ netFindingCount: "net change in finding count — gated on",
442
+ netScore: "net change in slop score — gated on",
443
+ },
444
+ exitCodes: {
445
+ [EXIT_SLOP_UNAVAILABLE]: "slop-scan could not run (not installed or not executable)",
446
+ [EXIT_SLOP_FAILED]: "slop-scan failed, or its JSON lacks the fields the gate reads",
447
+ [EXIT_NO_WORKTREE]: "the base ref could not be checked out as a worktree",
448
+ },
449
+ run: slop,
450
+ },
451
+ prose: {
452
+ summary:
453
+ "Run Vale over the markdown files the globs select; skip when vale is not installed.",
454
+ flags: [
455
+ {
456
+ name: "glob",
457
+ type: "string",
458
+ repeatable: true,
459
+ help: "files to lint, relative to the working directory (`*`, `**`, `?`; node_modules skipped; default `**/*.md`)",
460
+ },
461
+ ],
462
+ output: {
463
+ passed: "false when vale reported alerts",
464
+ skipped: "vale-missing | write-good-missing | no-files when nothing was linted, else null",
465
+ files: "how many files vale linted",
466
+ },
467
+ exitCodes: {
468
+ [EXIT_VALE_FAILED]: "vale could not run, or ended with a runtime error",
469
+ },
470
+ run: prose,
471
+ },
472
+ "skip-token": {
473
+ summary: "Whether a commit message carries a GitHub skip-CI token ([skip ci] and kin).",
474
+ flags: [{ name: "ref", type: "string", help: "commit to read (default HEAD)" }],
475
+ output: {
476
+ ref: "the ref read",
477
+ sha: "its commit SHA",
478
+ token: "the first skip-CI token in the message, else null",
479
+ },
480
+ run: skipToken,
481
+ },
482
+ },
483
+ };