@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
|
# Annotations Triage
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,142 +11,144 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
|
|
17
|
-
> - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites 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 edit a workflow, composite action, or other CI config; a recommended change is a finding for a human.
|
|
14
|
+
> - Do not edit a workflow, composite action or other CI config.
|
|
15
|
+
> - Record a recommended CI change as a finding for a human.
|
|
23
16
|
> - NEVER dispatch a workflow, push, or otherwise start a run to verify a fix.
|
|
24
17
|
|
|
25
18
|
## Universal Instructions
|
|
26
19
|
|
|
27
20
|
### Context & Goals
|
|
28
21
|
|
|
29
|
-
Green CI hides costly warnings.
|
|
22
|
+
Green CI hides costly warnings. The failure this audit targets takes two forms. In the first, a step succeeds while the operation it ran was refused, skipped or ignored, and the annotation was the only signal. In the second, a deprecation with a deadline stays green until the runtime or API is removed, and CI goes red on a date nobody chose.
|
|
30
23
|
|
|
31
|
-
**Applies when:** CI emits annotations, warnings
|
|
24
|
+
**Applies when:** CI emits annotations, warnings or notices (e.g., GitHub Actions check-run annotations, GitLab code-quality reports, Buildkite annotations). **If** it emits 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 week, and before every release to the production branch. Sweeps done in passing are not a control. Run an extra pass when a CI-vendor deprecation or retirement post, or a runner-image announcement, touches these workflows; when a workflow, composite action or reusable workflow changes, because a conditional lane annotates only when it runs; and when a deprecation deadline falls before the next weekly sweep.
|
|
34
27
|
|
|
35
|
-
**Anchor Standards:**
|
|
28
|
+
**Anchor Standards:**
|
|
36
29
|
|
|
37
|
-
- CI vendor changelog, deprecation, and retirement posts (e.g
|
|
38
|
-
- Runner-image announcements (e.g
|
|
39
|
-
- Workflow command reference, including deprecated commands (e.g
|
|
40
|
-
- Problem matchers and annotation limits (e.g
|
|
41
|
-
- Workflow static analysers (e.g
|
|
42
|
-
- Deprecated-API lint (e.g
|
|
30
|
+
- CI vendor changelog, deprecation, and retirement posts (e.g., GitHub Changelog deprecation label). These are living pages; record the date read.
|
|
31
|
+
- Runner-image announcements (e.g., `actions/runner-images` Announcement label). These are living pages; record the date read.
|
|
32
|
+
- Workflow command reference, including deprecated commands (e.g., GitHub `set-output`, `save-state`, `set-env`, `add-path`).
|
|
33
|
+
- Problem matchers and annotation limits (e.g., `actions/toolkit` problem matchers; per-step and per-job caps).
|
|
34
|
+
- Workflow static analysers (e.g., actionlint, zizmor). Record their versions.
|
|
35
|
+
- Deprecated-API lint (e.g., typescript-eslint `no-deprecated`). Record the version in the lockfile.
|
|
43
36
|
|
|
44
37
|
### Scope
|
|
45
38
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
39
|
+
- Read the annotations and notices on recent runs of every workflow, including scheduled, manual and bot-triggered runs, not just one pipeline.
|
|
40
|
+
- Read deprecation notices in the vendor changelog before they show up as annotations.
|
|
41
|
+
- Inventory actions and runtimes, including leftover opt-out env keys.
|
|
42
|
+
- Read log lines that never become annotations (deprecations, outdated CLIs).
|
|
43
|
+
- Run workflow static analysis, and find deprecated workflow commands that a conditional lane hides.
|
|
44
|
+
- Give one verdict per annotation.
|
|
45
|
+
- Find the root cause of each silent failure.
|
|
46
|
+
- Find which node a lint warning actually trips.
|
|
47
|
+
- Check that problem matchers turn lint output into annotations.
|
|
48
|
+
- Record what was verified locally, and what still needs a real run.
|
|
54
49
|
|
|
55
50
|
### Out of Scope
|
|
56
51
|
|
|
57
52
|
<!-- prettier-ignore -->
|
|
58
53
|
| Excluded item | Why | Where it belongs |
|
|
59
54
|
| --- | --- | --- |
|
|
60
|
-
| Runtime errors, and log lines that are not annotations or deprecation warnings |
|
|
61
|
-
| Flaky tests |
|
|
62
|
-
| Whether a static-analysis hit is exploitable |
|
|
63
|
-
| Applying fixes
|
|
55
|
+
| Runtime errors, and log lines that are not annotations or deprecation warnings | The log sweep owns them | `bkit-audit-logs` |
|
|
56
|
+
| Flaky tests | The flake sweep owns them | `bkit-audit-flakes` |
|
|
57
|
+
| Whether a static-analysis hit is exploitable | The security sweep owns it | `bkit-audit-security` |
|
|
58
|
+
| Applying fixes; changing workflows | The audit only reports | A plan made from this report |
|
|
64
59
|
|
|
65
60
|
### Verdicts
|
|
66
61
|
|
|
67
|
-
|
|
62
|
+
Give each annotation one verdict. **SILENT FAILURE** outranks every other verdict.
|
|
68
63
|
|
|
69
|
-
- **SILENT FAILURE:** step reported success, but annotation says operation was refused, skipped
|
|
70
|
-
- **DEPRECATION:** action, runtime
|
|
71
|
-
- **LINT WARNING:** real warning
|
|
72
|
-
- **DEAD SUPPRESSION:** disable comment with nothing left to disable.
|
|
73
|
-
- **ACCEPTED:** known
|
|
74
|
-
- **OTHER:** fits
|
|
64
|
+
- **SILENT FAILURE:** the step reported success, but the annotation says the operation was refused, skipped or ignored. The report names the root cause, and the fix is the next step.
|
|
65
|
+
- **DEPRECATION:** an action, runtime or API has an announced end date. The report names the date and the bump, and scheduling it is the next step.
|
|
66
|
+
- **LINT WARNING:** a real warning that points at code. The report says the fix, or why the warning stands. Do not edit the code here.
|
|
67
|
+
- **DEAD SUPPRESSION:** a disable comment with nothing left to disable. The report says to delete it, and whether it sat on the wrong node. Do not delete it here.
|
|
68
|
+
- **ACCEPTED:** the annotation is known and already recorded. Say where, and skip it.
|
|
69
|
+
- **OTHER:** it fits no other verdict. Resolve to one of the above if you can; otherwise say what it is and why it fits none. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
75
70
|
|
|
76
71
|
### Pre-Flight / Dependencies
|
|
77
72
|
|
|
78
|
-
**Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
|
|
79
|
-
|
|
80
|
-
**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.
|
|
81
|
-
|
|
82
73
|
#### Core
|
|
83
74
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
- [ ] **
|
|
87
|
-
- [ ] **
|
|
88
|
-
- [ ] **Workflow Files:** Steps 4, 6, 8 — workflows, composite actions, reusable workflows on disk. Fallback: none.
|
|
89
|
-
- [ ] **Web:** Steps 3, 12 — vendor changelog, runner-image announcements, anchor standards. Fallback: versions recorded as unread.
|
|
75
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
76
|
+
- [ ] **CI Read:** Steps 2, 5, 11 — annotations and step logs for recent runs of every workflow (e.g., `gh api` check-run annotations, `gh run view --log`, GitLab job-trace API). Log access: the `context-fetch` blocks below `bkit:end` in `.agents/context.md` are ready-made read-only readers. `bkit context list-blocks` prints each block's `context` and `body`. Set a body's `# Customise:` knobs to the audit window, and run it with `direnv exec . bash`. Fallback: read saved logs, and mark the runs not fetched `Not Checked`.
|
|
77
|
+
- [ ] **Workflow Files:** Steps 4, 6, 8 — the workflows, composite actions and reusable workflows on disk. Fallback: none.
|
|
78
|
+
- [ ] **Web:** Steps 3, 12 — the vendor changelog, runner-image announcements and anchor standards. Fallback: record the versions as unread.
|
|
90
79
|
|
|
91
80
|
#### Conditional
|
|
92
81
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **Language Server:** Typed language and a lint annotation → Step 9 — per-file diagnostics, e.g. Serena, `tsserver`. Fallback: lint that file; say so. Empty is inconclusive; corroborate with text search.
|
|
97
|
-
- [ ] **Deprecated-API Lint:** Typed language → Step 10 — e.g. `@typescript-eslint/no-deprecated`. Fallback: text search for known deprecated calls; under-count recorded.
|
|
82
|
+
- [ ] **Workflow Linters:** **If** workflows are on disk → Step 6 (e.g., actionlint, zizmor, shellcheck). Fallback: read the workflows, and name each check skipped.
|
|
83
|
+
- [ ] **Language Server:** **If** the language is typed **and** there is a lint annotation → Step 9 — per-file diagnostics (e.g., Serena, `tsserver`). Fallback: lint that file, and say so. An empty language-server result is inconclusive, so corroborate it with text search.
|
|
84
|
+
- [ ] **Deprecated-API Lint:** **If** the language is typed → Step 10 (e.g., `@typescript-eslint/no-deprecated`). Fallback: text search for known deprecated calls, and record the under-count.
|
|
98
85
|
|
|
99
86
|
### 🔒 Gate 1: Prerequisites Check
|
|
100
87
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
104
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
88
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
89
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
105
90
|
|
|
106
91
|
### Probe Steps
|
|
107
92
|
|
|
108
|
-
- [ ] **Step 1 — Previous Run:**
|
|
109
|
-
- [ ] **Step 2 — Collect:**
|
|
110
|
-
- [ ] **Step 3 — Deprecations:** Read vendor deprecation
|
|
111
|
-
- [ ] **Step 4 — Runtimes:**
|
|
112
|
-
- [ ] **Step 5 — Log Warnings:** Some deprecations print only to log. Grep same runs' step logs for deprecation markers (e.g
|
|
113
|
-
- [ ] **Step 6 — Static Analysis:** Run workflow linters every sweep, not only to verify a fix.
|
|
114
|
-
- [ ] **Step 7 — Classify:**
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
93
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
94
|
+
- [ ] **Step 2 — Collect:** **If** there is no CI → write one `N/A` row with evidence, then **STOP**. **Else** → read the annotation lists for recent runs of every workflow, not the last run of one pipeline, because deprecations surface on whichever workflow uses the old action. Include scheduled, manual and bot-triggered runs. Collect them mechanically, not by eye from the UI. The window runs from the previous report, and covers at least the latest completed run of each workflow. Save the list, and diff it against the previous report: new, resolved and persisting. Annotations are capped (e.g., GitHub allows 10 warnings, 10 errors and 10 notices per step, and 50 per job). **If** a step is at the cap → grep its raw job log for warning and error markers, and triage the overflow. Record the run ids and the commit. **If** you cannot re-open an id, run or path → do not cite it. **Done when:** `Annotations` holds the diff (new, resolved, persisting) and the run ids.
|
|
95
|
+
- [ ] **Step 3 — Deprecations:** Read the vendor's deprecation and retirement posts and the runner-image announcements since the previous report. List every dated change that touches these workflows: runtimes, runner images, events and actions. The changelog notice comes before the run notice. Give each one a DEPRECATION verdict with its date and bump. **If** a dependency bot already tracks the bump → say so. Schedule the rest as the next step. **Done when:** `Deprecations` holds one row per dated change: what · date · bump · bot already tracking?
|
|
96
|
+
- [ ] **Step 4 — Runtimes:** For every `uses:` (or the CI system's equivalent) in workflows, local composite actions and reusable workflows, record the resolved version and the declared runtime (e.g., `runs.using`). An action that declares a removed runtime (e.g., `node20` after the runners dropped it) runs on a forced runtime with no opt-out, and is a finding unless it has been seen working there. List leftover opt-out env keys that no longer change anything. **Done when:** `Runtimes` holds one row per action: version · declared runtime · verdict, plus the leftover keys.
|
|
97
|
+
- [ ] **Step 5 — Log Warnings:** Some deprecations print only to the log. Grep the same runs' step logs for deprecation markers (e.g., `DeprecationWarning`, `[DEP0`, `npm warn deprecated`, `WARN deprecated`, `will be removed`) and for outdated-CLI notices (e.g., EAS, Expo, Vercel). Give each line a verdict as if it were an annotation. Agree with `bkit-audit-logs` which sweep owns each line, so it is triaged once. **Done when:** `Log Warnings` holds one row per line: verdict or owning sweep.
|
|
98
|
+
- [ ] **Step 6 — Static Analysis:** Run the workflow linters on every sweep, not only to verify a fix. Treat each new finding as an annotation: shell issues in `run:` blocks, expression typos, template injection, excessive permissions and unpinned `uses:`. Grep workflows and scripts for deprecated workflow commands (e.g., GitHub Actions `::set-output`, `::save-state`, `::set-env`, `::add-path`) and for opt-ins that re-enable them (e.g., `ACTIONS_ALLOW_UNSECURE_COMMANDS`). The runner warns about some of these only when they execute, so a conditional lane hides them. **Done when:** `Static Analysis` holds one row per finding, with its verdict.
|
|
99
|
+
- [ ] **Step 7 — Classify:** Give each annotation one verdict from `Verdicts`.
|
|
100
|
+
- Some annotations are a SILENT FAILURE on sight, e.g., GitHub's `Unexpected input(s) '…', valid inputs are …` (a misspelled input key, ignored) and `No files were found with the provided path` (the artifact was never uploaded).
|
|
101
|
+
- **If** no verdict fits without forcing → use OTHER.
|
|
102
|
+
- Record each annotation's destination.
|
|
103
|
+
- This run writes the `docs/failures.jsonl` rows. Sending to every other destination is the next step's job.
|
|
104
|
+
- Destinations:
|
|
105
|
+
- a real defect → a `docs/failures.jsonl` row
|
|
106
|
+
- SILENT FAILURE → root cause, fix and guard (`Silent Failures`)
|
|
107
|
+
- DEPRECATION → date and bump, dependency bot first
|
|
108
|
+
- LINT WARNING → the fix, or why it stands
|
|
109
|
+
- DEAD SUPPRESSION → delete the directive, flagging a wrong node
|
|
110
|
+
- a flake → `bkit-audit-flakes`
|
|
111
|
+
- a runtime error or a line the log sweep owns → `bkit-audit-logs`
|
|
112
|
+
- a standing rule → a sentence for the testing or deployments doc
|
|
113
|
+
- a workflow change → a recommendation that needs explicit human confirmation
|
|
114
|
+
- ACCEPTED → nothing, citing the record
|
|
115
|
+
|
|
116
|
+
**Done when:** every annotation in `Annotations` has a verdict and a destination.
|
|
117
|
+
|
|
118
|
+
- [ ] **Step 8 — Silent Failures:** Find the root cause of each SILENT FAILURE in the runner's rules. The annotation is the symptom, in the platform's vocabulary. Examples from GitHub Actions: `$GITHUB_ENV` blocklists some names (`NODE_OPTIONS` among them), so set them as static job-level `env:` keys; the `env` context is not available to a job-level `env:` value, so the shortened form resolves empty and fails quietly; a step-level `env:` replaces the job-level map instead of merging, so overriding one key means restating the others; and managed blocks revert edits inside their markers, so check whether a key sits inside a managed marker before recommending a move. On other CI, look for the equivalents (masked variables, env that does not merge, config the platform rewrites). The report names the guard the fix should carry, proven red by reintroducing the bug. **If** deleting the mechanism leaves the lane quiet with no knob → name a second guard that checks the replacement knob exists. Writing the fix is the next step. **Done when:** `Silent Failures` names the root cause, fix and guard for each.
|
|
119
|
+
- [ ] **Step 9 — Lint Node:** For each lint annotation or in-code suppression, find the node the rule fires on, and how the count changes if the directive is removed. Reason from per-file diagnostics. Do not edit the code, and do not typecheck or lint the whole repo for one file. A language server covers one language; use text search for workflow files. **If** a disable comment sits at the annotation line, but the rule's effect is further down → it is a DEAD SUPPRESSION on the wrong node (comment only), and the live rule is a LINT WARNING. **Done when:** `Lint` holds one row per warning: node · directive · verdict.
|
|
120
|
+
- [ ] **Step 10 — Matchers:** Check for problem matchers or annotation reporters on typecheck, lint and test output in CI (e.g., `tsc`, ESLint, Vitest). Without them, warnings stay in the logs, and LINT WARNING is under-counted. Confirm that the deprecated-API lint is enabled (e.g., `@typescript-eslint/no-deprecated`). Calls to deprecated framework APIs are the code-side version of the same deadline. **Done when:** `Matchers` names each reporter and the deprecated-API rule: present or absent.
|
|
121
|
+
- [ ] **Step 11 — Verified:** A green run does not verify a fix to a conditional lane. A lane gated on a marker needs a run that carries the marker, which means a deliberate workflow dispatch, not a push. State what was verified locally (workflow linters, YAML parse, guard tests, per-file diagnostics), and what still needs a real run. Do not dispatch. **Done when:** `Verified` splits what was checked locally from what still needs a run.
|
|
122
|
+
- [ ] **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 deprecation or retirement announcement in the window, one per deprecated workflow command and one per linter check class, 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.
|
|
123
|
+
- [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the CI signal: workflows, composite actions, reusable workflows, `uses:` pins, runner images, workflow and step `env:` keys, or lint config. (b) In a bounded pass of about 30 minutes, note what a senior CI platform engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), 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`.
|
|
121
124
|
|
|
122
125
|
### 🔒 Gate 2: Probes Check
|
|
123
126
|
|
|
124
|
-
**
|
|
125
|
-
|
|
126
|
-
- [ ] **
|
|
127
|
-
- [ ] **
|
|
128
|
-
- [ ] **
|
|
129
|
-
- [ ] **
|
|
130
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
127
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
128
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
129
|
+
- [ ] **Workflows untouched:** no workflow, composite action or CI config was edited.
|
|
130
|
+
- [ ] **No dispatch:** no workflow run was triggered.
|
|
131
|
+
- [ ] **No push:** nothing was pushed.
|
|
132
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
131
133
|
|
|
132
134
|
## Findings
|
|
133
135
|
|
|
134
136
|
<!-- prettier-ignore -->
|
|
135
137
|
| Severity | Use |
|
|
136
138
|
| --- | --- |
|
|
137
|
-
| `CRITICAL` |
|
|
138
|
-
| `HIGH` |
|
|
139
|
-
| `MEDIUM` |
|
|
140
|
-
| `LOW` |
|
|
139
|
+
| `CRITICAL` | A step reported success while a required operation was refused, skipped or ignored, and no other check fails |
|
|
140
|
+
| `HIGH` | A deprecation whose deadline falls before the next release, or an action on a runtime the runners removed. A suppression on the wrong node, so the intended rule still fires |
|
|
141
|
+
| `MEDIUM` | A lint warning that points at code. A deprecation whose deadline is still after the next release. A dead suppression. A static-analysis finding that is not itself a silent failure |
|
|
142
|
+
| `LOW` | A leftover env key that changes nothing. An accepted annotation with no written record. A cosmetic notice |
|
|
141
143
|
|
|
142
|
-
|
|
144
|
+
Within a severity, list silent failures first.
|
|
143
145
|
|
|
144
146
|
<!-- prettier-ignore -->
|
|
145
147
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
146
148
|
| --- | --- | --- | --- | --- | --- |
|
|
147
149
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
148
150
|
|
|
149
|
-
|
|
151
|
+
**If** the run finds nothing → write one row: `None`.
|
|
150
152
|
|
|
151
153
|
## Report
|
|
152
154
|
|
|
@@ -223,18 +225,18 @@ PENDING
|
|
|
223
225
|
|
|
224
226
|
### 🔒 Gate 3: Report Check
|
|
225
227
|
|
|
226
|
-
**
|
|
227
|
-
|
|
228
|
-
- [ ] **
|
|
229
|
-
- [ ] **
|
|
230
|
-
- [ ] **
|
|
231
|
-
- [ ] **
|
|
232
|
-
- [ ] **Writes:** only this report
|
|
233
|
-
- [ ] **
|
|
234
|
-
- [ ] **
|
|
235
|
-
- [ ] **
|
|
236
|
-
|
|
237
|
-
|
|
228
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
229
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
230
|
+
- [ ] **Runs read:** `Summary` names the runs read.
|
|
231
|
+
- [ ] **Series:** the report shows new / resolved / persisting counts beside the previous report's numbers, or marks the run as baseline.
|
|
232
|
+
- [ ] **Checked locally:** `Verified` states what was checked locally.
|
|
233
|
+
- [ ] **Needs a real run:** `Verified` states what still needs a real run.
|
|
234
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
235
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
236
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
237
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
238
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
239
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
238
240
|
|
|
239
241
|
<!-- bkit:end -->
|
|
240
242
|
|