@cbartens/bkit 5.5.1 → 6.1.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 (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,4 +1,4 @@
1
- // bkit counters derive|run|route|max — attempt counters derived from status.jsonl.
1
+ // bkit counters derive|run|route|grant|max — attempt counters derived from status.jsonl.
2
2
  //
3
3
  // No counter is stored. Each is counted from the log when needed, at one of three
4
4
  // positions — read this before picking `--position`:
@@ -8,27 +8,32 @@
8
8
  // be 0 there, so 0 is refused (it means the row was dropped).
9
9
  // count routing on a DIFFERENT step, prior or not yet run: the bare count, and
10
10
  // 0 is a legal answer (that step simply has not run).
11
- import { activeDoneSteps, runNumber } from "../../ledgers/status.js";
12
- import { CommandError, EXIT } from "../lib.js";
13
- import { EXIT_NO_STATUS, FILE_FLAG, STEP_FLAG, SUB_PLAN_FLAG, WORKFLOW_FLAG, positiveInt, readRuns, readStatusRows, statusFile, str, } from "./status.js";
14
- /** Every MAX_* threshold the workflows route on. */
15
- export const THRESHOLDS = {
16
- // build
17
- MAX_VERIFY_ATTEMPT: 3,
18
- MAX_TEST_ATTEMPT: 3,
19
- MAX_CHALLENGE_REMEDIATE_ATTEMPT: 1,
20
- // debug — mode-matched pairs
21
- MAX_DEBUG_ATTEMPT: 3,
22
- MAX_NORMAL_ATTEMPT: 3,
23
- MAX_SOAK_ATTEMPT: 3,
24
- // ship
25
- MAX_MERGE_ATTEMPT: 3,
26
- /** gate-refusal (10/11/14) poll-only re-entries into the sweep step */
27
- MAX_REVALIDATE_ATTEMPT: 3,
28
- // bkit-cloud.yml
29
- /** distinct failed dev CI SHAs per FID that may each dispatch a debug run */
30
- MAX_DEV_DISPATCH_ATTEMPTS: 3,
31
- };
11
+ import * as fs from "node:fs";
12
+ import * as path from "node:path";
13
+ import { activeDoneSteps, allRunsDoneSteps, appendLine, lastDoneStepAllRuns, nextStrategy, runNumber, statusTimestamp, } from "../../ledgers/status.js";
14
+ import { ASK_POINTS, readBkitConfig, } from "../../shared/settings.js";
15
+ import { headlessRun } from "./runtime.js";
16
+ import { CommandError, EXIT, git, runGit, } from "../lib.js";
17
+ import { EXIT_NO_STATUS, FILE_FLAG, GROUP_FLAG, STEP_FLAG, WORKFLOW_FLAG, positiveInt, readRuns, readStatusRows, statusFile, str, } from "./status.js";
18
+ /** An ask point by name (`build.verify`); an unknown name is a usage error. */
19
+ export function askPoint(name) {
20
+ if (!ASK_POINTS.includes(name))
21
+ throw new CommandError(EXIT.USAGE, `unknown point ${name}; known: ${ASK_POINTS.join(", ")}`);
22
+ return name;
23
+ }
24
+ /** The checkout `cwd` sits in. */
25
+ const checkoutRoot = (cwd) => git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
26
+ /** `bkit.workflows.<point>` for the checkout `cwd` sits in. */
27
+ export function askSetting(cwd, point) {
28
+ return readBkitConfig(checkoutRoot(cwd)).asks[point];
29
+ }
30
+ /** Paths a fix round's code change is judged on: everything but plan logs and ledgers. */
31
+ const SOURCE_PATHS = [
32
+ ".",
33
+ ":(exclude)docs/plans",
34
+ ":(exclude)docs/*.jsonl",
35
+ ":(exclude).bkit/*.jsonl",
36
+ ];
32
37
  /** Exit code: `--position=current` found no row — the step's own row is missing. */
33
38
  export const EXIT_NO_OWN_ROW = 4;
34
39
  const nonNegativeInt = (v, flag) => {
@@ -40,7 +45,8 @@ const nonNegativeInt = (v, flag) => {
40
45
  };
41
46
  /**
42
47
  * `--of=<step>:<position>` over `--file` / `--workflow`: the counter at that position.
43
- * `--of=<step>,<step>...:count` sums the DONE rows of every listed step.
48
+ * `--of=<step>,<step>...:count` sums the DONE rows of every listed step. `--all-runs`
49
+ * counts every run of the workflow in the file, not only the active one.
44
50
  */
45
51
  function derivedOf(ctx) {
46
52
  const [list, position] = String(ctx.flags.of).split(":");
@@ -52,43 +58,241 @@ function derivedOf(ctx) {
52
58
  if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
53
59
  throw new CommandError(EXIT.USAGE, "--of needs --file and --workflow");
54
60
  const runs = readRuns(statusFile(ctx));
55
- const subPlan = positiveInt(ctx.flags.subPlan, "sub-plan");
56
- const count = steps.reduce((n, step) => n +
57
- activeDoneSteps(runs, String(ctx.flags.workflow), { step, subPlan }, str(ctx.flags.since))
58
- .length, 0);
61
+ const group = positiveInt(ctx.flags.group, "group");
62
+ const doneSteps = ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps;
63
+ const count = steps.reduce((n, step) => n + doneSteps(runs, String(ctx.flags.workflow), { step, group }).length, 0);
59
64
  if (position === "current" && count === 0)
60
65
  throw new CommandError(EXIT_NO_OWN_ROW, `${steps[0]}: no DONE row in the active run — the step's own row is missing`);
61
66
  return position === "next" ? count + 1 : count;
62
67
  }
63
- function threshold(name) {
64
- const value = THRESHOLDS[name];
65
- if (value === undefined) {
66
- throw new CommandError(EXIT.USAGE, `unknown threshold ${name}; known: ${Object.keys(THRESHOLDS).join(", ")}`);
68
+ /** `--all-runs`: count every run of the workflow in `--file`, not only the active one. */
69
+ const ALL_RUNS_FLAG = {
70
+ name: "all-runs",
71
+ type: "boolean",
72
+ help: "count every run of the workflow in --file, not only the active one",
73
+ };
74
+ /** The `workflow-started` row that opened `workflow`'s active run; undefined with no file or no run. */
75
+ export function activeRunStart(file, workflow) {
76
+ if (!fs.existsSync(file))
77
+ return undefined;
78
+ return readStatusRows(file)
79
+ .filter((r) => r.type === "workflow-started" && r.workflow === workflow)
80
+ .sort((a, b) => String(a.at).localeCompare(String(b.at)))
81
+ .at(-1);
82
+ }
83
+ /** The point's limit as the active run froze it in its `workflow-started` row's `limits`. */
84
+ function frozenAskSetting(file, workflow, point) {
85
+ const limits = activeRunStart(file, workflow)?.limits;
86
+ const frozen = limits !== null && typeof limits === "object"
87
+ ? limits[point]
88
+ : undefined;
89
+ if (frozen === null || typeof frozen !== "object")
90
+ return undefined;
91
+ const { ask, max } = frozen;
92
+ return typeof ask === "boolean" && Number.isInteger(max) && max >= 0
93
+ ? { ask, max: max }
94
+ : undefined;
95
+ }
96
+ /** Rows of `type` in `workflow`'s active run (since its last workflow-started row). */
97
+ function typedRowCount(file, workflow, type) {
98
+ const rows = readStatusRows(file);
99
+ let start = -1;
100
+ rows.forEach((r, i) => {
101
+ if (r.type === "workflow-started" && r.workflow === workflow)
102
+ start = i;
103
+ });
104
+ return rows
105
+ .slice(start + 1)
106
+ .filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
107
+ }
108
+ /** The row `counters grant` writes: the owner gave one loop one more full allowance. */
109
+ export const ALLOWANCE_ROW = "allowance-granted";
110
+ /**
111
+ * Allowances granted to `point` (and `group`, when given) in `workflow`'s active run, or
112
+ * across every run of the file with `allRuns`.
113
+ */
114
+ export function grantCount(file, workflow, point, group, allRuns) {
115
+ if (!fs.existsSync(file))
116
+ return 0;
117
+ const rows = readStatusRows(file);
118
+ let start = -1;
119
+ if (!allRuns)
120
+ rows.forEach((r, i) => {
121
+ if (r.type === "workflow-started" && r.workflow === workflow)
122
+ start = i;
123
+ });
124
+ return rows
125
+ .slice(start + 1)
126
+ .filter((r) => r.type === ALLOWANCE_ROW &&
127
+ r.workflow === workflow &&
128
+ r.point === point &&
129
+ (group === undefined || r.group === group)).length;
130
+ }
131
+ /** A loop's frozen allowance, including the owner's saved grants; absent for legacy runs. */
132
+ export function savedPointLimit(file, workflow, point, group, allRuns = false) {
133
+ const setting = frozenAskSetting(file, workflow, point);
134
+ return setting === undefined
135
+ ? undefined
136
+ : setting.max * (1 + grantCount(file, workflow, point, group, allRuns));
137
+ }
138
+ /** `route --rows=<type>:count`: rows of that type in the active run. */
139
+ function derivedRows(ctx) {
140
+ const [type, position] = String(ctx.flags.rows).split(":");
141
+ if (!type || position !== "count")
142
+ throw new CommandError(EXIT.USAGE, "--rows must be <row type>:count");
143
+ if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
144
+ throw new CommandError(EXIT.USAGE, "--rows needs --file and --workflow");
145
+ return typedRowCount(statusFile(ctx), String(ctx.flags.workflow), type);
146
+ }
147
+ /** The checkout a status.jsonl under `docs/plans/` belongs to; `cwd` when it is elsewhere. */
148
+ function checkoutOf(file, cwd) {
149
+ const abs = path.resolve(cwd, file);
150
+ const at = abs.lastIndexOf(`${path.sep}docs${path.sep}plans${path.sep}`);
151
+ return at < 0 ? cwd : abs.slice(0, at);
152
+ }
153
+ /**
154
+ * The loop's direction from its check rounds: `worse` when the problem count rose,
155
+ * `closing` when it fell and the rounds changed code, `stuck` otherwise.
156
+ */
157
+ export function loopTrend(rounds, codeChanged) {
158
+ if (rounds.length < 2)
159
+ return "first-round";
160
+ const first = rounds[0]?.failures;
161
+ const last = rounds.at(-1)?.failures;
162
+ if (first === undefined || last === undefined)
163
+ return "stuck";
164
+ if (last > first)
165
+ return "worse";
166
+ if (last < first && codeChanged !== false)
167
+ return "closing";
168
+ return "stuck";
169
+ }
170
+ /** A fix loop's progress in the active run: `check` counts problems, `fix` fixes them. */
171
+ export function loopProgress(file, cwd, workflow, check, fix, group) {
172
+ const runs = readRuns(file);
173
+ const rounds = activeDoneSteps(runs, workflow, { step: check, group });
174
+ const fixes = activeDoneSteps(runs, workflow, { step: fix, group });
175
+ const first = rounds[0];
176
+ const last = rounds.at(-1);
177
+ let codeChanged = null;
178
+ if (first && last && first !== last && first.parentSha && last.parentSha) {
179
+ const diff = runGit(checkoutOf(file, cwd), [
180
+ "diff",
181
+ "--quiet",
182
+ first.parentSha,
183
+ last.parentSha,
184
+ "--",
185
+ ...SOURCE_PATHS,
186
+ ]);
187
+ // --quiet: exit 0 = no change, 1 = changed; anything else (unknown sha) leaves null.
188
+ if (diff.ok)
189
+ codeChanged = false;
190
+ else if (diff.stderr === "")
191
+ codeChanged = true;
67
192
  }
68
- return value;
193
+ const ladder = lastDoneStepAllRuns(runs, workflow, { step: fix, group })?.strategy;
194
+ const trend = loopTrend(rounds, codeChanged);
195
+ const span = first && last && rounds.length > 1
196
+ ? (Date.parse(last.at) - Date.parse(first.at)) / 60000 / (rounds.length - 1)
197
+ : null;
198
+ return {
199
+ rounds: rounds.map((r) => ({
200
+ attempt: r.attempt ?? null,
201
+ failures: r.failures ?? null,
202
+ at: r.at,
203
+ })),
204
+ counts: rounds.map((r) => (r.failures === undefined ? "?" : String(r.failures))).join(" → "),
205
+ codeChanged,
206
+ lastStrategy: fixes.at(-1)?.strategy ?? null,
207
+ nextStrategy: nextStrategy(ladder),
208
+ finalSpent: fixes.some((r) => r.strategy === "FINAL") || ladder === "FINAL",
209
+ minutesPerRound: span === null || Number.isNaN(span) ? null : Math.round(span),
210
+ trend,
211
+ recommend: trend === "first-round" ? null : trend === "closing" ? "try-again" : "stop",
212
+ };
213
+ }
214
+ /**
215
+ * `--point`'s limit for route and grant: the run's frozen setting (else package.json's), its
216
+ * max raised by one full allowance per `allowance-granted` row when `--file` and
217
+ * `--workflow` name the run; undefined without `--point`.
218
+ */
219
+ function pointLimit(ctx) {
220
+ if (ctx.flags.point === undefined)
221
+ return undefined;
222
+ const point = askPoint(String(ctx.flags.point));
223
+ const inRun = ctx.flags.file !== undefined && ctx.flags.workflow !== undefined;
224
+ const frozen = inRun
225
+ ? frozenAskSetting(statusFile(ctx), String(ctx.flags.workflow), point)
226
+ : undefined;
227
+ const setting = frozen ?? askSetting(ctx.cwd, point);
228
+ const grants = inRun
229
+ ? grantCount(statusFile(ctx), String(ctx.flags.workflow), point, positiveInt(ctx.flags.group, "group"), ctx.flags.allRuns === true)
230
+ : 0;
231
+ return {
232
+ point,
233
+ max: setting.max * (1 + grants),
234
+ ask: setting.ask && !headlessRun(ctx.cwd),
235
+ out: {
236
+ limitsFrom: frozen ? "run" : "package.json",
237
+ ...(inRun ? { grants, allowance: setting.max } : {}),
238
+ },
239
+ };
240
+ }
241
+ /** The flags route and grant share: the counter's value, and the limit it is compared to. */
242
+ const VALUE_FLAGS = [
243
+ { name: "name", type: "string", required: true, help: "counter name, for the log line" },
244
+ {
245
+ name: "value",
246
+ type: "string",
247
+ help: "counter value (non-negative integer), or derive it with --of / --rows",
248
+ },
249
+ {
250
+ name: "of",
251
+ type: "string",
252
+ help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
253
+ },
254
+ {
255
+ name: "rows",
256
+ type: "string",
257
+ help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
258
+ },
259
+ { ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
260
+ { ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
261
+ { ...GROUP_FLAG, help: "with --of: only rows for this task group; with --point: its grants" },
262
+ {
263
+ ...ALL_RUNS_FLAG,
264
+ help: "with --of: count every run of the workflow in --file; with --point: grants of every run",
265
+ },
266
+ ];
267
+ /** The counter's value: `--value`, or derived with `--of` and/or `--rows`. */
268
+ function counterValue(ctx) {
269
+ const derived = ctx.flags.of !== undefined || ctx.flags.rows !== undefined;
270
+ if (derived === (ctx.flags.value !== undefined))
271
+ throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
272
+ return derived
273
+ ? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
274
+ (ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
275
+ : nonNegativeInt(ctx.flags.value, "value");
69
276
  }
70
277
  export const countersCommand = {
71
278
  noun: "counters",
72
- summary: "Attempt counters derived from status.jsonl, and the MAX_* thresholds.",
279
+ summary: "Attempt counters derived from status.jsonl, and the ask points' limits.",
73
280
  verbs: {
74
281
  derive: {
75
282
  summary: "Count a step's DONE rows in the active run, at one of three positions.",
283
+ use: "workflow",
76
284
  flags: [
77
285
  FILE_FLAG,
78
286
  WORKFLOW_FLAG,
79
287
  STEP_FLAG,
80
- SUB_PLAN_FLAG,
288
+ GROUP_FLAG,
81
289
  {
82
290
  name: "position",
83
291
  type: "string",
84
292
  required: true,
85
293
  help: "next (step start: count+1) | current (after own row: count, 0 refused) | count (other step: 0 legal)",
86
294
  },
87
- {
88
- name: "since",
89
- type: "string",
90
- help: "run field holding a timestamp; only rows after it count (soakEntryAt)",
91
- },
295
+ ALL_RUNS_FLAG,
92
296
  ],
93
297
  output: { value: "the counter at that position", count: "DONE rows counted" },
94
298
  exitCodes: {
@@ -100,7 +304,7 @@ export const countersCommand = {
100
304
  if (!["next", "current", "count"].includes(position)) {
101
305
  throw new CommandError(EXIT.USAGE, "--position must be next, current, or count");
102
306
  }
103
- const count = activeDoneSteps(readRuns(statusFile(ctx)), String(ctx.flags.workflow), { step: String(ctx.flags.step), subPlan: positiveInt(ctx.flags.subPlan, "sub-plan") }, str(ctx.flags.since)).length;
307
+ const count = (ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps)(readRuns(statusFile(ctx)), String(ctx.flags.workflow), { step: String(ctx.flags.step), group: positiveInt(ctx.flags.group, "group") }).length;
104
308
  if (position === "current" && count === 0) {
105
309
  ctx.log(`${String(ctx.flags.step)}: no DONE row in the active run — the step's own row is missing`);
106
310
  return EXIT_NO_OWN_ROW;
@@ -111,6 +315,7 @@ export const countersCommand = {
111
315
  },
112
316
  run: {
113
317
  summary: "Which run of the workflow this invocation is (1-based; a resume keeps its number).",
318
+ use: "workflow",
114
319
  flags: [FILE_FLAG, WORKFLOW_FLAG],
115
320
  output: { run: "run number" },
116
321
  exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
@@ -120,29 +325,16 @@ export const countersCommand = {
120
325
  },
121
326
  },
122
327
  route: {
123
- summary: "Compare a counter to its max: exit 0 continue, exit 1 exceeded.",
328
+ summary: "Compare a counter to its max: exit 0 continue, exit 1 exceeded; with --point, also whether to ask.",
329
+ use: "workflow",
124
330
  flags: [
125
- { name: "name", type: "string", required: true, help: "counter name, for the log line" },
331
+ ...VALUE_FLAGS,
332
+ { name: "max", type: "string", help: "max as a number (or use --point)" },
126
333
  {
127
- name: "value",
334
+ name: "point",
128
335
  type: "string",
129
- help: "counter value (non-negative integer), or derive it with --of",
336
+ help: `ask point whose limit is the max: ${ASK_POINTS.join(" | ")}; with --file and --workflow, as the active run's workflow-started row froze it, else live from package.json`,
130
337
  },
131
- {
132
- name: "of",
133
- type: "string",
134
- help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
135
- },
136
- { ...FILE_FLAG, required: false, help: "status.jsonl, with --of" },
137
- { ...WORKFLOW_FLAG, required: false, help: "workflow, with --of" },
138
- { ...SUB_PLAN_FLAG, help: "with --of: only rows for this sub-plan" },
139
- {
140
- name: "since",
141
- type: "string",
142
- help: "with --of: run field holding a timestamp; only rows after it count (soakEntryAt)",
143
- },
144
- { name: "max", type: "string", help: "max as a number (or use --limit)" },
145
- { name: "limit", type: "string", help: "max as a threshold name, e.g. MAX_VERIFY_ATTEMPT" },
146
338
  { name: "continue", type: "string", help: "step to go to when value <= max" },
147
339
  { name: "exceeded", type: "string", help: "step to go to when value > max" },
148
340
  ],
@@ -151,51 +343,168 @@ export const countersCommand = {
151
343
  exceeded: "true when value > max",
152
344
  next: "--continue or --exceeded step, whichever applies (null when not given)",
153
345
  max: "the max compared against",
346
+ ask: "with --point: the point's ask setting, false when headless (GITHUB_ACTION); else false",
347
+ limitsFrom: "with --point: run (the active run's workflow-started row froze the limit) | package.json (read live: no --file / --workflow, or no frozen limit)",
348
+ grants: "with --point, --file and --workflow: allowance-granted rows for the point (and --group); max = allowance x (1 + grants)",
349
+ allowance: "with --point, --file and --workflow: one full allowance, the point's maxAttempts",
154
350
  },
155
351
  exitCodes: {
156
- [EXIT_NO_STATUS]: "--of: status.jsonl missing, unreadable, or not valid NDJSON",
352
+ [EXIT_NO_STATUS]: "--of / --rows: status.jsonl missing, unreadable, or not valid NDJSON",
157
353
  [EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
158
354
  },
159
355
  run: (ctx) => {
160
356
  const name = String(ctx.flags.name);
161
- if ((ctx.flags.value === undefined) === (ctx.flags.of === undefined))
162
- throw new CommandError(EXIT.USAGE, "give exactly one of --value or --of");
163
- const value = ctx.flags.of !== undefined ? derivedOf(ctx) : nonNegativeInt(ctx.flags.value, "value");
164
- if ((ctx.flags.max === undefined) === (ctx.flags.limit === undefined)) {
165
- throw new CommandError(EXIT.USAGE, "give exactly one of --max or --limit");
357
+ const value = counterValue(ctx);
358
+ if ((ctx.flags.max === undefined) === (ctx.flags.point === undefined)) {
359
+ throw new CommandError(EXIT.USAGE, "give exactly one of --max or --point");
166
360
  }
167
- const max = ctx.flags.limit !== undefined
168
- ? threshold(String(ctx.flags.limit))
169
- : nonNegativeInt(ctx.flags.max, "max");
361
+ const limit = pointLimit(ctx);
362
+ const max = limit === undefined ? nonNegativeInt(ctx.flags.max, "max") : limit.max;
170
363
  const exceeded = value > max;
171
364
  if (exceeded)
172
365
  ctx.log(`counter ${name} exceeded max=${max} (value=${value})`);
173
366
  ctx.emit({
174
367
  value,
175
368
  exceeded,
176
- next: str(exceeded ? ctx.flags.exceeded : ctx.flags.continue) ?? null,
369
+ next: (exceeded ? str(ctx.flags.exceeded) : str(ctx.flags.continue)) ?? null,
177
370
  max,
371
+ ask: limit?.ask ?? false,
372
+ ...(limit === undefined ? {} : limit.out),
178
373
  });
179
374
  return exceeded ? EXIT.NO : EXIT.OK;
180
375
  },
181
376
  },
377
+ grant: {
378
+ summary: "Give one loop one more full allowance after the owner chose to continue at its used-up limit: exit 0 granted, exit 1 not (below the limit, ask off or headless).",
379
+ use: "workflow",
380
+ flags: [
381
+ ...VALUE_FLAGS,
382
+ {
383
+ name: "point",
384
+ type: "string",
385
+ required: true,
386
+ help: `the loop's ask point: ${ASK_POINTS.join(" | ")}`,
387
+ },
388
+ ],
389
+ output: {
390
+ granted: "true when an allowance-granted row was appended",
391
+ reason: "why nothing was granted: below-limit | ask-off (ask = false, or headless); null when granted",
392
+ value: "the counter compared",
393
+ max: "the limit after the grant",
394
+ grants: "allowance-granted rows for the point (and --group) after the grant",
395
+ },
396
+ exitCodes: {
397
+ [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON",
398
+ [EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
399
+ },
400
+ run: (ctx) => {
401
+ if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
402
+ throw new CommandError(EXIT.USAGE, "grant needs --file and --workflow");
403
+ const file = statusFile(ctx);
404
+ if (!fs.existsSync(file))
405
+ throw new CommandError(EXIT_NO_STATUS, `${file} does not exist`);
406
+ const value = counterValue(ctx);
407
+ const limit = pointLimit(ctx);
408
+ const grants = Number(limit.out.grants);
409
+ const refuse = (reason) => {
410
+ ctx.log(`counter ${String(ctx.flags.name)}: no allowance granted (${reason})`);
411
+ ctx.emit({ granted: false, reason, value, max: limit.max, grants });
412
+ return EXIT.NO;
413
+ };
414
+ if (!limit.ask)
415
+ return refuse("ask-off");
416
+ if (value < limit.max)
417
+ return refuse("below-limit");
418
+ const group = positiveInt(ctx.flags.group, "group");
419
+ const row = {
420
+ type: ALLOWANCE_ROW,
421
+ workflow: String(ctx.flags.workflow),
422
+ at: statusTimestamp(),
423
+ point: limit.point,
424
+ ...(group === undefined ? {} : { group }),
425
+ value,
426
+ };
427
+ fs.appendFileSync(file, appendLine(row));
428
+ const max = limit.max + Number(limit.out.allowance);
429
+ ctx.log(`counter ${String(ctx.flags.name)}: one more allowance for ${limit.point}, max=${max}`);
430
+ ctx.emit({ granted: true, reason: null, value, max, grants: grants + 1 });
431
+ return EXIT.OK;
432
+ },
433
+ },
182
434
  max: {
183
- summary: "The MAX_* thresholds: one by --name, or all.",
435
+ summary: "The ask points' limits and ask settings: one by --point, or all.",
436
+ use: "workflow",
184
437
  flags: [
185
- { name: "name", type: "string", help: "threshold name, e.g. MAX_DEV_DISPATCH_ATTEMPTS" },
438
+ { name: "point", type: "string", help: "ask point, e.g. debug.fix" },
439
+ {
440
+ ...FILE_FLAG,
441
+ required: false,
442
+ help: "status.jsonl: with --point and --workflow, the limit as the active run's workflow-started row froze it",
443
+ },
444
+ { ...WORKFLOW_FLAG, required: false, help: "workflow, with --file" },
445
+ GROUP_FLAG,
186
446
  ],
187
447
  output: {
188
- value: "the named threshold (with --name)",
189
- thresholds: "every threshold (without --name)",
448
+ value: "the point's limit (with --point)",
449
+ ask: "the point's ask setting, false when headless (with --point)",
450
+ limitsFrom: "run (the active run's workflow-started row froze the limit) | package.json (with --point)",
451
+ grants: "with --point, --file and --workflow: allowance-granted rows for the point; value = allowance x (1 + grants)",
452
+ allowance: "with --point, --file and --workflow: one full allowance, the point's maxAttempts",
453
+ points: "every point's {ask, max} as set (without --point)",
190
454
  },
191
455
  run: (ctx) => {
192
- const name = str(ctx.flags.name);
193
- ctx.emit(name === undefined ? { thresholds: THRESHOLDS } : { value: threshold(name) });
456
+ const name = str(ctx.flags.point);
457
+ if (name === undefined) {
458
+ ctx.emit({ points: readBkitConfig(checkoutRoot(ctx.cwd)).asks });
459
+ return EXIT.OK;
460
+ }
461
+ const limit = pointLimit(ctx);
462
+ ctx.emit({ value: limit.max, ask: limit.ask, ...limit.out });
463
+ return EXIT.OK;
464
+ },
465
+ },
466
+ progress: {
467
+ summary: "Progress report for a fix loop in the active run: counts per round, code change, strategy, trend.",
468
+ use: "workflow",
469
+ flags: [
470
+ FILE_FLAG,
471
+ WORKFLOW_FLAG,
472
+ {
473
+ name: "check",
474
+ type: "string",
475
+ required: true,
476
+ help: "the step that counts problems, e.g. build-plan-verify",
477
+ },
478
+ {
479
+ name: "fix",
480
+ type: "string",
481
+ required: true,
482
+ help: "the step that fixes them, e.g. build-plan-gaps-remediate",
483
+ },
484
+ GROUP_FLAG,
485
+ ],
486
+ output: {
487
+ rounds: "the check rounds counted: attempt, failures, at",
488
+ counts: "problem count after each round, e.g. 5 → 2",
489
+ codeChanged: "source changed between the first and last check round (null when git cannot tell)",
490
+ lastStrategy: "strategy of the last fix round (null when none ran)",
491
+ nextStrategy: "strategy the next fix round would use",
492
+ finalSpent: "true when a fix round already ran FINAL",
493
+ minutesPerRound: "average minutes between check rounds (null under two rounds)",
494
+ trend: "first-round | closing | stuck | worse",
495
+ recommend: "try-again when closing, else stop (null on the first round)",
496
+ },
497
+ exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
498
+ run: (ctx) => {
499
+ ctx.emit({
500
+ ...loopProgress(statusFile(ctx), ctx.cwd, String(ctx.flags.workflow), String(ctx.flags.check), String(ctx.flags.fix), positiveInt(ctx.flags.group, "group")),
501
+ });
194
502
  return EXIT.OK;
195
503
  },
196
504
  },
197
505
  rows: {
198
506
  summary: "Count rows of one audit type in the active run (since its workflow-started row).",
507
+ use: "workflow",
199
508
  flags: [
200
509
  FILE_FLAG,
201
510
  WORKFLOW_FLAG,
@@ -218,17 +527,7 @@ export const countersCommand = {
218
527
  const position = String(ctx.flags.position);
219
528
  if (!["next", "count"].includes(position))
220
529
  throw new CommandError(EXIT.USAGE, "--position must be next or count");
221
- const workflow = String(ctx.flags.workflow);
222
- const type = String(ctx.flags.type);
223
- const rows = readStatusRows(statusFile(ctx));
224
- let start = -1;
225
- rows.forEach((r, i) => {
226
- if (r.type === "workflow-started" && r.workflow === workflow)
227
- start = i;
228
- });
229
- const count = rows
230
- .slice(start + 1)
231
- .filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
530
+ const count = typedRowCount(statusFile(ctx), String(ctx.flags.workflow), String(ctx.flags.type));
232
531
  ctx.emit({ value: position === "next" ? count + 1 : count, count });
233
532
  return EXIT.OK;
234
533
  },