@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,20 +1,21 @@
1
- > Example output. Copy to `docs/capabilities.md`, own it. `bkit install` does not write this file and does not overwrite a copy.
1
+ > Example output. Copy it to `docs/capabilities.md` and own it. `bkit install` does not write this file and does not overwrite a copy.
2
2
  >
3
- > `pnpm graph:rollup` rewrites everything outside Overrides block; do not edit generated body. Add capability in `scripts/graphify/bkit-graph-drift-rules.json`. Running the tools: `.bkit/templates.md`.
3
+ > `pnpm bkit:graph:rollup` rewrites everything outside the Overrides block, so do not edit the generated body. To add a capability, add it in `scripts/graphify/bkit-graph-drift-rules.json`. How to run the tools is in `.bkit/templates.md`.
4
4
 
5
5
  # Capabilities
6
6
 
7
7
  > [!CAUTION]
8
- > **Purpose:** One row per capability — owner module, literal marker finding every use, whether anything bypasses owner.
8
+ > **Purpose:** One row per capability, with its owner module, the literal marker that finds every use of it, and whether anything bypasses the owner.
9
9
  >
10
10
  > **Rules:**
11
11
  >
12
- > - GENERATED. `pnpm graph:refresh` rewrites this file.
13
- > - Source of truth: `scripts/graphify/bkit-graph-drift-rules.json`. Status is derived from the tree, never typed.
14
- > - Markers literal, never regex. Regex metacharacter in a marker matches nothing → reads as clean result.
15
- > - Optional `scope`: path prefixes. Optional `surface`: `product` (default), `tests`, or `all`.
16
- > - Optional `budgets`: exact non-owner site count allowed per scope prefix. Measured = declared → `budgeted`.
17
- > - Only Overrides block is hand-maintained; malformed block aborts run.
12
+ > - This file is generated. `pnpm bkit:graph:refresh` rewrites it.
13
+ > - The source of truth is `scripts/graphify/bkit-graph-drift-rules.json`. Each status is derived from the tree, never typed in.
14
+ > - Markers are literal, never regex. A regex metacharacter in a marker matches nothing, and the row then reads as a clean result.
15
+ > - Optional `scope`: path prefixes.
16
+ > - Optional `surface`: `product` (default), `tests` or `all`.
17
+ > - Optional `budgets`: the exact non-owner site count allowed per scope prefix. Measured = declared → `budgeted`.
18
+ > - Only the Overrides block is hand-maintained. A malformed block aborts the run.
18
19
 
19
20
  ## Status Vocabulary
20
21
 
@@ -30,7 +31,7 @@
30
31
 
31
32
  ## Register
32
33
 
33
- Not built. Run `pnpm graph:rollup`.
34
+ Not built. Run `pnpm bkit:graph:rollup`.
34
35
 
35
36
  ## Unreachable API calls
36
37
 
@@ -42,7 +43,7 @@ Not scanned.
42
43
 
43
44
  ## Overrides
44
45
 
45
- Only hand-maintained region. Rename node, hide node / edge, pin note, force nodes into a named group. Each `hide_nodes` entry needs a one-line reason in `hide_nodes_why`.
46
+ This is the only hand-maintained region. Use it to rename a node, hide a node or an edge, pin a note, or force nodes into a named group. Each `hide_nodes` entry needs a one-line reason in `hide_nodes_why`.
46
47
 
47
48
  <!-- overrides:start -->
48
49
 
@@ -61,12 +62,12 @@ Only hand-maintained region. Rename node, hide node / edge, pin note, force node
61
62
 
62
63
  ## User-facing routes → backend capabilities
63
64
 
64
- No route layer yet. Run `pnpm graph:rollup`.
65
+ No route layer yet. Run `pnpm bkit:graph:rollup`.
65
66
 
66
67
  ## Architecture — packages
67
68
 
68
- Filled by `pnpm graph:rollup`.
69
+ Filled by `pnpm bkit:graph:rollup`.
69
70
 
70
71
  ## Architecture — modules
71
72
 
72
- Filled by `pnpm graph:rollup`.
73
+ Filled by `pnpm bkit:graph:rollup`.
@@ -2,7 +2,7 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-accepted-divergences.mjs — the accepted-divergence guard.
5
+ * bkit-check-accepted-divergences.mjs — the accepted-divergence guard.
6
6
  *
7
7
  * CI branches on the event in deliberate places (a PR plans against its base; a push against
8
8
  * the last green run; `@live` is push-only). Each is an ACCEPTED divergence from "one script
@@ -17,7 +17,7 @@
17
17
  * `file#(workflow)#concurrency#field`. Only `.github/workflows/*.yml` is scanned; scripts,
18
18
  * hooks and tests are not.
19
19
  *
20
- * Usage: node scripts/ci/check-accepted-divergences.mjs [--workflows=<dir>] [--registry=<file>]
20
+ * Usage: node scripts/ci/bkit-check-accepted-divergences.mjs [--workflows=<dir>] [--registry=<file>]
21
21
  * Exit: 0 = every site registered and every row live, 1 = drift.
22
22
  */
23
23
 
@@ -156,7 +156,10 @@ function main(argv) {
156
156
  return hit ? hit.slice(name.length + 3) : fallback;
157
157
  };
158
158
  const workflowsDir = arg("workflows", path.join(".github", "workflows"));
159
- const registryPath = arg("registry", path.join("scripts", "ci", "accepted-divergences.json"));
159
+ const registryPath = arg(
160
+ "registry",
161
+ path.join("scripts", "ci", "bkit-accepted-divergences.json"),
162
+ );
160
163
 
161
164
  if (!fs.existsSync(registryPath)) {
162
165
  console.error(`[accepted-divergences] no registry at ${registryPath} — nothing to check`);
@@ -2,16 +2,16 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-accepted-divergences.test.mjs — unit tests for the accepted-divergence guard.
5
+ * bkit-check-accepted-divergences.test.mjs — unit tests for the accepted-divergence guard.
6
6
  *
7
- * Pure Node, no runner: `node scripts/ci/check-accepted-divergences.test.mjs`.
7
+ * Pure Node, no runner: `node scripts/ci/bkit-check-accepted-divergences.test.mjs`.
8
8
  * Exit: 0 = all tests passed, 1 = at least one test failed.
9
9
  */
10
10
 
11
11
  import fs from "node:fs";
12
12
  import os from "node:os";
13
13
  import path from "node:path";
14
- import { collectSites, checkRegistry } from "./check-accepted-divergences.mjs";
14
+ import { collectSites, checkRegistry } from "./bkit-check-accepted-divergences.mjs";
15
15
 
16
16
  let passed = 0;
17
17
  let failed = 0;
@@ -2,7 +2,7 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-capstone.mjs — the decision behind the `bkit-tests-check` capstone.
5
+ * bkit-check-capstone.mjs — the decision behind the `bkit-tests-check` capstone.
6
6
  *
7
7
  * Reads the capstone's `needs` context from the environment and reds when green would prove
8
8
  * nothing. It fails when:
@@ -29,7 +29,7 @@
29
29
  * EMPTY_COUNT `warn` turns a lane that reports no count yet into a warning. Any
30
30
  * other value fails it. A count of 0 or a non-number always fails.
31
31
  *
32
- * Usage: node scripts/ci/check-capstone.mjs
32
+ * Usage: node scripts/ci/bkit-check-capstone.mjs
33
33
  * Exit: 0 = every expectation met, 1 = at least one failure.
34
34
  */
35
35
 
@@ -2,18 +2,18 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-capstone.test.mjs — unit tests for the capstone gate.
5
+ * bkit-check-capstone.test.mjs — unit tests for the capstone gate.
6
6
  *
7
- * Pure Node, no runner: `node scripts/ci/check-capstone.test.mjs`.
7
+ * Pure Node, no runner: `node scripts/ci/bkit-check-capstone.test.mjs`.
8
8
  * Exit: 0 = all tests passed, 1 = at least one test failed.
9
9
  */
10
10
 
11
11
  import { spawnSync } from "node:child_process";
12
12
  import path from "node:path";
13
13
  import { fileURLToPath } from "node:url";
14
- import { checkCapstone } from "./check-capstone.mjs";
14
+ import { checkCapstone } from "./bkit-check-capstone.mjs";
15
15
 
16
- const SCRIPT = path.join(path.dirname(fileURLToPath(import.meta.url)), "check-capstone.mjs");
16
+ const SCRIPT = path.join(path.dirname(fileURLToPath(import.meta.url)), "bkit-check-capstone.mjs");
17
17
 
18
18
  let passed = 0;
19
19
  let failed = 0;
@@ -2,7 +2,7 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-dependency-audit.mjs — the dependency-audit gate.
5
+ * bkit-check-dependency-audit.mjs — the dependency-audit gate.
6
6
  *
7
7
  * Runs `pnpm audit --json` and reds when a blocking advisory (by default high or critical)
8
8
  * reaches the lockfile without an acceptance in the registry. An acceptance is a row naming
@@ -19,8 +19,13 @@
19
19
  * Reads pnpm's report shape (`advisories`: id → { github_advisory_id, severity, module_name,
20
20
  * patched_versions, findings }). Another package manager → adapt `blockingFindings()`.
21
21
  *
22
- * Usage: node scripts/ci/check-dependency-audit.mjs [--registry=<file>] [--report=<file>]
22
+ * Usage: node scripts/ci/bkit-check-dependency-audit.mjs [--registry=<file>] [--report=<file>]
23
+ * [--unreachable=fail|warn]
23
24
  * --report reads a saved `pnpm audit --json` instead of running the audit.
25
+ * --unreachable (default fail) is what the LIVE audit does when the registry cannot
26
+ * be reached at all: `fail` stops the run (CI's choice), `warn` prints one warning
27
+ * and passes (a local hook that leaves the check to CI). A registry that answered
28
+ * badly (401, 500, a missing endpoint) is never "unreachable": its answer stands.
24
29
  * Exit: 0 = every blocking advisory accepted and every row live, 1 = drift or no report.
25
30
  */
26
31
 
@@ -33,8 +38,32 @@ import { parseArgs } from "node:util";
33
38
  /** Severity → the most days an acceptance may run. Severities not listed never block. */
34
39
  export const DEFAULT_BLOCKING = { critical: 7, high: 30 };
35
40
 
41
+ /**
42
+ * Error codes that mean the registry could not be reached at all — no DNS answer, a
43
+ * refused or reset connection, no route. A reachable registry that answers *badly*
44
+ * (`ERR_PNPM_AUDIT_BAD_RESPONSE` on a 401/500, `ERR_PNPM_AUDIT_ENDPOINT_NOT_EXISTS`) is
45
+ * not one of these: it answered, so its answer stands.
46
+ */
47
+ export const UNREACHABLE_CODES = new Set([
48
+ "ENOTFOUND",
49
+ "EAI_AGAIN",
50
+ "ETIMEDOUT",
51
+ "ECONNREFUSED",
52
+ "ECONNRESET",
53
+ "ECONNABORTED",
54
+ "EHOSTUNREACH",
55
+ "ENETUNREACH",
56
+ "EPIPE",
57
+ ]);
58
+
36
59
  const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
37
60
  const DAY_MS = 24 * 60 * 60 * 1000;
61
+ /**
62
+ * Pure backstop so a hung process cannot stall a push forever. A refused or unresolved
63
+ * registry returns in well under a second (`fetch-retries=0` below); this only catches a
64
+ * black hole, and stays generous so a slow legitimate registry is never cut off.
65
+ */
66
+ const AUDIT_TIMEOUT_MS = 180_000;
38
67
 
39
68
  /** `YYYY-MM-DD` of a Date, in UTC. */
40
69
  export function isoDay(date) {
@@ -111,43 +140,99 @@ export function checkAcceptances(findings, registry, today) {
111
140
  }
112
141
 
113
142
  /**
114
- * Run `pnpm audit --json`, retrying when it prints no report (a registry blip).
115
- * pnpm exits 1 whenever it finds an advisory, so the exit code is not the signal; the report is.
116
- * @returns {object | null} the parsed report, or null after three attempts.
143
+ * Classify what a `pnpm audit --json` run printed. `--json` writes either the report or an
144
+ * `{ "error": { "code": … } }` object to stdout.
145
+ * @returns {{status:"ok", report:object}
146
+ * | {status:"unreachable", code:string}
147
+ * | {status:"failed", detail:string}}
148
+ */
149
+ export function classifyAuditOutput(stdout) {
150
+ let parsed;
151
+ try {
152
+ parsed = JSON.parse(stdout);
153
+ } catch {
154
+ return { status: "failed", detail: "not JSON" };
155
+ }
156
+ if (parsed && typeof parsed.advisories === "object") return { status: "ok", report: parsed };
157
+ const code = parsed?.error?.code;
158
+ if (typeof code === "string" && UNREACHABLE_CODES.has(code)) {
159
+ return { status: "unreachable", code };
160
+ }
161
+ return { status: "failed", detail: typeof code === "string" ? `error ${code}` : "no advisories" };
162
+ }
163
+
164
+ /**
165
+ * Run `pnpm audit --json`. pnpm exits 1 whenever it finds an advisory, so the exit code is
166
+ * not the signal; the report is. `fetch-retries=0` makes an unreachable registry fail in
167
+ * under a second instead of hanging through pnpm's retry backoff. A *reachable* failure (a
168
+ * registry blip) is retried; an unreachable registry returns at once.
169
+ * @returns {ReturnType<typeof classifyAuditOutput>}
117
170
  */
118
171
  function runAudit() {
119
172
  for (let attempt = 1; attempt <= 3; attempt++) {
120
173
  const res = spawnSync("pnpm", ["audit", "--json"], {
121
174
  encoding: "utf-8",
122
175
  maxBuffer: 64 * 1024 * 1024,
176
+ timeout: AUDIT_TIMEOUT_MS,
177
+ killSignal: "SIGKILL",
178
+ env: { ...process.env, npm_config_fetch_retries: "0" },
123
179
  });
124
- let parseError = "";
125
- try {
126
- const report = JSON.parse(res.stdout);
127
- if (report && typeof report.advisories === "object") return report;
128
- } catch (err) {
129
- parseError = `not JSON (${err.message}): `;
130
- }
180
+ if (res.error?.code === "ETIMEDOUT") return { status: "unreachable", code: "ETIMEDOUT" };
181
+ const outcome = classifyAuditOutput(res.stdout ?? "");
182
+ if (outcome.status !== "failed") return outcome;
131
183
  const tail = (res.stderr || res.stdout || "").trim().split("\n").slice(-3).join(" | ");
132
- const detail = parseError + tail;
133
- console.error(`::warning::dependency-audit: attempt ${attempt} printed no report — ${detail}`);
184
+ console.error(
185
+ `::warning::dependency-audit: attempt ${attempt} printed no report — ${outcome.detail}; ${tail}`,
186
+ );
134
187
  }
135
- return null;
188
+ return { status: "failed", detail: "no report after 3 attempts" };
136
189
  }
137
190
 
138
191
  function main(argv) {
139
192
  const { values } = parseArgs({
140
193
  args: argv,
141
- options: { registry: { type: "string" }, report: { type: "string" } },
194
+ options: {
195
+ registry: { type: "string" },
196
+ report: { type: "string" },
197
+ unreachable: { type: "string" },
198
+ },
142
199
  strict: false,
143
200
  });
144
- const registryPath = values.registry ?? path.join("scripts", "ci", "accepted-advisories.json");
201
+ const registryPath =
202
+ values.registry ?? path.join("scripts", "ci", "bkit-accepted-advisories.json");
145
203
  const reportPath = values.report ?? null;
204
+ const unreachable = values.unreachable ?? "fail";
205
+ if (unreachable !== "fail" && unreachable !== "warn") {
206
+ console.error(
207
+ `::error::dependency-audit: --unreachable takes fail or warn, not ${unreachable}`,
208
+ );
209
+ process.exit(1);
210
+ }
146
211
 
147
212
  const registry = fs.existsSync(registryPath)
148
213
  ? JSON.parse(fs.readFileSync(registryPath, "utf-8"))
149
214
  : { accepted: [] };
150
- const report = reportPath ? JSON.parse(fs.readFileSync(reportPath, "utf-8")) : runAudit();
215
+
216
+ let report;
217
+ if (reportPath) {
218
+ // A saved report is the offline replay; only the live audit is ever "unreachable".
219
+ report = JSON.parse(fs.readFileSync(reportPath, "utf-8"));
220
+ } else {
221
+ const outcome = runAudit();
222
+ if (outcome.status === "unreachable") {
223
+ if (unreachable === "warn") {
224
+ console.error(
225
+ `::warning::dependency-audit: registry unreachable (${outcome.code}) — NOT checked; CI re-checks this push`,
226
+ );
227
+ process.exit(0);
228
+ }
229
+ console.error(
230
+ `::error::dependency-audit: registry unreachable (${outcome.code}) — failing closed`,
231
+ );
232
+ process.exit(1);
233
+ }
234
+ report = outcome.report;
235
+ }
151
236
  if (!report || typeof report.advisories !== "object") {
152
237
  console.error("::error::dependency-audit: the audit printed no report — failing closed");
153
238
  process.exit(1);
@@ -2,13 +2,17 @@
2
2
  // Example. Copy into scripts/ci/ and own it. bkit install does not write this file
3
3
  // and does not overwrite a copy.
4
4
  /**
5
- * check-dependency-audit.test.mjs — unit tests for the dependency-audit gate.
5
+ * bkit-check-dependency-audit.test.mjs — unit tests for the dependency-audit gate.
6
6
  *
7
- * Pure Node, no runner: `node scripts/ci/check-dependency-audit.test.mjs`.
7
+ * Pure Node, no runner: `node scripts/ci/bkit-check-dependency-audit.test.mjs`.
8
8
  * Exit: 0 = all tests passed, 1 = at least one test failed.
9
9
  */
10
10
 
11
- import { blockingFindings, checkAcceptances } from "./check-dependency-audit.mjs";
11
+ import {
12
+ blockingFindings,
13
+ checkAcceptances,
14
+ classifyAuditOutput,
15
+ } from "./bkit-check-dependency-audit.mjs";
12
16
 
13
17
  let passed = 0;
14
18
  let failed = 0;
@@ -123,5 +127,29 @@ test("a report with no advisories has nothing to block", () => {
123
127
  assert(blockingFindings({ advisories: {} }).length === 0, "found something");
124
128
  });
125
129
 
130
+ test("classifies a report as ok", () => {
131
+ const r = classifyAuditOutput(JSON.stringify({ advisories: {} }));
132
+ assert(r.status === "ok", `got ${r.status}`);
133
+ });
134
+
135
+ test("classifies an unreachable registry by its network code", () => {
136
+ const r = classifyAuditOutput(
137
+ JSON.stringify({ error: { code: "ENOTFOUND", message: "getaddrinfo ENOTFOUND" } }),
138
+ );
139
+ assert(r.status === "unreachable" && r.code === "ENOTFOUND", JSON.stringify(r));
140
+ });
141
+
142
+ test("a registry that answered badly is a failure, not unreachable", () => {
143
+ for (const code of ["ERR_PNPM_AUDIT_BAD_RESPONSE", "ERR_PNPM_AUDIT_ENDPOINT_NOT_EXISTS"]) {
144
+ const r = classifyAuditOutput(JSON.stringify({ error: { code, message: code } }));
145
+ assert(r.status === "failed", `${code} → ${r.status}`);
146
+ }
147
+ });
148
+
149
+ test("empty or non-JSON output is a failure", () => {
150
+ assert(classifyAuditOutput("").status === "failed", "empty");
151
+ assert(classifyAuditOutput("not json").status === "failed", "not json");
152
+ });
153
+
126
154
  console.log(`\n${passed} passed, ${failed} failed`);
127
155
  process.exit(failed ? 1 : 0);