@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
@@ -1,194 +0,0 @@
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-local-stack-lock.sh — one run at a time on a local stack every checkout shares.
6
- #
7
- # . scripts/ci/bkit-local-stack-lock.sh
8
- # take_local_stack_lock "<who>" || exit 1 # waits while another run holds it
9
- # try_local_stack_lock "<who>" # returns 1 at once while another run holds it
10
- # release_local_stack_lock # optional: the lock frees itself when the caller exits
11
- #
12
- # bash scripts/ci/bkit-local-stack-lock.sh run "<who>" -- <command> [args…] # package.json
13
- #
14
- # WHY. Agents work in several worktrees of one repo at once, and every worktree talks to the
15
- # SAME local services: a Docker database, an emulator, anything whose container names and ports
16
- # come from the repo's config. Nothing stops two worktrees using them at once, so a database
17
- # reset from one wipes the data under a test run in another, and a dev server that stops "its"
18
- # stack on exit stops it under someone else's run. Both show up as test failures nobody caused.
19
- # A run that starts, resets or stops the stack, or tests against it, takes this lock first; a
20
- # second run waits and says who it is waiting for.
21
- #
22
- # Wiring:
23
- # - package.json: wrap each script that starts, resets or stops the stack, e.g.
24
- # "db:reset": "bash scripts/ci/bkit-local-stack-lock.sh run db:reset -- <your reset command>"
25
- # - local runners that test against the stack: source this file and call take_local_stack_lock
26
- # before the first command that touches the stack.
27
- # - fix hints and docs name those scripts, never the raw command, which skips the lock.
28
- #
29
- # The lock is named after the stack: BKIT_LOCAL_STACK when set, otherwise the folder name of the
30
- # repo's main checkout, so every worktree of one repo finds the same lock. A throwaway stack with
31
- # names and ports of its own sets BKIT_LOCAL_STACK to its own name and never waits on the shared
32
- # one. The lock file sits outside the checkout: ~/.cache/bkit/local-stack-lock/<name>.lock
33
- # ($XDG_CACHE_HOME when set). A small perl process holds it (flock) and exits within a second of
34
- # the caller exiting, however the caller ends (its parent changes), so a killed run cannot leave
35
- # a stale lock behind. perl by its full path, so a PATH shim cannot stand in for it.
36
- #
37
- # A runner started by a runner that holds the lock (LOCAL_STACK_LOCK_OWNER, exported on success)
38
- # does not wait on its own parent. Safe under a caller's `set -e`. CI (CI=true or CI=1): no-op,
39
- # as a CI runner has one job and its own Docker. LOCAL_STACK_LOCK_WAIT_S (default 3600) caps
40
- # the wait. Needs bash and /usr/bin/perl (macOS and Linux ship both).
41
-
42
- _LOCAL_STACK_LOCK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
43
- _LOCAL_STACK_LOCK_ROOT="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$_LOCAL_STACK_LOCK_DIR")"
44
- LOCAL_STACK_LOCK_PID=""
45
-
46
- # The stack's name: BKIT_LOCAL_STACK, else the main checkout's folder name, the same from every
47
- # worktree. Characters outside A-Z a-z 0-9 . _ - become _.
48
- local_stack_lock_name() {
49
- _lsl_name="${BKIT_LOCAL_STACK:-}"
50
- if [ -z "$_lsl_name" ]; then
51
- _lsl_common="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" || return 1
52
- [ -n "$_lsl_common" ] || return 1
53
- case "$(basename "$_lsl_common")" in
54
- .git) _lsl_name="$(basename "$(dirname "$_lsl_common")")" ;;
55
- *) _lsl_name="$(basename "$_lsl_common" .git)" ;;
56
- esac
57
- fi
58
- printf '%s\n' "$_lsl_name" | LC_ALL=C tr -c 'A-Za-z0-9._\n-' '_'
59
- }
60
-
61
- # The lock file for the stack this checkout uses.
62
- local_stack_lock_file() {
63
- _lsl_stack="$(local_stack_lock_name)" || return 1
64
- echo "${XDG_CACHE_HOME:-$HOME/.cache}/bkit/local-stack-lock/${_lsl_stack}.lock"
65
- }
66
-
67
- # "<who> — <checkout> (pid N, since HH:MM:SS)" for the run holding the lock, or nothing.
68
- local_stack_lock_holder() {
69
- _lsl_held="$(local_stack_lock_file)" || return 0
70
- cat "${_lsl_held}.holder" 2>/dev/null
71
- return 0
72
- }
73
-
74
- _local_stack_lock() {
75
- _lsl_mode="$1"
76
- _lsl_who="$2"
77
- if [ "${CI:-}" = "true" ] || [ "${CI:-}" = "1" ]; then return 0; fi
78
- if [ -n "${LOCAL_STACK_LOCK_OWNER:-}" ] && kill -0 "$LOCAL_STACK_LOCK_OWNER" 2>/dev/null; then return 0; fi
79
- if [ -n "$LOCAL_STACK_LOCK_PID" ] && kill -0 "$LOCAL_STACK_LOCK_PID" 2>/dev/null; then return 0; fi
80
-
81
- if ! _lsl_file="$(local_stack_lock_file)"; then
82
- echo "[local-stack-lock] ❌ cannot name the local stack: run inside a git checkout, or set BKIT_LOCAL_STACK" >&2
83
- return 1
84
- fi
85
- _lsl_label="$(basename "$_lsl_file" .lock)"
86
- if [ ! -x /usr/bin/perl ]; then
87
- echo "[local-stack-lock] ❌ could not take the lock for the local stack $_lsl_label: /usr/bin/perl not found" >&2
88
- return 1
89
- fi
90
- mkdir -p "$(dirname "$_lsl_file")" || return 1
91
- _lsl_fifo="$(mktemp -u "${TMPDIR:-/tmp}/local-stack-lock.XXXXXX")"
92
- mkfifo "$_lsl_fifo" || return 1
93
-
94
- # The holder answers on the fifo once: ok, busy <holder>, timeout <holder> or error <why>.
95
- /usr/bin/perl -e '
96
- use strict;
97
- use Fcntl qw(:flock);
98
- use POSIX qw(strftime);
99
- my ($file, $owner, $who, $checkout, $fifo, $wait_s, $mode, $label) = @ARGV;
100
- # The caller is the parent of this process. When it exits, this process goes to init (or a
101
- # subreaper) at once, while `kill 0` would still find it until whoever started it reaps it.
102
- my $parent = getppid();
103
- my $caller_alive = sub { getppid() == $parent };
104
- open(my $out, ">", $fifo) or exit 1;
105
- $out->autoflush(1);
106
- my $holder = sub { open(my $h, "<", "$file.holder") or return "another run"; my $l = <$h>; chomp $l; $l };
107
- my $lock;
108
- open($lock, ">>", $file) or do { print $out "error cannot open $file: $!\n"; exit 1 };
109
- my $start = time;
110
- my $next_note = 0;
111
- until (flock($lock, LOCK_EX | LOCK_NB)) {
112
- exit 0 unless $caller_alive->();
113
- if ($mode eq "try") { print $out "busy " . $holder->() . "\n"; exit 0 }
114
- if (time - $start >= $wait_s) { print $out "timeout " . $holder->() . "\n"; exit 0 }
115
- if (time >= $next_note) {
116
- my $m = int((time - $start) / 60);
117
- my $so_far = $m ? " (still, $m min so far)" : "";
118
- print STDERR "[local-stack-lock] ⏳ $who is waiting for the local stack $label$so_far: in use by " . $holder->() . "\n";
119
- $next_note = time + 60;
120
- }
121
- sleep 1;
122
- }
123
- $SIG{TERM} = $SIG{INT} = $SIG{HUP} = sub { unlink "$file.holder"; exit 0 };
124
- if (open(my $h, ">", "$file.holder")) {
125
- print $h "$who — $checkout (pid $owner, since " . strftime("%H:%M:%S", localtime) . ")\n";
126
- close $h;
127
- }
128
- print $out "ok\n";
129
- close $out;
130
- sleep 1 while $caller_alive->();
131
- unlink "$file.holder";
132
- ' "$_lsl_file" "$$" "$_lsl_who" "$_LOCAL_STACK_LOCK_ROOT" "$_lsl_fifo" "${LOCAL_STACK_LOCK_WAIT_S:-3600}" "$_lsl_mode" "$_lsl_label" </dev/null >/dev/null &
133
- _lsl_pid=$!
134
- # The fifo is opened read-write, so the read never blocks on a holder that died before it
135
- # answered (a failed fork under load, a killed perl): the loop stops once it is gone.
136
- _lsl_reply="$(
137
- exec 3<>"$_lsl_fifo"
138
- while :; do
139
- if IFS= read -r -t 1 _lsl_line <&3; then
140
- printf '%s' "$_lsl_line"
141
- break
142
- fi
143
- kill -0 "$_lsl_pid" 2>/dev/null || break
144
- done
145
- )" || true
146
- rm -f "$_lsl_fifo"
147
-
148
- case "$_lsl_reply" in
149
- ok)
150
- LOCAL_STACK_LOCK_PID="$_lsl_pid"
151
- export LOCAL_STACK_LOCK_OWNER="$$"
152
- return 0
153
- ;;
154
- busy\ *)
155
- echo "[local-stack-lock] the local stack $_lsl_label is in use by ${_lsl_reply#busy }" >&2
156
- ;;
157
- timeout\ *)
158
- echo "[local-stack-lock] ❌ $_lsl_who gave up after ${LOCAL_STACK_LOCK_WAIT_S:-3600}s waiting for the local stack $_lsl_label, in use by ${_lsl_reply#timeout }" >&2
159
- echo "[local-stack-lock] Let that run finish, or stop it. LOCAL_STACK_LOCK_WAIT_S sets how long to wait." >&2
160
- ;;
161
- "")
162
- echo "[local-stack-lock] ❌ could not take the lock for the local stack $_lsl_label: the perl process holding it stopped before it answered" >&2
163
- ;;
164
- *)
165
- echo "[local-stack-lock] ❌ could not take the lock for the local stack $_lsl_label: ${_lsl_reply#error }" >&2
166
- ;;
167
- esac
168
- wait "$_lsl_pid" 2>/dev/null || true
169
- return 1
170
- }
171
-
172
- take_local_stack_lock() { _local_stack_lock wait "$1"; }
173
- try_local_stack_lock() { _local_stack_lock try "$1"; }
174
-
175
- release_local_stack_lock() {
176
- [ -n "$LOCAL_STACK_LOCK_PID" ] || return 0
177
- kill "$LOCAL_STACK_LOCK_PID" 2>/dev/null || true
178
- wait "$LOCAL_STACK_LOCK_PID" 2>/dev/null || true
179
- LOCAL_STACK_LOCK_PID=""
180
- unset LOCAL_STACK_LOCK_OWNER
181
- return 0
182
- }
183
-
184
- if [ "${BASH_SOURCE[0]}" = "$0" ]; then
185
- if [ "${1:-}" != "run" ] || [ -z "${2:-}" ]; then
186
- echo "usage: bash scripts/ci/bkit-local-stack-lock.sh run \"<who>\" -- <command> [args…]" >&2
187
- exit 2
188
- fi
189
- _lsl_run_who="$2"
190
- shift 2
191
- [ "${1:-}" = "--" ] && shift
192
- take_local_stack_lock "$_lsl_run_who" || exit 1
193
- "$@"
194
- fi
@@ -1,149 +0,0 @@
1
- // bkit workstreams parse|comment — design Step 11: read the organised design's
2
- // `## Suggested Workstreams` and build the advisory comment for the feature's
3
- // own issue.
4
- //
5
- // Advisory only. Workflows never create tracker issues, comment on another
6
- // issue, or set blockers, so nothing here matches workstreams to issues
7
- // or builds blocked-by bodies. The tracker write itself stays an MCP call in the
8
- // workflow; this prepares its body.
9
- import * as fs from "node:fs";
10
- import * as path from "node:path";
11
- import { CommandError, EXIT } from "../lib.js";
12
- import { COMMENT_FILE_OUTPUT, GENERATED_MARKER, commentFileOf, stampMarker } from "./tracker.js";
13
- /** Exit code: no workstream parsed — the workflow's Failure Path. */
14
- export const EXIT_NONE = 3;
15
- const HEADING = /^(#{1,6})\s+(.*?)\s*$/;
16
- const WS_HEADING = /^###\s+WS-(\d+):\s*(.*?)\s*$/;
17
- /**
18
- * Every `### WS-{N}: {NAME}` block under the LAST `## Suggested Workstreams`
19
- * heading (the organise step appends it after a verbatim copy of the design),
20
- * with its `#### Requires` value. An inline `Requires: [...]` line is read too.
21
- */
22
- export function parseWorkstreams(md) {
23
- const lines = md.split("\n");
24
- let start = -1;
25
- lines.forEach((l, i) => {
26
- if (/^##\s+Suggested Workstreams\s*$/.test(l))
27
- start = i;
28
- });
29
- if (start === -1)
30
- return [];
31
- const section = [];
32
- for (const line of lines.slice(start + 1)) {
33
- const h = HEADING.exec(line);
34
- if (h && h[1].length <= 2)
35
- break;
36
- section.push(line);
37
- }
38
- const out = [];
39
- let current;
40
- /** The `####` subsection the line sits in; undefined directly under the WS heading. */
41
- let sub;
42
- for (const line of section) {
43
- const ws = WS_HEADING.exec(line);
44
- if (ws) {
45
- current = {
46
- id: `WS-${ws[1]}`,
47
- n: Number(ws[1]),
48
- name: ws[2],
49
- requires: [],
50
- requiresText: "",
51
- };
52
- sub = undefined;
53
- out.push(current);
54
- continue;
55
- }
56
- if (!current)
57
- continue;
58
- const h = HEADING.exec(line);
59
- if (h) {
60
- sub = h[2].toLowerCase();
61
- continue;
62
- }
63
- const inline = sub === undefined ? /^\W*Requires\W*:\**\s*(.*)$/i.exec(line)?.[1] : undefined;
64
- const value = (sub === "requires" ? line : inline)?.trim();
65
- if (value && current.requiresText === "") {
66
- current.requiresText = value;
67
- current.requires = value.match(/WS-\d+/g) ?? [];
68
- }
69
- }
70
- return out;
71
- }
72
- /** `[]` or `[WS-1, WS-2]`. */
73
- export const requiresList = (w) => `[${w.requires.join(", ")}]`;
74
- /** The Step 11 comment: one line per workstream, the issue-body line, then the design doc link. */
75
- export function commentBody(ws, opts) {
76
- const doc = `docs/plans/${opts.month}/${opts.fid}-design.md`;
77
- const url = `https://github.com/${opts.ownerRepo}/blob/dev/${doc}`;
78
- const lines = [
79
- GENERATED_MARKER,
80
- "### Step 11 — Suggested Workstreams",
81
- "Advisory only. NEVER auto-trigger.",
82
- ...ws.map((w) => `- ${w.id}: ${w.name}. Requires: ${requiresList(w)}`),
83
- `Filing one issue per workstream: put \`**Parent design:** [${opts.fid}-design.md](${url})\` in its body, and list the issues it requires in a blocked-by block (.bkit/trackers.md § Issue shapes).`,
84
- `[${doc}](${url})`,
85
- ];
86
- return stampMarker(lines.join("\n"));
87
- }
88
- const ARTIFACT_FLAG = {
89
- name: "artifact",
90
- type: "string",
91
- required: true,
92
- help: "the organised design, docs/plans/{YYYYMM}/logs/{FID}/design-v3-organised.md",
93
- };
94
- function read(ctx) {
95
- const file = path.resolve(ctx.cwd, String(ctx.flags.artifact));
96
- if (!fs.existsSync(file))
97
- throw new CommandError(EXIT.USAGE, `--artifact ${file} does not exist`);
98
- const ws = parseWorkstreams(fs.readFileSync(file, "utf-8"));
99
- if (ws.length === 0) {
100
- throw new CommandError(EXIT_NONE, `no "### WS-{N}: {NAME}" block under "## Suggested Workstreams" in ${file}`);
101
- }
102
- return ws;
103
- }
104
- export const workstreamsCommand = {
105
- noun: "workstreams",
106
- summary: "Parse the organised design's suggested workstreams and build the advisory comment.",
107
- verbs: {
108
- parse: {
109
- summary: "List each WS-{N} with its name and Requires.",
110
- flags: [ARTIFACT_FLAG],
111
- output: { workstreams: "[{id, n, name, requires, requiresText}] in file order" },
112
- exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
113
- run: (ctx) => {
114
- ctx.emit({ workstreams: read(ctx) });
115
- return EXIT.OK;
116
- },
117
- },
118
- comment: {
119
- summary: "The Step 11 comment body for the feature's own issue (posted via MCP by the workflow).",
120
- flags: [
121
- ARTIFACT_FLAG,
122
- { name: "fid", type: "string", required: true, help: "feature id" },
123
- { name: "month", type: "string", required: true, help: "YYYYMM bucket of the design doc" },
124
- {
125
- name: "owner-repo",
126
- type: "string",
127
- required: true,
128
- help: "owner/repo for the design doc link",
129
- },
130
- ],
131
- output: {
132
- comment: "the comment body",
133
- commentFile: COMMENT_FILE_OUTPUT,
134
- workstreams: "the parsed workstreams",
135
- },
136
- exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
137
- run: (ctx) => {
138
- const workstreams = read(ctx);
139
- const body = commentBody(workstreams, {
140
- ownerRepo: String(ctx.flags.ownerRepo),
141
- month: String(ctx.flags.month),
142
- fid: String(ctx.flags.fid),
143
- });
144
- ctx.emit({ comment: body, commentFile: commentFileOf(ctx.cwd, body), workstreams });
145
- return EXIT.OK;
146
- },
147
- },
148
- },
149
- };