@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,154 +1,151 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# AIO SEO Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:** Whether search engines and answer engines can find, read
|
|
10
|
+
> **Purpose:** Whether search engines and answer engines can find, read and correctly describe public pages.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - never change search-console, webmaster, robots, sitemap, IndexNow, or firewall settings; record the owner's decision.
|
|
23
|
-
> - Name a personal-data field and its page for `bkit-audit-privacy`; never copy a personal-data value into the report.
|
|
14
|
+
> - Do not change search-console, webmaster, robots, sitemap, IndexNow or firewall settings.
|
|
15
|
+
> - Record the owner's decision on the AI-crawler policy in `robots.txt` and on the search-console control for generative answers.
|
|
16
|
+
> - Name each personal-data field and its page for `bkit-audit-privacy`.
|
|
17
|
+
> - NEVER copy a personal-data value into the report.
|
|
24
18
|
|
|
25
19
|
## Universal Instructions
|
|
26
20
|
|
|
27
21
|
### Context & Goals
|
|
28
22
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
23
|
+
Search engines and answer engines read the same public pages. The failure this audit targets is a silent indexing fault that stops traffic while the site still works. Examples: `noindex` leaking from preview config, a canonical pointing at a preview URL, or a sitemap listing login-gated pages.
|
|
24
|
+
|
|
25
|
+
Search engines rank pages, and answer engines quote facts, so plain factual copy matters. An engine that ignores `llms.txt` still shares one index with its AI answers, so the indexing basics cover both.
|
|
32
26
|
|
|
33
|
-
**Applies when:** a web origin crawlers can request.
|
|
27
|
+
**Applies when:** there is a web origin crawlers can request. **If** there is none → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
34
28
|
|
|
35
|
-
**Cadence:**
|
|
29
|
+
**Cadence:** Run once a quarter. Run an extra pass when routing, locales or the public site change.
|
|
36
30
|
|
|
37
|
-
**Anchor Standards:**
|
|
31
|
+
**Anchor Standards:**
|
|
38
32
|
|
|
39
|
-
- Search essentials and the search-documentation updates log (e.g
|
|
40
|
-
- The engine's AI-features and generative-AI optimisation guides (e.g
|
|
41
|
-
- Search-console help, including the control for generative answers (e.g
|
|
42
|
-
- Index submission protocol (e.g
|
|
43
|
-
-
|
|
44
|
-
- Robots Exclusion Protocol (e.g
|
|
45
|
-
- Each AI vendor's crawler documentation (e.g
|
|
46
|
-
- Core Web Vitals, owned by `bkit-audit-app-performance
|
|
33
|
+
- Search essentials and the search-documentation updates log (e.g., Google Search Essentials, Bing Webmaster Guidelines). Record the date of the newest entry read.
|
|
34
|
+
- The engine's AI-features and generative-AI optimisation guides (e.g., Google's AI features and your website). Record each page's last-updated date.
|
|
35
|
+
- Search-console help, including the control for generative answers (e.g., Search Console Help). Record the date read.
|
|
36
|
+
- Index submission protocol (e.g., IndexNow). Record the date read.
|
|
37
|
+
- The structured-data vocabulary release and the engine's supported-type list (e.g., schema.org, Google's structured-data gallery). Record the release number and the date read.
|
|
38
|
+
- Robots Exclusion Protocol (e.g., RFC 9309).
|
|
39
|
+
- Each AI vendor's crawler documentation (e.g., OpenAI, Anthropic, Perplexity, Apple, Google's common crawlers). Record each page's date, or the date read.
|
|
40
|
+
- Core Web Vitals, owned by `bkit-audit-app-performance`. This audit reads only what the search console reports.
|
|
47
41
|
|
|
48
42
|
### Scope
|
|
49
43
|
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
- AI crawler policy, firewall agreement,
|
|
54
|
-
-
|
|
44
|
+
- Separate public URLs from previews, and check that previews are not indexable.
|
|
45
|
+
- Check crawling and indexing: robots, sitemap, canonicals, locales, status codes, and the HTML with and without JavaScript.
|
|
46
|
+
- Check metadata, structured data and the plain answers that answer engines quote.
|
|
47
|
+
- Check the AI crawler policy, the firewall's agreement with it, and how engines respond when asked.
|
|
48
|
+
- Check site structure, trust pages and search-console reports.
|
|
55
49
|
|
|
56
50
|
### Out of Scope
|
|
57
51
|
|
|
58
52
|
<!-- prettier-ignore -->
|
|
59
53
|
| Excluded item | Why | Where it belongs |
|
|
60
54
|
| --- | --- | --- |
|
|
61
|
-
| Page speed; Core Web Vitals beyond the search console's report |
|
|
62
|
-
| Heading order, alt text, contrast |
|
|
63
|
-
| Whether structure or copy works for people |
|
|
64
|
-
| Personal data on a public page |
|
|
65
|
-
|
|
|
66
|
-
| How AI referral traffic is measured |
|
|
67
|
-
| A doc that describes the site wrongly |
|
|
68
|
-
| Applying fixes
|
|
55
|
+
| Page speed; Core Web Vitals beyond the search console's report | The speed sweep owns them | `bkit-audit-app-performance` |
|
|
56
|
+
| Heading order, alt text, contrast | The accessibility sweep owns them | `bkit-audit-accessibility` |
|
|
57
|
+
| Whether structure or copy works for people | The usability sweep owns it | `bkit-audit-usability` |
|
|
58
|
+
| Personal data on a public page | The privacy sweep owns it | `bkit-audit-privacy` |
|
|
59
|
+
| The screen a search-to-app link opens | The store sweep owns it | `bkit-audit-app-store` |
|
|
60
|
+
| How AI referral traffic is measured | The tracking sweep owns it | `bkit-audit-analytics` |
|
|
61
|
+
| A doc that describes the site wrongly | The documentation sweep owns it | `bkit-audit-documentation` |
|
|
62
|
+
| Applying fixes; changing robots, consoles or the firewall | The audit only reports | A plan made from this report |
|
|
69
63
|
|
|
70
64
|
### Pre-Flight / Dependencies
|
|
71
65
|
|
|
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
|
-
**Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
|
|
75
|
-
|
|
76
66
|
#### Core
|
|
77
67
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
- [ ] **
|
|
81
|
-
- [ ] **Live Fetch:** Steps 2–9 — request public URLs, headers, and HTML, e.g. `curl`, a browser. Fallback: source read; live claims = hypotheses.
|
|
82
|
-
- [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
68
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
69
|
+
- [ ] **Live Fetch:** Steps 2-9 — request public URLs, headers and HTML (e.g., `curl`, a browser). Fallback: read the source, and treat live claims as hypotheses.
|
|
70
|
+
- [ ] **Web:** Step 10 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
83
71
|
|
|
84
72
|
#### Conditional
|
|
85
73
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
- [ ] **
|
|
89
|
-
- [ ] **
|
|
90
|
-
- [ ] **Schema Validators:** Structured data present → Step 5 — rich-results test and a schema.org validator, e.g. Google Rich Results Test, Schema Markup Validator. Fallback: read required properties from the engine's docs.
|
|
91
|
-
- [ ] **Answer Engines:** Indexable public pages → Step 6 — signed-out prompts, e.g. ChatGPT search, Perplexity, Gemini, Google AI Mode, Copilot, Claude. Fallback: page-text checks only; prompt rows `Not Checked`.
|
|
74
|
+
- [ ] **Search Consoles:** **If** there are indexable public pages → Step 9 (e.g., Google Search Console, Bing Webmaster Tools). Fallback: none. **If** consoles are missing while indexable pages exist → that is a finding.
|
|
75
|
+
- [ ] **Edge Logs:** **If** there is a bot firewall or CDN → Step 6 — the status codes it returns to crawlers (e.g., Vercel Firewall, Cloudflare). Fallback: read `robots.txt` only, and mark the log rows `Not Checked`.
|
|
76
|
+
- [ ] **Schema Validators:** **If** structured data is present → Step 5 — a rich-results test and a schema.org validator (e.g., Google Rich Results Test, Schema Markup Validator). Fallback: read the required properties from the engine's docs.
|
|
77
|
+
- [ ] **Answer Engines:** **If** there are indexable public pages → Step 6 — signed-out prompts (e.g., ChatGPT search, Perplexity, Gemini, Google AI Mode, Copilot, Claude). Fallback: check the page text only, and mark the prompt rows `Not Checked`.
|
|
92
78
|
|
|
93
79
|
### 🔒 Gate 1: Prerequisites Check
|
|
94
80
|
|
|
95
|
-
|
|
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.
|
|
81
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
82
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
99
83
|
|
|
100
84
|
### Probe Steps
|
|
101
85
|
|
|
102
|
-
- [ ] **Step 1 — Previous Run:**
|
|
103
|
-
- [ ] **Step 2 — Public URLs:** List public URLs from sitemap
|
|
104
|
-
- [ ] **Step 3 — Indexing:**
|
|
105
|
-
-
|
|
106
|
-
-
|
|
86
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
87
|
+
- [ ] **Step 2 — Public URLs:** List the public URLs from the sitemap. **If** there is no sitemap → crawl from the home page. Record the production host and the tools available in `Checked`. Check first that no preview deployment is indexable (`X-Robots-Tag: noindex`, or the host's deployment protection), because a crawled preview competes with production and can expose unreleased pages. **If** the marketing site lives outside the repo → name where, and audit it from the live URL. **If** there is no web origin → write `N/A`, then **STOP**. **If** there is no indexable page → say so. `Indexing` still runs, and the steps that need an indexable page skip with evidence in `Not Checked`. **Done when:** `Public URLs` holds the host, the URL list and the preview verdict.
|
|
88
|
+
- [ ] **Step 3 — Indexing:** Check that `robots.txt` and the sitemap are present and valid.
|
|
89
|
+
- Check that the sitemap lists public URLs only.
|
|
90
|
+
- Check that `lastmod` changes only when that page's content changes. Engines trust it only when it is consistently accurate.
|
|
91
|
+
- Check that the sitemap is submitted in each webmaster console.
|
|
92
|
+
- Check the robots meta tag and `X-Robots-Tag` per page type: auth pages and previews are `noindex`, and public pages are indexable.
|
|
93
|
+
- Check that no `noindex` page is also `Disallow`ed, because a blocked crawler never sees the `noindex`, so the URL can stay indexed from links.
|
|
94
|
+
- Check that each canonical is absolute, on the production host, and one per page.
|
|
95
|
+
- Check host canonicalisation: `http` → `https`, apex ↔ `www` and the trailing-slash policy each take one hop, HSTS is set, and the sitemap uses the canonical form only.
|
|
96
|
+
- Check status codes: redirect chains are <= 1 hop, there are no loops, and missing pages return 404.
|
|
97
|
+
- Check locales: each variant's `hreflang` points to existing pages; `hreflang="x-default"` is present; each set is reciprocal and includes itself; the canonical stays in the same locale, never another; and no forced `/` redirect by `Accept-Language` or IP exists, because a crawler that sends no `Accept-Language` from one country (e.g., Googlebot) must still see the other locales.
|
|
98
|
+
- Check that content is in the HTML without JavaScript.
|
|
99
|
+
- Compare the rendered HTML for one URL per page type: the no-JavaScript view vs the engine's render after JavaScript (e.g., URL Inspection).
|
|
100
|
+
- **If** the engine indexes the mobile version (e.g., Google) → check that mobile and desktop have the same content.
|
|
101
|
+
|
|
102
|
+
**Done when:** `Indexing` holds one row per check: met / finding / not applicable (saying why).
|
|
103
|
+
|
|
104
|
+
- [ ] **Step 4 — Metadata:** Run this step only when the project has an indexable public page. Check that the title and description are present, unique and the right length. Check the Open Graph and Twitter card tags, and that their images exist at the right size. Check `lang`, the favicon and the web manifest. **If** the project has store listings → check the Smart App Banner (`apple-itunes-app`), and that `apple-app-site-association` and `assetlinks.json` are reachable, so search opens the app. The screen the link opens goes to `bkit-audit-app-store`. **Done when:** `Metadata` holds one row per page: tag · verdict, or the skip is in `Not Checked`.
|
|
105
|
+
- [ ] **Step 5 — Structured Data:** Run this step only when the project has an indexable public page. Check the JSON-LD for each page type: `Organization`, `WebSite`, `SoftwareApplication` or `MobileApplication` with store links, `FAQPage` only where it mirrors on-page Q&A, and `BreadcrumbList` where the site has depth. Validate each block, and check that it matches the visible page, because markup that disagrees with the page is worse than none. Use the engine's rich-results test for supported types and a schema.org validator for the vocabulary. For app types, check the engine's required software-app properties, plus `operatingSystem` and `applicationCategory`. Ratings must come from real on-page user ratings, never self-assigned ones. A missing rich-result type that is retired (listed in `Project Instructions`) is not a finding. Generative answers need no special markup: structured data earns rich results and states facts plainly. **Done when:** `Structured Data` holds one row per block: type · valid · agrees with page · verdict, or the skip is in `Not Checked`.
|
|
107
106
|
- [ ] **Step 6 — Answer Engines:**
|
|
108
|
-
- `llms.txt`
|
|
109
|
-
-
|
|
110
|
-
- AI crawler policy
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
- AI referrals from answer-engine hosts
|
|
115
|
-
|
|
116
|
-
**Done when:** `Answer Engines` holds policy per group, the console control, prompt rows or a skip, and referral status.
|
|
117
|
-
|
|
118
|
-
- [ ] **Step 7 — Structure:**
|
|
119
|
-
- [ ] **Step 8 — Trust:**
|
|
120
|
-
- [ ] **Step 9 — Consoles:**
|
|
121
|
-
- [ ] **Step 10 — Standards:** Confirm current version
|
|
122
|
-
- [ ] **Step 11 — Anything Else:** (a)
|
|
107
|
+
- `llms.txt` and `llms-full.txt` are optional. Engines ignore them or use them unevenly, so a missing file is not a finding. **If** one is present → check that it is current and links to existing pages. A stale file is `LOW`.
|
|
108
|
+
- **If** there is an indexable page → check that the plain facts are in the HTML text, not only in images or scripts: product, audience, cost and platforms. Check for a direct Q&A near the top of the page that owns each answer. Check that the product and company use one name across the site, store and social. Check that the off-site description, pricing and platforms match the store, reviews, forums and press, because answer engines often cite those over the product site. List the third-party sources the prompt pass cited.
|
|
109
|
+
- Read the AI crawler policy in `robots.txt` for each crawler group. Allowing and blocking are both fine; a group with no recorded decision is a finding. The owner decides, and the report records the decision. Blocking one group does not block the others. Training crawlers: GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot. Search crawlers: OAI-SearchBot, Claude-SearchBot, PerplexityBot, Bingbot (which feeds some assistants); blocking one keeps the site out of those answers. User-triggered crawlers: ChatGPT-User, Claude-User, Perplexity-User; some vendors say these may not follow `robots.txt`. "Block training, allow search" is common. Write the policy per group.
|
|
110
|
+
- Check that the edge or firewall and any CDN "block AI bots" setting agree with `robots.txt`. A firewall `403` to an allowed search crawler silently overrides `robots.txt`. Check the edge or server logs for each search crawler's requests and status codes, not `robots.txt` alone.
|
|
111
|
+
- Read the search-console control for including or excluding pages from generative answers. The owner decides, and the report records the decision. The control does not govern training.
|
|
112
|
+
- **If** there is an indexable page → ask the same questions of the same answer engines. Record the date, each answer and its citations. Answers drift daily, so treat them as a signal, not a test. A wrong answer is a finding about these pages, not about the engine. Keep the pass repeatable: fixed prompts (brand, category, comparison with a named competitor, pricing); a fixed engine set from ChatGPT search, Perplexity, Gemini, Google AI Mode, Copilot and Claude; signed out; verbatim answers and cited URLs; and the mention and citation share against the previous report or the baseline.
|
|
113
|
+
- Read AI referrals from answer-engine hosts and tagged visits as `bkit-audit-analytics` defines them. **If** referrals cannot be measured → name that audit, and do not invent a method here.
|
|
114
|
+
|
|
115
|
+
**Done when:** `Answer Engines` holds the policy per group, the console control, the prompt rows or a skip, and the referral status.
|
|
116
|
+
|
|
117
|
+
- [ ] **Step 7 — Structure:** Run this step only when the project has an indexable public page. Check the URL format (lowercase, hyphenated, stable), the click depth from home, orphan pages, broken internal links, and that navigation and breadcrumbs reach every public page. Whether the hierarchy works for people goes to `bkit-audit-usability`: flag it, and do not decide it. **Done when:** `Structure` holds one row per check: met / finding, or the skip is in `Not Checked`.
|
|
118
|
+
- [ ] **Step 8 — Trust:** Run this step only when the project has an indexable public page. Check for the about or company, contact, support, pricing, privacy and terms pages, and for dated, attributed content where the site publishes any. Check that `Organization` `sameAs` points to the store and social profiles. The generative-AI guides put unique, non-commodity content first, so flag pages that only restate what exists elsewhere. Copy for people goes to `bkit-audit-usability`. **Done when:** `Trust` holds one row per required page: present / finding, or the skip is in `Not Checked`.
|
|
119
|
+
- [ ] **Step 9 — Consoles:** **If** there are indexable pages **and** consoles → read the indexing errors, indexed vs submitted, and the top queries with their delta against the previous report. **If** consoles are missing while indexable pages exist → that is a finding, and `Indexing` is the only signal. In the search console, read generative-AI performance, Core Web Vitals (speed goes to `bkit-audit-app-performance`) and the page-indexing reasons per type (soft 404, duplicate without user-selected canonical, crawled but not indexed). In other webmaster consoles, read AI performance (citations, grounding queries, cited pages) and its delta. For IndexNow, check that public URL additions, updates and deletions are submitted, and that the webmaster console shows them received. **Done when:** `Consoles` holds one row per report: figure · delta · verdict, or the missing-console finding, or the skip is in `Not Checked`.
|
|
120
|
+
- [ ] **Step 10 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per anchor and one per search-documentation or AI-crawler change since the previous report, each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
121
|
+
- [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches public pages or the crawl surface: routes, `robots.txt`, the sitemap, metadata, structured data, locale routing, redirects, middleware, or firewall and bot settings. (b) In a bounded pass of about 30 minutes, note what a senior technical SEO would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows, `bkit-audit-logs` output, vendor status), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
|
|
123
122
|
|
|
124
123
|
### 🔒 Gate 2: Probes Check
|
|
125
124
|
|
|
126
|
-
**
|
|
127
|
-
|
|
128
|
-
- [ ] **
|
|
129
|
-
- [ ] **
|
|
130
|
-
- [ ] **
|
|
131
|
-
- [ ] **No values:** no personal-data value anywhere in the report.
|
|
132
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
125
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
126
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
127
|
+
- [ ] **Settings untouched:** no search-console, webmaster, robots, sitemap, IndexNow or firewall setting changed.
|
|
128
|
+
- [ ] **No values:** no personal-data value appears anywhere in the report.
|
|
129
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
133
130
|
|
|
134
131
|
## Findings
|
|
135
132
|
|
|
136
133
|
<!-- prettier-ignore -->
|
|
137
134
|
| Severity | Use |
|
|
138
135
|
| --- | --- |
|
|
139
|
-
| `CRITICAL` | An indexed preview or signed-in page exposes personal or unreleased data
|
|
140
|
-
| `HIGH` | Production removed from search
|
|
141
|
-
| `MEDIUM` | Wrong or missing metadata
|
|
142
|
-
| `LOW` |
|
|
136
|
+
| `CRITICAL` | An indexed preview or signed-in page exposes personal or unreleased data. The production canonical points at a host that serves the wrong site, and there is no workaround |
|
|
137
|
+
| `HIGH` | Production is removed from search. A page that should not be indexed is indexed (auth, preview, signed-in), or an indexable page is `noindex`. `noindex` is combined with `Disallow`, so the URL can stay indexed. The firewall blocks a search crawler that the recorded policy allows |
|
|
138
|
+
| `MEDIUM` | Wrong or missing metadata. Structured data that disagrees with the page. A canonical, `hreflang` or redirect defect. Consoles absent while indexable pages exist. An answer engine states a wrong fact taken from these pages. An off-site listing disagrees with the site |
|
|
139
|
+
| `LOW` | A stale `llms.txt`. Naming drift that does not change which page is indexed. A missing `llms.txt`, or a missing retired rich-result type, is not a finding |
|
|
143
140
|
|
|
144
|
-
|
|
141
|
+
Within a severity, list indexing findings first.
|
|
145
142
|
|
|
146
143
|
<!-- prettier-ignore -->
|
|
147
144
|
| ID | Severity | Location | Evidence | Expected |
|
|
148
145
|
| --- | --- | --- | --- | --- |
|
|
149
146
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
150
147
|
|
|
151
|
-
|
|
148
|
+
**If** the run finds nothing → write one row: `None`.
|
|
152
149
|
|
|
153
150
|
## Report
|
|
154
151
|
|
|
@@ -221,17 +218,17 @@ PENDING
|
|
|
221
218
|
|
|
222
219
|
### 🔒 Gate 3: Report Check
|
|
223
220
|
|
|
224
|
-
**
|
|
225
|
-
|
|
226
|
-
- [ ] **
|
|
227
|
-
- [ ] **
|
|
228
|
-
- [ ] **Series:** mention and citation share, and console query deltas, beside the previous report's numbers, or
|
|
229
|
-
- [ ] **Writes:** only this report
|
|
230
|
-
- [ ] **
|
|
231
|
-
- [ ] **
|
|
232
|
-
- [ ] **
|
|
233
|
-
|
|
234
|
-
|
|
221
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
222
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
223
|
+
- [ ] **Indexable page:** `Summary` states whether any indexable public page exists.
|
|
224
|
+
- [ ] **Production host:** `Summary` names the production host.
|
|
225
|
+
- [ ] **Series:** the report shows mention and citation share, and console query deltas, beside the previous report's numbers, or marks the run as baseline.
|
|
226
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
227
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
228
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
229
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
230
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
231
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
235
232
|
|
|
236
233
|
<!-- bkit:end -->
|
|
237
234
|
|