@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
  # Accessibility Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,154 +11,172 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - never widen, narrow, or edit the CI accessibility gate or its allowlists; full-rule and platform audits are report-only.
15
- > - never record an assistive-technology participant's name, contact, or health detail.
14
+ > - NEVER widen, narrow or edit the CI accessibility gate or its allowlists.
15
+ > - Run the full-rule and platform audits as report-only.
16
+ > - NEVER record an assistive-technology participant's name, contact or health detail.
16
17
 
17
18
  ## Universal Instructions
18
19
 
19
20
  ### Context & Goals
20
21
 
21
- Gate on + waiting for real content still covers partial rules/routes; not keyboard, screen reader, zoom, or native. Re-finding what CI blocks wastes the run.
22
+ An automated gate that is switched on and waits for real content still covers only some rules and some routes. It does not cover keyboard use, screen readers, zoom or native apps. Re-finding what CI already blocks wastes the run.
22
23
 
23
- Target failure: **a gate that stays green while the unchecked surface is where the defects are** — allowlist with no expiry, route never opened, checker on skeleton, custom control whose name the role forgot. Start from gate snapshot; scope everything below against it.
24
+ The failure this audit targets is a gate that stays green while the defects sit in the surface it does not check. Examples: an allowlist entry with no expiry, a route the gate never opens, a checker that runs on a loading skeleton, or a custom control that has a role but no name. Start from the gate snapshot, and scope everything below against it.
24
25
 
25
- **Applies when:** a user interface (web, native, or email). None → one `N/A` row with evidence, never "clean".
26
+ **Applies when:** the project has a user interface (web, native or email). **If** it has none → write one `N/A` row with its evidence, and never report the surface as "clean".
26
27
 
27
- **Cadence:** quarterly. Extra pass when palette, shared control, or route layout changes. Assistive-technology user sessions: once a year, own date; record next due.
28
+ **Cadence:** Run once a quarter. Run an extra pass when the palette, a shared control or the route layout changes. Hold assistive-technology user sessions once a year, on their own date, and record when the next one is due.
28
29
 
29
30
  **Anchor Standards:**
30
31
 
31
- - WCAG 2.2 (W3C Recommendation; same text ISO/IEC 40500). Record dated update.
32
- - EN 301 549. Record version procurement regime cites.
32
+ - WCAG 2.2 (W3C Recommendation, the same text as ISO/IEC 40500). Record the dated update.
33
+ - EN 301 549. Record the version that the procurement regime cites.
33
34
  - European Accessibility Act, Directive (EU) 2019/882, where it applies.
34
- - WAI-ARIA Authoring Practices Guide; record date read.
35
- - Platform accessibility HIG and store nutrition-label criteria (e.g. Apple HIG and Accessibility Nutrition Labels, Android accessibility guidelines and Accessibility Scanner).
36
- - National disability-discrimination guidance `Laws` finds applies (e.g. Australia's DDA and AHRC digital-access guidelines, US ADA via DOJ web guidance).
35
+ - WAI-ARIA Authoring Practices Guide. Record the date read.
36
+ - Platform accessibility HIG and store nutrition-label criteria (e.g., Apple HIG and Accessibility Nutrition Labels, Android accessibility guidelines and Accessibility Scanner).
37
+ - National disability-discrimination guidance that `Laws` finds applies (e.g., Australia's DDA and AHRC digital-access guidelines, US ADA via DOJ web guidance).
37
38
  - bkit block of `docs/design.md` (bkit version from `.bkit/version`): every rule and section
38
39
 
39
40
  ### Scope
40
41
 
41
- - Applicable accessibility laws and required statement.
42
- - Automated gate: rules, routes, themes, allowlists, self-checks, checker version.
43
- - Full rule set, report-only, every route and every theme the app ships.
44
- - Auth routes (accessible authentication), email, manual passes including assistive-technology matrix.
45
- - WCAG 2.2 additions, every Level A and AA criterion, native, text across locales and widths.
42
+ - Find the accessibility laws that apply, and the statement they require.
43
+ - Snapshot the automated gate: its rules, routes, themes, allowlists, self-checks and checker version.
44
+ - Run the full rule set, report-only, on every route and every theme the app ships.
45
+ - Check the auth routes for accessible authentication.
46
+ - Check the emails the product sends.
47
+ - Run the manual passes, including the assistive-technology matrix.
48
+ - Check the WCAG 2.2 additions and every Level A and AA criterion.
49
+ - Check the native UI.
50
+ - Check text across locales and widths.
46
51
 
47
52
  ### Out of Scope
48
53
 
49
54
  <!-- prettier-ignore -->
50
55
  | Excluded item | Why | Where it belongs |
51
56
  | --- | --- | --- |
52
- | Title, description, structured data | Search sweep; this audit owns alt text, headings, and names | `bkit-audit-aio-seo` |
53
- | CLS numbers | Performance sweep; this audit names missing dimensions | `bkit-audit-app-performance` |
54
- | Declaring store accessibility labels | Store sweep; this audit records which could be honest | `bkit-audit-app-store` |
55
- | Accessibility-statement wording vs behaviour | Privacy sweep; this audit checks the statement exists when a law requires it | `bkit-audit-privacy` |
56
- | Applying fixes / changing the gate or allowlists | Audit reports only | Plan from this report |
57
+ | Title, description, structured data | The search sweep owns them. This audit owns alt text, headings and names | `bkit-audit-aio-seo` |
58
+ | CLS numbers | The performance sweep owns them. This audit names missing dimensions | `bkit-audit-app-performance` |
59
+ | Declaring store accessibility labels | The store sweep owns it. This audit records which labels could be declared honestly | `bkit-audit-app-store` |
60
+ | Whether the accessibility statement's wording matches behaviour | The privacy sweep owns it. This audit checks that the statement exists when a law requires it | `bkit-audit-privacy` |
61
+ | Applying fixes; changing the gate or allowlists | The audit only reports | A plan made from this report |
57
62
 
58
63
  ### Pre-Flight / Dependencies
59
64
 
60
65
  #### Core
61
66
 
62
- - [ ] **Permissions:** blocked calls recorded
63
- - [ ] **Gate Source:** Steps 2, 4, 13 — automated-gate files readable. Fallback: no gate while UI exists = finding; later steps run without snapshot.
64
- - [ ] **Checker:** Steps 5, 6 — full rule set, e.g. axe-core, pa11y, Accessibility Insights. Fallback: manual steps only; automated rows `Not Checked`.
65
- - [ ] **Web:** Step 15 — fetch anchor standards. Fallback: versions recorded as unread.
67
+ - [ ] **Permissions:** every blocked call is recorded.
68
+ - [ ] **Gate Source:** Steps 2, 4, 13 — the automated gate's files, readable. Fallback: **If** a user interface exists and no gate does → record a finding, and run the later steps without a snapshot.
69
+ - [ ] **Checker:** Steps 5, 6 — the full rule set (e.g., axe-core, pa11y, Accessibility Insights). Fallback: run the manual steps only, and mark the automated rows `Not Checked`.
70
+ - [ ] **Web:** Step 15 — fetch the anchor standards. Fallback: record the versions as unread.
66
71
 
67
72
  #### Conditional
68
73
 
69
- - [ ] **Browser Runner:** Web UI → Steps 5, 6, 8, 11 — e.g. Playwright, Cypress. Fallback: manual on named route sample; rest `Not Checked`.
70
- - [ ] **Assistive Tech:** Manual pass → Step 8 — e.g. NVDA, JAWS, VoiceOver, TalkBack, Voice Control, Voice Access, Switch Control. Fallback: each missing pair → `Not Checked`.
71
- - [ ] **Native Audits:** Native UI → Step 12 — e.g. Xcode Accessibility Inspector, `performAccessibilityAudit()`, Android Accessibility Scanner, Espresso Accessibility Test Framework. Fallback: `Not Checked`.
72
- - [ ] **Email Render:** Transactional email → Step 7 — rendered HTML. Fallback: template source.
73
- - [ ] **Contrast Tool:** Non-text contrast → Step 8 — e.g. Colour Contrast Analyser. Fallback: ratios computed from tokens.
74
+ - [ ] **Browser Runner:** **If** the UI is web → Steps 5, 6, 8, 11 — a browser runner (e.g., Playwright, Cypress). Fallback: check a named sample of routes by hand, and mark the rest `Not Checked`.
75
+ - [ ] **Assistive Tech:** **If** a manual pass runs → Step 8 — assistive technology (e.g., NVDA, JAWS, VoiceOver, TalkBack, Voice Control, Voice Access, Switch Control). Fallback: mark each missing pair `Not Checked`.
76
+ - [ ] **Native Audits:** **If** the UI is native → Step 12 — the platform audit tools (e.g., Xcode Accessibility Inspector, `performAccessibilityAudit()`, Android Accessibility Scanner, Espresso Accessibility Test Framework). Fallback: `Not Checked`.
77
+ - [ ] **Email Render:** **If** the product sends transactional email → Step 7 — the rendered HTML. Fallback: read the template source.
78
+ - [ ] **Contrast Tool:** **If** non-text contrast is checked → Step 8 — a contrast tool (e.g., Colour Contrast Analyser). Fallback: compute the ratios from the tokens.
74
79
 
75
80
  ### 🔒 Gate 1: Prerequisites Check
76
81
 
77
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
78
- - [ ] **Gate 1 — Verified:** All Core items checked. All applicable Conditional items checked.
82
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
83
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
79
84
 
80
85
  ### Probe Steps
81
86
 
82
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
83
- - [ ] **Step 2 — Gate:** Open gate specs and helpers. Record in `Gate`: checker rule set; route list + ready/settle selectors per route; each allowlist; gate-pinned vs audit-run checker version; rules checker changelog adds since previous report version (pinned old version under-reports newer WCAG 2.2 rules). Scope everything below against snapshot. **Done when:** snapshot in `Gate`, or no gate recorded.
84
- - [ ] **Step 3 — Laws:** Which laws apply = owner decision; record or unmade (`Project Instructions` names questions). Law requiring public accessibility statement, service info, feedback channel → check they exist. Statement wording vs behaviour → `bkit-audit-privacy`. **Done when:** `Laws` row per regime: applies · why · statement.
85
- - [ ] **Step 4 — Allowlists:** Per-offender keys, never runtime hash, never rule downgrade or route exclusion. Honest only if each entry re-read. Per entry: offender still there, reason still true, fixable now? No expiry/owner = permanent exemption = finding. Policy "new entry = finding, not fix" (`Project Instructions`) → new entry = finding. Stale (offender gone, key remains) = finding. **Done when:** `Allowlists` row per entry: still present · reason true · expiry or owner · verdict. Empty → one row `none`, key shape noted.
86
- - [ ] **Step 5 — Full Rules:** Gate runs small rule set as hard gate. This audit: everything report-only — no rule restriction, every route, every theme the app ships, WCAG 2.2 AA tag set not just defaults. Full run on gate-uncovered route → findings. Do not widen CI rule set — rank; widening = later plan. Same sequencing as `bkit-audit-dead-code`: report first, gate later. **Done when:** `Full Rules` counts per route and theme, each violation dispositioned.
87
- - [ ] **Step 6 — Routes:** Diff gate route list vs every route. Each auth route: WCAG 2.2 3.3.8 Accessible Authentication — paste in every password/code field; `autocomplete` (`email`, `current-password`, `new-password`, `one-time-code` on code fields, also 1.3.5); CAPTCHA alternative not cognitive test; note magic-link/passkey sign-in. **Done when:** `Routes` row per route: in gate / not, 3.3.8 line per auth route.
88
- - [ ] **Step 7 — Emails:** Each transactional email the product sends (list from templates / send calls). Per message: `lang`; plain-text or real text alternative; image alt; layout tables `role="presentation"`; link text out of context; contrast. **Done when:** `Emails` row per message, or no email surface in `Checked`.
89
- - [ ] **Step 8 — Manual:** Not automatable. One pass per run on primary flows named in `Project Instructions` (none named → sign-in → first screen → core create action; record flows walked):
90
- - Keyboard only: every control reachable, sensible order, visible focus; nothing reachable that should not be; no trap.
91
- - Focus management: dialogs/popovers take focus, restore on close, no strand.
92
- - Screen reader: names, roles, states — custom controls; `div` + role = common missing name.
93
- - Assistive-technology matrix: NVDA+Chrome, NVDA+Firefox; JAWS+Chrome; VoiceOver+Safari macOS; VoiceOver iOS Safari + native app; TalkBack Chrome + native Android; one flow Voice Control (iOS) or Voice Access (Android); one Switch Control. Record versions. Pairs from latest WebAIM Screen Reader User Survey — re-read new editions; record figure and year.
94
- - Composite widgets vs WAI-ARIA APG: grid (arrow keys), popover (dialog/disclosure), picker (listbox/combobox), tabs, menus — roles, keys, focus match pattern.
95
- - Status messages (4.1.3): toasts, async state, save confirmations, form errors via `aria-live` or `role="status"` without moving focus; self-dismissing toast readable duration or pausable (2.2.1).
96
- - Page structure: skip link to main (2.4.1); unique title per route/locale (2.4.2); link text names destination (2.4.4).
97
- - Colour alone (1.4.1): colour-only distinction also has initials, icon, or pattern — contrast tools miss this.
98
- - Non-text contrast (1.4.11): every theme — focus, borders, outlines, toggles, icons >=3:1 vs adjacent; tools often skip.
99
- - Forced colours / increased contrast: `forced-colors: active`, platform Increase Contrast — custom controls and focus rings usual failures.
100
- - Zoom/reflow: 200% zoom, 320px viewport — no horizontal scroll or lost content (1.4.10).
101
- - Text spacing (1.4.12): line-height 1.5, paragraph spacing 2x, letter 0.12em, word 0.16em — nothing clipped/overlapping.
102
- - Content on hover/focus (1.4.13): Esc dismiss, hover without vanish, persist until dismissed.
103
- - Orientation/text size: no orientation lock unless essential (1.3.4); text 200% without loss (1.4.4), separate from 320px reflow.
104
- - Reduced motion: `prefers-reduced-motion` on animation surfaces.
105
- - Motion/flashing: no >5s self-starting animation without pause (2.2.2); no flashing (2.3.1). Native: Reduce Motion via platform API.
106
-
107
- **Done when:** `Manual` row per pass: met / finding / not checked (which pair).
108
-
109
- - [ ] **Step 9 — Sessions:** Yearly, 3-5 daily assistive-technology users on primary flow. Expert review misses their strategies; many screen-reader users navigate by headings first (WebAIM survey — record figure). Record last session date and next due. None yet → due now, not pass. **Done when:** `Sessions` holds last date, next due, barriers, or `due now`.
110
- - [ ] **Step 10 — Additions:** WCAG 2.2 likeliest gaps:
111
- - 2.5.7 Dragging Movements — every drag has single-pointer alternative.
112
- - 2.4.11 Focus Not Obscured — sticky headers/footers can cover focus.
113
- - 3.2.6 Consistent Help and 3.3.7 Redundant Entry across multi-step flows.
114
- - 2.5.8 Target Size (Minimum) — 24px floor, distinct from larger house convention gate may enforce.
115
-
116
- **Done when:** `Additions` line per criterion: met / finding / not applicable (why).
117
-
118
- - [ ] **Step 11 — Layout:** Same screens; nothing else owns them. Source-language text breaks first when translations longer.
119
- - Hardcoded strings: if a hardcoded-string guard exists → re-read each exception — reason still true? User-facing string without reason = finding. No guard → record absence in `Checked`. Translation authoring = plan, not this run.
120
- - Longer text: fixed widths, single-line truncation, buttons sized to source label. Primary flow in pseudo-locale and longest shipped locale, web and native.
121
- - RTL: physical `left`/`right`, physical margin/padding where logical `start`/`end`; icons that should mirror and do not.
122
- - Type floor: `px` fonts not scaling with user text size; <12px; native text ignoring system font size.
123
- - Off-scale: colours/spacing bypassing design tokens (if the project has them); a colour guard, if one exists, may not cover spacing/sizes.
124
- - Layout-shift causes: images/media without width/height. CLS → `bkit-audit-app-performance`.
125
- - Breakpoints: each primary screen phone, tablet, desktop — not only 320px reflow.
126
- - Before colour/sizing defect: value duplicated? Duplicated colour/spacing = finding here + name for `bkit-audit-duplication`. Documented palette / token source (if any) = reference fix edits first.
127
-
128
- **Done when:** `Layout` row per check: met / finding.
129
-
130
- - [ ] **Step 12 — Native:** Native UI → shared controls: name, role, state (e.g. `accessibilityLabel`, `accessibilityRole`, `accessibilityState`). Screen reader on same primary flow. Platform-split files (e.g. RN `.native`/`.web`) not diverged in labelling. Shared component fixed web bug → confirm native twin (consumer refs both ways; text search — language server under-reports). Platform automated audits report-only per primary-flow screen: iOS Accessibility Inspector or `performAccessibilityAudit()` in XCUITest; Android Accessibility Scanner or Espresso Accessibility Test Framework. Text scaling: largest accessibility text size + 200% font max (large-text scaling non-linear, e.g. Android 14+). Content not clipped/overlapped. Search text-scaling opt-outs on content text (e.g. RN `allowFontScaling={false}`, low `maxFontSizeMultiplier`; SwiftUI capped `dynamicTypeSize`; Android text sized in `dp` not `sp`) — finding unless reason recorded. Map to platform nutrition-label criteria (`Project Instructions`); declare only if common tasks completable with that feature; larger text needs >=200%. Record honest labels; declaring → `bkit-audit-app-store`. **Done when:** `Native` holds label parity, audit rows, scaling, label map, or no native UI in `Checked`.
131
- - [ ] **Step 13 — Gate Proof:** Vacuous-assertion class: checker on unmounted subtree passes; unmatched locator can pass assertion. Confirm gate self-checks fail closed — injected failure reported, injected undersize proves rule ran (not merely no violation when alternatives pass isolated node). Each route settle selector resolves after guarded content renders, including post-skeleton mount. Refactored route may measure skeleton again. **Done when:** self-check results in `Gate`, or no gate recorded.
132
- - [ ] **Step 14 — Criteria:** Automated rules cover minority of WCAG success criteria; `Manual` + `Additions` = chosen subset. Primary flows web + native: pass/fail/N/A every WCAG 2.2 Level A and AA criterion. Reuse earlier steps (name step); hand-check rest. Each fail = finding. **Done when:** `Criteria` has no empty criterion.
133
- - [ ] **Step 15 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: row per anchor + per WCAG 2.2 A/AA criterion → checked (name step; reuse `Criteria`) / not applicable (why) / finding. Per bkit anchor (doc section, rule, or issue shape): one row → followed (name step or evidence) / not applicable (why) / finding; departure with no recorded reason (e.g. `docs/decisions.jsonl` row, accepted-divergence entry) = finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
134
- - [ ] **Step 16 — Anything Else:** (a) Since previous report commit touching accessibility (routes, shared controls + platform twins (e.g. `.web`/`.native`), palette/tokens, animations, emails, gate rule set/route list/allowlists, checker version) → one-line verdict each. (b) ~30 min bounded: senior specialist flags no step asks; read since previous run (incidents, new `docs/failures.jsonl`, `bkit-audit-logs`, vendor status) — 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`.
87
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
88
+ - [ ] **Step 2 — Gate:** Open the gate's specs and helpers. Record in `Gate`: the checker rule set; the route list, with the ready and settle selectors of each route; each allowlist; the checker version the gate pins beside the version this audit runs; and the rules the checker's changelog added since the previous report's version, because a pinned old version under-reports the newer WCAG 2.2 rules. Scope every step below against this snapshot. **Done when:** `Gate` holds the snapshot, or records that there is no gate.
89
+ - [ ] **Step 3 — Laws:** Which laws apply is the owner's decision. Record the decision, or record that it is unmade (`Project Instructions` names the questions). **If** a law requires a public accessibility statement, service information or a feedback channel → check that each exists. Whether the statement's wording matches behaviour goes to `bkit-audit-privacy`. **Done when:** `Laws` holds one row per regime: applies · why · statement.
90
+ - [ ] **Step 4 — Allowlists:** A sound allowlist keys each entry to one offender, never to a runtime hash, and never downgrades a rule or excludes a route. An allowlist is honest only if each entry is re-read. For each entry, check whether the offender is still there, whether the reason is still true, and whether it is fixable now. **If** an entry has neither an expiry nor an owner → it is a permanent exemption, and a finding. **If** `Project Instructions` sets the policy "a new entry is a finding, not a fix" → record each new entry as a finding. **If** an entry is stale (the offender is gone and the key remains) → record a finding. **Done when:** `Allowlists` holds one row per entry: still present · reason true · expiry or owner · verdict. **If** there are no entries → write one row `none`, and note the key shape.
91
+ - [ ] **Step 5 — Full Rules:** The gate runs a small rule set as a hard gate. This audit runs everything, report-only: no rule restriction, every route and every theme the app ships, and the WCAG 2.2 AA tag set, not just the defaults. Record what the full run finds on a route the gate does not cover as findings. Do not widen the CI rule set. Rank the findings instead, and leave widening to a later plan. The order is the same as in `bkit-audit-dead-code`: report first, gate later. **Done when:** `Full Rules` holds the counts per route and theme, and each violation has a disposition.
92
+ - [ ] **Step 6 — Routes:** Diff the gate's route list against every route. Check each auth route against WCAG 2.2 3.3.8 Accessible Authentication: paste works in every password and code field; `autocomplete` is set (`email`, `current-password`, `new-password`, and `one-time-code` on code fields, which 1.3.5 also covers); and any CAPTCHA has an alternative that is not a cognitive test. Note magic-link and passkey sign-in. **Done when:** `Routes` holds one row per route, in the gate or not, and one 3.3.8 line per auth route.
93
+ - [ ] **Step 7 — Emails:** List each transactional email the product sends, from the templates and send calls. Check each message for `lang`; a plain-text part or a real text alternative; image alt text; `role="presentation"` on layout tables; link text that makes sense out of context; and contrast. **Done when:** `Emails` holds one row per message, or `Checked` records that there is no email surface.
94
+ - [ ] **Step 8 — Manual:** These checks cannot be automated. Run one pass per run on the primary flows that `Project Instructions` names. **If** it names none → walk sign-in, then the first screen, then the core create action. Record the flows walked. On each flow, run these passes:
95
+ - Keyboard only: every control is reachable, in a sensible order, with visible focus. Nothing is reachable that should not be, and there is no keyboard trap.
96
+ - Focus management: dialogs and popovers take focus and restore it on close, and focus is never stranded.
97
+ - Screen reader: custom controls have names, roles and states. A `div` given a role is the common case of a missing name.
98
+ - Assistive-technology matrix: NVDA with Chrome and with Firefox; JAWS with Chrome; VoiceOver with Safari on macOS; VoiceOver with iOS Safari and the native app; TalkBack with Chrome and the native Android app; one flow with Voice Control (iOS) or Voice Access (Android); and one with Switch Control. Record the versions. The pairs come from the latest WebAIM Screen Reader User Survey. Re-read each new edition, and record the figure and the year.
99
+ - Composite widgets against the WAI-ARIA APG: grid (arrow keys), popover (dialog or disclosure), picker (listbox or combobox), tabs and menus. Their roles, keys and focus match the pattern.
100
+ - Status messages (4.1.3): toasts, async state, save confirmations and form errors are announced through `aria-live` or `role="status"` without moving focus. A self-dismissing toast stays for a readable duration, or can be paused (2.2.1).
101
+ - Page structure: a skip link to the main content (2.4.1); a unique title per route and locale (2.4.2); link text that names its destination (2.4.4).
102
+ - Colour alone (1.4.1): a distinction made by colour also has initials, an icon or a pattern. Contrast tools miss this.
103
+ - Non-text contrast (1.4.11): in every theme, focus indicators, borders, outlines, toggles and icons reach >=3:1 against adjacent colours. Tools often skip this.
104
+ - Forced colours and increased contrast: check `forced-colors: active` and the platform's Increase Contrast. Custom controls and focus rings are the usual failures.
105
+ - Zoom and reflow: at 200% zoom and a 320px viewport, there is no horizontal scroll and no lost content (1.4.10).
106
+ - Text spacing (1.4.12): with line-height 1.5, paragraph spacing 2x, letter spacing 0.12em and word spacing 0.16em, nothing is clipped or overlapping.
107
+ - Content on hover or focus (1.4.13): Esc dismisses it, the pointer can move onto it without it vanishing, and it persists until dismissed.
108
+ - Orientation and text size: there is no orientation lock unless it is essential (1.3.4), and text resizes to 200% without loss (1.4.4), which is a separate check from 320px reflow.
109
+ - Reduced motion: animation surfaces respect `prefers-reduced-motion`.
110
+ - Motion and flashing: no self-starting animation runs longer than 5s without a pause (2.2.2), and nothing flashes (2.3.1). On native, Reduce Motion is read through the platform API.
111
+
112
+ **Done when:** `Manual` holds one row per pass: met / finding / not checked (naming the pair).
113
+
114
+ - [ ] **Step 9 — Sessions:** Once a year, the owner holds a session with 3-5 people who use assistive technology daily, on a primary flow. Expert review misses their strategies. For example, many screen-reader users navigate by headings first (the WebAIM survey; record the figure). Record the date of the last session and when the next is due. **If** no session has happened yet → record it as due now, not as a pass. **Done when:** `Sessions` holds the last date, the next due date and the barriers found, or `due now`.
115
+ - [ ] **Step 10 — Additions:** Check the WCAG 2.2 additions most likely to be missed:
116
+ - 2.5.7 Dragging Movements — every drag has a single-pointer alternative.
117
+ - 2.4.11 Focus Not Obscured — sticky headers and footers can cover focus.
118
+ - 3.2.6 Consistent Help and 3.3.7 Redundant Entry, across multi-step flows.
119
+ - 2.5.8 Target Size (Minimum) — a 24px floor, distinct from any larger house convention the gate may enforce.
120
+
121
+ **Done when:** `Additions` holds one line per criterion: met / finding / not applicable (saying why).
122
+
123
+ - [ ] **Step 11 — Layout:** Use the same screens. No other audit owns these checks. Source-language text breaks layouts first when translations are longer.
124
+ - Hardcoded strings: **If** a hardcoded-string guard exists → re-read each of its exceptions, and check that its reason still holds. A user-facing string with no reason is a finding. **If** there is no guard → record its absence in `Checked`. Writing translations belongs to a plan, not this run.
125
+ - Longer text: look for fixed widths, single-line truncation and buttons sized to the source label. Walk the primary flow in a pseudo-locale and in the longest shipped locale, on web and native.
126
+ - RTL: look for physical `left` and `right`, and physical margin and padding, where logical `start` and `end` belong; and for icons that should mirror and do not.
127
+ - Type floor: look for `px` fonts that do not scale with the user's text size, text under 12px, and native text that ignores the system font size.
128
+ - Off-scale values: look for colours and spacing that bypass the design tokens, where the project has them. A colour guard, where one exists, may not cover spacing and sizes.
129
+ - Layout-shift causes: look for images and media without width and height. CLS goes to `bkit-audit-app-performance`.
130
+ - Breakpoints: check each primary screen at phone, tablet and desktop widths, not only at 320px reflow.
131
+ - Before you record a colour or sizing defect, check whether the value is duplicated. A duplicated colour or spacing value is a finding here, and is named for `bkit-audit-duplication`. Where the project documents a palette or token source, that source is the reference the fix edits first.
132
+
133
+ **Done when:** `Layout` holds one row per check: met / finding.
134
+
135
+ - [ ] **Step 12 — Native:** Run this step only when the project has a native UI.
136
+ - Check that each shared control carries a name, role and state (e.g., `accessibilityLabel`, `accessibilityRole`, `accessibilityState`).
137
+ - Run the screen reader on the same primary flow.
138
+ - Check that platform-split files (e.g., React Native `.native` and `.web`) have not diverged in labelling.
139
+ - **If** a shared component fixed a web bug → confirm its native twin, following consumer references both ways with text search, because the language server under-reports them.
140
+ - Run the platform's automated audits, report-only, on each primary-flow screen: iOS Accessibility Inspector or `performAccessibilityAudit()` in XCUITest; Android Accessibility Scanner or the Espresso Accessibility Test Framework.
141
+ - Test text scaling at the largest accessibility text size and at the 200% font maximum, because large-text scaling is non-linear (e.g., Android 14+).
142
+ - Check that no content is clipped or overlapping.
143
+ - Search for text-scaling opt-outs on content text (e.g., React Native `allowFontScaling={false}` or a low `maxFontSizeMultiplier`; a capped SwiftUI `dynamicTypeSize`; Android text sized in `dp`, not `sp`). Each one is a finding unless a reason is recorded.
144
+ - Map the results to the platform's nutrition-label criteria (`Project Instructions`). A label may be declared only if common tasks can be completed with that feature, and larger text needs >=200%.
145
+ - Record which labels would be honest. Declaring them belongs to `bkit-audit-app-store`.
146
+
147
+ **Done when:** `Native` holds label parity, the audit rows, scaling and the label map, or `Checked` records that there is no native UI.
148
+
149
+ - [ ] **Step 13 — Gate Proof:** A gate can pass on a vacuous assertion: a checker run on an unmounted subtree passes, and an unmatched locator can pass an assertion. Confirm that the gate's self-checks fail closed: an injected failure is reported, and an injected undersize target proves the rule ran, not merely that no violation appeared because alternatives pass on an isolated node. Check that each route's settle selector resolves after the guarded content renders, including content mounted after a skeleton. A refactored route may measure the skeleton again. **Done when:** `Gate` holds the self-check results, or records that there is no gate.
150
+ - [ ] **Step 14 — Criteria:** Automated rules cover a minority of the WCAG success criteria, and `Manual` and `Additions` cover a chosen subset. On the primary flows, web and native, mark every WCAG 2.2 Level A and AA criterion pass, fail or N/A. Reuse the earlier steps, naming the step, and check the rest by hand. Record each fail as a finding. **Done when:** `Criteria` has no empty criterion.
151
+ - [ ] **Step 15 — 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 anchor and one per WCAG 2.2 A and AA criterion, each marked checked (naming the step, and reusing `Criteria`), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a 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.
152
+ - [ ] **Step 16 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches accessibility: routes, shared controls and their platform twins (e.g., `.web` and `.native`), the palette and tokens, animations, emails, the gate's rule set, route list and allowlists, and the checker version. (b) In a bounded pass of about 30 minutes, note what a senior specialist would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows, `bkit-audit-logs` output, vendor status), 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`.
135
153
 
136
154
  ### 🔒 Gate 2: Probes Check
137
155
 
138
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
139
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
140
- - [ ] **Gate untouched:** checker invocation, route list, and allowlists byte-identical to committed.
141
- - [ ] **No participants:** no name, contact, or health detail of an assistive-technology user.
142
- - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
156
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
157
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
158
+ - [ ] **Gate untouched:** the checker invocation, route list and allowlists are byte-identical to the committed versions.
159
+ - [ ] **No participants:** no name, contact or health detail of an assistive-technology user appears in the report.
160
+ - [ ] **Gate 2 — Verified:** every item above holds.
143
161
 
144
162
  ## Findings
145
163
 
146
164
  <!-- prettier-ignore -->
147
165
  | Severity | Use |
148
166
  | --- | --- |
149
- | `CRITICAL` | A primary task is impossible with keyboard, screen reader, or the only authentication method, and there is no workaround |
150
- | `HIGH` | WCAG 2.2 A or AA fail on a primary flow; gate self-check hollow, or the gate measured a skeleton; a drag on a primary interaction has no single-pointer alternative; an allowlist entry hides a real A or AA failure |
151
- | `MEDIUM` | A or AA fail off the primary flows; email defect; native name, role, or state missing on a shared control; text clipped at 200%, at 320px, or in a long locale; allowlist entry whose reason is stale or has no expiry |
152
- | `LOW` | Meets AA and misses a house convention (e.g. 44px where 2.5.8's 24px holds); wording drift that changes no criterion |
167
+ | `CRITICAL` | A primary task is impossible with the keyboard, a screen reader or the only authentication method, and there is no workaround |
168
+ | `HIGH` | A WCAG 2.2 A or AA fail on a primary flow. A hollow gate self-check, or a gate that measured a skeleton. A drag on a primary interaction with no single-pointer alternative. An allowlist entry that hides a real A or AA failure |
169
+ | `MEDIUM` | An A or AA fail off the primary flows. An email defect. A native name, role or state missing on a shared control. Text clipped at 200%, at 320px or in a long locale. An allowlist entry whose reason is stale or that has no expiry |
170
+ | `LOW` | The UI meets AA and misses a house convention (e.g., 44px where 2.5.8's 24px holds). Wording drift that changes no criterion |
153
171
 
154
- Within a severity: blocked primary tasks first.
172
+ Within a severity, list blocked primary tasks first.
155
173
 
156
174
  <!-- prettier-ignore -->
157
175
  | ID | Severity | Location | Evidence | Expected |
158
176
  | --- | --- | --- | --- | --- |
159
177
  | PENDING | PENDING | PENDING | PENDING | PENDING |
160
178
 
161
- Empty and clean → one row `None`.
179
+ **If** the run finds nothing → write one row: `None`.
162
180
 
163
181
  ## Report
164
182
 
@@ -247,13 +265,17 @@ PENDING
247
265
 
248
266
  ### 🔒 Gate 3: Report Check
249
267
 
250
- - [ ] **No placeholders:** no `PENDING` left
251
- - [ ] **Summary:** names count per severity and the checker version.
252
- - [ ] **Sessions:** states the date of the last assistive-technology session and when the next is due.
253
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
254
- - [ ] **Process Improvements:** `Universal` and `Project` filled
255
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
256
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
268
+ - [ ] **No placeholders:** no `PENDING` is left.
269
+ - [ ] **Summary:** `Summary` gives the count per severity.
270
+ - [ ] **Checker version:** `Summary` gives the checker version.
271
+ - [ ] **Sessions:** `Sessions` states the date of the last assistive-technology session.
272
+ - [ ] **Next session:** `Sessions` states when the next session is due.
273
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
274
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
275
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
276
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
277
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
278
+ - [ ] **Gate 3 — Verified:** every item above holds.
257
279
 
258
280
  <!-- bkit:end -->
259
281