@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,126 +1,130 @@
|
|
|
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
|
# Failures Triage
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** A verdict on every open failure: reachable, already fixed, mis-framed, unconfirmed, or a repeat of a known defect.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> -
|
|
19
|
-
> -
|
|
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 append or edit a ledger line. Close, regression, triage, and knowledge rows live in `Expected` only. `ts` is minted at append (`.bkit/jsonl.md` § Write Idiom), never written in this report.
|
|
23
|
-
> - A security row (`category: "security"`, or an auth, secrets, or data-exposure hole) carries key, verdict, and severity only. `file:line` stays in the ledger row. A public repo uses a draft repository security advisory, not this report.
|
|
14
|
+
> - NEVER append or edit a ledger line.
|
|
15
|
+
> - Write close, correction, regression, triage and knowledge rows in `Expected` only.
|
|
16
|
+
> - Never write `ts` in this report, because it is minted at append (`.bkit/jsonl.md` § Write Idiom).
|
|
17
|
+
> - Give a security row (`category: "security"`, or an auth, secrets or data-exposure hole) its key, verdict and severity only.
|
|
18
|
+
> - Keep a security row's `file:line` in the ledger row.
|
|
19
|
+
> - **If** the repo is public → report a security row through a draft repository security advisory, not this report.
|
|
24
20
|
|
|
25
21
|
## Universal Instructions
|
|
26
22
|
|
|
27
23
|
### Context & Goals
|
|
28
24
|
|
|
29
|
-
`docs/failures.jsonl` logs discovered bugs (`.bkit/jsonl.md` § Ledgers & Writers). Rows
|
|
25
|
+
`docs/failures.jsonl` logs discovered bugs (`.bkit/jsonl.md` § Ledgers & Writers). Rows are appended at discovery and never re-validated. They drift in four ways:
|
|
30
26
|
|
|
31
|
-
- Silently fixed
|
|
32
|
-
- Mis-framed
|
|
33
|
-
- Understated
|
|
34
|
-
- Untracked
|
|
27
|
+
- Silently fixed: the bug is fixed, and the row is not `CLOSED`.
|
|
28
|
+
- Mis-framed: the bug is not reachable, or its path moved.
|
|
29
|
+
- Understated: the row is one instance of a systemic defect.
|
|
30
|
+
- Untracked: the bug is reachable, and no issue carries it.
|
|
35
31
|
|
|
36
|
-
Row text that says found by reading and must be confirmed later
|
|
32
|
+
Row text that says the bug was found by reading and must be confirmed later is a hypothesis, not an established bug, and nothing forces the confirmation. The failure this audit targets is an open row for a bug the code has already fixed, or a live bug the row understates or never confirmed.
|
|
37
33
|
|
|
38
|
-
**Applies when:** `docs/failures.jsonl` exists, or agents append `kind: "failure"`.
|
|
34
|
+
**Applies when:** `docs/failures.jsonl` exists, **or** agents append `kind: "failure"`. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
39
35
|
|
|
40
|
-
**Cadence:** once per ship cycle, and at least
|
|
36
|
+
**Cadence:** Run once per ship cycle, and at least once a month when no cycle ships. Run an extra pass when a new `CRITICAL` row lands (its age target is 7 days), or after an incident on production or preview.
|
|
41
37
|
|
|
42
|
-
**Anchor Standards:**
|
|
38
|
+
**Anchor Standards:**
|
|
43
39
|
|
|
44
|
-
- Problem management and the known-error database (e.g
|
|
45
|
-
- Postmortem action items (e.g
|
|
46
|
-
- Bug triage and resolution states, including an incomplete state for an unanswered reproduction request (e.g
|
|
47
|
-
- Age targets, set by this procedure: 7 days for `CRITICAL`, 30 days for `HIGH`, from the row's
|
|
40
|
+
- Problem management and the known-error database (e.g., ITIL 4; record the edition). The deferred and known-error review it describes (e.g., ITIL-aligned known-error monitoring).
|
|
41
|
+
- Postmortem action items (e.g., Google SRE Workbook, Postmortem Culture).
|
|
42
|
+
- Bug triage and resolution states, including an incomplete state for an unanswered reproduction request (e.g., Mozilla defect severity guide, Bugzilla triage).
|
|
43
|
+
- Age targets, set by this procedure: 7 days for `CRITICAL`, 30 days for `HIGH`, from the winning row's `firstTs` (`ts` when absent). No published standard.
|
|
48
44
|
|
|
49
45
|
### Scope
|
|
50
46
|
|
|
51
|
-
- Fold `docs/failures.jsonl` last-row-wins.
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
47
|
+
- Fold `docs/failures.jsonl` last-row-wins. A row is open when its winning row has `status != "CLOSED"`.
|
|
48
|
+
- Measure each row's age against its target.
|
|
49
|
+
- Check whether a CI gate on open `CRITICAL` failures is installed, and whether it reads this ledger.
|
|
50
|
+
- Verify every open row against source, including hypotheses, mis-framing and understatement.
|
|
51
|
+
- Check incident follow-ups, and whether each incident has a postmortem with a preventing action.
|
|
52
|
+
- Find recurrences and regressions.
|
|
53
|
+
- Check that each known error has a workaround on record.
|
|
54
|
+
- Count root-cause classes, and name the top class as a gate candidate.
|
|
55
|
+
- Route security rows without exploit detail.
|
|
58
56
|
|
|
59
57
|
### Out of Scope
|
|
60
58
|
|
|
61
59
|
<!-- prettier-ignore -->
|
|
62
60
|
| Excluded item | Why | Where it belongs |
|
|
63
61
|
| --- | --- | --- |
|
|
64
|
-
| Deliberate deferred work |
|
|
65
|
-
| Exploit reproduction; auth and exposure as an attack sweep |
|
|
66
|
-
| Flake diagnosis in depth |
|
|
67
|
-
| Log volume, alert rules, drain coverage |
|
|
68
|
-
| Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists |
|
|
69
|
-
| Opening issues; writing the failing test or the postmortem |
|
|
62
|
+
| Deliberate deferred work | It is in the deferral register | `bkit-audit-deferrals` |
|
|
63
|
+
| Exploit reproduction; auth and exposure as an attack sweep | The security sweep reads the ledger row | `bkit-audit-security` |
|
|
64
|
+
| Flake diagnosis in depth | The flake sweep covers it | `bkit-audit-flakes` |
|
|
65
|
+
| Log volume, alert rules, drain coverage | The log sweep covers it | `bkit-audit-logs` |
|
|
66
|
+
| Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | These are ledger writes. For `category: "testing"`, the utility closes a row only on a landed deterministic fix, never on a recent green run | `@bkit-utility-update-failures` |
|
|
67
|
+
| Opening issues; writing the failing test or the postmortem | The audit only reports | A plan made from this report |
|
|
70
68
|
|
|
71
69
|
### Verdicts
|
|
72
70
|
|
|
73
|
-
|
|
71
|
+
Give each verified row one verdict.
|
|
74
72
|
|
|
75
|
-
- **CONFIRMED:** real and reachable.
|
|
76
|
-
- **FIXED:** already resolved. `Expected` = `CLOSED` same
|
|
77
|
-
- **MIS-FRAMED:** row wrong.
|
|
78
|
-
- **TRACKED:** real
|
|
79
|
-
- **UNCONFIRMED:** hypothesis
|
|
80
|
-
- **DUPLICATE:** same defect as another row under different `key`. `Expected` = canonical key, and `CLOSED` row for this one.
|
|
81
|
-
- **OTHER:** fits
|
|
73
|
+
- **CONFIRMED:** the bug is real and reachable. It was reproduced, or its path was read end to end with a cited `file:line`. **If** the row is a security row → keep the citation out of the report. Record the reach: the flow, the roles that hit it, and live event counts when an error tracker is available. **If** no issue carries it → `Expected` names the issue to open. A bug that cannot be reproduced is not fixed on the row's word alone. The failing test is the next step, named in `Expected`, not written here.
|
|
74
|
+
- **FIXED:** the bug is already resolved. `Expected` = the `CLOSED` row with the same `key`, with the `references` that closed it, and the test that would fail if the bug returned. A fix with no such test is not FIXED: `Expected` = a `TRIAGED` row whose follow-up is the missing test.
|
|
75
|
+
- **MIS-FRAMED:** the row is wrong. The bug is not reachable, its component or path moved, or it is one instance of a systemic defect. `Expected` = the corrected row, or the `CLOSED` row with the close reason.
|
|
76
|
+
- **TRACKED:** the bug is real, and an open issue covers it. `Expected` = the issue to point the row at.
|
|
77
|
+
- **UNCONFIRMED:** the row is a hypothesis, not yet reproduced or read end to end. `Expected` = the probe or failing test that settles it. **If** it is still unsettled on its third run → `CLOSED` as not reproducible, and say so.
|
|
78
|
+
- **DUPLICATE:** the row is the same defect as another row under a different `key`. `Expected` = the canonical key, and the `CLOSED` row for this one.
|
|
79
|
+
- **OTHER:** it fits no other verdict. Say what it is, why, and where it goes. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
82
80
|
|
|
83
|
-
**FIXED and MIS-FRAMED are the verdicts most likely to hide a live bug
|
|
81
|
+
**Close evidence:** FIXED and MIS-FRAMED are the verdicts most likely to hide a live bug, and language-server under-reporting biases the run toward them. Either verdict needs a positive reason: a fix commit, a deleted file or a changed guard. An empty query does not prove absence. **If** the error tracker shows events on the matching issue after the fix commit → the bug is not fixed.
|
|
84
82
|
|
|
85
|
-
Row text awaiting confirmation
|
|
83
|
+
Row text awaiting confirmation is UNCONFIRMED until the bug is reproduced or read end to end.
|
|
86
84
|
|
|
87
85
|
### Pre-Flight / Dependencies
|
|
88
86
|
|
|
89
|
-
**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.
|
|
90
|
-
|
|
91
|
-
**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.
|
|
92
|
-
|
|
93
87
|
#### Core
|
|
94
88
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
- [ ] **
|
|
98
|
-
- [ ] **
|
|
99
|
-
- [ ] **Git History:** Steps 2, 5 — commits since the previous report, fix commits. Fallback: closures and regression-by-commit `Not Checked`.
|
|
100
|
-
- [ ] **Web:** Step 8 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
89
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
90
|
+
- [ ] **Ledger:** Steps 3-7 — `docs/failures.jsonl` and `.bkit/jsonl.md`. Fallback: **If** the file is absent → write one `N/A` row after Step 3, then **STOP**.
|
|
91
|
+
- [ ] **Git History:** Steps 2, 5 — commits since the previous report, and fix commits. Fallback: mark closures and regression-by-commit `Not Checked`.
|
|
92
|
+
- [ ] **Web:** Step 8 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
101
93
|
|
|
102
94
|
#### Conditional
|
|
103
95
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
- [ ] **
|
|
107
|
-
- [ ] **
|
|
108
|
-
- [ ] **Tracker:** Issues wired → Steps 4, 7 — issue carrying bug, postmortem tracking issue. Fallback: issue pointers `Not Checked`.
|
|
109
|
-
- [ ] **CI Config:** Workflow can fail build → Step 3 — gate on open `CRITICAL` failures. Fallback: gate check `Not Checked`.
|
|
96
|
+
- [ ] **Language Server:** **If** the language is typed → Step 4 — the symbol at its current path, the caller chain, and diagnostics for one file without a full typecheck (e.g., Serena, `tsserver`). Fallback: text search. Reach and closes that need callers stay hypotheses until corroborated.
|
|
97
|
+
- [ ] **Error Tracker:** **If** production or preview events exist → Steps 4, 5 — event counts and flows after the fix commit (e.g., Sentry, platform logs). 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: code only. Mark event counts `Not Checked`.
|
|
98
|
+
- [ ] **Tracker:** **If** issues are wired → Steps 4, 7 — the issue carrying the bug, and the postmortem tracking issue. Fallback: mark issue pointers `Not Checked`.
|
|
99
|
+
- [ ] **CI Config:** **If** a workflow can fail the build → Step 3 — the gate on open `CRITICAL` failures. Fallback: mark the gate check `Not Checked`.
|
|
110
100
|
|
|
111
101
|
### 🔒 Gate 1: Prerequisites Check
|
|
112
102
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
116
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
103
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
104
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
117
105
|
|
|
118
106
|
### Probe Steps
|
|
119
107
|
|
|
120
|
-
- [ ] **Step 1 — Previous Run:**
|
|
121
|
-
- [ ] **Step 2 — Closures:** Re-verify every FIXED and MIS-FRAMED row from previous report
|
|
122
|
-
- [ ] **Step 3 — Fold:**
|
|
123
|
-
-
|
|
108
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
109
|
+
- [ ] **Step 2 — Closures:** Re-verify at `HEAD` every FIXED and MIS-FRAMED row from the previous report. Each one that no longer holds is a finding, with what changed. **Done when:** `Closures` holds every row, each failure and the failure rate, or the run is marked baseline.
|
|
110
|
+
- [ ] **Step 3 — Fold:** Fold the ledger last-row-wins per `key`, not per line. The ledger is append-only (`.gitattributes` `merge=union`), so editing a line leaves the stale copy beside its replacement. The highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row).
|
|
111
|
+
- **If** a `key`'s `ts` is not a number → the last line in the file is the latest.
|
|
112
|
+
- Open means every winning row with `status != "CLOSED"`, including `TRIAGED` (diagnosed is not fixed), `RESOLVED`, `FIXED`, `SUPERSEDED`, and rows with no `status`. A word that looks finished does not make a row done.
|
|
113
|
+
- **If** a `RESOLVED` or `FIXED` row is really done → put a `CLOSED` row in `Expected`, with the `references` that closed it.
|
|
114
|
+
- Do not skip a row because its word looks finished.
|
|
115
|
+
- Order the rows `CRITICAL`, then `HIGH`, then oldest `ts`.
|
|
116
|
+
- Compare `severity` case-insensitively.
|
|
117
|
+
- **If** a row has no `severity` → assign one with its verdict.
|
|
118
|
+
- Measure age from the row's first `ts`, and list every `CRITICAL` older than 7 days and every `HIGH` older than 30 days.
|
|
119
|
+
- Report whether a CI check is installed that goes red while any `CRITICAL` row has `status != "CLOSED"`. A green check beside such a row is a finding, because the gate is not reading the ledger.
|
|
120
|
+
- **If** the check is absent → record that in `Checked`.
|
|
121
|
+
- A large open set may get a partial pass, so record rows verified / rows open.
|
|
122
|
+
- **If** a winning row has a future `ts` that would outrank a close → name its `key`.
|
|
123
|
+
- Do not invent a later `ts`.
|
|
124
|
+
|
|
125
|
+
**Done when:** `Trend` holds the open counts, the age-target breaches, the gate result, and verified / open, or holds `N/A`, then **STOP**.
|
|
126
|
+
|
|
127
|
+
- [ ] **Step 4 — Source:** Give no verdict before this step. Under-reporting biases the run toward closing a live bug.
|
|
124
128
|
|
|
125
129
|
<!-- prettier-ignore -->
|
|
126
130
|
| Row claims | Check with |
|
|
@@ -132,15 +136,15 @@ Verify only when applicable.
|
|
|
132
136
|
| A ledger, migration, workflow, SQL, config, or string literal | Text search. A language server reads one language |
|
|
133
137
|
| FIXED, or the reach of CONFIRMED | Error tracker and platform logs. Events after the fix commit mean not fixed. Counts and flows are the reach |
|
|
134
138
|
|
|
135
|
-
Pace reference queries. Re-run empty or surprisingly low result before close verdict
|
|
139
|
+
Pace the reference queries. Re-run an empty or surprisingly low result before giving a close verdict, because a partial answer looks the same as a real one. An empty result is inconclusive, not proof of absence. Packages and files outside the project graph, and mock-factory keys, are invisible to the language server, so use text search for them.
|
|
136
140
|
|
|
137
|
-
Incident rows (seen on production or preview, not in review) need follow-ups checked.
|
|
141
|
+
Incident rows (seen on production or preview, not in review) need their follow-ups checked. The remediation usually names more than the code fix: a regression test, a monitor, an alert or a doc change. Check that each one landed. **If** the fix landed **and** the test or monitor did not → the row is not FIXED. `Expected` names each missing follow-up and the issue to open.
|
|
138
142
|
|
|
139
|
-
Each incident
|
|
143
|
+
Each incident needs a written postmortem, with at least one action that prevents or detects a repeat, an owner, and a tracking issue at top priority. A user-affecting outage needs at least one top-priority bug. A missing postmortem, or a postmortem with only mitigation items, is a finding, and `Expected` = the issue to open. **Done when:** every row verified this pass has its evidence and the tool on its finding. `Incidents` lists the follow-ups and postmortem gaps, or says `none`. Unverified rows stay counted in `Trend`, and are not passed.
|
|
140
144
|
|
|
141
|
-
- [ ] **Step 5 — Recurrences:**
|
|
142
|
-
- [ ] **Step 6 — Classes:** (a) Known errors carry workaround. For every `TRIAGED` or CONFIRMED row agents keep hitting (
|
|
143
|
-
- [ ] **Step 7 — Classify:**
|
|
145
|
+
- [ ] **Step 5 — Recurrences:** A same-`key` append that records the defect being seen again is a recurrence (`.bkit/jsonl.md` § Updating a Row). Leave out appends that only change `status`. For `category: "testing"`, the flake count is the winning row's `updates`, status-only appends included. Rank the open rows by count. Then find regressions. For each row `CLOSED` since the previous report, look for a later row with the same `key`, a new row for the same defect under another `key`, or error-tracker events on the matching issue after the close. Each one gets `Expected` = the `OPEN` row to append. **Done when:** `Recurrences` ranks the open rows and lists the regressions, or says `none`.
|
|
146
|
+
- [ ] **Step 6 — Classes:** (a) Known errors carry a workaround. For every `TRIAGED` or CONFIRMED row that agents keep hitting (2 or more recurrences in Step 5, or a parked row whose blocker is not in the winning row), check that `docs/knowledge.jsonl` has an `ACTIVE` row with the workaround. A missing one is a finding, and `Expected` = the knowledge row to append. (b) Count the open and recently closed rows by `category`, package and root-cause class. The top recurring class this run is a gate candidate; name it for `bkit-audit-gates`. **Done when:** `Classes` holds the workaround gaps, the counts and the gate candidate, or says `none`.
|
|
147
|
+
- [ ] **Step 7 — Classify:** Give every row, as Step 4 left it, one verdict. This run does not append rows or open issues. A security row goes to `bkit-audit-security`, with only its key, verdict and severity in this report. A flaky test's diagnosis goes to `bkit-audit-flakes`. Older flake diagnoses may sit on tracker issues that predate that audit, so search those too.
|
|
144
148
|
|
|
145
149
|
<!-- prettier-ignore -->
|
|
146
150
|
| Finding | Expected |
|
|
@@ -160,39 +164,40 @@ Each incident: written postmortem; ≥1 action preventing or detecting repeat, w
|
|
|
160
164
|
| Flaky test's diagnosis | `bkit-audit-flakes` |
|
|
161
165
|
| OTHER | Where it goes |
|
|
162
166
|
|
|
163
|
-
**Done when:** every verified row has one verdict
|
|
167
|
+
**Done when:** every verified row has one verdict, and the security rows in Findings carry no `file:line` and no exploit detail.
|
|
164
168
|
|
|
165
|
-
- [ ] **Step 8 — Standards:** Confirm current version
|
|
166
|
-
- [ ] **Step 9 — Anything Else:** (a)
|
|
169
|
+
- [ ] **Step 8 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. In `Standards Coverage`, give one row per practice (known-error records, proactive problem review, postmortem action items, triage resolution states, age targets), marked checked (with 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.
|
|
170
|
+
- [ ] **Step 9 — Anything Else:** (a) List everything changed since the previous report's commit that touches failures (the schema and writers in `.bkit/jsonl.md`, the steps and agents that append rows, the CI gate on open `CRITICAL` failures, the flake register `bkit-audit-flakes`, and error-tracker projects and alert rules), with a one-line verdict each. (b) In a bounded pass of about 30 minutes, note what a senior problem manager would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` sweeps, vendor status incidents), and note 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`.
|
|
167
171
|
|
|
168
172
|
### 🔒 Gate 2: Probes Check
|
|
169
173
|
|
|
170
|
-
**
|
|
171
|
-
|
|
172
|
-
- [ ] **
|
|
173
|
-
- [ ] **
|
|
174
|
-
- [ ] **
|
|
175
|
-
- [ ] **
|
|
176
|
-
- [ ] **
|
|
174
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
175
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
176
|
+
- [ ] **Read-only:** no ledger line, code or config changed.
|
|
177
|
+
- [ ] **Rows proposed only:** every close, correction, regression, triage and knowledge row is in `Expected` only.
|
|
178
|
+
- [ ] **Security:** security rows carry key, verdict and severity only.
|
|
179
|
+
- [ ] **No exploit detail:** no security row carries exploit detail.
|
|
180
|
+
- [ ] **No location:** no security row carries a `file:line`.
|
|
181
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
177
182
|
|
|
178
183
|
## Findings
|
|
179
184
|
|
|
180
185
|
<!-- prettier-ignore -->
|
|
181
186
|
| Severity | Use |
|
|
182
187
|
| --- | --- |
|
|
183
|
-
| `CRITICAL` |
|
|
184
|
-
| `HIGH` |
|
|
185
|
-
| `MEDIUM` |
|
|
186
|
-
| `LOW` |
|
|
188
|
+
| `CRITICAL` | A row records data loss, a security hole, or a broken workflow with no workaround, and is still open. That includes a row whose word looks finished. |
|
|
189
|
+
| `HIGH` | A row records real damage or a blocked path, with a workaround. A fix landed with no regression test. An incident's test or monitor did not land. A user-affecting outage has no preventing action. |
|
|
190
|
+
| `MEDIUM` | A row is mis-framed or understated. A defect recurred or regressed. A known error has no workaround on record. An age target is breached. A hypothesis is still open. |
|
|
191
|
+
| `LOW` | A key is duplicated. A path drifted without changing the reach. A row is missing `severity`. |
|
|
187
192
|
|
|
188
|
-
|
|
193
|
+
Within a severity, list the oldest `firstTs` first, using `ts` where `firstTs` is absent. A finding keeps its severity when it becomes a ledger row or an issue. A row's severity is its ledger `severity`, or the one its verdict assigned.
|
|
189
194
|
|
|
190
195
|
<!-- prettier-ignore -->
|
|
191
196
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
192
197
|
| --- | --- | --- | --- | --- | --- |
|
|
193
198
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
194
199
|
|
|
195
|
-
|
|
200
|
+
**If** the run finds nothing → write one row: `None`.
|
|
196
201
|
|
|
197
202
|
## Report
|
|
198
203
|
|
|
@@ -253,17 +258,17 @@ PENDING
|
|
|
253
258
|
|
|
254
259
|
### 🔒 Gate 3: Report Check
|
|
255
260
|
|
|
256
|
-
**
|
|
257
|
-
|
|
258
|
-
- [ ] **
|
|
259
|
-
- [ ] **
|
|
260
|
-
- [ ] **Series:** open count and the recurrence ranking beside previous report's numbers, or
|
|
261
|
-
- [ ] **Writes:** only this report and template `Project Instructions
|
|
262
|
-
- [ ] **
|
|
263
|
-
- [ ] **
|
|
264
|
-
- [ ] **
|
|
265
|
-
|
|
266
|
-
|
|
261
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
262
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
263
|
+
- [ ] **Age breaches:** `Summary` gives the age-target breach count.
|
|
264
|
+
- [ ] **Coverage:** `Summary` gives rows verified / rows open.
|
|
265
|
+
- [ ] **Series:** the report shows open count and the recurrence ranking beside the previous report's numbers, or marks the run as baseline.
|
|
266
|
+
- [ ] **Writes:** this run changed only this report and the template's `Project Instructions`.
|
|
267
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
268
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
269
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
270
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
271
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
267
272
|
|
|
268
273
|
<!-- bkit:end -->
|
|
269
274
|
|