@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,173 +1,174 @@
|
|
|
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
|
# App Performance Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:** Reproducible field, lab
|
|
10
|
+
> **Purpose:** Reproducible field, lab and source baseline of web, native and server performance, judged against published thresholds and budgets.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - never change sampling rates, dashboards, or project settings to take a measurement; a gap = finding.
|
|
23
|
-
> - Every figure names environment, window, percentile, and `n`.
|
|
14
|
+
> - Do not change sampling rates, dashboards or project settings to take a measurement.
|
|
15
|
+
> - Record a measurement gap as a finding.
|
|
16
|
+
> - Name the environment, window, percentile and `n` for every figure.
|
|
24
17
|
|
|
25
18
|
## Universal Instructions
|
|
26
19
|
|
|
27
20
|
### Context & Goals
|
|
28
21
|
|
|
29
|
-
|
|
22
|
+
A performance number only matters beside the previous number, taken the same way. **If** the method is not fixed → the delta is worthless. The failure this audit targets is a baseline that measures the instrument or the harness instead of the app. Examples: field data that comes only from CI or previews (cold functions, no warm cache, no CDN, a robot browser), where the waterfall shape transfers but the absolute times do not; a preview overlay that adds seconds to each page load; or a vital that was never collected and so reads as fine. Fix the measurement before measuring. Findings about the instrument outrank findings about the app.
|
|
30
23
|
|
|
31
|
-
**Applies when:** web app, native app
|
|
24
|
+
**Applies when:** there is a web app, a native app or a server answering user requests. **If** there is none → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
32
25
|
|
|
33
|
-
**Cadence:**
|
|
26
|
+
**Cadence:** Run once a quarter. Run an extra pass when production first gets real traffic, after instrument fixes (`Re-baseline`), and after a change to the network shape (region pin, prefetch policy, server-data seeding). A change to sampling, dashboards, the window or the percentile starts a new baseline, so run one then.
|
|
34
27
|
|
|
35
|
-
**Anchor Standards:**
|
|
28
|
+
**Anchor Standards:**
|
|
36
29
|
|
|
37
|
-
- Core Web Vitals (LCP, INP, CLS at p75, mobile, and desktop apart) and supporting FCP, TTFB (e.g
|
|
38
|
-
- Field dataset (e.g
|
|
39
|
-
- Lab method (e.g
|
|
30
|
+
- Core Web Vitals (LCP, INP, CLS at p75, mobile, and desktop apart) and supporting FCP, TTFB (e.g., web.dev). Check its changelog.
|
|
31
|
+
- Field dataset (e.g., Chrome UX Report, PageSpeed Insights).
|
|
32
|
+
- Lab method (e.g., Lighthouse, WebPageTest). Record the tool version.
|
|
40
33
|
- Long Animation Frames API.
|
|
41
|
-
- Soft Navigations API
|
|
42
|
-
- Framework production checklist, edition
|
|
43
|
-
- Platform native vitals (e.g
|
|
44
|
-
- Monitoring vendor's mobile vitals docs (e.g
|
|
34
|
+
- Soft Navigations API. Record the browser version that ships it by default.
|
|
35
|
+
- Framework production checklist, in the edition for the version the app runs (e.g., Next.js, Nuxt).
|
|
36
|
+
- Platform native vitals (e.g., Android vitals, Xcode Organizer metrics).
|
|
37
|
+
- Monitoring vendor's mobile vitals docs (e.g., Sentry Mobile Vitals, Datadog RUM mobile).
|
|
45
38
|
|
|
46
39
|
### Scope
|
|
47
40
|
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
41
|
+
- Check instrument health: which metrics are collected, sample sizes, the environment split and pollution.
|
|
42
|
+
- Take field and lab baselines per web route, native screen and client-side navigation, and read production field data.
|
|
43
|
+
- Read store and device native vitals.
|
|
44
|
+
- Compare results with budgets.
|
|
45
|
+
- Read waterfalls, and find static causes: bundle, media, render-blocking, start-up, rendering and caching, third parties, back/forward cache, prefetch and native size.
|
|
46
|
+
- Find slow interactions.
|
|
47
|
+
- Measure async user-facing pipelines.
|
|
48
|
+
- Measure server, DB, background-job and LLM latency.
|
|
49
|
+
- Check long sessions.
|
|
50
|
+
- Sort the follow-ups closed since the previous report.
|
|
54
51
|
|
|
55
52
|
### Out of Scope
|
|
56
53
|
|
|
57
54
|
<!-- prettier-ignore -->
|
|
58
55
|
| Excluded item | Why | Where it belongs |
|
|
59
56
|
| --- | --- | --- |
|
|
60
|
-
| Crawling, metadata, structured data |
|
|
61
|
-
| Query plans, indexes, vacuum, pool sizing |
|
|
62
|
-
| Prompt quality |
|
|
63
|
-
| Model choice |
|
|
64
|
-
| LLM spend |
|
|
65
|
-
| Third-party tag payloads, consent |
|
|
66
|
-
| Module structure, coupling |
|
|
67
|
-
| CI pipeline duration | CI sweep | `bkit-audit-ci-performance` |
|
|
68
|
-
| Applying fixes
|
|
57
|
+
| Crawling, metadata, structured data | The search sweep owns them; page speed stays here | `bkit-audit-aio-seo` |
|
|
58
|
+
| Query plans, indexes, vacuum, pool sizing | The database sweep owns them | `bkit-audit-database` |
|
|
59
|
+
| Prompt quality | The prompt sweep owns it; latency stays here | `bkit-audit-prompts` |
|
|
60
|
+
| Model choice | The model sweep owns it; latency stays here | `bkit-audit-models` |
|
|
61
|
+
| LLM spend | The cost sweep owns it; latency stays here | `bkit-audit-cost` |
|
|
62
|
+
| Third-party tag payloads, consent | The tracking sweep owns them; main-thread cost stays here | `bkit-audit-analytics` |
|
|
63
|
+
| Module structure, coupling | The architecture sweep owns them; its method is reused here | `bkit-audit-architecture` |
|
|
64
|
+
| CI pipeline duration | The CI sweep owns it | `bkit-audit-ci-performance` |
|
|
65
|
+
| Applying fixes; changing sampling or dashboards | The audit only reports | A plan made from this report |
|
|
69
66
|
|
|
70
67
|
### Pre-Flight / Dependencies
|
|
71
68
|
|
|
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
69
|
#### Core
|
|
77
70
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
- [ ] **
|
|
81
|
-
- [ ] **
|
|
82
|
-
- [ ] **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`.
|
|
83
|
-
- [ ] **Web:** Steps 4, 17 — fetch anchor standards and published thresholds. Fallback: versions and thresholds recorded as unread.
|
|
71
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
72
|
+
- [ ] **Monitoring:** Steps 2-4, 6, 9, 11-13, 15 — field traces, vitals and spans per environment (e.g., Sentry, Datadog RUM, New Relic). Fallback: lab and static only, with field rows `Not Checked`.
|
|
73
|
+
- [ ] **Build Output:** Steps 8, 10 — a production build with per-route size and render mode (e.g., `next build`, `vite build` with a bundle analyser). Fallback: read the source only, and mark sizes `Not Checked`.
|
|
74
|
+
- [ ] **Web:** Steps 4, 17 — fetch the anchor standards and published thresholds. Fallback: record the versions and thresholds as unread.
|
|
84
75
|
|
|
85
76
|
#### Conditional
|
|
86
77
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- [ ] **
|
|
90
|
-
- [ ] **
|
|
91
|
-
- [ ] **
|
|
92
|
-
- [ ] **
|
|
93
|
-
- [ ] **
|
|
94
|
-
- [ ] **
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **
|
|
97
|
-
- [ ] **
|
|
98
|
-
- [ ] **Job Runner:** Background jobs → Steps 12, 13 — run timings and queue lag, e.g. Inngest, Temporal, Sidekiq. Fallback: monitoring spans only.
|
|
99
|
-
- [ ] **Tracker:** Follow-ups from previous reports → Step 16 — via tracker MCP, e.g. GitHub MCP, Linear MCP, Jira MCP; `gh` only as fallback. Fallback: `Closed Follow-Ups` `Not Checked`.
|
|
78
|
+
- [ ] **Lab Runner:** **If** a web app is deployed → Steps 5, 10 (e.g., Lighthouse CI, WebPageTest). Record its version and profile. Fallback: none. Mark `Lab Baseline` `Not Checked`.
|
|
79
|
+
- [ ] **Browser DevTools:** **If** there is a web app → Steps 10, 11, 14 — back/forward cache, Long Animation Frames and heap snapshots (e.g., Chrome DevTools, Playwright over CDP). Fallback: mark those rows `Not Checked`.
|
|
80
|
+
- [ ] **Field Dataset:** **If** a production origin has traffic → Step 6 (e.g., CrUX via PageSpeed Insights, the search console Core Web Vitals report). Fallback: use the monitoring production rows only.
|
|
81
|
+
- [ ] **Store Consoles:** **If** a native app is published → Step 7 (e.g., Play Console Android vitals, Xcode Organizer, App Store Connect sizes). Fallback: `not published`, or `Not Checked`.
|
|
82
|
+
- [ ] **Low-End Device:** **If** there is a native app → Step 7 — a physical low-end device for each platform shipped (e.g., a budget Android, the oldest supported iPhone). Fallback: none. Mark the device rows `Not Checked`.
|
|
83
|
+
- [ ] **Language Server:** **If** the language is typed → Step 9 — references (e.g., Serena, `tsserver`, `pyright`). Fallback: text search only, named on each finding.
|
|
84
|
+
- [ ] **Code Graph:** **If** there are structural questions → Steps 9, 10 — module fan-out and the cold-start graph, using `bkit-audit-architecture`'s method. Fallback: language server and text search. **If** a local-only tool is missing in the cloud → say so.
|
|
85
|
+
- [ ] **Platform Settings:** **If** the app runs on a hosted platform → Steps 3, 10 — preview overlays, region and CDN cache hit ratio (e.g., Vercel, Netlify, Cloudflare dashboard or API). Fallback: read response headers only, and mark settings `Not Checked`.
|
|
86
|
+
- [ ] **DB Statistics:** **If** the DB is hosted → Step 13 (e.g., `pg_stat_statements`, the platform's performance advisor). Fallback: monitoring spans only.
|
|
87
|
+
- [ ] **Job Runner:** **If** there are background jobs → Steps 12, 13 — run timings and queue lag (e.g., Inngest, Temporal, Sidekiq). Fallback: monitoring spans only.
|
|
88
|
+
- [ ] **Tracker:** **If** previous reports raised follow-ups → Step 16 — read them through the tracker MCP (e.g., GitHub MCP, Linear MCP, Jira MCP), with `gh` only as a fallback. Fallback: mark `Closed Follow-Ups` `Not Checked`.
|
|
100
89
|
|
|
101
90
|
### 🔒 Gate 1: Prerequisites Check
|
|
102
91
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
106
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
92
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
93
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
107
94
|
|
|
108
95
|
### Probe Steps
|
|
109
96
|
|
|
110
|
-
- [ ] **Step 1 — Previous Run:**
|
|
111
|
-
- [ ] **Step 2 — Measurement Basis:** Record dashboards (IDs, owned
|
|
112
|
-
- [ ] **Step 3 — Instrument:** Confirm before trusting
|
|
113
|
-
- [ ] **Step 4 — Field Baseline:**
|
|
114
|
-
- [ ] **Step 5 — Lab Baseline:**
|
|
115
|
-
- [ ] **Step 6 — Production:**
|
|
116
|
-
- [ ] **Step 7 — Native Vitals:**
|
|
117
|
-
- [ ] **Step 8 — Budgets:**
|
|
118
|
-
- [ ] **Step 9 — Waterfall:**
|
|
119
|
-
-
|
|
120
|
-
|
|
121
|
-
|
|
97
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
98
|
+
- [ ] **Step 2 — Measurement Basis:** Record the dashboards (their IDs, and whether each is owned or vendor-prebuilt; a prebuilt one cannot be edited) and the exact query behind each table. Record the window, percentile and `n` for each row. Split environments plainly, and give the production count even when it is 0. Link one reference trace. **If** the window or percentile differs from the previous report → this is a new baseline, not a comparison. **Done when:** `Measurement Basis` holds all of these.
|
|
99
|
+
- [ ] **Step 3 — Instrument:** Confirm each of these before trusting the numbers, and state each result, because a missing metric otherwise reads as fine. **If** preview deploys exist with injected overlays (e.g., toolbars, comment widgets) → check that they are off at the project level, or page loads carry their requests. Check that every vital is collected (INP `null` on every route is a gap). Check native screen transactions and frame tracking. **If** warm start is slower than cold start → the dataset cannot be trusted. Check that `n` per row is large enough (a few hundred events on one transaction is not a baseline). Check that client-side navigations are measured: navigation transactions, and LCP and INP after a soft navigation. Check that the fallback or degraded-path rate is measured, or name it as a blind spot. **If** field data comes only from CI or previews → say that the shape transfers, and the absolute times do not. Each failure here is a finding, and outranks app findings, because no fix can be proven until the instrument is honest. **Done when:** `Instrument` holds one line per check.
|
|
100
|
+
- [ ] **Step 4 — Field Baseline:** Build one table per surface, at p75, ordered by load count. For web, per route: LCP, INP, CLS, FCP and TTFB. For native, per screen: cold and warm start, time to initial and full display, and slow and frozen frames. Write `not collected` for an uncollected metric, never a blank. Give each p75 a verdict of good / needs improvement / poor against the source's thresholds, with mobile and desktop split. Read the thresholds on each run, never from memory, and write them in the table header. Add a navigation table: navigation transactions per route, and LCP and INP after soft navigation where reported. **Done when:** every row in `Field Baseline` has a verdict or `not collected`.
|
|
101
|
+
- [ ] **Step 5 — Lab Baseline:** **If** field data comes from CI or previews → the lab gives the reproducible number. Run the lab runner on production, never a preview, on the `Field Baseline` web routes, with fixed throttling (mid-tier mobile, slow 4G), 5 runs per route, and take the median. Record the tool version and profile. A change to either starts a new series. The lab cannot measure INP, so use Total Blocking Time as the stand-in. Keep the third-party summary for `Static`. **Done when:** `Lab Baseline` holds a series per route.
|
|
102
|
+
- [ ] **Step 6 — Production:** **If** there are production users → their numbers are the ones that count. Check that production sampling gives about 1,000 events per route per window, and record the production `n` per route. Read the field dataset (e.g., CrUX via PageSpeed Insights) for the production origin once it qualifies, and the search console Core Web Vitals report (shared with `bkit-audit-aio-seo`). **If** there is no production traffic → write `no production traffic`, and never omit the section. **Done when:** `Production` holds `n` per route and the field-dataset rows, or `no production traffic`.
|
|
103
|
+
- [ ] **Step 7 — Native Vitals:** Run this step only when the project has a native app, and read beyond the monitoring SDK. Android store vitals: slow cold and warm starts, slow and frozen frames, ANR rate and excessive partial wake locks (which affect store visibility). iOS Organizer: launch time, hang rate and energy. On a low-end device, read memory across the primary flow. **If** an over-the-air update layer ships (e.g., `expo-updates`, CodePush) → measure its cost on cold start on the same low-end device. **If** the app is not in the stores → write `not published` for the store rows. **Done when:** `Native Vitals` holds one row per metric, or `not published`.
|
|
104
|
+
- [ ] **Step 8 — Budgets:** A delta against the previous run says the number moved, not that it is good enough, so report each delta against a budget: shipped client code per route (e.g., first-load JS, gzipped), LCP and INP targets per route, native bundle or binary size, and a bundle size cap. **If** a budget is not set → propose one from this run, and let the owner decide. **Done when:** `Budgets` holds one row per budget: target · actual · delta, or a proposed target.
|
|
105
|
+
- [ ] **Step 9 — Waterfall:** The table says which route is slow; the trace says why.
|
|
106
|
+
- For each worst route, open its reference trace and count:
|
|
107
|
+
- round trips
|
|
108
|
+
- sequential vs concurrent calls (concurrent code already in the codebase is the model to copy)
|
|
109
|
+
- page-load requests for data that only one interaction needs
|
|
110
|
+
- duplicate work (e.g., two navigation components each prefetching every route)
|
|
111
|
+
- a fixed floor under every call (a primary-key lookup costing the same as token validation is a network toll, not a slow query)
|
|
112
|
+
- Find where the DB and the functions run before rewriting any query, because a region pin beats every rewrite.
|
|
113
|
+
- **If** several findings share one toll → merge them into one finding (six sequential calls paying one toll is one fix, not six).
|
|
114
|
+
- Use language-server references on the hook or fetcher to see whether there is one call site or many, and on the shared client or helper to see what else pays the toll.
|
|
115
|
+
- Pace the queries: back-to-back queries collapse to partial results, and the under-count shrinks the blast radius, so re-run small caller sets.
|
|
116
|
+
- Use text search for config and JSON wiring.
|
|
117
|
+
- Use the code graph for structural questions (hub module, cold-start graph).
|
|
118
|
+
- Each finding carries its explanation, or links the finding that has it.
|
|
119
|
+
|
|
120
|
+
**Done when:** `Waterfall` holds one row per worst route: round trips · shape · tolls · call sites · merged findings.
|
|
121
|
+
|
|
122
|
+
- [ ] **Step 10 — Static:** The baseline covers routes with traffic and collected metrics; the source shows causes before they run. **If** an item's surface is absent **or** the stack lacks its mechanism → write `N/A` for that item, with evidence. Check each item below where its surface (web, server, native) exists and the stack has the mechanism:
|
|
123
|
+
- Client bundle: size per route from the build output; heavy dependencies in client-side code (e.g., React client components); barrel imports that drag in a whole package. Record it as a series.
|
|
124
|
+
- Media: missing width and height (CLS), no lazy loading below the fold, no responsive sizes.
|
|
122
125
|
- Render-blocking: synchronous third-party scripts; font loading.
|
|
123
|
-
- Server start-up: heavy top-level imports in route handlers
|
|
124
|
-
- Request-path blocking: synchronous file
|
|
125
|
-
- Native entry: top-level imports every cold start pays.
|
|
126
|
-
- Rendering
|
|
127
|
-
- Third-party scripts: main-thread time and transfer per third party from `Lab Baseline` summary
|
|
128
|
-
- Back/forward cache: main routes eligible (DevTools)
|
|
129
|
-
- Prefetch: what each route prefetches (link prefetch, Speculation Rules) and
|
|
130
|
-
- Native size: bytecode bundle (e.g
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
- [ ] **Step 11 — Interactions:**
|
|
135
|
-
- [ ] **Step 12 — Async Paths:**
|
|
136
|
-
- [ ] **Step 13 — Server Latency:** `Waterfall` only traced routes
|
|
137
|
-
- [ ] **Step 14 — Long Sessions:**
|
|
138
|
-
- [ ] **Step 15 — Re-baseline:**
|
|
139
|
-
- [ ] **Step 16 — Closed Follow-Ups:** Follow-ups from previous reports close with decisions only in threads. Read each closed since previous report
|
|
140
|
-
- [ ] **Step 17 — Standards:** Confirm current version
|
|
141
|
-
- [ ] **Step 18 — Anything Else:** (a)
|
|
126
|
+
- Server start-up: heavy top-level imports in route handlers or workers, where a lazy import would keep them off the cold start; intended cold-start splits that were undone. Code-graph fan-out finds candidates.
|
|
127
|
+
- Request-path blocking: synchronous file or crypto work; sequential awaits that could run concurrently.
|
|
128
|
+
- Native entry: top-level imports that every cold start pays for.
|
|
129
|
+
- Rendering and caching per route: the rendering mode from the build output, where the framework has one (e.g., Next.js static / dynamic / partially prerendered); unexpected dynamic rendering (e.g., cookies or headers read in a layout); `Cache-Control`; the CDN cache hit ratio; the server-rendered payload on the heaviest routes (e.g., the React server-component payload).
|
|
130
|
+
- Third-party scripts: main-thread time and transfer per third party, from the `Lab Baseline` summary. Check that each loads after the page is interactive or later (e.g., `next/script` `afterInteractive`, Nuxt Scripts).
|
|
131
|
+
- Back/forward cache: check that the main routes are eligible (DevTools). `Cache-Control: no-store` on HTML, `unload` handlers or open connections force a full reload on back and forward.
|
|
132
|
+
- Prefetch: what each route prefetches (link prefetch, Speculation Rules), and whether it is used.
|
|
133
|
+
- Native size: the bytecode bundle (e.g., Hermes), the store download and install size, and whether long lists are virtualised.
|
|
134
|
+
|
|
135
|
+
These are risk signals, not measurements. Confirm fixes with `Re-baseline`, not by re-reading code. **Done when:** `Static` holds one row per item, and the bundle series is recorded.
|
|
136
|
+
|
|
137
|
+
- [ ] **Step 11 — Interactions:** For each route with INP, find the slowest interactions, and attribute them with Long Animation Frames to a script source, forced layout or hydration. Name the worst ones (drag, popover open, picker, form submit). **Done when:** `Interactions` holds one row per route: interaction · duration · attributed cause.
|
|
138
|
+
- [ ] **Step 12 — Async Paths:** **If** there are async user-facing pipelines → the slowest path is often absent from web vitals (e.g., an inbound message is parsed, goes through model extraction, becomes visible, and a reply is sent). Measure it end to end, at p50 and p95 per stage, from job-runner timings and monitoring spans, and name the longest stage. **Done when:** `Async Paths` holds a stage table per pipeline, or records none.
|
|
139
|
+
- [ ] **Step 13 — Server Latency:** `Waterfall` covers only the traced routes, so read latency app-wide: p75 and p95 per server endpoint (e.g., server action, route handler, controller action, DB RPC) from spans; slow queries from DB statistics and the platform advisor; background-job step durations and queue lag; and LLM calls per model and call site — time to first token, total duration, timeouts, retries, and whether user-facing calls stream. **Done when:** `Server Latency` holds a table per source.
|
|
140
|
+
- [ ] **Step 14 — Long Sessions:** **If** some screens stay open for hours (calendar, dashboard) → keep each open for 30 minutes, take heap snapshots, and record memory growth, the realtime subscription count and polling intervals. **Done when:** `Long Sessions` holds one row per screen.
|
|
141
|
+
- [ ] **Step 15 — Re-baseline:** **If** the instrument was fixed since the previous report → the pre-fix baseline is no longer the reference. Re-take `Field Baseline` and `Lab Baseline`, and mark the figures that moved because of the instrument change, not the app. **Done when:** `Field Baseline` marks the moves, or the report records that there was no instrument fix since the previous report.
|
|
142
|
+
- [ ] **Step 16 — Closed Follow-Ups:** Follow-ups from previous reports often close with their decisions recorded only in threads. Read each one closed since the previous report, and sort it: A = not done, blocked on an owner → a named action and blocker; B = deliberately dropped, and the reasoning holds → record it so nobody reopens it; C = real work nobody owns → a new tracker item, or a named home in scheduled work. **If** there is neither a tracker nor scheduled work → name a `docs/deferrals.jsonl` row. A comment on a closed item is not a register. **Done when:** `Closed Follow-Ups` holds one row per item: group · destination.
|
|
143
|
+
- [ ] **Step 17 — 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 Core Web Vital and supporting web metric (LCP, INP, CLS, FCP, TTFB), one per Android vital, one per iOS Organizer metric and one per framework production-checklist item, 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.
|
|
144
|
+
- [ ] **Step 18 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches 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, or the native app entry. (b) In a bounded pass of about 30 minutes, note what a senior performance engineer would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), 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`.
|
|
142
145
|
|
|
143
146
|
### 🔒 Gate 2: Probes Check
|
|
144
147
|
|
|
145
|
-
**
|
|
146
|
-
|
|
147
|
-
- [ ] **
|
|
148
|
-
- [ ] **
|
|
149
|
-
- [ ] **
|
|
150
|
-
- [ ] **Settings untouched:** no sampling rate, dashboard, or project setting changed.
|
|
151
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
148
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
149
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
150
|
+
- [ ] **Environments:** every figure names its environment, window, percentile and `n`.
|
|
151
|
+
- [ ] **Settings untouched:** no sampling rate, dashboard or project setting changed.
|
|
152
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
152
153
|
|
|
153
154
|
## Findings
|
|
154
155
|
|
|
155
156
|
<!-- prettier-ignore -->
|
|
156
157
|
| Severity | Use |
|
|
157
158
|
| --- | --- |
|
|
158
|
-
| `CRITICAL` |
|
|
159
|
-
| `HIGH` |
|
|
160
|
-
| `MEDIUM` |
|
|
161
|
-
| `LOW` |
|
|
159
|
+
| `CRITICAL` | A user-facing path times out or never completes. A crash, ANR or hang blocks a primary flow. Memory grows over a long session until it crashes |
|
|
160
|
+
| `HIGH` | An instrument gap or pollution invalidates the baseline. A core vital is `poor` on a primary route. A budget is exceeded. A store-enforced vital is over its threshold. A fixed network toll on every call. A sequential waterfall on a primary route |
|
|
161
|
+
| `MEDIUM` | A vital at `needs improvement`. A duplicate or wasted prefetch. Unexpected dynamic rendering. A main route that is not back/forward-cache eligible. A third party that loads before the page is interactive. A slow query, job step or LLM call off the primary path. A long list that is not virtualised |
|
|
162
|
+
| `LOW` | A static risk signal with no measured impact. Size drift within budget. A gap in a series |
|
|
162
163
|
|
|
163
|
-
|
|
164
|
+
Within a severity, list first what unblocks the next measurement, in this order: instrument and pollution fixes; one-line config changes (region, project settings); contained client trims; decisions; and packages shared with native that need a local repro. **If** a finding needs diagnosis before it can be sized → its `Expected` says so.
|
|
164
165
|
|
|
165
166
|
<!-- prettier-ignore -->
|
|
166
167
|
| ID | Severity | Location | Evidence | Expected |
|
|
167
168
|
| --- | --- | --- | --- | --- |
|
|
168
169
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
169
170
|
|
|
170
|
-
|
|
171
|
+
**If** the run finds nothing → write one row: `None`.
|
|
171
172
|
|
|
172
173
|
## Report
|
|
173
174
|
|
|
@@ -264,17 +265,17 @@ PENDING
|
|
|
264
265
|
|
|
265
266
|
### 🔒 Gate 3: Report Check
|
|
266
267
|
|
|
267
|
-
**
|
|
268
|
-
|
|
269
|
-
- [ ] **
|
|
270
|
-
- [ ] **
|
|
271
|
-
- [ ] **Series:** every series beside previous report's numbers, or
|
|
272
|
-
- [ ] **Writes:** only this report
|
|
273
|
-
- [ ] **
|
|
274
|
-
- [ ] **
|
|
275
|
-
- [ ] **
|
|
276
|
-
|
|
277
|
-
|
|
268
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
269
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
270
|
+
- [ ] **Environments measured:** `Summary` names the environments measured.
|
|
271
|
+
- [ ] **Production n:** `Summary` gives the production `n`.
|
|
272
|
+
- [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
|
|
273
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
274
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
275
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
276
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
277
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
278
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
278
279
|
|
|
279
280
|
<!-- bkit:end -->
|
|
280
281
|
|