@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,9 +1,9 @@
|
|
|
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
|
# CI Performance Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,102 +11,84 @@
|
|
|
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 dispatch, rerun, or cancel a workflow. A runner-class experiment is named, not run.
|
|
23
|
-
> - Billable rates are read this run from the billing pages. never copy a previous report's prices.
|
|
14
|
+
> - Never dispatch, rerun or cancel a workflow.
|
|
15
|
+
> - Name a runner-class experiment, but do not run it.
|
|
16
|
+
> - Read the billable rates from the billing pages during this run.
|
|
17
|
+
> - Never copy a previous report's prices.
|
|
24
18
|
|
|
25
19
|
## Universal Instructions
|
|
26
20
|
|
|
27
21
|
### Context & Goals
|
|
28
22
|
|
|
29
|
-
CI time gets re-argued from impressions
|
|
30
|
-
|
|
31
|
-
- Lane duration alone ≠ wall-clock savings — only finish time relative to the run shows whether trimming it helps.
|
|
32
|
-
- Cost and latency are different purchases: state which a change buys, every time.
|
|
33
|
-
- Target failure: effort on a lane that does not hold the run open, or a latency change reported as money saved.
|
|
23
|
+
CI time gets re-argued from impressions, and two mistakes recur. First, a lane's duration alone does not equal wall-clock savings: only its finish time relative to the run shows whether trimming it helps. Second, cost and latency are different purchases, so state which one a change buys, every time. The failure this audit targets is effort spent on a lane that does not hold the run open, or a latency change reported as money saved.
|
|
34
24
|
|
|
35
|
-
**Applies when:** a CI workflow.
|
|
25
|
+
**Applies when:** the repo has a CI workflow. **If** it has none → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
36
26
|
|
|
37
|
-
**Cadence:**
|
|
27
|
+
**Cadence:** Run once a quarter. Run an extra pass when the workflow topology changes (a new lane, runner class or cache).
|
|
38
28
|
|
|
39
|
-
**Anchor Standards:**
|
|
29
|
+
**Anchor Standards:**
|
|
40
30
|
|
|
41
31
|
- DORA software delivery performance: change lead time, deployment frequency, failed-deployment recovery time, change fail rate, and deployment rework rate.
|
|
42
|
-
- Host CI metrics (e.g
|
|
43
|
-
- Task-runner remote cache and affected selection (e.g
|
|
44
|
-
- Package-manager store cache in CI (e.g
|
|
45
|
-
- Browser-test sharding and report merge (e.g
|
|
46
|
-
- Concurrency groups and job timeouts (e.g
|
|
47
|
-
- Runner billing (e.g
|
|
32
|
+
- Host CI metrics (e.g., GitHub Actions usage and performance: job run time, queue time, failure rate). Living docs; record the date read.
|
|
33
|
+
- Task-runner remote cache and affected selection (e.g., Turborepo remote caching and `--affected`), at the version in the lockfile.
|
|
34
|
+
- Package-manager store cache in CI (e.g., pnpm via `actions/setup-node` `cache: pnpm`), at the pinned setup version.
|
|
35
|
+
- Browser-test sharding and report merge (e.g., Playwright sharding and `merge-reports`), at the version in the lockfile.
|
|
36
|
+
- Concurrency groups and job timeouts (e.g., GitHub Actions `concurrency` and `timeout-minutes`).
|
|
37
|
+
- Runner billing (e.g., GitHub-hosted and larger runners, a remote builder such as Depot, mobile-build credits such as EAS). Record the date read.
|
|
48
38
|
- bkit block of `docs/deployments.md` (bkit version from `.bkit/version`): § Run-level decision matrix; § One run per branch or pull request; § Parallel test lanes (one lane per tier); § turbo `//` over-triggers `web_affected` on docs-only diffs (turbo monorepos); § One CI run per dev commit (release PR mirrors the `dev` push run)
|
|
49
39
|
- bkit block of `docs/testing.md` (bkit version from `.bkit/version`): § CI verbosity (`[verbose ci]`)
|
|
50
40
|
|
|
51
41
|
### Scope
|
|
52
42
|
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
43
|
+
- Measure each lane's duration, queue time and finish time, and whether the lane holds the run open.
|
|
44
|
+
- Report distributions (p50 and p90), not a single run.
|
|
45
|
+
- Check the job timeouts.
|
|
46
|
+
- Measure change lead time from push → green → deployed, split by segment.
|
|
47
|
+
- On the lanes that matter, measure step timings, cache hit rate, shard balance, per-job setup cost and artifacts.
|
|
48
|
+
- Check every cache: hit or miss, restore time against a cold rebuild, and usage against the eviction limit.
|
|
49
|
+
- Check what a change actually runs: path filters and required checks.
|
|
50
|
+
- Time the local gate separately, with the cache forced off.
|
|
51
|
+
- Count re-runs, failures that passed later and duplicate runs, as minutes.
|
|
52
|
+
- Measure billable minutes and the cost per successful merge.
|
|
53
|
+
- State latency or cost on every finding.
|
|
62
54
|
|
|
63
55
|
### Out of Scope
|
|
64
56
|
|
|
65
57
|
<!-- prettier-ignore -->
|
|
66
58
|
| Excluded item | Why | Where it belongs |
|
|
67
59
|
| --- | --- | --- |
|
|
68
|
-
| Spend outside CI minutes |
|
|
69
|
-
| Which checks should gate |
|
|
70
|
-
| Product request latency |
|
|
71
|
-
| Why a test flakes, beyond minutes lost |
|
|
72
|
-
| Changing workflows, runners, or caches |
|
|
60
|
+
| Spend outside CI minutes | The cost audit owns the whole bill | `bkit-audit-cost` |
|
|
61
|
+
| Which checks should gate | The gates audit owns it | `bkit-audit-gates` |
|
|
62
|
+
| Product request latency | The performance audit owns hot paths | `bkit-audit-app-performance` |
|
|
63
|
+
| Why a test flakes, beyond minutes lost | The flakes audit owns it | `bkit-audit-flakes` |
|
|
64
|
+
| Changing workflows, runners, or caches | The audit only reports | A plan made from this report |
|
|
73
65
|
|
|
74
66
|
### Pre-Flight / Dependencies
|
|
75
67
|
|
|
76
|
-
**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.
|
|
77
|
-
|
|
78
|
-
**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.
|
|
79
|
-
|
|
80
68
|
#### Core
|
|
81
69
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
- [ ] **
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **Workflow Files:** Steps 3, 7–10 — workflows, task graph, cache config readable. Fallback: none; those steps `Not Checked`.
|
|
87
|
-
- [ ] **Web:** Step 12 — fetch anchor standards and current runner prices. Fallback: versions and prices unread. never reuse a previous report's prices.
|
|
70
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
71
|
+
- [ ] **CI API:** Steps 2-6, 10-11 — read-only run and job metadata (e.g., `gh run view`, `gh api`). Fallback: use the workflow files only, and mark timings `Not Checked`.
|
|
72
|
+
- [ ] **Workflow Files:** Steps 3, 7-10 — readable workflows, task graph and cache config. Fallback: none. Mark those steps `Not Checked`.
|
|
73
|
+
- [ ] **Web:** Step 12 — fetch the anchor standards and the current runner prices. Fallback: record the versions and prices as unread. Never reuse a previous report's prices.
|
|
88
74
|
|
|
89
75
|
#### Conditional
|
|
90
76
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
- [ ] **
|
|
94
|
-
- [ ] **
|
|
95
|
-
- [ ] **Remote Builders:** Job only waits on external builder → Step 6 — builder API or log, e.g. EAS GraphQL. Fallback: wrapper-job duration only; worker time `Not Checked`.
|
|
96
|
-
- [ ] **Local Gate:** Pre-push or local CI command exists → Step 9. Fallback: skip with evidence.
|
|
77
|
+
- [ ] **Host Metrics:** **If** the host publishes queue time → Step 3 — the host's queue figures (e.g., the Actions performance page). Fallback: derive queue time from timestamps only.
|
|
78
|
+
- [ ] **Cache API:** **If** a cache listing exists → Step 7 — the cache list (e.g., `gh cache list`). Fallback: use log lines only, and mark eviction `Not Checked`.
|
|
79
|
+
- [ ] **Remote Builders:** **If** a job only waits on an external builder → Step 6 — the builder API or log (e.g., EAS GraphQL). Fallback: use the wrapper-job duration only, and mark worker time `Not Checked`.
|
|
80
|
+
- [ ] **Local Gate:** **If** a pre-push or local CI command exists → Step 9 — that command. Fallback: skip the step with evidence.
|
|
97
81
|
|
|
98
82
|
### 🔒 Gate 1: Prerequisites Check
|
|
99
83
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
103
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
84
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
85
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
104
86
|
|
|
105
87
|
### Probe Steps
|
|
106
88
|
|
|
107
|
-
- [ ] **Step 1 — Previous Run:**
|
|
108
|
-
- [ ] **Step 2 — Reference:** Name reference run ids, event type
|
|
109
|
-
- [ ] **Step 3 — Lanes:**
|
|
89
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
90
|
+
- [ ] **Step 2 — Reference:** Name the reference run ids, the event type and the date. A push to the integration branch and a pull request are different pipelines (some lanes run on push only), so never compare them as one number without saying so. Record green or red for each run, because red lanes exit early and under-report duration. Runner classes and external queues drift, so the date matters. **Done when:** `Reference` holds the ids, event types, conclusions and date.
|
|
91
|
+
- [ ] **Step 3 — Lanes:** For each job, record the conclusion, duration and start, and a column for whether it holds the run open (duration alone is not that column). Add queue time, because the duration from start to completion hides the runner wait. Queue time = run created → job started. **If** the job has `needs:` → subtract the upstream finish to get the runner wait, and keep the `needs:` wait for Step 5. Cross-check the host's average queue time per job. For example, on GitHub Actions:
|
|
110
92
|
|
|
111
93
|
```
|
|
112
94
|
gh run view <id> --json jobs \
|
|
@@ -116,47 +98,45 @@ Verify only when applicable.
|
|
|
116
98
|
--jq '.jobs[] | "\(.name)\t\(.created_at)\t\(.started_at)"'
|
|
117
99
|
```
|
|
118
100
|
|
|
119
|
-
**Done when:** `Lanes` has duration, queue, finish
|
|
101
|
+
**Done when:** `Lanes` has the duration, queue, finish and holding-the-run-open column for each job.
|
|
120
102
|
|
|
121
|
-
- [ ] **Step 4 — Distributions:** One run cannot separate regression from noise. Pull
|
|
122
|
-
- [ ] **Step 5 — Lead Time:** Lane finish times
|
|
123
|
-
- [ ] **Step 6 — Timings:** Inside lanes that hold the run open or that a proposal would trim: step timings; task-runner cache hit rate (zero cached on a lane that should cache
|
|
124
|
-
- [ ] **Step 7 — Caches:**
|
|
125
|
-
- [ ] **Step 8 — Affected:**
|
|
126
|
-
- [ ] **Step 9 — Local:** Time local gate on whole tree, cache forced off
|
|
127
|
-
- [ ] **Step 10 — Reruns:**
|
|
128
|
-
- [ ] **Step 11 — Cost:** For Step 4 window
|
|
129
|
-
- [ ] **Step 12 — Standards:** Confirm current version
|
|
130
|
-
- [ ] **Step 13 — Anything Else:** (a)
|
|
103
|
+
- [ ] **Step 4 — Distributions:** One run cannot separate a regression from noise. Pull >=20 recent CI workflow runs per event type, and keep green and red apart. Report p50 and p90 for the total wall clock and for the critical-path lane finish, per event type. Say how typical the Step 2 runs are. Check that every job timeout is about 1.5x its p99 (at this sample size, the slowest run). **If** a job has no timeout → it gets the host default (e.g., GitHub Actions 360 minutes) and bills all of it. For example: `gh api "repos/{owner}/{repo}/actions/workflows/<workflow>/runs?event=push&branch=<branch>&per_page=30"`. **Done when:** `Distributions` holds p50 and p90, and each job meets the timeout rule or is a finding.
|
|
104
|
+
- [ ] **Step 5 — Lead Time:** Lane finish times are one segment. Report DORA change lead time for a push to the integration branch: push → all lanes green → deployed. Split it into queue (Step 3), critical-path execution, `needs:` waits and re-run time (Step 10). Name the dominating segment, because that is the one worth buying down. **Done when:** `Lead Time` names the split and the dominating segment.
|
|
105
|
+
- [ ] **Step 6 — Timings:** Inside the lanes that hold the run open, or that a proposal would trim, record: step timings; the task-runner cache hit rate (zero cached on a lane that should cache is a finding); the test counts executed (wall clock per test compares runs better than wall clock alone); for remote-builder jobs, the builder queue and build time, recorded separately from the wrapper; shard balance (a slowest/fastest ratio above about 1.3x means one shard holds the lane); the fixed cost per job (checkout, toolchain setup, install) x the parallel jobs (splitting buys wall clock, but pays setup again); and artifact upload and download time and stored size (large reports on every green run cost time and storage). For example, run `gh run view <id> --log --job=<jobId>` and grep the cache and executed-count lines. **Done when:** `Timings` holds the hit rate, counts, shard ratio or "not sharded", setup cost and artifact size for each lane that matters.
|
|
106
|
+
- [ ] **Step 7 — Caches:** Check every cache, not only the task runner's. Record hit or miss and the restore time for the package-manager store, the framework build cache, browser binaries, native build caches (e.g., Gradle, CocoaPods, hosted mobile builds) and image layer caches. Compare each restore with a cold install. A restore slower than a rebuild is a finding. Compare cache usage with the eviction limit, because a full cache evicts entries that matter. **Done when:** `Caches` holds one row per cache, with hit or miss, restore against cold, and over limit, or the cache is absent with evidence.
|
|
107
|
+
- [ ] **Step 8 — Affected:** Check whether PR lanes run only what changed (an affected graph or a path filter). For a docs-only change and a change scoped to one app, read the `on:` triggers, `paths` filters and job-level `if:`, and record which lanes each change starts. **If** a `paths` filter is safe → propose it, and state its interaction with required checks: a workflow skipped by a path filter leaves required checks pending, while a job skipped by `if` reports success. **Done when:** `Affected` says what each sample change starts, and names any required-check trap.
|
|
108
|
+
- [ ] **Step 9 — Local:** Time the local gate on the whole tree, with the cache forced off, because warm or affected-only numbers are meaningless. Record it beside the CI critical path. **Done when:** `Local` holds the forced whole-tree time, the command, and whether it is on the critical path.
|
|
109
|
+
- [ ] **Step 10 — Reruns:** A red lane costs a full re-run. Read the concurrency block before counting. **If** in-progress runs are not cancelled on the integration branch → a fix-and-repush costs two complete runs. **If** they are cancelled → count the cancelled minutes separately from re-runs. Neither is zero. **If** the flakiest lane is also the slowest lane → it compounds the wall clock. Count its minutes here, and send the cause to `bkit-audit-flakes`. Over the Step 4 window, count the runs with attempt >1, and the jobs that failed then passed on the same commit, per lane, and record both as minutes. Also count the commits that ran under both push and PR, and the runs that completed after a newer run started. **Done when:** `Reruns` holds those minutes, and what the concurrency block does.
|
|
110
|
+
- [ ] **Step 11 — Cost:** For the Step 4 window, multiply the billable minutes per lane by the runner class's current per-minute price, and record the remote-builder minutes and mobile-build credits. Read the prices during this run. Derive the cost per successful merge to the integration branch, re-runs included. Spend outside CI minutes goes to `bkit-audit-cost`. Before recommending a runner-class change for a CPU-bound lane, name a one-run experiment on a larger or different-architecture runner that compares cost and duration. Name the experiment only, and do not run it in this audit, because running it changes the workflow. Every finding states whether it buys latency or cost. **Done when:** `Cost` holds the minutes, the current prices, the cost per merge, and the experiment name or "none".
|
|
111
|
+
- [ ] **Step 12 — 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 DORA metric, per host performance metric, and per caching, sharding, concurrency or billing practice in the anchor list, each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a 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.
|
|
112
|
+
- [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the pipeline: workflows and composite actions, jobs and `needs:`, runner classes, task-runner config and cache keys, shard settings, remote-build profiles, and the local pre-push gate. (b) In a bounded pass of about 30 minutes, note what a senior CI 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`.
|
|
131
113
|
|
|
132
114
|
### 🔒 Gate 2: Probes Check
|
|
133
115
|
|
|
134
|
-
**
|
|
135
|
-
|
|
136
|
-
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
137
|
-
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
116
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
117
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
138
118
|
- [ ] **Event types:** push and pull request are never treated as one pipeline.
|
|
139
|
-
- [ ] **Prices current:** every rate was read this run, not copied from a
|
|
140
|
-
- [ ] **Gate 2
|
|
119
|
+
- [ ] **Prices current:** every rate was read this run, not copied from a previous report.
|
|
120
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
141
121
|
|
|
142
122
|
## Findings
|
|
143
123
|
|
|
144
124
|
<!-- prettier-ignore -->
|
|
145
125
|
| Severity | Use |
|
|
146
126
|
| --- | --- |
|
|
147
|
-
| `CRITICAL` |
|
|
148
|
-
| `HIGH` | The dominating segment is the one a proposal would not touch
|
|
149
|
-
| `MEDIUM` |
|
|
150
|
-
| `LOW` | A slow lane that does not hold the run open
|
|
127
|
+
| `CRITICAL` | There is no green path through the pipeline. A job with no timeout can bill the host maximum on every run |
|
|
128
|
+
| `HIGH` | The dominating segment is the one a proposal would not touch. Latency is described as cost savings, or the reverse, on that segment |
|
|
129
|
+
| `MEDIUM` | A cache miss on a lane that should cache. Shard imbalance that holds a lane open. Setup cost paid again on every split. Re-run minutes that rival the critical path |
|
|
130
|
+
| `LOW` | A slow lane that does not hold the run open. Artifact size that is not on the critical path |
|
|
151
131
|
|
|
152
|
-
|
|
132
|
+
Within a severity, list critical-path findings first. Every finding states whether it buys latency or cost.
|
|
153
133
|
|
|
154
134
|
<!-- prettier-ignore -->
|
|
155
135
|
| ID | Severity | Location | Evidence | Expected |
|
|
156
136
|
| --- | --- | --- | --- | --- |
|
|
157
137
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
158
138
|
|
|
159
|
-
|
|
139
|
+
**If** the run finds nothing → write one row: `None`.
|
|
160
140
|
|
|
161
141
|
## Report
|
|
162
142
|
|
|
@@ -237,17 +217,16 @@ PENDING
|
|
|
237
217
|
|
|
238
218
|
### 🔒 Gate 3: Report Check
|
|
239
219
|
|
|
240
|
-
**
|
|
241
|
-
|
|
242
|
-
- [ ] **
|
|
243
|
-
- [ ] **
|
|
244
|
-
- [ ] **
|
|
245
|
-
- [ ] **
|
|
246
|
-
- [ ] **Process Improvements:** `Universal`
|
|
247
|
-
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one
|
|
248
|
-
- [ ] **
|
|
249
|
-
|
|
250
|
-
> `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
|
|
220
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
221
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
222
|
+
- [ ] **Dominant segment:** `Summary` names the segment that dominates wall clock.
|
|
223
|
+
- [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
|
|
224
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
225
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
226
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
227
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
228
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
229
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
251
230
|
|
|
252
231
|
<!-- bkit:end -->
|
|
253
232
|
|