@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /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,174 +11,172 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - never widen, narrow, or edit the CI accessibility gate or its allowlists; full-rule and platform audits are report-only.
|
|
23
|
-
> - 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.
|
|
24
17
|
|
|
25
18
|
## Universal Instructions
|
|
26
19
|
|
|
27
20
|
### Context & Goals
|
|
28
21
|
|
|
29
|
-
|
|
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.
|
|
30
23
|
|
|
31
|
-
|
|
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.
|
|
32
25
|
|
|
33
|
-
**Applies when:** a user interface (web, native
|
|
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".
|
|
34
27
|
|
|
35
|
-
**Cadence:**
|
|
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.
|
|
36
29
|
|
|
37
|
-
**Anchor Standards:**
|
|
30
|
+
**Anchor Standards:**
|
|
38
31
|
|
|
39
|
-
- WCAG 2.2 (W3C Recommendation
|
|
40
|
-
- 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.
|
|
41
34
|
- European Accessibility Act, Directive (EU) 2019/882, where it applies.
|
|
42
|
-
- WAI-ARIA Authoring Practices Guide
|
|
43
|
-
- Platform accessibility HIG and store nutrition-label criteria (e.g
|
|
44
|
-
- National disability-discrimination guidance `Laws` finds applies (e.g
|
|
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).
|
|
45
38
|
- bkit block of `docs/design.md` (bkit version from `.bkit/version`): every rule and section
|
|
46
39
|
|
|
47
40
|
### Scope
|
|
48
41
|
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
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.
|
|
54
51
|
|
|
55
52
|
### Out of Scope
|
|
56
53
|
|
|
57
54
|
<!-- prettier-ignore -->
|
|
58
55
|
| Excluded item | Why | Where it belongs |
|
|
59
56
|
| --- | --- | --- |
|
|
60
|
-
| Title, description, structured data |
|
|
61
|
-
| CLS numbers |
|
|
62
|
-
| Declaring store accessibility labels |
|
|
63
|
-
|
|
|
64
|
-
| Applying fixes
|
|
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 |
|
|
65
62
|
|
|
66
63
|
### Pre-Flight / Dependencies
|
|
67
64
|
|
|
68
|
-
**Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
|
|
69
|
-
|
|
70
|
-
**Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
|
|
71
|
-
|
|
72
65
|
#### Core
|
|
73
66
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
- [ ] **
|
|
77
|
-
- [ ] **
|
|
78
|
-
- [ ] **Checker:** Steps 5, 6 — full rule set, e.g. axe-core, pa11y, Accessibility Insights. Fallback: manual steps only; automated rows `Not Checked`.
|
|
79
|
-
- [ ] **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.
|
|
80
71
|
|
|
81
72
|
#### Conditional
|
|
82
73
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **
|
|
87
|
-
- [ ] **
|
|
88
|
-
- [ ] **Email Render:** Transactional email → Step 7 — rendered HTML. Fallback: template source.
|
|
89
|
-
- [ ] **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.
|
|
90
79
|
|
|
91
80
|
### 🔒 Gate 1: Prerequisites Check
|
|
92
81
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
96
|
-
- [ ] **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.
|
|
97
84
|
|
|
98
85
|
### Probe Steps
|
|
99
86
|
|
|
100
|
-
- [ ] **Step 1 — Previous Run:**
|
|
101
|
-
- [ ] **Step 2 — Gate:** Open gate specs and helpers. Record in `Gate`: checker rule set; route list
|
|
102
|
-
- [ ] **Step 3 — Laws:** Which laws apply
|
|
103
|
-
- [ ] **Step 4 — Allowlists:**
|
|
104
|
-
- [ ] **Step 5 — Full Rules:**
|
|
105
|
-
- [ ] **Step 6 — Routes:** Diff gate route list
|
|
106
|
-
- [ ] **Step 7 — Emails:**
|
|
107
|
-
- [ ] **Step 8 — Manual:**
|
|
108
|
-
- Keyboard only: every control reachable, sensible order, visible focus
|
|
109
|
-
- Focus management: dialogs
|
|
110
|
-
- Screen reader: names, roles
|
|
111
|
-
- Assistive-technology matrix: NVDA
|
|
112
|
-
- Composite widgets
|
|
113
|
-
- Status messages (4.1.3): toasts, async state, save confirmations
|
|
114
|
-
- Page structure: skip link to main (2.4.1); unique title per route
|
|
115
|
-
- Colour alone (1.4.1):
|
|
116
|
-
- Non-text contrast (1.4.11): every theme
|
|
117
|
-
- Forced colours
|
|
118
|
-
- Zoom
|
|
119
|
-
- Text spacing (1.4.12): line-height 1.5, paragraph spacing
|
|
120
|
-
- Content on hover
|
|
121
|
-
- Orientation
|
|
122
|
-
- Reduced motion: `prefers-reduced-motion
|
|
123
|
-
- Motion
|
|
124
|
-
|
|
125
|
-
**Done when:** `Manual` row per pass: met / finding / not checked (
|
|
126
|
-
|
|
127
|
-
- [ ] **Step 9 — Sessions:**
|
|
128
|
-
- [ ] **Step 10 — Additions:** WCAG 2.2
|
|
129
|
-
- 2.5.7 Dragging Movements — every drag has single-pointer alternative.
|
|
130
|
-
- 2.4.11 Focus Not Obscured — sticky headers
|
|
131
|
-
- 3.2.6 Consistent Help and 3.3.7 Redundant Entry across multi-step flows.
|
|
132
|
-
- 2.5.8 Target Size (Minimum) — 24px floor, distinct from larger house convention gate may enforce.
|
|
133
|
-
|
|
134
|
-
**Done when:** `Additions` line per criterion: met / finding / not applicable (why).
|
|
135
|
-
|
|
136
|
-
- [ ] **Step 11 — Layout:**
|
|
137
|
-
- Hardcoded strings:
|
|
138
|
-
- Longer text: fixed widths, single-line truncation
|
|
139
|
-
- RTL: physical `left
|
|
140
|
-
- Type floor: `px` fonts not
|
|
141
|
-
- Off-scale: colours
|
|
142
|
-
- Layout-shift causes: images
|
|
143
|
-
- Breakpoints: each primary screen phone, tablet
|
|
144
|
-
- Before colour
|
|
145
|
-
|
|
146
|
-
**Done when:** `Layout` row per check: met / finding.
|
|
147
|
-
|
|
148
|
-
- [ ] **Step 12 — Native:**
|
|
149
|
-
-
|
|
150
|
-
-
|
|
151
|
-
-
|
|
152
|
-
-
|
|
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`.
|
|
153
153
|
|
|
154
154
|
### 🔒 Gate 2: Probes Check
|
|
155
155
|
|
|
156
|
-
**
|
|
157
|
-
|
|
158
|
-
- [ ] **
|
|
159
|
-
- [ ] **
|
|
160
|
-
- [ ] **Gate
|
|
161
|
-
- [ ] **No participants:** no name, contact, or health detail of an assistive-technology user.
|
|
162
|
-
- [ ] **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.
|
|
163
161
|
|
|
164
162
|
## Findings
|
|
165
163
|
|
|
166
164
|
<!-- prettier-ignore -->
|
|
167
165
|
| Severity | Use |
|
|
168
166
|
| --- | --- |
|
|
169
|
-
| `CRITICAL` | A primary task is impossible with keyboard, screen reader
|
|
170
|
-
| `HIGH` | WCAG 2.2 A or AA fail on a primary flow
|
|
171
|
-
| `MEDIUM` | A or AA fail off the primary flows
|
|
172
|
-
| `LOW` |
|
|
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 |
|
|
173
171
|
|
|
174
|
-
|
|
172
|
+
Within a severity, list blocked primary tasks first.
|
|
175
173
|
|
|
176
174
|
<!-- prettier-ignore -->
|
|
177
175
|
| ID | Severity | Location | Evidence | Expected |
|
|
178
176
|
| --- | --- | --- | --- | --- |
|
|
179
177
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
180
178
|
|
|
181
|
-
|
|
179
|
+
**If** the run finds nothing → write one row: `None`.
|
|
182
180
|
|
|
183
181
|
## Report
|
|
184
182
|
|
|
@@ -267,17 +265,17 @@ PENDING
|
|
|
267
265
|
|
|
268
266
|
### 🔒 Gate 3: Report Check
|
|
269
267
|
|
|
270
|
-
**
|
|
271
|
-
|
|
272
|
-
- [ ] **
|
|
273
|
-
- [ ] **
|
|
274
|
-
- [ ] **
|
|
275
|
-
- [ ] **Writes:** only this report
|
|
276
|
-
- [ ] **
|
|
277
|
-
- [ ] **
|
|
278
|
-
- [ ] **
|
|
279
|
-
|
|
280
|
-
|
|
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.
|
|
281
279
|
|
|
282
280
|
<!-- bkit:end -->
|
|
283
281
|
|