@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/dist/cli.js
CHANGED
|
@@ -413,92 +413,228 @@ export function parseArgs(argv) {
|
|
|
413
413
|
tipsWorkflow,
|
|
414
414
|
};
|
|
415
415
|
}
|
|
416
|
+
export const CLASSIC_VERB_HELP = [
|
|
417
|
+
{
|
|
418
|
+
verb: "install",
|
|
419
|
+
args: "<module-flags>",
|
|
420
|
+
summary: "Install or re-sync the named modules plus the core files.",
|
|
421
|
+
flags: [
|
|
422
|
+
"--claude",
|
|
423
|
+
"--codex",
|
|
424
|
+
"--antigravity",
|
|
425
|
+
"--cursor",
|
|
426
|
+
"--opencode=<provider>",
|
|
427
|
+
"--auto=<claude|cursor|opencode>",
|
|
428
|
+
"--tracker=<name>",
|
|
429
|
+
"--auto-revert",
|
|
430
|
+
],
|
|
431
|
+
detail: [
|
|
432
|
+
"Install (or re-sync) the named modules + the implicit",
|
|
433
|
+
"core foundation. At least one module flag is REQUIRED —",
|
|
434
|
+
"a bare `bkit install` errors (name the modules below).",
|
|
435
|
+
"Hosts compose: --claude --codex --antigravity --cursor",
|
|
436
|
+
"--opencode=<provider>.",
|
|
437
|
+
],
|
|
438
|
+
},
|
|
439
|
+
{
|
|
440
|
+
verb: "check",
|
|
441
|
+
args: "",
|
|
442
|
+
summary: "Drift gate: exit 1 when a managed file needs re-rendering. The CI gate.",
|
|
443
|
+
flags: [],
|
|
444
|
+
detail: [
|
|
445
|
+
"Dry-run — drift-check everything already installed (no",
|
|
446
|
+
"module flags). Exits 1 when a managed file needs",
|
|
447
|
+
"re-rendering. Copies under .bkit/templates/ are refreshed by",
|
|
448
|
+
"install/upgrade and checked for staleness — adopt one by",
|
|
449
|
+
"copying it elsewhere; that copy is yours. The CI gate.",
|
|
450
|
+
"Changes no managed file; rewrites .bkit/advisories.md.",
|
|
451
|
+
],
|
|
452
|
+
},
|
|
453
|
+
{
|
|
454
|
+
verb: "upgrade",
|
|
455
|
+
args: "[--to=<version>|--latest] [--auto-apply] [--dry-run]",
|
|
456
|
+
summary: "Re-render everything installed; --to / --latest bump @cbartens/bkit first.",
|
|
457
|
+
flags: ["--to=<version>", "--latest", "--auto-apply", "--dry-run"],
|
|
458
|
+
detail: [
|
|
459
|
+
"Upgrade everything installed (no module flags). Diffs old",
|
|
460
|
+
"vs new templates; conflict list emitted to stderr. Use",
|
|
461
|
+
"--auto-apply for CI (apply non-conflicting; exit non-zero",
|
|
462
|
+
"on any conflict). Only a whole file you edited since bkit",
|
|
463
|
+
"wrote it conflicts; rendered files (agents, commands,",
|
|
464
|
+
"skills, .bkit/*.md) are always re-rendered — bkit check",
|
|
465
|
+
"flags an edit to one.",
|
|
466
|
+
"--to=<version> / --latest atomically BUMP @cbartens/bkit",
|
|
467
|
+
"(pnpm add), then re-render + re-pin in one step — so a",
|
|
468
|
+
"version bump can never drift from its rendered mirrors.",
|
|
469
|
+
"This is the supported way to move bkit versions; a bare",
|
|
470
|
+
"`pnpm add @cbartens/bkit` alone leaves mirrors stale.",
|
|
471
|
+
],
|
|
472
|
+
},
|
|
473
|
+
{
|
|
474
|
+
verb: "uninstall",
|
|
475
|
+
args: "[module-flags]",
|
|
476
|
+
summary: "Remove bkit-managed files and strip managed blocks; no flags = everything.",
|
|
477
|
+
flags: [
|
|
478
|
+
"--claude",
|
|
479
|
+
"--codex",
|
|
480
|
+
"--antigravity",
|
|
481
|
+
"--cursor",
|
|
482
|
+
"--opencode=<provider>",
|
|
483
|
+
"--auto=<claude|cursor|opencode>",
|
|
484
|
+
"--dry-run",
|
|
485
|
+
"--force",
|
|
486
|
+
"--nuke",
|
|
487
|
+
"--yes",
|
|
488
|
+
],
|
|
489
|
+
detail: [
|
|
490
|
+
"Remove bkit-managed files + strip managed blocks.",
|
|
491
|
+
"No flags = full removal — ALL modules incl. opt-in add-ons",
|
|
492
|
+
"(cloud/opencode) + core. Consumer-owned updater configs",
|
|
493
|
+
"(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified",
|
|
494
|
+
"files, your own files under docs/, and generated artefacts",
|
|
495
|
+
"(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use",
|
|
496
|
+
"--nuke to force-remove manifest-listed files). Target with the",
|
|
497
|
+
"same module flags as install (e.g. uninstall --claude); a",
|
|
498
|
+
"targeted uninstall leaves core untouched.",
|
|
499
|
+
],
|
|
500
|
+
},
|
|
501
|
+
{
|
|
502
|
+
verb: "doctor",
|
|
503
|
+
args: "",
|
|
504
|
+
summary: "Preflight and advisory replay; rewrites .bkit/advisories.md only. Exits 0.",
|
|
505
|
+
flags: [],
|
|
506
|
+
detail: [
|
|
507
|
+
"Preflight + post-install advisory replay (changes no",
|
|
508
|
+
"managed file; rewrites .bkit/advisories.md). Diagnose",
|
|
509
|
+
"token surfaces and config drift. Exits 0.",
|
|
510
|
+
],
|
|
511
|
+
},
|
|
512
|
+
{
|
|
513
|
+
verb: "tips",
|
|
514
|
+
args: "[--workflow=<name>] [--all]",
|
|
515
|
+
summary: "What this repo has not set up yet, most useful first. Exits 0.",
|
|
516
|
+
flags: ["--workflow=<name>", "--all"],
|
|
517
|
+
detail: [
|
|
518
|
+
"Setup tips: what this repo has not set up yet, most useful",
|
|
519
|
+
"first, each with a sentence to ask your agent. Top three",
|
|
520
|
+
"by default; --workflow=design|plan|build|debug|ship puts",
|
|
521
|
+
"the tips that matter there first and prints one (each",
|
|
522
|
+
"workflow runs this at its close; audit and utility do the",
|
|
523
|
+
"same for audits and the ledger / roadmap updaters);",
|
|
524
|
+
'--all lists every one. Ends with a star line ("bkit-star"',
|
|
525
|
+
"in bkit.advisories.ignore silences it), except under",
|
|
526
|
+
"--workflow=audit|utility. Local checks only. Exits 0.",
|
|
527
|
+
],
|
|
528
|
+
},
|
|
529
|
+
{
|
|
530
|
+
verb: "status",
|
|
531
|
+
args: "",
|
|
532
|
+
summary: "Current host and provider. Writes nothing. Exits 0.",
|
|
533
|
+
flags: [],
|
|
534
|
+
detail: [
|
|
535
|
+
"Read-only host/provider status. Reports current host+provider",
|
|
536
|
+
"(sampled from .claude/, .cursor/, package.json, and the",
|
|
537
|
+
"opencode agent model pins in .opencode/agents/).",
|
|
538
|
+
"Writes nothing. Exits 0.",
|
|
539
|
+
],
|
|
540
|
+
},
|
|
541
|
+
{
|
|
542
|
+
verb: "cursor",
|
|
543
|
+
args: "",
|
|
544
|
+
summary: "Launch Cursor with .bkit/.env loaded into its environment.",
|
|
545
|
+
flags: [],
|
|
546
|
+
detail: [
|
|
547
|
+
"Launch Cursor with .bkit/.env loaded into its environment.",
|
|
548
|
+
"macOS GUI apps launched from the Dock/Finder do not inherit",
|
|
549
|
+
"the login shell env (direnv stays shell-only), so MCP token",
|
|
550
|
+
"placeholders resolve empty. This verb execs the app binary",
|
|
551
|
+
"directly with the per-repo .bkit/.env merged in. Quit Cursor",
|
|
552
|
+
"before running — a running instance ignores the new env.",
|
|
553
|
+
"Override binary path via BKIT_CURSOR_BIN=<path>.",
|
|
554
|
+
],
|
|
555
|
+
},
|
|
556
|
+
{
|
|
557
|
+
verb: "opencode",
|
|
558
|
+
args: "",
|
|
559
|
+
summary: "Launch the OpenCode desktop app with .bkit/.env loaded.",
|
|
560
|
+
flags: [],
|
|
561
|
+
detail: [
|
|
562
|
+
"Same as `bkit cursor` but for the OpenCode desktop app.",
|
|
563
|
+
"Override binary path via BKIT_OPENCODE_BIN=<path>.",
|
|
564
|
+
],
|
|
565
|
+
},
|
|
566
|
+
{
|
|
567
|
+
verb: "comply",
|
|
568
|
+
args: "--phase=<phase>",
|
|
569
|
+
summary: "Compliance grader for one workflow phase; appends stats rows. Exits 0.",
|
|
570
|
+
flags: ["--phase=<phase>"],
|
|
571
|
+
detail: [
|
|
572
|
+
"Run the compliance grader advisory step.",
|
|
573
|
+
"Checks the diff since parentSha for violations",
|
|
574
|
+
"(no-mirror-edit, skip-ci-not-head). Advisory only —",
|
|
575
|
+
'never gates a workflow. Appends kind:"compliance"',
|
|
576
|
+
"rows to .bkit/stats.jsonl. Fail-open: always exits 0.",
|
|
577
|
+
"Valid phases: design, plan, build, debug, ship.",
|
|
578
|
+
],
|
|
579
|
+
},
|
|
580
|
+
{
|
|
581
|
+
verb: "telemetry",
|
|
582
|
+
args: "summary [--phase=<workflow>]",
|
|
583
|
+
summary: "One workflow run's metrics against the median of the previous five. Exits 0.",
|
|
584
|
+
flags: ["--phase=<workflow>"],
|
|
585
|
+
detail: [
|
|
586
|
+
"Per-workflow telemetry report: THIS run's metrics",
|
|
587
|
+
"(duration, size, friction/deferrals/failures added,",
|
|
588
|
+
"compliance) against med·5 — the median of the previous 5",
|
|
589
|
+
"same-workflow runs. The close step of every /bkit-*",
|
|
590
|
+
"workflow calls this and posts it to the tracker comment.",
|
|
591
|
+
"--phase=<workflow>: the workflow to report",
|
|
592
|
+
"(design|plan|build|debug|ship). Without it, prints the",
|
|
593
|
+
"ledger-health line only. Read-only: exits 0.",
|
|
594
|
+
],
|
|
595
|
+
},
|
|
596
|
+
{
|
|
597
|
+
verb: "stats",
|
|
598
|
+
args: "",
|
|
599
|
+
summary: "This repo's stats report, written to .bkit/stats.md. Exits 0.",
|
|
600
|
+
flags: [],
|
|
601
|
+
detail: [
|
|
602
|
+
"This repo's stats report: counts, durations, change-size vs",
|
|
603
|
+
"outcome, counterSource trust, per-rule and per-version",
|
|
604
|
+
"compliance, and the unjustified-deferral rate per",
|
|
605
|
+
"(subagent, model). Reads .bkit/stats.jsonl,",
|
|
606
|
+
".bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo",
|
|
607
|
+
"only; writes .bkit/stats.md and prints it.",
|
|
608
|
+
"Advisory + inform-only: exits 0.",
|
|
609
|
+
],
|
|
610
|
+
},
|
|
611
|
+
{
|
|
612
|
+
verb: "help",
|
|
613
|
+
args: "",
|
|
614
|
+
summary: "Print the usage text.",
|
|
615
|
+
flags: [],
|
|
616
|
+
detail: ["Print this message."],
|
|
617
|
+
},
|
|
618
|
+
];
|
|
619
|
+
/** Usage line width: a synopsis up to this long shares its line with the first detail line. */
|
|
620
|
+
const SYNOPSIS_WIDTH = 29;
|
|
621
|
+
/** The usage text's `bkit <verb>` list, rendered from `CLASSIC_VERB_HELP`. */
|
|
622
|
+
function classicUsage() {
|
|
623
|
+
const indent = " ".repeat(SYNOPSIS_WIDTH + 4);
|
|
624
|
+
return CLASSIC_VERB_HELP.flatMap(({ verb, args, detail }) => {
|
|
625
|
+
const synopsis = `bkit ${verb}${args ? ` ${args}` : ""}`;
|
|
626
|
+
if (synopsis.length > SYNOPSIS_WIDTH) {
|
|
627
|
+
return [` ${synopsis}`, ...detail.map((d) => indent + d)];
|
|
628
|
+
}
|
|
629
|
+
const [first = "", ...rest] = detail;
|
|
630
|
+
return [` ${synopsis.padEnd(SYNOPSIS_WIDTH)} ${first}`, ...rest.map((d) => indent + d)];
|
|
631
|
+
}).join("\n");
|
|
632
|
+
}
|
|
416
633
|
export function printUsage() {
|
|
417
634
|
console.log(`bkit — agent-stack consolidation CLI
|
|
418
635
|
|
|
419
636
|
Usage:
|
|
420
|
-
|
|
421
|
-
core foundation. At least one module flag is REQUIRED —
|
|
422
|
-
a bare \`bkit install\` errors (name the modules below).
|
|
423
|
-
Hosts compose: --claude --cursor --codex --antigravity
|
|
424
|
-
--opencode=<provider>.
|
|
425
|
-
bkit check Dry-run — drift-check everything already installed (no
|
|
426
|
-
module flags). Exits 1 when a managed file needs
|
|
427
|
-
re-rendering. Copies under .bkit/templates/ are refreshed by
|
|
428
|
-
install/upgrade and checked for staleness — adopt one by
|
|
429
|
-
copying it elsewhere; that copy is yours. The CI gate.
|
|
430
|
-
Changes no managed file; rewrites .bkit/advisories.md.
|
|
431
|
-
bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
|
|
432
|
-
Upgrade everything installed (no module flags). Diffs old
|
|
433
|
-
vs new templates; conflict list emitted to stderr. Use
|
|
434
|
-
--auto-apply for CI (apply non-conflicting; exit non-zero
|
|
435
|
-
on any conflict). Only a whole file you edited since bkit
|
|
436
|
-
wrote it conflicts; rendered files (agents, commands,
|
|
437
|
-
skills, .bkit/*.md) are always re-rendered — bkit check
|
|
438
|
-
flags an edit to one.
|
|
439
|
-
--to=<version> / --latest atomically BUMP @cbartens/bkit
|
|
440
|
-
(pnpm add), then re-render + re-pin in one step — so a
|
|
441
|
-
version bump can never drift from its rendered mirrors.
|
|
442
|
-
This is the supported way to move bkit versions; a bare
|
|
443
|
-
\`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
|
|
444
|
-
bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
|
|
445
|
-
No flags = full removal — ALL modules incl. opt-in add-ons
|
|
446
|
-
(cloud/opencode) + core. Consumer-owned updater configs
|
|
447
|
-
(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
|
|
448
|
-
files, your own files under docs/, and generated artefacts
|
|
449
|
-
(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
|
|
450
|
-
--nuke to force-remove manifest-listed files). Target with the
|
|
451
|
-
same module flags as install (e.g. uninstall --claude); a
|
|
452
|
-
targeted uninstall leaves core untouched.
|
|
453
|
-
bkit doctor Preflight + post-install advisory replay (changes no
|
|
454
|
-
managed file; rewrites .bkit/advisories.md). Diagnose
|
|
455
|
-
token surfaces and config drift. Exits 0.
|
|
456
|
-
bkit tips [--workflow=<name>] [--all]
|
|
457
|
-
Setup tips: what this repo has not set up yet, most useful
|
|
458
|
-
first, each with a sentence to ask your agent. Top three
|
|
459
|
-
by default; --workflow=design|plan|build|debug|ship puts
|
|
460
|
-
the tips that matter there first and prints one (each
|
|
461
|
-
workflow runs this at its close; audit and utility do the
|
|
462
|
-
same for audits and the ledger / roadmap updaters);
|
|
463
|
-
--all lists every one. Ends with a star line ("bkit-star"
|
|
464
|
-
in bkit.advisories.ignore silences it), except under
|
|
465
|
-
--workflow=audit|utility. Local checks only. Exits 0.
|
|
466
|
-
bkit status Read-only host/provider status. Reports current host+provider
|
|
467
|
-
(sampled from .claude/, .cursor/, package.json, and the
|
|
468
|
-
opencode agent model pins in .opencode/agents/).
|
|
469
|
-
Writes nothing. Exits 0.
|
|
470
|
-
bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
|
|
471
|
-
macOS GUI apps launched from the Dock/Finder do not inherit
|
|
472
|
-
the login shell env (direnv stays shell-only), so MCP token
|
|
473
|
-
placeholders resolve empty. This verb execs the app binary
|
|
474
|
-
directly with the per-repo .bkit/.env merged in. Quit Cursor
|
|
475
|
-
before running — a running instance ignores the new env.
|
|
476
|
-
Override binary path via BKIT_CURSOR_BIN=<path>.
|
|
477
|
-
bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
|
|
478
|
-
Override binary path via BKIT_OPENCODE_BIN=<path>.
|
|
479
|
-
bkit comply --phase=<phase> Run the compliance grader advisory step.
|
|
480
|
-
Checks the diff since parentSha for violations
|
|
481
|
-
(no-mirror-edit, skip-ci-not-head). Advisory only —
|
|
482
|
-
never gates a workflow. Appends kind:"compliance"
|
|
483
|
-
rows to .bkit/stats.jsonl. Fail-open: always exits 0.
|
|
484
|
-
Valid phases: design, plan, build, debug, ship.
|
|
485
|
-
bkit telemetry summary [--phase=<workflow>]
|
|
486
|
-
Per-workflow telemetry report: THIS run's metrics
|
|
487
|
-
(duration, size, friction/deferrals/failures added,
|
|
488
|
-
compliance) against med·5 — the median of the previous 5
|
|
489
|
-
same-workflow runs. The close step of every /bkit-*
|
|
490
|
-
workflow calls this and posts it to the tracker comment.
|
|
491
|
-
--phase=<workflow>: the workflow to report
|
|
492
|
-
(design|plan|build|debug|ship). Without it, prints the
|
|
493
|
-
ledger-health line only. Read-only: exits 0.
|
|
494
|
-
bkit stats This repo's stats report: counts, durations, change-size vs
|
|
495
|
-
outcome, counterSource trust, per-rule and per-version
|
|
496
|
-
compliance, and the unjustified-deferral rate per
|
|
497
|
-
(subagent, model). Reads .bkit/stats.jsonl,
|
|
498
|
-
.bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo
|
|
499
|
-
only; writes .bkit/stats.md and prints it.
|
|
500
|
-
Advisory + inform-only: exits 0.
|
|
501
|
-
bkit help Print this message.
|
|
637
|
+
${classicUsage()}
|
|
502
638
|
|
|
503
639
|
Core (implicit — no flag; installed/upgraded on every install):
|
|
504
640
|
AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
|
|
@@ -506,7 +642,7 @@ Core (implicit — no flag; installed/upgraded on every install):
|
|
|
506
642
|
.gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
|
|
507
643
|
.bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
|
|
508
644
|
runs (added when missing, never overwritten, left by uninstall). The tool scripts those
|
|
509
|
-
gates chain (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
|
|
645
|
+
gates chain (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta) and their devDeps are
|
|
510
646
|
yours to add: see .bkit/templates.md.
|
|
511
647
|
|
|
512
648
|
Module flags (composable; symmetric install ↔ uninstall):
|
|
@@ -542,6 +678,8 @@ Dependency updaters (copy an example and own it):
|
|
|
542
678
|
.bkit/templates/.github/renovate.json5
|
|
543
679
|
.bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
|
|
544
680
|
.bkit/templates/.github/dependabot.yml
|
|
681
|
+
Install records the one present in bkit.dependencies.updater; bkit check
|
|
682
|
+
blocks when that value and the configs disagree.
|
|
545
683
|
All templates and install steps: .bkit/templates.md
|
|
546
684
|
|
|
547
685
|
--auto=<claude|cursor|opencode>
|
|
@@ -635,7 +773,7 @@ function commandsUsage() {
|
|
|
635
773
|
export function validateModuleFlagsForVerb(verb, moduleFlags, tracker = null) {
|
|
636
774
|
if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
|
|
637
775
|
return ("[bkit] `bkit install` requires at least one module flag. Name what to install: " +
|
|
638
|
-
"--claude, --
|
|
776
|
+
"--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
|
|
639
777
|
`--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
|
|
640
778
|
"tracker on what is installed. Run `bkit help` for usage.");
|
|
641
779
|
}
|
|
@@ -13,15 +13,28 @@
|
|
|
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
|
import { AGENT_CONTEXT_CAP, UNJUSTIFIED_REASON, foldFrom, } from "../ledgers/telemetry.js";
|
|
23
|
+
// ---------------------------------------------------------------------------
|
|
24
|
+
// Counts / rates summary
|
|
25
|
+
// ---------------------------------------------------------------------------
|
|
26
|
+
/** `by.workflow` of a row a direct chat wrote, outside any workflow run. */
|
|
27
|
+
export const UTILITY_WORKFLOW = "utility";
|
|
28
|
+
export const ROW_SOURCES = ["workflow", "utility"];
|
|
29
|
+
export function rowSource(row) {
|
|
30
|
+
return row.by?.workflow === UTILITY_WORKFLOW ? "utility" : "workflow";
|
|
31
|
+
}
|
|
19
32
|
export function computeCounts(events) {
|
|
20
33
|
const byKind = {};
|
|
21
34
|
const byWorkflow = {};
|
|
22
35
|
const byRepo = {};
|
|
23
36
|
for (const ev of events) {
|
|
24
|
-
byKind[ev.kind]
|
|
37
|
+
(byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
|
|
25
38
|
const workflow = ev.by?.workflow ?? "unknown";
|
|
26
39
|
byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
|
|
27
40
|
byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
|
|
@@ -260,70 +273,91 @@ export function computeDeferralDiscipline(rows) {
|
|
|
260
273
|
b.total - a.total ||
|
|
261
274
|
a.writer.localeCompare(b.writer));
|
|
262
275
|
}
|
|
276
|
+
export function computeRunFigures(outcomeRows, counterRows, complianceRows) {
|
|
277
|
+
return {
|
|
278
|
+
outcomes: outcomeRows.length,
|
|
279
|
+
compliance: complianceRows.length,
|
|
280
|
+
elapsed: computeElapsedStats(outcomeRows),
|
|
281
|
+
regression: computeRegression(outcomeRows, counterRows),
|
|
282
|
+
complianceRates: computeComplianceRates(complianceRows),
|
|
283
|
+
versionCompliance: computeVersionCompliance(complianceRows),
|
|
284
|
+
challengeGate: computeChallengeGate(outcomeRows),
|
|
285
|
+
agentContext: computeAgentContext(outcomeRows),
|
|
286
|
+
};
|
|
287
|
+
}
|
|
288
|
+
function runFigureLines(label, f) {
|
|
289
|
+
const p = `[bkit-analysis] [${label}]`;
|
|
290
|
+
const lines = [`${p} Run outcomes: ${f.outcomes} | Compliance rows: ${f.compliance}`];
|
|
291
|
+
const { elapsed, regression, challengeGate, complianceRates, versionCompliance } = f;
|
|
292
|
+
if (elapsed.count > 0) {
|
|
293
|
+
lines.push(`${p} Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`);
|
|
294
|
+
}
|
|
295
|
+
lines.push(`${p} #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`);
|
|
296
|
+
for (const b of regression.buckets) {
|
|
297
|
+
if (b.count > 0) {
|
|
298
|
+
lines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
lines.push(`${p} counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`);
|
|
302
|
+
if (challengeGate.runs > 0) {
|
|
303
|
+
lines.push(`${p} Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`);
|
|
304
|
+
}
|
|
305
|
+
if (complianceRates.length > 0) {
|
|
306
|
+
lines.push(`${p} Per-rule compliance rates:`);
|
|
307
|
+
for (const r of complianceRates) {
|
|
308
|
+
lines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
if (versionCompliance.length > 0) {
|
|
312
|
+
lines.push(`${p} Per-bkit.version compliance:`);
|
|
313
|
+
for (const v of versionCompliance) {
|
|
314
|
+
lines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
return lines;
|
|
318
|
+
}
|
|
263
319
|
/** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
|
|
264
320
|
export function runAnalysis(paths, skipKinds = new Set()) {
|
|
265
321
|
const { state, rowCount, malformedLineCount } = foldFrom(paths);
|
|
266
322
|
const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
|
|
267
|
-
const
|
|
268
|
-
|
|
269
|
-
|
|
323
|
+
const grouped = () => ({
|
|
324
|
+
outcome: [],
|
|
325
|
+
counter: [],
|
|
326
|
+
compliance: [],
|
|
327
|
+
});
|
|
328
|
+
const bySource = {
|
|
329
|
+
workflow: grouped(),
|
|
330
|
+
utility: grouped(),
|
|
331
|
+
};
|
|
270
332
|
const deferralRows = [];
|
|
271
333
|
for (const ev of events) {
|
|
334
|
+
const g = bySource[rowSource(ev)];
|
|
272
335
|
if (ev.kind === "outcome") {
|
|
273
|
-
|
|
336
|
+
g.outcome.push(ev);
|
|
274
337
|
}
|
|
275
338
|
else if (ev.kind === "counter") {
|
|
276
|
-
|
|
339
|
+
g.counter.push(ev);
|
|
277
340
|
}
|
|
278
341
|
else if (ev.kind === "compliance") {
|
|
279
|
-
|
|
342
|
+
g.compliance.push(ev);
|
|
280
343
|
}
|
|
281
344
|
else if (ev.kind === "deferral") {
|
|
282
345
|
deferralRows.push(ev);
|
|
283
346
|
}
|
|
284
347
|
}
|
|
285
348
|
const counts = computeCounts(events);
|
|
286
|
-
const
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
349
|
+
const runs = {
|
|
350
|
+
workflow: computeRunFigures(bySource.workflow.outcome, bySource.workflow.counter, bySource.workflow.compliance),
|
|
351
|
+
utility: computeRunFigures(bySource.utility.outcome, bySource.utility.counter, bySource.utility.compliance),
|
|
352
|
+
};
|
|
290
353
|
const deferralDiscipline = computeDeferralDiscipline(deferralRows);
|
|
291
|
-
const challengeGate = computeChallengeGate(outcomeRows);
|
|
292
|
-
const agentContext = computeAgentContext(outcomeRows);
|
|
293
354
|
const reportLines = [
|
|
294
355
|
`[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
|
|
295
356
|
`[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
|
|
296
357
|
`[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
|
|
297
|
-
|
|
358
|
+
...runFigureLines("workflow", runs.workflow),
|
|
359
|
+
...runFigureLines(UTILITY_WORKFLOW, runs.utility),
|
|
298
360
|
];
|
|
299
|
-
if (elapsed.count > 0) {
|
|
300
|
-
reportLines.push(`[bkit-analysis] Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`);
|
|
301
|
-
}
|
|
302
|
-
// Regression report
|
|
303
|
-
reportLines.push(`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`);
|
|
304
|
-
for (const b of regression.buckets) {
|
|
305
|
-
if (b.count > 0) {
|
|
306
|
-
reportLines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
|
|
307
|
-
}
|
|
308
|
-
}
|
|
309
|
-
reportLines.push(`[bkit-analysis] counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`);
|
|
310
|
-
if (challengeGate.runs > 0) {
|
|
311
|
-
reportLines.push(`[bkit-analysis] Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`);
|
|
312
|
-
}
|
|
313
|
-
// Compliance rates
|
|
314
|
-
if (complianceRates.length > 0) {
|
|
315
|
-
reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
|
|
316
|
-
for (const r of complianceRates) {
|
|
317
|
-
reportLines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
|
|
318
|
-
}
|
|
319
|
-
}
|
|
320
|
-
// Version compliance
|
|
321
|
-
if (versionCompliance.length > 0) {
|
|
322
|
-
reportLines.push(`[bkit-analysis] Per-bkit.version compliance:`);
|
|
323
|
-
for (const v of versionCompliance) {
|
|
324
|
-
reportLines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
|
|
325
|
-
}
|
|
326
|
-
}
|
|
327
361
|
// Deferral discipline — who defers work they should have finished.
|
|
328
362
|
if (deferralDiscipline.length > 0) {
|
|
329
363
|
const totals = deferralDiscipline.reduce((acc, d) => ({ total: acc.total + d.total, unjust: acc.unjust + d.unjustifiedCount }), { total: 0, unjust: 0 });
|
|
@@ -336,15 +370,5 @@ export function runAnalysis(paths, skipKinds = new Set()) {
|
|
|
336
370
|
reportLines.push(` ${d.writer} [${d.model}]: ${d.unjustifiedCount}/${d.total} unjustified (${(d.unjustifiedRate * 100).toFixed(1)}%) | ${reasons}`);
|
|
337
371
|
}
|
|
338
372
|
}
|
|
339
|
-
return {
|
|
340
|
-
counts,
|
|
341
|
-
elapsed,
|
|
342
|
-
regression,
|
|
343
|
-
complianceRates,
|
|
344
|
-
versionCompliance,
|
|
345
|
-
deferralDiscipline,
|
|
346
|
-
challengeGate,
|
|
347
|
-
agentContext,
|
|
348
|
-
reportLines,
|
|
349
|
-
};
|
|
373
|
+
return { counts, runs, deferralDiscipline, reportLines };
|
|
350
374
|
}
|