@cbartens/bkit 0.0.0-stage → 5.0.1
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 +417 -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 +417 -0
- package/.bkit/core/.bkit/cloud.md +493 -0
- package/.bkit/core/.bkit/comparison.md +321 -0
- package/.bkit/core/.bkit/install.md +401 -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 +470 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1550 -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 +149 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +530 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/suppression.ts +53 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +187 -0
- package/.bkit/core/engine/checks/before/files.ts +204 -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 +867 -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 +254 -0
- package/.bkit/core/engine/commands/install/install.ts +550 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +495 -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 +924 -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 +173 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +620 -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/payload-links.ts +150 -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 +649 -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 +86 -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 +433 -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 +97 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -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 +224 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -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 +1503 -0
- package/LICENSE.md +161 -0
- package/README.md +184 -2
- package/dist/checks/after/auth.js +140 -0
- package/dist/checks/after/ci-yml.js +681 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +431 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/suppression.js +39 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +163 -0
- package/dist/checks/before/files.js +187 -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 +688 -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 +209 -0
- package/dist/commands/install/install.js +475 -0
- package/dist/commands/install/uninstall.js +839 -0
- package/dist/commands/install/upgrade.js +782 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +363 -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 +818 -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 +151 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +531 -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/payload-links.js +119 -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,230 @@
|
|
|
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
|
+
# Annotations Triage
|
|
8
|
+
|
|
9
|
+
> [!CAUTION]
|
|
10
|
+
> **Purpose:** Triage CI annotations and warnings beside a green result — silent failures, deprecations with a deadline, and lint warnings including a suppression on the wrong node.
|
|
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 edit a workflow, composite action, or other CI config; a recommended change is a finding for a human.
|
|
23
|
+
> - NEVER dispatch a workflow, push, or otherwise start a run to verify a fix.
|
|
24
|
+
|
|
25
|
+
## Universal Instructions
|
|
26
|
+
|
|
27
|
+
### Context & Goals
|
|
28
|
+
|
|
29
|
+
Green CI hides costly warnings. Two failure modes: step success while the operation was refused, skipped, or ignored (annotation was the only signal); deprecation with a deadline stays green until runtime/API removal — CI red on a date nobody chose.
|
|
30
|
+
|
|
31
|
+
**Applies when:** CI emits annotations, warnings, or notices (e.g. GitHub Actions check-run annotations, GitLab code-quality reports, Buildkite annotations). None → one `N/A` row with evidence, never "clean".
|
|
32
|
+
|
|
33
|
+
**Cadence:** weekly, and before every release to the production branch. In-passing sweeps are not a control. Extra pass when: CI-vendor deprecation/retirement post or runner-image announcement touches these workflows; workflow, composite action, or reusable workflow changes (conditional lane annotates only when it runs); deprecation deadline before next weekly sweep.
|
|
34
|
+
|
|
35
|
+
**Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
|
|
36
|
+
|
|
37
|
+
- CI vendor changelog, deprecation, and retirement posts (e.g. GitHub Changelog deprecation label). Living; record the date read.
|
|
38
|
+
- Runner-image announcements (e.g. `actions/runner-images` Announcement label). Living; record the date read.
|
|
39
|
+
- Workflow command reference, including deprecated commands (e.g. GitHub `set-output`, `save-state`, `set-env`, `add-path`).
|
|
40
|
+
- Problem matchers and annotation limits (e.g. `actions/toolkit` problem matchers; per-step and per-job caps).
|
|
41
|
+
- Workflow static analysers (e.g. actionlint, zizmor); record versions.
|
|
42
|
+
- Deprecated-API lint (e.g. typescript-eslint `no-deprecated`); record the version in the lockfile.
|
|
43
|
+
|
|
44
|
+
### Scope
|
|
45
|
+
|
|
46
|
+
- Annotations and notices on recent runs of every workflow, including scheduled, manual, and bot-triggered. Not one pipeline.
|
|
47
|
+
- Deprecation notices in the vendor changelog before they annotate.
|
|
48
|
+
- Action and runtime inventory, including leftover opt-out env keys.
|
|
49
|
+
- Log lines that never become annotations (deprecations, outdated CLIs).
|
|
50
|
+
- Workflow static analysis, and deprecated workflow commands a conditional lane hides.
|
|
51
|
+
- One verdict per annotation. Root cause for each silent failure.
|
|
52
|
+
- Which node a lint warning actually trips. Problem matchers so lint output becomes annotations.
|
|
53
|
+
- What was verified locally, and what still needs a real run.
|
|
54
|
+
|
|
55
|
+
### Out of Scope
|
|
56
|
+
|
|
57
|
+
<!-- prettier-ignore -->
|
|
58
|
+
| Excluded item | Why | Where it belongs |
|
|
59
|
+
| --- | --- | --- |
|
|
60
|
+
| Runtime errors, and log lines that are not annotations or deprecation warnings | Log sweep | `bkit-audit-logs` |
|
|
61
|
+
| Flaky tests | Flake sweep | `bkit-audit-flakes` |
|
|
62
|
+
| Whether a static-analysis hit is exploitable | Security sweep | `bkit-audit-security` |
|
|
63
|
+
| Applying fixes / changing workflows | Audit reports only | Plan from this report |
|
|
64
|
+
|
|
65
|
+
### Verdicts
|
|
66
|
+
|
|
67
|
+
One per annotation. **SILENT FAILURE** outranks every other verdict.
|
|
68
|
+
|
|
69
|
+
- **SILENT FAILURE:** step reported success, but annotation says operation was refused, skipped, or ignored. Report names root cause. Fix is next step.
|
|
70
|
+
- **DEPRECATION:** action, runtime, or API with announced end date. Report names date and bump. Scheduling is next step.
|
|
71
|
+
- **LINT WARNING:** real warning pointing at code. Report says fix, or why it stands. Do not edit the code here.
|
|
72
|
+
- **DEAD SUPPRESSION:** disable comment with nothing left to disable. Report says delete it, and whether it sat on the wrong node. Do not delete it here.
|
|
73
|
+
- **ACCEPTED:** known, and already recorded. Say where, and skip.
|
|
74
|
+
- **OTHER:** fits none. Resolve to one of the above if you can; otherwise say what it is and why it fits none. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
|
|
75
|
+
|
|
76
|
+
### Pre-Flight / Dependencies
|
|
77
|
+
|
|
78
|
+
**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.
|
|
79
|
+
|
|
80
|
+
#### Core
|
|
81
|
+
|
|
82
|
+
Always verify.
|
|
83
|
+
|
|
84
|
+
- [ ] **CI Read:** Steps 2, 5, 11 — annotations and step logs for recent runs of every workflow, e.g. `gh api` check-run annotations, `gh run view --log`, GitLab job-trace API. Fallback: saved logs; runs not fetched `Not Checked`.
|
|
85
|
+
- [ ] **Workflow Files:** Steps 4, 6, 8 — workflows, composite actions, reusable workflows on disk. Fallback: none.
|
|
86
|
+
- [ ] **Web:** Steps 3, 12 — vendor changelog, runner-image announcements, anchor standards. Fallback: versions recorded as unread.
|
|
87
|
+
|
|
88
|
+
#### Conditional
|
|
89
|
+
|
|
90
|
+
Verify only when applicable.
|
|
91
|
+
|
|
92
|
+
- [ ] **Workflow Linters:** Workflows on disk → Step 6 — e.g. actionlint, zizmor, shellcheck. Fallback: read the workflows; name each check skipped.
|
|
93
|
+
- [ ] **Language Server:** Typed language and a lint annotation → Step 9 — per-file diagnostics, e.g. Serena, `tsserver`. Fallback: lint that file; say so. Empty is inconclusive; corroborate with text search.
|
|
94
|
+
- [ ] **Deprecated-API Lint:** Typed language → Step 10 — e.g. `@typescript-eslint/no-deprecated`. Fallback: text search for known deprecated calls; under-count recorded.
|
|
95
|
+
|
|
96
|
+
### 🔒 Gate 1: Prerequisites Check
|
|
97
|
+
|
|
98
|
+
**Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
|
|
99
|
+
|
|
100
|
+
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
101
|
+
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
102
|
+
|
|
103
|
+
### Probe Steps
|
|
104
|
+
|
|
105
|
+
- [ ] **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.
|
|
106
|
+
- [ ] **Step 2 — Collect:** No CI → one `N/A` row with evidence and STOP. Else read annotation lists for recent runs of every workflow, not last run of one pipeline. Deprecations surface on whichever workflow uses the old action. Include scheduled, manual, and bot-triggered runs. Collect mechanically, not by eye from the UI. Window = since previous report, and at least latest completed run of each workflow. Save list; diff vs previous report: new, resolved, persisting. Annotations capped (e.g. GitHub: 10 warnings, 10 errors, and 10 notices per step, and 50 per job). Step at cap → grep raw job log for warning and error markers; triage overflow. Record run ids and commit. Id, run, or path you cannot re-open → do not cite it. **Done when:** `Annotations` holds diff (new, resolved, persisting) and run ids.
|
|
107
|
+
- [ ] **Step 3 — Deprecations:** Read vendor deprecation/retirement posts and runner-image announcements since previous report. List every dated change touching these workflows: runtimes, runner images, events, actions. Changelog notice precedes run notice. Each → DEPRECATION with date and bump. Dependency bot already tracks bump → say so; schedule rest next step. **Done when:** `Deprecations` row per dated change: what · date · bump · bot already tracking?
|
|
108
|
+
- [ ] **Step 4 — Runtimes:** Every `uses:` (or the CI system's equivalent) in workflows, local composite actions, and reusable workflows — resolved version and declared runtime (e.g. `runs.using`). Action declaring removed runtime (e.g. `node20` after runners dropped it) runs on forced runtime with no opt-out → finding, unless seen working there. List leftover opt-out env keys that no longer change anything. **Done when:** `Runtimes` row per action: version · declared runtime · verdict, plus leftover keys.
|
|
109
|
+
- [ ] **Step 5 — Log Warnings:** Some deprecations print only to log. Grep same runs' step logs for deprecation markers (e.g. `DeprecationWarning`, `[DEP0`, `npm warn deprecated`, `WARN deprecated`, `will be removed`) and CLI outdated notices (e.g. EAS, Expo, Vercel). Verdict each as if annotation. Agree with `bkit-audit-logs` which sweep owns each line — triage once. **Done when:** `Log Warnings` row per line: verdict or owning sweep.
|
|
110
|
+
- [ ] **Step 6 — Static Analysis:** Run workflow linters every sweep, not only to verify a fix. Each new finding = annotation: shell issues in `run:` blocks, expression typos, template injection, excessive permissions, unpinned `uses:`. Grep workflows/scripts for deprecated workflow commands (e.g. GitHub Actions `::set-output`, `::save-state`, `::set-env`, `::add-path`) and opt-in re-enabling them (e.g. `ACTIONS_ALLOW_UNSECURE_COMMANDS`). Runner warns on some only at execute — conditional lane hides them. **Done when:** `Static Analysis` row per finding with verdict.
|
|
111
|
+
- [ ] **Step 7 — Classify:** One verdict each from `Verdicts`. SILENT FAILURE on sight, e.g. GitHub `Unexpected input(s) '…', valid inputs are …` (misspelled input key, ignored); `No files were found with the provided path` (artifact never uploaded). No forced fit → OTHER. Destinations (next step; this run does not send): real defect → `docs/failures.jsonl` row to append (`@bkit-utility-update-failures` applies); SILENT FAILURE → root cause, fix, guard (`Silent Failures`); DEPRECATION → date and bump, dependency bot first; LINT WARNING → fix or why it stands; DEAD SUPPRESSION → delete directive, wrong-node flag; flake → `bkit-audit-flakes`; runtime error or log-sweep line → `bkit-audit-logs`; standing rule → sentence for testing or deployments doc; workflow change → recommendation needing explicit human confirmation; ACCEPTED → nothing, cite record. **Done when:** every annotation in `Annotations` has verdict and destination.
|
|
112
|
+
- [ ] **Step 8 — Silent Failures:** Root-cause each SILENT FAILURE vs runner rules. Annotation = platform vocabulary symptom. Examples (GitHub Actions): `$GITHUB_ENV` blocklists some names (`NODE_OPTIONS` among them) — set as static job-level `env:` keys; `env` context unavailable to job-level `env:` value → shortened form resolves empty, fails quiet; step-level `env:` replaces job-level map (no merge) — overriding one key restates others; managed blocks revert in-marker edits — check key inside managed marker before recommending move. Other CI → equivalent (masked variables, non-merging env, platform-rewritten config). Report names guard fix should carry, proven red by reintroducing bug; where deleting mechanism leaves lane quiet and knob-less → second guard that replacement knob exists. Writing fix = next step. **Done when:** `Silent Failures` names root cause, fix, guard for each.
|
|
113
|
+
- [ ] **Step 9 — Lint Node:** Lint annotation or in-code suppression → node rule fires on; count change if directive removed. Reason from per-file diagnostics; do not edit; do not whole-repo typecheck/lint for one file. Language server = one language; workflow files = text search. Dead disable at annotation line with effect further down (comment only) → DEAD SUPPRESSION on wrong node (live rule = LINT WARNING). **Done when:** `Lint` row per warning: node · directive · verdict.
|
|
114
|
+
- [ ] **Step 10 — Matchers:** Problem matchers or annotation reporters for typecheck, lint, test output in CI (e.g. `tsc`, ESLint, Vitest). Without them warnings stay in logs — LINT WARNING under-counted. Confirm deprecated-API lint enabled (e.g. `@typescript-eslint/no-deprecated`). Deprecated framework API calls = code-side same deadline. **Done when:** `Matchers` names each reporter and deprecated-API rule: present or absent.
|
|
115
|
+
- [ ] **Step 11 — Verified:** Green run does not verify fix to conditional lane. Marker-gated lane needs run carrying marker — deliberate workflow dispatch, not push. State local verification (workflow linters, YAML parse, guard tests, per-file diagnostics) vs still needs real run. Do not dispatch. **Done when:** `Verified` splits local vs still needs a run.
|
|
116
|
+
- [ ] **Step 12 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: row per deprecation/retirement announcement in window, deprecated workflow command, linter check class → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
|
|
117
|
+
- [ ] **Step 13 — Anything Else:** (a) Everything changed since previous report's commit touching CI signal (workflows, composite actions, reusable workflows, `uses:` pins, runner images, workflow and step `env:` keys, lint config) → one-line verdict each. (b) Bounded ~30 min pass: what senior CI platform engineer flags that no step asks; read since previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
|
|
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
|
+
- [ ] **Workflows untouched:** no workflow, composite action, or CI config edited.
|
|
126
|
+
- [ ] **No dispatch:** no workflow run triggered, and no push.
|
|
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` | Step reported success while a required operation was refused, skipped, or ignored, and no other check fails |
|
|
135
|
+
| `HIGH` | Deprecation whose deadline falls before the next release, or an action on a runtime the runners removed; suppression on the wrong node so the intended rule still fires |
|
|
136
|
+
| `MEDIUM` | Lint warning that points at code; deprecation with a deadline still after the next release; dead suppression; static-analysis finding that is not itself a silent failure |
|
|
137
|
+
| `LOW` | Leftover env key that changes nothing; accepted annotation with no written record; cosmetic notice |
|
|
138
|
+
|
|
139
|
+
Scale per `.bkit/jsonl.md` § Severity. Within a severity: silent failures first.
|
|
140
|
+
|
|
141
|
+
<!-- prettier-ignore -->
|
|
142
|
+
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
143
|
+
| --- | --- | --- | --- | --- | --- |
|
|
144
|
+
| PENDING | 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
|
+
### Annotations
|
|
159
|
+
|
|
160
|
+
PENDING
|
|
161
|
+
|
|
162
|
+
### Deprecations
|
|
163
|
+
|
|
164
|
+
PENDING
|
|
165
|
+
|
|
166
|
+
### Runtimes
|
|
167
|
+
|
|
168
|
+
PENDING
|
|
169
|
+
|
|
170
|
+
### Log Warnings
|
|
171
|
+
|
|
172
|
+
PENDING
|
|
173
|
+
|
|
174
|
+
### Static Analysis
|
|
175
|
+
|
|
176
|
+
PENDING
|
|
177
|
+
|
|
178
|
+
### Silent Failures
|
|
179
|
+
|
|
180
|
+
PENDING
|
|
181
|
+
|
|
182
|
+
### Lint
|
|
183
|
+
|
|
184
|
+
PENDING
|
|
185
|
+
|
|
186
|
+
### Matchers
|
|
187
|
+
|
|
188
|
+
PENDING
|
|
189
|
+
|
|
190
|
+
### Verified
|
|
191
|
+
|
|
192
|
+
PENDING
|
|
193
|
+
|
|
194
|
+
### Checked
|
|
195
|
+
|
|
196
|
+
PENDING
|
|
197
|
+
|
|
198
|
+
### Not Checked
|
|
199
|
+
|
|
200
|
+
PENDING
|
|
201
|
+
|
|
202
|
+
### Standards Coverage
|
|
203
|
+
|
|
204
|
+
PENDING
|
|
205
|
+
|
|
206
|
+
### Beyond the Steps
|
|
207
|
+
|
|
208
|
+
PENDING
|
|
209
|
+
|
|
210
|
+
### Process Improvements
|
|
211
|
+
|
|
212
|
+
PENDING
|
|
213
|
+
|
|
214
|
+
### 🔒 Gate 3: Report Check
|
|
215
|
+
|
|
216
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then stop.
|
|
217
|
+
|
|
218
|
+
- [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
|
|
219
|
+
- [ ] **Summary:** names count per severity and the runs read.
|
|
220
|
+
- [ ] **Series:** new / resolved / persisting counts beside previous report's, or marked baseline.
|
|
221
|
+
- [ ] **Verified:** states what was checked locally and what still needs a real run.
|
|
222
|
+
- [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
|
|
223
|
+
- [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
|
|
224
|
+
- [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
|
|
225
|
+
|
|
226
|
+
> `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.
|
|
227
|
+
|
|
228
|
+
<!-- bkit:end -->
|
|
229
|
+
|
|
230
|
+
## Project Instructions
|
|
@@ -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
|
+
# App Performance Audit
|
|
8
|
+
|
|
9
|
+
> [!CAUTION]
|
|
10
|
+
> **Purpose:** Reproducible field, lab, and source baseline of web, native, and server performance, judged against published thresholds and budgets.
|
|
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 change sampling rates, dashboards, or project settings to take a measurement; a gap = finding.
|
|
23
|
+
> - Every figure names environment, window, percentile, and `n`.
|
|
24
|
+
|
|
25
|
+
## Universal Instructions
|
|
26
|
+
|
|
27
|
+
### Context & Goals
|
|
28
|
+
|
|
29
|
+
Performance numbers only matter beside the prior number, same method; unfixed method → worthless delta. Target failure: **baseline measures instrument or harness, not app** — e.g. field data all CI / preview (cold functions, no warm cache, no CDN, robot browser: waterfall shape transfers, absolute times do not); preview overlay adding seconds per pageload; vital never collected reading fine. Fix measurement before measuring; instrument findings outrank app findings.
|
|
30
|
+
|
|
31
|
+
**Applies when:** web app, native app, or server answering user requests. None → one `N/A` row with evidence, never "clean".
|
|
32
|
+
|
|
33
|
+
**Cadence:** quarterly. Extra pass when production first gets real traffic, after instrument fixes (`Re-baseline`), or network-shape change (region pin, prefetch policy, server-data seeding). Changed sampling, dashboards, window, or percentile → new baseline; run one then.
|
|
34
|
+
|
|
35
|
+
**Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
|
|
36
|
+
|
|
37
|
+
- Core Web Vitals (LCP, INP, CLS at p75, mobile, and desktop apart) and supporting FCP, TTFB (e.g. web.dev); check its changelog.
|
|
38
|
+
- Field dataset (e.g. Chrome UX Report, PageSpeed Insights).
|
|
39
|
+
- Lab method (e.g. Lighthouse, WebPageTest); record tool version.
|
|
40
|
+
- Long Animation Frames API.
|
|
41
|
+
- Soft Navigations API; record browser version shipping it by default.
|
|
42
|
+
- Framework production checklist, edition = version the app runs (e.g. Next.js, Nuxt).
|
|
43
|
+
- Platform native vitals (e.g. Android vitals, Xcode Organizer metrics).
|
|
44
|
+
- Monitoring vendor's mobile vitals docs (e.g. Sentry Mobile Vitals, Datadog RUM mobile).
|
|
45
|
+
|
|
46
|
+
### Scope
|
|
47
|
+
|
|
48
|
+
- Instrument health: collected metrics, sample sizes, environment split, pollution.
|
|
49
|
+
- Field and lab baselines per web route, native screen, and client-side navigation; production field data.
|
|
50
|
+
- Store and device native vitals; budgets.
|
|
51
|
+
- Waterfalls and static causes: bundle, media, render-blocking, start-up, rendering / caching, third parties, back/forward cache, prefetch, native size.
|
|
52
|
+
- Slow interactions; async user-facing pipelines; server, DB, background-job, and LLM latency; long sessions.
|
|
53
|
+
- Follow-ups closed since previous report.
|
|
54
|
+
|
|
55
|
+
### Out of Scope
|
|
56
|
+
|
|
57
|
+
<!-- prettier-ignore -->
|
|
58
|
+
| Excluded item | Why | Where it belongs |
|
|
59
|
+
| --- | --- | --- |
|
|
60
|
+
| Crawling, metadata, structured data | Search sweep; page speed stays here | `bkit-audit-aio-seo` |
|
|
61
|
+
| Query plans, indexes, vacuum, pool sizing | Database sweep | `bkit-audit-database` |
|
|
62
|
+
| Prompt quality | Prompt sweep; latency stays here | `bkit-audit-prompts` |
|
|
63
|
+
| Model choice | Model sweep; latency stays here | `bkit-audit-models` |
|
|
64
|
+
| LLM spend | Cost sweep; latency stays here | `bkit-audit-cost` |
|
|
65
|
+
| Third-party tag payloads, consent | Tracking sweep; main-thread cost stays here | `bkit-audit-analytics` |
|
|
66
|
+
| Module structure, coupling | Architecture sweep; method reused here | `bkit-audit-architecture` |
|
|
67
|
+
| CI pipeline duration | CI sweep | `bkit-audit-ci-performance` |
|
|
68
|
+
| Applying fixes / changing sampling or dashboards | Audit reports only | Plan from this report |
|
|
69
|
+
|
|
70
|
+
### Pre-Flight / Dependencies
|
|
71
|
+
|
|
72
|
+
**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.
|
|
73
|
+
|
|
74
|
+
#### Core
|
|
75
|
+
|
|
76
|
+
Always verify.
|
|
77
|
+
|
|
78
|
+
- [ ] **Monitoring:** Steps 2–4, 6, 9, 11–13, 15 — field traces, vitals, spans per environment, e.g. Sentry, Datadog RUM, New Relic. Fallback: lab and static only; field rows `Not Checked`.
|
|
79
|
+
- [ ] **Build Output:** Steps 8, 10 — production build with per-route size and render mode, e.g. `next build`, `vite build` with bundle analyser. Fallback: source read only; sizes `Not Checked`.
|
|
80
|
+
- [ ] **Web:** Steps 4, 17 — fetch anchor standards and published thresholds. Fallback: versions and thresholds recorded as unread.
|
|
81
|
+
|
|
82
|
+
#### Conditional
|
|
83
|
+
|
|
84
|
+
Verify only when applicable.
|
|
85
|
+
|
|
86
|
+
- [ ] **Lab Runner:** Deployed web app → Steps 5, 10 — e.g. Lighthouse CI, WebPageTest; record version and profile. Fallback: none; `Lab Baseline` `Not Checked`.
|
|
87
|
+
- [ ] **Browser DevTools:** Web app → Steps 10, 11, 14 — back/forward cache, Long Animation Frames, heap snapshots, e.g. Chrome DevTools, Playwright over CDP. Fallback: those rows `Not Checked`.
|
|
88
|
+
- [ ] **Field Dataset:** Production origin with traffic → Step 6 — e.g. CrUX via PageSpeed Insights, search console Core Web Vitals report. Fallback: monitoring production rows only.
|
|
89
|
+
- [ ] **Store Consoles:** Published native app → Step 7 — e.g. Play Console Android vitals, Xcode Organizer, App Store Connect sizes. Fallback: `not published`, or `Not Checked`.
|
|
90
|
+
- [ ] **Low-End Device:** Native app → Step 7 — physical low-end device per platform shipped (e.g. budget Android, oldest supported iPhone). Fallback: none; device rows `Not Checked`.
|
|
91
|
+
- [ ] **Language Server:** Typed language → Step 9 — references, e.g. Serena, `tsserver`, `pyright`. Fallback: text search only; name it per finding.
|
|
92
|
+
- [ ] **Code Graph:** Structural questions → Steps 9, 10 — module fan-out and cold-start graph, method per `bkit-audit-architecture`. Fallback: language server and text search; local-only tool missing in cloud → say so.
|
|
93
|
+
- [ ] **Platform Settings:** Hosted platform → Steps 3, 10 — preview overlays, region, CDN cache hit ratio, e.g. Vercel, Netlify, Cloudflare dashboard / API. Fallback: response headers only; settings `Not Checked`.
|
|
94
|
+
- [ ] **DB Statistics:** Hosted DB → Step 13 — e.g. `pg_stat_statements`, platform performance advisor. Fallback: monitoring spans only.
|
|
95
|
+
- [ ] **Job Runner:** Background jobs → Steps 12, 13 — run timings and queue lag, e.g. Inngest, Temporal, Sidekiq. Fallback: monitoring spans only.
|
|
96
|
+
- [ ] **Tracker:** Follow-ups from previous reports → Step 16 — e.g. `gh`, Linear MCP. Fallback: `Closed Follow-Ups` `Not Checked`.
|
|
97
|
+
|
|
98
|
+
### 🔒 Gate 1: Prerequisites Check
|
|
99
|
+
|
|
100
|
+
**Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
|
|
101
|
+
|
|
102
|
+
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
103
|
+
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
104
|
+
|
|
105
|
+
### Probe Steps
|
|
106
|
+
|
|
107
|
+
- [ ] **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.
|
|
108
|
+
- [ ] **Step 2 — Measurement Basis:** Record dashboards (IDs, owned vs vendor-prebuilt — prebuilt = not editable), exact query per table; window, percentile, `n` per row; environment split plain, production count even when 0; one linked reference trace. Window or percentile ≠ previous report → new baseline, not comparison. **Done when:** all in `Measurement Basis`.
|
|
109
|
+
- [ ] **Step 3 — Instrument:** Confirm before trusting; state each result — missing metric reads fine otherwise. Preview deploys (if any) with injected overlays (e.g. toolbars, comment widgets) → off at project level, else pageloads carry their requests. Every vital collected (INP `null` every route = gap). Native screen transactions and frame tracking; warm start slower than cold = untrustworthy dataset. `n` per row large enough (few hundred events on one transaction ≠ baseline). Client-side navigations measured: navigation transactions, LCP / INP after soft navigation. Fallback / degraded-path rate measured, or named blind spot. Field data CI / preview only → shape transfers, absolute times do not; say so. Each failure = finding, outranks app — until instrument honest, no fix provable. **Done when:** `Instrument` line per check.
|
|
110
|
+
- [ ] **Step 4 — Field Baseline:** One table per surface, p75, ordered by load count. Web per route: LCP, INP, CLS, FCP, TTFB. Native per screen: cold / warm start, time to initial / full display, slow / frozen frames. Uncollected → `not collected`, never blank. Verdict per p75 good / needs improvement / poor vs source thresholds; mobile and desktop split; read thresholds each run, never memory; write in table header. Plus navigation table: navigation transactions per route; LCP / INP after soft navigation where reported. **Done when:** every row has verdict or `not collected` in `Field Baseline`.
|
|
111
|
+
- [ ] **Step 5 — Lab Baseline:** Field data CI / preview → lab = reproducible number. Lab runner on production, never preview, on `Field Baseline` web routes: fixed throttling (mid-tier mobile, slow 4G), 5 runs per route, median. Record tool version and profile; change to either → new series. Lab cannot measure INP → Total Blocking Time stand-in. Keep third-party summary for `Static`. **Done when:** series per route in `Lab Baseline`.
|
|
112
|
+
- [ ] **Step 6 — Production:** Production users → their numbers count. Production sampling ~1,000 events per route per window; record production `n` per route. Field dataset (e.g. CrUX via PageSpeed Insights) for production origin once qualified; search console Core Web Vitals report (shared with `bkit-audit-aio-seo`). No production traffic → `no production traffic`, never omit. **Done when:** `Production` holds `n` per route and field-dataset rows, or `no production traffic`.
|
|
113
|
+
- [ ] **Step 7 — Native Vitals:** Native app → read beyond monitoring SDK. Android store vitals: slow cold / warm starts, slow / frozen frames, ANR rate, excessive partial wake locks (store visibility). iOS organizer: launch time, hang rate, energy. Low-end device: memory over primary flow; OTA update layer on cold start, if shipped (e.g. `expo-updates`, CodePush). Not in stores → `not published` for store rows. **Done when:** `Native Vitals` row per metric, or `not published`.
|
|
114
|
+
- [ ] **Step 8 — Budgets:** Delta vs previous says moved, not good enough → report delta vs budget: per-route shipped client code (e.g. first-load JS, gzipped), LCP and INP targets per route, native bundle / binary size, bundle size cap. Unset budget → propose from this run; owner decides. **Done when:** `Budgets` row per budget: target · actual · delta, or proposed target.
|
|
115
|
+
- [ ] **Step 9 — Waterfall:** Table says slow route; trace says why. Per worst route open reference trace; count: round trips, sequential vs concurrent (concurrent in codebase = model to copy); pageload requests for data one interaction needs; duplicate work (e.g. two nav components each prefetching every route); fixed floor under every call (primary-key lookup same cost as token validation = network toll, not slow query). Resolve where DB and functions run before query rewrite — region pin beats every rewrite. Several findings, one toll → one finding (six sequential calls, one toll ≠ six fixes). Language-server references on hook / fetcher → one call site or many; on shared client / helper → what else pays toll. Pace queries — back-to-back collapse to partial results, under-count shrinks blast radius; re-run small caller sets; config / JSON wiring = text search. Structural questions (hub module, cold-start graph) → code graph. Each finding carries explanation or links the one that has it. **Done when:** `Waterfall` row per worst route: round trips · shape · tolls · call sites · merged findings.
|
|
116
|
+
- [ ] **Step 10 — Static:** Baseline covers routes with traffic and collected metrics; source shows causes before run. Each item only where its surface (web, server, native) exists and the stack has the mechanism; else `N/A` with evidence:
|
|
117
|
+
- Client bundle: size per route from build output; heavy deps in client-side code (e.g. React client components); barrel imports dragging whole package. Record as series.
|
|
118
|
+
- Media: missing width / height (CLS), no lazy below fold, no responsive sizes.
|
|
119
|
+
- Render-blocking: synchronous third-party scripts; font loading.
|
|
120
|
+
- Server start-up: heavy top-level imports in route handlers / workers where lazy import keeps cold start off; intended cold-start splits not undone; code-graph fan-out finds candidates.
|
|
121
|
+
- Request-path blocking: synchronous file / crypto work; sequential awaits that could run concurrently.
|
|
122
|
+
- Native entry: top-level imports every cold start pays.
|
|
123
|
+
- Rendering / caching per route: rendering mode from build output, where the framework has one (e.g. Next.js static / dynamic / partially prerendered); unexpected dynamic (e.g. cookies / headers in layout); `Cache-Control`; CDN cache hit ratio; server-rendered payload on heaviest routes (e.g. React server-component payload).
|
|
124
|
+
- Third-party scripts: main-thread time and transfer per third party from `Lab Baseline` summary; each loads after interactive or later (e.g. `next/script` `afterInteractive`, Nuxt Scripts).
|
|
125
|
+
- Back/forward cache: main routes eligible (DevTools); `Cache-Control: no-store` on HTML, `unload` handlers, or open connections → full reload on back / forward.
|
|
126
|
+
- Prefetch: what each route prefetches (link prefetch, Speculation Rules) and usage.
|
|
127
|
+
- Native size: bytecode bundle (e.g. Hermes), store download / install size, long lists virtualised.
|
|
128
|
+
|
|
129
|
+
Risk signals, not measurements; confirm fixes with `Re-baseline`, not re-reading code. **Done when:** `Static` row per item; bundle series recorded.
|
|
130
|
+
|
|
131
|
+
- [ ] **Step 11 — Interactions:** Per route with INP: slowest interactions — Long Animation Frames attribution to script source, forced layout, hydration. Name worst (drag, popover open, picker, form submit). **Done when:** `Interactions` row per route: interaction · duration · attributed cause.
|
|
132
|
+
- [ ] **Step 12 — Async Paths:** Async user-facing pipelines → slowest path often absent from web vitals (e.g. inbound message → parsed → model extraction → visible → reply sent). Measure end to end, p50 / p95 per stage, from job-runner timings and monitoring spans; name longest stage. **Done when:** `Async Paths` stage table per pipeline, or none recorded.
|
|
133
|
+
- [ ] **Step 13 — Server Latency:** `Waterfall` only traced routes → read app-wide: p75 / p95 per server endpoint (e.g. server action, route handler, controller action, DB RPC) from spans; slow queries from DB statistics and platform advisor; background-job step durations and queue lag; LLM calls per model and call site — time to first token, total duration, timeouts, retries, user-facing calls stream or not. **Done when:** `Server Latency` tables per source.
|
|
134
|
+
- [ ] **Step 14 — Long Sessions:** Screens open hours (calendar, dashboard) → open each 30 min, heap snapshots; record memory growth, realtime subscription count, polling intervals. **Done when:** `Long Sessions` row per screen.
|
|
135
|
+
- [ ] **Step 15 — Re-baseline:** Instrument fixes since previous report → pre-fix baseline not reference; re-take `Field Baseline` and `Lab Baseline`; mark figures moved by instrument change, not app. **Done when:** moves marked in `Field Baseline`, or no instrument fix since previous report recorded.
|
|
136
|
+
- [ ] **Step 16 — Closed Follow-Ups:** Follow-ups from previous reports close with decisions only in threads. Read each closed since previous report; sort: A = not done, blocked on owner → named action and blocker; B = deliberately dropped, reasoning holds → recorded so nobody reopens; C = real work nobody owns → new tracker item or named home in scheduled work. Neither tracker nor scheduled work → `docs/deferrals.jsonl` row named. Comment on closed item ≠ register. **Done when:** `Closed Follow-Ups` row per item: group · destination.
|
|
137
|
+
- [ ] **Step 17 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per Core Web Vital and supporting web metric (LCP, INP, CLS, FCP, TTFB), Android vital, iOS organizer metric, framework production-checklist item → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
|
|
138
|
+
- [ ] **Step 18 — Anything Else:** (a) Everything changed since previous report's commit touching performance (routes and layouts, client-side code and dependencies, third-party scripts, server endpoints, DB queries and RPCs, background jobs, LLM call sites, region, and caching config, monitoring sampling, native app entry) → one-line verdict each. (b) Bounded ~30 min pass: what a senior performance engineer 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`.
|
|
139
|
+
|
|
140
|
+
### 🔒 Gate 2: Probes Check
|
|
141
|
+
|
|
142
|
+
**Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
|
|
143
|
+
|
|
144
|
+
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
145
|
+
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
146
|
+
- [ ] **Environments:** every figure names environment, window, percentile, and `n`.
|
|
147
|
+
- [ ] **Settings untouched:** no sampling rate, dashboard, or project setting changed.
|
|
148
|
+
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
149
|
+
|
|
150
|
+
## Findings
|
|
151
|
+
|
|
152
|
+
<!-- prettier-ignore -->
|
|
153
|
+
| Severity | Use |
|
|
154
|
+
| --- | --- |
|
|
155
|
+
| `CRITICAL` | User-facing path that times out or never completes; crash, ANR, or hang blocking a primary flow; long-session memory growth to crash |
|
|
156
|
+
| `HIGH` | Instrument gap or pollution invalidating the baseline; core vital `poor` on a primary route; budget exceeded; store-enforced vital over threshold; fixed network toll on every call; sequential waterfall on a primary route |
|
|
157
|
+
| `MEDIUM` | Vital `needs improvement`; duplicate or wasted prefetch; unexpected dynamic rendering; main route not back/forward-cache eligible; third party loading before interactive; slow query, job step, or LLM call off the primary path; unvirtualised long list |
|
|
158
|
+
| `LOW` | Static risk signal without measured impact; size drift within budget; series gap |
|
|
159
|
+
|
|
160
|
+
Scale per `.bkit/jsonl.md` § Severity. Within a severity: what unblocks the next measurement first — instrument / pollution, one-line config (region, project settings), contained client trims, decisions, or packages shared with native, needs local repro. Needs diagnosis before sizing → `Expected` says so.
|
|
161
|
+
|
|
162
|
+
<!-- prettier-ignore -->
|
|
163
|
+
| ID | Severity | Location | Evidence | Expected |
|
|
164
|
+
| --- | --- | --- | --- | --- |
|
|
165
|
+
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
166
|
+
|
|
167
|
+
Empty and clean → one row `None`.
|
|
168
|
+
|
|
169
|
+
## Report
|
|
170
|
+
|
|
171
|
+
### Summary
|
|
172
|
+
|
|
173
|
+
PENDING
|
|
174
|
+
|
|
175
|
+
### Previous Run
|
|
176
|
+
|
|
177
|
+
PENDING
|
|
178
|
+
|
|
179
|
+
### Measurement Basis
|
|
180
|
+
|
|
181
|
+
PENDING
|
|
182
|
+
|
|
183
|
+
### Instrument
|
|
184
|
+
|
|
185
|
+
PENDING
|
|
186
|
+
|
|
187
|
+
### Field Baseline
|
|
188
|
+
|
|
189
|
+
PENDING
|
|
190
|
+
|
|
191
|
+
### Lab Baseline
|
|
192
|
+
|
|
193
|
+
PENDING
|
|
194
|
+
|
|
195
|
+
### Production
|
|
196
|
+
|
|
197
|
+
PENDING
|
|
198
|
+
|
|
199
|
+
### Native Vitals
|
|
200
|
+
|
|
201
|
+
PENDING
|
|
202
|
+
|
|
203
|
+
### Budgets
|
|
204
|
+
|
|
205
|
+
PENDING
|
|
206
|
+
|
|
207
|
+
### Waterfall
|
|
208
|
+
|
|
209
|
+
PENDING
|
|
210
|
+
|
|
211
|
+
### Static
|
|
212
|
+
|
|
213
|
+
PENDING
|
|
214
|
+
|
|
215
|
+
### Interactions
|
|
216
|
+
|
|
217
|
+
PENDING
|
|
218
|
+
|
|
219
|
+
### Async Paths
|
|
220
|
+
|
|
221
|
+
PENDING
|
|
222
|
+
|
|
223
|
+
### Server Latency
|
|
224
|
+
|
|
225
|
+
PENDING
|
|
226
|
+
|
|
227
|
+
### Long Sessions
|
|
228
|
+
|
|
229
|
+
PENDING
|
|
230
|
+
|
|
231
|
+
### Closed Follow-Ups
|
|
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 count per severity, environments measured, and production `n`.
|
|
261
|
+
- [ ] **Series:** every series 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
|