@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # Repo Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,125 +11,217 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - NEVER delete, prune, push, drop a stash, or rewrite history; name the command, do not run it.
15
- > - NEVER copy a secret or personal-data value into the report; name the file and line.
16
- > - Name the machine. Local leftovers absent on a fresh checkout stay `Not Checked`.
14
+ > - NEVER delete, prune, push, drop a stash or rewrite history. Name the command in the finding, and leave it unrun.
15
+ > - NEVER copy a secret, token, key or personal-data value into the report. Name the file and line instead.
16
+ > - Name the machine.
17
+ > - Local leftovers that a fresh checkout does not have stay `Not Checked`.
17
18
 
18
19
  ## Universal Instructions
19
20
 
20
21
  ### Context & Goals
21
22
 
22
- Every task leaves a worktree, branch, stash, or scratch directory; nothing's job is to remove them. Stale copies look like live work — search and agents read them; a leftover something keeps producing is a bug in that producer. Worse: cleanup by age deletes the only copy of unpushed work. Target: **every leftover judged before anything is called removable**, and a producer that keeps writing leftovers named as the bug.
23
+ Every task leaves a worktree, branch, stash or scratch directory behind, and removing them is nothing's job. Stale copies look like live work, and search and agents read them. A leftover that something keeps producing is a bug in that producer. Worse, cleanup by age deletes the only copy of unpushed work. The goal is that every leftover is judged before anything is called removable, and that a producer which keeps writing leftovers is named as the bug.
23
24
 
24
- **Applies when:** a git checkout. None → one `N/A` row with evidence, never "clean".
25
+ **Applies when:** the project is a git checkout. **If** it is not → write one `N/A` row with its evidence, and never report the surface as "clean".
25
26
 
26
- **Cadence:** monthly. Extra pass after a burst of parallel agent work (worktrees and branches pile up fastest).
27
+ **Cadence:** Run once a month. Run an extra pass after a burst of parallel agent work, because that is when worktrees and branches pile up fastest.
27
28
 
28
29
  **Anchor Standards:**
29
30
 
30
- - OpenSSF Scorecard checks; record the version run.
31
+ - OpenSSF Scorecard checks; record the version.
31
32
  - OpenSSF OSPS Baseline, the version marked current.
32
- - Host branch rulesets (e.g. GitHub rulesets, GitLab protected branches).
33
- - Secret scanning push protection (e.g. GitHub secret scanning, GitLab secret push protection).
34
- - Secret scanners (e.g. gitleaks, TruffleHog); record versions.
35
- - Repository size tool (e.g. git-sizer); record version.
36
- - Workspace dependency-version linter (e.g. sherif, syncpack); record version.
33
+ - Host branch rulesets (e.g., GitHub rulesets, GitLab protected branches).
34
+ - Secret scanning push protection (e.g., GitHub secret scanning, GitLab secret push protection).
35
+ - Secret scanners (e.g., gitleaks, TruffleHog); record versions.
36
+ - Repository size tool (e.g., git-sizer); record version.
37
+ - Workspace dependency-version linter (e.g., sherif, syncpack); record version.
37
38
  - RFC 9116 `security.txt`.
38
39
 
39
40
  ### Scope
40
41
 
41
- - Worktrees, local, and remote branches, stashes, tags, stale pull requests.
42
- - Ignored and untracked leftovers, including scratch directories and files stranded at the root.
43
- - Secret and personal-data scan of leftovers and of history (names only).
44
- - Tracked layout: size, history size, toolchain agreement, accidental publish, attributes, placement, naming, contribution scaffolding.
45
- - Repository posture: scorecard subset, branch protection, security settings, disclosure route, accumulating installations.
42
+ - List worktrees, local and remote branches, stashes, tags and stale pull requests.
43
+ - List ignored and untracked leftovers, including scratch directories and files stranded at the root.
44
+ - Scan leftovers and history for secrets and personal data, and record names only.
45
+ - Check the tracked layout: size, history size, toolchain agreement, accidental publish, attributes, placement, naming and contribution scaffolding.
46
+ - Check the repository posture: a scorecard subset, branch protection, security settings, the disclosure route and accumulating installations.
46
47
 
47
48
  ### Out of Scope
48
49
 
49
50
  <!-- prettier-ignore -->
50
51
  | Excluded item | Why | Where it belongs |
51
52
  | --- | --- | --- |
52
- | Code or config nothing reaches | Dead-code sweep | `bkit-audit-dead-code` |
53
- | Whether a doc is true | Documentation sweep | `bkit-audit-documentation` |
54
- | Dependency-update bot branches | Dependency sweep | `bkit-audit-dependencies` |
55
- | Workflow token permissions, pinned actions, dangerous workflow | Security sweep | `bkit-audit-security` |
56
- | People, 2FA, deploy keys, long-lived tokens | Security sweep | `bkit-audit-security` |
57
- | Actions secrets and variables; settings versus docs | Config sweep | `bkit-audit-config` |
58
- | Personal-data lifecycle | Privacy sweep | `bkit-audit-privacy` |
59
- | Deleting, moving, pruning, or pushing | Audit reports only | Plan from this report |
53
+ | Code or config nothing reaches | The dead-code sweep owns it | `bkit-audit-dead-code` |
54
+ | Whether a doc is true | The documentation sweep owns it | `bkit-audit-documentation` |
55
+ | Dependency-update bot branches | The dependency sweep owns them | `bkit-audit-dependencies` |
56
+ | Workflow token permissions, pinned actions, dangerous workflow | The security sweep owns them | `bkit-audit-security` |
57
+ | People, 2FA, deploy keys, long-lived tokens | The security sweep owns them | `bkit-audit-security` |
58
+ | Actions secrets and variables; settings versus docs | The config sweep owns them | `bkit-audit-config` |
59
+ | Personal-data lifecycle | The privacy sweep owns it | `bkit-audit-privacy` |
60
+ | Deleting, moving, pruning, or pushing | The audit only reports | A plan made from this report |
60
61
 
61
62
  ### Verdicts
62
63
 
63
- - **REMOVE:** provably safe. Merged by ancestry, patch-equivalent on the integration branch (`git cherry` shows only `-`), its pull request merged, or a regenerable artefact (build output, cache, coverage, test results).
64
- - **RESCUE:** holds work that exists nowhere else (unpushed commits, uncommitted worktree edits, a stash whose changes are on no branch). Name what it holds and who would know. Pushing it, or dropping it on purpose, is the next step. At least `HIGH`.
65
- - **MOVE:** kept, but in the wrong place or under a misleading name.
66
- - **KEEP:** in use. Say what uses it.
67
- - **ASK:** cannot tell from the evidence. Name who would know.
68
- - **OTHER:** fits none. Say why. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
64
+ - **REMOVE:** it is provably safe to remove: merged by ancestry, patch-equivalent on the integration branch (`git cherry` shows only `-`), its pull request merged, or a regenerable artefact (build output, cache, coverage, test results).
65
+ - **RESCUE:** it holds work that exists nowhere else (unpushed commits, uncommitted worktree edits, a stash whose changes are on no branch). Name what it holds and who would know. The next step is to push it, or to drop it on purpose. It is at least `HIGH`.
66
+ - **MOVE:** it is kept, but it sits in the wrong place or has a misleading name.
67
+ - **KEEP:** it is in use. Say what uses it.
68
+ - **ASK:** the evidence cannot tell. Name who would know.
69
+ - **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
69
70
 
70
- **Two traps.** Squash merge stays ahead of the integration branch by ancestry: check the pull request and `git cherry`, never `git branch --merged` alone. A worktree whose branch is fully merged can still hold uncommitted edits: `git status --porcelain` before REMOVE.
71
+ **Two traps:** A squash merge stays ahead of the integration branch by ancestry, so check the pull request and `git cherry`, never `git branch --merged` alone. A worktree whose branch is fully merged can still hold uncommitted edits, so run `git status --porcelain` before REMOVE.
71
72
 
72
73
  ### Pre-Flight / Dependencies
73
74
 
74
75
  #### Core
75
76
 
76
- - [ ] **Permissions:** blocked calls recorded
77
- - [ ] **Git:** Steps 2-7, 9 — local checkout, worktrees, branches, stashes. Fallback: none; no checkout → `N/A` and STOP.
78
- - [ ] **Host API:** Steps 4, 8 — read-only, e.g. `gh api`. Fallback: local git only; remote branches, pull requests, and settings `Not Checked`.
79
- - [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
77
+ - [ ] **Permissions:** every blocked call is recorded.
78
+ - [ ] **Git:** Steps 2-7, 9 — the local checkout, worktrees, branches and stashes. Fallback: there is none. **If** there is no checkout → write `N/A`, then **STOP**.
79
+ - [ ] **Host API:** Steps 4, 8 — read-only host reads (e.g., `gh api`). Fallback: use local git only, and mark remote branches, pull requests and settings `Not Checked`.
80
+ - [ ] **Web:** Step 10 — fetch the anchor standards. Fallback: record the versions as unread.
80
81
 
81
82
  #### Conditional
82
83
 
83
- - [ ] **Secret Scanners:** Leftovers or history → Steps 6-7 — e.g. gitleaks, TruffleHog. Fallback: pattern search; verified-credential check `Not Checked`. Reports outside the repo.
84
- - [ ] **Repo Sizer:** History size → Step 7 — e.g. git-sizer. Fallback: `git rev-list` blob sizes.
85
- - [ ] **Dependency Version Linter:** Workspaces → Step 7 — e.g. sherif, syncpack. Fallback: diff manifests by reading.
86
- - [ ] **Scorecard:** Host exposes one → Step 8 — e.g. OpenSSF Scorecard, read-only token. Fallback: settings API only; scores `Not Checked`.
84
+ - [ ] **Secret Scanners:** **If** there are leftovers or history → Steps 6-7 — secret scans (e.g., gitleaks, TruffleHog). Fallback: pattern search, and mark the verified-credential check `Not Checked`. Write the reports outside the repo.
85
+ - [ ] **Repo Sizer:** **If** history size is measured → Step 7 — history size (e.g., git-sizer). Fallback: read blob sizes with `git rev-list`.
86
+ - [ ] **Dependency Version Linter:** **If** the repo has workspaces → Step 7 — version drift across workspaces (e.g., sherif, syncpack). Fallback: diff the manifests by reading them.
87
+ - [ ] **Scorecard:** **If** the host exposes one → Step 8 — check scores (e.g., OpenSSF Scorecard, with a read-only token). Fallback: use the settings API only, and mark the scores `Not Checked`.
87
88
 
88
89
  ### 🔒 Gate 1: Prerequisites Check
89
90
 
90
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
91
- - [ ] **Gate 1 — Verified:** All Core items checked. All applicable Conditional items checked.
91
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
92
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
92
93
 
93
94
  ### Probe Steps
94
95
 
95
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
96
- - [ ] **Step 2 — Checkout:** Name machine and checkout. Worktrees, stashes, scratch directories are local — fresh cloud checkout sees none; say so, not clean. Remote branches and pull requests are shared; every run checks those. **Done when:** machine, checkout, and which surfaces are local-only in `Checked`.
97
- - [ ] **Step 3 — Worktrees:** `git worktree list --porcelain`. Per worktree: branch, ahead/behind integration branch, `git cherry`, pull-request state, uncommitted changes (`git status --porcelain`), last commit date, size (`du -sh`). Locked or files modified in the last day → KEEP or ASK, never REMOVE (agent may still be running). Also `git worktree prune --dry-run` for entries whose directory is gone. Never prune for real. **Done when:** `Worktrees` row per entry with verdict; totals in `Totals`.
98
- - [ ] **Step 4 — Branches:** Local: merged by ancestry, merged by squash (pull request merged, or `git cherry` all `-`), upstream gone, agent-prefix branches with no worktree. Remote: branches other than integration, production, dependency-update bot's, with pull-request state. Record delete-on-merge; when off, merged pull request leaves its branch. Unmerged with no pull request: every commit is RESCUE until shown otherwise. Open pull requests with no activity for 30 days, and old drafts. Tags no release or deploy uses. **Done when:** `Branches` row per item with verdict; counts in `Totals`.
99
- - [ ] **Step 5 — Stashes:** `git stash list` with dates, then `git stash show --stat` for each. Check whether changes already landed on integration branch. Stashes a commit hook creates when it fails: usually commit was retried — verify before REMOVE. **Done when:** `Stashes` row per stash with verdict.
100
- - [ ] **Step 6 — Leftovers:** Untracked (`git status --porcelain`) and ignored (`git ls-files --others --ignored --exclude-standard --directory`), each sized. Sort: regenerable (dependencies, task cache, coverage, test results, native build folders, tool caches) — REMOVE is safe, report the size; hand-made (notes, plans, backups, logs, scripts in the scratch directory) — group by age and type; open issue or plan references → KEEP; produced and not cleaned up — leftover REMOVE, producer is finding; stranded at root — find writer; tool defaulting to root → point elsewhere. Ignore file: rules matching nothing; leftovers untracked because no rule covers them. Scan secrets and personal data before any MOVE or REMOVE on scratch, root, or plan logs; scanner reports outside repo. Personal-data hits are candidates: test fixtures carry fake addresses. A real hit in a tracked file is not fixed by removing the file — it stays in history. Name the file and line, never the value. Hooks: hooks path resolves at the hook directory, each hook executable, and the install script installs them. A checkout where hooks silently do not run looks clean here while skipping every pre-commit control. **Done when:** `Leftovers` grouped with verdicts; scan result named; sizes in `Totals`.
101
- - [ ] **Step 7 — Layout:** Read where tracked files belong; find misfits. Size: largest blobs at `HEAD`. Committed generated output/logs → MOVE or REMOVE candidates. Record pack size as series. History size: deleted file still grows clones — repository sizer or blob sizes across all refs. Images/logs → recommend large-file storage or ignore; history rewrite owner's call (ASK). Secrets in history: scan all refs; list every sensitive file ever added (example env files expected). Verified live credential → `CRITICAL`: rotation first (rewrite does not reach existing clones). Name file and commit, never value. Toolchain agreement: runtime pin, engine field, package-manager field, CI setup, host build image, native build config; workspace dependency-version linter for cross-workspace drift or catalog bypass. Docs-versus-files → documentation audit; this step files versus each other. Accidental publish: every workspace package not meant for a registry is marked unpublishable (e.g. npm `private: true`, Cargo `publish = false`), and the root states the licence position. Attributes: end-of-line, generated-file linguist marks so review diffs collapse them, binary marks on images, and an editor config that agrees with the formatter. Placement: root files belonging to app/package, finished one-off scripts, drafts beside final doc, unlinked archive folders, near-empty packages. Naming: folders/files breaking neighbour conventions. Contribution scaffolding: owners file, pull-request and issue templates, contributing note — present and true; whether team needs them → owner (ASK). Template describing unfollowed process → MOVE or REMOVE. Owners file: propose paths that weaken a gate when edited → required human review; once exists, host owners-errors API must return none. Unimported file → dead-code audit; misplaced-but-wrong doc → documentation audit. **Done when:** `Layout` rows; pack size and largest history blobs in `Totals`.
102
- - [ ] **Step 8 — Posture:** Config audit asks settings vs docs; this step asks vs anchor standards. Read that audit's latest report first; do not duplicate findings. Shared settings: every run checks (local or cloud). Scorecard: each check's score as series. Keep binary artifacts, branch protection, code review, dependency-update tool, security policy here; token permissions, pinned dependencies, dangerous workflow → `bkit-audit-security`. Branch protection (integration, production): pull request required, required check required, force-push and deletion blocked, squash-only or linear history, bypass list — compare with production-merge-requires-PR rule. Security settings: secret scanning and push protection on; who may bypass push protection. Private repo: push protection may need paid secret-protection plan — say so if plan excludes it. Push protection blocks at server (hook bypass does not reach). Also dependency alerts, private vulnerability reporting, default automation token read-only, automation creating/approving pull requests off. Disclosure: security policy or private vulnerability reporting, and `/.well-known/security.txt` on production web origin with RFC contact/expiry fields and expiry ahead. People, 2FA, deploy keys, long-lived tokens → security audit; automation secrets/variables → config audit. Read their latest reports; confirm 2FA enforcement recorded. List accumulators like branches: installed apps and permissions, webhooks, environments. App over-scoped or webhook to unused service → REMOVE or ASK. **Done when:** `Posture` holds each setting met / finding / not applicable; scores in `Totals`.
103
- - [ ] **Step 9 — Verify:** Git state changes hourly. Record when each check ran; re-check every RESCUE and REMOVE at end. No finding without re-checkable evidence: command and output, or `file:line`. Destinations (name; do not act; the audit agent writes `docs/failures.jsonl` rows): REMOVE → exact command next step would run, batched for one review; RESCUE → what it holds, who would know, decision (push and open pull request, or drop on purpose); MOVE → move and every reference to update; ASK → who would know and question; OTHER → why no verdict fits; leftover something keeps producing → `docs/failures.jsonl` row against producer; missing/stale ignore rule → line to add or remove; code or config nothing reaches → `bkit-audit-dead-code`; a doc that is wrong, not misplaced → `bkit-audit-documentation`; dependency-bot branch → `bkit-audit-dependencies`; secret in history, log, or leftover → `bkit-audit-security`, rotation first, file and commit only; personal data in log or leftover → `bkit-audit-privacy`; repository setting below standard → setting to change for owner, doc drift → `bkit-audit-config`; workflow-level scorecard failure → `bkit-audit-security`; toolchain versions disagree → file to change; host setting → `bkit-audit-config`; dependency versions → `bkit-audit-dependencies`. **Done when:** every RESCUE and REMOVE re-checked, with time, verdict, and destination.
104
- - [ ] **Step 10 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per Scorecard check and per baseline control in sets this audit touches (e.g. OSPS-AC, OSPS-BR-07, OSPS-GV, OSPS-LE, OSPS-VM) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
105
- - [ ] **Step 11 — Anything Else:** (a) Everything changed since previous report's commit touching the repository itself (new top-level files and folders, workspaces, ignore, and attribute files, hooks, branch, and ruleset settings, host apps, webhooks, environments, anything new that writes to the scratch directory or the root) → one-line verdict each. (b) Bounded ~30 min pass: what a senior platform engineer flags that no step asks; read what happened since previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
96
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
97
+ - [ ] **Step 2 — Checkout:** Name the machine and the checkout. Worktrees, stashes and scratch directories are local, so a fresh cloud checkout sees none of them. Say so, rather than calling them clean. Remote branches and pull requests are shared, and every run checks them. **Done when:** `Checked` holds the machine, the checkout, and which surfaces are local-only.
98
+ - [ ] **Step 3 — Worktrees:** Run `git worktree list --porcelain`. For each worktree, record its branch, ahead/behind the integration branch, `git cherry`, pull-request state, uncommitted changes (`git status --porcelain`), last commit date and size (`du -sh`). **If** a worktree is locked, **or** has files modified in the last day → give it KEEP or ASK, never REMOVE, because an agent may still be running. Also run `git worktree prune --dry-run` for entries whose directory is gone. Never prune for real. **Done when:** `Worktrees` has one row per entry with its verdict, and the totals are in `Totals`.
99
+ - [ ] **Step 4 — Branches:** For local branches, list those merged by ancestry, those merged by squash (pull request merged, or `git cherry` all `-`), those whose upstream is gone, and agent-prefix branches with no worktree. For remote branches, list every branch other than integration, production and the dependency-update bot's, with its pull-request state. Record whether delete-on-merge is on. When it is off, a merged pull request leaves its branch behind. For an unmerged branch with no pull request, every commit is RESCUE until shown otherwise. List open pull requests with no activity for 30 days, and old drafts. List tags that no release or deploy uses. **Done when:** `Branches` has one row per item with its verdict, and the counts are in `Totals`.
100
+ - [ ] **Step 5 — Stashes:** Run `git stash list` with dates, then `git stash show --stat` for each stash. Check whether the changes already landed on the integration branch. For a stash that a commit hook created when it failed, the commit was usually retried, so verify before REMOVE. **Done when:** `Stashes` has one row per stash with its verdict.
101
+ - [ ] **Step 6 — Leftovers:** List untracked files (`git status --porcelain`) and ignored files (`git ls-files --others --ignored --exclude-standard --directory`), each with its size.
102
+ - **If** an open issue or plan references a leftover → KEEP, whatever its group.
103
+ - Sort the rest into groups:
104
+ - Regenerable files (dependencies, task cache, coverage, test results, native build folders, tool caches) are safe to REMOVE, so report their size.
105
+ - Group hand-made files (notes, plans, backups, logs, scripts in the scratch directory) by age and type.
106
+ - For a file something produced and did not clean up, the leftover is REMOVE, and the producer is the finding.
107
+ - For a file stranded at the root, find the writer.
108
+ - **If** a tool defaults to the root → point it elsewhere.
109
+ - In the ignore file, find rules that match nothing, and leftovers that are untracked because no rule covers them.
110
+ - Scan for secrets and personal data before any MOVE or REMOVE on the scratch directory, the root or plan logs, and write the scanner reports outside the repo. Personal-data hits are only candidates, because test fixtures carry fake addresses.
111
+ - A real hit in a tracked file is not fixed by removing the file, because it stays in history. Name the file and line, NEVER the value.
112
+ - For hooks, check that the hooks path resolves to the hook directory, that each hook is executable, and that the install script installs them. A checkout where hooks silently do not run looks clean here while it skips every pre-commit control.
113
+
114
+ **Done when:** `Leftovers` is grouped with verdicts, the scan result is named, and the sizes are in `Totals`.
115
+
116
+ - [ ] **Step 7 — Layout:** Read where tracked files belong, and find the misfits.
117
+ - Size:
118
+ - Find the largest blobs at `HEAD`. Committed generated output and logs are MOVE or REMOVE candidates.
119
+ - Record the pack size as a series.
120
+ - History size:
121
+ - A deleted file still grows clones, so measure it with the repository sizer, or with blob sizes across all refs.
122
+ - **If** images or logs are the cause → recommend large-file storage or an ignore rule.
123
+ - A history rewrite is the owner's call (ASK).
124
+ - Secrets in history:
125
+ - Scan all refs, and list every sensitive file ever added (example env files are expected).
126
+ - A verified live credential is `CRITICAL`, and rotation comes first, because a rewrite does not reach existing clones.
127
+ - Name the file and commit, NEVER the value.
128
+ - Toolchain agreement:
129
+ - Compare the runtime pin, engine field, package-manager field, CI setup, host build image and native build config.
130
+ - Run the workspace dependency-version linter for drift across workspaces or a catalog bypass.
131
+ - Docs against files goes to the documentation audit, and this step compares files with each other.
132
+ - Accidental publish: check that every workspace package not meant for a registry is marked unpublishable (e.g., npm `private: true`, Cargo `publish = false`), and that the root states the licence position.
133
+ - Attributes: check end-of-line settings, linguist marks on generated files so review diffs collapse them, binary marks on images, and an editor config that agrees with the formatter.
134
+ - Placement: find root files that belong to an app or package, finished one-off scripts, drafts beside the final doc, unlinked archive folders and near-empty packages.
135
+ - Naming: find folders and files that break their neighbours' conventions.
136
+ - Contribution scaffolding:
137
+ - Check that the owners file, the pull-request and issue templates and the contributing note are present and true.
138
+ - Whether the team needs them is the owner's call (ASK).
139
+ - A template that describes a process nobody follows is MOVE or REMOVE.
140
+ - Owners file:
141
+ - Propose that paths which weaken a gate when edited require human review.
142
+ - Once the file exists, the host's owners-errors API must return none.
143
+ - An unimported file goes to the dead-code audit, and a doc that is wrong rather than misplaced goes to the documentation audit.
144
+
145
+ **Done when:** `Layout` has its rows, and the pack size and largest history blobs are in `Totals`.
146
+
147
+ - [ ] **Step 8 — Posture:** The config audit compares settings with the docs, and this step compares them with the anchor standards.
148
+ - Read that audit's latest report first, and do not duplicate its findings.
149
+ - Every run checks shared settings, local or cloud.
150
+ - Scorecard:
151
+ - Record each check's score as a series.
152
+ - Keep binary artifacts, branch protection, code review, dependency-update tool and security policy here.
153
+ - Token permissions, pinned dependencies and dangerous workflow go to `bkit-audit-security`.
154
+ - Branch protection (integration, production):
155
+ - Check that a pull request is required, that a required check is required, that force-push and deletion are blocked, and that merges are squash-only or history is linear.
156
+ - Read the bypass list, and compare it with the production-merge-requires-PR rule.
157
+ - Security settings:
158
+ - Check that secret scanning and push protection are on, and who may bypass push protection. Push protection blocks at the server, where a hook bypass does not reach.
159
+ - On a private repo, push protection may need a paid secret-protection plan.
160
+ - **If** the plan excludes it → say so.
161
+ - Also check dependency alerts, private vulnerability reporting, a read-only default automation token, and that automation creating or approving pull requests is off.
162
+ - Disclosure: check for a security policy or private vulnerability reporting, and for `/.well-known/security.txt` on the production web origin, with the RFC contact and expiry fields and the expiry still ahead.
163
+ - People, 2FA, deploy keys and long-lived tokens go to the security audit, and automation secrets and variables go to the config audit.
164
+ - Read their latest reports, and confirm that 2FA enforcement is recorded.
165
+ - List accumulators the way branches are listed: installed apps and their permissions, webhooks and environments. An over-scoped app, or a webhook to an unused service, is REMOVE or ASK.
166
+
167
+ **Done when:** `Posture` marks each setting met, finding or not applicable, and the scores are in `Totals`.
168
+
169
+ - [ ] **Step 9 — Verify:** Git state changes hourly.
170
+ - Record when each check ran, and re-check every RESCUE and REMOVE at the end.
171
+ - Give no finding without evidence someone can check again: the command and its output, or `file:line`.
172
+ - Name each destination, and do not act on it. The one exception is the `docs/failures.jsonl` rows, which this run writes.
173
+ - Destinations:
174
+ - REMOVE → the exact command the next step would run, batched for one review.
175
+ - RESCUE → what it holds, who would know, and the decision: push and open a pull request, or drop it on purpose.
176
+ - MOVE → the move, and every reference to update.
177
+ - ASK → who would know, and the question.
178
+ - OTHER → why no verdict fits.
179
+ - A leftover something keeps producing → a `docs/failures.jsonl` row against the producer.
180
+ - A missing or stale ignore rule → the line to add or remove.
181
+ - Code or config nothing reaches → `bkit-audit-dead-code`.
182
+ - A doc that is wrong, not misplaced → `bkit-audit-documentation`.
183
+ - A dependency-bot branch → `bkit-audit-dependencies`.
184
+ - A secret in history, a log or a leftover → `bkit-audit-security`, with rotation first and the file and commit only.
185
+ - Personal data in a log or leftover → `bkit-audit-privacy`.
186
+ - A repository setting below the standard → the setting to change, for the owner.
187
+ - A repository setting that drifted from its doc → `bkit-audit-config`.
188
+ - A workflow-level scorecard failure → `bkit-audit-security`.
189
+ - Toolchain versions that disagree → the file to change.
190
+ - A host setting that disagrees → `bkit-audit-config`.
191
+ - Dependency versions that disagree → `bkit-audit-dependencies`.
192
+
193
+ **Done when:** every RESCUE and REMOVE is re-checked, with its time, verdict and destination.
194
+
195
+ - [ ] **Step 10 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per Scorecard check, and one per baseline control in the sets this audit touches (e.g., OSPS-AC, OSPS-BR-07, OSPS-GV, OSPS-LE, OSPS-VM), each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
196
+ - [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the repository itself: new top-level files and folders, workspaces, ignore and attribute files, hooks, branch and ruleset settings, host apps, webhooks, environments, and anything new that writes to the scratch directory or the root. (b) In a bounded pass of about 30 minutes, note what a senior platform engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
106
197
 
107
198
  ### 🔒 Gate 2: Probes Check
108
199
 
109
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
110
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
111
- - [ ] **No values:** no secret or personal-data value anywhere in the report.
112
- - [ ] **Nothing removed:** no worktree, branch, stash, file, or remote ref deleted or pushed.
113
- - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
200
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
201
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
202
+ - [ ] **No values:** no secret or personal-data value appears anywhere in the report.
203
+ - [ ] **Nothing removed:** no worktree, branch, stash, file or remote ref was deleted.
204
+ - [ ] **Nothing pushed:** nothing was pushed.
205
+ - [ ] **Gate 2 — Verified:** every item above holds.
114
206
 
115
207
  ## Findings
116
208
 
117
209
  <!-- prettier-ignore -->
118
210
  | Severity | Use |
119
211
  | --- | --- |
120
- | `CRITICAL` | Verified live credential in history, a log, or a leftover. Rotation first; a history rewrite does not reach existing clones |
121
- | `HIGH` | RESCUE — work one cleanup command would lose; unverified secret material in history |
122
- | `MEDIUM` | Leftover a test or script keeps producing; toolchain versions disagree; repository setting below the standard |
123
- | `LOW` | Regenerable cache, reported by size; naming drift; contribution scaffolding the owner must decide |
212
+ | `CRITICAL` | A verified live credential in history, a log or a leftover. Rotation comes first, because a history rewrite does not reach existing clones |
213
+ | `HIGH` | RESCUE: work that one cleanup command would lose. Unverified secret material in history |
214
+ | `MEDIUM` | A leftover that a test or script keeps producing. Toolchain versions that disagree. A repository setting below the standard |
215
+ | `LOW` | A regenerable cache, reported by size. Naming drift. Contribution scaffolding the owner must decide on |
124
216
 
125
- Within a severity: live credentials, then RESCUE, before REMOVE.
217
+ Within a severity, list live credentials first, then RESCUE, before REMOVE.
126
218
 
127
219
  <!-- prettier-ignore -->
128
220
  | ID | Severity | Verdict | Location | Evidence | Expected |
129
221
  | --- | --- | --- | --- | --- | --- |
130
222
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
131
223
 
132
- Empty and clean → one row `None`.
224
+ **If** the run finds nothing → write one row: `None`.
133
225
 
134
226
  ## Report
135
227
 
@@ -198,13 +290,17 @@ PENDING
198
290
 
199
291
  ### 🔒 Gate 3: Report Check
200
292
 
201
- - [ ] **No placeholders:** no `PENDING` left
202
- - [ ] **Summary:** names count per severity, the machine, and the checkout.
203
- - [ ] **Series:** `Totals` beside previous report's numbers, or marked baseline.
204
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
205
- - [ ] **Process Improvements:** `Universal` and `Project` filled
206
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
207
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
293
+ - [ ] **No placeholders:** no `PENDING` is left.
294
+ - [ ] **Summary:** `Summary` gives the count per severity.
295
+ - [ ] **Machine:** `Summary` names the machine.
296
+ - [ ] **Checkout:** `Summary` names the checkout.
297
+ - [ ] **Series:** the report shows `Totals` beside the previous report's numbers, or marks the run as baseline.
298
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
299
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
300
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
301
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
302
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
303
+ - [ ] **Gate 3 — Verified:** every item above holds.
208
304
 
209
305
  <!-- bkit:end -->
210
306