@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
package/.bkit/core/engine/cli.ts
CHANGED
|
@@ -11,8 +11,7 @@ import { runCommand } from "./commands/lib.js";
|
|
|
11
11
|
import { launchApp } from "./commands/launch.js";
|
|
12
12
|
import { runStatus, runDoctor } from "./commands/install/doctor.js";
|
|
13
13
|
import { runComplyCommand } from "./commands/comply.js";
|
|
14
|
-
import {
|
|
15
|
-
import { runAnalysisCommand } from "./commands/analysis.js";
|
|
14
|
+
import { runStatsCommand } from "./commands/stats.js";
|
|
16
15
|
import { runTelemetryCommand } from "./commands/telemetry.js";
|
|
17
16
|
import { runTipsCommand } from "./commands/tips.js";
|
|
18
17
|
import { runUpgradeCommand } from "./commands/install/upgrade.js";
|
|
@@ -47,8 +46,7 @@ export const CLASSIC_VERBS: ReadonlySet<string> = new Set([
|
|
|
47
46
|
"uninstall",
|
|
48
47
|
"upgrade",
|
|
49
48
|
"comply",
|
|
50
|
-
"
|
|
51
|
-
"analysis",
|
|
49
|
+
"stats",
|
|
52
50
|
"telemetry",
|
|
53
51
|
"tips",
|
|
54
52
|
"cursor",
|
|
@@ -66,8 +64,7 @@ export type Verb =
|
|
|
66
64
|
| "cursor"
|
|
67
65
|
| "opencode"
|
|
68
66
|
| "comply"
|
|
69
|
-
| "
|
|
70
|
-
| "analysis"
|
|
67
|
+
| "stats"
|
|
71
68
|
| "telemetry"
|
|
72
69
|
| "tips"
|
|
73
70
|
| "help";
|
|
@@ -260,24 +257,12 @@ export function parseArgs(argv: string[]): ParsedArgs {
|
|
|
260
257
|
} else if (firstArg === "comply") {
|
|
261
258
|
verb = "comply";
|
|
262
259
|
args.shift();
|
|
263
|
-
} else if (firstArg === "
|
|
264
|
-
verb = "
|
|
260
|
+
} else if (firstArg === "stats") {
|
|
261
|
+
verb = "stats";
|
|
265
262
|
args.shift();
|
|
266
|
-
//
|
|
263
|
+
// stats takes no flags — reject any remaining positional args
|
|
267
264
|
if (args.length > 0 && !args[0]?.startsWith("-")) {
|
|
268
|
-
console.error(
|
|
269
|
-
`[bkit] \`bkit harvest\` takes no positional args. Run \`bkit help\` for usage.`,
|
|
270
|
-
);
|
|
271
|
-
process.exit(1);
|
|
272
|
-
}
|
|
273
|
-
} else if (firstArg === "analysis") {
|
|
274
|
-
verb = "analysis";
|
|
275
|
-
args.shift();
|
|
276
|
-
// analysis takes no flags — reject any remaining positional args
|
|
277
|
-
if (args.length > 0 && !args[0]?.startsWith("-")) {
|
|
278
|
-
console.error(
|
|
279
|
-
`[bkit] \`bkit analysis\` takes no positional args. Run \`bkit help\` for usage.`,
|
|
280
|
-
);
|
|
265
|
+
console.error(`[bkit] \`bkit stats\` takes no positional args. Run \`bkit help\` for usage.`);
|
|
281
266
|
process.exit(1);
|
|
282
267
|
}
|
|
283
268
|
} else if (firstArg === "telemetry") {
|
|
@@ -580,106 +565,245 @@ export function parseArgs(argv: string[]): ParsedArgs {
|
|
|
580
565
|
};
|
|
581
566
|
}
|
|
582
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
|
+
|
|
583
801
|
export function printUsage(): void {
|
|
584
802
|
console.log(
|
|
585
803
|
`bkit — agent-stack consolidation CLI
|
|
586
804
|
|
|
587
805
|
Usage:
|
|
588
|
-
|
|
589
|
-
core foundation. At least one module flag is REQUIRED —
|
|
590
|
-
a bare \`bkit install\` errors (name the modules below).
|
|
591
|
-
Hosts compose: --claude --cursor --codex --antigravity
|
|
592
|
-
--opencode=<provider>.
|
|
593
|
-
bkit check Dry-run — drift-check everything already installed (no
|
|
594
|
-
module flags). Exits 1 when a managed file needs
|
|
595
|
-
re-rendering. Copies under .bkit/templates/ are refreshed by
|
|
596
|
-
install/upgrade and checked for staleness — adopt one by
|
|
597
|
-
copying it elsewhere; that copy is yours. The CI gate.
|
|
598
|
-
Changes no managed file; rewrites .bkit/advisories.md.
|
|
599
|
-
bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
|
|
600
|
-
Upgrade everything installed (no module flags). Diffs old
|
|
601
|
-
vs new templates; conflict list emitted to stderr. Use
|
|
602
|
-
--auto-apply for CI (apply non-conflicting; exit non-zero
|
|
603
|
-
on any conflict). Only a whole file you edited since bkit
|
|
604
|
-
wrote it conflicts; rendered files (agents, commands,
|
|
605
|
-
skills, .bkit/*.md) are always re-rendered — bkit check
|
|
606
|
-
flags an edit to one.
|
|
607
|
-
--to=<version> / --latest atomically BUMP @cbartens/bkit
|
|
608
|
-
(pnpm add), then re-render + re-pin in one step — so a
|
|
609
|
-
version bump can never drift from its rendered mirrors.
|
|
610
|
-
This is the supported way to move bkit versions; a bare
|
|
611
|
-
\`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
|
|
612
|
-
bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
|
|
613
|
-
No flags = full removal — ALL modules incl. opt-in add-ons
|
|
614
|
-
(cloud/opencode) + core. Consumer-owned updater configs
|
|
615
|
-
(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
|
|
616
|
-
files, your own files under docs/, and generated artefacts
|
|
617
|
-
(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
|
|
618
|
-
--nuke to force-remove manifest-listed files). Target with the
|
|
619
|
-
same module flags as install (e.g. uninstall --claude); a
|
|
620
|
-
targeted uninstall leaves core untouched.
|
|
621
|
-
bkit doctor Preflight + post-install advisory replay (changes no
|
|
622
|
-
managed file; rewrites .bkit/advisories.md). Diagnose
|
|
623
|
-
token surfaces and config drift. Exits 0.
|
|
624
|
-
bkit tips [--workflow=<name>] [--all]
|
|
625
|
-
Setup tips: what this repo has not set up yet, most useful
|
|
626
|
-
first, each with a sentence to ask your agent. Top three
|
|
627
|
-
by default; --workflow=design|plan|build|debug|ship puts
|
|
628
|
-
the tips that matter there first and prints one (each
|
|
629
|
-
workflow runs this at its close; audit and utility do the
|
|
630
|
-
same for audits and the ledger / roadmap updaters);
|
|
631
|
-
--all lists every one. Ends with a star line ("bkit-star"
|
|
632
|
-
in bkit.ignoreAdvisories silences it), except under
|
|
633
|
-
--workflow=audit|utility. Local checks only. Exits 0.
|
|
634
|
-
bkit status Read-only host/provider status. Reports current host+provider
|
|
635
|
-
(sampled from .claude/, .cursor/, package.json, and the
|
|
636
|
-
opencode agent model pins in .opencode/agents/).
|
|
637
|
-
Writes nothing. Exits 0.
|
|
638
|
-
bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
|
|
639
|
-
macOS GUI apps launched from the Dock/Finder do not inherit
|
|
640
|
-
the login shell env (direnv stays shell-only), so MCP token
|
|
641
|
-
placeholders resolve empty. This verb execs the app binary
|
|
642
|
-
directly with the per-repo .bkit/.env merged in. Quit Cursor
|
|
643
|
-
before running — a running instance ignores the new env.
|
|
644
|
-
Override binary path via BKIT_CURSOR_BIN=<path>.
|
|
645
|
-
bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
|
|
646
|
-
Override binary path via BKIT_OPENCODE_BIN=<path>.
|
|
647
|
-
bkit comply --phase=<phase> Run the compliance grader advisory step.
|
|
648
|
-
Checks the diff since parentSha for violations
|
|
649
|
-
(no-mirror-edit, skip-ci-not-head). Advisory only —
|
|
650
|
-
never gates a workflow. Appends kind:"compliance"
|
|
651
|
-
rows to .bkit/stats.jsonl. Fail-open: always exits 0.
|
|
652
|
-
Valid phases: design, plan, build, debug, ship.
|
|
653
|
-
bkit harvest Cross-repo harvest — COPIES consumer .bkit/stats.jsonl
|
|
654
|
-
and MOVES .bkit/friction.jsonl into harvest/ (COUNT-ONLY
|
|
655
|
-
for docs/deferrals.jsonl and docs/failures.jsonl).
|
|
656
|
-
Reads consumer paths from harvest/consumers.md.
|
|
657
|
-
DESTRUCTIVE: harvested friction rows are REMOVED from
|
|
658
|
-
the consumer, but only after they are fsync'd and read
|
|
659
|
-
back from harvest/. stats.jsonl is never modified.
|
|
660
|
-
harvest/ accumulates and is never cleared; it is
|
|
661
|
-
gitignored, so it is the only record of pruned rows —
|
|
662
|
-
back it up. Never commits
|
|
663
|
-
in any repo. Deduplicates by per-kind composite
|
|
664
|
-
identity. Advisory + fail-open: exits 0.
|
|
665
|
-
bkit telemetry summary [--phase=<workflow>]
|
|
666
|
-
Per-workflow telemetry report: THIS run's metrics
|
|
667
|
-
(duration, size, friction/deferrals/failures added,
|
|
668
|
-
compliance) against med·5 — the median of the previous 5
|
|
669
|
-
same-workflow runs. The close step of every /bkit-*
|
|
670
|
-
workflow calls this and posts it to the tracker comment.
|
|
671
|
-
--phase=<workflow>: the workflow to report
|
|
672
|
-
(design|plan|build|debug|ship). Without it, prints the
|
|
673
|
-
ledger-health line only. Read-only: exits 0.
|
|
674
|
-
bkit analysis Cross-repo analysis — reports counts/rates/elapsed-time,
|
|
675
|
-
change-size vs outcome regression, dispatch-size threshold,
|
|
676
|
-
counterSource trust labelling, per-rule compliance
|
|
677
|
-
rate over kind:"compliance" rows, and the
|
|
678
|
-
unjustified-deferral rate per (subagent, model)
|
|
679
|
-
over kind:"deferral" rows. Reads from harvest/,
|
|
680
|
-
.bkit/stats.jsonl and docs/deferrals.jsonl.
|
|
681
|
-
Advisory + inform-only: exits 0.
|
|
682
|
-
bkit help Print this message.
|
|
806
|
+
${classicUsage()}
|
|
683
807
|
|
|
684
808
|
Core (implicit — no flag; installed/upgraded on every install):
|
|
685
809
|
AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
|
|
@@ -687,7 +811,7 @@ Core (implicit — no flag; installed/upgraded on every install):
|
|
|
687
811
|
.gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
|
|
688
812
|
.bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
|
|
689
813
|
runs (added when missing, never overwritten, left by uninstall). The tool scripts those
|
|
690
|
-
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
|
|
691
815
|
yours to add: see .bkit/templates.md.
|
|
692
816
|
|
|
693
817
|
Module flags (composable; symmetric install ↔ uninstall):
|
|
@@ -705,7 +829,7 @@ Module flags (composable; symmetric install ↔ uninstall):
|
|
|
705
829
|
Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js,
|
|
706
830
|
bkit-readguard.js).
|
|
707
831
|
Configure your provider key; verify with \`bkit doctor\`. All installed
|
|
708
|
-
providers tracked in bkit.
|
|
832
|
+
providers tracked in bkit.providers.opencode.installed.
|
|
709
833
|
--codex Codex CLI host. BARE flag — takes no value: Codex runs on one gateway
|
|
710
834
|
(openai), so only --opencode is provider-pluggable. Ships .codex/agents/*.toml
|
|
711
835
|
+ .codex/hooks.json + .codex/hooks/bkit-{gateguard,guardrails,readguard}.cjs,
|
|
@@ -723,6 +847,8 @@ Dependency updaters (copy an example and own it):
|
|
|
723
847
|
.bkit/templates/.github/renovate.json5
|
|
724
848
|
.bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
|
|
725
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.
|
|
726
852
|
All templates and install steps: .bkit/templates.md
|
|
727
853
|
|
|
728
854
|
--auto=<claude|cursor|opencode>
|
|
@@ -736,7 +862,7 @@ Dependency updaters (copy an example and own it):
|
|
|
736
862
|
|
|
737
863
|
Cross-cutting / modifiers:
|
|
738
864
|
--tracker=<name> Wire issue tracker integration. Values: github, linear, jira, none
|
|
739
|
-
(default). Records bkit.
|
|
865
|
+
(default). Records bkit.tracker.default in package.json and substitutes
|
|
740
866
|
tracker snippets into command mirrors. Re-renders every installed
|
|
741
867
|
host, and works alone (bkit install --tracker=github). Switching is
|
|
742
868
|
free; a switch removes the old linear or jira MCP entry unless you
|
|
@@ -754,7 +880,7 @@ Uninstall flags:
|
|
|
754
880
|
--dry-run Print decision table (FILE / DECISION / REASON) without writing.
|
|
755
881
|
--opencode=<provider>
|
|
756
882
|
Surgical provider removal: removes that provider's block from
|
|
757
|
-
opencode.json + drops it from bkit.
|
|
883
|
+
opencode.json + drops it from bkit.providers.opencode.installed. Does NOT remove
|
|
758
884
|
agents/commands/gateguard. If the removed provider was active, the first
|
|
759
885
|
remaining provider becomes active and the agents are re-rendered to its
|
|
760
886
|
model pins.
|
|
@@ -802,7 +928,7 @@ function commandsUsage(): string {
|
|
|
802
928
|
return [
|
|
803
929
|
"",
|
|
804
930
|
"",
|
|
805
|
-
"Workflow commands (bkit <noun> <verb> --flags;
|
|
931
|
+
"Workflow commands (bkit <noun> <verb> --flags; text on stdout, --json for JSON; bkit <noun> --help):",
|
|
806
932
|
...COMMANDS.map((c) => ` bkit ${c.noun.padEnd(width)} ${c.summary}`),
|
|
807
933
|
].join("\n");
|
|
808
934
|
}
|
|
@@ -823,7 +949,7 @@ export function validateModuleFlagsForVerb(
|
|
|
823
949
|
if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
|
|
824
950
|
return (
|
|
825
951
|
"[bkit] `bkit install` requires at least one module flag. Name what to install: " +
|
|
826
|
-
"--claude, --
|
|
952
|
+
"--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
|
|
827
953
|
`--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
|
|
828
954
|
"tracker on what is installed. Run `bkit help` for usage."
|
|
829
955
|
);
|
|
@@ -884,13 +1010,8 @@ export async function main() {
|
|
|
884
1010
|
return;
|
|
885
1011
|
}
|
|
886
1012
|
|
|
887
|
-
if (verb === "
|
|
888
|
-
|
|
889
|
-
return;
|
|
890
|
-
}
|
|
891
|
-
|
|
892
|
-
if (verb === "analysis") {
|
|
893
|
-
runAnalysisCommand();
|
|
1013
|
+
if (verb === "stats") {
|
|
1014
|
+
runStatsCommand();
|
|
894
1015
|
return;
|
|
895
1016
|
}
|
|
896
1017
|
|