@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
@@ -0,0 +1,117 @@
1
+ import { parseFindings, mergeFindings, normalizeLocation, lowDeferralKey, } from "./challenge.js";
2
+ import { parseDecisionItems } from "./decisions.js";
3
+ const artifacts = (row) => Array.isArray(row.artifacts)
4
+ ? row.artifacts.filter((p) => typeof p === "string")
5
+ : [];
6
+ /** The latest assessment must cover this task, after its finding and last execution. */
7
+ export function taskVerified(input, task, after) {
8
+ const assessments = input.rows
9
+ .map((row, index) => ({ row, index }))
10
+ .filter(({ row }) => row.type === "step-done" && row.step === "build-plan-verify" && row.group === task.group);
11
+ const latest = assessments.at(-1);
12
+ if (!task.done ||
13
+ latest === undefined ||
14
+ latest.index <= after ||
15
+ latest.row.verdict !== "PASS" ||
16
+ (latest.row.failures !== undefined && latest.row.failures !== 0))
17
+ return false;
18
+ if (input.rows
19
+ .slice(latest.index + 1)
20
+ .some((r) => r.type === "step-done" &&
21
+ r.group === task.group &&
22
+ (r.step === "build-plan-tasks" || r.step === "build-plan-gaps-remediate")))
23
+ return false;
24
+ return artifacts(latest.row).some((p) => {
25
+ const header = (input.read(p) ?? "").split("<!-- verdict:end -->")[0];
26
+ const numbers = /^Tasks:[ \t]*(.*)$/m
27
+ .exec(header)?.[1]
28
+ ?.split(",")
29
+ .map((n) => Number(n.trim())) ?? [];
30
+ return /^Verdict:[ \t]*PASS[ \t]*$/m.test(header) && numbers.includes(task.task);
31
+ });
32
+ }
33
+ /** Unreadable or incomplete evidence leaves the recorded assessment unresolved. */
34
+ export function challengeResolution(input, row, index, tasks) {
35
+ const paths = artifacts(row);
36
+ const round = row.round;
37
+ if (paths.length === 0 || typeof round !== "number")
38
+ return undefined;
39
+ const later = input.rows
40
+ .slice(index + 1)
41
+ .filter((r) => r.type === "step-done" && r.step === "build-challenge");
42
+ if (row.challengeFindings === undefined &&
43
+ later.some((r) => artifacts(r).some((p) => paths.includes(p)))) {
44
+ const latest = later.at(-1);
45
+ const roundTasks = tasks.filter((t) => (/\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? []).includes(round));
46
+ if (latest.verdict !== "PASS" ||
47
+ !paths.every((p) => artifacts(latest).includes(p)) ||
48
+ roundTasks.length === 0 ||
49
+ !roundTasks.every((t) => taskVerified(input, t, index)))
50
+ return undefined;
51
+ return {
52
+ resolved: [
53
+ `build-challenge round ${round}, resolved by build-plan-verify and the later passing challenge covering the same reports`,
54
+ ],
55
+ failures: [],
56
+ concerns: [],
57
+ };
58
+ }
59
+ let findings;
60
+ if (row.challengeFindings !== undefined) {
61
+ const snapshot = row.challengeFindings;
62
+ if (!Array.isArray(snapshot) ||
63
+ !snapshot.every((f) => f !== null &&
64
+ typeof f === "object" &&
65
+ ["CRITICAL", "HIGH", "MEDIUM", "LOW"].includes(String(f.severity)) &&
66
+ typeof f.location === "string" &&
67
+ typeof f.title === "string"))
68
+ return undefined;
69
+ findings = snapshot;
70
+ }
71
+ else {
72
+ const reports = paths.map((p) => input.read(p));
73
+ if (reports.some((t) => t === null))
74
+ return undefined;
75
+ try {
76
+ findings = mergeFindings(reports.map((t, i) => parseFindings(t, paths[i], input.root ?? process.cwd())), new Set()).findings;
77
+ }
78
+ catch (error) {
79
+ return {
80
+ resolved: [],
81
+ failures: row.verdict === "FAIL" ? [`build-challenge FAIL: ${String(error)}`] : [],
82
+ concerns: row.verdict === "CONCERNS" ? [`build-challenge CONCERNS: ${String(error)}`] : [],
83
+ };
84
+ }
85
+ }
86
+ if (findings.length === 0)
87
+ return undefined;
88
+ const result = { resolved: [], failures: [], concerns: [] };
89
+ for (const f of findings) {
90
+ const matches = tasks.filter((t) => {
91
+ const location = /\*\*Location:\*\*\s*([^\n·]+)/.exec(t.text)?.[1];
92
+ const severity = /\*\*Severity:\*\*\s*(\w+)/.exec(t.text)?.[1];
93
+ const rounds = /\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? [];
94
+ return (location !== undefined &&
95
+ normalizeLocation(location, input.root ?? process.cwd()) === f.location &&
96
+ severity === f.severity &&
97
+ rounds.includes(round));
98
+ });
99
+ const label = `build-challenge round ${round}: ${f.severity} ${f.location}`;
100
+ const accepted = input.decisionFiles.some((p) => parseDecisionItems(input.read(p) ?? "").some((item) => /^Accept\b/.test(item.decision ?? "") &&
101
+ [...item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)].some((m) => normalizeLocation(m[0], input.root ?? process.cwd()) === f.location)));
102
+ const closed = f.severity === "LOW" &&
103
+ input.deferrals.some((d) => d.status === "CLOSED" &&
104
+ d.key === lowDeferralKey(input.fid, f.location) &&
105
+ typeof d.source === "string" &&
106
+ normalizeLocation(d.source, input.root ?? process.cwd()) === f.location);
107
+ if (accepted)
108
+ result.concerns.push(`${label}, accepted limitation`);
109
+ else if (closed)
110
+ result.resolved.push(`${label}, resolved by closed deferral`);
111
+ else if (matches.length === 1 && taskVerified(input, matches[0], index))
112
+ result.resolved.push(`${label}, resolved by build-plan-verify (group ${matches[0].group}, task ${matches[0].task})`);
113
+ else
114
+ (f.severity === "CRITICAL" ? result.failures : result.concerns).push(label);
115
+ }
116
+ return result;
117
+ }
@@ -0,0 +1,388 @@
1
+ // The summary a phase workflow writes at its Summary step (`bkit workflows summary`):
2
+ // verdict, reasons and the recommended next command, from the run's status rows,
3
+ // its log files, the plan and the ledger rows it added. Pure: the caller reads the
4
+ // disk and passes `read` for the log files.
5
+ import { coversList } from "./plans.js";
6
+ import { issueIdOf } from "./fids.js";
7
+ import { parseDecisionItems } from "./decisions.js";
8
+ import { parsePlanBlocks } from "./plan-blocks.js";
9
+ import { challengeResolution, taskVerified } from "./summary-findings.js";
10
+ export const SUMMARY_WORKFLOWS = ["plan", "design", "build", "debug", "ship"];
11
+ /** Per workflow and verdict, the next command the summary recommends. */
12
+ export const NEXT_STEP = {
13
+ plan: {
14
+ PASS: { command: "/bkit-build" },
15
+ CONCERNS: { command: "/bkit-build", or: "/bkit-plan" },
16
+ FAIL: { command: "/bkit-plan" },
17
+ },
18
+ design: {
19
+ PASS: { command: "/bkit-plan" },
20
+ CONCERNS: { command: "/bkit-plan", or: "/bkit-design" },
21
+ FAIL: { command: "/bkit-design" },
22
+ },
23
+ debug: {
24
+ PASS: { command: "/bkit-ship" },
25
+ CONCERNS: { command: "/bkit-ship", or: "/bkit-debug" },
26
+ FAIL: { line: "Manual handover — no bkit command; see the debug handover." },
27
+ },
28
+ build: {
29
+ PASS: { command: "/bkit-ship" },
30
+ CONCERNS: { command: "/bkit-ship" },
31
+ FAIL: { command: "/bkit-debug" },
32
+ },
33
+ ship: {
34
+ PASS: { line: "No further bkit command — feature shipped." },
35
+ CONCERNS: { line: "No further bkit command — feature shipped." },
36
+ FAIL: { command: "/bkit-ship" },
37
+ },
38
+ };
39
+ /**
40
+ * The issue reference a FID carries: `160-slug` → `#160`, `abc-123-slug` →
41
+ * `ABC-123`; undefined when the FID has no issue segment for `tracker`.
42
+ */
43
+ export function refOf(fid, tracker = "any") {
44
+ const id = issueIdOf(fid, tracker);
45
+ if (id === null)
46
+ return undefined;
47
+ return /^[0-9]+$/.test(id) ? `#${id}` : id;
48
+ }
49
+ /**
50
+ * Review updates cover their review's findings. Group verification covers failed
51
+ * execution, but does not cover a remediation agent's separate warnings or flakes.
52
+ */
53
+ const RESOLVED_BY = {
54
+ "plan/plan-review": ["plan-apply-review"],
55
+ "design/design-review": ["design-apply-review"],
56
+ "build/build-plan-tasks": ["build-plan-verify"],
57
+ "build/build-plan-gaps-remediate": ["build-plan-verify"],
58
+ };
59
+ const RUN_TESTS = new Set(["build-run-tests", "debug-run-tests"]);
60
+ const SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
61
+ const TEST_EXCEPTION = "**TEST EXCEPTION:**";
62
+ const str = (v) => (typeof v === "string" ? v : undefined);
63
+ const artifactsOf = (r) => Array.isArray(r.artifacts) ? r.artifacts.filter((a) => typeof a === "string") : [];
64
+ /** A step row's task group (`group`, or debug's `subPlan`); undefined when it has none. */
65
+ const taskGroupOf = (r) => {
66
+ const taskGroup = r.group ?? r.subPlan;
67
+ return typeof taskGroup === "number" ? taskGroup : undefined;
68
+ };
69
+ /** The run's step rows grouped per step (and task group), in first-seen order. */
70
+ function stepGroups(rows) {
71
+ const groups = new Map();
72
+ rows.forEach((row, index) => {
73
+ const step = str(row.step);
74
+ if (row.type !== "step-done" || step === undefined)
75
+ return;
76
+ const sub = taskGroupOf(row);
77
+ const scope = sub === undefined ? step : `${step}#${sub}`;
78
+ const key = step === "build-challenge" && typeof row.round === "number" ? `${scope}@${row.round}` : scope;
79
+ const g = groups.get(key) ?? {
80
+ label: sub === undefined ? step : `${step} (group ${sub})`,
81
+ key,
82
+ step,
83
+ rows: [],
84
+ };
85
+ g.rows.push({ row, index });
86
+ groups.set(key, g);
87
+ });
88
+ return [...groups.values()];
89
+ }
90
+ const lastOf = (g) => g.rows.at(-1);
91
+ /** A level-2 section whose heading matches `title`, minus the template's non-content subsections. */
92
+ function planSection(text, title) {
93
+ const lines = text.split("\n");
94
+ const start = lines.findIndex((l) => /^## /.test(l) && title.test(l));
95
+ if (start < 0)
96
+ return undefined;
97
+ const out = [];
98
+ let skip = false;
99
+ for (const line of lines.slice(start + 1)) {
100
+ if (/^## /.test(line))
101
+ break;
102
+ if (/^### /.test(line))
103
+ skip = /Derived Test Matrix|Human Confirmation/.test(line);
104
+ if (!skip)
105
+ out.push(line);
106
+ }
107
+ return out.join("\n").trim();
108
+ }
109
+ /**
110
+ * A TEST EXCEPTION field's entries from its 1-based plan `fieldLines` (`plan-blocks.ts`):
111
+ * the label line's inline value and each sub-bullet, continuation lines joined to the entry above.
112
+ */
113
+ function exceptionEntries(lines, fieldLines) {
114
+ const out = [];
115
+ for (const n of fieldLines) {
116
+ const raw = lines[n - 1] ?? "";
117
+ const label = raw.indexOf(TEST_EXCEPTION);
118
+ const bullet = /^\s*- (.*)$/.exec(raw);
119
+ const text = (label >= 0 ? raw.slice(label + TEST_EXCEPTION.length) : (bullet?.[1] ?? raw)).trim();
120
+ if (text === "")
121
+ continue;
122
+ if (label < 0 && bullet === null && out.length > 0)
123
+ out[out.length - 1] += ` ${text}`;
124
+ else
125
+ out.push(text);
126
+ }
127
+ return out;
128
+ }
129
+ export function buildSummary(input) {
130
+ const { workflow } = input;
131
+ const groups = stepGroups(input.rows);
132
+ const fails = [];
133
+ const concerns = [];
134
+ const resolved = new Map();
135
+ const resolvedFindings = [];
136
+ const reassessed = [];
137
+ const read = (rel) => input.read(rel);
138
+ // Debug: a reproduce step that could not reproduce is a re-run, not a failure.
139
+ const reproduce = groups.find((g) => g.step === "debug-failure-reproduce");
140
+ const reproText = reproduce ? read(artifactsOf(lastOf(reproduce).row)[0] ?? "") : null;
141
+ const notReproduced = reproText !== null && /^Reproduced:\s*NO\b/m.test(reproText);
142
+ if (notReproduced)
143
+ concerns.push("Reproduced: NO");
144
+ // Plan tasks: every unticked task of the plan files; a build always has a plan.
145
+ const tasks = input.plans.flatMap((p) => parsePlanBlocks(p.text).tasks.map((t) => ({ ...t, path: p.path })));
146
+ if (workflow === "build" && input.plans.length === 0)
147
+ fails.push("No plan file");
148
+ if (workflow === "build")
149
+ for (const t of tasks.filter((x) => !x.done)) {
150
+ const sev = SEVERITY.exec(t.text)?.[1];
151
+ fails.push(`Task ${t.task} not done (${t.path})${sev === undefined ? "" : ` — ${sev} challenge finding`}`);
152
+ }
153
+ for (const g of groups) {
154
+ const { row, index } = lastOf(g);
155
+ if (g.step === `${workflow}-summary`)
156
+ continue;
157
+ if (RUN_TESTS.has(g.step)) {
158
+ if (row.verdict === "FAIL")
159
+ fails.push(`${g.label} FAIL`);
160
+ continue;
161
+ }
162
+ if (row.verdict !== "FAIL" && row.verdict !== "CONCERNS")
163
+ continue;
164
+ if (g.step === "debug-failure-reproduce" && notReproduced)
165
+ continue;
166
+ if (workflow === "build" && g.step === "build-challenge") {
167
+ const assessment = challengeResolution(input, row, index, tasks);
168
+ if (assessment !== undefined) {
169
+ fails.push(...assessment.failures);
170
+ concerns.push(...assessment.concerns);
171
+ resolvedFindings.push(...assessment.resolved);
172
+ continue;
173
+ }
174
+ }
175
+ if (workflow === "build" &&
176
+ g.step === "build-plan-current" &&
177
+ tasks.length > 0 &&
178
+ tasks.every((t) => taskVerified(input, t, index))) {
179
+ resolved.set(g.key, "build-plan-verify");
180
+ continue;
181
+ }
182
+ const review = g.step === `${workflow}-review`;
183
+ const spike = workflow === "design" && g.step === "design-spike";
184
+ const answers = spike
185
+ ? ["design-apply-review"]
186
+ : review || row.verdict === "FAIL"
187
+ ? (RESOLVED_BY[`${workflow}/${g.step}`] ?? [])
188
+ : [];
189
+ const sub = taskGroupOf(row);
190
+ const answer = groups
191
+ .map(lastOf)
192
+ .find(({ row: r, index: i }) => i > index &&
193
+ answers.includes(String(r.step)) &&
194
+ (r.verdict === "PASS" || (review && r.verdict === "CONCERNS")) &&
195
+ (r.failures === undefined || r.failures === 0) &&
196
+ taskGroupOf(r) === sub &&
197
+ (!review || r.attempt === row.attempt));
198
+ if (answer !== undefined && spike) {
199
+ const reports = artifactsOf(row).map((p) => read(p));
200
+ const unsettled = reports.map((report) => report === null ? undefined : planSection(report, /^## Unsettled\s*$/));
201
+ if (unsettled.length > 0 &&
202
+ unsettled.every((section) => section !== undefined && section !== "")) {
203
+ if (unsettled.every((section) => /^None\.?$/i.test(section)))
204
+ resolved.set(g.key, String(answer.row.step));
205
+ else {
206
+ concerns.push("design-spike: unsettled claims remain");
207
+ reassessed.push("design-spike: design impact addressed by design-apply-review; unsettled claims remain");
208
+ }
209
+ continue;
210
+ }
211
+ }
212
+ if (answer !== undefined && !spike && answer.row.verdict === "CONCERNS")
213
+ reassessed.push(`${g.label} ${String(row.verdict)}, remaining findings assessed by ${String(answer.row.step)}`);
214
+ else if (answer !== undefined && !spike)
215
+ resolved.set(g.key, String(answer.row.step));
216
+ else if (row.verdict === "FAIL")
217
+ fails.push(`${g.label} FAIL`);
218
+ else
219
+ concerns.push(`${g.label} CONCERNS`);
220
+ }
221
+ // The Decision Pause: accepted items in this run's decision files.
222
+ const decided = groups
223
+ .filter((g) => g.step === "build-decision")
224
+ .flatMap((g) => g.rows.flatMap(({ row }) => artifactsOf(row)));
225
+ const acceptItems = decided.flatMap((rel) => parseDecisionItems(read(rel) ?? "")
226
+ .filter((i) => /^Accept\b/.test(i.decision ?? ""))
227
+ .map((i) => ({ assumed: i.assumed, line: `${rel}: Decision: ${i.decision}` })));
228
+ // `Accept (assumed)`: taken without the owner (`ask: false` or headless); ship asks to confirm.
229
+ const assumed = acceptItems.filter((a) => a.assumed).map((a) => a.line);
230
+ const accepted = acceptItems.filter((a) => !a.assumed).map((a) => a.line);
231
+ if (accepted.length > 0)
232
+ concerns.push(`${accepted.length} item(s) accepted at the Decision Pause`);
233
+ if (assumed.length > 0)
234
+ concerns.push(`${assumed.length} item(s) accepted without the owner (assumed; ship asks to confirm)`);
235
+ // Ship: assumed Accepts the owner rejected or never confirmed; ship merged anyway.
236
+ const unconfirmed = workflow === "ship"
237
+ ? input.decisionFiles.flatMap((rel) => parseDecisionItems(read(rel) ?? "")
238
+ .filter((i) => i.assumed)
239
+ .map((i) => `\`${rel}\` Q${i.n} — ${i.title}${i.rejected ? " (rejected)" : ""}`))
240
+ : [];
241
+ if (unconfirmed.length > 0)
242
+ concerns.push(`shipped with ${unconfirmed.length} assumed item(s) the owner did not confirm`);
243
+ if (input.deferralsAdded > 0)
244
+ concerns.push(`${input.deferralsAdded} deferral(s) from this run remain open`);
245
+ const verdict = fails.length > 0 ? "FAIL" : concerns.length > 0 ? "CONCERNS" : "PASS";
246
+ const reasons = [...fails, ...concerns];
247
+ // Next step.
248
+ const step = NEXT_STEP[workflow][verdict];
249
+ const withRef = (cmd) => (input.ref === undefined ? cmd : `${cmd} ${input.ref}`);
250
+ let nextStep = step.command === undefined ? (step.line ?? "") : withRef(step.command);
251
+ if (workflow === "debug" && notReproduced)
252
+ nextStep = `${withRef("/bkit-debug")} [repro]`;
253
+ const suggested = input.suggestedPlans ?? [];
254
+ if (workflow === "design" && step.command === "/bkit-plan" && suggested.length > 1)
255
+ nextStep = "File the Suggested Plans issues, then /bkit-plan <first root plan's new issue>";
256
+ // Sections.
257
+ const out = [
258
+ `Verdict: ${verdict}`,
259
+ `Failures: ${fails.length}`,
260
+ "<!-- verdict:end -->",
261
+ "",
262
+ `# ${workflow[0].toUpperCase()}${workflow.slice(1)} Summary`,
263
+ "",
264
+ "## Verdict",
265
+ "",
266
+ verdict,
267
+ "",
268
+ ...(reasons.length > 0
269
+ ? reasons.map((r) => `- ${r}`)
270
+ : [
271
+ "- No unresolved finding, failing check, open task, accepted limitation or open deferral.",
272
+ ]),
273
+ ];
274
+ if (workflow === "build")
275
+ out.push("", input.plans.length === 0
276
+ ? "Plan tasks: no plan file."
277
+ : `Plan tasks: ${tasks.filter((t) => t.done).length} of ${tasks.length} ticked in ${input.plans.map((p) => `\`${p.path}\``).join(", ")}.`, "", input.publish === false ? "Publish: held" : "Publish: pr", ...(input.publish === false ? ["", "Docs: not synced (ship syncs on landing)"] : []));
278
+ out.push("", "## Steps", "", "| Step | Verdict | Failures | Attempts | Artifact |", "| --- | --- | --- | --- | --- |");
279
+ for (const g of groups) {
280
+ const { row } = lastOf(g);
281
+ const artifact = artifactsOf(row)
282
+ .map((a) => `\`${a}\``)
283
+ .join(", ");
284
+ out.push(`| ${g.label} | ${str(row.verdict) ?? "-"} | ${typeof row.failures === "number" ? row.failures : "-"} | ${g.rows.length} | ${artifact || "-"} |`);
285
+ }
286
+ out.push("", "## Resolved Findings", "");
287
+ const resolutions = groups
288
+ .filter((g) => resolved.has(g.key))
289
+ .map((g) => `- ${g.label} ${String(lastOf(g).row.verdict)}, resolved by ${resolved.get(g.key)}`);
290
+ resolutions.push(...resolvedFindings.map((r) => `- ${r}`));
291
+ out.push(...(resolutions.length > 0 ? resolutions : ["None"]));
292
+ if (reassessed.length > 0)
293
+ out.push("", "## Reassessed Findings", "", ...reassessed.map((r) => `- ${r}`));
294
+ out.push("", "## Assessment History", "", "| Step | Verdict | Attempt | Artifact |", "| --- | --- | --- | --- |");
295
+ for (const { g, row } of groups
296
+ .flatMap((g) => g.rows.map(({ row, index }) => ({ g, row, index })))
297
+ .sort((a, b) => a.index - b.index)) {
298
+ out.push(`| ${g.label} | ${str(row.verdict) ?? "-"} | ${String(row.attempt ?? "-")} | ${artifactsOf(row)
299
+ .map((a) => `\`${a}\``)
300
+ .join(", ") || "-"} |`);
301
+ }
302
+ if (workflow === "build") {
303
+ const appended = tasks.filter((t) => SEVERITY.test(t.text));
304
+ const low = input.deferrals.filter((r) => r.by?.step === "build-challenge");
305
+ const gate = input.rows.filter((r) => r.type === "challenge-gate").at(-1);
306
+ const skipped = gate?.skipped === true;
307
+ out.push("", "## Challenge", "");
308
+ if (skipped)
309
+ out.push(`- challenge-1 skipped: small change (${String(gate.linesChanged)} lines, ${String(gate.filesChanged)} files)`);
310
+ if (appended.length === 0 && low.length === 0 && !skipped)
311
+ out.push("None");
312
+ for (const t of appended)
313
+ out.push(`- Task ${t.task} — ${SEVERITY.exec(t.text)[1]} — ${t.done ? "ticked" : "not ticked"} (\`${t.path}\`)`);
314
+ for (const r of low)
315
+ out.push(`- LOW, ${r.status === "CLOSED" ? "closed" : "deferred"}: ${String(r.key ?? "")} — ${String(r.description ?? "")}`);
316
+ }
317
+ if (workflow === "build" || workflow === "debug") {
318
+ const runs = groups.filter((g) => RUN_TESTS.has(g.step)).flatMap((g) => g.rows);
319
+ out.push("", "## Tests", "");
320
+ if (runs.length === 0)
321
+ out.push("None recorded.");
322
+ for (const { row } of runs)
323
+ out.push(`- Attempt ${String(row.attempt ?? "?")}: ${str(row.verdict) ?? "-"}, failures ${typeof row.failures === "number" ? row.failures : "-"}, ran \`${str(row.scope) ?? "unknown"}\``);
324
+ }
325
+ if (workflow === "plan") {
326
+ const final = input.plans.at(-1)?.text ?? "";
327
+ out.push("", "## Acceptance Scenario", "", planSection(final, /Acceptance Scenario/) || "None", "", "## Open Questions", "", planSection(final, /Open Questions/) || "None");
328
+ }
329
+ if (workflow === "design") {
330
+ out.push("", "## Suggested Plans", "");
331
+ if (suggested.length === 0)
332
+ out.push("None");
333
+ for (const p of suggested)
334
+ out.push(`### ${p.id}: ${p.name}`, "", `Covers: ${coversList(p, input.workstreams ?? []) || "None"}`, `Requires: ${p.requiresText || "None"}`, "");
335
+ out.push("", "## Open Questions", "", planSection(input.organised ?? "", /Risks & Open Questions/) || "None");
336
+ }
337
+ if (workflow === "ship" && input.pr !== undefined) {
338
+ const pr = input.pr;
339
+ out.push("", "## Pull Request", "", `PR #${pr.number}: +${pr.additions} / -${pr.deletions} lines across ${pr.changedFiles} files.`);
340
+ }
341
+ if (unconfirmed.length > 0)
342
+ out.push("", "## Ship Completed with Assumed Items", "", "Accepted without the owner and not confirmed; each is a `needs-decision` deferral.", "", ...unconfirmed.map((u) => `- ${u}`));
343
+ // Risks and action items.
344
+ const items = [];
345
+ for (const g of groups) {
346
+ if (resolved.has(g.key))
347
+ continue;
348
+ for (const rel of artifactsOf(lastOf(g).row).filter((a) => a.endsWith("-log.md"))) {
349
+ const dispositions = new Map();
350
+ for (const line of (read(rel) ?? "").split("\n")) {
351
+ const entry = /^(BLOCKED|DONE)\s*—\s*((?:task|step|gap)\s+\d+)\b/i.exec(line);
352
+ if (entry !== null)
353
+ dispositions.set(entry[2].toLowerCase(), line);
354
+ else if (/^BLOCKED\b/.test(line))
355
+ dispositions.set(line, line);
356
+ }
357
+ for (const line of [...dispositions.values()].filter((l) => /^BLOCKED\b/.test(l)))
358
+ items.push(`- ${line} (\`${rel}\`)`);
359
+ }
360
+ }
361
+ items.push(...accepted.map((a) => `- Accepted: ${a}`));
362
+ items.push(...assumed.map((a) => `- Assumed, not confirmed: ${a}`));
363
+ for (const rel of workflow === "build" ? input.decisionFiles : []) {
364
+ if (!/^Decision:/m.test(read(rel) ?? ""))
365
+ items.push(`- \`${rel}\`: no decision recorded`);
366
+ }
367
+ for (const p of input.plans) {
368
+ const lines = p.text.split(/\r?\n/);
369
+ const covered = new Set();
370
+ for (const t of tasks.filter((x) => x.path === p.path && x.testException !== undefined)) {
371
+ const fieldLines = t.testException.lines;
372
+ for (const n of fieldLines)
373
+ covered.add(n);
374
+ const entries = exceptionEntries(lines, fieldLines);
375
+ for (const e of entries.length > 0 ? entries : ["no reason recorded"])
376
+ items.push(`- TEST EXCEPTION, task ${t.task}: ${e} (\`${p.path}\`)`);
377
+ }
378
+ lines.forEach((l, i) => {
379
+ if (l.includes(TEST_EXCEPTION) && !covered.has(i + 1))
380
+ items.push(`- \`${p.path}\`: ${l.trim()}`);
381
+ });
382
+ }
383
+ out.push("", "## Risks and Action Items", "", ...(items.length > 0 ? items : ["None"]));
384
+ out.push("", "## Recommended Next Step", "", "```text", nextStep, "```");
385
+ if (step.or !== undefined && !notReproduced)
386
+ out.push("", `Or, to address the reasons first: \`${withRef(step.or)}\``);
387
+ return { verdict, failures: fails.length, reasons, nextStep, markdown: `${out.join("\n")}\n` };
388
+ }