@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/dist/cli.js
CHANGED
|
@@ -10,8 +10,7 @@ import { runCommand } from "./commands/lib.js";
|
|
|
10
10
|
import { launchApp } from "./commands/launch.js";
|
|
11
11
|
import { runStatus, runDoctor } from "./commands/install/doctor.js";
|
|
12
12
|
import { runComplyCommand } from "./commands/comply.js";
|
|
13
|
-
import {
|
|
14
|
-
import { runAnalysisCommand } from "./commands/analysis.js";
|
|
13
|
+
import { runStatsCommand } from "./commands/stats.js";
|
|
15
14
|
import { runTelemetryCommand } from "./commands/telemetry.js";
|
|
16
15
|
import { runTipsCommand } from "./commands/tips.js";
|
|
17
16
|
import { runUpgradeCommand } from "./commands/install/upgrade.js";
|
|
@@ -39,8 +38,7 @@ export const CLASSIC_VERBS = new Set([
|
|
|
39
38
|
"uninstall",
|
|
40
39
|
"upgrade",
|
|
41
40
|
"comply",
|
|
42
|
-
"
|
|
43
|
-
"analysis",
|
|
41
|
+
"stats",
|
|
44
42
|
"telemetry",
|
|
45
43
|
"tips",
|
|
46
44
|
"cursor",
|
|
@@ -149,21 +147,12 @@ export function parseArgs(argv) {
|
|
|
149
147
|
verb = "comply";
|
|
150
148
|
args.shift();
|
|
151
149
|
}
|
|
152
|
-
else if (firstArg === "
|
|
153
|
-
verb = "
|
|
150
|
+
else if (firstArg === "stats") {
|
|
151
|
+
verb = "stats";
|
|
154
152
|
args.shift();
|
|
155
|
-
//
|
|
153
|
+
// stats takes no flags — reject any remaining positional args
|
|
156
154
|
if (args.length > 0 && !args[0]?.startsWith("-")) {
|
|
157
|
-
console.error(`[bkit] \`bkit
|
|
158
|
-
process.exit(1);
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
else if (firstArg === "analysis") {
|
|
162
|
-
verb = "analysis";
|
|
163
|
-
args.shift();
|
|
164
|
-
// analysis takes no flags — reject any remaining positional args
|
|
165
|
-
if (args.length > 0 && !args[0]?.startsWith("-")) {
|
|
166
|
-
console.error(`[bkit] \`bkit analysis\` takes no positional args. Run \`bkit help\` for usage.`);
|
|
155
|
+
console.error(`[bkit] \`bkit stats\` takes no positional args. Run \`bkit help\` for usage.`);
|
|
167
156
|
process.exit(1);
|
|
168
157
|
}
|
|
169
158
|
}
|
|
@@ -424,105 +413,228 @@ export function parseArgs(argv) {
|
|
|
424
413
|
tipsWorkflow,
|
|
425
414
|
};
|
|
426
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
|
+
}
|
|
427
633
|
export function printUsage() {
|
|
428
634
|
console.log(`bkit — agent-stack consolidation CLI
|
|
429
635
|
|
|
430
636
|
Usage:
|
|
431
|
-
|
|
432
|
-
core foundation. At least one module flag is REQUIRED —
|
|
433
|
-
a bare \`bkit install\` errors (name the modules below).
|
|
434
|
-
Hosts compose: --claude --cursor --codex --antigravity
|
|
435
|
-
--opencode=<provider>.
|
|
436
|
-
bkit check Dry-run — drift-check everything already installed (no
|
|
437
|
-
module flags). Exits 1 when a managed file needs
|
|
438
|
-
re-rendering. Copies under .bkit/templates/ are refreshed by
|
|
439
|
-
install/upgrade and checked for staleness — adopt one by
|
|
440
|
-
copying it elsewhere; that copy is yours. The CI gate.
|
|
441
|
-
Changes no managed file; rewrites .bkit/advisories.md.
|
|
442
|
-
bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
|
|
443
|
-
Upgrade everything installed (no module flags). Diffs old
|
|
444
|
-
vs new templates; conflict list emitted to stderr. Use
|
|
445
|
-
--auto-apply for CI (apply non-conflicting; exit non-zero
|
|
446
|
-
on any conflict). Only a whole file you edited since bkit
|
|
447
|
-
wrote it conflicts; rendered files (agents, commands,
|
|
448
|
-
skills, .bkit/*.md) are always re-rendered — bkit check
|
|
449
|
-
flags an edit to one.
|
|
450
|
-
--to=<version> / --latest atomically BUMP @cbartens/bkit
|
|
451
|
-
(pnpm add), then re-render + re-pin in one step — so a
|
|
452
|
-
version bump can never drift from its rendered mirrors.
|
|
453
|
-
This is the supported way to move bkit versions; a bare
|
|
454
|
-
\`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
|
|
455
|
-
bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
|
|
456
|
-
No flags = full removal — ALL modules incl. opt-in add-ons
|
|
457
|
-
(cloud/opencode) + core. Consumer-owned updater configs
|
|
458
|
-
(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
|
|
459
|
-
files, your own files under docs/, and generated artefacts
|
|
460
|
-
(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
|
|
461
|
-
--nuke to force-remove manifest-listed files). Target with the
|
|
462
|
-
same module flags as install (e.g. uninstall --claude); a
|
|
463
|
-
targeted uninstall leaves core untouched.
|
|
464
|
-
bkit doctor Preflight + post-install advisory replay (changes no
|
|
465
|
-
managed file; rewrites .bkit/advisories.md). Diagnose
|
|
466
|
-
token surfaces and config drift. Exits 0.
|
|
467
|
-
bkit tips [--workflow=<name>] [--all]
|
|
468
|
-
Setup tips: what this repo has not set up yet, most useful
|
|
469
|
-
first, each with a sentence to ask your agent. Top three
|
|
470
|
-
by default; --workflow=design|plan|build|debug|ship puts
|
|
471
|
-
the tips that matter there first and prints one (each
|
|
472
|
-
workflow runs this at its close; audit and utility do the
|
|
473
|
-
same for audits and the ledger / roadmap updaters);
|
|
474
|
-
--all lists every one. Ends with a star line ("bkit-star"
|
|
475
|
-
in bkit.ignoreAdvisories silences it), except under
|
|
476
|
-
--workflow=audit|utility. Local checks only. Exits 0.
|
|
477
|
-
bkit status Read-only host/provider status. Reports current host+provider
|
|
478
|
-
(sampled from .claude/, .cursor/, package.json, and the
|
|
479
|
-
opencode agent model pins in .opencode/agents/).
|
|
480
|
-
Writes nothing. Exits 0.
|
|
481
|
-
bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
|
|
482
|
-
macOS GUI apps launched from the Dock/Finder do not inherit
|
|
483
|
-
the login shell env (direnv stays shell-only), so MCP token
|
|
484
|
-
placeholders resolve empty. This verb execs the app binary
|
|
485
|
-
directly with the per-repo .bkit/.env merged in. Quit Cursor
|
|
486
|
-
before running — a running instance ignores the new env.
|
|
487
|
-
Override binary path via BKIT_CURSOR_BIN=<path>.
|
|
488
|
-
bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
|
|
489
|
-
Override binary path via BKIT_OPENCODE_BIN=<path>.
|
|
490
|
-
bkit comply --phase=<phase> Run the compliance grader advisory step.
|
|
491
|
-
Checks the diff since parentSha for violations
|
|
492
|
-
(no-mirror-edit, skip-ci-not-head). Advisory only —
|
|
493
|
-
never gates a workflow. Appends kind:"compliance"
|
|
494
|
-
rows to .bkit/stats.jsonl. Fail-open: always exits 0.
|
|
495
|
-
Valid phases: design, plan, build, debug, ship.
|
|
496
|
-
bkit harvest Cross-repo harvest — COPIES consumer .bkit/stats.jsonl
|
|
497
|
-
and MOVES .bkit/friction.jsonl into harvest/ (COUNT-ONLY
|
|
498
|
-
for docs/deferrals.jsonl and docs/failures.jsonl).
|
|
499
|
-
Reads consumer paths from harvest/consumers.md.
|
|
500
|
-
DESTRUCTIVE: harvested friction rows are REMOVED from
|
|
501
|
-
the consumer, but only after they are fsync'd and read
|
|
502
|
-
back from harvest/. stats.jsonl is never modified.
|
|
503
|
-
harvest/ accumulates and is never cleared; it is
|
|
504
|
-
gitignored, so it is the only record of pruned rows —
|
|
505
|
-
back it up. Never commits
|
|
506
|
-
in any repo. Deduplicates by per-kind composite
|
|
507
|
-
identity. Advisory + fail-open: exits 0.
|
|
508
|
-
bkit telemetry summary [--phase=<workflow>]
|
|
509
|
-
Per-workflow telemetry report: THIS run's metrics
|
|
510
|
-
(duration, size, friction/deferrals/failures added,
|
|
511
|
-
compliance) against med·5 — the median of the previous 5
|
|
512
|
-
same-workflow runs. The close step of every /bkit-*
|
|
513
|
-
workflow calls this and posts it to the tracker comment.
|
|
514
|
-
--phase=<workflow>: the workflow to report
|
|
515
|
-
(design|plan|build|debug|ship). Without it, prints the
|
|
516
|
-
ledger-health line only. Read-only: exits 0.
|
|
517
|
-
bkit analysis Cross-repo analysis — reports counts/rates/elapsed-time,
|
|
518
|
-
change-size vs outcome regression, dispatch-size threshold,
|
|
519
|
-
counterSource trust labelling, per-rule compliance
|
|
520
|
-
rate over kind:"compliance" rows, and the
|
|
521
|
-
unjustified-deferral rate per (subagent, model)
|
|
522
|
-
over kind:"deferral" rows. Reads from harvest/,
|
|
523
|
-
.bkit/stats.jsonl and docs/deferrals.jsonl.
|
|
524
|
-
Advisory + inform-only: exits 0.
|
|
525
|
-
bkit help Print this message.
|
|
637
|
+
${classicUsage()}
|
|
526
638
|
|
|
527
639
|
Core (implicit — no flag; installed/upgraded on every install):
|
|
528
640
|
AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
|
|
@@ -530,7 +642,7 @@ Core (implicit — no flag; installed/upgraded on every install):
|
|
|
530
642
|
.gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
|
|
531
643
|
.bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
|
|
532
644
|
runs (added when missing, never overwritten, left by uninstall). The tool scripts those
|
|
533
|
-
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
|
|
534
646
|
yours to add: see .bkit/templates.md.
|
|
535
647
|
|
|
536
648
|
Module flags (composable; symmetric install ↔ uninstall):
|
|
@@ -548,7 +660,7 @@ Module flags (composable; symmetric install ↔ uninstall):
|
|
|
548
660
|
Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js,
|
|
549
661
|
bkit-readguard.js).
|
|
550
662
|
Configure your provider key; verify with \`bkit doctor\`. All installed
|
|
551
|
-
providers tracked in bkit.
|
|
663
|
+
providers tracked in bkit.providers.opencode.installed.
|
|
552
664
|
--codex Codex CLI host. BARE flag — takes no value: Codex runs on one gateway
|
|
553
665
|
(openai), so only --opencode is provider-pluggable. Ships .codex/agents/*.toml
|
|
554
666
|
+ .codex/hooks.json + .codex/hooks/bkit-{gateguard,guardrails,readguard}.cjs,
|
|
@@ -566,6 +678,8 @@ Dependency updaters (copy an example and own it):
|
|
|
566
678
|
.bkit/templates/.github/renovate.json5
|
|
567
679
|
.bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
|
|
568
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.
|
|
569
683
|
All templates and install steps: .bkit/templates.md
|
|
570
684
|
|
|
571
685
|
--auto=<claude|cursor|opencode>
|
|
@@ -579,7 +693,7 @@ Dependency updaters (copy an example and own it):
|
|
|
579
693
|
|
|
580
694
|
Cross-cutting / modifiers:
|
|
581
695
|
--tracker=<name> Wire issue tracker integration. Values: github, linear, jira, none
|
|
582
|
-
(default). Records bkit.
|
|
696
|
+
(default). Records bkit.tracker.default in package.json and substitutes
|
|
583
697
|
tracker snippets into command mirrors. Re-renders every installed
|
|
584
698
|
host, and works alone (bkit install --tracker=github). Switching is
|
|
585
699
|
free; a switch removes the old linear or jira MCP entry unless you
|
|
@@ -597,7 +711,7 @@ Uninstall flags:
|
|
|
597
711
|
--dry-run Print decision table (FILE / DECISION / REASON) without writing.
|
|
598
712
|
--opencode=<provider>
|
|
599
713
|
Surgical provider removal: removes that provider's block from
|
|
600
|
-
opencode.json + drops it from bkit.
|
|
714
|
+
opencode.json + drops it from bkit.providers.opencode.installed. Does NOT remove
|
|
601
715
|
agents/commands/gateguard. If the removed provider was active, the first
|
|
602
716
|
remaining provider becomes active and the agents are re-rendered to its
|
|
603
717
|
model pins.
|
|
@@ -644,7 +758,7 @@ function commandsUsage() {
|
|
|
644
758
|
return [
|
|
645
759
|
"",
|
|
646
760
|
"",
|
|
647
|
-
"Workflow commands (bkit <noun> <verb> --flags;
|
|
761
|
+
"Workflow commands (bkit <noun> <verb> --flags; text on stdout, --json for JSON; bkit <noun> --help):",
|
|
648
762
|
...COMMANDS.map((c) => ` bkit ${c.noun.padEnd(width)} ${c.summary}`),
|
|
649
763
|
].join("\n");
|
|
650
764
|
}
|
|
@@ -659,7 +773,7 @@ function commandsUsage() {
|
|
|
659
773
|
export function validateModuleFlagsForVerb(verb, moduleFlags, tracker = null) {
|
|
660
774
|
if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
|
|
661
775
|
return ("[bkit] `bkit install` requires at least one module flag. Name what to install: " +
|
|
662
|
-
"--claude, --
|
|
776
|
+
"--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
|
|
663
777
|
`--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
|
|
664
778
|
"tracker on what is installed. Run `bkit help` for usage.");
|
|
665
779
|
}
|
|
@@ -698,12 +812,8 @@ export async function main() {
|
|
|
698
812
|
runComplyCommand(complyPhase);
|
|
699
813
|
return;
|
|
700
814
|
}
|
|
701
|
-
if (verb === "
|
|
702
|
-
|
|
703
|
-
return;
|
|
704
|
-
}
|
|
705
|
-
if (verb === "analysis") {
|
|
706
|
-
runAnalysisCommand();
|
|
815
|
+
if (verb === "stats") {
|
|
816
|
+
runStatsCommand();
|
|
707
817
|
return;
|
|
708
818
|
}
|
|
709
819
|
if (verb === "telemetry") {
|