@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -0,0 +1,177 @@
1
+ import {
2
+ parseFindings,
3
+ mergeFindings,
4
+ normalizeLocation,
5
+ lowDeferralKey,
6
+ type Finding,
7
+ } from "./challenge.js";
8
+ import type { PlanTaskBlock } from "./plan-blocks.js";
9
+ import type { SummaryInput } from "./summary.js";
10
+ import { parseDecisionItems } from "./decisions.js";
11
+
12
+ type Row = Record<string, unknown>;
13
+ type Task = PlanTaskBlock & { path: string };
14
+
15
+ const artifacts = (row: Row): string[] =>
16
+ Array.isArray(row.artifacts)
17
+ ? row.artifacts.filter((p): p is string => typeof p === "string")
18
+ : [];
19
+
20
+ /** The latest assessment must cover this task, after its finding and last execution. */
21
+ export function taskVerified(input: SummaryInput, task: Task, after: number): boolean {
22
+ const assessments = input.rows
23
+ .map((row, index) => ({ row, index }))
24
+ .filter(
25
+ ({ row }) =>
26
+ row.type === "step-done" && row.step === "build-plan-verify" && row.group === task.group,
27
+ );
28
+ const latest = assessments.at(-1);
29
+ if (
30
+ !task.done ||
31
+ latest === undefined ||
32
+ latest.index <= after ||
33
+ latest.row.verdict !== "PASS" ||
34
+ (latest.row.failures !== undefined && latest.row.failures !== 0)
35
+ )
36
+ return false;
37
+ if (
38
+ input.rows
39
+ .slice(latest.index + 1)
40
+ .some(
41
+ (r) =>
42
+ r.type === "step-done" &&
43
+ r.group === task.group &&
44
+ (r.step === "build-plan-tasks" || r.step === "build-plan-gaps-remediate"),
45
+ )
46
+ )
47
+ return false;
48
+ return artifacts(latest.row).some((p) => {
49
+ const header = (input.read(p) ?? "").split("<!-- verdict:end -->")[0]!;
50
+ const numbers =
51
+ /^Tasks:[ \t]*(.*)$/m
52
+ .exec(header)?.[1]
53
+ ?.split(",")
54
+ .map((n) => Number(n.trim())) ?? [];
55
+ return /^Verdict:[ \t]*PASS[ \t]*$/m.test(header) && numbers.includes(task.task);
56
+ });
57
+ }
58
+
59
+ export interface ChallengeResolution {
60
+ resolved: string[];
61
+ failures: string[];
62
+ concerns: string[];
63
+ }
64
+
65
+ /** Unreadable or incomplete evidence leaves the recorded assessment unresolved. */
66
+ export function challengeResolution(
67
+ input: SummaryInput,
68
+ row: Row,
69
+ index: number,
70
+ tasks: Task[],
71
+ ): ChallengeResolution | undefined {
72
+ const paths = artifacts(row);
73
+ const round = row.round;
74
+ if (paths.length === 0 || typeof round !== "number") return undefined;
75
+ const later = input.rows
76
+ .slice(index + 1)
77
+ .filter((r) => r.type === "step-done" && r.step === "build-challenge");
78
+ if (
79
+ row.challengeFindings === undefined &&
80
+ later.some((r) => artifacts(r).some((p) => paths.includes(p)))
81
+ ) {
82
+ const latest = later.at(-1)!;
83
+ const roundTasks = tasks.filter((t) =>
84
+ (/\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? []).includes(
85
+ round,
86
+ ),
87
+ );
88
+ if (
89
+ latest.verdict !== "PASS" ||
90
+ !paths.every((p) => artifacts(latest).includes(p)) ||
91
+ roundTasks.length === 0 ||
92
+ !roundTasks.every((t) => taskVerified(input, t, index))
93
+ )
94
+ return undefined;
95
+ return {
96
+ resolved: [
97
+ `build-challenge round ${round}, resolved by build-plan-verify and the later passing challenge covering the same reports`,
98
+ ],
99
+ failures: [],
100
+ concerns: [],
101
+ };
102
+ }
103
+ let findings: Pick<Finding, "severity" | "location" | "title">[];
104
+ if (row.challengeFindings !== undefined) {
105
+ const snapshot = row.challengeFindings;
106
+ if (
107
+ !Array.isArray(snapshot) ||
108
+ !snapshot.every(
109
+ (f): f is Pick<Finding, "severity" | "location" | "title"> =>
110
+ f !== null &&
111
+ typeof f === "object" &&
112
+ ["CRITICAL", "HIGH", "MEDIUM", "LOW"].includes(String(f.severity)) &&
113
+ typeof f.location === "string" &&
114
+ typeof f.title === "string",
115
+ )
116
+ )
117
+ return undefined;
118
+ findings = snapshot;
119
+ } else {
120
+ const reports = paths.map((p) => input.read(p));
121
+ if (reports.some((t) => t === null)) return undefined;
122
+ try {
123
+ findings = mergeFindings(
124
+ reports.map((t, i) => parseFindings(t!, paths[i]!, input.root ?? process.cwd())),
125
+ new Set(),
126
+ ).findings;
127
+ } catch (error) {
128
+ return {
129
+ resolved: [],
130
+ failures: row.verdict === "FAIL" ? [`build-challenge FAIL: ${String(error)}`] : [],
131
+ concerns: row.verdict === "CONCERNS" ? [`build-challenge CONCERNS: ${String(error)}`] : [],
132
+ };
133
+ }
134
+ }
135
+ if (findings.length === 0) return undefined;
136
+ const result: ChallengeResolution = { resolved: [], failures: [], concerns: [] };
137
+ for (const f of findings) {
138
+ const matches = tasks.filter((t) => {
139
+ const location = /\*\*Location:\*\*\s*([^\n·]+)/.exec(t.text)?.[1];
140
+ const severity = /\*\*Severity:\*\*\s*(\w+)/.exec(t.text)?.[1];
141
+ const rounds = /\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? [];
142
+ return (
143
+ location !== undefined &&
144
+ normalizeLocation(location, input.root ?? process.cwd()) === f.location &&
145
+ severity === f.severity &&
146
+ rounds.includes(round)
147
+ );
148
+ });
149
+ const label = `build-challenge round ${round}: ${f.severity} ${f.location}`;
150
+ const accepted = input.decisionFiles.some((p) =>
151
+ parseDecisionItems(input.read(p) ?? "").some(
152
+ (item) =>
153
+ /^Accept\b/.test(item.decision ?? "") &&
154
+ [...item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)].some(
155
+ (m) => normalizeLocation(m[0], input.root ?? process.cwd()) === f.location,
156
+ ),
157
+ ),
158
+ );
159
+ const closed =
160
+ f.severity === "LOW" &&
161
+ input.deferrals.some(
162
+ (d) =>
163
+ d.status === "CLOSED" &&
164
+ d.key === lowDeferralKey(input.fid, f.location) &&
165
+ typeof d.source === "string" &&
166
+ normalizeLocation(d.source, input.root ?? process.cwd()) === f.location,
167
+ );
168
+ if (accepted) result.concerns.push(`${label}, accepted limitation`);
169
+ else if (closed) result.resolved.push(`${label}, resolved by closed deferral`);
170
+ else if (matches.length === 1 && taskVerified(input, matches[0]!, index))
171
+ result.resolved.push(
172
+ `${label}, resolved by build-plan-verify (group ${matches[0]!.group}, task ${matches[0]!.task})`,
173
+ );
174
+ else (f.severity === "CRITICAL" ? result.failures : result.concerns).push(label);
175
+ }
176
+ return result;
177
+ }
@@ -3,10 +3,11 @@
3
3
  // its log files, the plan and the ledger rows it added. Pure: the caller reads the
4
4
  // disk and passes `read` for the log files.
5
5
 
6
- import type { Workstream } from "./workstreams.js";
6
+ import { coversList, type Plan, type Workstream } from "./plans.js";
7
7
  import { issueIdOf, type FidTracker } from "./fids.js";
8
8
  import { parseDecisionItems } from "./decisions.js";
9
9
  import { parsePlanBlocks } from "./plan-blocks.js";
10
+ import { challengeResolution, taskVerified } from "./summary-findings.js";
10
11
 
11
12
  export const SUMMARY_WORKFLOWS = ["plan", "design", "build", "debug", "ship"] as const;
12
13
  export type SummaryWorkflow = (typeof SUMMARY_WORKFLOWS)[number];
@@ -59,15 +60,14 @@ export function refOf(fid: string, tracker: FidTracker = "any"): string | undefi
59
60
  }
60
61
 
61
62
  /**
62
- * A critique step whose FAIL a later step of the same workflow answers; the run
63
- * carried on past it. A build challenge is answered by its fix tasks running
64
- * (`build-plan-execute`) or by a Decision Pause (`build-decision`).
63
+ * Review updates cover their review's findings. Group verification covers failed
64
+ * execution, but does not cover a remediation agent's separate warnings or flakes.
65
65
  */
66
- const ANSWERED_BY: Readonly<Record<string, readonly string[]>> = {
66
+ const RESOLVED_BY: Readonly<Record<string, readonly string[]>> = {
67
67
  "plan/plan-review": ["plan-apply-review"],
68
68
  "design/design-review": ["design-apply-review"],
69
- "design/design-spike": ["design-apply-review"],
70
- "build/build-challenge": ["build-plan-execute", "build-decision"],
69
+ "build/build-plan-tasks": ["build-plan-verify"],
70
+ "build/build-plan-gaps-remediate": ["build-plan-verify"],
71
71
  };
72
72
 
73
73
  const RUN_TESTS = new Set(["build-run-tests", "debug-run-tests"]);
@@ -77,6 +77,8 @@ const TEST_EXCEPTION = "**TEST EXCEPTION:**";
77
77
  type Row = Record<string, unknown>;
78
78
 
79
79
  export interface SummaryInput {
80
+ /** Checkout root for normalising finding locations. */
81
+ root?: string;
80
82
  workflow: SummaryWorkflow;
81
83
  fid: string;
82
84
  /** `refOf(fid)`; undefined = no tracker reference. */
@@ -85,18 +87,22 @@ export interface SummaryInput {
85
87
  rows: Row[];
86
88
  /** The plan files the run worked from, repo-relative path and text. */
87
89
  plans: Array<{ path: string; text: string }>;
88
- /** Deferral rows this workflow added since the run started. */
90
+ /** Current deferrals whose keys this workflow touched since the run started, including closed ones. */
89
91
  deferrals: Row[];
90
- /** Distinct deferral keys this workflow added since the run started. */
92
+ /** Number of those distinct keys still open. */
91
93
  deferralsAdded: number;
92
94
  /** build and ship: every `build-decision-*.md` in the log folder, repo-relative. */
93
95
  decisionFiles: string[];
94
96
  /** A repo-relative file's text, or null when it is missing. */
95
97
  read: (rel: string) => string | null;
96
- /** design: the workstreams `workstreams parse` reads from the organised design. */
98
+ /** design: the workstreams `plans parse` reads from the organised design. */
97
99
  workstreams?: Workstream[];
100
+ /** design: the plans `plans parse` reads from the organised design. */
101
+ suggestedPlans?: Plan[];
98
102
  /** design: the organised design's text; its `## Risks & Open Questions` becomes `## Open Questions`. */
99
103
  organised?: string;
104
+ /** build: `false` = the run held (no push, no PR); absent or `true` = it publishes. */
105
+ publish?: boolean;
100
106
  /** ship: the PR's size; absent when `gh` could not read it. */
101
107
  pr?: { number: number; additions: number; deletions: number; changedFiles: number };
102
108
  }
@@ -119,16 +125,22 @@ interface StepGroup {
119
125
  const str = (v: unknown) => (typeof v === "string" ? v : undefined);
120
126
  const artifactsOf = (r: Row) =>
121
127
  Array.isArray(r.artifacts) ? r.artifacts.filter((a): a is string => typeof a === "string") : [];
128
+ /** A step row's task group (`group`, or debug's `subPlan`); undefined when it has none. */
129
+ const taskGroupOf = (r: Row) => {
130
+ const taskGroup = r.group ?? r.subPlan;
131
+ return typeof taskGroup === "number" ? taskGroup : undefined;
132
+ };
122
133
 
123
- /** The run's step rows grouped per step (and plan group), in first-seen order. */
134
+ /** The run's step rows grouped per step (and task group), in first-seen order. */
124
135
  function stepGroups(rows: Row[]): StepGroup[] {
125
136
  const groups = new Map<string, StepGroup>();
126
137
  rows.forEach((row, index) => {
127
138
  const step = str(row.step);
128
139
  if (row.type !== "step-done" || step === undefined) return;
129
- const planGroup = row.group ?? row.subPlan;
130
- const sub = typeof planGroup === "number" ? planGroup : undefined;
131
- const key = sub === undefined ? step : `${step}#${sub}`;
140
+ const sub = taskGroupOf(row);
141
+ const scope = sub === undefined ? step : `${step}#${sub}`;
142
+ const key =
143
+ step === "build-challenge" && typeof row.round === "number" ? `${scope}@${row.round}` : scope;
132
144
  const g = groups.get(key) ?? {
133
145
  label: sub === undefined ? step : `${step} (group ${sub})`,
134
146
  key,
@@ -158,11 +170,34 @@ function planSection(text: string, title: RegExp): string | undefined {
158
170
  return out.join("\n").trim();
159
171
  }
160
172
 
173
+ /**
174
+ * A TEST EXCEPTION field's entries from its 1-based plan `fieldLines` (`plan-blocks.ts`):
175
+ * the label line's inline value and each sub-bullet, continuation lines joined to the entry above.
176
+ */
177
+ function exceptionEntries(lines: string[], fieldLines: number[]): string[] {
178
+ const out: string[] = [];
179
+ for (const n of fieldLines) {
180
+ const raw = lines[n - 1] ?? "";
181
+ const label = raw.indexOf(TEST_EXCEPTION);
182
+ const bullet = /^\s*- (.*)$/.exec(raw);
183
+ const text = (
184
+ label >= 0 ? raw.slice(label + TEST_EXCEPTION.length) : (bullet?.[1] ?? raw)
185
+ ).trim();
186
+ if (text === "") continue;
187
+ if (label < 0 && bullet === null && out.length > 0) out[out.length - 1] += ` ${text}`;
188
+ else out.push(text);
189
+ }
190
+ return out;
191
+ }
192
+
161
193
  export function buildSummary(input: SummaryInput): Summary {
162
194
  const { workflow } = input;
163
195
  const groups = stepGroups(input.rows);
164
196
  const fails: string[] = [];
165
197
  const concerns: string[] = [];
198
+ const resolved = new Map<string, string>();
199
+ const resolvedFindings: string[] = [];
200
+ const reassessed: string[] = [];
166
201
  const read = (rel: string) => input.read(rel);
167
202
 
168
203
  // Debug: a reproduce step that could not reproduce is a re-run, not a failure.
@@ -186,35 +221,91 @@ export function buildSummary(input: SummaryInput): Summary {
186
221
 
187
222
  for (const g of groups) {
188
223
  const { row, index } = lastOf(g);
224
+ if (g.step === `${workflow}-summary`) continue;
189
225
  if (RUN_TESTS.has(g.step)) {
190
226
  if (row.verdict === "FAIL") fails.push(`${g.label} FAIL`);
191
227
  continue;
192
228
  }
193
- if (row.verdict === "CONCERNS") concerns.push(`${g.label} CONCERNS`);
194
- if (row.verdict !== "FAIL") continue;
229
+ if (row.verdict !== "FAIL" && row.verdict !== "CONCERNS") continue;
195
230
  if (g.step === "debug-failure-reproduce" && notReproduced) continue;
196
- const answers = ANSWERED_BY[`${workflow}/${g.step}`] ?? [];
197
- const answeredBy = input.rows.find(
198
- (r, i) => i > index && r.type === "step-done" && answers.includes(String(r.step)),
199
- )?.step;
200
- if (answeredBy !== undefined)
201
- concerns.push(`${g.label} FAIL, answered by ${String(answeredBy)}`);
202
- else fails.push(`${g.label} FAIL`);
231
+ if (workflow === "build" && g.step === "build-challenge") {
232
+ const assessment = challengeResolution(input, row, index, tasks);
233
+ if (assessment !== undefined) {
234
+ fails.push(...assessment.failures);
235
+ concerns.push(...assessment.concerns);
236
+ resolvedFindings.push(...assessment.resolved);
237
+ continue;
238
+ }
239
+ }
240
+ if (
241
+ workflow === "build" &&
242
+ g.step === "build-plan-current" &&
243
+ tasks.length > 0 &&
244
+ tasks.every((t) => taskVerified(input, t, index))
245
+ ) {
246
+ resolved.set(g.key, "build-plan-verify");
247
+ continue;
248
+ }
249
+ const review = g.step === `${workflow}-review`;
250
+ const spike = workflow === "design" && g.step === "design-spike";
251
+ const answers = spike
252
+ ? ["design-apply-review"]
253
+ : review || row.verdict === "FAIL"
254
+ ? (RESOLVED_BY[`${workflow}/${g.step}`] ?? [])
255
+ : [];
256
+ const sub = taskGroupOf(row);
257
+ const answer = groups
258
+ .map(lastOf)
259
+ .find(
260
+ ({ row: r, index: i }) =>
261
+ i > index &&
262
+ answers.includes(String(r.step)) &&
263
+ (r.verdict === "PASS" || (review && r.verdict === "CONCERNS")) &&
264
+ (r.failures === undefined || r.failures === 0) &&
265
+ taskGroupOf(r) === sub &&
266
+ (!review || r.attempt === row.attempt),
267
+ );
268
+ if (answer !== undefined && spike) {
269
+ const reports = artifactsOf(row).map((p) => read(p));
270
+ const unsettled = reports.map((report) =>
271
+ report === null ? undefined : planSection(report, /^## Unsettled\s*$/),
272
+ );
273
+ if (
274
+ unsettled.length > 0 &&
275
+ unsettled.every((section) => section !== undefined && section !== "")
276
+ ) {
277
+ if (unsettled.every((section) => /^None\.?$/i.test(section!)))
278
+ resolved.set(g.key, String(answer.row.step));
279
+ else {
280
+ concerns.push("design-spike: unsettled claims remain");
281
+ reassessed.push(
282
+ "design-spike: design impact addressed by design-apply-review; unsettled claims remain",
283
+ );
284
+ }
285
+ continue;
286
+ }
287
+ }
288
+ if (answer !== undefined && !spike && answer.row.verdict === "CONCERNS")
289
+ reassessed.push(
290
+ `${g.label} ${String(row.verdict)}, remaining findings assessed by ${String(answer.row.step)}`,
291
+ );
292
+ else if (answer !== undefined && !spike) resolved.set(g.key, String(answer.row.step));
293
+ else if (row.verdict === "FAIL") fails.push(`${g.label} FAIL`);
294
+ else concerns.push(`${g.label} CONCERNS`);
203
295
  }
204
296
 
205
297
  // The Decision Pause: accepted items in this run's decision files.
206
298
  const decided = groups
207
299
  .filter((g) => g.step === "build-decision")
208
300
  .flatMap((g) => g.rows.flatMap(({ row }) => artifactsOf(row)));
209
- const acceptLines = decided.flatMap((rel) =>
210
- (read(rel) ?? "")
211
- .split("\n")
212
- .filter((l) => /^Decision:\s*Accept\b/.test(l.trim()))
213
- .map((l) => `${rel}: ${l.trim()}`),
301
+ const acceptItems = decided.flatMap((rel) =>
302
+ parseDecisionItems(read(rel) ?? "")
303
+ .filter((i) => /^Accept\b/.test(i.decision ?? ""))
304
+ .map((i) => ({ assumed: i.assumed, line: `${rel}: Decision: ${i.decision}` })),
214
305
  );
215
306
  // `Accept (assumed)`: taken without the owner (`ask: false` or headless); ship asks to confirm.
216
- const assumed = acceptLines.filter((a) => /Decision:\s*Accept \(assumed\)/.test(a));
217
- const accepted = acceptLines.filter((a) => !assumed.includes(a));
307
+ const assumed = acceptItems.filter((a) => a.assumed).map((a) => a.line);
308
+ const accepted = acceptItems.filter((a) => !a.assumed).map((a) => a.line);
218
309
  if (accepted.length > 0)
219
310
  concerns.push(`${accepted.length} item(s) accepted at the Decision Pause`);
220
311
  if (assumed.length > 0)
@@ -233,7 +324,7 @@ export function buildSummary(input: SummaryInput): Summary {
233
324
  if (unconfirmed.length > 0)
234
325
  concerns.push(`shipped with ${unconfirmed.length} assumed item(s) the owner did not confirm`);
235
326
  if (input.deferralsAdded > 0)
236
- concerns.push(`${input.deferralsAdded} deferral(s) written this run`);
327
+ concerns.push(`${input.deferralsAdded} deferral(s) from this run remain open`);
237
328
 
238
329
  const verdict: SummaryVerdict =
239
330
  fails.length > 0 ? "FAIL" : concerns.length > 0 ? "CONCERNS" : "PASS";
@@ -244,10 +335,9 @@ export function buildSummary(input: SummaryInput): Summary {
244
335
  const withRef = (cmd: string) => (input.ref === undefined ? cmd : `${cmd} ${input.ref}`);
245
336
  let nextStep = step.command === undefined ? (step.line ?? "") : withRef(step.command);
246
337
  if (workflow === "debug" && notReproduced) nextStep = `${withRef("/bkit-debug")} [repro]`;
247
- const streams = input.workstreams ?? [];
248
- if (workflow === "design" && step.command === "/bkit-plan" && streams.length > 1)
249
- nextStep =
250
- "File the Suggested Workstreams issues, then /bkit-plan <first root workstream's new issue>";
338
+ const suggested = input.suggestedPlans ?? [];
339
+ if (workflow === "design" && step.command === "/bkit-plan" && suggested.length > 1)
340
+ nextStep = "File the Suggested Plans issues, then /bkit-plan <first root plan's new issue>";
251
341
 
252
342
  // Sections.
253
343
  const out: string[] = [
@@ -263,7 +353,9 @@ export function buildSummary(input: SummaryInput): Summary {
263
353
  "",
264
354
  ...(reasons.length > 0
265
355
  ? reasons.map((r) => `- ${r}`)
266
- : ["- No failing step, open task, accepted item or new deferral."]),
356
+ : [
357
+ "- No unresolved finding, failing check, open task, accepted limitation or open deferral.",
358
+ ]),
267
359
  ];
268
360
  if (workflow === "build")
269
361
  out.push(
@@ -271,6 +363,9 @@ export function buildSummary(input: SummaryInput): Summary {
271
363
  input.plans.length === 0
272
364
  ? "Plan tasks: no plan file."
273
365
  : `Plan tasks: ${tasks.filter((t) => t.done).length} of ${tasks.length} ticked in ${input.plans.map((p) => `\`${p.path}\``).join(", ")}.`,
366
+ "",
367
+ input.publish === false ? "Publish: held" : "Publish: pr",
368
+ ...(input.publish === false ? ["", "Docs: not synced (ship syncs on landing)"] : []),
274
369
  );
275
370
 
276
371
  out.push(
@@ -290,6 +385,35 @@ export function buildSummary(input: SummaryInput): Summary {
290
385
  );
291
386
  }
292
387
 
388
+ out.push("", "## Resolved Findings", "");
389
+ const resolutions = groups
390
+ .filter((g) => resolved.has(g.key))
391
+ .map(
392
+ (g) => `- ${g.label} ${String(lastOf(g).row.verdict)}, resolved by ${resolved.get(g.key)!}`,
393
+ );
394
+ resolutions.push(...resolvedFindings.map((r) => `- ${r}`));
395
+ out.push(...(resolutions.length > 0 ? resolutions : ["None"]));
396
+ if (reassessed.length > 0)
397
+ out.push("", "## Reassessed Findings", "", ...reassessed.map((r) => `- ${r}`));
398
+ out.push(
399
+ "",
400
+ "## Assessment History",
401
+ "",
402
+ "| Step | Verdict | Attempt | Artifact |",
403
+ "| --- | --- | --- | --- |",
404
+ );
405
+ for (const { g, row } of groups
406
+ .flatMap((g) => g.rows.map(({ row, index }) => ({ g, row, index })))
407
+ .sort((a, b) => a.index - b.index)) {
408
+ out.push(
409
+ `| ${g.label} | ${str(row.verdict) ?? "-"} | ${String(row.attempt ?? "-")} | ${
410
+ artifactsOf(row)
411
+ .map((a) => `\`${a}\``)
412
+ .join(", ") || "-"
413
+ } |`,
414
+ );
415
+ }
416
+
293
417
  if (workflow === "build") {
294
418
  const appended = tasks.filter((t) => SEVERITY.test(t.text));
295
419
  const low = input.deferrals.filter(
@@ -308,7 +432,9 @@ export function buildSummary(input: SummaryInput): Summary {
308
432
  `- Task ${t.task} — ${SEVERITY.exec(t.text)![1]} — ${t.done ? "ticked" : "not ticked"} (\`${t.path}\`)`,
309
433
  );
310
434
  for (const r of low)
311
- out.push(`- LOW, deferred: ${String(r.key ?? "")} — ${String(r.description ?? "")}`);
435
+ out.push(
436
+ `- LOW, ${r.status === "CLOSED" ? "closed" : "deferred"}: ${String(r.key ?? "")} — ${String(r.description ?? "")}`,
437
+ );
312
438
  }
313
439
 
314
440
  if (workflow === "build" || workflow === "debug") {
@@ -336,13 +462,15 @@ export function buildSummary(input: SummaryInput): Summary {
336
462
  }
337
463
 
338
464
  if (workflow === "design") {
339
- out.push("", "## Suggested Workstreams", "");
340
- if (streams.length === 0) out.push("None");
341
- for (const w of streams)
342
- out.push(`### ${w.id}: ${w.name}`, "", `Requires: ${w.requiresText || "None"}`, "");
343
- if (streams.length > 1)
465
+ out.push("", "## Suggested Plans", "");
466
+ if (suggested.length === 0) out.push("None");
467
+ for (const p of suggested)
344
468
  out.push(
345
- "File these as one issue each? Body per .bkit/trackers.md § Issue shapes; file in Requires order.",
469
+ `### ${p.id}: ${p.name}`,
470
+ "",
471
+ `Covers: ${coversList(p, input.workstreams ?? []) || "None"}`,
472
+ `Requires: ${p.requiresText || "None"}`,
473
+ "",
346
474
  );
347
475
  out.push(
348
476
  "",
@@ -374,8 +502,15 @@ export function buildSummary(input: SummaryInput): Summary {
374
502
  // Risks and action items.
375
503
  const items: string[] = [];
376
504
  for (const g of groups) {
505
+ if (resolved.has(g.key)) continue;
377
506
  for (const rel of artifactsOf(lastOf(g).row).filter((a) => a.endsWith("-log.md"))) {
378
- for (const line of (read(rel) ?? "").split("\n").filter((l) => /^BLOCKED\b/.test(l)))
507
+ const dispositions = new Map<string, string>();
508
+ for (const line of (read(rel) ?? "").split("\n")) {
509
+ const entry = /^(BLOCKED|DONE)\s*—\s*((?:task|step|gap)\s+\d+)\b/i.exec(line);
510
+ if (entry !== null) dispositions.set(entry[2]!.toLowerCase(), line);
511
+ else if (/^BLOCKED\b/.test(line)) dispositions.set(line, line);
512
+ }
513
+ for (const line of [...dispositions.values()].filter((l) => /^BLOCKED\b/.test(l)))
379
514
  items.push(`- ${line} (\`${rel}\`)`);
380
515
  }
381
516
  }
@@ -385,8 +520,19 @@ export function buildSummary(input: SummaryInput): Summary {
385
520
  if (!/^Decision:/m.test(read(rel) ?? "")) items.push(`- \`${rel}\`: no decision recorded`);
386
521
  }
387
522
  for (const p of input.plans) {
388
- for (const line of p.text.split("\n").filter((l) => l.includes(TEST_EXCEPTION)))
389
- items.push(`- \`${p.path}\`: ${line.trim()}`);
523
+ const lines = p.text.split(/\r?\n/);
524
+ const covered = new Set<number>();
525
+ for (const t of tasks.filter((x) => x.path === p.path && x.testException !== undefined)) {
526
+ const fieldLines = t.testException!.lines;
527
+ for (const n of fieldLines) covered.add(n);
528
+ const entries = exceptionEntries(lines, fieldLines);
529
+ for (const e of entries.length > 0 ? entries : ["no reason recorded"])
530
+ items.push(`- TEST EXCEPTION, task ${t.task}: ${e} (\`${p.path}\`)`);
531
+ }
532
+ lines.forEach((l, i) => {
533
+ if (l.includes(TEST_EXCEPTION) && !covered.has(i + 1))
534
+ items.push(`- \`${p.path}\`: ${l.trim()}`);
535
+ });
390
536
  }
391
537
  out.push("", "## Risks and Action Items", "", ...(items.length > 0 ? items : ["None"]));
392
538