@cbartens/bkit 0.0.0-stage → 5.0.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 +421 -0
- package/.bkit/core/.agents/context.md +95 -0
- package/.bkit/core/.agents/docs.md +62 -0
- package/.bkit/core/.agents/rules.md +147 -0
- package/.bkit/core/.agents/skills.md +43 -0
- package/.bkit/core/.bkit/LICENSE.md +151 -0
- package/.bkit/core/.bkit/README.md +421 -0
- package/.bkit/core/.bkit/cloud.md +502 -0
- package/.bkit/core/.bkit/comparison.md +318 -0
- package/.bkit/core/.bkit/install.md +496 -0
- package/.bkit/core/.bkit/jsonl.md +497 -0
- package/.bkit/core/.bkit/prompts.md +474 -0
- package/.bkit/core/.bkit/providers.md +598 -0
- package/.bkit/core/.bkit/templates.md +471 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1546 -0
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
- package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
- package/.bkit/core/AGENTS.md +77 -0
- package/.bkit/core/LICENSE.md +149 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
- package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
- package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
- package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
- package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
- package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
- package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
- package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
- package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
- package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
- package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
- package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
- package/.bkit/core/docs/templates/bkit-plan.md +476 -0
- package/.bkit/core/engine/checks/after/auth.ts +247 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +556 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/after/vercel.ts +101 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +201 -0
- package/.bkit/core/engine/checks/before/files.ts +202 -0
- package/.bkit/core/engine/checks/before/index.ts +206 -0
- package/.bkit/core/engine/checks/before/mcp.ts +127 -0
- package/.bkit/core/engine/checks/before/repo.ts +77 -0
- package/.bkit/core/engine/checks/before/version.ts +67 -0
- package/.bkit/core/engine/checks/status-holes.ts +479 -0
- package/.bkit/core/engine/cli.ts +871 -0
- package/.bkit/core/engine/commands/analysis.ts +550 -0
- package/.bkit/core/engine/commands/ci/ci.ts +483 -0
- package/.bkit/core/engine/commands/comply.ts +415 -0
- package/.bkit/core/engine/commands/harvest.ts +459 -0
- package/.bkit/core/engine/commands/install/check.ts +70 -0
- package/.bkit/core/engine/commands/install/doctor.ts +247 -0
- package/.bkit/core/engine/commands/install/install.ts +528 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +494 -0
- package/.bkit/core/engine/commands/registry.ts +53 -0
- package/.bkit/core/engine/commands/setup/setup.ts +184 -0
- package/.bkit/core/engine/commands/telemetry.ts +32 -0
- package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
- package/.bkit/core/engine/commands/workflow/context.ts +961 -0
- package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
- package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
- package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
- package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
- package/.bkit/core/engine/commands/workflow/status.ts +455 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
- package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
- package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
- package/.bkit/core/engine/install/cloud-env.ts +925 -0
- package/.bkit/core/engine/install/managed-block.ts +212 -0
- package/.bkit/core/engine/install/manifest.ts +448 -0
- package/.bkit/core/engine/install/modules/claude.ts +362 -0
- package/.bkit/core/engine/install/modules/cloud.ts +174 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +600 -0
- package/.bkit/core/engine/install/modules/cursor.ts +231 -0
- package/.bkit/core/engine/install/modules/index.ts +242 -0
- package/.bkit/core/engine/install/modules/opencode.ts +573 -0
- package/.bkit/core/engine/install/placeholders.ts +108 -0
- package/.bkit/core/engine/install/template-copies.ts +119 -0
- package/.bkit/core/engine/install/version-file.ts +284 -0
- package/.bkit/core/engine/install/write.ts +467 -0
- package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
- package/.bkit/core/engine/ledgers/status.ts +213 -0
- package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
- package/.bkit/core/engine/render/hosts.ts +372 -0
- package/.bkit/core/engine/render/models.ts +323 -0
- package/.bkit/core/engine/render/parts.ts +38 -0
- package/.bkit/core/engine/render/trackers.ts +170 -0
- package/.bkit/core/engine/shared/egress.ts +345 -0
- package/.bkit/core/engine/shared/json.ts +16 -0
- package/.bkit/core/engine/shared/log-prefix.ts +9 -0
- package/.bkit/core/engine/shared/package-json.ts +29 -0
- package/.bkit/core/engine/shared/package-manager.ts +38 -0
- package/.bkit/core/engine/shared/package-roots.ts +163 -0
- package/.bkit/core/engine/shared/protected-paths.ts +164 -0
- package/.bkit/core/engine/shared/settings.ts +72 -0
- package/.bkit/core/engine/shared/timeouts.ts +20 -0
- package/.bkit/core/engine/tools/wording.ts +748 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
- package/.bkit/core/hooks/gateguard-engine.js +193 -0
- package/.bkit/core/hooks/guardrails-shell.js +154 -0
- package/.bkit/core/hooks/guardrails-tiers.js +68 -0
- package/.bkit/core/hooks/preflight-linear.sh +73 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
- package/.bkit/core/prompts/bkit-build-summary.md +93 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
- package/.bkit/core/prompts/bkit-design-generate.md +110 -0
- package/.bkit/core/prompts/bkit-design-organise.md +85 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
- package/.bkit/core/prompts/bkit-design-spike.md +97 -0
- package/.bkit/core/prompts/bkit-design-summary.md +106 -0
- package/.bkit/core/prompts/bkit-design-update.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
- package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
- package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
- package/.bkit/core/prompts/bkit-plan-update.md +68 -0
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
- package/.bkit/core/workflows/bkit-auto.md +121 -0
- package/.bkit/core/workflows/bkit-build.md +802 -0
- package/.bkit/core/workflows/bkit-debug.md +642 -0
- package/.bkit/core/workflows/bkit-design.md +495 -0
- package/.bkit/core/workflows/bkit-plan.md +510 -0
- package/.bkit/core/workflows/bkit-ship.md +650 -0
- package/.bkit/shared/.bkit/.env.example +108 -0
- package/.bkit/shared/.claude/bkit-cloud.md +117 -0
- package/.bkit/shared/.claude/settings.json +88 -0
- package/.bkit/shared/.codex/hooks.json +26 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
- package/.bkit/shared/.cursor/hooks.json +26 -0
- package/.bkit/shared/.cursor/mcp.json +15 -0
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
- package/.bkit/shared/.gitattributes +37 -0
- package/.bkit/shared/.mcp.json +16 -0
- package/.bkit/shared/.opencode/opencode.json +62 -0
- package/.bkit/shared/CLAUDE.md +11 -0
- package/.bkit/shared/LICENSE.md +22 -0
- package/.bkit/shared/docs/architecture.md +19 -0
- package/.bkit/shared/docs/data-schema.md +19 -0
- package/.bkit/shared/docs/deployments.md +438 -0
- package/.bkit/shared/docs/design.md +39 -0
- package/.bkit/shared/docs/noise.md +19 -0
- package/.bkit/shared/docs/observability.md +25 -0
- package/.bkit/shared/docs/security.md +42 -0
- package/.bkit/shared/docs/setup.md +30 -0
- package/.bkit/shared/docs/technology.md +18 -0
- package/.bkit/shared/docs/testing.md +413 -0
- package/.bkit/shared/gitignore +92 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
- package/.bkit/templates/.cursor/Dockerfile +68 -0
- package/.bkit/templates/.cursor/environment.json +6 -0
- package/.bkit/templates/.cursor/settings.json +11 -0
- package/.bkit/templates/.envrc +7 -0
- package/.bkit/templates/.github/dependabot.yml +52 -0
- package/.bkit/templates/.github/renovate.json5 +239 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
- package/.bkit/templates/.graphifyignore +108 -0
- package/.bkit/templates/.husky/pre-commit +16 -0
- package/.bkit/templates/.husky/pre-push +91 -0
- package/.bkit/templates/.lintstagedrc.json +3 -0
- package/.bkit/templates/.prettierignore +41 -0
- package/.bkit/templates/.serena/project.yml +243 -0
- package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
- package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
- package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
- package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
- package/.bkit/templates/.vale.ini +67 -0
- package/.bkit/templates/LICENSE.md +22 -0
- package/.bkit/templates/context/bkit-cloudrun.md +84 -0
- package/.bkit/templates/context/bkit-expo.md +186 -0
- package/.bkit/templates/context/bkit-github.md +79 -0
- package/.bkit/templates/context/bkit-inngest.md +45 -0
- package/.bkit/templates/context/bkit-maestro.md +76 -0
- package/.bkit/templates/context/bkit-playwright.md +62 -0
- package/.bkit/templates/context/bkit-resend.md +36 -0
- package/.bkit/templates/context/bkit-sentry.md +65 -0
- package/.bkit/templates/context/bkit-serena.md +33 -0
- package/.bkit/templates/context/bkit-stripe.md +36 -0
- package/.bkit/templates/context/bkit-supabase.md +59 -0
- package/.bkit/templates/context/bkit-tavily.md +49 -0
- package/.bkit/templates/context/bkit-vercel.md +64 -0
- package/.bkit/templates/docs/capabilities.md +72 -0
- package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
- package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
- package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
- package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
- package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
- package/.bkit/templates/slop-scan.config.json +120 -0
- package/CHANGELOG.md +1486 -0
- package/LICENSE.md +161 -0
- package/README.md +185 -2
- package/dist/checks/after/auth.js +232 -0
- package/dist/checks/after/ci-yml.js +718 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +447 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/after/vercel.js +102 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +173 -0
- package/dist/checks/before/files.js +185 -0
- package/dist/checks/before/index.js +162 -0
- package/dist/checks/before/mcp.js +111 -0
- package/dist/checks/before/repo.js +71 -0
- package/dist/checks/before/version.js +60 -0
- package/dist/checks/status-holes.js +393 -0
- package/dist/cli.js +692 -0
- package/dist/commands/analysis.js +325 -0
- package/dist/commands/ci/ci.js +438 -0
- package/dist/commands/comply.js +310 -0
- package/dist/commands/harvest.js +354 -0
- package/dist/commands/install/check.js +61 -0
- package/dist/commands/install/doctor.js +207 -0
- package/dist/commands/install/install.js +461 -0
- package/dist/commands/install/uninstall.js +815 -0
- package/dist/commands/install/upgrade.js +771 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +362 -0
- package/dist/commands/registry.js +50 -0
- package/dist/commands/setup/setup.js +158 -0
- package/dist/commands/telemetry.js +29 -0
- package/dist/commands/workflow/branches.js +1265 -0
- package/dist/commands/workflow/context.js +846 -0
- package/dist/commands/workflow/counters.js +227 -0
- package/dist/commands/workflow/fids.js +224 -0
- package/dist/commands/workflow/issues.js +585 -0
- package/dist/commands/workflow/ledgers.js +472 -0
- package/dist/commands/workflow/locks.js +364 -0
- package/dist/commands/workflow/prs.js +904 -0
- package/dist/commands/workflow/repo.js +199 -0
- package/dist/commands/workflow/roadmap.js +495 -0
- package/dist/commands/workflow/runs.js +1717 -0
- package/dist/commands/workflow/runtime.js +257 -0
- package/dist/commands/workflow/skills.js +110 -0
- package/dist/commands/workflow/status.js +392 -0
- package/dist/commands/workflow/steps.js +1093 -0
- package/dist/commands/workflow/tests.js +144 -0
- package/dist/commands/workflow/workflows.js +1342 -0
- package/dist/commands/workflow/workstreams.js +141 -0
- package/dist/commands/workflow/worktrees.js +473 -0
- package/dist/install/cloud-env.js +819 -0
- package/dist/install/managed-block.js +182 -0
- package/dist/install/manifest.js +376 -0
- package/dist/install/modules/claude.js +288 -0
- package/dist/install/modules/cloud.js +152 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +511 -0
- package/dist/install/modules/cursor.js +186 -0
- package/dist/install/modules/index.js +152 -0
- package/dist/install/modules/opencode.js +504 -0
- package/dist/install/placeholders.js +87 -0
- package/dist/install/template-copies.js +106 -0
- package/dist/install/version-file.js +204 -0
- package/dist/install/write.js +342 -0
- package/dist/ledgers/clamp-log.js +27 -0
- package/dist/ledgers/status.js +156 -0
- package/dist/ledgers/telemetry.js +637 -0
- package/dist/render/hosts.js +339 -0
- package/dist/render/models.js +288 -0
- package/dist/render/parts.js +33 -0
- package/dist/render/trackers.js +135 -0
- package/dist/shared/egress.js +299 -0
- package/dist/shared/json.js +16 -0
- package/dist/shared/log-prefix.js +7 -0
- package/dist/shared/package-json.js +22 -0
- package/dist/shared/package-manager.js +32 -0
- package/dist/shared/package-roots.js +145 -0
- package/dist/shared/protected-paths.js +153 -0
- package/dist/shared/settings.js +44 -0
- package/dist/shared/timeouts.js +19 -0
- package/dist/tools/wording.js +680 -0
- package/package.json +101 -4
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
# Licence for `.bkit/core/`
|
|
2
|
+
|
|
3
|
+
Everything in this folder is licensed under your choice of the PolyForm Noncommercial License 1.0.0 or the PolyForm Small Business License 1.0.0, both below. The `LICENSE.md` at the root of the bkit repository and package summarises who each one covers, and how to get a commercial licence if neither does.
|
|
4
|
+
|
|
5
|
+
Required Notice: Copyright 2026 Christian Bartens (https://github.com/cbartens/bkit)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# PolyForm Noncommercial License 1.0.0
|
|
10
|
+
|
|
11
|
+
<https://polyformproject.org/licenses/noncommercial/1.0.0>
|
|
12
|
+
|
|
13
|
+
## Acceptance
|
|
14
|
+
|
|
15
|
+
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
16
|
+
|
|
17
|
+
## Copyright License
|
|
18
|
+
|
|
19
|
+
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
|
|
20
|
+
|
|
21
|
+
## Distribution License
|
|
22
|
+
|
|
23
|
+
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
|
|
24
|
+
|
|
25
|
+
## Notices
|
|
26
|
+
|
|
27
|
+
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
28
|
+
|
|
29
|
+
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
30
|
+
|
|
31
|
+
## Changes and New Works License
|
|
32
|
+
|
|
33
|
+
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
34
|
+
|
|
35
|
+
## Patent License
|
|
36
|
+
|
|
37
|
+
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
38
|
+
|
|
39
|
+
## Noncommercial Purposes
|
|
40
|
+
|
|
41
|
+
Any noncommercial purpose is a permitted purpose.
|
|
42
|
+
|
|
43
|
+
## Personal Uses
|
|
44
|
+
|
|
45
|
+
Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
|
|
46
|
+
|
|
47
|
+
## Noncommercial Organizations
|
|
48
|
+
|
|
49
|
+
Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
|
|
50
|
+
|
|
51
|
+
## Fair Use
|
|
52
|
+
|
|
53
|
+
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
54
|
+
|
|
55
|
+
## No Other Rights
|
|
56
|
+
|
|
57
|
+
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
58
|
+
|
|
59
|
+
## Patent Defense
|
|
60
|
+
|
|
61
|
+
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
62
|
+
|
|
63
|
+
## Violations
|
|
64
|
+
|
|
65
|
+
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
66
|
+
|
|
67
|
+
## No Liability
|
|
68
|
+
|
|
69
|
+
_**As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.**_
|
|
70
|
+
|
|
71
|
+
## Definitions
|
|
72
|
+
|
|
73
|
+
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
74
|
+
|
|
75
|
+
**You** refers to the individual or entity agreeing to these terms.
|
|
76
|
+
|
|
77
|
+
**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
78
|
+
|
|
79
|
+
**Your licenses** are all the licenses granted to you for the software under these terms.
|
|
80
|
+
|
|
81
|
+
**Use** means anything you do with the software requiring one of your licenses.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
# PolyForm Small Business License 1.0.0
|
|
86
|
+
|
|
87
|
+
<https://polyformproject.org/licenses/small-business/1.0.0>
|
|
88
|
+
|
|
89
|
+
## Acceptance
|
|
90
|
+
|
|
91
|
+
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
92
|
+
|
|
93
|
+
## Copyright License
|
|
94
|
+
|
|
95
|
+
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
|
|
96
|
+
|
|
97
|
+
## Distribution License
|
|
98
|
+
|
|
99
|
+
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
|
|
100
|
+
|
|
101
|
+
## Notices
|
|
102
|
+
|
|
103
|
+
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
104
|
+
|
|
105
|
+
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
106
|
+
|
|
107
|
+
## Changes and New Works License
|
|
108
|
+
|
|
109
|
+
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
110
|
+
|
|
111
|
+
## Patent License
|
|
112
|
+
|
|
113
|
+
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
114
|
+
|
|
115
|
+
## Fair Use
|
|
116
|
+
|
|
117
|
+
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
118
|
+
|
|
119
|
+
## Small Business
|
|
120
|
+
|
|
121
|
+
Use of the software for the benefit of your company is use for a permitted purpose if your company has fewer than 100 total individuals working as employees and independent contractors, and less than 1,000,000 USD (2019) total revenue in the prior tax year. Adjust this revenue threshold for inflation according to the United States Bureau of Labor Statistics' consumer price index for all urban consumers, U.S. city average, for all items, not seasonally adjusted, with 1982–1984=100 reference base.
|
|
122
|
+
|
|
123
|
+
## No Other Rights
|
|
124
|
+
|
|
125
|
+
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
126
|
+
|
|
127
|
+
## Patent Defense
|
|
128
|
+
|
|
129
|
+
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
130
|
+
|
|
131
|
+
## Violations
|
|
132
|
+
|
|
133
|
+
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
134
|
+
|
|
135
|
+
## No Liability
|
|
136
|
+
|
|
137
|
+
_**As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.**_
|
|
138
|
+
|
|
139
|
+
## Definitions
|
|
140
|
+
|
|
141
|
+
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
142
|
+
|
|
143
|
+
**You** refers to the individual or entity agreeing to these terms.
|
|
144
|
+
|
|
145
|
+
**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
146
|
+
|
|
147
|
+
**Your licenses** are all the licenses granted to you for the software under these terms.
|
|
148
|
+
|
|
149
|
+
**Use** means anything you do with the software requiring one of your licenses.
|
|
@@ -0,0 +1,272 @@
|
|
|
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. `@bkit-audit-generate` fills this template. -->
|
|
2
|
+
|
|
3
|
+
<!-- bkit:start -->
|
|
4
|
+
|
|
5
|
+
{{BKIT_MANAGED_MARKER}}
|
|
6
|
+
|
|
7
|
+
# Accessibility Audit
|
|
8
|
+
|
|
9
|
+
> [!CAUTION]
|
|
10
|
+
> **Purpose:** What the automated accessibility gate covers, what it leaves out, and the manual passes nothing automates, judged against WCAG 2.2 AA.
|
|
11
|
+
>
|
|
12
|
+
> **Rules:**
|
|
13
|
+
>
|
|
14
|
+
> - Read-only audit; never edit code, config, or data.
|
|
15
|
+
> - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
|
|
16
|
+
> - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
|
|
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 evidence (`file:line`, or command / query and its output) and tool behind it.
|
|
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.
|
|
24
|
+
|
|
25
|
+
## Universal Instructions
|
|
26
|
+
|
|
27
|
+
### Context & Goals
|
|
28
|
+
|
|
29
|
+
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.
|
|
30
|
+
|
|
31
|
+
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.
|
|
32
|
+
|
|
33
|
+
**Applies when:** a user interface (web, native, or email). None → one `N/A` row with evidence, never "clean".
|
|
34
|
+
|
|
35
|
+
**Cadence:** quarterly. Extra pass when palette, shared control, or route layout changes. Assistive-technology user sessions: once a year, own date; record next due.
|
|
36
|
+
|
|
37
|
+
**Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
|
|
38
|
+
|
|
39
|
+
- WCAG 2.2 (W3C Recommendation; same text ISO/IEC 40500). Record dated update.
|
|
40
|
+
- EN 301 549. Record version procurement regime cites.
|
|
41
|
+
- European Accessibility Act, Directive (EU) 2019/882, where it applies.
|
|
42
|
+
- WAI-ARIA Authoring Practices Guide; record date read.
|
|
43
|
+
- Platform accessibility HIG and store nutrition-label criteria (e.g. Apple HIG and Accessibility Nutrition Labels, Android accessibility guidelines and Accessibility Scanner).
|
|
44
|
+
- National disability-discrimination guidance `Laws` finds applies (e.g. Australia's DDA and AHRC digital-access guidelines, US ADA via DOJ web guidance).
|
|
45
|
+
|
|
46
|
+
### Scope
|
|
47
|
+
|
|
48
|
+
- Applicable accessibility laws and required statement.
|
|
49
|
+
- Automated gate: rules, routes, themes, allowlists, self-checks, checker version.
|
|
50
|
+
- Full rule set, report-only, every route and every theme the app ships.
|
|
51
|
+
- Auth routes (accessible authentication), email, manual passes including assistive-technology matrix.
|
|
52
|
+
- WCAG 2.2 additions, every Level A and AA criterion, native, text across locales and widths.
|
|
53
|
+
|
|
54
|
+
### Out of Scope
|
|
55
|
+
|
|
56
|
+
<!-- prettier-ignore -->
|
|
57
|
+
| Excluded item | Why | Where it belongs |
|
|
58
|
+
| --- | --- | --- |
|
|
59
|
+
| Title, description, structured data | Search sweep; this audit owns alt text, headings, and names | `bkit-audit-aio-seo` |
|
|
60
|
+
| CLS numbers | Performance sweep; this audit names missing dimensions | `bkit-audit-app-performance` |
|
|
61
|
+
| Declaring store accessibility labels | Store sweep; this audit records which could be honest | `bkit-audit-app-store` |
|
|
62
|
+
| Accessibility-statement wording vs behaviour | Privacy sweep; this audit checks the statement exists when a law requires it | `bkit-audit-privacy` |
|
|
63
|
+
| Applying fixes / changing the gate or allowlists | Audit reports only | Plan from this report |
|
|
64
|
+
|
|
65
|
+
### Pre-Flight / Dependencies
|
|
66
|
+
|
|
67
|
+
**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.
|
|
68
|
+
|
|
69
|
+
#### Core
|
|
70
|
+
|
|
71
|
+
Always verify.
|
|
72
|
+
|
|
73
|
+
- [ ] **Gate Source:** Steps 2, 4, 13 — automated-gate files readable. Fallback: no gate while UI exists = finding; later steps run without snapshot.
|
|
74
|
+
- [ ] **Checker:** Steps 5, 6 — full rule set, e.g. axe-core, pa11y, Accessibility Insights. Fallback: manual steps only; automated rows `Not Checked`.
|
|
75
|
+
- [ ] **Web:** Step 15 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
76
|
+
|
|
77
|
+
#### Conditional
|
|
78
|
+
|
|
79
|
+
Verify only when applicable.
|
|
80
|
+
|
|
81
|
+
- [ ] **Browser Runner:** Web UI → Steps 5, 6, 8, 11 — e.g. Playwright, Cypress. Fallback: manual on named route sample; rest `Not Checked`.
|
|
82
|
+
- [ ] **Assistive Tech:** Manual pass → Step 8 — e.g. NVDA, JAWS, VoiceOver, TalkBack, Voice Control, Voice Access, Switch Control. Fallback: each missing pair → `Not Checked`.
|
|
83
|
+
- [ ] **Native Audits:** Native UI → Step 12 — e.g. Xcode Accessibility Inspector, `performAccessibilityAudit()`, Android Accessibility Scanner, Espresso Accessibility Test Framework. Fallback: `Not Checked`.
|
|
84
|
+
- [ ] **Email Render:** Transactional email → Step 7 — rendered HTML. Fallback: template source.
|
|
85
|
+
- [ ] **Contrast Tool:** Non-text contrast → Step 8 — e.g. Colour Contrast Analyser. Fallback: ratios computed from tokens.
|
|
86
|
+
|
|
87
|
+
### 🔒 Gate 1: Prerequisites Check
|
|
88
|
+
|
|
89
|
+
**Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
|
|
90
|
+
|
|
91
|
+
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
92
|
+
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
93
|
+
|
|
94
|
+
### Probe Steps
|
|
95
|
+
|
|
96
|
+
- [ ] **Step 1 — Previous Run:** Record `git rev-parse HEAD`. Read newest prior report for this slug under `docs/audits/`. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
|
|
97
|
+
- [ ] **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.
|
|
98
|
+
- [ ] **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.
|
|
99
|
+
- [ ] **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.
|
|
100
|
+
- [ ] **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.
|
|
101
|
+
- [ ] **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.
|
|
102
|
+
- [ ] **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`.
|
|
103
|
+
- [ ] **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):
|
|
104
|
+
- Keyboard only: every control reachable, sensible order, visible focus; nothing reachable that should not be; no trap.
|
|
105
|
+
- Focus management: dialogs/popovers take focus, restore on close, no strand.
|
|
106
|
+
- Screen reader: names, roles, states — custom controls; `div` + role = common missing name.
|
|
107
|
+
- 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.
|
|
108
|
+
- Composite widgets vs WAI-ARIA APG: grid (arrow keys), popover (dialog/disclosure), picker (listbox/combobox), tabs, menus — roles, keys, focus match pattern.
|
|
109
|
+
- 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).
|
|
110
|
+
- Page structure: skip link to main (2.4.1); unique title per route/locale (2.4.2); link text names destination (2.4.4).
|
|
111
|
+
- Colour alone (1.4.1): colour-only distinction also has initials, icon, or pattern — contrast tools miss this.
|
|
112
|
+
- Non-text contrast (1.4.11): every theme — focus, borders, outlines, toggles, icons ≥3:1 vs adjacent; tools often skip.
|
|
113
|
+
- Forced colours / increased contrast: `forced-colors: active`, platform Increase Contrast — custom controls and focus rings usual failures.
|
|
114
|
+
- Zoom/reflow: 200% zoom, 320px viewport — no horizontal scroll or lost content (1.4.10).
|
|
115
|
+
- Text spacing (1.4.12): line-height 1.5, paragraph spacing 2×, letter 0.12em, word 0.16em — nothing clipped/overlapping.
|
|
116
|
+
- Content on hover/focus (1.4.13): Esc dismiss, hover without vanish, persist until dismissed.
|
|
117
|
+
- Orientation/text size: no orientation lock unless essential (1.3.4); text 200% without loss (1.4.4), separate from 320px reflow.
|
|
118
|
+
- Reduced motion: `prefers-reduced-motion` on animation surfaces.
|
|
119
|
+
- Motion/flashing: no >5s self-starting animation without pause (2.2.2); no flashing (2.3.1). Native: Reduce Motion via platform API.
|
|
120
|
+
|
|
121
|
+
**Done when:** `Manual` row per pass: met / finding / not checked (which pair).
|
|
122
|
+
|
|
123
|
+
- [ ] **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`.
|
|
124
|
+
- [ ] **Step 10 — Additions:** WCAG 2.2 likeliest gaps:
|
|
125
|
+
- 2.5.7 Dragging Movements — every drag has single-pointer alternative.
|
|
126
|
+
- 2.4.11 Focus Not Obscured — sticky headers/footers can cover focus.
|
|
127
|
+
- 3.2.6 Consistent Help and 3.3.7 Redundant Entry across multi-step flows.
|
|
128
|
+
- 2.5.8 Target Size (Minimum) — 24px floor, distinct from larger house convention gate may enforce.
|
|
129
|
+
|
|
130
|
+
**Done when:** `Additions` line per criterion: met / finding / not applicable (why).
|
|
131
|
+
|
|
132
|
+
- [ ] **Step 11 — Layout:** Same screens; nothing else owns them. Source-language text breaks first when translations longer.
|
|
133
|
+
- 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.
|
|
134
|
+
- Longer text: fixed widths, single-line truncation, buttons sized to source label. Primary flow in pseudo-locale and longest shipped locale, web and native.
|
|
135
|
+
- RTL: physical `left`/`right`, physical margin/padding where logical `start`/`end`; icons that should mirror and do not.
|
|
136
|
+
- Type floor: `px` fonts not scaling with user text size; <12px; native text ignoring system font size.
|
|
137
|
+
- Off-scale: colours/spacing bypassing design tokens (if the project has them); a colour guard, if one exists, may not cover spacing/sizes.
|
|
138
|
+
- Layout-shift causes: images/media without width/height. CLS → `bkit-audit-app-performance`.
|
|
139
|
+
- Breakpoints: each primary screen phone, tablet, desktop — not only 320px reflow.
|
|
140
|
+
- 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.
|
|
141
|
+
|
|
142
|
+
**Done when:** `Layout` row per check: met / finding.
|
|
143
|
+
|
|
144
|
+
- [ ] **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`.
|
|
145
|
+
- [ ] **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.
|
|
146
|
+
- [ ] **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.
|
|
147
|
+
- [ ] **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. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
|
|
148
|
+
- [ ] **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`.
|
|
149
|
+
|
|
150
|
+
### 🔒 Gate 2: Probes Check
|
|
151
|
+
|
|
152
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
|
|
153
|
+
|
|
154
|
+
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
155
|
+
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
156
|
+
- [ ] **Gate untouched:** checker invocation, route list, and allowlists byte-identical to committed.
|
|
157
|
+
- [ ] **No participants:** no name, contact, or health detail of an assistive-technology user.
|
|
158
|
+
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
159
|
+
|
|
160
|
+
## Findings
|
|
161
|
+
|
|
162
|
+
<!-- prettier-ignore -->
|
|
163
|
+
| Severity | Use |
|
|
164
|
+
| --- | --- |
|
|
165
|
+
| `CRITICAL` | A primary task is impossible with keyboard, screen reader, or the only authentication method, and there is no workaround |
|
|
166
|
+
| `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 |
|
|
167
|
+
| `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 |
|
|
168
|
+
| `LOW` | Meets AA and misses a house convention (e.g. 44px where 2.5.8's 24px holds); wording drift that changes no criterion |
|
|
169
|
+
|
|
170
|
+
Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked primary tasks first.
|
|
171
|
+
|
|
172
|
+
<!-- prettier-ignore -->
|
|
173
|
+
| ID | Severity | Location | Evidence | Expected |
|
|
174
|
+
| --- | --- | --- | --- | --- |
|
|
175
|
+
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
176
|
+
|
|
177
|
+
Empty and clean → one row `None`.
|
|
178
|
+
|
|
179
|
+
## Report
|
|
180
|
+
|
|
181
|
+
### Summary
|
|
182
|
+
|
|
183
|
+
PENDING
|
|
184
|
+
|
|
185
|
+
### Previous Run
|
|
186
|
+
|
|
187
|
+
PENDING
|
|
188
|
+
|
|
189
|
+
### Gate
|
|
190
|
+
|
|
191
|
+
PENDING
|
|
192
|
+
|
|
193
|
+
### Laws
|
|
194
|
+
|
|
195
|
+
PENDING
|
|
196
|
+
|
|
197
|
+
### Allowlists
|
|
198
|
+
|
|
199
|
+
PENDING
|
|
200
|
+
|
|
201
|
+
### Full Rules
|
|
202
|
+
|
|
203
|
+
PENDING
|
|
204
|
+
|
|
205
|
+
### Routes
|
|
206
|
+
|
|
207
|
+
PENDING
|
|
208
|
+
|
|
209
|
+
### Emails
|
|
210
|
+
|
|
211
|
+
PENDING
|
|
212
|
+
|
|
213
|
+
### Manual
|
|
214
|
+
|
|
215
|
+
PENDING
|
|
216
|
+
|
|
217
|
+
### Sessions
|
|
218
|
+
|
|
219
|
+
PENDING
|
|
220
|
+
|
|
221
|
+
### Additions
|
|
222
|
+
|
|
223
|
+
PENDING
|
|
224
|
+
|
|
225
|
+
### Layout
|
|
226
|
+
|
|
227
|
+
PENDING
|
|
228
|
+
|
|
229
|
+
### Native
|
|
230
|
+
|
|
231
|
+
PENDING
|
|
232
|
+
|
|
233
|
+
### Criteria
|
|
234
|
+
|
|
235
|
+
PENDING
|
|
236
|
+
|
|
237
|
+
### Checked
|
|
238
|
+
|
|
239
|
+
PENDING
|
|
240
|
+
|
|
241
|
+
### Not Checked
|
|
242
|
+
|
|
243
|
+
PENDING
|
|
244
|
+
|
|
245
|
+
### Standards Coverage
|
|
246
|
+
|
|
247
|
+
PENDING
|
|
248
|
+
|
|
249
|
+
### Beyond the Steps
|
|
250
|
+
|
|
251
|
+
PENDING
|
|
252
|
+
|
|
253
|
+
### Process Improvements
|
|
254
|
+
|
|
255
|
+
PENDING
|
|
256
|
+
|
|
257
|
+
### 🔒 Gate 3: Report Check
|
|
258
|
+
|
|
259
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then stop.
|
|
260
|
+
|
|
261
|
+
- [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
|
|
262
|
+
- [ ] **Summary:** names count per severity and the checker version.
|
|
263
|
+
- [ ] **Sessions:** states the date of the last assistive-technology session and when the next is due.
|
|
264
|
+
- [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
|
|
265
|
+
- [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
|
|
266
|
+
- [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
|
|
267
|
+
|
|
268
|
+
> `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
|
|
269
|
+
|
|
270
|
+
<!-- bkit:end -->
|
|
271
|
+
|
|
272
|
+
## Project Instructions
|