@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,270 @@
|
|
|
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
|
+
# Testing Audit
|
|
8
|
+
|
|
9
|
+
> [!CAUTION]
|
|
10
|
+
> **Purpose:** Whether the suite tests what the product must do and must never do, whether those tests go red when the code breaks, and whether they run.
|
|
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 weaken, skip, delete, or quarantine a test to get green. A test that fails because it found a real bug is working.
|
|
23
|
+
> - Mutation and clock probes restore the tree before the report finishes: in-place edits reverted, throwaway setup removed, `git status` clean on touched paths. Restore fails → STOP, restore, record as finding.
|
|
24
|
+
> - Do not run suites that send mail, take payment, or write production tenants. Unit and local / throwaway targets only.
|
|
25
|
+
|
|
26
|
+
## Universal Instructions
|
|
27
|
+
|
|
28
|
+
### Context & Goals
|
|
29
|
+
|
|
30
|
+
Green suite = tests passed — not that they could fail, that every promise has a test, or that lanes run them. Coverage % misses both: line covered by a test that asserts nothing; % cannot show behaviour that should exist with no test. Target failure: **a test that stays green when the behaviour it names is broken, or a promise with no test at the tier that would notice.**
|
|
31
|
+
|
|
32
|
+
**Applies when:** test runner, test files, or CI test lane. None → one `N/A` row with evidence, never "clean".
|
|
33
|
+
|
|
34
|
+
**Cadence:** monthly — every product area and every package or app; record mutation cost per package. Package mutation tool cannot finish → `Not Checked` with that cost, never omitted. Extra pass when: test-toolchain major or config changes (mutation with force — incremental misses those); new route, worker, or external service; `bkit-audit-logs` or `bkit-audit-flakes` reports bug no test caught.
|
|
35
|
+
|
|
36
|
+
**Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
|
|
37
|
+
|
|
38
|
+
- Risk-based testing (e.g. ISO/IEC/IEEE 29119 Part 1:2022 and Part 2:2021, ISTQB Foundation Level syllabus).
|
|
39
|
+
- Test-size model (e.g. Testing Trophy, Google test sizes); unversioned → record the date read.
|
|
40
|
+
- Mutation tool, incl. incremental mode and disable comments (e.g. StrykerJS, mutmut); record the version run.
|
|
41
|
+
- Property-based testing (e.g. fast-check, Hypothesis); record the version read.
|
|
42
|
+
- Contract testing (e.g. Pact, schema snapshots); record the version read.
|
|
43
|
+
- Database tests (e.g. pgTAP, a catalog check against the deployed schema); record the date read.
|
|
44
|
+
- OWASP ASVS and the OWASP API Security Top 10; record the edition read.
|
|
45
|
+
- Visual and accessibility snapshots (e.g. Playwright `toHaveScreenshot` / `toMatchAriaSnapshot`, device screenshots); record the runner version.
|
|
46
|
+
- Test-smell catalogue (e.g. xUnit Test Patterns, Meszaros 2007).
|
|
47
|
+
- Test lint (e.g. `@vitest/eslint-plugin`, `eslint-plugin-playwright`, `eslint-plugin-testing-library`); record each version.
|
|
48
|
+
- Network mock that fails closed (e.g. MSW); record the major read.
|
|
49
|
+
|
|
50
|
+
### Scope
|
|
51
|
+
|
|
52
|
+
- Should-test list: promises, never-events, platforms, roles, failure paths, data that outlives the request. Right tier, not only any tier.
|
|
53
|
+
- Database rules and boundary contracts have tests, not only the guards in front of them.
|
|
54
|
+
- Mutation: would tests go red. Known cannot-fail shapes. Lint and setup that should catch those shapes.
|
|
55
|
+
- Every test file has a lane. Timezone and date boundaries. Duplicated test procedure.
|
|
56
|
+
|
|
57
|
+
### Out of Scope
|
|
58
|
+
|
|
59
|
+
<!-- prettier-ignore -->
|
|
60
|
+
| Excluded item | Why | Where it belongs |
|
|
61
|
+
| --- | --- | --- |
|
|
62
|
+
| Branch-coverage percentage and the CI floor | Coverage sweep | `bkit-audit-coverage` |
|
|
63
|
+
| Flake diagnosis | Flake triage | `bkit-audit-flakes` |
|
|
64
|
+
| Log sweeps | Log triage | `bkit-audit-logs` |
|
|
65
|
+
| Turning a check into a CI gate | Gates sweep | `bkit-audit-gates` |
|
|
66
|
+
| Dead code beyond a mutant no test runs | Dead-code sweep | `bkit-audit-dead-code` |
|
|
67
|
+
| Product-code duplication | Duplication sweep | `bkit-audit-duplication` |
|
|
68
|
+
| Catalogue privileges and policy correctness | Database sweep | `bkit-audit-database` |
|
|
69
|
+
| Changing tests or code | Audit reports only | Plan from this report |
|
|
70
|
+
|
|
71
|
+
### Pre-Flight / Dependencies
|
|
72
|
+
|
|
73
|
+
**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.
|
|
74
|
+
|
|
75
|
+
#### Core
|
|
76
|
+
|
|
77
|
+
Always verify.
|
|
78
|
+
|
|
79
|
+
- [ ] **Git:** Steps 1, 14 — `git rev-parse`, diff since previous report. Fallback: run marked baseline; ages and the what-changed pass `Not Checked`.
|
|
80
|
+
- [ ] **Test Runner:** Steps 3, 6, 9, 10 — execute or read reports, e.g. Vitest, Jest, pytest. Fallback: static read only; counts, mutation, clock runs `Not Checked`.
|
|
81
|
+
- [ ] **Web:** Step 13 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
82
|
+
|
|
83
|
+
#### Conditional
|
|
84
|
+
|
|
85
|
+
Verify only when applicable.
|
|
86
|
+
|
|
87
|
+
- [ ] **Mutation Tool:** Tool exists for the language → Step 6 — e.g. Stryker, mutmut. Fallback: hand-break code tests protect; scores `Not Checked`.
|
|
88
|
+
- [ ] **E2E Runner:** Browser or device E2E → Steps 3, 7, 9 — e.g. Playwright, Cypress, Maestro. Fallback: unit and integration only.
|
|
89
|
+
- [ ] **DB Tests:** Row-level policies, buckets, or data migrations → Step 4 — e.g. pgTAP, `supabase db test`, deployed-schema check. Fallback: read existing tests; live matrix = hypothesis.
|
|
90
|
+
- [ ] **Test Lint:** Test files linted → Step 8 — e.g. eslint-plugin-vitest, eslint-plugin-playwright. Fallback: text search for the shapes.
|
|
91
|
+
- [ ] **Language Server:** Typed language → Step 11 — references, e.g. Serena, `tsserver`. Fallback: text search; name it.
|
|
92
|
+
|
|
93
|
+
### 🔒 Gate 1: Prerequisites Check
|
|
94
|
+
|
|
95
|
+
**Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
|
|
96
|
+
|
|
97
|
+
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
98
|
+
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
99
|
+
|
|
100
|
+
### Probe Steps
|
|
101
|
+
|
|
102
|
+
- [ ] **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.
|
|
103
|
+
- [ ] **Step 2 — Scope:** Every product area for Steps 3–5 (behaviour usually crosses packages). Every package or app for Steps 6–11. Area shared with native client → every platform; one defect can have a different cause on each. **Done when:** every area, every package, platforms in `Scope`; tools and commands in `Checked`.
|
|
104
|
+
- [ ] **Step 3 — Behaviours:** Start from product should-do, not code — code finds untested code, not promises with no test or unguarded failures. Rows from:
|
|
105
|
+
- Screens and routes (each action one row; finishing separate from opening).
|
|
106
|
+
- Unattended work (workers, crons, inbound, webhooks, tool APIs).
|
|
107
|
+
- Security rules (cross-tenant read/write, role above itself, signed-out access).
|
|
108
|
+
- OWASP ASVS and API Security Top 10 items security doc may omit (cross-tenant object access, open redirect, SSRF via user-supplied URL, mass assignment, rate limiting, CSRF, webhook signature bypass) — tier each.
|
|
109
|
+
- Decisions ledger (decision with no test undoable unnoticed).
|
|
110
|
+
- Failures ledger (each fixed row needs test red if fix reverted).
|
|
111
|
+
- Each external-service boundary → live test reaching real service.
|
|
112
|
+
- Multiply every row: every platform (native never out of scope when native client exists); every role can/cannot; failure path (request fails, service down, invalid input, cancel halfway); data outliving request (deletes, retention, billing, storage writes).
|
|
113
|
+
- Per row: tier = unit / integration / live / web E2E / device E2E / none vs project rubric. Tier below behaviour (mock for real external API) = gap. Tier above (only web/device E2E where unit/integration suffices) = finding — slowness and flake source. Record test count and runtime per tier per package (trophy vs pyramid). Per core screen: visual or accessibility snapshot on web, device screenshot on native; list screens with neither.
|
|
114
|
+
- Rank gaps: another tenant's data, lost data, money first; broken core action; cosmetic.
|
|
115
|
+
- Recurring shapes: action started never finished (confirm on destructive/session-wide); failing request still success; security guard only stop (e.g. app check because DB client skips RLS) — list even if code correct today; settings config-only (triggers, schedules, concurrency, lint globs, auth mount paths) — blank breaks production unnoticed.
|
|
116
|
+
- Behaviour-to-test registry exists → start from it, add; do not rebuild. Coverage reports show untested code; cannot produce this list. **Done when:** ranked gaps, tiers, per-tier counts in `Gaps`.
|
|
117
|
+
- [ ] **Step 4 — Database Rules:** DB with row-level policies (e.g. Postgres RLS, Firestore rules), storage buckets, definer-rights functions, or data-changing migrations → app guard tests cannot catch policy regression in migration. Per row-policy table, bucket, definer-rights function: DB test (e.g. pgTAP) or DB-backed integration asserts allow/deny per role and operation (select, insert, update, delete). Record matrix gaps. Migration transforming rows, not only schema → replay test on seeded rows asserts invariants: row counts, no orphaned FKs, no nulls in new `NOT NULL` column. **Done when:** matrix in `Database Rules`, or skip with evidence.
|
|
118
|
+
- [ ] **Step 5 — Contracts:** External services or fielded older clients → fixtures typed to provider SDK and pinned API version; age each payload vs version; webhook bad/expired signature tested and rejected. Contract or snapshot pins API and validator shapes oldest supported client needs; else server breaking change ships green. **Done when:** rows in `Contracts`, or skip with evidence.
|
|
119
|
+
- [ ] **Step 6 — Mutation:** Run mutation tool on every package. One small change at a time (flip comparison, delete line, blank string). Setup and traps → project docs. In-place mutation → nothing else builds, lints, tests, or commits package under mutation; tree clean afterwards or STOP and restore. Give every unnoticed change exactly one verdict:
|
|
120
|
+
- **Bug in the code** — change exposed real wrong behaviour. Route as app bug.
|
|
121
|
+
- **Real gap** — test exists, does not check this. Name missing assertion.
|
|
122
|
+
- **No test at all** — no unit test runs this code. Tier that should own it → Step 3.
|
|
123
|
+
- **Caught elsewhere** — integration, live, or E2E would catch it. Name the test. "Probably the E2E" is not a verdict.
|
|
124
|
+
- **Equivalent** — no observable difference. Report the tool's disable comment to add so the next run does not re-judge it. Adding it is the next step.
|
|
125
|
+
- **Not worth a test** — log text, error messages.
|
|
126
|
+
- **Tool misreport** — re-check by hand.
|
|
127
|
+
- **Other** — say why. Same `Other` on 2 runs → propose verdict in `Process Improvements`.
|
|
128
|
+
|
|
129
|
+
Do not trust tool numbers until checked. Runner with zero tests per mutant → every mutant in suite reported survived. Test file crashing on load → survived, not caught. Integration-named tests mocking everything can sit outside unit and mutation runs. Tests reading source as text cannot mutate. Re-check every zero-tests survivor by hand. Code tool cannot reach (browser specs, device flows, lint guard tests) → break by hand, run test, watch red, restore. Two scores: total and covered (excludes mutants no test runs), by package and product risk area from Step 3. Total dominated by **No test at all** hides weak existing tests. List pure functions where boundary mutants survive (comparisons, dates, timezones, permission checks, validators) → one property-based test to recommend each. Record cost: wall-clock, CPU-seconds, peak memory, triage agents. CI check viability → `bkit-audit-gates` from those numbers. Run incremental keeping previous incremental file; full run (e.g. Stryker `--force`) every few runs and after dependency, config, or snapshot change. Record mode. **Done when:** both scores, verdicts, property candidates, cost, mode in `Scores`, or skip with evidence.
|
|
130
|
+
|
|
131
|
+
- [ ] **Step 7 — Shapes:** Search every package for a test that cannot fail. Every one of these has been green while checking nothing:
|
|
132
|
+
- Wait that does not wait. Visibility check with ignored timeout (e.g. `isVisible({ timeout })`); response wait nobody reads.
|
|
133
|
+
- Assertion matching anything. Bare regex in object matcher (e.g. Vitest `toMatchObject`); two constants vs calling code.
|
|
134
|
+
- Mock hiding thing under test. Hand-written mock of shared module, or fixture shape production never produces.
|
|
135
|
+
- Test of copy, not code. Hand-written copy of guard, or two apps same code compared to each other.
|
|
136
|
+
- Setup skipping code. Fake DB always empty — branch under test never runs.
|
|
137
|
+
- Test locking in bug. Asserts wrong behaviour; no decision wanted it.
|
|
138
|
+
- Positive control that cannot fail. Asserts absent using selector/text that never existed.
|
|
139
|
+
- Guard tested in different setup from runtime (cwd, config, env).
|
|
140
|
+
- String scan cut short. Comment stripper cutting at marker also cuts marker inside strings.
|
|
141
|
+
- Wrong surface. Write one place, assertion reads another — for every write, assertion reads surface write meant to change. Derived copies → `bkit-audit-database`.
|
|
142
|
+
- Status-only assertion. Response code only on operation that succeeds when failed. Assert what was stored.
|
|
143
|
+
- Two clients mocked as one. User-scoped and admin clients differ; same mock cannot see write through wrong one. Mocks keep runtime-different deps different.
|
|
144
|
+
- "Did not throw" only check on boundary (webhook, external API, DB write). Not throwing ≠ work happened. Step 6 usually confirms.
|
|
145
|
+
|
|
146
|
+
New shape → propose under `Process Improvements`. Do not edit this list during run. **Done when:** every hit in `Shapes`, or `none`.
|
|
147
|
+
|
|
148
|
+
- [ ] **Step 8 — Guards:** Shape tools can catch → lint rule or setup file, not per-run search. Confirm enabled for test files; record violation count per test-stack lint rule catching each shape (e.g. JS: `vitest/expect-expect`, `vitest/valid-expect`, `vitest/no-conditional-in-test`, `playwright/missing-playwright-await`, `playwright/no-wait-for-timeout`, `playwright/prefer-web-first-assertions`, `playwright/no-networkidle`, `playwright/no-force-option`, `@typescript-eslint/no-floating-promises`; Python: `flake8-pytest-style`). No test-stack linter → text search for the shapes, say so. Rule would catch Step 7 shape and is off → finding, destination `bkit-audit-gates`. Confirm network mock fails test on unhandled request (e.g. MSW `onUnhandledRequest: 'error'`). Else unmocked call reaches real service or hangs. Fixtures/factories typed to generated DB types and schema validators, where the project has them. Grep tests for type-check escapes (e.g. TS `as any`, `as unknown as`; Python `cast(Any, ...)`, `# type: ignore`) — fixture drifts to shape production never produces; untyped language → `N/A`. Count snapshot assertions and size. List snapshot files (e.g. `.snap`) changed same commit as covered code since previous report commit. Large snapshot or wholesale `-u` update behaves like assertion matching anything. **Done when:** counts and hits in `Guards`.
|
|
149
|
+
- [ ] **Step 9 — Runs:** Every test file has a lane. Names putting file outside every run (see Step 6). Suites skipping when setup fails instead of failing. Skips (e.g. `test.skip`, `fixme`, `describe.skip`, `pytest.mark.skip`), env-dependent skips. Stale build output runner now collects (e.g. Vitest 4 and later does not ignore `dist/` by default). The 20 slowest tests per tier from runner reports. Slow test = next one someone skips. **Done when:** rows in `Runs`.
|
|
150
|
+
- [ ] **Step 10 — Time:** Date/calendar/timezone logic → unit tests with `TZ` non-UTC zone observing DST (e.g. `Pacific/Auckland`, `America/St_Johns`) on process before workers spawn. Then date-touching suites with clock pinned near month end and DST change (e.g. `vi.setSystemTime`, Playwright `page.clock`), throwaway setup removed after. Record tests whose result changes. List suites never pinning clock. **Done when:** results in `Time`, or skip with evidence.
|
|
151
|
+
- [ ] **Step 11 — Copies:** Same test procedure in several places (open dialog, create user, read credentials). Disagreeing copies first. Agreeing copies need single owner only if likely to drift. One owner created → next step adds guard failing on new copy. Code graph finds copied functions; copied statement sequences need syntax-tree scan. Product-code duplication → `bkit-audit-duplication`. **Done when:** groups in `Copies`, or `none`.
|
|
152
|
+
- [ ] **Step 12 — Route:** No finding without re-checkable evidence: `file:line`, or query, run id, measurement, plus tool. Language-server empty inconclusive → corroborate text search. Report names where each finding goes; sending is next step. App bug → `docs/failures.jsonl` row and issue; security bugs flagged for project security milestone. Missing test small → test to write. Missing test large → follow-up issue. Cannot-fail test → fix, positive control (break code, watch red, restore), `docs/failures.jsonl` row. Behaviour no recorded intent → question for maintainer; do not guess from code. Tier too high → lower-tier test to write; higher-tier stays until new one seen red. Equivalent mutant → disable comment to add. Timezone/date result → app bug if app wrong; else test fix and `docs/failures.jsonl` row. Flaky → `bkit-audit-flakes`. Coverage floor move → `bkit-audit-coverage`. Check as CI gate → `bkit-audit-gates`. Dead code → `bkit-audit-dead-code`. **Done when:** every finding's Expected names destination.
|
|
153
|
+
- [ ] **Step 13 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per OWASP API Security Top 10 item and ASVS chapter (attack rows Step 3), per test-smell in catalogue (shapes Step 7) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. Do not change steps during run. **Done when:** no empty row.
|
|
154
|
+
- [ ] **Step 14 — Anything Else:** (a) Everything since previous report commit touching suite (test files/helpers, fixtures/factories, unit/browser/device runner config, CI test lanes, routes/workers/migrations/external services tests cover) → one-line verdict each. (b) Bounded ~30 min pass: senior test engineer flags outside steps; read since previous run (incidents, `bkit-audit-logs`, new `docs/failures.jsonl`, 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`.
|
|
155
|
+
|
|
156
|
+
### 🔒 Gate 2: Probes Check
|
|
157
|
+
|
|
158
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
|
|
159
|
+
|
|
160
|
+
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
161
|
+
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
162
|
+
- [ ] **Tree clean:** mutation restores and throwaway clock setup removed; no test weakened, skipped, or deleted.
|
|
163
|
+
- [ ] **Scores:** total and covered recorded, or mutation explicitly skipped with evidence.
|
|
164
|
+
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
165
|
+
|
|
166
|
+
## Findings
|
|
167
|
+
|
|
168
|
+
<!-- prettier-ignore -->
|
|
169
|
+
| Severity | Use |
|
|
170
|
+
| --- | --- |
|
|
171
|
+
| `CRITICAL` | Untested or cannot-fail guard on cross-tenant access, money, or a workflow with no workaround; the lane that should run that guard does not |
|
|
172
|
+
| `HIGH` | Core behaviour with no test, or a test that cannot go red; security guard with no test; untyped external contract or untested signature rejection; timezone-dependent result hiding a real bug |
|
|
173
|
+
| `MEDIUM` | Tier too low or too high; missing failure path; lint rule off that would catch a cannot-fail shape; duplicated procedures that disagree; snapshot that matches anything; suite that skips itself |
|
|
174
|
+
| `LOW` | Equivalent mutant without a disable comment; cosmetic screen without a visual assertion; agreed duplicates |
|
|
175
|
+
|
|
176
|
+
Scale per `.bkit/jsonl.md` § Severity. Within a severity: security / data first.
|
|
177
|
+
|
|
178
|
+
<!-- prettier-ignore -->
|
|
179
|
+
| ID | Severity | Location | Evidence | Expected |
|
|
180
|
+
| --- | --- | --- | --- | --- |
|
|
181
|
+
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
182
|
+
|
|
183
|
+
Empty and clean → one row `None`.
|
|
184
|
+
|
|
185
|
+
## Report
|
|
186
|
+
|
|
187
|
+
### Summary
|
|
188
|
+
|
|
189
|
+
PENDING
|
|
190
|
+
|
|
191
|
+
### Previous Run
|
|
192
|
+
|
|
193
|
+
PENDING
|
|
194
|
+
|
|
195
|
+
### Scope
|
|
196
|
+
|
|
197
|
+
PENDING
|
|
198
|
+
|
|
199
|
+
### Gaps
|
|
200
|
+
|
|
201
|
+
PENDING
|
|
202
|
+
|
|
203
|
+
### Database Rules
|
|
204
|
+
|
|
205
|
+
PENDING
|
|
206
|
+
|
|
207
|
+
### Contracts
|
|
208
|
+
|
|
209
|
+
PENDING
|
|
210
|
+
|
|
211
|
+
### Scores
|
|
212
|
+
|
|
213
|
+
PENDING
|
|
214
|
+
|
|
215
|
+
### Shapes
|
|
216
|
+
|
|
217
|
+
PENDING
|
|
218
|
+
|
|
219
|
+
### Guards
|
|
220
|
+
|
|
221
|
+
PENDING
|
|
222
|
+
|
|
223
|
+
### Runs
|
|
224
|
+
|
|
225
|
+
PENDING
|
|
226
|
+
|
|
227
|
+
### Time
|
|
228
|
+
|
|
229
|
+
PENDING
|
|
230
|
+
|
|
231
|
+
### Copies
|
|
232
|
+
|
|
233
|
+
PENDING
|
|
234
|
+
|
|
235
|
+
### Checked
|
|
236
|
+
|
|
237
|
+
PENDING
|
|
238
|
+
|
|
239
|
+
### Not Checked
|
|
240
|
+
|
|
241
|
+
PENDING
|
|
242
|
+
|
|
243
|
+
### Standards Coverage
|
|
244
|
+
|
|
245
|
+
PENDING
|
|
246
|
+
|
|
247
|
+
### Beyond the Steps
|
|
248
|
+
|
|
249
|
+
PENDING
|
|
250
|
+
|
|
251
|
+
### Process Improvements
|
|
252
|
+
|
|
253
|
+
PENDING
|
|
254
|
+
|
|
255
|
+
### 🔒 Gate 3: Report Check
|
|
256
|
+
|
|
257
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then stop.
|
|
258
|
+
|
|
259
|
+
- [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
|
|
260
|
+
- [ ] **Summary:** names the single most important finding, count per severity, and both mutation scores per package (or the skip).
|
|
261
|
+
- [ ] **Series:** test count and runtime per tier, and both scores, beside previous report's numbers, or marked baseline.
|
|
262
|
+
- [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
|
|
263
|
+
- [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
|
|
264
|
+
- [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
|
|
265
|
+
|
|
266
|
+
> `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.
|
|
267
|
+
|
|
268
|
+
<!-- bkit:end -->
|
|
269
|
+
|
|
270
|
+
## Project Instructions
|
|
@@ -0,0 +1,237 @@
|
|
|
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
|
+
# Usability Review
|
|
8
|
+
|
|
9
|
+
> [!CAUTION]
|
|
10
|
+
> **Purpose:** Whether each screen matches its drawing and the same screen on other platforms, and whether a person can finish the primary flows.
|
|
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 commit, push, or start a metered native build to produce shots. Use an artifact that already exists.
|
|
23
|
+
> - Seeded-defect copies stay in scratch. never write them into the app, the manifest under test, or this report as product shots.
|
|
24
|
+
> - Session notes name the segment, not the person. never copy a personal-data value from a screen into the report.
|
|
25
|
+
|
|
26
|
+
## Universal Instructions
|
|
27
|
+
|
|
28
|
+
### Context & Goals
|
|
29
|
+
|
|
30
|
+
Automated checks never look at a screen. They pass when a title is centred on one platform and left-aligned on another, when an empty state was never drawn, or when a label overflows. Drawings are the reference for how a screen should look, so drift from the drawing is a defect with every test green. Target failure: a screen that does not match its drawing, its twin on another platform, or a path a new user can finish.
|
|
31
|
+
|
|
32
|
+
**Applies when:** user-facing screens. None → one `N/A` row with evidence, never "clean".
|
|
33
|
+
|
|
34
|
+
**Cadence:** monthly. Extra pass when a shared component, the palette, or a route's layout changes. Every second run includes the sessions in `Sessions`.
|
|
35
|
+
|
|
36
|
+
**Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
|
|
37
|
+
|
|
38
|
+
- Nielsen's 10 usability heuristics (NN/g, the 1994 set).
|
|
39
|
+
- NN/g severity ratings: frequency, impact, and persistence.
|
|
40
|
+
- ISO 9241-11:2018 (effectiveness, efficiency, and satisfaction).
|
|
41
|
+
- ISO 9241-110:2020 (interaction principles).
|
|
42
|
+
- Platform interface guidelines (e.g. Apple Human Interface Guidelines, Material Design 3). Living documents; record the date read.
|
|
43
|
+
- Human-AI interaction guidelines (e.g. Microsoft HAX, 18 guidelines; Google PAIR Guidebook).
|
|
44
|
+
- Task metrics (e.g. task success, time on task, Single Ease Question, SUS, UMUX-Lite) and the five-participant round.
|
|
45
|
+
|
|
46
|
+
### Scope
|
|
47
|
+
|
|
48
|
+
- Rendered screens beside their drawings and beside the same screen on other platforms.
|
|
49
|
+
- Routes and states the capture did not reach.
|
|
50
|
+
- A new user's first journey, per platform.
|
|
51
|
+
- Heuristics on the primary flows, including when the drawing itself is the defect.
|
|
52
|
+
- Copy, locale format, findability, platform conventions, notifications, poor network, and device switching.
|
|
53
|
+
- Errors, forms, and destructive actions.
|
|
54
|
+
- AI features the user must see, correct, and undo.
|
|
55
|
+
- Scripted sessions with real people, every second run.
|
|
56
|
+
|
|
57
|
+
### Out of Scope
|
|
58
|
+
|
|
59
|
+
<!-- prettier-ignore -->
|
|
60
|
+
| Excluded item | Why | Where it belongs |
|
|
61
|
+
| --- | --- | --- |
|
|
62
|
+
| Contrast, target size, focus, labels | Same screens, different sweep | `bkit-audit-accessibility` |
|
|
63
|
+
| A value or control implemented twice | Duplication sweep | `bkit-audit-duplication` |
|
|
64
|
+
| Funnel or feedback instrumentation | Analytics sweep | `bkit-audit-analytics` |
|
|
65
|
+
| Store listing declarations | Store sweep | `bkit-audit-app-store` |
|
|
66
|
+
| Model output, when the screen already shows, corrects, and undoes it | Model sweep | `bkit-audit-llm` |
|
|
67
|
+
| Price, renewal, or cancel wording vs consumer law | Privacy sweep | `bkit-audit-privacy` |
|
|
68
|
+
| Capture pipeline (bad crop, unpaired row, missing cell, canary miss) | Pipeline, not the screen | Plan from this report |
|
|
69
|
+
| Changing screens or drawings | Audit reports only | Plan from this report |
|
|
70
|
+
|
|
71
|
+
### Pre-Flight / Dependencies
|
|
72
|
+
|
|
73
|
+
**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.
|
|
74
|
+
|
|
75
|
+
#### Core
|
|
76
|
+
|
|
77
|
+
Always verify.
|
|
78
|
+
|
|
79
|
+
- [ ] **Screens:** Steps 2, 7–14 — open product (local or existing preview). Fallback: drawings and source only; live claims = hypotheses.
|
|
80
|
+
- [ ] **Drawings:** Steps 5, 7, 9 — reference drawings readable. Fallback: live vs live only; drawing comparison `Not Checked`.
|
|
81
|
+
- [ ] **Web:** Step 15 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
82
|
+
|
|
83
|
+
#### Conditional
|
|
84
|
+
|
|
85
|
+
Verify only when applicable.
|
|
86
|
+
|
|
87
|
+
- [ ] **Capture Artifact:** Screenshot-capture pipeline exists, finished run's artifact inside retention window → Steps 3–6. Fallback: hand walk; capture `Not Checked`. NEVER push or start a run.
|
|
88
|
+
- [ ] **Vision:** Image review → Steps 5–6 — agent opens every PNG. Fallback: hand comparison; record images not opened.
|
|
89
|
+
- [ ] **Phone Runtimes:** Phone apps ship → Step 8 — simulator, emulator, or device. Fallback: web only; phone `Not Checked`.
|
|
90
|
+
- [ ] **Locale Catalogue:** More than one locale, or a pseudo-locale → Step 8. Fallback: source-language copy only.
|
|
91
|
+
- [ ] **Participants:** Session run → Step 11. Fallback: last round's date and next due date; figures `Not Checked`.
|
|
92
|
+
|
|
93
|
+
### 🔒 Gate 1: Prerequisites Check
|
|
94
|
+
|
|
95
|
+
**Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
|
|
96
|
+
|
|
97
|
+
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
98
|
+
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
99
|
+
|
|
100
|
+
### Probe Steps
|
|
101
|
+
|
|
102
|
+
- [ ] **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.
|
|
103
|
+
- [ ] **Step 2 — Signals:** Since previous report: funnel drop-off on core flows, support tickets, store-review themes, in-app feedback. Top 5 complaints → each a finding or explained by run end. No users yet → `no users yet`. Missing or untrustworthy funnel data stays listed; fix → `bkit-audit-analytics`. **Done when:** `Signals` holds the five, or `no users yet`.
|
|
104
|
+
- [ ] **Step 3 — Capture:** Project has a screenshot-capture pipeline (`Project Instructions` names it, incl. how a run opts in, e.g. commit-message marker) → use finished run with artifact still inside retention window. No pipeline or no such run → hand walk; capture `Not Checked`. Record run id, event type, opt-in markers. Fetch and review before artifact expires. **Done when:** run id in `Capture`, or absence recorded.
|
|
105
|
+
- [ ] **Step 4 — Manifest:** Download that run's report artifact. Read manifest and gap step in same job's log, where the pipeline emits them: every route and test id the run did not reach → this run's blind spot. **Done when:** manifest path in `Capture` and gap list in `Gaps`, or skip recorded.
|
|
106
|
+
- [ ] **Step 5 — Review:** Side-by-side image per row. Reviewer opens every image; reads each row (drawing, viewport, full page, each platform with a cell). Rules: rows, not pairs (one row per screen × state × size × theme the pipeline captures); status bar, home indicator, and keyboard are never findings; blocked or missing native cell = pipeline or surface with no phone screen, never app defect; cut drawing stops at control its state is about — region below cut not missing; viewport↔viewport, full page↔full page (heights differ by construction); same scale → metrics may compare, different scale → layout and presence only. Inventory on full-page pair only: items in drawing missing from app, items in app missing from drawing — names, not counts; do not fold inventory into parity severity. Verdicts not deterministic → Step 7. **Done when:** every row has verdict or explicit skip; `Inventory` names both directions or `none`.
|
|
107
|
+
- [ ] **Step 6 — Canary:** Run that finds nothing reads like blind reviewer. Copy few rows' shots to scratch; seed known defects (title off centre, truncated button label, blank drawn empty state). Point manifest copy at them; review those rows only. Record hit rate. Missed seed = pipeline finding, not app defect. **Done when:** hit rate in `Canary`.
|
|
108
|
+
- [ ] **Step 7 — Verify:** No finding counts until PNG and live screen at same width and theme opened; drawing compared and wins on arrangement when they disagree; pipeline ruled out; value or control checked for second implementation (platform file split, both consumers). Second copy still recorded here → belongs to `bkit-audit-duplication`. Each finding cites PNG, live screen, drawing, or source line. **Done when:** every finding has that evidence.
|
|
109
|
+
- [ ] **Step 8 — Hand Checks:** What shots do not cover. While phone cells blocked → walk primary flows on each phone platform, light and dark, against same drawings. States seed does not produce (empty, loading, failed request): each not seen = unchecked, not clean. Longer text in pseudo-locale; source detail → `bkit-audit-accessibility`. Translations: every key in every locale, no source-language on translated screen, no sentence from joined strings; then read every locale for meaning. Dates, numbers, currency use locale format. Plurals: counts reaching every category locale has (0, 1, 2, 5, 21 cover most) — right branch, not raw pattern or source-language form. Right-to-left target locale → walk primary flow once. Plain language: UI copy and email ~grade 8; one word per concept everywhere; no internal jargon. Findability: five lookups `Project Instructions` name; flag path over 3 taps or clicks. Phone conventions: back gesture and system back, native date/time pickers, share sheet, haptics, safe areas, pull-to-refresh, tab bar. Web: links open in place, browser back works, every screen has URL that opens directly. Notifications and email: worth sending, open right screen; frequency and quiet-hours settings; permission in context when first needed, not at first launch. Poor network on phone: slow/flaky, offline, backgrounding mid-flow, low-end device — record what user sees, whether action queues or fails loudly, whether every skeleton and spinner resolves. Switching devices: start task on phone, finish on web; state, drafts, notifications agree. Plans: comparison understandable, prices show tax and currency, downgrade, and cancel take no more steps than upgrade, no confirm-shaming, and no hidden cancel path. Consumer-law wording → `bkit-audit-privacy`. Everything in `Gaps`. **Done when:** `Hand Checks` lists each item checked, unchecked, or not applicable.
|
|
110
|
+
- [ ] **Step 9 — First Run:** Capture account already full. Walk new-user path by hand, as journey, each platform, fresh synthetic account teardown can reap. One row per point: screens and taps, dead ends, words that assume knowledge, verdict per platform. (1) Sign up on web, including confirmation message and link, through first landing — check message, not only screens. (2) Install on phone first — create account? If not, screen says where to go? (3) Multi-tenant → tenant created for them: understand it exists, see and change name, find address or id given. (4) Empty primary screens — each says what to do next or is blank; no drawing of empty state → finding for drawing first: decide, draw, then build. (5) First record by hand from empty screen — appears where expected, empty-state message goes away. (6) Product ingests items from outside app (e.g. forwarded email, upload) → first item: what they see while processing, reply text, when nothing extractable. (7) Invitations exist → join by invitation — different first run, arrive in full tenant. (8) Come back: sign out, sign in, recovery path once; note drawings promise what app lacks. (9) First plan gate or paywall in first session — what it says, whether next step clear. **Done when:** `First Run` has one row per point; condition unmet → `N/A` row with evidence.
|
|
111
|
+
- [ ] **Step 10 — Heuristics:** Drawing says how screen should look; nothing above asks whether drawn design is usable — screen matching bad drawing passes. Walk each primary flow; check every screen against Nielsen's 10 heuristics. Each violation = finding with heuristic (`H1` visibility of system status through `H10` help and documentation). Same problem in drawing → finding for drawing first. **Done when:** each primary flow has line in `Checked`; violations are findings.
|
|
112
|
+
- [ ] **Step 11 — Sessions:** Screenshot review ≠ user evidence. Every second run: same scripted tasks with real people — five participants from segments `Project Instructions` name; think-aloud; one script in `Sessions` for next round. Per task: success (unaided, with help, failed), time on task, Single Ease Question. Per session: SUS or UMUX-Lite — pick one, keep it. Each figure beside previous session. No participants → last round's date and next due; do not invent figures. **Done when:** `Sessions` holds figures beside previous session, or next due date.
|
|
113
|
+
- [ ] **Step 12 — AI Features:** Each user-visible result feature vs human-AI guidelines — user sees what it did and why; each extracted field correctable, each created item undoable; low-confidence flagged, not silently saved; failure says what happened and next step (Step 9 point 6 covers first). Screen already does this, fault is model output → `bkit-audit-llm`. **Done when:** `AI Features` row per feature: guideline · what the user sees · verdict.
|
|
114
|
+
- [ ] **Step 13 — Errors:** Trigger every validation and server error on primary forms — each says what happened and how to fix, plain language, next to field. Input survives failed submit, offline mid-form, session expiry. Every destructive action: undo or confirmation, same on every platform, not most prominent when drawing shows otherwise. **Done when:** `Errors` row per form and per destructive action.
|
|
115
|
+
- [ ] **Step 14 — Dates:** Product with dates, times, or recurrence → accounts in different locales and timezones. Date format, first day of week, and 12- or 24-hour time follow the locale. Members in different timezones: which timezone each sees, whether app says so when they differ. Event crossing daylight-saving change keeps wall-clock time. Editing recurring event: choice (this event, this and following, all events) clear, each does what it says. No dates → skip with evidence. **Done when:** `Dates` holds answers, or skip recorded.
|
|
116
|
+
- [ ] **Step 15 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per Nielsen heuristic, ISO 9241-110 interaction principle, HAX guideline → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
|
|
117
|
+
- [ ] **Step 16 — Anything Else:** (a) Everything changed since previous report's commit touching usability (screens and routes, shared components, drawings, copy, emails, notifications, plan gates, AI-produced results) → one-line verdict each. (b) Bounded ~30 min pass: what senior UX researcher flags that no step asks; read since previous run (incidents, new `docs/failures.jsonl` rows) — 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`.
|
|
118
|
+
|
|
119
|
+
### 🔒 Gate 2: Probes Check
|
|
120
|
+
|
|
121
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
|
|
122
|
+
|
|
123
|
+
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
124
|
+
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
125
|
+
- [ ] **Canary isolated:** seeded copies are not product shots in this report, and were not written into the app.
|
|
126
|
+
- [ ] **Pipeline ruled out:** no finding is OS chrome, the region below a cut drawing, or a blocked native cell.
|
|
127
|
+
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
128
|
+
|
|
129
|
+
## Findings
|
|
130
|
+
|
|
131
|
+
<!-- prettier-ignore -->
|
|
132
|
+
| Severity | Use |
|
|
133
|
+
| --- | --- |
|
|
134
|
+
| `CRITICAL` | Broken primary flow with no workaround; typed input or a record lost with no recovery; destructive action with no undo that loses data |
|
|
135
|
+
| `HIGH` | User cannot finish a task, and a workaround exists; empty first screen with no next step; destructive confirmation missing on one platform |
|
|
136
|
+
| `MEDIUM` | Screen ≠ drawing, the drawing is right, and it stops nobody; error text that does not say how to fix it; wrong locale format; one concept named two ways |
|
|
137
|
+
| `LOW` | Cosmetic mismatch; region below a cut drawing reported as missing and then corrected to not-reached |
|
|
138
|
+
|
|
139
|
+
Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked tasks first. Set bucket from frequency (how many users meet it), impact (whether they can get past it), persistence (whether it bothers them every time). Task user cannot finish = `HIGH`, or `CRITICAL` with no workaround. Drawing mismatch that stops nobody = `MEDIUM` or `LOW`.
|
|
140
|
+
|
|
141
|
+
<!-- prettier-ignore -->
|
|
142
|
+
| ID | Severity | Location | Evidence | Expected |
|
|
143
|
+
| --- | --- | --- | --- | --- |
|
|
144
|
+
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
145
|
+
|
|
146
|
+
Empty and clean → one row `None`.
|
|
147
|
+
|
|
148
|
+
## Report
|
|
149
|
+
|
|
150
|
+
### Summary
|
|
151
|
+
|
|
152
|
+
PENDING
|
|
153
|
+
|
|
154
|
+
### Previous Run
|
|
155
|
+
|
|
156
|
+
PENDING
|
|
157
|
+
|
|
158
|
+
### Signals
|
|
159
|
+
|
|
160
|
+
PENDING
|
|
161
|
+
|
|
162
|
+
### Capture
|
|
163
|
+
|
|
164
|
+
PENDING
|
|
165
|
+
|
|
166
|
+
### Gaps
|
|
167
|
+
|
|
168
|
+
PENDING
|
|
169
|
+
|
|
170
|
+
### Inventory
|
|
171
|
+
|
|
172
|
+
PENDING
|
|
173
|
+
|
|
174
|
+
### Canary
|
|
175
|
+
|
|
176
|
+
PENDING
|
|
177
|
+
|
|
178
|
+
### Hand Checks
|
|
179
|
+
|
|
180
|
+
PENDING
|
|
181
|
+
|
|
182
|
+
### First Run
|
|
183
|
+
|
|
184
|
+
PENDING
|
|
185
|
+
|
|
186
|
+
### Sessions
|
|
187
|
+
|
|
188
|
+
PENDING
|
|
189
|
+
|
|
190
|
+
### AI Features
|
|
191
|
+
|
|
192
|
+
PENDING
|
|
193
|
+
|
|
194
|
+
### Errors
|
|
195
|
+
|
|
196
|
+
PENDING
|
|
197
|
+
|
|
198
|
+
### Dates
|
|
199
|
+
|
|
200
|
+
PENDING
|
|
201
|
+
|
|
202
|
+
### Checked
|
|
203
|
+
|
|
204
|
+
PENDING
|
|
205
|
+
|
|
206
|
+
### Not Checked
|
|
207
|
+
|
|
208
|
+
PENDING
|
|
209
|
+
|
|
210
|
+
### Standards Coverage
|
|
211
|
+
|
|
212
|
+
PENDING
|
|
213
|
+
|
|
214
|
+
### Beyond the Steps
|
|
215
|
+
|
|
216
|
+
PENDING
|
|
217
|
+
|
|
218
|
+
### Process Improvements
|
|
219
|
+
|
|
220
|
+
PENDING
|
|
221
|
+
|
|
222
|
+
### 🔒 Gate 3: Report Check
|
|
223
|
+
|
|
224
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then stop.
|
|
225
|
+
|
|
226
|
+
- [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
|
|
227
|
+
- [ ] **Summary:** names count per severity, cells captured vs blocked per platform, and the canary hit rate.
|
|
228
|
+
- [ ] **Series:** every series beside previous report's numbers, or marked baseline.
|
|
229
|
+
- [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
|
|
230
|
+
- [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
|
|
231
|
+
- [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
|
|
232
|
+
|
|
233
|
+
> `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.
|
|
234
|
+
|
|
235
|
+
<!-- bkit:end -->
|
|
236
|
+
|
|
237
|
+
## Project Instructions
|