@cbartens/bkit 6.0.0 → 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 (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -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 +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  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 +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -0,0 +1,387 @@
1
+ #!/bin/bash
2
+ # Example. Copy into scripts/ci/ and own it.
3
+ # bkit install does not write this file and does not overwrite a copy.
4
+ #
5
+ # bkit-machine-lock.sh — machine-wide named locks and the checkout's shared stack lock.
6
+ #
7
+ # . scripts/ci/bkit-machine-lock.sh
8
+ # take_local_stack_lock "<who>" [name] # waits, returns 1 on refusal
9
+ # try_local_stack_lock "<who>" [name] # returns 1 immediately while busy
10
+ # release_local_stack_lock [name] # optional; caller exit also frees the lock
11
+ # local_stack_lock_holder [name]
12
+ # local_stack_lock_file [name]
13
+ #
14
+ # package.json: wrap test gates with
15
+ # bash scripts/ci/bkit-machine-lock.sh run --lock tests -- <gate command> [args…]
16
+ # run ["<who>"] [--lock <name>] -- <command> exits with the command's status:
17
+ # 2 usage, 73 the lock could not be taken, 75 the wait gave up.
18
+ # The run name defaults to LOCAL_STACK_LOCK_WHO, npm_lifecycle_event, then run.
19
+ # TERM, INT and HUP defer cancellation until the foreground command ends, keeping
20
+ # its lock held throughout; the wrapper then returns the signal's exit status.
21
+ #
22
+ # Named locks live in ${XDG_CACHE_HOME:-$HOME/.cache}/bkit/machine-lock/ with no
23
+ # repository prefix. The unnamed stack lock keeps its local-stack-lock/ path and
24
+ # LOCAL_STACK_LOCK_OWNER / LOCAL_STACK_LOCK_PID names, so adopted copies still work.
25
+ # Named owners use LOCAL_STACK_LOCK_OWNER_<key> and LOCAL_STACK_LOCK_PID_<key>.
26
+ # Each holder records its checkout, process id and start time.
27
+ #
28
+ # Take locks in this order: tests, other named locks, then the unnamed stack lock.
29
+ # A child reuses only the named or unnamed lock its live parent holds.
30
+ # BKIT_TEST_SLOTS sets the tests slots (whole number >= 1, default 1). Taking tests
31
+ # exports BKIT_TEST_WORKERS=max(1, floor(cores / slots) - 1) for the runner to use.
32
+ # LOCAL_STACK_LOCK_WAIT_S caps the wait; otherwise it is 60s without a TTY, 3600s
33
+ # with a TTY. Named releases save each checkout's held seconds in <name>.last.
34
+ # Waiting notes name every holder and that checkout's last run. CI=true / CI=1 is a no-op.
35
+ # A Perl flock holder exits within a second of its caller; killed callers leave no stale lock.
36
+ # Requires Bash 3.2+ and /usr/bin/perl.
37
+
38
+ _LOCAL_STACK_LOCK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
39
+ _LOCAL_STACK_LOCK_ROOT="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$_LOCAL_STACK_LOCK_DIR")"
40
+ LOCAL_STACK_LOCK_PID="${LOCAL_STACK_LOCK_PID:-}"
41
+ _LOCAL_STACK_LOCK_EXIT=73
42
+
43
+ # The stack's name: BKIT_LOCAL_STACK, else the main checkout's folder name, the same from every
44
+ # worktree. Characters outside A-Z a-z 0-9 . _ - become _.
45
+ local_stack_lock_name() {
46
+ _lsl_name="${BKIT_LOCAL_STACK:-}"
47
+ if [ -z "$_lsl_name" ]; then
48
+ _lsl_common="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" || return 1
49
+ [ -n "$_lsl_common" ] || return 1
50
+ case "$(basename "$_lsl_common")" in
51
+ .git) _lsl_name="$(basename "$(dirname "$_lsl_common")")" ;;
52
+ *) _lsl_name="$(basename "$_lsl_common" .git)" ;;
53
+ esac
54
+ fi
55
+ printf '%s\n' "$_lsl_name" | LC_ALL=C tr -c 'A-Za-z0-9._\n-' '_'
56
+ }
57
+
58
+ # A named lock has one machine-wide path; the unnamed path remains stack-scoped.
59
+ local_stack_lock_file() {
60
+ local _lsl_stack
61
+ if [ -n "${1:-}" ]; then
62
+ _lsl_stack="$(printf '%s' "$1" | LC_ALL=C tr -c 'A-Za-z0-9._-' '_')"
63
+ echo "${XDG_CACHE_HOME:-$HOME/.cache}/bkit/machine-lock/${_lsl_stack}.lock"
64
+ else
65
+ _lsl_stack="$(local_stack_lock_name)" || return 1
66
+ echo "${XDG_CACHE_HOME:-$HOME/.cache}/bkit/local-stack-lock/${_lsl_stack}.lock"
67
+ fi
68
+ }
69
+
70
+ # "<who> — <checkout> (pid N, since HH:MM:SS)" for the run holding the lock.
71
+ local_stack_lock_holder() {
72
+ local _lsl_held _lsl_slot
73
+ _lsl_held="$(local_stack_lock_file "${1:-}")" || return 0
74
+ if [ -f "${_lsl_held}.holder" ]; then
75
+ cat "${_lsl_held}.holder"
76
+ fi
77
+ if [ "${1:-}" = tests ]; then
78
+ for _lsl_slot in "${_lsl_held%.lock}".[0-9]*.lock.holder; do
79
+ [ -f "$_lsl_slot" ] && cat "$_lsl_slot"
80
+ done
81
+ fi
82
+ return 0
83
+ }
84
+
85
+ _local_stack_lock_slots() {
86
+ _lsl_slots="${BKIT_TEST_SLOTS-1}"
87
+ case "$_lsl_slots" in
88
+ *[!0-9]*|"") _lsl_slots=0 ;;
89
+ *) _lsl_slots=$((10#$_lsl_slots)) ;;
90
+ esac
91
+ if [ "$_lsl_slots" -lt 1 ]; then
92
+ if [ "${_LOCAL_STACK_LOCK_SLOTS_NOTED:-}" != 1 ]; then
93
+ echo "[machine-lock] invalid BKIT_TEST_SLOTS; using 1 slot" >&2
94
+ _LOCAL_STACK_LOCK_SLOTS_NOTED=1
95
+ fi
96
+ _lsl_slots=1
97
+ fi
98
+ }
99
+
100
+ _local_stack_lock_workers() {
101
+ local _lsl_cores="" _lsl_probe
102
+ for _lsl_probe in getconf nproc sysctl; do
103
+ case "$_lsl_probe" in
104
+ getconf) _lsl_cores="$(getconf _NPROCESSORS_ONLN 2>/dev/null)" || continue ;;
105
+ nproc) _lsl_cores="$(nproc 2>/dev/null)" || continue ;;
106
+ sysctl) _lsl_cores="$(sysctl -n hw.ncpu 2>/dev/null)" || continue ;;
107
+ esac
108
+ case "$_lsl_cores" in *[!0-9]*|""|0) continue ;; esac
109
+ break
110
+ done
111
+ case "$_lsl_cores" in *[!0-9]*|""|0) _lsl_cores=1 ;; esac
112
+ BKIT_TEST_WORKERS=$((_lsl_cores / _lsl_slots - 1))
113
+ [ "$BKIT_TEST_WORKERS" -ge 1 ] || BKIT_TEST_WORKERS=1
114
+ export BKIT_TEST_WORKERS
115
+ }
116
+
117
+ _local_stack_lock_vars() {
118
+ local _lsl_key
119
+ _lsl_key="$(printf '%s' "${1:-}" | LC_ALL=C tr -c 'A-Za-z0-9._-' '_')"
120
+ _lsl_key="${_lsl_key//_/__}"
121
+ _lsl_key="${_lsl_key//-/_h}"
122
+ _lsl_key="${_lsl_key//./_d}"
123
+ _lsl_pid_var="LOCAL_STACK_LOCK_PID"
124
+ _lsl_owner_var="LOCAL_STACK_LOCK_OWNER"
125
+ _lsl_name_var="LOCAL_STACK_LOCK_NAME"
126
+ if [ -n "${1:-}" ]; then
127
+ _lsl_pid_var="${_lsl_pid_var}_${_lsl_key}"
128
+ _lsl_owner_var="${_lsl_owner_var}_${_lsl_key}"
129
+ _lsl_name_var="${_lsl_name_var}_${_lsl_key}"
130
+ fi
131
+ }
132
+
133
+ _local_stack_lock() {
134
+ local _lsl_mode="$1" _lsl_who="$2" _lsl_name="${3:-}"
135
+ local _lsl_pid_var _lsl_owner_var _lsl_name_var _lsl_owner _lsl_existing
136
+ local _lsl_file _lsl_label _lsl_fifo _lsl_pid _lsl_reply _lsl_checkout
137
+ local _lsl_slots=1 _lsl_wait _lsl_var _lsl_held_name _lsl_held_name_var
138
+ _LOCAL_STACK_LOCK_EXIT=73
139
+ _local_stack_lock_vars "$_lsl_name"
140
+ _lsl_owner="${!_lsl_owner_var:-}"
141
+ _lsl_existing="${!_lsl_pid_var:-}"
142
+ if [ "${CI:-}" = "true" ] || [ "${CI:-}" = "1" ]; then return 0; fi
143
+ if [ "$_lsl_name" = tests ]; then
144
+ _local_stack_lock_slots
145
+ _local_stack_lock_workers
146
+ fi
147
+ if [ -n "$_lsl_owner" ] && kill -0 "$_lsl_owner" 2>/dev/null; then return 0; fi
148
+ if [ -n "$_lsl_existing" ] && kill -0 "$_lsl_existing" 2>/dev/null; then return 0; fi
149
+ if [ -n "$_lsl_name" ]; then
150
+ for _lsl_var in ${!LOCAL_STACK_LOCK_OWNER*}; do
151
+ _lsl_owner="${!_lsl_var:-}"
152
+ [ -n "$_lsl_owner" ] && kill -0 "$_lsl_owner" 2>/dev/null || continue
153
+ if [ "$_lsl_var" = LOCAL_STACK_LOCK_OWNER ] || [ "$_lsl_name" = tests ]; then
154
+ _lsl_held_name_var="${_lsl_var/OWNER/NAME}"
155
+ _lsl_held_name="${!_lsl_held_name_var:-the unnamed stack lock}"
156
+ echo "[machine-lock] ❌ cannot take $_lsl_name while holding $_lsl_held_name: lock order is tests, other named locks, then the unnamed stack lock" >&2
157
+ return 1
158
+ fi
159
+ done
160
+ fi
161
+ if [ "${LOCAL_STACK_LOCK_WAIT_S+x}" = x ]; then
162
+ _lsl_wait="$LOCAL_STACK_LOCK_WAIT_S"
163
+ elif [ -t 0 ]; then
164
+ _lsl_wait=3600
165
+ else
166
+ _lsl_wait=60
167
+ fi
168
+
169
+ if ! _lsl_file="$(local_stack_lock_file "$_lsl_name")"; then
170
+ echo "[machine-lock] ❌ cannot name the local stack: run inside a git checkout, or set BKIT_LOCAL_STACK" >&2
171
+ return 1
172
+ fi
173
+ _lsl_label="the local stack $(basename "$_lsl_file" .lock)"
174
+ _lsl_checkout="$_LOCAL_STACK_LOCK_ROOT"
175
+ if [ -n "$_lsl_name" ]; then
176
+ _lsl_label="$_lsl_name"
177
+ _lsl_checkout="$(git -C "$PWD" rev-parse --show-toplevel 2>/dev/null || printf '%s' "$PWD")"
178
+ fi
179
+ if [ ! -x /usr/bin/perl ]; then
180
+ echo "[machine-lock] ❌ could not take the lock for $_lsl_label: /usr/bin/perl not found" >&2
181
+ return 1
182
+ fi
183
+ if ! mkdir -p "$(dirname "$_lsl_file")"; then
184
+ echo "[machine-lock] ❌ could not take the lock for $_lsl_label: cannot create $(dirname "$_lsl_file")" >&2
185
+ return 1
186
+ fi
187
+ _lsl_fifo="$(mktemp -u "${TMPDIR:-/tmp}/local-stack-lock.XXXXXX")"
188
+ mkfifo "$_lsl_fifo" || return 1
189
+
190
+ # The holder answers on the fifo once: ok, busy <holder>, timeout <holder> or error <why>.
191
+ /usr/bin/perl -e '
192
+ use strict;
193
+ use Fcntl qw(:flock);
194
+ use File::Glob qw(bsd_glob);
195
+ use POSIX qw(strftime);
196
+ my ($file, $owner, $who, $checkout, $fifo, $wait_s, $mode, $label, $slots, $name) = @ARGV;
197
+ # The caller is the parent of this process. When it exits, this process goes to init (or a
198
+ # subreaper) at once, while `kill 0` would still find it until whoever started it reaps it.
199
+ my $parent = getppid();
200
+ my $caller_alive = sub { getppid() == $parent };
201
+ open(my $out, ">", $fifo) or exit 1;
202
+ $out->autoflush(1);
203
+ my $stem = $file; $stem =~ s/\.lock$//;
204
+ my $history = "$stem.last";
205
+ my $holder = sub {
206
+ my @files = ("$file.holder");
207
+ push @files, grep { /^\Q$stem\E\.\d+\.lock\.holder$/ } bsd_glob("$stem.*.lock.holder") if $name eq "tests";
208
+ my @holders;
209
+ for my $held (@files) {
210
+ open(my $h, "<", $held) or next;
211
+ my $line = <$h>; close $h;
212
+ next unless defined $line;
213
+ chomp $line;
214
+ if (length $name) {
215
+ my ($held_checkout) = $line =~ / — (.*) \(pid /;
216
+ my $duration;
217
+ if (defined $held_checkout && open(my $last, "<", $history)) {
218
+ while (my $row = <$last>) {
219
+ chomp $row;
220
+ my ($path, $seconds) = split /\t/, $row, 2;
221
+ $duration = $seconds if $path eq $held_checkout && defined $seconds && $seconds =~ /^\d+$/;
222
+ }
223
+ close $last;
224
+ }
225
+ $line .= defined $duration ? ", last run took " . int($duration / 60) . "m" . ($duration % 60) . "s" : ", no earlier run";
226
+ }
227
+ push @holders, $line;
228
+ }
229
+ return @holders ? join("; ", @holders) : "another run";
230
+ };
231
+ my ($lock, $held_file);
232
+ my $start = time;
233
+ my $next_note = 0;
234
+ while (1) {
235
+ for my $slot (1 .. $slots) {
236
+ my $candidate = $slot == 1 ? $file : "$stem.$slot.lock";
237
+ open(my $next, ">>", $candidate) or do { print $out "error cannot open $candidate: $!\n"; exit 1 };
238
+ if (flock($next, LOCK_EX | LOCK_NB)) { $lock = $next; $held_file = $candidate; last }
239
+ close $next;
240
+ }
241
+ last if defined $lock;
242
+ exit 0 unless $caller_alive->();
243
+ if ($mode eq "try") { print $out "busy " . $holder->() . "\n"; exit 0 }
244
+ if (time - $start >= $wait_s) { print $out "timeout " . $holder->() . "\n"; exit 0 }
245
+ if (time >= $next_note) {
246
+ my $m = int((time - $start) / 60);
247
+ my $so_far = $m ? " (still, $m min so far)" : "";
248
+ print STDERR "[machine-lock] ⏳ $who is waiting for $label$so_far (up to ${wait_s}s): in use by " . $holder->() . "\n";
249
+ $next_note = time + 60;
250
+ }
251
+ select(undef, undef, undef, 0.1);
252
+ }
253
+ my $stopping = 0;
254
+ $SIG{TERM} = $SIG{INT} = $SIG{HUP} = sub { $stopping = 1 };
255
+ my $held_since = time;
256
+ if (open(my $h, ">", "$held_file.holder")) {
257
+ print $h "$who — $checkout (pid $owner, since " . strftime("%H:%M:%S", localtime) . ")\n";
258
+ close $h;
259
+ }
260
+ print $out "ok\n";
261
+ close $out;
262
+ select(undef, undef, undef, 0.1) while !$stopping && $caller_alive->();
263
+ if (length $name) {
264
+ # Serialize history updates across slots; the portable shell replaces just this checkout row.
265
+ my $history_lock;
266
+ if (open($history_lock, ">>", "$history.lock") && flock($history_lock, LOCK_EX)) {
267
+ my $pattern = $checkout; $pattern =~ s/([.\[\]\\*^\$])/\\$1/g;
268
+ $pattern = "^$pattern\t";
269
+ my $status = system("bash", "-c", q{
270
+ history="$1"; pattern="$2"; checkout="$3"; held="$4"
271
+ tmp=$(mktemp "$history.XXXXXX") || exit 1
272
+ if [ -f "$history" ]; then
273
+ grep -v "$pattern" "$history" >"$tmp"
274
+ code=$?
275
+ if [ "$code" -gt 1 ]; then rm -f "$tmp"; exit 1; fi
276
+ fi
277
+ printf "%s\t%s\n" "$checkout" "$held" >>"$tmp" && mv "$tmp" "$history"
278
+ }, "machine-lock-history", $history, $pattern, $checkout, time - $held_since);
279
+ print STDERR "[machine-lock] could not record $name held time in $history\n" if $status;
280
+ close $history_lock;
281
+ } else { print STDERR "[machine-lock] could not lock $history for held-time history: $!\n" }
282
+ }
283
+ unlink "$held_file.holder";
284
+ ' "$_lsl_file" "$$" "$_lsl_who" "$_lsl_checkout" "$_lsl_fifo" "$_lsl_wait" "$_lsl_mode" "$_lsl_label" "$_lsl_slots" "$_lsl_name" </dev/null >/dev/null &
285
+ _lsl_pid=$!
286
+ # The fifo is opened read-write, so the read never blocks on a holder that died before it
287
+ # answered (a failed fork under load, a killed perl): the loop stops once it is gone.
288
+ _lsl_reply="$(
289
+ exec 3<>"$_lsl_fifo"
290
+ while :; do
291
+ if IFS= read -r -t 1 _lsl_line <&3; then
292
+ printf '%s' "$_lsl_line"
293
+ break
294
+ fi
295
+ if ! kill -0 "$_lsl_pid" 2>/dev/null; then
296
+ # The holder may have answered and exited between the read timing out and this check.
297
+ if IFS= read -r -t 1 _lsl_line <&3; then printf '%s' "$_lsl_line"; fi
298
+ break
299
+ fi
300
+ done
301
+ )" || true
302
+ rm -f "$_lsl_fifo"
303
+
304
+ case "$_lsl_reply" in
305
+ ok)
306
+ printf -v "$_lsl_pid_var" '%s' "$_lsl_pid"
307
+ printf -v "$_lsl_owner_var" '%s' "$$"
308
+ export "$_lsl_owner_var"
309
+ printf -v "$_lsl_name_var" '%s' "${_lsl_name:-the unnamed stack lock}"
310
+ export "$_lsl_name_var"
311
+ return 0
312
+ ;;
313
+ busy\ *)
314
+ _LOCAL_STACK_LOCK_EXIT=75
315
+ echo "[machine-lock] $_lsl_label is in use by ${_lsl_reply#busy }" >&2
316
+ ;;
317
+ timeout\ *)
318
+ _LOCAL_STACK_LOCK_EXIT=75
319
+ echo "[machine-lock] ❌ $_lsl_who gave up after ${_lsl_wait}s waiting for $_lsl_label, in use by ${_lsl_reply#timeout }" >&2
320
+ echo "[machine-lock] Let that run finish, or stop it. LOCAL_STACK_LOCK_WAIT_S sets how long to wait." >&2
321
+ ;;
322
+ "")
323
+ echo "[machine-lock] ❌ could not take the lock for $_lsl_label: the perl process holding it stopped before it answered" >&2
324
+ ;;
325
+ *)
326
+ echo "[machine-lock] ❌ could not take the lock for $_lsl_label: ${_lsl_reply#error }" >&2
327
+ ;;
328
+ esac
329
+ wait "$_lsl_pid" 2>/dev/null || true
330
+ return 1
331
+ }
332
+
333
+ take_local_stack_lock() { _local_stack_lock wait "$1" "${2:-}"; }
334
+ try_local_stack_lock() { _local_stack_lock try "$1" "${2:-}"; }
335
+
336
+ release_local_stack_lock() {
337
+ local _lsl_pid_var _lsl_owner_var _lsl_name_var _lsl_release_pid
338
+ _local_stack_lock_vars "${1:-}"
339
+ _lsl_release_pid="${!_lsl_pid_var:-}"
340
+ [ -n "$_lsl_release_pid" ] || return 0
341
+ kill "$_lsl_release_pid" 2>/dev/null || true
342
+ wait "$_lsl_release_pid" 2>/dev/null || true
343
+ printf -v "$_lsl_pid_var" '%s' ""
344
+ unset "$_lsl_owner_var"
345
+ unset "$_lsl_name_var"
346
+ return 0
347
+ }
348
+
349
+ if [ "${BASH_SOURCE[0]}" = "$0" ]; then
350
+ _lsl_run_usage() {
351
+ echo 'usage: bash scripts/ci/bkit-machine-lock.sh run ["<who>"] [--lock <name>] -- <command> [args…]' >&2
352
+ exit 2
353
+ }
354
+ [ "${1:-}" = run ] || _lsl_run_usage
355
+ shift
356
+ _lsl_run_who="${LOCAL_STACK_LOCK_WHO:-${npm_lifecycle_event:-run}}"
357
+ _lsl_run_name=""
358
+ case "${1:-}" in
359
+ --lock|--) ;;
360
+ "") _lsl_run_usage ;;
361
+ *) _lsl_run_who="$1"; shift ;;
362
+ esac
363
+ if [ "${1:-}" = --lock ]; then
364
+ [ -n "${2:-}" ] && [ "$2" != -- ] || _lsl_run_usage
365
+ _lsl_run_name="$2"
366
+ shift 2
367
+ fi
368
+ [ "${1:-}" = -- ] || _lsl_run_usage
369
+ shift
370
+ [ "$#" -gt 0 ] || _lsl_run_usage
371
+ take_local_stack_lock "$_lsl_run_who" "$_lsl_run_name" || exit "$_LOCAL_STACK_LOCK_EXIT"
372
+ _lsl_run_signal_status=0
373
+ _lsl_run_cancel() {
374
+ _lsl_run_signal_status="$1"
375
+ echo "[machine-lock] cancellation requested; waiting for $_lsl_run_who to finish before releasing its lock" >&2
376
+ }
377
+ # Bash runs these traps after its foreground command ends. Keeping this owner
378
+ # alive also keeps the Perl holder alive while that command finishes naturally.
379
+ trap '_lsl_run_cancel 143' TERM
380
+ trap '_lsl_run_cancel 130' INT
381
+ trap '_lsl_run_cancel 129' HUP
382
+ "$@"
383
+ _lsl_run_status=$?
384
+ release_local_stack_lock "$_lsl_run_name"
385
+ [ "$_lsl_run_signal_status" -eq 0 ] || _lsl_run_status="$_lsl_run_signal_status"
386
+ exit "$_lsl_run_status"
387
+ fi
@@ -0,0 +1,75 @@
1
+ #!/usr/bin/env node
2
+ // Example. Copy into scripts/ci/ and own it. bkit install does not write this file.
3
+ // Usage: node scripts/ci/bkit-test-awake.mjs command [args...]
4
+ // Chains: node scripts/ci/bkit-test-awake.mjs --shell 'first && second'
5
+
6
+ import { spawn } from "node:child_process";
7
+ import spawnCommand from "cross-spawn";
8
+ import { once } from "node:events";
9
+ import { constants } from "node:os";
10
+ import { pathToFileURL } from "node:url";
11
+
12
+ /** Run a command with a macOS sleep assertion owned by this process. */
13
+ export async function runAwake(command, args, platform = process.platform) {
14
+ let assertion;
15
+ if (platform === "darwin") {
16
+ assertion = spawn("/usr/bin/caffeinate", ["-is", "-w", String(process.pid)], {
17
+ stdio: "ignore",
18
+ detached: true,
19
+ });
20
+ try {
21
+ await once(assertion, "spawn");
22
+ } catch (error) {
23
+ console.error(`bkit-test-awake: caffeinate could not run: ${error.message}`);
24
+ return 127;
25
+ }
26
+ }
27
+
28
+ const child = spawnCommand(command, args, {
29
+ stdio: "inherit",
30
+ });
31
+ const forward = (signal) => {
32
+ if (!child.pid) return;
33
+ try {
34
+ child.kill(signal);
35
+ } catch (error) {
36
+ if (error.code !== "ESRCH") throw error;
37
+ }
38
+ };
39
+ const handlers = ["SIGINT", "SIGTERM", "SIGHUP"].map((signal) => {
40
+ const handler = () => forward(signal);
41
+ process.on(signal, handler);
42
+ return [signal, handler];
43
+ });
44
+ try {
45
+ const [code, signal] = await once(child, "close");
46
+ return code ?? 128 + (constants.signals[signal] ?? 1);
47
+ } catch (error) {
48
+ const reason = error.code === "ENOENT" ? "not found on PATH" : "could not run";
49
+ console.error(`bkit-test-awake: ${command} ${reason}: ${error.message}`);
50
+ return error.code === "EACCES" ? 126 : 127;
51
+ } finally {
52
+ for (const [signal, handler] of handlers) process.off(signal, handler);
53
+ if (assertion && assertion.exitCode === null && assertion.signalCode === null) {
54
+ const closed = once(assertion, "close");
55
+ assertion.kill();
56
+ await closed;
57
+ }
58
+ }
59
+ }
60
+
61
+ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
62
+ const [command, ...args] = process.argv.slice(2);
63
+ if (!command || (command === "--shell" && args.length !== 1)) {
64
+ console.error("bkit-test-awake: name a command, or --shell followed by one command string");
65
+ process.exitCode = 2;
66
+ } else if (command === "--shell") {
67
+ const windows = process.platform === "win32";
68
+ process.exitCode = await runAwake(
69
+ windows ? process.env.ComSpec || "cmd.exe" : "/bin/sh",
70
+ windows ? ["/d", "/s", "/c", args[0]] : ["-c", args[0]],
71
+ );
72
+ } else {
73
+ process.exitCode = await runAwake(command, args);
74
+ }
75
+ }
@@ -0,0 +1,160 @@
1
+ // Example. Copy into scripts/ci/ and own it. bkit install does not write this file.
2
+ import assert from "node:assert/strict";
3
+ import { spawn, spawnSync } from "node:child_process";
4
+ import { once } from "node:events";
5
+ import { existsSync, readFileSync } from "node:fs";
6
+ import { test } from "node:test";
7
+ import { fileURLToPath } from "node:url";
8
+
9
+ const script = fileURLToPath(new URL("./bkit-test-awake.mjs", import.meta.url));
10
+
11
+ function isRunning(pid) {
12
+ try {
13
+ process.kill(pid, 0);
14
+ if (process.platform === "linux") {
15
+ const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
16
+ return stat.slice(stat.lastIndexOf(")") + 2, stat.lastIndexOf(")") + 3) !== "Z";
17
+ }
18
+ return true;
19
+ } catch (error) {
20
+ if (error.code === "ESRCH" || error.code === "ENOENT") return false;
21
+ throw error;
22
+ }
23
+ }
24
+
25
+ test("ships a command-scoped sleep prevention wrapper", () => {
26
+ assert.ok(existsSync(script));
27
+ });
28
+
29
+ test("preserves arguments, output and nonzero exit status", () => {
30
+ const result = spawnSync(
31
+ process.execPath,
32
+ [
33
+ script,
34
+ process.execPath,
35
+ "-e",
36
+ 'console.log(JSON.stringify(process.argv.slice(1))); console.error("failure detail"); process.exit(23)',
37
+ "a b",
38
+ "$(echo unsafe)",
39
+ "",
40
+ "--flag",
41
+ ],
42
+ { encoding: "utf8" },
43
+ );
44
+ assert.equal(result.status, 23);
45
+ assert.deepEqual(JSON.parse(result.stdout), ["a b", "$(echo unsafe)", "", "--flag"]);
46
+ assert.equal(result.stderr, "failure detail\n");
47
+ });
48
+
49
+ test("runs an entire shell chain and retains its failure", () => {
50
+ const result = spawnSync(
51
+ process.execPath,
52
+ [script, "--shell", "echo first && echo second && exit 19"],
53
+ { encoding: "utf8" },
54
+ );
55
+ assert.equal(result.status, 19);
56
+ assert.match(result.stdout, /first\r?\nsecond\r?\n/);
57
+ });
58
+
59
+ test("reports a missing command as 127", () => {
60
+ const result = spawnSync(process.execPath, [script, "bkit-command-that-does-not-exist"], {
61
+ encoding: "utf8",
62
+ });
63
+ assert.equal(result.status, 127);
64
+ assert.match(result.stderr, /bkit-command-that-does-not-exist/);
65
+ });
66
+
67
+ test("requires a command", () => {
68
+ const result = spawnSync(process.execPath, [script], { encoding: "utf8" });
69
+ assert.equal(result.status, 2);
70
+ assert.match(result.stderr, /command/);
71
+ });
72
+
73
+ test("non-macOS platform selection runs commands without sleep prevention", async () => {
74
+ const { runAwake } = await import("./bkit-test-awake.mjs");
75
+ for (const platform of ["linux", "win32"]) {
76
+ assert.equal(await runAwake(process.execPath, ["-e", "process.exit(17)"], platform), 17);
77
+ }
78
+ });
79
+
80
+ test(
81
+ "hard timeout escalation reaches a command that ignores TERM",
82
+ { skip: process.platform === "win32" },
83
+ async () => {
84
+ const child = spawn(
85
+ process.execPath,
86
+ [
87
+ script,
88
+ process.execPath,
89
+ "-e",
90
+ 'process.on("SIGTERM", () => {}); console.log(String(process.pid)); setInterval(() => {}, 1000)',
91
+ ],
92
+ {
93
+ detached: true,
94
+ stdio: ["ignore", "pipe", "pipe"],
95
+ env: { ...process.env, FORCE_COLOR: "1" },
96
+ },
97
+ );
98
+ const exited = once(child, "exit");
99
+ const [data] = await once(child.stdout, "data");
100
+ const pid = Number(data.toString().trim());
101
+ assert.ok(pid > 0);
102
+ process.kill(-child.pid, "SIGTERM");
103
+ await new Promise((resolve) => setTimeout(resolve, 100));
104
+ process.kill(-child.pid, "SIGKILL");
105
+ await exited;
106
+ for (let attempt = 0; attempt < 40 && isRunning(pid); attempt++) {
107
+ await new Promise((resolve) => setTimeout(resolve, 25));
108
+ }
109
+ const alive = isRunning(pid);
110
+ if (alive) process.kill(pid, "SIGKILL");
111
+ child.stdout.destroy();
112
+ child.stderr.destroy();
113
+ assert.equal(alive, false, "a hard timeout must kill the test command too");
114
+ },
115
+ );
116
+
117
+ test(
118
+ "forwards POSIX cancellation to the command and releases the assertion",
119
+ { skip: process.platform === "win32" },
120
+ async () => {
121
+ const child = spawn(
122
+ process.execPath,
123
+ [
124
+ script,
125
+ process.execPath,
126
+ "-e",
127
+ "console.log(String(process.pid)); setInterval(() => {}, 1000)",
128
+ ],
129
+ { stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, FORCE_COLOR: "1" } },
130
+ );
131
+ const closed = once(child, "close");
132
+ const [data] = await once(child.stdout, "data");
133
+ const pid = Number(data.toString().trim());
134
+ assert.ok(pid > 0);
135
+ child.kill("SIGTERM");
136
+ const [code] = await closed;
137
+ assert.equal(code, 143);
138
+ assert.throws(() => process.kill(pid, 0), { code: "ESRCH" });
139
+ },
140
+ );
141
+
142
+ test(
143
+ "holds a real macOS assertion only while the command runs",
144
+ { skip: process.platform !== "darwin" },
145
+ () => {
146
+ const probe = `
147
+ const { execFileSync } = require("node:child_process");
148
+ const pid = Number(execFileSync("pgrep", ["-P", String(process.ppid), "caffeinate"], {encoding:"utf8"}).trim());
149
+ const command = execFileSync("ps", ["-p", String(pid), "-o", "command="], {encoding:"utf8"});
150
+ console.log(JSON.stringify({pid, command, owner:process.ppid}));
151
+ `;
152
+ const result = spawnSync(process.execPath, [script, process.execPath, "-e", probe], {
153
+ encoding: "utf8",
154
+ });
155
+ assert.equal(result.status, 0, result.stderr);
156
+ const { pid, command, owner } = JSON.parse(result.stdout);
157
+ assert.match(command, new RegExp("caffeinate -is -w " + owner));
158
+ assert.throws(() => process.kill(pid, 0), { code: "ESRCH" });
159
+ },
160
+ );
@@ -2,7 +2,7 @@
2
2
  // Example. Copy into scripts/ci/lanes/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * resolve-push-base.mjs — the diff base for a push run's test plan.
5
+ * bkit-resolve-push-base.mjs — the diff base for a push run's test plan.
6
6
  *
7
7
  * A newer run on a branch cancels the older one, so the previous push's run may never have
8
8
  * finished — and `github.event.before` is that previous push. Diffing against it would leave
@@ -17,9 +17,9 @@
17
17
  * in for `event.before`, and ancestry is tested against the pushed commit (`--head`), which is
18
18
  * not always the checked-out one. gh uses its own login.
19
19
  *
20
- * Usage: node scripts/ci/lanes/resolve-push-base.mjs
20
+ * Usage: node scripts/ci/lanes/bkit-resolve-push-base.mjs
21
21
  * (env: GH_TOKEN, REPO, BRANCH, BEFORE_SHA, WORKFLOW_FILE; optional SOURCE_FILE)
22
- * node scripts/ci/lanes/resolve-push-base.mjs --local --branch=dev --head=<pushed sha>
22
+ * node scripts/ci/lanes/bkit-resolve-push-base.mjs --local --branch=dev --head=<pushed sha>
23
23
  * (env: optional WORKFLOW_FILE, SOURCE_FILE)
24
24
  * Output: the base SHA on stdout; the chosen source (`last-green-run`, `event-before`, ...;
25
25
  * `origin/<branch>` in place of `event-before` in local mode) on stderr, and in
@@ -2,9 +2,9 @@
2
2
  // Example. Copy into scripts/ci/lanes/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * resolve-push-base.test.mjs — unit tests for the push-run diff base.
5
+ * bkit-resolve-push-base.test.mjs — unit tests for the push-run diff base.
6
6
  *
7
- * Pure Node, no runner: `node scripts/ci/lanes/resolve-push-base.test.mjs`.
7
+ * Pure Node, no runner: `node scripts/ci/lanes/bkit-resolve-push-base.test.mjs`.
8
8
  * Exit: 0 = all tests passed, 1 = at least one test failed.
9
9
  */
10
10
 
@@ -18,9 +18,9 @@ import {
18
18
  newestRunSha,
19
19
  parseArgs,
20
20
  repoFromRemoteUrl,
21
- } from "./resolve-push-base.mjs";
21
+ } from "./bkit-resolve-push-base.mjs";
22
22
 
23
- const SCRIPT = fileURLToPath(new URL("./resolve-push-base.mjs", import.meta.url));
23
+ const SCRIPT = fileURLToPath(new URL("./bkit-resolve-push-base.mjs", import.meta.url));
24
24
 
25
25
  /** Run the script with fake `gh` / `git` binaries first on PATH; `gh` calls land in gh.log. */
26
26
  function runWithFakes({ gh, git, args = [], env = {} }) {