@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,148 +1,166 @@
|
|
|
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
|
# Architecture Review
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** A judgment on the codebase's shape: the package graph, the intended layers, the server and client boundary, and the coupling the import graph cannot see.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - A code graph confirms presence; a missing edge proves nothing. Corroborate every load-bearing claim with a language server or text search before it is a finding.
|
|
23
|
-
> - Build the graph locally and code-only; NEVER send the corpus or credentials to a model backend.
|
|
14
|
+
> - A code graph confirms presence. A missing edge proves nothing.
|
|
15
|
+
> - Corroborate every load-bearing claim with a language server or text search before it becomes a finding.
|
|
16
|
+
> - Build the graph locally, from code only.
|
|
17
|
+
> - NEVER send the corpus or credentials to a model backend.
|
|
24
18
|
|
|
25
19
|
## Universal Instructions
|
|
26
20
|
|
|
27
21
|
### Context & Goals
|
|
28
22
|
|
|
29
|
-
|
|
23
|
+
Reading files cannot show whether the package graph is acyclic, which modules are hubs, or where types were copied. A code graph and a language server fail in different ways: graph edges can be false, and edges the graph omits prove nothing. The failure this audit targets is a shape enforced in a diagram or a clean graph, but not in source. Examples: a type-only cycle treated as a runtime cycle, a manifest edge treated as a package dependency, or a privileged module reachable from the client bundle.
|
|
30
24
|
|
|
31
|
-
**Applies when:** more than one package, or a written layer model.
|
|
25
|
+
**Applies when:** the repo has more than one package, or a written layer model. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
32
26
|
|
|
33
|
-
**Cadence:**
|
|
27
|
+
**Cadence:** Run once a quarter. Run an extra pass when a cycle adds a package, moves a module, or changes path aliases or project references. The walk through the production checklists is part of the quarterly pass.
|
|
34
28
|
|
|
35
|
-
**Anchor Standards:**
|
|
29
|
+
**Anchor Standards:**
|
|
36
30
|
|
|
37
31
|
- C4 model (System Context, Container, Component).
|
|
38
|
-
- Architecture decision records (e.g
|
|
39
|
-
- Product quality model, nine characteristics (e.g
|
|
40
|
-
- Quality-attribute scenarios (e.g
|
|
41
|
-
- Package metrics: afferent coupling (Ca), efferent coupling (Ce), instability, abstractness, Stable Dependencies Principle (e.g
|
|
42
|
-
- Compiler-resolving dependency linter (e.g
|
|
43
|
-
- Workspace boundary checker (e.g
|
|
44
|
-
- Layer-boundary linter (e.g
|
|
45
|
-
- Well-architected pillars as a lens (e.g
|
|
46
|
-
- Server and client component boundary, including a build-failing server-only guard (e.g
|
|
47
|
-
- Host production checklists (e.g
|
|
32
|
+
- Architecture decision records (e.g., adr.github.io) and architectural fitness functions (e.g., _Building Evolutionary Architectures_).
|
|
33
|
+
- Product quality model, nine characteristics (e.g., ISO/IEC 25010:2023).
|
|
34
|
+
- Quality-attribute scenarios (e.g., ATAM utility tree).
|
|
35
|
+
- Package metrics: afferent coupling (Ca), efferent coupling (Ce), instability, abstractness, Stable Dependencies Principle (e.g., Robert C. Martin).
|
|
36
|
+
- Compiler-resolving dependency linter (e.g., dependency-cruiser, import-linter); record version.
|
|
37
|
+
- Workspace boundary checker (e.g., `turbo boundaries`, Nx module boundaries); record version.
|
|
38
|
+
- Layer-boundary linter (e.g., eslint-plugin-boundaries, ArchUnit).
|
|
39
|
+
- Well-architected pillars as a lens (e.g., AWS Well-Architected, Azure Well-Architected).
|
|
40
|
+
- Server and client component boundary, including a build-failing server-only guard (e.g., Next.js Server and Client Components, `server-only`).
|
|
41
|
+
- Host production checklists (e.g., Vercel, Supabase, Fly).
|
|
48
42
|
|
|
49
43
|
### Scope
|
|
50
44
|
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
45
|
+
- Check the package dependency graph: cycles, back-edges, coupling metrics, fan-in, fan-out and duplicate symbols.
|
|
46
|
+
- Check conformance to a written layer matrix, public entry points and deep imports.
|
|
47
|
+
- Check the server and client boundary, and the privileged modules.
|
|
48
|
+
- Find the coupling that has no import edge: events, data ownership and change coupling.
|
|
49
|
+
- Compare the shape with the recorded decisions, the context and container views, and the quality-attribute scenarios.
|
|
50
|
+
- Find production-checklist gaps, and route each one to the audit that owns it.
|
|
57
51
|
|
|
58
52
|
### Out of Scope
|
|
59
53
|
|
|
60
54
|
<!-- prettier-ignore -->
|
|
61
55
|
| Excluded item | Why | Where it belongs |
|
|
62
56
|
| --- | --- | --- |
|
|
63
|
-
| Whether a symbol is reachable |
|
|
64
|
-
| Confirmed same-name copies, once named |
|
|
65
|
-
| Auth holes and secret exposure in depth |
|
|
66
|
-
| A table written from several places, in depth |
|
|
67
|
-
| Cold-start time and request latency |
|
|
68
|
-
| Job retries and idempotency in depth |
|
|
69
|
-
| Changing packages, layers, or the graph |
|
|
57
|
+
| Whether a symbol is reachable | It is about reachability, not shape | `bkit-audit-dead-code` |
|
|
58
|
+
| Confirmed same-name copies, once named | The duplication audit owns them | `bkit-audit-duplication` |
|
|
59
|
+
| Auth holes and secret exposure in depth | The security audit owns them | `bkit-audit-security` |
|
|
60
|
+
| A table written from several places, in depth | The database audit owns it | `bkit-audit-database` |
|
|
61
|
+
| Cold-start time and request latency | The performance audit owns hot paths | `bkit-audit-app-performance` |
|
|
62
|
+
| Job retries and idempotency in depth | The reliability audit owns them | `bkit-audit-reliability` |
|
|
63
|
+
| Changing packages, layers, or the graph | The audit only reports | A plan made from this report |
|
|
70
64
|
|
|
71
65
|
### Pre-Flight / Dependencies
|
|
72
66
|
|
|
73
|
-
**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.
|
|
74
|
-
|
|
75
|
-
**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.
|
|
76
|
-
|
|
77
67
|
#### Core
|
|
78
68
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
- [ ] **
|
|
82
|
-
- [ ] **
|
|
83
|
-
- [ ] **
|
|
84
|
-
- [ ] **Git History:** Steps 1, 9, 13 — change coupling and the diff since the previous report. Fallback: change coupling `Not Checked`.
|
|
85
|
-
- [ ] **Web:** Step 12 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
69
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
70
|
+
- [ ] **Code Graph:** Steps 2-4 — a local, code-only extractor (e.g., graphify through a wrapper that strips API keys). Fallback: use the dependency linter and text search, and mark the graph counts `Not Checked`.
|
|
71
|
+
- [ ] **Dependency Linter:** Steps 5-6 — a linter that resolves through the compiler (e.g., dependency-cruiser, import-linter). Fallback: read the import statements, and say so for each claim.
|
|
72
|
+
- [ ] **Git History:** Steps 1, 9, 13 — change coupling and the diff since the previous report. Fallback: mark change coupling `Not Checked`.
|
|
73
|
+
- [ ] **Web:** Step 12 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
86
74
|
|
|
87
75
|
#### Conditional
|
|
88
76
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
- [ ] **
|
|
92
|
-
- [ ] **Workspace Boundaries:** Monorepo task runner with a boundaries command → Step 5 — e.g. `turbo boundaries`, Nx. Fallback: layer matrix by hand.
|
|
93
|
-
- [ ] **Host Checklists:** Managed host → Step 10 — production checklist, e.g. vendor docs, dashboard. Fallback: docs only; live settings `Not Checked`.
|
|
77
|
+
- [ ] **Language Server:** **If** the language is typed → Steps 7, 11 — references (e.g., Serena, `tsserver`, gopls). Fallback: text search, and name the tool for each claim. Repeat any surprisingly low count.
|
|
78
|
+
- [ ] **Workspace Boundaries:** **If** a monorepo task runner has a boundaries command → Step 5 — its boundary check (e.g., `turbo boundaries`, Nx). Fallback: check the layer matrix by hand.
|
|
79
|
+
- [ ] **Host Checklists:** **If** the app runs on a managed host → Step 10 — the production checklist (e.g., vendor docs, dashboard). Fallback: use the docs only, and mark live settings `Not Checked`.
|
|
94
80
|
|
|
95
81
|
### 🔒 Gate 1: Prerequisites Check
|
|
96
82
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
100
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
83
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
84
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
101
85
|
|
|
102
86
|
### Probe Steps
|
|
103
87
|
|
|
104
|
-
- [ ] **Step 1 — Previous Run:**
|
|
105
|
-
- [ ] **Step 2 — Graph:** Build locally, code
|
|
106
|
-
- [ ] **Step 3 — Report:** Read extractor report.
|
|
107
|
-
- [ ] **Step 4 — Structure:** Query built graph
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
88
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
89
|
+
- [ ] **Step 2 — Graph:** Build the graph locally, from code only, with credentials stripped, through the project wrapper (never a bare extract). Record the tool version, `built_at_commit`, the node count, the edge count and the cross-package edge count. **If** the graph commit != the reviewed `HEAD` → the findings are invalid, so rebuild. Keep the derived output untracked. A clean rebuild deletes only that output. **If** path aliases changed → do a clean rebuild, because a force flag that does not clear the module-resolution cache keeps stale unresolved edges. A syntax-only graph (e.g., tree-sitter) does not consult the language server. Path aliases and manifest names are separate inputs, and losing either one drops edges with no error. Keep the manifests in the corpus so workspace imports resolve, then drop manifest-to-manifest edges before building the matrix. Skip the whole-repo render, and use package and module rollups. **If** the tool keeps dated extractor backups → they accumulate, and a clean rebuild clears them. **Done when:** `Graph` holds the commit, the counts and the tool list, or `Not Checked` names the absent tool.
|
|
90
|
+
- [ ] **Step 3 — Report:** Read the extractor's report. Check every finding-like section against source before it counts. Import cycles: a type-only edge is erased at compile time, so it is not a runtime cycle. Check every edge. Cross-package edges: once aliases resolve, do not dismiss them as impossible, but do dismiss manifest-to-manifest edges. God nodes: a high degree is a reason to look, not a defect. **If** a community dump has numbered labels and near-zero cohesion → the clustering found no structure, so skip it. **Done when:** `Graph` gives each section a disposition.
|
|
91
|
+
- [ ] **Step 4 — Structure:** Query the built graph first, then the graph file.
|
|
92
|
+
- Apply the filters first: code only (source extensions; drop manifests and config), with tests separated by the repo's one test-path rule. Do not type a shorter list.
|
|
93
|
+
- Test files cross boundaries, so counting them as product hides the shape. Views with and without test code can both be correct, so record which one you use.
|
|
94
|
+
- Keep dependency-shaped edges only (import, re-export, dynamic import). Nesting is not dependency.
|
|
95
|
+
- Exclude name-matching edges (e.g., `indirect_call`), because they can invent links between unrelated files that share a function name.
|
|
96
|
+
- Blast radius under-reports: it misses callers in anonymous callbacks and calls in module-level initialisers. A blast-radius set is a starting set, never a complete one.
|
|
97
|
+
- Run these checks, each as a series:
|
|
98
|
+
- (1) Package dependencies:
|
|
99
|
+
- Build the package dependency matrix, code only, and find the back-edges (library→app, leaf→consumer). It should be a DAG.
|
|
100
|
+
- For each workspace, compute Ca, Ce, instability I = Ce/(Ca+Ce) and abstractness (the share of exported types and interfaces).
|
|
101
|
+
- Flag a package that depends on a less stable one.
|
|
102
|
+
- (2) Find file-level cycles (SCC over import edges). A component of more than 1 file is a candidate for the type-only check.
|
|
103
|
+
- (3) Fan-in: rank the files everything imports.
|
|
104
|
+
- (4) Fan-out: rank the files with the most imports, which are barrels and god modules.
|
|
105
|
+
- (5) Duplicate symbol names:
|
|
106
|
+
- Group callables by label across distinct non-test source files. A name with >=3 definitions is a prompt to look. Per-directory handlers and platform splits (e.g., `.native` / `.web`) are false positives. The signal is a type or component duplicated where a canonical one exists.
|
|
107
|
+
- Run the same grouping over test code alone.
|
|
108
|
+
- Find copies without a shared name with text search.
|
|
109
|
+
- Confirmed hits go to `bkit-audit-duplication`.
|
|
110
|
+
|
|
111
|
+
**Done when:** `Structure` holds the matrix, the cycles, the rankings and the duplicates.
|
|
112
|
+
|
|
113
|
+
- [ ] **Step 5 — Layers:** A back-edge hunt with no written model lets a legal but wrong dependency pass.
|
|
114
|
+
- Carry the allowed package-layer matrix forward from the previous report.
|
|
115
|
+
- **If** there is no matrix → draft one from the recorded architecture decisions, and mark it proposed.
|
|
116
|
+
- Diff the code-only matrix against it. Every disallowed edge is a candidate.
|
|
117
|
+
- Encode the matrix as forbidden rules for the compiler-resolving linter, with its config under the repo-root `tmp/` only and type-only edges excluded.
|
|
118
|
+
- Check the extractor's import cycles. A rule that runs clean is a fitness function to propose under `Process Improvements`.
|
|
119
|
+
- Run the workspace boundary checker, and record its version. A clean result is a candidate for a package-DAG gate, not proof.
|
|
120
|
+
- **If** there is a native or restricted app →
|
|
121
|
+
- Check that no package it imports transitively has a server-only or host-only module (e.g., `fs`, a server-only import, a service-role client).
|
|
122
|
+
- Write a forbidden rule for it, so a bundle break or a client secret is caught by structure.
|
|
123
|
+
- Public entry points:
|
|
124
|
+
- Check that every workspace package declares them where the ecosystem supports it (e.g., the Node `exports` map, Go `internal/`). Deep imports past them are candidates.
|
|
125
|
+
- Name the enforcing rule each one would need.
|
|
126
|
+
|
|
127
|
+
**Done when:** `Layers` holds every disallowed edge, with the rule that would forbid it.
|
|
128
|
+
|
|
129
|
+
- [ ] **Step 6 — Boundary:** List the modules that import a privileged data client, a service-role secret or a non-public secret. Confirm that each one imports a guard that turns a client import into a build error (e.g., `server-only`), where the stack has one. **If** the stack has none → the reach check stands alone, so say so. Confirm that no client-entry module reaches one transitively, because a client entry pulls its imports into the client bundle. Compute that reach over runtime edges only: a type-only import is erased at compile time. Use text search for the list, the linter or blast radius for reach, and `Cross-Check` to confirm. **Done when:** `Boundary` holds every privileged module, with its guard, reach and verdict.
|
|
130
|
+
- [ ] **Step 7 — Cross-Check:** The language server answers from disk, so it shows no mid-edit staleness, and it resolves what the tree-sitter graph cannot. The graph misses callers in anonymous callbacks. The language server misses what the project graph cannot reach. Confirm fan-in and blast radius with references before the write-up. Pace the reference queries, because back-to-back calls can return a partial count that looks the same as a real one. **If** a count is surprisingly low → repeat it after a pause. An empty result is inconclusive. Neither tool sees these blind spots: middleware guards, config-referenced files, runtime-registered handlers, mock-factory keys, packages outside the language server's project graph, and dynamic imports whose specifier is not a literal (e.g., a variable or cast string, or a bundler ignore comment). Use text search for non-source files, string literals and unknown names. **Done when:** every load-bearing claim in `Cross-Check` names both tools, or the blind spot.
|
|
131
|
+
- [ ] **Step 8 — References:** Pick 2-3 well-regarded OSS repos on the same stack, and compare their shape: package boundaries, where shared code lives, the config and env split, and how client code is shared. Record the repo name, the commit or tag, and the comparison. A difference is a soft signal, not a finding on its own. Report it only with the problem it would solve here, mark it low-confidence, and never rank it above a graph finding. **Done when:** `References` holds the repos, revisions and comparisons, or `none`.
|
|
132
|
+
- [ ] **Step 9 — Coupling:** Three kinds of coupling carry no import edge. Events and runtime wiring: compare every event sent with the handlers registered, plus schedules, DB triggers, outbound DB HTTP, edge functions and inbound webhooks. Flag a producer without a consumer, a consumer without a producer, and two packages coupled only through an event. Data ownership: list the table and routine call sites per package, app, and script or CLI directory. Flag a table written from more than 1 module or app, and a table written through a privileged client from more than 1 place. Change coupling: find the file pairs, in commits since the previous report, that sit in different packages or clients and change together in more than half of the commits, with no import edge. Confirmed pairs go to `bkit-audit-duplication`. **Done when:** `Coupling` holds the events, tables and pairs.
|
|
133
|
+
- [ ] **Step 10 — Judgment:** Judge the shape on four criteria. Decisions against code: check that every architecture-scoped decision is still honoured, and name what enforces it (a lint, a dependency rule, a test). A decision nothing enforces is a finding. Shape with no decision behind it is undocumented architecture. Context and containers: draw the C4 System Context and Container views in Mermaid, from the previous report's views, corrected. Every external service in the code and the env schema appears, and nothing retired stays on the diagram. The capability register is a package-level view only. Annotate the Container view with each compute and data region, read live. A request that crosses regions on every call is a finding. Quality attributes: pick the product-quality characteristics that matter, and write one scenario for each (stimulus, environment, response, response measure). Carry them forward, and judge whether the shape meets each one. Production checklists (quarterly): walk the host checklists, and route each gap to the audit that owns it. **Done when:** `Judgment` holds the decisions, the views, the scenarios and the routed gaps.
|
|
134
|
+
- [ ] **Step 11 — Verify:** Give no finding without opening the file. Confirm that a cycle is runtime, not type-only; that a cross-package edge is a real source import, not a shared manifest name; that a privileged call site is unguarded, not guarded by middleware the tools cannot see; and that a duplicated name is real duplication, not a platform split or a local handler. Cite `file:line`. Destinations (name; do not file): confirmed copies and change-coupled pairs go to `bkit-audit-duplication`; reachability, or an event without a producer or consumer, goes to `bkit-audit-dead-code`; a server-only module reached from the client, or a secret in the native bundle, goes to `bkit-audit-security`; a table with several writers goes to `bkit-audit-database`; a production-checklist gap goes to the audit that owns it (`bkit-audit-security`, `bkit-audit-app-performance`, `bkit-audit-database`, `bkit-audit-reliability`); anything else goes to the slug this report names. **Done when:** every surviving candidate has its `file:line`, tool and destination.
|
|
135
|
+
- [ ] **Step 12 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per anchor standard and one per product-quality characteristic, each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
136
|
+
- [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches shape: workspaces added or removed, manifest dependencies between workspaces, export maps, path aliases and project references, moved modules, new jobs and events, migrations that add tables, and new external services in the env schema. (b) Spend a bounded pass of about 30 minutes on what a senior architect would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs`, 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`.
|
|
117
137
|
|
|
118
138
|
### 🔒 Gate 2: Probes Check
|
|
119
139
|
|
|
120
|
-
**
|
|
121
|
-
|
|
122
|
-
- [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
|
|
123
|
-
- [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
|
|
140
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
141
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
124
142
|
- [ ] **Presence only:** no finding rests on a missing edge alone.
|
|
125
|
-
- [ ] **Graph commit:** graph was built from the reviewed commit, or the mismatch is itself a finding.
|
|
126
|
-
- [ ] **Gate 2
|
|
143
|
+
- [ ] **Graph commit:** the graph was built from the reviewed commit, or the mismatch is itself a finding.
|
|
144
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
127
145
|
|
|
128
146
|
## Findings
|
|
129
147
|
|
|
130
148
|
<!-- prettier-ignore -->
|
|
131
149
|
| Severity | Use |
|
|
132
150
|
| --- | --- |
|
|
133
|
-
| `CRITICAL` |
|
|
134
|
-
| `HIGH` |
|
|
135
|
-
| `MEDIUM` |
|
|
136
|
-
| `LOW` |
|
|
151
|
+
| `CRITICAL` | A privileged or secret-bearing module is reachable from a client bundle or a native app |
|
|
152
|
+
| `HIGH` | A runtime cycle or a back-edge across the intended layers. A privileged call site that nothing either tool can see guards |
|
|
153
|
+
| `MEDIUM` | An architecture decision that nothing enforces. A confirmed duplicate where a canonical symbol exists. An event with no producer or no consumer |
|
|
154
|
+
| `LOW` | A low-confidence shape difference from a reference repo. Diagram drift that changes no boundary |
|
|
137
155
|
|
|
138
|
-
|
|
156
|
+
Within a severity, list boundary and secrets findings first.
|
|
139
157
|
|
|
140
158
|
<!-- prettier-ignore -->
|
|
141
159
|
| ID | Severity | Location | Evidence | Expected |
|
|
142
160
|
| --- | --- | --- | --- | --- |
|
|
143
161
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
144
162
|
|
|
145
|
-
|
|
163
|
+
**If** the run finds nothing → write one row: `None`.
|
|
146
164
|
|
|
147
165
|
## Report
|
|
148
166
|
|
|
@@ -215,17 +233,17 @@ PENDING
|
|
|
215
233
|
|
|
216
234
|
### 🔒 Gate 3: Report Check
|
|
217
235
|
|
|
218
|
-
**
|
|
219
|
-
|
|
220
|
-
- [ ] **
|
|
221
|
-
- [ ] **
|
|
222
|
-
- [ ] **Series:** node, edge, and cross-package counts, and the coupling table, beside previous report's numbers, or
|
|
223
|
-
- [ ] **Writes:** only this report
|
|
224
|
-
- [ ] **
|
|
225
|
-
- [ ] **
|
|
226
|
-
- [ ] **
|
|
227
|
-
|
|
228
|
-
|
|
236
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
237
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
238
|
+
- [ ] **Tools:** `Summary` names the tools available.
|
|
239
|
+
- [ ] **Graph commit named:** `Summary` names the graph commit.
|
|
240
|
+
- [ ] **Series:** the report shows node, edge, and cross-package counts, and the coupling table, beside the previous report's numbers, or marks the run as baseline.
|
|
241
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
242
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
243
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
244
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
245
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
246
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
229
247
|
|
|
230
248
|
<!-- bkit:end -->
|
|
231
249
|
|