@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -15,20 +15,171 @@
15
15
  // step's own commit (if any). Forensic only — points to the commit that preceded
16
16
  // this step's work, not the commit that resulted from it.
17
17
 
18
+ import { createHash } from "node:crypto";
19
+ import * as fs from "node:fs";
20
+ import * as path from "node:path";
21
+
22
+ import { parseJson } from "../shared/json.js";
23
+
24
+ export const CI_TIERS = ["static", "unit", "integration", "e2e", "live", "migration"] as const;
25
+ export type CiTier = (typeof CI_TIERS)[number];
26
+ export type CiSelection =
27
+ | { mode: "local"; reason: string }
28
+ | {
29
+ mode: "ci";
30
+ provider: "github";
31
+ repo: string;
32
+ runId: string;
33
+ runAttempt: number;
34
+ runUrl: string;
35
+ workflowId: string;
36
+ workflowPath: string;
37
+ headBranch: string;
38
+ headSha: string;
39
+ conclusion: "failure" | "timed_out" | "startup_failure";
40
+ redTiers: CiTier[];
41
+ via: string;
42
+ };
43
+
44
+ /** Validate the whole saved selection before any reader treats it as evidence. */
45
+ export function validateCiSelection(value: unknown): value is CiSelection {
46
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
47
+ const v = value as Record<string, unknown>;
48
+ if (v.mode === "local") return typeof v.reason === "string" && v.reason.trim().length > 0;
49
+ const stringField = (key: string) => (typeof v[key] === "string" ? v[key] : "");
50
+ const repo = stringField("repo");
51
+ const runId = stringField("runId");
52
+ const branch = stringField("headBranch");
53
+ return (
54
+ v.mode === "ci" &&
55
+ v.provider === "github" &&
56
+ /^[A-Za-z0-9][A-Za-z0-9_.-]*\/[A-Za-z0-9][A-Za-z0-9_.-]*$/.test(repo) &&
57
+ /^[1-9][0-9]*$/.test(runId) &&
58
+ Number.isSafeInteger(v.runAttempt) &&
59
+ Number(v.runAttempt) > 0 &&
60
+ stringField("runUrl") ===
61
+ `https://github.com/${repo}/actions/runs/${runId}/attempts/${v.runAttempt}` &&
62
+ /^[1-9][0-9]*$/.test(stringField("workflowId")) &&
63
+ /^\.github\/workflows\/[^/]+\.ya?ml$/.test(stringField("workflowPath")) &&
64
+ !stringField("workflowPath").includes("..") &&
65
+ branch.length > 0 &&
66
+ !branch.startsWith("-") &&
67
+ !branch.startsWith("/") &&
68
+ !branch.endsWith("/") &&
69
+ !/[\s~^:?*\[\\\u0000-\u001f\u007f]/.test(branch) &&
70
+ !branch.includes("..") &&
71
+ !branch.includes("//") &&
72
+ !branch.includes("@{") &&
73
+ !branch.endsWith(".") &&
74
+ branch.split("/").every((part) => !part.startsWith(".") && !part.endsWith(".lock")) &&
75
+ /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(stringField("headSha")) &&
76
+ ["failure", "timed_out", "startup_failure"].includes(stringField("conclusion")) &&
77
+ Array.isArray(v.redTiers) &&
78
+ v.redTiers.every((tier) => CI_TIERS.some((known) => known === tier)) &&
79
+ typeof v.via === "string" &&
80
+ v.via.trim().length > 0
81
+ );
82
+ }
83
+
84
+ /** Transport and wording changes preserve the identity of the evidence. */
85
+ export function ciSelectionIdentity(selection: CiSelection): string {
86
+ return JSON.stringify(
87
+ selection.mode === "local"
88
+ ? ["local"]
89
+ : [
90
+ selection.provider,
91
+ selection.repo.toLowerCase(),
92
+ selection.workflowId,
93
+ selection.workflowPath,
94
+ selection.runId,
95
+ selection.runAttempt,
96
+ selection.headSha,
97
+ ],
98
+ );
99
+ }
100
+
18
101
  export type Step = {
19
102
  step: string;
20
103
  status: "DONE" | "FAILED";
21
104
  at: string;
22
105
  parentSha: string;
23
106
  artifacts: string[];
24
- verdict?: "PASS" | "FAIL" | "CONCERNS" | "SINGLE" | "SPLIT";
107
+ verdict?: "PASS" | "FAIL" | "CONCERNS" | "HANDOVER" | "SINGLE" | "SPLIT";
25
108
  attempt?: number;
109
+ /** The task group the step ran for. */
110
+ group?: number;
111
+ /** A row written before groups replaced sub-plans; read as its group. */
26
112
  subPlan?: number;
27
113
  failures?: number;
28
114
  strategy?: "STANDARD" | "PIVOT" | "FINAL";
29
115
  scope?: string;
116
+ ciGeneration?: number;
117
+ reproduced?: string;
30
118
  };
31
119
 
120
+ /** Validate the bounded CI evidence variant without relaxing local exit codes. */
121
+ export function testRunProblem(value: unknown): string | null {
122
+ if (!value || typeof value !== "object") return "test-run must be an object";
123
+ const r = value as Record<string, unknown>;
124
+ const positive = (v: unknown) => Number.isSafeInteger(v) && Number(v) > 0;
125
+ if (r.source === "ci") {
126
+ if (
127
+ r.workflow !== "debug" ||
128
+ r.step !== "debug-run-tests" ||
129
+ r.verdict !== "FAIL" ||
130
+ r.exitCode !== null ||
131
+ r.failures !== null ||
132
+ r.gate !== null ||
133
+ !positive(r.ciGeneration) ||
134
+ !positive(r.runAttempt) ||
135
+ typeof r.ciRun !== "string" ||
136
+ !/^[1-9][0-9]*$/.test(r.ciRun) ||
137
+ r.scope !== `ci:${r.ciRun}` ||
138
+ typeof r.artifact !== "string" ||
139
+ !r.artifact ||
140
+ typeof r.repo !== "string" ||
141
+ !/^[\w.-]+\/[\w.-]+$/.test(r.repo) ||
142
+ r.ciUrl !== `https://github.com/${r.repo}/actions/runs/${r.ciRun}/attempts/${r.runAttempt}` ||
143
+ typeof r.workflowId !== "string" ||
144
+ !/^[1-9][0-9]*$/.test(r.workflowId) ||
145
+ typeof r.workflowPath !== "string" ||
146
+ !/^\.github\/workflows\/[^/]+\.ya?ml$/.test(r.workflowPath) ||
147
+ typeof r.headSha !== "string" ||
148
+ !/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(r.headSha)
149
+ )
150
+ return "invalid CI evidence round";
151
+ return null;
152
+ }
153
+ if (r.source !== undefined && r.source !== "local") return "invalid test source";
154
+ if (!Number.isSafeInteger(r.exitCode) || Number(r.exitCode) < 0)
155
+ return "local exitCode must be a non-negative integer";
156
+ if (r.failures !== null && (!Number.isSafeInteger(r.failures) || Number(r.failures) < 0))
157
+ return "invalid failure count";
158
+ return null;
159
+ }
160
+
161
+ /** A round belongs to exactly one saved evidence generation. */
162
+ export function ciRoundMatches(
163
+ row: Record<string, unknown>,
164
+ selection: unknown,
165
+ generation: unknown,
166
+ ): boolean {
167
+ return (
168
+ validateCiSelection(selection) &&
169
+ selection.mode === "ci" &&
170
+ testRunProblem(row) === null &&
171
+ row.source === "ci" &&
172
+ row.ciGeneration === generation &&
173
+ row.ciRun === selection.runId &&
174
+ row.runAttempt === selection.runAttempt &&
175
+ row.ciUrl === selection.runUrl &&
176
+ row.repo === selection.repo &&
177
+ row.workflowId === selection.workflowId &&
178
+ row.workflowPath === selection.workflowPath &&
179
+ row.headSha === selection.headSha
180
+ );
181
+ }
182
+
32
183
  export type WorkflowRun = {
33
184
  workflow: string;
34
185
  startedAt: string;
@@ -44,14 +195,25 @@ export type StatusEvent =
44
195
  | { type: "workflow-started"; workflow: string; at: string }
45
196
  | ({ type: "step-done"; workflow: string } & Step)
46
197
  | ({ type: "workflow-meta"; workflow: string; at: string } & Record<string, unknown>)
47
- | { type: "workflow-done"; workflow: string; at: string }
198
+ // `parentSha`: HEAD at close, the run's join key (`run.parentSha` on its ledger rows).
199
+ // `ending` / `publish`: a build's close; `held` = a local build that published nothing.
200
+ | {
201
+ type: "workflow-done";
202
+ workflow: string;
203
+ at: string;
204
+ parentSha?: string;
205
+ ending?: "done" | "held";
206
+ publish?: boolean;
207
+ }
48
208
  | { type: "workflow-failed"; workflow: string; at: string };
49
209
 
50
210
  // Identity for de-dup under union merge. `step-done` is unique per
51
211
  // (workflow, step, parentSha, at); workflow-level events per (type, workflow, at).
52
212
  function identity(e: StatusEvent): string {
53
213
  if (e.type === "step-done")
54
- return `S\u0000${e.workflow}\u0000${e.step}\u0000${e.parentSha}\u0000${e.at}`;
214
+ return `S\u0000${e.workflow}\u0000${e.step}\u0000${e.parentSha}\u0000${e.at}${e.ciGeneration === undefined ? "" : `\u0000${e.status}\u0000${e.ciGeneration}`}`;
215
+ if (e.type === "workflow-meta" && e.ciSelection !== undefined)
216
+ return `M\u0000${e.workflow}\u0000${e.at}\u0000${e.ciGeneration}\u0000${JSON.stringify(e.ciSelection)}`;
55
217
  return `W\u0000${e.type}\u0000${e.workflow}\u0000${e.at}`;
56
218
  }
57
219
 
@@ -142,26 +304,26 @@ export function lastRun(runs: WorkflowRun[], workflow: string): WorkflowRun | un
142
304
 
143
305
  export interface StepFilter {
144
306
  step: string;
145
- subPlan?: number;
307
+ group?: number;
146
308
  }
147
309
 
148
310
  const matches = (s: Step, f: StepFilter) =>
149
- s.step === f.step && s.status === "DONE" && (f.subPlan === undefined || s.subPlan === f.subPlan);
311
+ s.step === f.step &&
312
+ s.status === "DONE" &&
313
+ (f.group === undefined || (s.group ?? s.subPlan) === f.group);
150
314
 
151
- /**
152
- * DONE rows for the step in the active run of `workflow`. `since` names a run
153
- * field holding a timestamp (SOAK's `soakEntryAt`): only rows after it count.
154
- */
155
- export function activeDoneSteps(
156
- runs: WorkflowRun[],
157
- workflow: string,
158
- f: StepFilter,
159
- since?: string,
160
- ): Step[] {
315
+ /** DONE rows for the step in the active run of `workflow`. */
316
+ export function activeDoneSteps(runs: WorkflowRun[], workflow: string, f: StepFilter): Step[] {
161
317
  const run = lastRun(runs, workflow);
162
318
  if (!run) return [];
163
- const floor = since === undefined ? undefined : String(run[since] ?? "");
164
- return run.steps.filter((s) => matches(s, f) && (floor === undefined || s.at > floor));
319
+ return run.steps.filter((s) => matches(s, f));
320
+ }
321
+
322
+ /** DONE rows for the step across ALL runs of `workflow`: debug's limits span every run. */
323
+ export function allRunsDoneSteps(runs: WorkflowRun[], workflow: string, f: StepFilter): Step[] {
324
+ return runs
325
+ .filter((r) => r.workflow === workflow)
326
+ .flatMap((r) => r.steps.filter((s) => matches(s, f)));
165
327
  }
166
328
 
167
329
  /** The last DONE row for the step across ALL runs of `workflow`. */
@@ -179,13 +341,12 @@ export function lastDoneStepAllRuns(
179
341
 
180
342
  /**
181
343
  * Which run of `workflow` this invocation is (1-based): the count of its runs,
182
- * plus one unless the latest run overall is one of them still IN_PROGRESS — a
183
- * resume. Same answer before and after the run's `workflow-started` row lands.
344
+ * plus one unless the latest of them is still IN_PROGRESS — a resume, even after
345
+ * another workflow's run. Same answer before and after the run's `workflow-started` row lands.
184
346
  */
185
347
  export function runNumber(runs: WorkflowRun[], workflow: string): number {
186
348
  const n = runs.filter((r) => r.workflow === workflow).length;
187
- const latest = runs.at(-1);
188
- return latest?.workflow === workflow && latest.status === "IN_PROGRESS" ? n : n + 1;
349
+ return lastRun(runs, workflow)?.status === "IN_PROGRESS" ? n : n + 1;
189
350
  }
190
351
 
191
352
  /**
@@ -204,6 +365,73 @@ export function runOrStepField(runs: WorkflowRun[], workflow: string, field: str
204
365
  return fromStep === undefined ? "" : String(fromStep);
205
366
  }
206
367
 
368
+ // ---------------------------------------------------------------------------
369
+ // engine-action rows — an engine action unsafe to repeat (a tracker comment, a
370
+ // marker commit, a CI re-trigger, a PR open) records itself here and is checked
371
+ // first, so a re-run of the same block does not do it twice. Actions safe to
372
+ // repeat (a label already set) record nothing. The fold and every status reader
373
+ // skip the type.
374
+ // ---------------------------------------------------------------------------
375
+
376
+ export const ENGINE_ACTION = "engine-action";
377
+
378
+ export type EngineActionRow = {
379
+ type: typeof ENGINE_ACTION;
380
+ /** What was done: `comment`, `commit`, `dispatch`, `pr-open`, … */
381
+ action: string;
382
+ /** The moment: workflow, run, step, task group, attempt and kind, joined by `/`. */
383
+ key: string;
384
+ /** sha256 of the body or payload acted on. */
385
+ hash: string;
386
+ /** What the action made: comment URL, commit SHA, run id; null when it names none. */
387
+ ref: string | null;
388
+ at: string;
389
+ };
390
+
391
+ /** The `key` of an engine-action row: its parts joined by `/`, an absent part as `-`. */
392
+ export const actionKey = (...parts: Array<string | number | undefined | null>): string =>
393
+ parts.map((p) => (p === undefined || p === null || p === "" ? "-" : String(p))).join("/");
394
+
395
+ /** sha256 hex of an action's body or payload. */
396
+ export const actionHash = (payload: string): string =>
397
+ createHash("sha256").update(payload).digest("hex");
398
+
399
+ /** The engine-action rows of `file`; a missing file or a malformed line reads as none. */
400
+ function engineActions(file: string): EngineActionRow[] {
401
+ if (!fs.existsSync(file)) return [];
402
+ const out: EngineActionRow[] = [];
403
+ for (const line of fs.readFileSync(file, "utf-8").split("\n")) {
404
+ if (line.trim() === "") continue;
405
+ const parsed = parseJson(line);
406
+ if (!parsed.ok) continue;
407
+ const r = parsed.value as Partial<EngineActionRow> | null;
408
+ if (r?.type === ENGINE_ACTION && typeof r.key === "string" && typeof r.hash === "string")
409
+ out.push(r as EngineActionRow);
410
+ }
411
+ return out;
412
+ }
413
+
414
+ /**
415
+ * The row recording this action already done (same key, same hash), or undefined.
416
+ * Same key with a different hash is a deliberate edit: act again.
417
+ */
418
+ export function alreadyDone(file: string, key: string, hash: string): EngineActionRow | undefined {
419
+ return engineActions(file)
420
+ .filter((r) => r.key === key && r.hash === hash)
421
+ .at(-1);
422
+ }
423
+
424
+ /** Append the engine-action row for an action just done; returns the row. */
425
+ export function recordAction(
426
+ file: string,
427
+ a: { action: string; key: string; hash: string; ref: string | null },
428
+ ): EngineActionRow {
429
+ const row: EngineActionRow = { type: ENGINE_ACTION, ...a, at: statusTimestamp() };
430
+ fs.mkdirSync(path.dirname(file), { recursive: true });
431
+ fs.appendFileSync(file, appendLine(row));
432
+ return row;
433
+ }
434
+
207
435
  export type Strategy = NonNullable<Step["strategy"]>;
208
436
 
209
437
  /** Next rung: none -> STANDARD -> PIVOT -> FINAL, and FINAL stays FINAL. */