@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# bkit Adoption Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,140 +11,149 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> -
|
|
19
|
-
> -
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - NEVER print or copy a token, key, or secret value; names and presence only.
|
|
23
|
-
> - never run `bkit install` / `bkit upgrade`; bkit commands = `bkit check`, `bkit doctor` only.
|
|
24
|
-
> - NEVER run a hook, script, or tool that writes, commits, pushes, or calls a remote write API; syntax checks and read-only modes only.
|
|
25
|
-
> - No skip record exists: every unadopted template is re-listed each run, with the previous verdict and its age.
|
|
14
|
+
> - NEVER print or copy a token, key or secret value. Record names and presence only.
|
|
15
|
+
> - Do not run `bkit install` / `bkit upgrade`.
|
|
16
|
+
> - Run only `bkit check` and `bkit doctor` among the bkit commands.
|
|
17
|
+
> - NEVER run a hook, script or tool that writes, commits, pushes or calls a remote write API.
|
|
18
|
+
> - Run hooks, scripts and tools only as syntax checks or in read-only modes.
|
|
19
|
+
> - Re-list every unadopted template on each run, with the previous verdict and its age, because no skip record exists.
|
|
26
20
|
|
|
27
21
|
## Universal Instructions
|
|
28
22
|
|
|
29
23
|
### Context & Goals
|
|
30
24
|
|
|
31
|
-
bkit ships three folders.
|
|
25
|
+
bkit ships three folders. A file's path inside its folder is the path it lands at in the repo.
|
|
32
26
|
|
|
33
27
|
<!-- prettier-ignore -->
|
|
34
28
|
| Package folder | Install does | Repo gets |
|
|
35
29
|
| --- | --- | --- |
|
|
36
|
-
| `.bkit/core/` | Writes
|
|
37
|
-
| `.bkit/shared/` | Writes
|
|
38
|
-
| `.bkit/templates/` | Never writes into the repo
|
|
30
|
+
| `.bkit/core/` | Writes its files and keeps them current. It never writes `engine/`, `workflows/` or `prompts/` as they are: workflows and prompts render to host agent and command copies | Whole files, managed blocks, hooks, reference docs in `.bkit/`, audit and plan templates |
|
|
31
|
+
| `.bkit/shared/` | Writes its files and keeps them current | bkit blocks and keys inside files you also edit (`docs/*.md`, `.gitignore`, settings, tool-server config) |
|
|
32
|
+
| `.bkit/templates/` | Never writes them into the repo. It keeps a raw copy at `.bkit/templates/`, and `bkit upgrade` lists the changed paths | Nothing until you copy one and own it |
|
|
39
33
|
|
|
40
|
-
`bkit check` proves written files match the package. Nothing proves the rest: a template never copied, a copy whose tool never runs, a written doc
|
|
34
|
+
`bkit check` proves that the written files match the package. Nothing proves the rest: a template never copied, a copy whose tool never runs, a written doc that holds only bkit's block, or a shipped audit never run. The failure this audit targets is a shipped piece that would have caught something but sits unused or half-wired, while every check stays green. Examples: `.husky/pre-push` was never copied, so tests run only in CI; `.lintstagedrc.json` was copied, but `pre-commit` never calls lint-staged; `{{NODE_VERSION}}` was left raw in `bkit-ci.yml`; `bkit-cloud.yml` waits on a workflow name that no longer exists; `docs/security.md` holds bkit's block and nothing else; `bkit-audit-security` was never run; or the install is three releases behind, with hand edits inside managed blocks.
|
|
41
35
|
|
|
42
|
-
**Applies when:** `.bkit/version` present.
|
|
36
|
+
**Applies when:** `.bkit/version` is present. **If** it is absent → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
43
37
|
|
|
44
|
-
**Cadence:**
|
|
38
|
+
**Cadence:** Run once a month. Run an extra pass after `bkit upgrade`, after adopting or dropping a template, and after adding an agent host.
|
|
45
39
|
|
|
46
|
-
**Anchor Standards:**
|
|
40
|
+
**Anchor Standards:** Record the bkit version and the date read.
|
|
47
41
|
|
|
48
|
-
- bkit, at the installed version: `.bkit/templates.md` (Contract, placeholders, Context-fetch blocks), `.bkit/README.md` § File ownership and § Ongoing CLI, `.bkit/install.md
|
|
49
|
-
- Config reference of each tool behind an adopted template (e.g
|
|
42
|
+
- bkit, at the installed version: `.bkit/templates.md` (Contract, placeholders, Context-fetch blocks), `.bkit/README.md` § File ownership and § Ongoing CLI, `.bkit/install.md`, and the release notes since the pinned version.
|
|
43
|
+
- Config reference of each tool behind an adopted template (e.g., Husky, lint-staged, Vale, Prettier, Renovate, Dependabot, Trivy, GitHub Actions workflow syntax, direnv). Record the version read.
|
|
50
44
|
|
|
51
45
|
### Scope
|
|
52
46
|
|
|
53
|
-
- Inventory
|
|
54
|
-
-
|
|
55
|
-
- `bkit check` drift
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
47
|
+
- Inventory every file in the package's `core/`, `shared/` and `templates/` against `.bkit/version` `canonicalHashes` and against the repo's `.bkit/templates/` copy.
|
|
48
|
+
- Compare the pinned, installed and registry-latest versions.
|
|
49
|
+
- Read the `bkit check` drift.
|
|
50
|
+
- Read the `bkit doctor` advisories.
|
|
51
|
+
- Compare the agent hosts in use with the bkit hosts installed.
|
|
52
|
+
- Check the agent, command and hook copies for each host.
|
|
53
|
+
- Check that the managed blocks and owned keys in written files are untouched.
|
|
54
|
+
- Check that each file bkit shares with you carries your part.
|
|
55
|
+
- Check that each audit template was run within its cadence.
|
|
56
|
+
- Record whether each template is adopted, and why when it is not.
|
|
57
|
+
- Check that each adopted copy is filled, reconciled, merged after upgrade, wired and running.
|
|
58
|
+
- Check that there is one context-fetch block per context with a lane, and that each matches the lane it names.
|
|
61
59
|
|
|
62
60
|
### Out of Scope
|
|
63
61
|
|
|
64
62
|
<!-- prettier-ignore -->
|
|
65
63
|
| Excluded item | Why | Where it belongs |
|
|
66
64
|
| --- | --- | --- |
|
|
67
|
-
| Agent permissions, hooks firing, tool servers, parity across hosts — bkit-shipped gates included |
|
|
68
|
-
| Whether a doc's content is true |
|
|
69
|
-
| Branch protection, required checks, hosted variables |
|
|
70
|
-
| CI token permissions, action pinning, secret rotation |
|
|
71
|
-
| Lint and scanner suppressions inside adopted configs |
|
|
72
|
-
| Whether a sweep here should become a gate |
|
|
73
|
-
| Copying, editing
|
|
65
|
+
| Agent permissions, hooks firing, tool servers, parity across hosts — bkit-shipped gates included | The agent config sweep owns them | `bkit-audit-agents` |
|
|
66
|
+
| Whether a doc's content is true | The documentation sweep owns it | `bkit-audit-documentation` |
|
|
67
|
+
| Branch protection, required checks, hosted variables | The config sweep owns them | `bkit-audit-config` |
|
|
68
|
+
| CI token permissions, action pinning, secret rotation | The security sweep owns them | `bkit-audit-security` |
|
|
69
|
+
| Lint and scanner suppressions inside adopted configs | The slop sweep owns them | `bkit-audit-slop` |
|
|
70
|
+
| Whether a sweep here should become a gate | The gate sweep owns it | `bkit-audit-gates` |
|
|
71
|
+
| Copying, editing or merging a template; running `bkit install` / `bkit upgrade` | The audit only reports | A plan made from this report |
|
|
74
72
|
|
|
75
73
|
### Pre-Flight / Dependencies
|
|
76
74
|
|
|
77
|
-
**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.
|
|
78
|
-
|
|
79
|
-
**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.
|
|
80
|
-
|
|
81
75
|
#### Core
|
|
82
76
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **
|
|
87
|
-
- [ ] **
|
|
88
|
-
- [ ] **bkit CLI:** Steps 4, 5 — `bkit check`, `bkit doctor` (or `pnpm bkit …`). Fallback: hash written files against `canonicalHashes` by hand; advisories `Not Checked`.
|
|
89
|
-
- [ ] **Registry:** Step 3 — latest version and release notes (e.g. `npm view @cbartens/bkit version`, release page). Fallback: pinned vs installed only; currency `Not Checked`.
|
|
77
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
78
|
+
- [ ] **Checkout:** Steps 2-11 — a repo with `.bkit/version`. Fallback: none. **If** it is absent → write one `N/A` row, then **STOP**.
|
|
79
|
+
- [ ] **Package:** Step 2 — the installed package root (e.g., `node_modules/@cbartens/bkit/.bkit/`, resolved through the package manager). Fallback: unpack the pinned version into a throwaway directory (e.g., `npm pack @cbartens/bkit@<pinnedVersion>`). **If** that fails → inventory from `.bkit/templates/` and `canonicalHashes` only, and mark the unwritten `core/` and `shared/` files `Not Checked`.
|
|
80
|
+
- [ ] **bkit CLI:** Steps 4, 5 — `bkit check` and `bkit doctor` (or `pnpm bkit …`). Fallback: hash the written files against `canonicalHashes` by hand, and mark the advisories `Not Checked`.
|
|
81
|
+
- [ ] **Registry:** Step 3 — the latest version and its release notes (e.g., `npm view @cbartens/bkit version`, the release page). Fallback: compare the pinned and installed versions only, and mark currency `Not Checked`.
|
|
90
82
|
|
|
91
83
|
#### Conditional
|
|
92
84
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **Template Tools:** ≥1 adopted template → Step 9 — each tool behind one, installed version (e.g. `npx husky --version`, `vale --version`, `npx lint-staged --version`). Fallback: version from lockfile; runs `Not Checked`.
|
|
97
|
-
- [ ] **Machine Config:** Audit runs on a developer machine → Step 9 — local git config (e.g. `git config core.hooksPath`), direnv allow state. Fallback: repo-level only; machine wiring `Not Checked`.
|
|
85
|
+
- [ ] **CI Host Read:** **If** the repo has CI → Steps 8, 9 — the workflow list, job names, recent runs and artifact names (e.g., `gh workflow list`, `gh run list`, `gh run view --json jobs`). Fallback: read the workflow files only, and mark lane matching `Not Checked`.
|
|
86
|
+
- [ ] **Template Tools:** **If** at least one template is adopted → Step 9 — the installed version of each tool behind one (e.g., `npx husky --version`, `vale --version`, `npx lint-staged --version`). Fallback: take the version from the lockfile, and mark runs `Not Checked`.
|
|
87
|
+
- [ ] **Machine Config:** **If** the audit runs on a developer machine → Step 9 — the local git config (e.g., `git config core.hooksPath`) and the direnv allow state. Fallback: check the repo level only, and mark machine wiring `Not Checked`.
|
|
98
88
|
|
|
99
89
|
### 🔒 Gate 1: Prerequisites Check
|
|
100
90
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
104
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
91
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
92
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
105
93
|
|
|
106
94
|
### Probe Steps
|
|
107
95
|
|
|
108
|
-
- [ ] **Step 1 — Previous Run:**
|
|
109
|
-
- [ ] **Step 2 — Inventory:** List every file in the package's `core/`, `shared
|
|
110
|
-
- [ ] **Step 3 — Version:** `pinnedVersion
|
|
111
|
-
- [ ] **Step 4 — Check and Doctor:** `bkit check
|
|
112
|
-
- [ ] **Step 5 — Hosts:**
|
|
113
|
-
- [ ] **Step 6 — Written Files:** (a)
|
|
114
|
-
- [ ] **Step 7 — Audits:**
|
|
115
|
-
- [ ] **Step 8 — Adoption:**
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
96
|
+
- [ ] **Step 1 — Previous Run:** Carry each `Adoption` verdict forward with its age. **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
97
|
+
- [ ] **Step 2 — Inventory:** List every file in the package's `core/`, `shared/` and `templates/`. A file's landing path is its path inside the folder. `core/engine/`, `core/workflows/` and `core/prompts/` have no landing path: workflows and prompts are checked as host copies in Step 5. For each file, join: the package file · landing path present · in `canonicalHashes` · the repo's `.bkit/templates/` copy matches the package's `templates/`. Give each file one kind: whole file / managed block / owned keys / template. Record these as findings: a `core/` or `shared/` file whose landing path is absent; a `canonicalHashes` entry the package no longer ships; and a repo `.bkit/templates/` that differs from the package. Group a folder into one row only when every file in it shares one verdict. **Done when:** `Inventory` holds one row per shipped file or uniform folder: folder · landing path · kind · present · recorded.
|
|
98
|
+
- [ ] **Step 3 — Version:** Compare `pinnedVersion`, the installed package and the registry latest. **If** pinned != installed → the package was bumped without `bkit upgrade`. **If** the repo is behind → record the release count, the release-note changes that touch this repo, and the template paths changed since the pinned version. **Done when:** `Version` names all three versions and every relevant release-note change.
|
|
99
|
+
- [ ] **Step 4 — Check and Doctor:** Run `bkit check`, and record its exit code and the cause of each drift line. Run `bkit doctor`, and mark each advisory adopt, reject (saying why) or not applicable. Carry the previous report's rejects forward, and re-raise one only when the advisory text changed. **Done when:** `Check and Doctor` holds one row per drift line and per advisory.
|
|
100
|
+
- [ ] **Step 5 — Hosts:** Compare the agent hosts in use with the bkit hosts installed. Find the hosts in use from the repo's config directories and from team use. Use the `Hosts` section of the newest `bkit-audit-agents` report as a cross-check, not as the source. For each installed host, check for one agent copy per `core/prompts/` source, one command copy per `core/workflows/` source, and every `core/` hook file present, executable and wired in that host's settings. Record these as findings: a host in use with no bkit install, because agents there run without bkit gates; a missing or extra copy; and a hook file present but unwired, or wired but absent. Whether hooks fire and agree across hosts goes to `bkit-audit-agents`. **Done when:** `Hosts` holds one row per host: in use · installed · agent copies · command copies · hooks wired.
|
|
101
|
+
- [ ] **Step 6 — Written Files:** (a) Check that every `bkit:start` / `bkit:end` block and owned key is untouched (the Step 4 drift). **If** one holds a hand edit → the fix moves the edit below `bkit:end` or to `Project Instructions`. **If** the defect is in what bkit shipped → the fix is upstream in bkit. (b) In each file bkit shares with you (`shared/docs/*.md`, `AGENTS.md`, `CLAUDE.md`, `.agents/*.md`, `.gitignore`, `.gitattributes`, settings, tool-server config), check that your part is present for every block that expects one. A doc that holds only bkit's block is unadopted. **If** `.bkit/.env.example` exists → check that `.bkit/.env` is present and git-ignored, and that every listed key is set (names only). **If** bkit wrote a tracker or tool-server entry → check that the credential env var it names is set. Whether your part is true goes to `bkit-audit-documentation`. **Done when:** `Written Files` holds one row per shared file: block untouched · your part present · verdict.
|
|
102
|
+
- [ ] **Step 7 — Audits:** For each `docs/templates/bkit-audit-*.md`, record whether its `**Applies when:**` is met, yes or no, with evidence; its `**Cadence:**`; and its newest report under `docs/audits/` by commit date. An audit never run is due, by the same rule as `bkit-utility-update-roadmap`. An `N/A` report with evidence counts as a run. Record these as findings: an audit that applies and was never run; an audit overdue by more than one cadence; and `Process Improvements` `Project` edits that a report proposed and that are absent from that template's `Project Instructions`. **Done when:** `Audits` holds one row per template: applies · cadence · last run · overdue by · verdict.
|
|
103
|
+
- [ ] **Step 8 — Adoption:** Join each file in the package's `templates/` to `.bkit/templates.md` § Contract.
|
|
104
|
+
- **If** a file is missing from the Contract → the fix is an upstream bkit doc fix.
|
|
105
|
+
- Mark each file adopted (a copy at its landing path, or at the destination the Contract names) or not adopted.
|
|
106
|
+
- Give each file not adopted one verdict: `gap` (it fits this stack, and nothing else does the job), `covered` (naming the tool that does) or `not applicable` (with evidence, e.g., no GitHub Actions or no markdown docs).
|
|
107
|
+
- **If** two templates do one job (e.g., Renovate and Dependabot) → check that one is adopted, or that `bkit.dependencies.updater` is recorded.
|
|
108
|
+
- For each context (`ci`, `diff`, `e2e`, `runtime`, `web`) that the repo has a lane or provider for, check for a context-fetch block below `bkit:end` in `.agents/context.md`, or a `<!-- context-fetch:none … -->` naming it.
|
|
109
|
+
- **If** a provider is in use (a dependency, config or CI step), a shipped `templates/context/` file exists for it, **and** there is no block → `gap`.
|
|
110
|
+
- Re-list every row on each run, and diff against the previous report: newly adopted, newly dropped, and unchanged with its age.
|
|
111
|
+
|
|
112
|
+
**Done when:** `Adoption` holds one row per template file and per context: adopted · verdict · evidence · age.
|
|
113
|
+
|
|
114
|
+
- [ ] **Step 9 — Templates:** For each adopted template, check:
|
|
115
|
+
- (a) Filled: no raw `{{…}}` placeholder is left, the default branch and runner are real, and no stub sentinel is left.
|
|
116
|
+
- (b) Reconciled: run `diff .bkit/templates/<path> <path>`, and mark each difference adopt or reject (saying why). Placeholder lines differ by design.
|
|
117
|
+
- (c) Merged:
|
|
118
|
+
- **If** the package changed the template after the copy's last change (Step 3, `git log` on `.bkit/templates/<path>`) → mark it merged, rejected (saying why) or pending.
|
|
119
|
+
- (d) Wired: the tool behind it is installed, and invoked where the template expects. For example, the hook manager is installed by a `prepare` script, the hooks are executable and `core.hooksPath` is set; `pre-commit` calls lint-staged; the prose linter's styles are synced and its config loads them; the scanner plugin path resolves; the tool-server snippet is merged into the host's server config; the secrets config names real stores; the cloud workflow waits on a workflow `name:` that exists; and the CI template's job names are the ones the repo requires.
|
|
120
|
+
- (e) Runs: one read-only invocation, where one exists (e.g., `sh -n` on a hook, `prettier --check`, `vale` on one doc, `actionlint` on a workflow).
|
|
121
|
+
- (f) Ignored: every repo-wide gate (formatter, prose linter, scanner, linter, type checker) skips `.bkit/templates/`.
|
|
122
|
+
- For each context-fetch block, check that its job regex and artifact name match exactly the lane it names (CI Host Read). A widened regex that catches another lane is a finding.
|
|
123
|
+
|
|
124
|
+
**Done when:** `Templates` holds one row per adopted template, with a verdict for each of (a)-(f).
|
|
125
|
+
|
|
126
|
+
- [ ] **Step 10 — 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 Contract row, one per context-fetch file and one per tool reference read, each marked checked (naming the step), not applicable (saying why) or finding. A key or option in an adopted config that its tool reference deprecates is a finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
127
|
+
- [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches bkit-written files, `.bkit/templates/`, adopted copies, `.agents/context.md` or `package.json` `bkit.*`. (b) In a bounded pass of about 30 minutes, note what a senior engineer adopting bkit would flag that no step asks about. Read what happened since the previous run (`bkit upgrade` output, new `docs/failures.jsonl` rows, `.bkit/friction.jsonl`), 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`.
|
|
119
128
|
|
|
120
129
|
### 🔒 Gate 2: Probes Check
|
|
121
130
|
|
|
122
|
-
**
|
|
123
|
-
|
|
124
|
-
- [ ] **
|
|
125
|
-
- [ ] **
|
|
126
|
-
- [ ] **No
|
|
127
|
-
- [ ] **
|
|
128
|
-
- [ ] **Gate 2
|
|
131
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
132
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
133
|
+
- [ ] **No secrets:** no token, key, or secret value appears anywhere in the report.
|
|
134
|
+
- [ ] **Repo untouched:** no template was copied or edited, and no bkit-written file changed.
|
|
135
|
+
- [ ] **No install:** no `bkit install` / `bkit upgrade` was run.
|
|
136
|
+
- [ ] **No writing runs:** no hook or script that writes was run.
|
|
137
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
129
138
|
|
|
130
139
|
## Findings
|
|
131
140
|
|
|
132
141
|
<!-- prettier-ignore -->
|
|
133
142
|
| Severity | Use |
|
|
134
143
|
| --- | --- |
|
|
135
|
-
| `CRITICAL` |
|
|
136
|
-
| `HIGH` | `bkit check`
|
|
137
|
-
| `MEDIUM` |
|
|
138
|
-
| `LOW` | bkit behind
|
|
144
|
+
| `CRITICAL` | A secret value in a tracked adopted copy or a tracked `.bkit/.env`. Rotation goes to `bkit-audit-security` |
|
|
145
|
+
| `HIGH` | `bkit check` fails. Pinned != installed. A host in use with no bkit install. An adopted template whose tool is not installed or never invoked. A raw placeholder in an executed file (workflow, hook). A cloud workflow waiting on a workflow name that does not exist. A context-fetch block that matches the wrong lane |
|
|
146
|
+
| `MEDIUM` | A template `gap`. Edits inside a bkit managed block. An unaddressed `bkit doctor` advisory. A package change to an adopted template left unmerged. An unreviewed difference from the template. A written doc that holds only bkit's block. A `.bkit/.env` key unset. An audit that applies and was never run, or is overdue. A repo-wide gate that scans `.bkit/templates/`. A context with a lane and no block or opt-out. bkit behind with a relevant fix |
|
|
147
|
+
| `LOW` | bkit behind with no relevant fix. A shipped file missing from the Contract. Two updaters adopted, with one idle. Naming drift with no behaviour change |
|
|
139
148
|
|
|
140
|
-
|
|
149
|
+
Within a severity, list missing gates first, then unwired copies, then drift.
|
|
141
150
|
|
|
142
151
|
<!-- prettier-ignore -->
|
|
143
152
|
| ID | Severity | Folder | Location | Evidence | Expected |
|
|
144
153
|
| --- | --- | --- | --- | --- | --- |
|
|
145
154
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
146
155
|
|
|
147
|
-
|
|
156
|
+
**If** the run finds nothing → write one row: `None`.
|
|
148
157
|
|
|
149
158
|
## Report
|
|
150
159
|
|
|
@@ -217,17 +226,18 @@ PENDING
|
|
|
217
226
|
|
|
218
227
|
### 🔒 Gate 3: Report Check
|
|
219
228
|
|
|
220
|
-
**
|
|
221
|
-
|
|
222
|
-
- [ ] **
|
|
223
|
-
- [ ] **
|
|
224
|
-
- [ ] **
|
|
225
|
-
- [ ] **
|
|
226
|
-
- [ ] **
|
|
227
|
-
- [ ] **
|
|
228
|
-
- [ ] **
|
|
229
|
-
|
|
230
|
-
|
|
229
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
230
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
231
|
+
- [ ] **bkit version:** `Summary` gives the bkit version.
|
|
232
|
+
- [ ] **Hosts:** `Summary` names the hosts.
|
|
233
|
+
- [ ] **Template counts:** `Summary` gives the count of templates adopted / `gap` / `covered` / `not applicable`.
|
|
234
|
+
- [ ] **Series:** `Adoption` is diffed against the previous report's, or the run is marked baseline.
|
|
235
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
236
|
+
- [ ] **Throwaways removed:** the throwaway package unpack is removed.
|
|
237
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
238
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
239
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
240
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
231
241
|
|
|
232
242
|
<!-- bkit:end -->
|
|
233
243
|
|