@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
package/.bkit/core/engine/cli.ts
CHANGED
|
@@ -565,93 +565,245 @@ export function parseArgs(argv: string[]): ParsedArgs {
|
|
|
565
565
|
};
|
|
566
566
|
}
|
|
567
567
|
|
|
568
|
+
/** One `bkit <verb>` entry of the usage text; `.bkit/cli.md` renders the same list. */
|
|
569
|
+
export interface ClassicVerbHelp {
|
|
570
|
+
verb: Verb;
|
|
571
|
+
/** What follows the verb on its usage line. */
|
|
572
|
+
args: string;
|
|
573
|
+
/** One line for the `.bkit/cli.md` table. */
|
|
574
|
+
summary: string;
|
|
575
|
+
/** Every flag the verb takes. */
|
|
576
|
+
flags: readonly string[];
|
|
577
|
+
/** The usage text's description, one printed line each. */
|
|
578
|
+
detail: readonly string[];
|
|
579
|
+
}
|
|
580
|
+
|
|
581
|
+
export const CLASSIC_VERB_HELP: readonly ClassicVerbHelp[] = [
|
|
582
|
+
{
|
|
583
|
+
verb: "install",
|
|
584
|
+
args: "<module-flags>",
|
|
585
|
+
summary: "Install or re-sync the named modules plus the core files.",
|
|
586
|
+
flags: [
|
|
587
|
+
"--claude",
|
|
588
|
+
"--codex",
|
|
589
|
+
"--antigravity",
|
|
590
|
+
"--cursor",
|
|
591
|
+
"--opencode=<provider>",
|
|
592
|
+
"--auto=<claude|cursor|opencode>",
|
|
593
|
+
"--tracker=<name>",
|
|
594
|
+
"--auto-revert",
|
|
595
|
+
],
|
|
596
|
+
detail: [
|
|
597
|
+
"Install (or re-sync) the named modules + the implicit",
|
|
598
|
+
"core foundation. At least one module flag is REQUIRED —",
|
|
599
|
+
"a bare `bkit install` errors (name the modules below).",
|
|
600
|
+
"Hosts compose: --claude --codex --antigravity --cursor",
|
|
601
|
+
"--opencode=<provider>.",
|
|
602
|
+
],
|
|
603
|
+
},
|
|
604
|
+
{
|
|
605
|
+
verb: "check",
|
|
606
|
+
args: "",
|
|
607
|
+
summary: "Drift gate: exit 1 when a managed file needs re-rendering. The CI gate.",
|
|
608
|
+
flags: [],
|
|
609
|
+
detail: [
|
|
610
|
+
"Dry-run — drift-check everything already installed (no",
|
|
611
|
+
"module flags). Exits 1 when a managed file needs",
|
|
612
|
+
"re-rendering. Copies under .bkit/templates/ are refreshed by",
|
|
613
|
+
"install/upgrade and checked for staleness — adopt one by",
|
|
614
|
+
"copying it elsewhere; that copy is yours. The CI gate.",
|
|
615
|
+
"Changes no managed file; rewrites .bkit/advisories.md.",
|
|
616
|
+
],
|
|
617
|
+
},
|
|
618
|
+
{
|
|
619
|
+
verb: "upgrade",
|
|
620
|
+
args: "[--to=<version>|--latest] [--auto-apply] [--dry-run]",
|
|
621
|
+
summary: "Re-render everything installed; --to / --latest bump @cbartens/bkit first.",
|
|
622
|
+
flags: ["--to=<version>", "--latest", "--auto-apply", "--dry-run"],
|
|
623
|
+
detail: [
|
|
624
|
+
"Upgrade everything installed (no module flags). Diffs old",
|
|
625
|
+
"vs new templates; conflict list emitted to stderr. Use",
|
|
626
|
+
"--auto-apply for CI (apply non-conflicting; exit non-zero",
|
|
627
|
+
"on any conflict). Only a whole file you edited since bkit",
|
|
628
|
+
"wrote it conflicts; rendered files (agents, commands,",
|
|
629
|
+
"skills, .bkit/*.md) are always re-rendered — bkit check",
|
|
630
|
+
"flags an edit to one.",
|
|
631
|
+
"--to=<version> / --latest atomically BUMP @cbartens/bkit",
|
|
632
|
+
"(pnpm add), then re-render + re-pin in one step — so a",
|
|
633
|
+
"version bump can never drift from its rendered mirrors.",
|
|
634
|
+
"This is the supported way to move bkit versions; a bare",
|
|
635
|
+
"`pnpm add @cbartens/bkit` alone leaves mirrors stale.",
|
|
636
|
+
],
|
|
637
|
+
},
|
|
638
|
+
{
|
|
639
|
+
verb: "uninstall",
|
|
640
|
+
args: "[module-flags]",
|
|
641
|
+
summary: "Remove bkit-managed files and strip managed blocks; no flags = everything.",
|
|
642
|
+
flags: [
|
|
643
|
+
"--claude",
|
|
644
|
+
"--codex",
|
|
645
|
+
"--antigravity",
|
|
646
|
+
"--cursor",
|
|
647
|
+
"--opencode=<provider>",
|
|
648
|
+
"--auto=<claude|cursor|opencode>",
|
|
649
|
+
"--dry-run",
|
|
650
|
+
"--force",
|
|
651
|
+
"--nuke",
|
|
652
|
+
"--yes",
|
|
653
|
+
],
|
|
654
|
+
detail: [
|
|
655
|
+
"Remove bkit-managed files + strip managed blocks.",
|
|
656
|
+
"No flags = full removal — ALL modules incl. opt-in add-ons",
|
|
657
|
+
"(cloud/opencode) + core. Consumer-owned updater configs",
|
|
658
|
+
"(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified",
|
|
659
|
+
"files, your own files under docs/, and generated artefacts",
|
|
660
|
+
"(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use",
|
|
661
|
+
"--nuke to force-remove manifest-listed files). Target with the",
|
|
662
|
+
"same module flags as install (e.g. uninstall --claude); a",
|
|
663
|
+
"targeted uninstall leaves core untouched.",
|
|
664
|
+
],
|
|
665
|
+
},
|
|
666
|
+
{
|
|
667
|
+
verb: "doctor",
|
|
668
|
+
args: "",
|
|
669
|
+
summary: "Preflight and advisory replay; rewrites .bkit/advisories.md only. Exits 0.",
|
|
670
|
+
flags: [],
|
|
671
|
+
detail: [
|
|
672
|
+
"Preflight + post-install advisory replay (changes no",
|
|
673
|
+
"managed file; rewrites .bkit/advisories.md). Diagnose",
|
|
674
|
+
"token surfaces and config drift. Exits 0.",
|
|
675
|
+
],
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
verb: "tips",
|
|
679
|
+
args: "[--workflow=<name>] [--all]",
|
|
680
|
+
summary: "What this repo has not set up yet, most useful first. Exits 0.",
|
|
681
|
+
flags: ["--workflow=<name>", "--all"],
|
|
682
|
+
detail: [
|
|
683
|
+
"Setup tips: what this repo has not set up yet, most useful",
|
|
684
|
+
"first, each with a sentence to ask your agent. Top three",
|
|
685
|
+
"by default; --workflow=design|plan|build|debug|ship puts",
|
|
686
|
+
"the tips that matter there first and prints one (each",
|
|
687
|
+
"workflow runs this at its close; audit and utility do the",
|
|
688
|
+
"same for audits and the ledger / roadmap updaters);",
|
|
689
|
+
'--all lists every one. Ends with a star line ("bkit-star"',
|
|
690
|
+
"in bkit.advisories.ignore silences it), except under",
|
|
691
|
+
"--workflow=audit|utility. Local checks only. Exits 0.",
|
|
692
|
+
],
|
|
693
|
+
},
|
|
694
|
+
{
|
|
695
|
+
verb: "status",
|
|
696
|
+
args: "",
|
|
697
|
+
summary: "Current host and provider. Writes nothing. Exits 0.",
|
|
698
|
+
flags: [],
|
|
699
|
+
detail: [
|
|
700
|
+
"Read-only host/provider status. Reports current host+provider",
|
|
701
|
+
"(sampled from .claude/, .cursor/, package.json, and the",
|
|
702
|
+
"opencode agent model pins in .opencode/agents/).",
|
|
703
|
+
"Writes nothing. Exits 0.",
|
|
704
|
+
],
|
|
705
|
+
},
|
|
706
|
+
{
|
|
707
|
+
verb: "cursor",
|
|
708
|
+
args: "",
|
|
709
|
+
summary: "Launch Cursor with .bkit/.env loaded into its environment.",
|
|
710
|
+
flags: [],
|
|
711
|
+
detail: [
|
|
712
|
+
"Launch Cursor with .bkit/.env loaded into its environment.",
|
|
713
|
+
"macOS GUI apps launched from the Dock/Finder do not inherit",
|
|
714
|
+
"the login shell env (direnv stays shell-only), so MCP token",
|
|
715
|
+
"placeholders resolve empty. This verb execs the app binary",
|
|
716
|
+
"directly with the per-repo .bkit/.env merged in. Quit Cursor",
|
|
717
|
+
"before running — a running instance ignores the new env.",
|
|
718
|
+
"Override binary path via BKIT_CURSOR_BIN=<path>.",
|
|
719
|
+
],
|
|
720
|
+
},
|
|
721
|
+
{
|
|
722
|
+
verb: "opencode",
|
|
723
|
+
args: "",
|
|
724
|
+
summary: "Launch the OpenCode desktop app with .bkit/.env loaded.",
|
|
725
|
+
flags: [],
|
|
726
|
+
detail: [
|
|
727
|
+
"Same as `bkit cursor` but for the OpenCode desktop app.",
|
|
728
|
+
"Override binary path via BKIT_OPENCODE_BIN=<path>.",
|
|
729
|
+
],
|
|
730
|
+
},
|
|
731
|
+
{
|
|
732
|
+
verb: "comply",
|
|
733
|
+
args: "--phase=<phase>",
|
|
734
|
+
summary: "Compliance grader for one workflow phase; appends stats rows. Exits 0.",
|
|
735
|
+
flags: ["--phase=<phase>"],
|
|
736
|
+
detail: [
|
|
737
|
+
"Run the compliance grader advisory step.",
|
|
738
|
+
"Checks the diff since parentSha for violations",
|
|
739
|
+
"(no-mirror-edit, skip-ci-not-head). Advisory only —",
|
|
740
|
+
'never gates a workflow. Appends kind:"compliance"',
|
|
741
|
+
"rows to .bkit/stats.jsonl. Fail-open: always exits 0.",
|
|
742
|
+
"Valid phases: design, plan, build, debug, ship.",
|
|
743
|
+
],
|
|
744
|
+
},
|
|
745
|
+
{
|
|
746
|
+
verb: "telemetry",
|
|
747
|
+
args: "summary [--phase=<workflow>]",
|
|
748
|
+
summary: "One workflow run's metrics against the median of the previous five. Exits 0.",
|
|
749
|
+
flags: ["--phase=<workflow>"],
|
|
750
|
+
detail: [
|
|
751
|
+
"Per-workflow telemetry report: THIS run's metrics",
|
|
752
|
+
"(duration, size, friction/deferrals/failures added,",
|
|
753
|
+
"compliance) against med·5 — the median of the previous 5",
|
|
754
|
+
"same-workflow runs. The close step of every /bkit-*",
|
|
755
|
+
"workflow calls this and posts it to the tracker comment.",
|
|
756
|
+
"--phase=<workflow>: the workflow to report",
|
|
757
|
+
"(design|plan|build|debug|ship). Without it, prints the",
|
|
758
|
+
"ledger-health line only. Read-only: exits 0.",
|
|
759
|
+
],
|
|
760
|
+
},
|
|
761
|
+
{
|
|
762
|
+
verb: "stats",
|
|
763
|
+
args: "",
|
|
764
|
+
summary: "This repo's stats report, written to .bkit/stats.md. Exits 0.",
|
|
765
|
+
flags: [],
|
|
766
|
+
detail: [
|
|
767
|
+
"This repo's stats report: counts, durations, change-size vs",
|
|
768
|
+
"outcome, counterSource trust, per-rule and per-version",
|
|
769
|
+
"compliance, and the unjustified-deferral rate per",
|
|
770
|
+
"(subagent, model). Reads .bkit/stats.jsonl,",
|
|
771
|
+
".bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo",
|
|
772
|
+
"only; writes .bkit/stats.md and prints it.",
|
|
773
|
+
"Advisory + inform-only: exits 0.",
|
|
774
|
+
],
|
|
775
|
+
},
|
|
776
|
+
{
|
|
777
|
+
verb: "help",
|
|
778
|
+
args: "",
|
|
779
|
+
summary: "Print the usage text.",
|
|
780
|
+
flags: [],
|
|
781
|
+
detail: ["Print this message."],
|
|
782
|
+
},
|
|
783
|
+
];
|
|
784
|
+
|
|
785
|
+
/** Usage line width: a synopsis up to this long shares its line with the first detail line. */
|
|
786
|
+
const SYNOPSIS_WIDTH = 29;
|
|
787
|
+
|
|
788
|
+
/** The usage text's `bkit <verb>` list, rendered from `CLASSIC_VERB_HELP`. */
|
|
789
|
+
function classicUsage(): string {
|
|
790
|
+
const indent = " ".repeat(SYNOPSIS_WIDTH + 4);
|
|
791
|
+
return CLASSIC_VERB_HELP.flatMap(({ verb, args, detail }) => {
|
|
792
|
+
const synopsis = `bkit ${verb}${args ? ` ${args}` : ""}`;
|
|
793
|
+
if (synopsis.length > SYNOPSIS_WIDTH) {
|
|
794
|
+
return [` ${synopsis}`, ...detail.map((d) => indent + d)];
|
|
795
|
+
}
|
|
796
|
+
const [first = "", ...rest] = detail;
|
|
797
|
+
return [` ${synopsis.padEnd(SYNOPSIS_WIDTH)} ${first}`, ...rest.map((d) => indent + d)];
|
|
798
|
+
}).join("\n");
|
|
799
|
+
}
|
|
800
|
+
|
|
568
801
|
export function printUsage(): void {
|
|
569
802
|
console.log(
|
|
570
803
|
`bkit — agent-stack consolidation CLI
|
|
571
804
|
|
|
572
805
|
Usage:
|
|
573
|
-
|
|
574
|
-
core foundation. At least one module flag is REQUIRED —
|
|
575
|
-
a bare \`bkit install\` errors (name the modules below).
|
|
576
|
-
Hosts compose: --claude --cursor --codex --antigravity
|
|
577
|
-
--opencode=<provider>.
|
|
578
|
-
bkit check Dry-run — drift-check everything already installed (no
|
|
579
|
-
module flags). Exits 1 when a managed file needs
|
|
580
|
-
re-rendering. Copies under .bkit/templates/ are refreshed by
|
|
581
|
-
install/upgrade and checked for staleness — adopt one by
|
|
582
|
-
copying it elsewhere; that copy is yours. The CI gate.
|
|
583
|
-
Changes no managed file; rewrites .bkit/advisories.md.
|
|
584
|
-
bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
|
|
585
|
-
Upgrade everything installed (no module flags). Diffs old
|
|
586
|
-
vs new templates; conflict list emitted to stderr. Use
|
|
587
|
-
--auto-apply for CI (apply non-conflicting; exit non-zero
|
|
588
|
-
on any conflict). Only a whole file you edited since bkit
|
|
589
|
-
wrote it conflicts; rendered files (agents, commands,
|
|
590
|
-
skills, .bkit/*.md) are always re-rendered — bkit check
|
|
591
|
-
flags an edit to one.
|
|
592
|
-
--to=<version> / --latest atomically BUMP @cbartens/bkit
|
|
593
|
-
(pnpm add), then re-render + re-pin in one step — so a
|
|
594
|
-
version bump can never drift from its rendered mirrors.
|
|
595
|
-
This is the supported way to move bkit versions; a bare
|
|
596
|
-
\`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
|
|
597
|
-
bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
|
|
598
|
-
No flags = full removal — ALL modules incl. opt-in add-ons
|
|
599
|
-
(cloud/opencode) + core. Consumer-owned updater configs
|
|
600
|
-
(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
|
|
601
|
-
files, your own files under docs/, and generated artefacts
|
|
602
|
-
(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
|
|
603
|
-
--nuke to force-remove manifest-listed files). Target with the
|
|
604
|
-
same module flags as install (e.g. uninstall --claude); a
|
|
605
|
-
targeted uninstall leaves core untouched.
|
|
606
|
-
bkit doctor Preflight + post-install advisory replay (changes no
|
|
607
|
-
managed file; rewrites .bkit/advisories.md). Diagnose
|
|
608
|
-
token surfaces and config drift. Exits 0.
|
|
609
|
-
bkit tips [--workflow=<name>] [--all]
|
|
610
|
-
Setup tips: what this repo has not set up yet, most useful
|
|
611
|
-
first, each with a sentence to ask your agent. Top three
|
|
612
|
-
by default; --workflow=design|plan|build|debug|ship puts
|
|
613
|
-
the tips that matter there first and prints one (each
|
|
614
|
-
workflow runs this at its close; audit and utility do the
|
|
615
|
-
same for audits and the ledger / roadmap updaters);
|
|
616
|
-
--all lists every one. Ends with a star line ("bkit-star"
|
|
617
|
-
in bkit.advisories.ignore silences it), except under
|
|
618
|
-
--workflow=audit|utility. Local checks only. Exits 0.
|
|
619
|
-
bkit status Read-only host/provider status. Reports current host+provider
|
|
620
|
-
(sampled from .claude/, .cursor/, package.json, and the
|
|
621
|
-
opencode agent model pins in .opencode/agents/).
|
|
622
|
-
Writes nothing. Exits 0.
|
|
623
|
-
bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
|
|
624
|
-
macOS GUI apps launched from the Dock/Finder do not inherit
|
|
625
|
-
the login shell env (direnv stays shell-only), so MCP token
|
|
626
|
-
placeholders resolve empty. This verb execs the app binary
|
|
627
|
-
directly with the per-repo .bkit/.env merged in. Quit Cursor
|
|
628
|
-
before running — a running instance ignores the new env.
|
|
629
|
-
Override binary path via BKIT_CURSOR_BIN=<path>.
|
|
630
|
-
bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
|
|
631
|
-
Override binary path via BKIT_OPENCODE_BIN=<path>.
|
|
632
|
-
bkit comply --phase=<phase> Run the compliance grader advisory step.
|
|
633
|
-
Checks the diff since parentSha for violations
|
|
634
|
-
(no-mirror-edit, skip-ci-not-head). Advisory only —
|
|
635
|
-
never gates a workflow. Appends kind:"compliance"
|
|
636
|
-
rows to .bkit/stats.jsonl. Fail-open: always exits 0.
|
|
637
|
-
Valid phases: design, plan, build, debug, ship.
|
|
638
|
-
bkit telemetry summary [--phase=<workflow>]
|
|
639
|
-
Per-workflow telemetry report: THIS run's metrics
|
|
640
|
-
(duration, size, friction/deferrals/failures added,
|
|
641
|
-
compliance) against med·5 — the median of the previous 5
|
|
642
|
-
same-workflow runs. The close step of every /bkit-*
|
|
643
|
-
workflow calls this and posts it to the tracker comment.
|
|
644
|
-
--phase=<workflow>: the workflow to report
|
|
645
|
-
(design|plan|build|debug|ship). Without it, prints the
|
|
646
|
-
ledger-health line only. Read-only: exits 0.
|
|
647
|
-
bkit stats This repo's stats report: counts, durations, change-size vs
|
|
648
|
-
outcome, counterSource trust, per-rule and per-version
|
|
649
|
-
compliance, and the unjustified-deferral rate per
|
|
650
|
-
(subagent, model). Reads .bkit/stats.jsonl,
|
|
651
|
-
.bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo
|
|
652
|
-
only; writes .bkit/stats.md and prints it.
|
|
653
|
-
Advisory + inform-only: exits 0.
|
|
654
|
-
bkit help Print this message.
|
|
806
|
+
${classicUsage()}
|
|
655
807
|
|
|
656
808
|
Core (implicit — no flag; installed/upgraded on every install):
|
|
657
809
|
AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
|
|
@@ -659,7 +811,7 @@ Core (implicit — no flag; installed/upgraded on every install):
|
|
|
659
811
|
.gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
|
|
660
812
|
.bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
|
|
661
813
|
runs (added when missing, never overwritten, left by uninstall). The tool scripts those
|
|
662
|
-
gates chain (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
|
|
814
|
+
gates chain (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta) and their devDeps are
|
|
663
815
|
yours to add: see .bkit/templates.md.
|
|
664
816
|
|
|
665
817
|
Module flags (composable; symmetric install ↔ uninstall):
|
|
@@ -695,6 +847,8 @@ Dependency updaters (copy an example and own it):
|
|
|
695
847
|
.bkit/templates/.github/renovate.json5
|
|
696
848
|
.bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
|
|
697
849
|
.bkit/templates/.github/dependabot.yml
|
|
850
|
+
Install records the one present in bkit.dependencies.updater; bkit check
|
|
851
|
+
blocks when that value and the configs disagree.
|
|
698
852
|
All templates and install steps: .bkit/templates.md
|
|
699
853
|
|
|
700
854
|
--auto=<claude|cursor|opencode>
|
|
@@ -795,7 +949,7 @@ export function validateModuleFlagsForVerb(
|
|
|
795
949
|
if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
|
|
796
950
|
return (
|
|
797
951
|
"[bkit] `bkit install` requires at least one module flag. Name what to install: " +
|
|
798
|
-
"--claude, --
|
|
952
|
+
"--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
|
|
799
953
|
`--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
|
|
800
954
|
"tracker on what is installed. Run `bkit help` for usage."
|
|
801
955
|
);
|
|
@@ -13,6 +13,10 @@
|
|
|
13
13
|
//
|
|
14
14
|
// Rows are read folded, so rows written without `schema` arrive in the current shape.
|
|
15
15
|
//
|
|
16
|
+
// Every figure built from `outcome`, `counter` or `compliance` rows is computed twice: once over
|
|
17
|
+
// the rows workflow closes wrote, once over the rows a direct chat wrote (`by.workflow`
|
|
18
|
+
// `utility`). No figure adds the two together.
|
|
19
|
+
//
|
|
16
20
|
// All computation is advisory + inform-only; never gates any workflow.
|
|
17
21
|
// See DE-34 for the shared-entrypoint + crash-isolation contract.
|
|
18
22
|
|
|
@@ -45,20 +49,33 @@ export type ComplianceRow = TelemetryEnvelope & CompliancePayload;
|
|
|
45
49
|
// Counts / rates summary
|
|
46
50
|
// ---------------------------------------------------------------------------
|
|
47
51
|
|
|
52
|
+
/** `by.workflow` of a row a direct chat wrote, outside any workflow run. */
|
|
53
|
+
export const UTILITY_WORKFLOW = "utility";
|
|
54
|
+
|
|
55
|
+
/** Who wrote a row: a workflow (its close, or its orchestrator), or a direct chat. */
|
|
56
|
+
export type RowSource = "workflow" | "utility";
|
|
57
|
+
|
|
58
|
+
export const ROW_SOURCES: readonly RowSource[] = ["workflow", "utility"];
|
|
59
|
+
|
|
60
|
+
export function rowSource(row: Pick<TelemetryEnvelope, "by">): RowSource {
|
|
61
|
+
return row.by?.workflow === UTILITY_WORKFLOW ? "utility" : "workflow";
|
|
62
|
+
}
|
|
63
|
+
|
|
48
64
|
export interface TelemetryCounts {
|
|
49
65
|
total: number;
|
|
50
|
-
|
|
66
|
+
/** Rows per kind, workflow rows and direct-chat rows apart. */
|
|
67
|
+
byKind: Record<string, Record<RowSource, number>>;
|
|
51
68
|
byWorkflow: Record<string, number>;
|
|
52
69
|
byRepo: Record<string, number>;
|
|
53
70
|
}
|
|
54
71
|
|
|
55
72
|
export function computeCounts(events: TelemetryEvent[]): TelemetryCounts {
|
|
56
|
-
const byKind: Record<string, number
|
|
73
|
+
const byKind: Record<string, Record<RowSource, number>> = {};
|
|
57
74
|
const byWorkflow: Record<string, number> = {};
|
|
58
75
|
const byRepo: Record<string, number> = {};
|
|
59
76
|
|
|
60
77
|
for (const ev of events) {
|
|
61
|
-
byKind[ev.kind]
|
|
78
|
+
(byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
|
|
62
79
|
const workflow = ev.by?.workflow ?? "unknown";
|
|
63
80
|
byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
|
|
64
81
|
byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
|
|
@@ -454,108 +471,153 @@ export function computeDeferralDiscipline(rows: DeferralRow[]): DeferralDiscipli
|
|
|
454
471
|
}
|
|
455
472
|
|
|
456
473
|
// ---------------------------------------------------------------------------
|
|
457
|
-
//
|
|
474
|
+
// Run figures — one set per row source
|
|
458
475
|
// ---------------------------------------------------------------------------
|
|
459
476
|
|
|
460
|
-
|
|
461
|
-
|
|
477
|
+
/** Every figure built from one source's `outcome`, `counter` and `compliance` rows. */
|
|
478
|
+
export interface RunFigures {
|
|
479
|
+
outcomes: number;
|
|
480
|
+
compliance: number;
|
|
462
481
|
elapsed: ElapsedStats;
|
|
463
482
|
regression: RegressionResult;
|
|
464
483
|
complianceRates: ComplianceRuleRate[];
|
|
465
484
|
versionCompliance: VersionComplianceEntry[];
|
|
466
|
-
deferralDiscipline: DeferralDisciplineEntry[];
|
|
467
485
|
challengeGate: ChallengeGateCounts;
|
|
468
486
|
agentContext: AgentContextReport;
|
|
469
|
-
reportLines: string[];
|
|
470
487
|
}
|
|
471
488
|
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
):
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
} else if (ev.kind === "counter") {
|
|
489
|
-
counterRows.push(ev);
|
|
490
|
-
} else if (ev.kind === "compliance") {
|
|
491
|
-
complianceRows.push(ev);
|
|
492
|
-
} else if (ev.kind === "deferral") {
|
|
493
|
-
deferralRows.push(ev);
|
|
494
|
-
}
|
|
495
|
-
}
|
|
496
|
-
|
|
497
|
-
const counts = computeCounts(events);
|
|
498
|
-
const elapsed = computeElapsedStats(outcomeRows);
|
|
499
|
-
const regression = computeRegression(outcomeRows, counterRows);
|
|
500
|
-
const complianceRates = computeComplianceRates(complianceRows);
|
|
501
|
-
const versionCompliance = computeVersionCompliance(complianceRows);
|
|
502
|
-
const deferralDiscipline = computeDeferralDiscipline(deferralRows);
|
|
503
|
-
const challengeGate = computeChallengeGate(outcomeRows);
|
|
504
|
-
const agentContext = computeAgentContext(outcomeRows);
|
|
489
|
+
export function computeRunFigures(
|
|
490
|
+
outcomeRows: OutcomeRow[],
|
|
491
|
+
counterRows: CounterRow[],
|
|
492
|
+
complianceRows: ComplianceRow[],
|
|
493
|
+
): RunFigures {
|
|
494
|
+
return {
|
|
495
|
+
outcomes: outcomeRows.length,
|
|
496
|
+
compliance: complianceRows.length,
|
|
497
|
+
elapsed: computeElapsedStats(outcomeRows),
|
|
498
|
+
regression: computeRegression(outcomeRows, counterRows),
|
|
499
|
+
complianceRates: computeComplianceRates(complianceRows),
|
|
500
|
+
versionCompliance: computeVersionCompliance(complianceRows),
|
|
501
|
+
challengeGate: computeChallengeGate(outcomeRows),
|
|
502
|
+
agentContext: computeAgentContext(outcomeRows),
|
|
503
|
+
};
|
|
504
|
+
}
|
|
505
505
|
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
`[bkit-analysis] Run outcomes: ${outcomeRows.length} | Compliance rows: ${complianceRows.length}`,
|
|
511
|
-
];
|
|
506
|
+
function runFigureLines(label: string, f: RunFigures): string[] {
|
|
507
|
+
const p = `[bkit-analysis] [${label}]`;
|
|
508
|
+
const lines = [`${p} Run outcomes: ${f.outcomes} | Compliance rows: ${f.compliance}`];
|
|
509
|
+
const { elapsed, regression, challengeGate, complianceRates, versionCompliance } = f;
|
|
512
510
|
|
|
513
511
|
if (elapsed.count > 0) {
|
|
514
|
-
|
|
515
|
-
|
|
512
|
+
lines.push(
|
|
513
|
+
`${p} Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`,
|
|
516
514
|
);
|
|
517
515
|
}
|
|
518
516
|
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`,
|
|
517
|
+
lines.push(
|
|
518
|
+
`${p} #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`,
|
|
522
519
|
);
|
|
523
520
|
for (const b of regression.buckets) {
|
|
524
521
|
if (b.count > 0) {
|
|
525
|
-
|
|
522
|
+
lines.push(
|
|
526
523
|
` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`,
|
|
527
524
|
);
|
|
528
525
|
}
|
|
529
526
|
}
|
|
530
|
-
|
|
531
|
-
|
|
527
|
+
lines.push(
|
|
528
|
+
`${p} counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`,
|
|
532
529
|
);
|
|
533
530
|
|
|
534
531
|
if (challengeGate.runs > 0) {
|
|
535
|
-
|
|
536
|
-
|
|
532
|
+
lines.push(
|
|
533
|
+
`${p} Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`,
|
|
537
534
|
);
|
|
538
535
|
}
|
|
539
536
|
|
|
540
|
-
// Compliance rates
|
|
541
537
|
if (complianceRates.length > 0) {
|
|
542
|
-
|
|
538
|
+
lines.push(`${p} Per-rule compliance rates:`);
|
|
543
539
|
for (const r of complianceRates) {
|
|
544
|
-
|
|
540
|
+
lines.push(
|
|
545
541
|
` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`,
|
|
546
542
|
);
|
|
547
543
|
}
|
|
548
544
|
}
|
|
549
545
|
|
|
550
|
-
// Version compliance
|
|
551
546
|
if (versionCompliance.length > 0) {
|
|
552
|
-
|
|
547
|
+
lines.push(`${p} Per-bkit.version compliance:`);
|
|
553
548
|
for (const v of versionCompliance) {
|
|
554
|
-
|
|
555
|
-
` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`,
|
|
556
|
-
);
|
|
549
|
+
lines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
|
|
557
550
|
}
|
|
558
551
|
}
|
|
552
|
+
return lines;
|
|
553
|
+
}
|
|
554
|
+
|
|
555
|
+
// ---------------------------------------------------------------------------
|
|
556
|
+
// Full analysis report
|
|
557
|
+
// ---------------------------------------------------------------------------
|
|
558
|
+
|
|
559
|
+
export interface AnalysisReport {
|
|
560
|
+
counts: TelemetryCounts;
|
|
561
|
+
/** Workflow rows and direct-chat (`utility`) rows, never added together. */
|
|
562
|
+
runs: Record<RowSource, RunFigures>;
|
|
563
|
+
deferralDiscipline: DeferralDisciplineEntry[];
|
|
564
|
+
reportLines: string[];
|
|
565
|
+
}
|
|
566
|
+
|
|
567
|
+
/** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
|
|
568
|
+
export function runAnalysis(
|
|
569
|
+
paths: string[],
|
|
570
|
+
skipKinds: ReadonlySet<string> = new Set(),
|
|
571
|
+
): AnalysisReport {
|
|
572
|
+
const { state, rowCount, malformedLineCount } = foldFrom(paths);
|
|
573
|
+
const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
|
|
574
|
+
|
|
575
|
+
const grouped = () => ({
|
|
576
|
+
outcome: [] as OutcomeRow[],
|
|
577
|
+
counter: [] as CounterRow[],
|
|
578
|
+
compliance: [] as ComplianceRow[],
|
|
579
|
+
});
|
|
580
|
+
const bySource: Record<RowSource, ReturnType<typeof grouped>> = {
|
|
581
|
+
workflow: grouped(),
|
|
582
|
+
utility: grouped(),
|
|
583
|
+
};
|
|
584
|
+
const deferralRows: DeferralRow[] = [];
|
|
585
|
+
|
|
586
|
+
for (const ev of events) {
|
|
587
|
+
const g = bySource[rowSource(ev)];
|
|
588
|
+
if (ev.kind === "outcome") {
|
|
589
|
+
g.outcome.push(ev);
|
|
590
|
+
} else if (ev.kind === "counter") {
|
|
591
|
+
g.counter.push(ev);
|
|
592
|
+
} else if (ev.kind === "compliance") {
|
|
593
|
+
g.compliance.push(ev);
|
|
594
|
+
} else if (ev.kind === "deferral") {
|
|
595
|
+
deferralRows.push(ev);
|
|
596
|
+
}
|
|
597
|
+
}
|
|
598
|
+
|
|
599
|
+
const counts = computeCounts(events);
|
|
600
|
+
const runs: Record<RowSource, RunFigures> = {
|
|
601
|
+
workflow: computeRunFigures(
|
|
602
|
+
bySource.workflow.outcome,
|
|
603
|
+
bySource.workflow.counter,
|
|
604
|
+
bySource.workflow.compliance,
|
|
605
|
+
),
|
|
606
|
+
utility: computeRunFigures(
|
|
607
|
+
bySource.utility.outcome,
|
|
608
|
+
bySource.utility.counter,
|
|
609
|
+
bySource.utility.compliance,
|
|
610
|
+
),
|
|
611
|
+
};
|
|
612
|
+
const deferralDiscipline = computeDeferralDiscipline(deferralRows);
|
|
613
|
+
|
|
614
|
+
const reportLines: string[] = [
|
|
615
|
+
`[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
|
|
616
|
+
`[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
|
|
617
|
+
`[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
|
|
618
|
+
...runFigureLines("workflow", runs.workflow),
|
|
619
|
+
...runFigureLines(UTILITY_WORKFLOW, runs.utility),
|
|
620
|
+
];
|
|
559
621
|
|
|
560
622
|
// Deferral discipline — who defers work they should have finished.
|
|
561
623
|
if (deferralDiscipline.length > 0) {
|
|
@@ -577,15 +639,5 @@ export function runAnalysis(
|
|
|
577
639
|
}
|
|
578
640
|
}
|
|
579
641
|
|
|
580
|
-
return {
|
|
581
|
-
counts,
|
|
582
|
-
elapsed,
|
|
583
|
-
regression,
|
|
584
|
-
complianceRates,
|
|
585
|
-
versionCompliance,
|
|
586
|
-
deferralDiscipline,
|
|
587
|
-
challengeGate,
|
|
588
|
-
agentContext,
|
|
589
|
-
reportLines,
|
|
590
|
-
};
|
|
642
|
+
return { counts, runs, deferralDiscipline, reportLines };
|
|
591
643
|
}
|