@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,172 +1,201 @@
|
|
|
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
|
# Duplication Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** A verdict on every behaviour with more than one implementation: inline rules, competing capability mechanisms, restated types, paired decisions, and merges that should not have happened.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
|
|
17
|
-
> - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - Generated registers / graphs → verify-only mode or throwaway copy; never regenerate a tracked file.
|
|
14
|
+
> - Run generated registers and graphs in verify-only mode, or on a throwaway copy.
|
|
15
|
+
> - Never regenerate a tracked file.
|
|
23
16
|
|
|
24
17
|
## Universal Instructions
|
|
25
18
|
|
|
26
19
|
### Context & Goals
|
|
27
20
|
|
|
28
|
-
Identical-signature gates catch identical copies
|
|
21
|
+
Identical-signature gates catch identical copies. The duplication that hurts is divergent: one behaviour with N implementations that have drifted apart, each locally correct, so review and tests pass. It comes in three shapes that other detectors cannot see. A rule is one expression inlined at N sites and then edited. The expression is not a symbol, so it needs text or structural search, not the language server. A capability is one operation done by N modules or mechanisms. It needs the register, reference search and literal-mechanism search. A paired decision is two files that must change together, each owning its half, with nothing tying them. It needs co-change history. A shared home that exists does not mean every site calls it, and a documented convention does not stop drift. Until a guard covers both altitudes, this sweep is the prevention. The failure this audit targets is copies of one piece of knowledge that silently disagree, e.g., a security control left `null` at a call site the remediation missed.
|
|
29
22
|
|
|
30
|
-
**Applies when:** source code
|
|
23
|
+
**Applies when:** the source code spans more than one module, package or platform. **If** it does not → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
31
24
|
|
|
32
|
-
**Cadence:**
|
|
25
|
+
**Cadence:** Run once a month. Run an extra pass when a consolidation lands (re-check its register row and call sites), when a new owner module or shared package lands, or when a production failure traces to divergent copies.
|
|
33
26
|
|
|
34
|
-
**Anchor Standards:**
|
|
27
|
+
**Anchor Standards:**
|
|
35
28
|
|
|
36
|
-
- Clone taxonomy Type-1 to Type-4 and clone detector at version run (e.g
|
|
37
|
-
- Structural search at version run (e.g
|
|
29
|
+
- Clone taxonomy Type-1 to Type-4 and clone detector at version run (e.g., jscpd clone-types guide, PMD CPD).
|
|
30
|
+
- Structural search at version run (e.g., ast-grep, Semgrep).
|
|
38
31
|
- DRY as knowledge, not text (_The Pragmatic Programmer_, edition read).
|
|
39
32
|
- Rule of three and "The Wrong Abstraction" (Sandi Metz).
|
|
40
|
-
- Change coupling (e.g
|
|
41
|
-
- Package-manager dedupe at version run (e.g
|
|
42
|
-
- AI-assisted code-quality research, latest year (e.g
|
|
33
|
+
- Change coupling (e.g., code-maat).
|
|
34
|
+
- Package-manager dedupe at version run (e.g., `pnpm dedupe --check`, `npm dedupe`).
|
|
35
|
+
- AI-assisted code-quality research, latest year (e.g., GitClear duplicated-block prevalence).
|
|
43
36
|
|
|
44
37
|
### Scope
|
|
45
38
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
39
|
+
- Check the rule altitude: one business rule inlined at N sites, such as fallback chains, null against falsy, formatting, predicates and defaults.
|
|
40
|
+
- Check the capability altitude: one operation with N implementations or mechanisms, and the capability register.
|
|
41
|
+
- Find paired decisions: files that must change together with nothing tying them.
|
|
42
|
+
- Find token and syntax-tree clones (Type-1 to Type-3), including cross-platform counterparts.
|
|
43
|
+
- Find types and schemas restated by hand instead of derived from the generated or source schema.
|
|
44
|
+
- Find two libraries for one job, and one package resolved at several versions.
|
|
45
|
+
- Find copies outside code: SQL, shared config and i18n strings.
|
|
46
|
+
- Find wrong abstractions: merges that landed and serve different knowledge.
|
|
47
|
+
- Decide whether the next step for prevention is a guard or a sweep.
|
|
55
48
|
|
|
56
49
|
### Out of Scope
|
|
57
50
|
|
|
58
51
|
<!-- prettier-ignore -->
|
|
59
52
|
| Excluded item | Why | Where it belongs |
|
|
60
53
|
| --- | --- | --- |
|
|
61
|
-
| Single-call-site helpers |
|
|
62
|
-
| Capability with one implementation that is wrong |
|
|
63
|
-
| Unreachable modules beyond reference check |
|
|
64
|
-
| One-off structural problems; module-graph shape |
|
|
65
|
-
| Upgrading / removing dependencies |
|
|
66
|
-
| Mobile OS divergence (e.g
|
|
67
|
-
| Building the guard; CI wiring |
|
|
68
|
-
| Consolidating copies |
|
|
54
|
+
| Single-call-site helpers | They are not duplication | — |
|
|
55
|
+
| Capability with one implementation that is wrong | It is a gap, not duplication | Plan / `docs/failures.jsonl` |
|
|
56
|
+
| Unreachable modules beyond reference check | The dead-code sweep covers it | `bkit-audit-dead-code` |
|
|
57
|
+
| One-off structural problems; module-graph shape | The architecture sweep covers it | `bkit-audit-architecture` |
|
|
58
|
+
| Upgrading / removing dependencies | The dependency sweep covers it | `bkit-audit-dependencies` |
|
|
59
|
+
| Mobile OS divergence (e.g., iOS vs Android) | It is a test-lane blind spot | `bkit-audit-testing` |
|
|
60
|
+
| Building the guard; CI wiring | It is a gate change | `bkit-audit-gates` |
|
|
61
|
+
| Consolidating copies | The audit only reports | A plan made from this report |
|
|
69
62
|
|
|
70
63
|
### Verdicts
|
|
71
64
|
|
|
72
|
-
- **DUPLICATE:** one piece of knowledge
|
|
73
|
-
- **COINCIDENTAL:**
|
|
74
|
-
- **RULE-OF-THREE-PENDING:** two copies of one piece of knowledge. Record and watch; consolidate at the third.
|
|
75
|
-
- **OTHER:** fits
|
|
65
|
+
- **DUPLICATE:** the copies are one piece of knowledge, and change for the same reason. Name the consolidation and its home.
|
|
66
|
+
- **COINCIDENTAL:** the copies look alike, but change for different reasons. Leave them, and record why.
|
|
67
|
+
- **RULE-OF-THREE-PENDING:** there are two copies of one piece of knowledge. Record them and watch; consolidate at the third.
|
|
68
|
+
- **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
76
69
|
|
|
77
|
-
**Test:** same knowledge, same reason to change. A paired decision
|
|
70
|
+
**Test:** the copies hold the same knowledge, with the same reason to change. A paired decision is one decision in two places, so it is `DUPLICATE`, and its home is a paired-owner check or a gate.
|
|
78
71
|
|
|
79
72
|
**Confirm before `DUPLICATE`:**
|
|
80
73
|
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
- Similar defaults are one decision
|
|
84
|
-
- "
|
|
85
|
-
- Co-change history (`Coupling`) says one decision, or already diverged.
|
|
74
|
+
- A duplicated name is not a deliberate platform split (e.g., `.native.tsx` / `.web.tsx`) or a local UI handler.
|
|
75
|
+
- The bypass is gratuitous, not a surface the owner cannot serve (e.g., a framework-specific request context).
|
|
76
|
+
- Similar defaults are one decision. A least-privilege read default and a signup write default are not, and forcing one value breaks a flow.
|
|
77
|
+
- A "dead" or "unwired" copy has no config-only or deployed consumer: an explicit worker registry or a deployed function.
|
|
78
|
+
- Co-change history (`Coupling`) says it is one decision, or that the copies have already diverged.
|
|
86
79
|
|
|
87
|
-
Carry `COINCIDENTAL` and `RULE-OF-THREE-PENDING` forward in `Carried Forward
|
|
80
|
+
Carry `COINCIDENTAL` and `RULE-OF-THREE-PENDING` forward in `Carried Forward`, so a two-site finding is neither consolidated early nor rediscovered on every run.
|
|
88
81
|
|
|
89
82
|
### Pre-Flight / Dependencies
|
|
90
83
|
|
|
91
|
-
**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.
|
|
92
|
-
|
|
93
|
-
**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.
|
|
94
|
-
|
|
95
84
|
#### Core
|
|
96
85
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
- [ ] **
|
|
100
|
-
- [ ] **
|
|
101
|
-
- [ ] **
|
|
102
|
-
- [ ] **
|
|
103
|
-
- [ ] **
|
|
104
|
-
- [ ] **Git History:** Steps 4, 10 — full history for clone baseline, blame, and co-change. Fallback: growth and coupling `Not Checked`.
|
|
105
|
-
- [ ] **Web:** Step 14 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
86
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
87
|
+
- [ ] **Clean Tree:** Steps 2-13 — a clean `git status` at the recorded commit, because findings only mean something against a known tree. Fallback: use a detached worktree off the default branch.
|
|
88
|
+
- [ ] **Text Search:** Steps 3, 5, 7-10 — inline expressions, literals, env names and non-code files (e.g., ripgrep, `git grep`). Fallback: `grep -rn`.
|
|
89
|
+
- [ ] **Structural Search:** Steps 3, 12 — syntax patterns that skip comments and strings and catch reordered copies (e.g., ast-grep, Semgrep). Run it ad hoc, and record the resolved version. Fallback: text search, and mark reformatted copies `Not Checked`.
|
|
90
|
+
- [ ] **Clone Detector:** Steps 4, 8 — Type-1 to Type-3 clones (e.g., jscpd, PMD CPD). Run it ad hoc, and record the resolved version. Fallback: mark `Clones` `Not Checked`.
|
|
91
|
+
- [ ] **Git History:** Steps 4, 10 — the full history, for the clone baseline, blame and co-change. Fallback: mark growth and coupling `Not Checked`.
|
|
92
|
+
- [ ] **Web:** Step 14 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
106
93
|
|
|
107
94
|
#### Conditional
|
|
108
95
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
- [ ] **
|
|
112
|
-
- [ ] **
|
|
113
|
-
- [ ] **
|
|
114
|
-
- [ ] **Cross-Platform Compare:** 2+ platforms / apps sharing behaviour → Step 4 — counterpart listing, e.g. jscpd `--compare`. Fallback: text search for counterparts.
|
|
115
|
-
- [ ] **Package Manager:** Lockfile → Step 7 — dedupe check and resolution reason, e.g. `pnpm dedupe --check` / `pnpm why`, `npm ls --all`. Fallback: read lockfile.
|
|
96
|
+
- [ ] **Language Server:** **If** the language is typed → Steps 3, 5, 13 — references on helpers and owners (e.g., Serena, `tsserver`, pyright). Fallback: text search only. Treat caller sets as hypotheses, and `one` against `bypassed` as unproven.
|
|
97
|
+
- [ ] **Module Graph:** Steps 5, 10 — duplicate symbol names, god nodes and import edges (e.g., graphify, dependency-cruiser, madge). Fallback: mark the module-graph cross-check `Not Checked`.
|
|
98
|
+
- [ ] **Capability Register:** **If** a register exists → Step 5 — capability, owner and status, in verify-only mode. Fallback: derive the rows in `Capabilities` only. No register is a finding.
|
|
99
|
+
- [ ] **Cross-Platform Compare:** **If** 2 or more platforms or apps share behaviour → Step 4 — a counterpart listing (e.g., jscpd `--compare`). Fallback: text search for counterparts.
|
|
100
|
+
- [ ] **Package Manager:** **If** the project has a lockfile → Step 7 — the dedupe check and the resolution reason (e.g., `pnpm dedupe --check` / `pnpm why`, `npm ls --all`). Fallback: read the lockfile.
|
|
116
101
|
|
|
117
102
|
### 🔒 Gate 1: Prerequisites Check
|
|
118
103
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
122
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
104
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
105
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
123
106
|
|
|
124
107
|
### Probe Steps
|
|
125
108
|
|
|
126
|
-
- [ ] **Step 1 — Previous Run:**
|
|
127
|
-
- [ ] **Step 2 — Detect:** List apps, packages
|
|
128
|
-
- [ ] **Step 3 — Rule Altitude:** Hunt one conceptual operation inlined at N sites instead of called from one function, copies
|
|
129
|
-
- [ ] **Step 4 — Clones:**
|
|
130
|
-
- [ ] **Step 5 — Capability Altitude:**
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
139
|
-
-
|
|
140
|
-
-
|
|
109
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
110
|
+
- [ ] **Step 2 — Detect:** List the apps, packages and platforms; the shared homes (utility and owner modules); the capability register; and the duplication gates enforced, with what each one catches (e.g., an identical-signature gate catches identical copies only). **Done when:** `Checked` holds surface map and existing gates, or `N/A` is recorded → **STOP**.
|
|
111
|
+
- [ ] **Step 3 — Rule Altitude:** Hunt for one conceptual operation inlined at N sites instead of called from one function, where the copies differ on load-bearing details. Look at fallback chains (e.g., JS `a ?? b ?? c`, with a different terminal fallback or order); null against falsy (e.g., JS `??` against `||`, with or without trim, optional-chain guards); formatting (date, time and timezone, currency, name and initials, address); predicates ("is active / deleted / owner?" filters); and defaults (the same enum or config default hardcoded in several readers). Use structural rules where possible, and text search where not. A structural census searches both `fn($$$)` and the generic-call form `fn<$T>($$$)`, plus renamed imports, because a rule for the plain call misses the other two. Keep the rules under `tmp/`, and paste each one into the report for the next run. For each shared helper, subtract: the references on the helper are the routed set, the sites matching the inline pattern are the inline set, and inline-but-not-routed sites are unmigrated. Counts taken before a reference-graph change (e.g., project references added) are stale, so take them again; never carry them forward. **Done when:** `Inline Rules` has a row per rule: helper · routed · inline · unmigrated · verdict, with its search rule.
|
|
112
|
+
- [ ] **Step 4 — Clones:** Run the clone detector over the source roots, with machine-readable output, in three passes: Type-1 exact; Type-2 renamed (ignoring identifiers and literals); and Type-3 near-miss (e.g., similarity 0.85, syntax-tree mode). Exclude generated files (e.g., migration snapshots, generated types, import maps) before quoting a duplication %. Record the duplication % per package as a series against the previous report. Every hit is a candidate for `Verify`, not a finding. **If** there are multiple platforms → list the counterparts: the functions with and without a counterpart on each side. Growth: baseline the exact pass at the previous report's commit, then count the clones new since then against the ones consolidated since then, with blame naming who introduced each. Clones arriving faster than they are consolidated is a finding. **Done when:** `Clones` holds the per-package %, the growth and the counterpart list.
|
|
113
|
+
- [ ] **Step 5 — Capability Altitude:** Work above the file graph, on capabilities rather than files. For each capability, record the owner, the callers, the status and a note.
|
|
114
|
+
- Give each capability one status:
|
|
115
|
+
- `one` = there is one implementation, and every caller routes through it.
|
|
116
|
+
- `bypassed` = an owner exists, and some callers skip it.
|
|
117
|
+
- `split` = 2 or more implementations compete, with no owner.
|
|
118
|
+
- `gap` = it is designed but not built.
|
|
119
|
+
- Run all three detectors, because each one finds something the others miss:
|
|
120
|
+
- (a) Literal-mechanism search for a second mechanism (e.g., a second SDK client constructor, rate limiter, email-send call or duplicated validation regex). It is the primary detector, because the symbol graph cannot see a duplicated regex.
|
|
121
|
+
- (b) Language-server references on each owner. They give the caller set, and decide `one` against `bypassed`.
|
|
122
|
+
- (c) The module graph's duplicate-symbol-name check. It groups callable nodes by name across distinct non-test source files, and 3 or more definitions make a candidate. Its god-node list flags an owner that has become load-bearing.
|
|
123
|
+
- A register status that differs from the measured status is a finding.
|
|
124
|
+
- This run does not edit the register. Put each register correction in `Expected`.
|
|
125
|
+
|
|
126
|
+
**Done when:** `Capabilities` has a row per capability: owner · callers · measured status · register status · verdict.
|
|
127
|
+
|
|
128
|
+
- [ ] **Step 6 — Restated Types:** **If** the language is typed **and** there is a schema source (generated DB types, migrations, IDL) → for each core table, find the hand-written types, validation schemas and route validators that restate its columns, enums and constraints. A restatement not derived from the source is a finding. Diff it against the source: a column added, renamed or made nullable on one side only is a live defect. **Done when:** `Types` has a row per restated type: source · derived? · drift · verdict, or the skip is recorded with evidence.
|
|
129
|
+
- [ ] **Step 7 — Libraries:** Literal search finds a second client, not a second library. List the dependencies across every manifest that do one job: two date libraries, two validation libraries or two majors side by side, two HTTP clients, or two markdown parsers. Run the dedupe check, and give the resolution reason for every package at more than one version. Each one is a capability row, with the library as the mechanism. **Done when:** `Libraries` lists every same-job pair, and every multi-version package with its reason.
|
|
130
|
+
- [ ] **Step 8 — Outside Code:** SQL: access-policy bodies and helper functions redefined across migrations instead of one function. Shared config: type-checker, linter and styling presets copied between apps instead of extending a shared package. i18n: the same string under several keys. List the formats the clone detector supports, run it over migrations and config, and text search the rest. **Done when:** every hit is a candidate for `Verify`, and an absent surface is in `Checked`.
|
|
131
|
+
- [ ] **Step 9 — Wrong Abstractions:** This is the opposite failure: a merge that landed and should not have. Find shared helpers with boolean or mode parameters, or per-caller branches (e.g., `if (caller === …)`, more than 2 option flags), and fewer than 3 callers. **If** the callers serve different knowledge → recommend inlining it back. `Verify` guards new merges, and this step reviews old ones. **Done when:** `Wrong Abstractions` has a row per helper: params · callers · knowledge · verdict.
|
|
132
|
+
- [ ] **Step 10 — Coupling:** For each candidate set, read the co-change history (e.g., `git log --name-only`, code-maat). **If** the files always changed together → it is a true duplicate; consolidate it. **If** they changed separately → they have already diverged, so decide which behaviour is right first. Run the reverse detector: file pairs in different packages, or one per platform, that co-change in more than 50% of commits with no import edge are paired-decision candidates. Also find comments that tie two files together in prose (e.g., `keep in sync`, `must match`, `mirrors`). A pair goes straight to `Prevention`. **Done when:** `Coupling` has a row per candidate and pair: co-change share · import edge · verdict.
|
|
133
|
+
- [ ] **Step 11 — Confidence:** Name the tool behind every count.
|
|
134
|
+
- Grade each claim type:
|
|
135
|
+
- "A second implementation exists" = high, because every site was read rather than matched.
|
|
136
|
+
- Exact call-site counts = medium.
|
|
137
|
+
- "No production consumer" = medium, and needs corroboration in the code.
|
|
138
|
+
- "Does not exist" = high only when it is absent from the schema and from all source.
|
|
139
|
+
- Pace the language-server queries. The language server under-reports, which gives a false `one`.
|
|
140
|
+
- Re-run a surprisingly low or empty count before recording it.
|
|
141
|
+
- Corroborate an empty result with text search, because an empty result is inconclusive.
|
|
142
|
+
- Use text search for mocked-module factory keys and packages outside the project graph, because the language server cannot see them.
|
|
143
|
+
- Treat the module graph as proof of presence, never of absence. It misses callers in anonymous callbacks and module-level initialisers. Manifest-driven or type-only edges can fake cross-package edges and cycles, and the resolution cache goes stale after a path-alias change.
|
|
144
|
+
- Treat a count on which the language server and text search agree as the strongest evidence.
|
|
145
|
+
- **If** the language server and text search disagree on a count → name the file to open.
|
|
146
|
+
- **If** a count is corrected mid-run → record which count, from what, and by what tool.
|
|
147
|
+
|
|
148
|
+
**Done when:** `Method` grades every claim type and names the tool for each count, including the corrections.
|
|
149
|
+
|
|
150
|
+
- [ ] **Step 12 — Prevention:** Check whether a guard fails on re-implementation at both altitudes: an inline rule expression outside its helper, and a mechanism (a constructor, a send call, an env name) outside its owner. A bespoke guard per rule means one guard per consolidated field, forever. A structural rule per pattern (with owner-file ignores, the rules checked in, seeded from the Step 3 rules, each covering the plain call, the generic-call form and renamed imports), plus a literal search with an owner allowlist for env names, covers both altitudes without the language server. Record whether the recorded decisions favour a guard or a sweep, and whether evidence since then contradicts them. Do not build anything. **Done when:** `Prevention` states whether the next step is a guard or a sweep, with the evidence and the rules it would start from.
|
|
151
|
+
- [ ] **Step 13 — Verify:** Open every candidate file.
|
|
152
|
+
- Cite `file:line` for every survivor.
|
|
153
|
+
- Apply the `Verdicts` checks.
|
|
154
|
+
- Re-check the previous `Carried Forward` rows. A third copy makes one `DUPLICATE`.
|
|
155
|
+
- Rank the survivors by blast radius x divergence x user visibility.
|
|
156
|
+
- Name each survivor's consolidation and its home in `Expected`, for the next step to apply:
|
|
157
|
+
- A rule → one function in the correct shared package, with the inline copies removed.
|
|
158
|
+
- A capability → one owner module with a call contract, and the register row to update.
|
|
159
|
+
- A wrong abstraction → inline it back.
|
|
160
|
+
- A paired decision → a paired-owner check or a gate.
|
|
161
|
+
- A drifted type or a live defect → its finding, which becomes a `docs/failures.jsonl` row, fixed ahead of any refactor.
|
|
162
|
+
- A second library or version → `bkit-audit-dependencies`.
|
|
163
|
+
- A deliberate bypass blocked on other work → the register row to add, naming the blocker. An unrecorded bypass reads as `one` on the next run, which is a false clean.
|
|
164
|
+
- A one-off structural problem, or missing module-graph evidence → `bkit-audit-architecture`.
|
|
165
|
+
- **If** a consolidation changes a shared signature → `Expected` names the reference check to run first.
|
|
166
|
+
|
|
167
|
+
**Done when:** every candidate has a verdict, evidence, a rank and a home.
|
|
168
|
+
|
|
169
|
+
- [ ] **Step 14 — 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 standard, per clone type (Type-1 to Type-4), and per shape (rule, capability, paired decision), 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 15 — Anything Else:** (a) List everything changed since the previous report's commit that touches duplication (new shared helpers and owner modules, shared packages, cross-platform counterparts of a screen or hook, validation schemas and route validators, migrations adding tables, enums or policies, new dependencies, config presets and i18n keys), with a one-line verdict each. (b) In a bounded pass of about 30 minutes, note what a senior engineer owning shared packages would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), 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`.
|
|
141
171
|
|
|
142
172
|
### 🔒 Gate 2: Probes Check
|
|
143
173
|
|
|
144
|
-
**
|
|
145
|
-
|
|
146
|
-
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
147
|
-
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
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.
|
|
148
176
|
- [ ] **Sites read:** every `DUPLICATE` cites `file:line` from an opened file, not a match.
|
|
149
|
-
- [ ] **
|
|
150
|
-
- [ ] **
|
|
177
|
+
- [ ] **Other writers:** `Not Checked` names every changed path that this run did not write.
|
|
178
|
+
- [ ] **Registers unchanged:** the tracked registers and graphs are unchanged.
|
|
179
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
151
180
|
|
|
152
181
|
## Findings
|
|
153
182
|
|
|
154
183
|
<!-- prettier-ignore -->
|
|
155
184
|
| Severity | Use |
|
|
156
185
|
| --- | --- |
|
|
157
|
-
| `CRITICAL` |
|
|
158
|
-
| `HIGH` |
|
|
159
|
-
| `MEDIUM` | Copies consistent today
|
|
160
|
-
| `LOW` |
|
|
186
|
+
| `CRITICAL` | A divergent copy disables a security or access control (e.g., a rate limiter, auth or a tenancy check), or loses data. A workflow is broken with no workaround. |
|
|
187
|
+
| `HIGH` | Copies of one rule diverge in a way users can see. A hand-written type has drifted from the schema. A paired decision is out of step. A `split` capability sits on a request path. |
|
|
188
|
+
| `MEDIUM` | Copies are consistent today, with drift risk and no live bug. An owner is `bypassed`. The register status differs from the measured one. An abstraction is wrong. Two libraries or versions do one job. SQL, config or i18n is copied. Clone growth outpaces consolidation. |
|
|
189
|
+
| `LOW` | Copies are cosmetic. Clones are test-only. A stale register note changes no status. |
|
|
161
190
|
|
|
162
|
-
|
|
191
|
+
Within a severity, list higher blast radius x divergence x user visibility first.
|
|
163
192
|
|
|
164
193
|
<!-- prettier-ignore -->
|
|
165
194
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
166
195
|
| --- | --- | --- | --- | --- | --- |
|
|
167
196
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
168
197
|
|
|
169
|
-
|
|
198
|
+
**If** the run finds nothing → write one row: `None`.
|
|
170
199
|
|
|
171
200
|
## Report
|
|
172
201
|
|
|
@@ -247,17 +276,17 @@ PENDING
|
|
|
247
276
|
|
|
248
277
|
### 🔒 Gate 3: Report Check
|
|
249
278
|
|
|
250
|
-
**
|
|
251
|
-
|
|
252
|
-
- [ ] **
|
|
253
|
-
- [ ] **
|
|
254
|
-
- [ ] **Series:** per-package duplication % and clone growth beside previous report's numbers, or
|
|
255
|
-
- [ ] **Writes:** only this report
|
|
256
|
-
- [ ] **
|
|
257
|
-
- [ ] **
|
|
258
|
-
- [ ] **
|
|
259
|
-
|
|
260
|
-
|
|
279
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
280
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
281
|
+
- [ ] **Verdict counts:** `Summary` gives the count per verdict.
|
|
282
|
+
- [ ] **Guard or sweep:** `Summary` states the guard-or-sweep call.
|
|
283
|
+
- [ ] **Series:** the report shows per-package duplication % and clone growth beside the previous report's numbers, or marks the run as baseline.
|
|
284
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
285
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
286
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
287
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
288
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
289
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
261
290
|
|
|
262
291
|
<!-- bkit:end -->
|
|
263
292
|
|