@cbartens/bkit 0.0.0-stage → 5.0.1

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 (375) hide show
  1. package/.bkit/README.md +417 -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 +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -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 +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -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 +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -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 +867 -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 +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -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 +924 -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 +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -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/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,342 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import { updateManagedBlock, extractFullManagedBlock, extractManagedBlock, findLineAnchoredMarkers, selectMarkers, } from "./managed-block.js";
4
+ import { readTemplate } from "../render/parts.js";
5
+ import { applyTokens } from "./placeholders.js";
6
+ export function deepContains(template, consumer, pathPrefix = "") {
7
+ const missing = [];
8
+ const mismatched = [];
9
+ // null template: owns nothing → ok
10
+ if (template === null) {
11
+ return { ok: true, missing, mismatched };
12
+ }
13
+ // non-null template, null consumer → missing
14
+ if (consumer === null) {
15
+ missing.push(pathPrefix || "<root>");
16
+ return { ok: false, missing, mismatched };
17
+ }
18
+ // Both are arrays
19
+ if (Array.isArray(template) && Array.isArray(consumer)) {
20
+ _deepContainsArray(template, consumer, pathPrefix, missing);
21
+ return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
22
+ }
23
+ // Type mismatch (one is array, other is not, or different primitive types)
24
+ if (Array.isArray(template) !== Array.isArray(consumer)) {
25
+ mismatched.push(pathPrefix || "<root>");
26
+ return { ok: false, missing, mismatched };
27
+ }
28
+ // Both are plain objects
29
+ if (typeof template === "object" && typeof consumer === "object") {
30
+ const tObj = template;
31
+ const cObj = consumer;
32
+ for (const key of Object.keys(tObj)) {
33
+ const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
34
+ const tVal = tObj[key];
35
+ const cVal = cObj[key];
36
+ if (cVal === undefined) {
37
+ // If template has null for this key, still ok
38
+ if (tVal === null)
39
+ continue;
40
+ missing.push(childPath);
41
+ }
42
+ else {
43
+ const sub = deepContains(tVal, cVal, childPath);
44
+ missing.push(...sub.missing);
45
+ mismatched.push(...sub.mismatched);
46
+ }
47
+ }
48
+ return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
49
+ }
50
+ // Both are primitives — exact equality
51
+ if (template !== consumer) {
52
+ mismatched.push(pathPrefix || "<root>");
53
+ return { ok: false, missing, mismatched };
54
+ }
55
+ return { ok: true, missing, mismatched };
56
+ }
57
+ function _deepContainsArray(template, consumer, pathPrefix, missing) {
58
+ // Classify template elements as primitive or object
59
+ for (let i = 0; i < template.length; i++) {
60
+ const tEl = template[i];
61
+ const elPath = pathPrefix ? `${pathPrefix}[${i}]` : `[${i}]`;
62
+ if (tEl === null || typeof tEl !== "object") {
63
+ // Primitive — subset: consumer must contain this value
64
+ if (!consumer.includes(tEl)) {
65
+ missing.push(elPath);
66
+ }
67
+ }
68
+ else if (Array.isArray(tEl)) {
69
+ // Nested array element — must find an equal consumer element
70
+ const found = consumer.some((cEl) => Array.isArray(cEl) && deepContains(tEl, cEl, "").ok);
71
+ if (!found) {
72
+ missing.push(elPath);
73
+ }
74
+ }
75
+ else {
76
+ // Object element — order-insensitive deep-equal containment
77
+ const found = consumer.some((cEl) => cEl !== null &&
78
+ typeof cEl === "object" &&
79
+ !Array.isArray(cEl) &&
80
+ deepContains(tEl, cEl, "").ok);
81
+ if (!found) {
82
+ missing.push(elPath);
83
+ }
84
+ }
85
+ }
86
+ }
87
+ // ---------------------------------------------------------------------------
88
+ // deepMergeJson — recursive JSON merge primitive (P3.T1)
89
+ //
90
+ // Semantics (from DE-8 contract spec):
91
+ // - Objects: merge recursively (override keys win; base keys retained if absent from override)
92
+ // - Arrays: override replaces base (no concat — arrays are treated as atomic values)
93
+ // - Primitives / null: override replaces base
94
+ // ---------------------------------------------------------------------------
95
+ export function deepMergeJson(base, override) {
96
+ if (override === null || typeof override !== "object" || Array.isArray(override)) {
97
+ return override;
98
+ }
99
+ if (base === null || typeof base !== "object" || Array.isArray(base)) {
100
+ // base is not a plain object — override wins wholesale
101
+ return override;
102
+ }
103
+ // Both are plain objects — recursive merge.
104
+ //
105
+ // Key ORDER follows `override` (the bkit template) for keys it defines, then appends
106
+ // base-only (consumer) keys. Order-significant maps like opencode's last-match-wins
107
+ // `permission.bash` keep the template's order (`git push --force-with-lease*: allow`
108
+ // stays after `git push --force*: deny`).
109
+ const baseObj = base;
110
+ const overrideObj = override;
111
+ const result = {};
112
+ // 1. Template keys first, in template order (recurse where both sides are plain objects).
113
+ for (const [key, val] of Object.entries(overrideObj)) {
114
+ const baseVal = baseObj[key];
115
+ if (key in baseObj &&
116
+ baseVal !== null &&
117
+ typeof baseVal === "object" &&
118
+ !Array.isArray(baseVal) &&
119
+ val !== null &&
120
+ typeof val === "object" &&
121
+ !Array.isArray(val)) {
122
+ result[key] = deepMergeJson(baseVal, val);
123
+ }
124
+ else {
125
+ result[key] = val;
126
+ }
127
+ }
128
+ // 2. Consumer-only keys preserved, appended after the template's keys.
129
+ for (const [key, val] of Object.entries(baseObj)) {
130
+ if (!(key in result)) {
131
+ result[key] = val;
132
+ }
133
+ }
134
+ return result;
135
+ }
136
+ // ---------------------------------------------------------------------------
137
+ // writeTier2JsonContained — deep-containment JSON helper (BAR-167 Phase 1)
138
+ //
139
+ // Contract:
140
+ // - dest absent → write template as-is (first install)
141
+ // - dest present, valid JSON, template contained → no-op (idempotent)
142
+ // - dest present, valid JSON, containment fails → deepMergeJson(existing, template)
143
+ // (template wins on key collisions; consumer-only keys outside template tree preserved)
144
+ // - dest present, malformed JSON → overwrite with template
145
+ // - schemaFlipped: true when a path value changed type during deep-merge
146
+ // ---------------------------------------------------------------------------
147
+ export function writeTier2JsonContained(srcPath, dstPath, dryRun, ws) {
148
+ const srcRaw = fs.readFileSync(srcPath, "utf-8");
149
+ let template;
150
+ try {
151
+ template = JSON.parse(srcRaw);
152
+ }
153
+ catch {
154
+ throw new Error(`writeTier2JsonContained: template at ${srcPath} is not valid JSON`);
155
+ }
156
+ if (!fs.existsSync(dstPath)) {
157
+ // First install — write template as-is
158
+ ensureDir(path.dirname(dstPath));
159
+ if (!dryRun) {
160
+ fs.writeFileSync(dstPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
161
+ const srcMode = fs.statSync(srcPath).mode;
162
+ fs.chmodSync(dstPath, srcMode);
163
+ }
164
+ ws.writes.push({ path: dstPath, action: "write" });
165
+ return;
166
+ }
167
+ // dest exists — read and check containment
168
+ const dstRaw = fs.readFileSync(dstPath, "utf-8");
169
+ let existing;
170
+ try {
171
+ existing = JSON.parse(dstRaw);
172
+ }
173
+ catch {
174
+ // Malformed destination — refuse to overwrite; require manual fix (matches malformed-package-json blocker discipline)
175
+ throw new Error(`[bkit] ${dstPath} is malformed JSON — fix manually before running bkit install`);
176
+ }
177
+ // Check if existing already contains the template
178
+ const containsResult = deepContains(template, existing);
179
+ if (containsResult.ok) {
180
+ return; // idempotent — no change needed
181
+ }
182
+ // Deep-merge: existing base, template override (template wins on conflicts)
183
+ const merged = deepMergeJson(existing, template);
184
+ const mergedStr = JSON.stringify(merged, null, 2) + "\n";
185
+ if (mergedStr === dstRaw)
186
+ return; // idempotent guard
187
+ if (!dryRun) {
188
+ fs.writeFileSync(dstPath, mergedStr, "utf-8");
189
+ }
190
+ ws.writes.push({ path: dstPath, action: "update" });
191
+ }
192
+ // ---------------------------------------------------------------------------
193
+ // Internal helpers
194
+ // ---------------------------------------------------------------------------
195
+ export function ensureDir(dir) {
196
+ fs.mkdirSync(dir, { recursive: true });
197
+ }
198
+ // ---------------------------------------------------------------------------
199
+ // fully-managed format — idempotent rewrite of whole file after token substitution
200
+ //
201
+ // Semantics: always writes the src content (with tokens applied) to dst.
202
+ // If dst exists with identical content, no-op (no double-count in WriteSet).
203
+ // ---------------------------------------------------------------------------
204
+ export function writeTier1(srcPath, dstPath, tokens, dryRun, ws) {
205
+ const srcRaw = readTemplate(srcPath);
206
+ const srcContent = applyTokens(srcRaw, tokens);
207
+ if (fs.existsSync(dstPath)) {
208
+ const existing = fs.readFileSync(dstPath, "utf-8");
209
+ if (existing === srcContent)
210
+ return; // identical — no-op
211
+ }
212
+ ensureDir(path.dirname(dstPath));
213
+ if (!dryRun) {
214
+ fs.writeFileSync(dstPath, srcContent, "utf-8");
215
+ // Preserve executable bit from src
216
+ const srcMode = fs.statSync(srcPath).mode;
217
+ fs.chmodSync(dstPath, srcMode);
218
+ }
219
+ ws.writes.push({ path: dstPath, action: "write" });
220
+ }
221
+ // ---------------------------------------------------------------------------
222
+ // markered-text format — managed-block (bkit owns content between markers; consumer owns rest)
223
+ //
224
+ // Semantics:
225
+ // - dest absent → write whole file (with token substitution)
226
+ // - dest has markers → update only the bkit block (tokens applied to new block content)
227
+ // - dest present, no marks → append full block at EOF; preserve consumer content above
228
+ //
229
+ // markerStyle: "html-comment" for markdown, shell and `.gitignore` (`# ` prefix allowed);
230
+ // "slash-comment" for JS.
231
+ // ---------------------------------------------------------------------------
232
+ export function writeTier2(srcPath, dstPath, tokens, markerStyle, dryRun, ws) {
233
+ const srcRaw = readTemplate(srcPath);
234
+ if (!fs.existsSync(dstPath)) {
235
+ // dest missing → write whole template (with tokens applied)
236
+ const content = applyTokens(srcRaw, tokens);
237
+ ensureDir(path.dirname(dstPath));
238
+ if (!dryRun) {
239
+ fs.writeFileSync(dstPath, content, "utf-8");
240
+ const srcMode = fs.statSync(srcPath).mode;
241
+ fs.chmodSync(dstPath, srcMode);
242
+ }
243
+ ws.writes.push({ path: dstPath, action: "write" });
244
+ return;
245
+ }
246
+ const destContent = fs.readFileSync(dstPath, "utf-8");
247
+ const fullBlock = extractFullManagedBlock(srcRaw, markerStyle);
248
+ if (fullBlock === null) {
249
+ // Template has no block for this marker style — nothing to manage
250
+ return;
251
+ }
252
+ // Check if dest already has markers
253
+ const blockContent = extractManagedBlock(destContent, markerStyle);
254
+ if (blockContent === null) {
255
+ // extractManagedBlock returns null for BOTH "no markers" and "ambiguous markers"
256
+ // (duplicates / inverted). Only the former should append — appending on the latter
257
+ // compounds corruption (dogfood docs grew a second stamped block every install).
258
+ const [startMarker, endMarker] = selectMarkers(markerStyle);
259
+ const starts = findLineAnchoredMarkers(destContent, startMarker);
260
+ const ends = findLineAnchoredMarkers(destContent, endMarker);
261
+ if (starts.length > 0 || ends.length > 0) {
262
+ console.warn(`[bkit] Managed block markers present but unparseable in ${dstPath} — skipping (expected exactly one start/end)`);
263
+ return;
264
+ }
265
+ // dest has no markers → append full block at EOF (with tokens applied)
266
+ const appliedBlock = applyTokens(fullBlock, tokens);
267
+ const sep = destContent.length === 0
268
+ ? ""
269
+ : destContent.endsWith("\n\n")
270
+ ? ""
271
+ : destContent.endsWith("\n")
272
+ ? "\n"
273
+ : "\n\n";
274
+ const tail = appliedBlock.endsWith("\n") ? "" : "\n";
275
+ if (!dryRun) {
276
+ fs.writeFileSync(dstPath, destContent + sep + appliedBlock + tail, "utf-8");
277
+ }
278
+ ws.writes.push({ path: dstPath, action: "append" });
279
+ return;
280
+ }
281
+ // dest has markers → update managed block with new content (tokens applied)
282
+ const newBlockContent = extractManagedBlock(srcRaw, markerStyle);
283
+ if (newBlockContent === null)
284
+ return;
285
+ const appliedNewContent = applyTokens(newBlockContent, tokens);
286
+ if (updateManagedBlock(dstPath, appliedNewContent, dryRun, markerStyle)) {
287
+ ws.writes.push({ path: dstPath, action: "update" });
288
+ }
289
+ }
290
+ // ---------------------------------------------------------------------------
291
+ // Managed package.json scripts — add-if-missing with consumer ownership
292
+ //
293
+ // Semantics:
294
+ // - File absent → no-op, returns missingPkg: true
295
+ // - File malformed JSON → no-op, returns malformed: true
296
+ // - script key absent → add with default value (recorded as one update)
297
+ // - script key exists → preserve consumer value (never overwrite)
298
+ //
299
+ // One WriteSet entry per call when any script was added. Drift
300
+ // surfaces in `bkit check` because `dryRun=true` still pushes to ws.writes.
301
+ // ---------------------------------------------------------------------------
302
+ export function ensurePackageJsonScripts(scripts, dryRun, ws) {
303
+ const pkgPath = "package.json";
304
+ if (!fs.existsSync(pkgPath)) {
305
+ return { added: [], preserved: [], missingPkg: true, malformed: false };
306
+ }
307
+ const raw = fs.readFileSync(pkgPath, "utf-8");
308
+ let pkg;
309
+ try {
310
+ pkg = JSON.parse(raw);
311
+ }
312
+ catch {
313
+ return { added: [], preserved: [], missingPkg: false, malformed: true };
314
+ }
315
+ let pkgScripts = pkg.scripts ?? undefined;
316
+ const added = [];
317
+ const preserved = [];
318
+ for (const [name, value] of Object.entries(scripts)) {
319
+ if (pkgScripts && Object.prototype.hasOwnProperty.call(pkgScripts, name)) {
320
+ preserved.push(name);
321
+ }
322
+ else {
323
+ if (!pkgScripts) {
324
+ pkgScripts = {};
325
+ pkg.scripts = pkgScripts;
326
+ }
327
+ pkgScripts[name] = value;
328
+ added.push(name);
329
+ }
330
+ }
331
+ if (added.length > 0) {
332
+ ws.writes.push({ path: pkgPath, action: "update" });
333
+ if (!dryRun) {
334
+ // Preserve indent style and trailing newline of the original file.
335
+ const indentMatch = raw.match(/\n([ \t]+)"/);
336
+ const indent = indentMatch ? indentMatch[1] : " ";
337
+ const trailingNewline = raw.endsWith("\n") ? "\n" : "";
338
+ fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
339
+ }
340
+ }
341
+ return { added, preserved, missingPkg: false, malformed: false };
342
+ }
@@ -0,0 +1,27 @@
1
+ // The clamp record log: one JSON line per artifact `bkit context clamp` trimmed,
2
+ // read back into the step's status row (`clamped`) by `bkit context finalise` and
3
+ // `bkit steps finish --clamp-log`. Lives outside commands/workflow so both read it
4
+ // without importing each other.
5
+ import * as fs from "node:fs";
6
+ import * as path from "node:path";
7
+ import { git, parseJson } from "../commands/lib.js";
8
+ /** `tmp/bkit-clamp-{fid}-{step}[-{attempt}].jsonl` in the checkout `cwd` sits in. */
9
+ export function clampLogPath(cwd, fid, step, attempt) {
10
+ const top = git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
11
+ return path.join(top, "tmp", `bkit-clamp-${fid}-${step}${attempt ? `-${attempt}` : ""}.jsonl`);
12
+ }
13
+ /** Every record in the log; reading never drains it, so a retried status block sees the same array. */
14
+ export function readRecords(log, onBad = () => undefined) {
15
+ if (!fs.existsSync(log))
16
+ return [];
17
+ return fs
18
+ .readFileSync(log, "utf-8")
19
+ .split("\n")
20
+ .filter((l) => l.trim() !== "")
21
+ .flatMap((l) => {
22
+ const parsed = parseJson(l);
23
+ if (!parsed.ok)
24
+ onBad(l);
25
+ return parsed.ok ? [parsed.value] : [];
26
+ });
27
+ }
@@ -0,0 +1,156 @@
1
+ // Contract + reducer for the bkit workflow status log.
2
+ //
3
+ // State is an append-only NDJSON event log (`status.jsonl`): one JSON event per
4
+ // line, prior lines NEVER mutated. `merge=union` (see `.gitattributes`) lets git
5
+ // auto-concatenate both branches' appended lines server-side, so a per-FID status
6
+ // log can never block a PR merge. Union may interleave or duplicate lines, so the
7
+ // reader (`fold`) de-dupes by identity and orders by `at` before reconstructing
8
+ // the run array.
9
+ //
10
+ // This module is the CANONICAL reference reducer. The bkit workflows execute an
11
+ // inline jq filter that mirrors `fold` exactly; this TS is the unit-tested source
12
+ // of truth for the fold semantics.
13
+ //
14
+ // `parentSha` is captured at step START via `git rev-parse HEAD`, BEFORE the
15
+ // step's own commit (if any). Forensic only — points to the commit that preceded
16
+ // this step's work, not the commit that resulted from it.
17
+ // Identity for de-dup under union merge. `step-done` is unique per
18
+ // (workflow, step, parentSha, at); workflow-level events per (type, workflow, at).
19
+ function identity(e) {
20
+ if (e.type === "step-done")
21
+ return `S\u0000${e.workflow}\u0000${e.step}\u0000${e.parentSha}\u0000${e.at}`;
22
+ return `W\u0000${e.type}\u0000${e.workflow}\u0000${e.at}`;
23
+ }
24
+ // Index of the most-recent run matching `workflow`, or -1.
25
+ function lastIndexOfWorkflow(runs, workflow) {
26
+ for (let i = runs.length - 1; i >= 0; i--)
27
+ if (runs[i].workflow === workflow)
28
+ return i;
29
+ return -1;
30
+ }
31
+ // Strip routing fields to recover the bare `Step`.
32
+ function toStep(e) {
33
+ const { type: _t, workflow: _w, ...step } = e;
34
+ return step;
35
+ }
36
+ // Fold the event log into the run array. De-dupes
37
+ // (keeping first occurrence), then orders by `at` (stable), then reduces.
38
+ export function fold(events) {
39
+ const seen = new Set();
40
+ const deduped = events.filter((e) => {
41
+ const k = identity(e);
42
+ if (seen.has(k))
43
+ return false;
44
+ seen.add(k);
45
+ return true;
46
+ });
47
+ // Stable sort by `at` (Array.prototype.sort is stable in modern engines).
48
+ const ordered = deduped
49
+ .map((e, i) => ({ e, i }))
50
+ .sort((a, b) => (a.e.at < b.e.at ? -1 : a.e.at > b.e.at ? 1 : a.i - b.i))
51
+ .map((x) => x.e);
52
+ const runs = [];
53
+ for (const e of ordered) {
54
+ if (e.type === "workflow-started") {
55
+ runs.push({ workflow: e.workflow, startedAt: e.at, status: "IN_PROGRESS", steps: [] });
56
+ }
57
+ else if (e.type === "step-done") {
58
+ const i = lastIndexOfWorkflow(runs, e.workflow);
59
+ if (i < 0) {
60
+ runs.push({
61
+ workflow: e.workflow,
62
+ startedAt: e.at,
63
+ status: "IN_PROGRESS",
64
+ steps: [toStep(e)],
65
+ });
66
+ }
67
+ else {
68
+ runs[i].steps.push(toStep(e));
69
+ }
70
+ }
71
+ else if (e.type === "workflow-meta") {
72
+ const i = lastIndexOfWorkflow(runs, e.workflow);
73
+ if (i >= 0) {
74
+ const { type: _t, workflow: _w, at: _a, ...meta } = e;
75
+ Object.assign(runs[i], meta);
76
+ }
77
+ }
78
+ else if (e.type === "workflow-done" || e.type === "workflow-failed") {
79
+ const i = lastIndexOfWorkflow(runs, e.workflow);
80
+ if (i >= 0)
81
+ runs[i].status = e.type === "workflow-done" ? "DONE" : "FAILED";
82
+ }
83
+ }
84
+ return runs;
85
+ }
86
+ // Serialize one event to the NDJSON line appended to `status.jsonl`, newline included.
87
+ export function appendLine(event) {
88
+ return `${JSON.stringify(event)}\n`;
89
+ }
90
+ // ---------------------------------------------------------------------------
91
+ // Queries — the reads routing and counters make. Two opposite scopings: attempt
92
+ // counts and verdict/failures/mode reads look at the ACTIVE
93
+ // run only, so a resumed run never inherits a finished run's spent budget;
94
+ // strategy reads ALL runs, so a resumed run keeps its place on the
95
+ // STANDARD -> PIVOT -> FINAL ladder instead of restarting it.
96
+ // ---------------------------------------------------------------------------
97
+ /** `status.jsonl` timestamp: UTC, whole seconds (`date -u +%FT%TZ`). */
98
+ export const statusTimestamp = (now = new Date()) => now.toISOString().replace(/\.\d{3}Z$/, "Z");
99
+ /** The latest run of `workflow` — the active one. */
100
+ export function lastRun(runs, workflow) {
101
+ const i = lastIndexOfWorkflow(runs, workflow);
102
+ return i < 0 ? undefined : runs[i];
103
+ }
104
+ const matches = (s, f) => s.step === f.step && s.status === "DONE" && (f.subPlan === undefined || s.subPlan === f.subPlan);
105
+ /**
106
+ * DONE rows for the step in the active run of `workflow`. `since` names a run
107
+ * field holding a timestamp (SOAK's `soakEntryAt`): only rows after it count.
108
+ */
109
+ export function activeDoneSteps(runs, workflow, f, since) {
110
+ const run = lastRun(runs, workflow);
111
+ if (!run)
112
+ return [];
113
+ const floor = since === undefined ? undefined : String(run[since] ?? "");
114
+ return run.steps.filter((s) => matches(s, f) && (floor === undefined || s.at > floor));
115
+ }
116
+ /** The last DONE row for the step across ALL runs of `workflow`. */
117
+ export function lastDoneStepAllRuns(runs, workflow, f) {
118
+ return runs
119
+ .filter((r) => r.workflow === workflow)
120
+ .flatMap((r) => r.steps)
121
+ .filter((s) => matches(s, f))
122
+ .at(-1);
123
+ }
124
+ /**
125
+ * Which run of `workflow` this invocation is (1-based): the count of its runs,
126
+ * plus one unless the latest run overall is one of them still IN_PROGRESS — a
127
+ * resume. Same answer before and after the run's `workflow-started` row lands.
128
+ */
129
+ export function runNumber(runs, workflow) {
130
+ const n = runs.filter((r) => r.workflow === workflow).length;
131
+ const latest = runs.at(-1);
132
+ return latest?.workflow === workflow && latest.status === "IN_PROGRESS" ? n : n + 1;
133
+ }
134
+ /**
135
+ * A run-level field of the active run (merged from `workflow-meta`) when set,
136
+ * else the last step that carries it. "" when neither does.
137
+ */
138
+ export function runOrStepField(runs, workflow, field) {
139
+ const run = lastRun(runs, workflow);
140
+ if (!run)
141
+ return "";
142
+ const own = run[field];
143
+ if (typeof own === "string" && own !== "")
144
+ return own;
145
+ const fromStep = run.steps
146
+ .map((s) => s[field])
147
+ .filter((v) => v !== undefined && v !== null && v !== "")
148
+ .at(-1);
149
+ return fromStep === undefined ? "" : String(fromStep);
150
+ }
151
+ /** Next rung: none -> STANDARD -> PIVOT -> FINAL, and FINAL stays FINAL. */
152
+ export function nextStrategy(prior) {
153
+ if (prior === undefined)
154
+ return "STANDARD";
155
+ return prior === "STANDARD" ? "PIVOT" : "FINAL";
156
+ }