@cbartens/bkit 6.0.0 → 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 +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -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 +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- 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 +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- 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/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- 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 +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- 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 +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- 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/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- 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 +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- 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 +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- 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 +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -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/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- 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 +282 -176
- 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 +24 -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 +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- 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 +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- 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 +9 -1
- 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 +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- 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/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- 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 +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /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,49 +1,51 @@
|
|
|
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
|
# Issue Prioritisation
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:** A size and a priority for every open tracker issue,
|
|
10
|
+
> **Purpose:** A size and a priority for every open tracker issue, set by two rules that a later run can re-apply and get the same answer. The audit also checks board membership, and the parent, milestone and blocked-by links the rules read.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
14
|
+
> - NEVER write tracker fields, labels or comments.
|
|
15
|
+
> - NEVER close, merge or open issues.
|
|
16
|
+
> - The report proposes size and priority.
|
|
17
|
+
> - NEVER copy a personal-data value into the report.
|
|
16
18
|
|
|
17
19
|
## Universal Instructions
|
|
18
20
|
|
|
19
21
|
### Context & Goals
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
A board with no stated rule is ordered by filing order. Example: a search feature and an authorisation bypass share a band, and the next pass reshuffles both. The failure this audit targets is a ranking that cannot be re-derived. Rule 1 picks the band, and Rule 2 moves it. The rules live in this template beside the ranking, so a later run on the same board gets the same answer.
|
|
22
24
|
|
|
23
|
-
**Applies when:** tracker holds open issues.
|
|
25
|
+
**Applies when:** the tracker holds open issues. **If** it holds none → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
24
26
|
|
|
25
|
-
**Cadence:**
|
|
27
|
+
**Cadence:** Run once a month for the clocks. A monthly pass always runs Steps 1, 4, 11 and 12. It runs Step 2 for membership only, Step 3 for stale issues only, Step 5 for in-flight age and the launch target, and Step 6 for eight-week launch moves and stuck-item lifts only. Other issues carry the previous proposal. Run a full rank (Steps 2-10) when a milestone opens or closes, a ship cycle lands a cluster, lane contents turn over, or an audit files a batch of follow-ups. Run a mini-pass when an issue filed since the previous report has gone a week with no size or priority, or off the board (anchor-standard triage). A mini-pass runs Steps 3-8 and 10, plus Steps 1, 11 and 12 and Step 2 for membership, with the same two rules.
|
|
26
28
|
|
|
27
29
|
**Anchor Standards:**
|
|
28
30
|
|
|
29
|
-
- Weighted Shortest Job First and cost of delay (e.g
|
|
30
|
-
- RICE and ICE scoring (e.g
|
|
31
|
-
- The Kanban Guide (WIP, work-item age, service level expectation); record the edition (e.g
|
|
31
|
+
- Weighted Shortest Job First and cost of delay (e.g., SAFe WSJF, after Reinertsen, _The Principles of Product Development Flow_).
|
|
32
|
+
- RICE and ICE scoring (e.g., Intercom RICE).
|
|
33
|
+
- The Kanban Guide (WIP, work-item age, service level expectation); record the edition (e.g., May 2025).
|
|
32
34
|
- Kanban classes of service (Expedite, Fixed date, Standard, Intangible).
|
|
33
|
-
- Definition of Ready: the Scrum Guide's description of ready items under Product Backlog refinement; record the edition (e.g
|
|
34
|
-
- Severity is not priority (e.g
|
|
35
|
-
- Tracker dependency links (e.g
|
|
35
|
+
- Definition of Ready: the Scrum Guide's description of ready items under Product Backlog refinement; record the edition (e.g., November 2020). No separate published standard exists.
|
|
36
|
+
- Severity is not priority (e.g., Mozilla defect-severity guide and Bugzilla triage policy).
|
|
37
|
+
- Tracker dependency links (e.g., GitHub blocked-by / blocking).
|
|
36
38
|
- bkit issue shapes (bkit version from `.bkit/version`): `.bkit/trackers.md` § Issue shapes; example forms `.bkit/templates/.github/ISSUE_TEMPLATE/` (`.bkit/templates.md` § Issue forms)
|
|
37
39
|
|
|
38
40
|
### Scope
|
|
39
41
|
|
|
40
|
-
-
|
|
41
|
-
- Rule 1 band from the work, not the label.
|
|
42
|
-
- Rule 2 move from in flight, launch-gating, and waits on data that does not exist yet.
|
|
43
|
-
- Size
|
|
44
|
-
- Order inside
|
|
45
|
-
-
|
|
46
|
-
-
|
|
42
|
+
- Apply one rule set to every open issue in every open lane.
|
|
43
|
+
- Take the Rule 1 band from the work, not the label.
|
|
44
|
+
- Take the Rule 2 move from work in flight, launch-gating, and waits on data that does not exist yet.
|
|
45
|
+
- Size the work.
|
|
46
|
+
- Order the issues inside each band. Tracker fields do not store order.
|
|
47
|
+
- Propose a size and a priority for each issue. This run does not write them.
|
|
48
|
+
- Record a finding for board membership, a parent, a milestone or a blocked-by link that is missing, stale or contradicting.
|
|
47
49
|
|
|
48
50
|
### Out of Scope
|
|
49
51
|
|
|
@@ -59,9 +61,9 @@ Board with no stated rule = filing order. Search feature and authorisation bypas
|
|
|
59
61
|
|
|
60
62
|
### Ranking Rules
|
|
61
63
|
|
|
62
|
-
Both rules load-bearing. Rule 1 decides band
|
|
64
|
+
Both rules are load-bearing. Rule 1 decides the band, and Rule 2 moves it one band. Re-apply the rules; do not vote.
|
|
63
65
|
|
|
64
|
-
**Rule 1 — what kind of work it is
|
|
66
|
+
**Rule 1 — what kind of work it is:** security issues come first, then error fixing, then design issues, then everything else.
|
|
65
67
|
|
|
66
68
|
<!-- prettier-ignore -->
|
|
67
69
|
| Category | Priority | What lands here |
|
|
@@ -71,41 +73,41 @@ Both rules load-bearing. Rule 1 decides band. Rule 2 moves one band. Re-apply; d
|
|
|
71
73
|
| Design | `Medium` | Layout, copy, icons, parity, accessibility, anything about how it looks or reads |
|
|
72
74
|
| Everything else | `Low` | New features, test coverage, CI, and tooling, dependency debt, trackers, and milestones |
|
|
73
75
|
|
|
74
|
-
|
|
76
|
+
A defect label is a starting point, not the answer. Read the body, because presentation work and missing tests are often labelled as bugs. Record every override, because those rows are the most likely to be wrong. Name the label correction that matches the body (e.g., drop the defect label from presentation work).
|
|
75
77
|
|
|
76
|
-
**Rule 2 — when it can be done
|
|
78
|
+
**Rule 2 — when it can be done:** in-flight neighbours move up, and lifecycle-later work moves down.
|
|
77
79
|
|
|
78
80
|
<!-- prettier-ignore -->
|
|
79
81
|
| Signal | Move |
|
|
80
82
|
| --- | --- |
|
|
81
83
|
| Parent, child, or sibling of something in progress or in review | Up one band |
|
|
82
84
|
| Split out of an in-flight issue, or touching the same harness | Up one band |
|
|
83
|
-
| Launch-gating: must ship before launch or before first production deploy | Never down. Up one band when the recorded launch or milestone target is eight weeks away or less.
|
|
85
|
+
| Launch-gating: must ship before launch or before first production deploy | Never down. Up one band when the recorded launch or milestone target is eight weeks away or less. **If** no target is recorded → keep the Rule 1 band |
|
|
84
86
|
| Says "once we have usage data" or "when thresholds are hit" | Down one band |
|
|
85
87
|
| Protects data that does not exist yet | Down one band, except a critical path named in Project Instructions |
|
|
86
88
|
|
|
87
|
-
Launch-gating
|
|
89
|
+
Launch-gating work is the fixed-date class of service. Its cost of delay grows as the date approaches, so it never moves down. Step 5 records the target on each run.
|
|
88
90
|
|
|
89
|
-
**Blockers
|
|
91
|
+
**Blockers:** a blocker takes the band of what it blocks, when that band is higher than its own. A non-security blocker of an `Urgent` issue stops at `High`, and goes first in the `High` order (Step 8).
|
|
90
92
|
|
|
91
93
|
Two guards:
|
|
92
94
|
|
|
93
|
-
1. Non-security work does not reach `Urgent`, however hot. No up-move and no blocker lifts past `High`.
|
|
94
|
-
2. Security drops at most one band, never for launch timing. Launch-gating security never down. Security on named critical path never takes "data does not exist yet" down-move. Security never `Low` on "no users yet" alone.
|
|
95
|
+
1. Non-security work does not reach `Urgent`, however hot. No up-move and no blocker lifts it past `High`. The exception: a defect that loses or silently corrupts user data may be `Urgent`.
|
|
96
|
+
2. Security work drops at most one band, and never for launch timing. Launch-gating security work never moves down. Security work on a named critical path never takes the "data does not exist yet" down-move. Security work is never `Low` on "no users yet" alone.
|
|
95
97
|
|
|
96
98
|
**Traps:**
|
|
97
99
|
|
|
98
|
-
- Do not rank by label alone
|
|
99
|
-
- `Urgent` inflation kills the band.
|
|
100
|
-
- Standing issues split across bands by subject.
|
|
101
|
-
- An auto-generated checklist is not work (e.g
|
|
102
|
-
-
|
|
100
|
+
- Do not rank by label alone. It is the main source of wrong answers.
|
|
101
|
+
- `Urgent` inflation kills the band. A long `Urgent` list is a category, not a queue. **If** all protective work is `Urgent` → ask which items matter in the current lifecycle (Project Instructions: are there users?).
|
|
102
|
+
- Standing issues split across bands by subject. A shared process does not put them in one band.
|
|
103
|
+
- An auto-generated checklist is not work (e.g., a dependency-bot dashboard).
|
|
104
|
+
- Rank every open lane by the same two rules. **If** two lanes are ranked differently → the ranking did not read across the boundary.
|
|
103
105
|
|
|
104
|
-
|
|
106
|
+
A `CRITICAL`-`LOW` finding in another audit does not set priority; the two rules do. Severity orders issues inside `High` only (Step 8).
|
|
105
107
|
|
|
106
108
|
### Size Scale
|
|
107
109
|
|
|
108
|
-
Size work, not body.
|
|
110
|
+
Size the work, not the issue body. A long evidence write-up can describe a one-file fix.
|
|
109
111
|
|
|
110
112
|
<!-- prettier-ignore -->
|
|
111
113
|
| Size | Work |
|
|
@@ -116,74 +118,91 @@ Size work, not body. Long evidence write-up can be one-file fix.
|
|
|
116
118
|
| `L` | Several packages, more than one client, or roughly a week |
|
|
117
119
|
| `XL` | Milestone, full-product inventory, or subsystem not yet built |
|
|
118
120
|
|
|
119
|
-
|
|
121
|
+
Never size a multi-client change as one. Size a standing or umbrella issue for one run, not for the series. Size a milestone for its contents.
|
|
120
122
|
|
|
121
123
|
### Pre-Flight / Dependencies
|
|
122
124
|
|
|
123
125
|
#### Core
|
|
124
126
|
|
|
125
|
-
- [ ] **Permissions:** blocked
|
|
126
|
-
- [ ] **Tracker Read:** Steps 2, 5, 10 — every board item with lane, size
|
|
127
|
-
- [ ] **Open-Issue List:** Steps 2, 10 — every open issue
|
|
128
|
-
- [ ] **Issue Bodies:** Steps 3, 4, 6, 8 — title, labels, body, parent, milestone
|
|
129
|
-
- [ ] **Web:** Step 11 — fetch anchor standards. Fallback: versions
|
|
127
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
128
|
+
- [ ] **Tracker Read:** Steps 2, 5, 10 — every board item with its lane, size and priority, read through the tracker MCP (e.g., GitHub MCP `projects_list` for project items, Linear MCP `list_issues`, Jira MCP `searchJiraIssuesUsingJql`). Use `gh` only as a fallback. Fallback: none. Mark unread items `Not Checked`; the proposal does not cover them.
|
|
129
|
+
- [ ] **Open-Issue List:** Steps 2, 10 — every open issue in every repo or team the board draws from, read separately from the board (e.g., GitHub MCP `list_issues`, Linear MCP `list_issues` per team, Jira MCP JQL per project). Fallback: none. Mark membership `Not Checked`; the proposal covers board items only.
|
|
130
|
+
- [ ] **Issue Bodies:** Steps 3, 4, 6, 8 — the title, labels, body, parent, milestone and blocked-by of each issue (e.g., GitHub MCP `issue_read`, Linear MCP `get_issue`, Jira MCP `getJiraIssue`). Fallback: read titles only, mark each such rank low-confidence in `Judgement Calls`, and take links from structured fields only.
|
|
131
|
+
- [ ] **Web:** Step 11 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
130
132
|
|
|
131
133
|
#### Conditional
|
|
132
134
|
|
|
133
|
-
- [ ] **Ship Ledger:**
|
|
134
|
-
- [ ] **Link API:**
|
|
135
|
+
- [ ] **Ship Ledger:** **If** ship outcomes are recorded → Step 9 — the outcomes (e.g., `.bkit/stats.jsonl` `outcome` rows). Fallback: say that the size table was not checked against what shipped.
|
|
136
|
+
- [ ] **Link API:** **If** the tracker exposes structured blocked-by or parent links → Step 4 — those links (e.g., GitHub MCP `issue_read` sub-issues / parent, Linear `relations` / `parent`, Jira issue links / `parent`). Fallback: read the body text only, and say so.
|
|
135
137
|
|
|
136
138
|
### 🔒 Gate 1: Prerequisites Check
|
|
137
139
|
|
|
138
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
139
|
-
- [ ] **Gate 1 — Verified:**
|
|
140
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
141
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
140
142
|
|
|
141
143
|
### Probe Steps
|
|
142
144
|
|
|
143
|
-
- [ ] **Step 1 — Previous Run:** **Done when:**
|
|
144
|
-
- [ ] **Step 2 — Board:** Read every item.
|
|
145
|
-
- [ ] **Step 3 — Triage:** Read every open issue, not
|
|
146
|
-
- [ ] **Step 4 — Links:**
|
|
147
|
-
-
|
|
148
|
-
-
|
|
149
|
-
-
|
|
150
|
-
|
|
151
|
-
-
|
|
152
|
-
-
|
|
153
|
-
-
|
|
154
|
-
-
|
|
155
|
-
|
|
145
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
146
|
+
- [ ] **Step 2 — Board:** Read every item. Check that the read was not truncated: the count is below the limit. **If** the count is at the limit → raise the limit and read again. Record the lane names, and the size and priority field ids and option ids, from the live field list. An unused numeric estimate field stays unused, and the size field is the estimate. For membership, diff the open-issue list against the board. An open issue not on the board is off-board. A closed issue outside the done lane is a stale card. List each one by number. Off-board issues stay in scope: Steps 3-10 treat each one as an item with no lane, size or priority. **Done when:** the item count, lanes, field ids, off-board issues and stale cards are in `Board`, or `N/A` is recorded → **STOP**.
|
|
147
|
+
- [ ] **Step 3 — Triage:** Read every open issue, not only its title. A short prefix of the body is enough when the summary comes first. Read umbrella and milestone issues in full. While reading, mark these. Stale: no activity for 90 days, and the body is no longer true of the code or plan. A standing issue is never stale for age. Duplicate: the same change filed twice, or one change wholly inside another. Won't-do candidate: `Low` on 3 or more passes and still true, standing issues excluded. Not ready: a ready-lane item missing acceptance criteria, a defect reproduction or a test to write. A not-ready item still gets a size and a priority. Note each Rule 1 override, with its label correction, for Step 6. List each stale or duplicate issue with its merge target or stale reason. Closing is the owner's decision, and this run does not close. **If** this is a monthly clock pass → check stale issues only. **Done when:** `Triage` lists the stale, duplicate, won't-do and not-ready issues, and the overrides to rank.
|
|
148
|
+
- [ ] **Step 4 — Links:** For each open issue, record its parent, milestone and blocked-by links.
|
|
149
|
+
- For blocked-by, read all three sources: structured links (`Link API`), the body block the build gates on (e.g., GitHub `###### bkit:blocked-by start` / `end`), and body prose ("blocked by #N", "after #N").
|
|
150
|
+
- Flag these:
|
|
151
|
+
- (1) Parent: a child listed in the parent body with no link, or the reverse; an open child with a closed parent.
|
|
152
|
+
- **If** an open non-standing parent has all its children closed → put it in `Judgement Calls`.
|
|
153
|
+
- (2) Milestone: a closed or past-due milestone with open issues; a body or title that names a milestone while the field is empty; a milestone that breaks how the repo assigns them, read from open and recently closed issues.
|
|
154
|
+
- **If** there is no clear pattern → do not flag it.
|
|
155
|
+
- (3) Blocked-by: a link in prose only; a structured link and a body block that disagree; a closed blocker still listed; a blocked issue in a ready or later lane while its blocker is open; an off-board blocker; a cycle.
|
|
156
|
+
- Feed the edges to the Step 5 blocker rule and the Step 6 parent and child moves.
|
|
157
|
+
|
|
158
|
+
**Done when:** `Links` holds the counts per kind (with and without a parent, a milestone and a blocker) and every flag, or `none`.
|
|
159
|
+
|
|
160
|
+
- [ ] **Step 5 — In Flight:** Read three sources: the in-progress and in-review lanes, open PRs, and recently closed issues. A shipped cluster is still warm, so the next issue in it is cheap. Record the launch or milestone target, and where it is written. **If** there is none → say so; launch-gating work keeps its Rule 1 band. Count the in-progress and in-review items, with each one's age and last activity (commit, PR, comment). Flag each item older than the service level expectation: the 85th-percentile cycle time of issues closed in the last 90 days, from start of work to close. Record how the start was taken. **If** fewer than 20 issues closed → use two weeks, and say so. A stuck item lifts its parent, its children or its siblings. List each lift as a judgement call. Apply the blocker rule to every Step 4 edge. **Done when:** `In Flight` holds the counts, ages, target, blocker moves and stuck lifts.
|
|
161
|
+
- [ ] **Step 6 — Rank:** Apply `Ranking Rules` to every in-scope issue. Record every Rule 1 override (label against body) and its label correction. Record every Rule 2 move with its signal and the launch target read. **If** a band changed since the previous report while none of the body, labels or in-flight neighbours changed → one of the two passes misapplied a rule; say which. **If** a maintenance check belongs as a gate → send it to `bkit-audit-gates`, and give it no band here. **If** this is a mini-pass → run this step on the unsized or unprioritised subset only. **If** this is a monthly clock pass → apply the eight-week launch moves and stuck lifts only. **Done when:** `Ranking` lists every override, move and band change.
|
|
162
|
+
- [ ] **Step 7 — Size:** Apply `Size Scale` to every in-scope issue. **Done when:** `Sizes` has a row per in-scope issue.
|
|
163
|
+
|
|
164
|
+
- [ ] **Step 8 — Order:** The four bands leave issues tied. Order each ready-lane band, and report the top ten. The proposal does not invent an order field. (1) Inside `High`, blockers of `Urgent` issues go first, then severity decides. A defect with a ledger or audit `CRITICAL` goes before one with `HIGH`, and both go before the rest. Severity orders issues within a band, and never moves the band. (2) Order by cost of delay ÷ size (WSJF). Score each of these 1-3: user or business value, time-criticality, and risk reduced or work unblocked. Divide the sum by the size: XS 1, S 2, M 3, L 5, XL 8. **If** two issues tie → the older issue goes first. This is a simplified WSJF; the standard uses modified Fibonacci for each part and for job size. (3) **If** any demand signal exists (error-tracker volume, store reviews, analytics, support, previous-product users) → raise the value score, and name the source. **If** none exists → say so, and do not guess. **Done when:** `Order` holds the top ten with their scores.
|
|
165
|
+
- [ ] **Step 9 — Shipped:** For each issue closed since the previous report, join its ship outcome through the closing PR (lines changed, duration). Compare it with the size given. **If** sizes overlap heavily in lines or time → the size table no longer means what it says; propose a change in `Process Improvements`. **Done when:** `Shipped` holds the comparison, or says there are no outcomes.
|
|
166
|
+
- [ ] **Step 10 — Propose:** Propose one size and one priority for each open item outside the done lane, off-board items included, from Steps 6-7. Before the report is finished, check that the proposal set equals the open-issue list (Step 2), because otherwise a missing issue goes unnoticed. This run does not write fields. The distribution before (fields as read) and after (the proposal) leads `Summary`. Put every call the owner might overturn in `Judgement Calls` (stuck lifts, won't-do, stale, duplicate closes, uncertain bands), each with a recommendation and what would settle it. **Done when:** `Proposal` covers every in-scope item, and `Judgement Calls` holds the calls.
|
|
167
|
+
- [ ] **Step 11 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per anchor-standard practice (within-band order, classes of service, WIP, and work-item age, definition of ready, severity against priority, dependencies), each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
168
|
+
- [ ] **Step 12 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches prioritisation: board fields and options, lanes, labels, milestones, issue templates, and the two rules. (b) In a bounded pass of about 30 minutes, note what a senior delivery lead 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), 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`.
|
|
156
169
|
|
|
157
170
|
### 🔒 Gate 2: Probes Check
|
|
158
171
|
|
|
159
|
-
- [ ] **Steps complete:** every step `[x]`, or
|
|
160
|
-
- [ ] **
|
|
161
|
-
- [ ] **
|
|
162
|
-
- [ ] **
|
|
163
|
-
- [ ] **
|
|
172
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
173
|
+
- [ ] **Clock pass skips:** a monthly clock pass skips Steps 7, 8, 9 and 10 explicitly.
|
|
174
|
+
- [ ] **Clock pass membership:** in a monthly clock pass, Step 2 covers membership only.
|
|
175
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
176
|
+
- [ ] **Membership:** the open-issue list was read separately from the board.
|
|
177
|
+
- [ ] **Off-board listed:** every off-board issue and every stale card is listed.
|
|
178
|
+
- [ ] **Links:** each open issue has its parent, milestone and blocked-by recorded.
|
|
179
|
+
- [ ] **Blocked-by sources:** blocked-by links come from all three Step 4 sources.
|
|
180
|
+
- [ ] **Proposal complete:** every open item outside Done has a proposed size and priority, or this is a monthly clock pass.
|
|
181
|
+
- [ ] **Proposal set:** the proposal set equals the open-issue list, or this is a monthly clock pass.
|
|
182
|
+
- [ ] **Clock pass proposal:** a monthly clock pass keeps the previous proposal, plus the stale calls, stuck lifts and eight-week moves.
|
|
164
183
|
- [ ] **Tracker untouched:** no tracker field, label, comment, or issue was written.
|
|
165
|
-
- [ ] **Gate 2 — Verified:**
|
|
184
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
166
185
|
|
|
167
186
|
## Findings
|
|
168
187
|
|
|
169
188
|
<!-- prettier-ignore -->
|
|
170
189
|
| Severity | Use |
|
|
171
190
|
| --- | --- |
|
|
172
|
-
| `CRITICAL` |
|
|
173
|
-
| `HIGH` | Launch-gating work the rules forbid moving down
|
|
174
|
-
| `MEDIUM` | Rule 1 override with no label correction
|
|
175
|
-
| `LOW` |
|
|
191
|
+
| `CRITICAL` | A security issue proposed more than one band down, or non-security work proposed as `Urgent` (the data-loss exception in `Ranking Rules` is allowed) |
|
|
192
|
+
| `HIGH` | Launch-gating work the rules forbid moving down. A blocker left below the issue it blocks. A security issue moved down for "no users yet" |
|
|
193
|
+
| `MEDIUM` | A Rule 1 override with no label correction. A ready-lane item that is not ready. A stale or duplicate issue still treated as open work. A band change whose body, labels, and in-flight neighbours did not change. An in-flight item older than the service level expectation. An off-board issue. A blocked-by link in prose only, or a structured link and body block that disagree. A blocked issue in a ready or later lane while its blocker is open. A blocked-by cycle. An open child with a closed parent. A closed / past-due milestone with open issues |
|
|
194
|
+
| `LOW` | A won't-do candidate. A label correction that changes no band. Within-band order only. A stale card. A closed blocker still listed. A parent named in the body with no link. A milestone named in the body while the field is empty. A milestone that breaks the repo's own milestone pattern |
|
|
176
195
|
|
|
177
|
-
Within a severity
|
|
196
|
+
Within a severity, list security-band mistakes first.
|
|
178
197
|
|
|
179
|
-
Ranked issues are not findings
|
|
198
|
+
Ranked issues are not findings; their output is the proposed priority. The findings are stale, duplicate, not-ready, mis-ranked, stuck and off-board issues, and broken links.
|
|
180
199
|
|
|
181
200
|
<!-- prettier-ignore -->
|
|
182
201
|
| ID | Severity | Location | Evidence | Expected |
|
|
183
202
|
| --- | --- | --- | --- | --- |
|
|
184
203
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
185
204
|
|
|
186
|
-
|
|
205
|
+
**If** the run finds nothing → write one row: `None`.
|
|
187
206
|
|
|
188
207
|
## Report
|
|
189
208
|
|
|
@@ -264,13 +283,18 @@ PENDING
|
|
|
264
283
|
|
|
265
284
|
### 🔒 Gate 3: Report Check
|
|
266
285
|
|
|
267
|
-
- [ ] **No placeholders:** no `PENDING` left
|
|
268
|
-
- [ ] **Summary:**
|
|
269
|
-
- [ ] **
|
|
270
|
-
- [ ] **
|
|
271
|
-
- [ ] **
|
|
272
|
-
- [ ] **
|
|
273
|
-
- [ ] **
|
|
286
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
287
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
288
|
+
- [ ] **Distribution:** `Summary` gives the size and priority distribution before and after the proposal.
|
|
289
|
+
- [ ] **Off-board count:** `Summary` gives the off-board count.
|
|
290
|
+
- [ ] **Broken-link count:** `Summary` gives the broken-link count.
|
|
291
|
+
- [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
|
|
292
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
293
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
294
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
295
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
296
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
297
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
274
298
|
|
|
275
299
|
<!-- bkit:end -->
|
|
276
300
|
|