@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
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
// Local full-gate receipts, shared by linked worktrees and bound to committed trees.
|
|
2
|
+
import { spawnSync } from "node:child_process";
|
|
3
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as os from "node:os";
|
|
6
|
+
import * as path from "node:path";
|
|
7
|
+
import { gitEnv } from "../../ledgers/telemetry.js";
|
|
8
|
+
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
9
|
+
import { readPackageJson } from "../../shared/package-json.js";
|
|
10
|
+
import { scriptCommand, testCommand } from "../../shared/package-manager.js";
|
|
11
|
+
import { EXIT, git, outboxRoot, runGit } from "../lib.js";
|
|
12
|
+
import { changedOutside } from "../workflow/ledgers.js";
|
|
13
|
+
const UNIT = "bkit:gate:static-unit";
|
|
14
|
+
const INTEGRATION = "bkit:gate:static-unit-integration";
|
|
15
|
+
const SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
|
|
16
|
+
function scriptsOf(pkg) {
|
|
17
|
+
if (!pkg || typeof pkg !== "object" || !("scripts" in pkg))
|
|
18
|
+
return null;
|
|
19
|
+
const scripts = pkg.scripts;
|
|
20
|
+
if (!scripts || typeof scripts !== "object" || Array.isArray(scripts))
|
|
21
|
+
return null;
|
|
22
|
+
return scripts;
|
|
23
|
+
}
|
|
24
|
+
function gateDefinition(pkg) {
|
|
25
|
+
const values = scriptsOf(pkg);
|
|
26
|
+
if (!values)
|
|
27
|
+
return null;
|
|
28
|
+
const gate = typeof values[INTEGRATION] === "string" ? INTEGRATION : UNIT;
|
|
29
|
+
if (typeof values[gate] !== "string" || values[gate].trim() === "")
|
|
30
|
+
return null;
|
|
31
|
+
const fingerprint = createHash("sha256")
|
|
32
|
+
.update(JSON.stringify(Object.entries(values).sort(([a], [b]) => a.localeCompare(b))))
|
|
33
|
+
.digest("hex");
|
|
34
|
+
return { gate, fingerprint };
|
|
35
|
+
}
|
|
36
|
+
/** The deepest full push gate declared by this checkout. */
|
|
37
|
+
export function requiredPushGate(cwd) {
|
|
38
|
+
const pkg = readPackageJson(cwd);
|
|
39
|
+
return pkg.ok ? (gateDefinition(pkg.pkg)?.gate ?? null) : null;
|
|
40
|
+
}
|
|
41
|
+
const receiptPath = (cwd, sha) => {
|
|
42
|
+
const outbox = outboxRoot(cwd);
|
|
43
|
+
return outbox ? path.join(outbox, "push-gates", `${sha}.json`) : null;
|
|
44
|
+
};
|
|
45
|
+
function cleanHead(cwd) {
|
|
46
|
+
const status = git(cwd, [
|
|
47
|
+
"status",
|
|
48
|
+
"--porcelain",
|
|
49
|
+
"--untracked-files=all",
|
|
50
|
+
"--ignore-submodules=none",
|
|
51
|
+
]);
|
|
52
|
+
if (status !== "")
|
|
53
|
+
return null;
|
|
54
|
+
const sha = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
|
|
55
|
+
const tree = git(cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
|
|
56
|
+
return sha && tree ? { sha, tree } : null;
|
|
57
|
+
}
|
|
58
|
+
/** Execute a consumer gate; only a successful deepest full gate on an unchanged clean tree earns proof. */
|
|
59
|
+
export function runPushGate(cwd, gate, log) {
|
|
60
|
+
const pkg = readPackageJson(cwd);
|
|
61
|
+
const script = pkg.ok ? scriptsOf(pkg.pkg)?.[gate] : null;
|
|
62
|
+
if (typeof script !== "string" || script.trim() === "") {
|
|
63
|
+
log(`package.json must declare a non-empty ${gate} script`);
|
|
64
|
+
return EXIT.USAGE;
|
|
65
|
+
}
|
|
66
|
+
const definition = pkg.ok ? gateDefinition(pkg.pkg) : null;
|
|
67
|
+
const before = cleanHead(cwd);
|
|
68
|
+
const head = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
|
|
69
|
+
const file = head ? receiptPath(cwd, head) : null;
|
|
70
|
+
const attempt = file && definition?.gate === gate ? path.join(`${file}.running`, randomUUID()) : null;
|
|
71
|
+
const fail = () => {
|
|
72
|
+
if (!attempt || !file)
|
|
73
|
+
return;
|
|
74
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
75
|
+
fs.writeFileSync(`${file}.failed`, JSON.stringify({ version: 1, sha: head, gate, passed: false }) + "\n");
|
|
76
|
+
fs.rmSync(file, { force: true });
|
|
77
|
+
};
|
|
78
|
+
if (attempt) {
|
|
79
|
+
fs.mkdirSync(path.dirname(attempt), { recursive: true });
|
|
80
|
+
fs.writeFileSync(attempt, JSON.stringify({ pid: process.pid, sha: head }) + "\n");
|
|
81
|
+
fail();
|
|
82
|
+
}
|
|
83
|
+
const finish = (code) => {
|
|
84
|
+
if (attempt)
|
|
85
|
+
fs.rmSync(attempt, { force: true });
|
|
86
|
+
return code;
|
|
87
|
+
};
|
|
88
|
+
const argv = testCommand(scriptCommand(gate));
|
|
89
|
+
log(`running ${scriptCommand(gate).join(" ")}`);
|
|
90
|
+
const result = spawnSync(argv[0], argv.slice(1), {
|
|
91
|
+
cwd,
|
|
92
|
+
env: gitEnv(),
|
|
93
|
+
stdio: ["ignore", 2, 2],
|
|
94
|
+
});
|
|
95
|
+
const status = result.error
|
|
96
|
+
? 127
|
|
97
|
+
: (result.status ??
|
|
98
|
+
128 + ((result.signal ? os.constants.signals[result.signal] : undefined) ?? 1));
|
|
99
|
+
if (result.error)
|
|
100
|
+
log(result.error.message);
|
|
101
|
+
if (status !== 0 || !before || definition?.gate !== gate) {
|
|
102
|
+
fail();
|
|
103
|
+
return finish(status);
|
|
104
|
+
}
|
|
105
|
+
const after = cleanHead(cwd);
|
|
106
|
+
const afterPkg = readPackageJson(cwd);
|
|
107
|
+
if (after?.sha !== before.sha ||
|
|
108
|
+
after.tree !== before.tree ||
|
|
109
|
+
!afterPkg.ok ||
|
|
110
|
+
gateDefinition(afterPkg.pkg)?.fingerprint !== definition.fingerprint) {
|
|
111
|
+
log("full gate passed, but the checkout changed — no reusable push receipt");
|
|
112
|
+
fail();
|
|
113
|
+
return finish(status);
|
|
114
|
+
}
|
|
115
|
+
if (file) {
|
|
116
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
117
|
+
fs.writeFileSync(file, JSON.stringify({ version: 1, ...before, ...definition, passed: true }) + "\n");
|
|
118
|
+
fs.rmSync(`${file}.failed`, { force: true });
|
|
119
|
+
log(`recorded full push gate for ${before.sha}`);
|
|
120
|
+
}
|
|
121
|
+
return finish(status);
|
|
122
|
+
}
|
|
123
|
+
/** Pending files survive interrupted runners; one read suffices to block earlier proof. */
|
|
124
|
+
function pendingAttempt(file) {
|
|
125
|
+
const dir = `${file}.running`;
|
|
126
|
+
if (!fs.existsSync(dir))
|
|
127
|
+
return false;
|
|
128
|
+
const handle = fs.opendirSync(dir);
|
|
129
|
+
try {
|
|
130
|
+
return handle.readSync() !== null;
|
|
131
|
+
}
|
|
132
|
+
finally {
|
|
133
|
+
handle.closeSync();
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
function validReceipt(cwd, file, sha, definition) {
|
|
137
|
+
const read = readJsonFile(file);
|
|
138
|
+
if (!read.ok || !read.value || typeof read.value !== "object")
|
|
139
|
+
return false;
|
|
140
|
+
const receipt = read.value;
|
|
141
|
+
return (receipt.version === 1 &&
|
|
142
|
+
receipt.passed === true &&
|
|
143
|
+
receipt.sha === sha &&
|
|
144
|
+
receipt.gate === definition.gate &&
|
|
145
|
+
receipt.fingerprint === definition.fingerprint &&
|
|
146
|
+
receipt.tree === git(cwd, ["rev-parse", `${sha}^{tree}`]));
|
|
147
|
+
}
|
|
148
|
+
/** Every commit not covered by this success must be free of failed or unreadable gate evidence. */
|
|
149
|
+
function noLaterFailure(cwd, dir, sha, newSha, definition) {
|
|
150
|
+
const range = git(cwd, ["rev-list", "--max-count=129", newSha, `^${sha}`]);
|
|
151
|
+
if (range === null)
|
|
152
|
+
return false;
|
|
153
|
+
const commits = range ? range.split("\n") : [];
|
|
154
|
+
if (commits.length > 128)
|
|
155
|
+
return false;
|
|
156
|
+
for (const commit of [sha, ...commits]) {
|
|
157
|
+
const file = path.join(dir, `${commit}.json`);
|
|
158
|
+
if (fs.existsSync(`${file}.failed`) ||
|
|
159
|
+
pendingAttempt(file) ||
|
|
160
|
+
(fs.existsSync(file) && !validReceipt(cwd, file, commit, definition)))
|
|
161
|
+
return false;
|
|
162
|
+
}
|
|
163
|
+
return true;
|
|
164
|
+
}
|
|
165
|
+
/** A bounded ancestor search; absent, malformed or stale proof always requires the full gate. */
|
|
166
|
+
export function hasVerifiedIncrement(cwd, oldSha, newSha, paths) {
|
|
167
|
+
if (!SHA.test(oldSha) ||
|
|
168
|
+
!SHA.test(newSha) ||
|
|
169
|
+
/^0+$/.test(oldSha) ||
|
|
170
|
+
!runGit(cwd, ["merge-base", "--is-ancestor", oldSha, newSha]).ok)
|
|
171
|
+
return false;
|
|
172
|
+
const raw = git(cwd, ["show", `${newSha}:package.json`]);
|
|
173
|
+
const parsed = raw === null ? null : parseJson(raw);
|
|
174
|
+
const definition = parsed?.ok ? gateDefinition(parsed.value) : null;
|
|
175
|
+
const localPkg = readPackageJson(cwd);
|
|
176
|
+
if (!definition ||
|
|
177
|
+
!localPkg.ok ||
|
|
178
|
+
gateDefinition(localPkg.pkg)?.fingerprint !== definition.fingerprint)
|
|
179
|
+
return false;
|
|
180
|
+
const ancestors = git(cwd, ["rev-list", "--max-count=128", oldSha]);
|
|
181
|
+
const firstFile = receiptPath(cwd, oldSha);
|
|
182
|
+
if (!ancestors || !firstFile)
|
|
183
|
+
return false;
|
|
184
|
+
const dir = path.dirname(firstFile);
|
|
185
|
+
for (const sha of ancestors.split("\n")) {
|
|
186
|
+
const file = path.join(dir, `${sha}.json`);
|
|
187
|
+
if (!validReceipt(cwd, file, sha, definition))
|
|
188
|
+
continue;
|
|
189
|
+
const diff = changedOutside(cwd, sha, newSha, paths);
|
|
190
|
+
if (diff.ok && diff.outside.length === 0 && noLaterFailure(cwd, dir, sha, newSha, definition))
|
|
191
|
+
return true;
|
|
192
|
+
}
|
|
193
|
+
return false;
|
|
194
|
+
}
|
package/dist/commands/comply.js
CHANGED
|
@@ -14,12 +14,10 @@
|
|
|
14
14
|
//
|
|
15
15
|
// See DE-34 for the shared-entrypoint + crash-isolation contract.
|
|
16
16
|
import { execFileSync } from "node:child_process";
|
|
17
|
-
import * as fs from "node:fs";
|
|
18
17
|
import * as path from "node:path";
|
|
19
|
-
import { readJsonFile } from "../shared/json.js";
|
|
20
|
-
import { getPkgRoot } from "../shared/package-roots.js";
|
|
21
18
|
import { isMirrorPath } from "../shared/protected-paths.js";
|
|
22
|
-
import { gitEnv, resolveGitSha,
|
|
19
|
+
import { gitEnv, resolveGitSha, } from "../ledgers/telemetry.js";
|
|
20
|
+
import { appendLedgerRows } from "./workflow/ledgers.js";
|
|
23
21
|
/** SHA charset guard — only raw hex SHAs from the ledger are accepted. */
|
|
24
22
|
const SHA_RE = /^[0-9a-f]{7,40}$/;
|
|
25
23
|
export const realGitAdapter = {
|
|
@@ -134,89 +132,74 @@ export function runGrader(input) {
|
|
|
134
132
|
/**
|
|
135
133
|
* Build one `kind:"compliance"` row per rule.
|
|
136
134
|
* Rules that produced no violation emit a "pass" row.
|
|
137
|
-
* Every row carries `bkitVersion`.
|
|
138
|
-
*
|
|
139
|
-
* Called by the CLI dispatch after `runGrader`.
|
|
140
135
|
*/
|
|
141
136
|
export function buildComplianceRows(input) {
|
|
142
|
-
const
|
|
143
|
-
const { violations, phase, parentSha, repo, bkitVersion, extra } = input;
|
|
137
|
+
const { violations, workflow, parentSha, step } = input;
|
|
144
138
|
const violationByRule = new Map();
|
|
145
139
|
for (const v of violations) {
|
|
146
140
|
violationByRule.set(v.ruleId, v);
|
|
147
141
|
}
|
|
148
142
|
const ALL_RULES = ["no-mirror-edit", "skip-ci-not-head"];
|
|
149
|
-
|
|
150
|
-
for (const ruleId of ALL_RULES) {
|
|
143
|
+
return ALL_RULES.map((ruleId) => {
|
|
151
144
|
const violation = violationByRule.get(ruleId);
|
|
152
|
-
const
|
|
145
|
+
const verdict = violation != null ? violation.result : "pass";
|
|
153
146
|
const evidence = violation?.evidence;
|
|
154
|
-
|
|
155
|
-
ts: ts + rows.length, // micro-offset so each row has a unique ts within the batch
|
|
147
|
+
return {
|
|
156
148
|
kind: "compliance",
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
step: "close-gate",
|
|
161
|
-
...(extra ?? {}),
|
|
162
|
-
};
|
|
163
|
-
const payload = {
|
|
164
|
-
rule: ruleId,
|
|
165
|
-
result,
|
|
166
|
-
...(evidence != null ? { evidence } : {}),
|
|
167
|
-
phase,
|
|
168
|
-
parentSha,
|
|
149
|
+
by: { workflow, step },
|
|
150
|
+
run: { parentSha },
|
|
151
|
+
rule: { id: ruleId, verdict, ...(evidence != null ? { evidence } : {}) },
|
|
169
152
|
};
|
|
170
|
-
|
|
171
|
-
}
|
|
172
|
-
return rows;
|
|
153
|
+
});
|
|
173
154
|
}
|
|
174
155
|
// ---------------------------------------------------------------------------
|
|
175
156
|
// Append helper — writes rows to .bkit/stats.jsonl (best-effort)
|
|
176
157
|
// ---------------------------------------------------------------------------
|
|
177
158
|
/**
|
|
178
|
-
* Append compliance rows to
|
|
179
|
-
* Best-effort: prints `[bkit-comply] append failed: …` on error,
|
|
159
|
+
* Append compliance rows to `<root>/.bkit/stats.jsonl` through `bkit ledgers append`.
|
|
160
|
+
* Best-effort: prints `[bkit-comply] append failed: …` and returns false on error,
|
|
161
|
+
* never throws.
|
|
180
162
|
*/
|
|
181
|
-
export function appendComplianceRows(rows,
|
|
163
|
+
export function appendComplianceRows(rows, root, log = (m) => console.error(m)) {
|
|
164
|
+
if (rows.length === 0)
|
|
165
|
+
return false;
|
|
182
166
|
try {
|
|
183
|
-
|
|
184
|
-
|
|
167
|
+
appendLedgerRows(root, "stats", rows);
|
|
168
|
+
return true;
|
|
185
169
|
}
|
|
186
170
|
catch (err) {
|
|
187
171
|
const msg = err instanceof Error ? err.message : String(err);
|
|
188
|
-
|
|
172
|
+
log(`[bkit-comply] append failed: ${path.join(root, ".bkit", "stats.jsonl")} — ${msg}`);
|
|
173
|
+
return false;
|
|
189
174
|
}
|
|
190
175
|
}
|
|
191
|
-
// ---------------------------------------------------------------------------
|
|
192
|
-
// One grading pass, as `bkit workflows close` runs it before its report
|
|
193
|
-
// ---------------------------------------------------------------------------
|
|
194
176
|
/**
|
|
195
177
|
* Grade `phase` over HEAD~1..HEAD (HEAD alone in a one-commit repo) and append
|
|
196
178
|
* its compliance rows to `<cwd>/.bkit/stats.jsonl`. With `squashSha` (ship's
|
|
197
179
|
* close, run in the feature worktree) the squash commit is graded instead —
|
|
198
180
|
* its subject and `squash~1..squash` — so the grade covers the whole feature
|
|
199
|
-
* as it reaches main, not the worktree's last commit.
|
|
200
|
-
*
|
|
181
|
+
* as it reaches main, not the worktree's last commit. The rows carry `run`'s
|
|
182
|
+
* `parentSha` and step (default: HEAD and `close-gate`), so they join the
|
|
183
|
+
* close's other rows. Fail-open: any error is logged and returns null, so a
|
|
184
|
+
* close never stops on the grader.
|
|
201
185
|
*/
|
|
202
|
-
export function gradeCompliance(cwd, phase, log, squashSha) {
|
|
186
|
+
export function gradeCompliance(cwd, phase, log, squashSha, run) {
|
|
203
187
|
try {
|
|
204
188
|
const squashParent = squashSha === undefined ? "" : resolveGitSha(`${squashSha}~1`, cwd);
|
|
205
|
-
const
|
|
206
|
-
if (!
|
|
189
|
+
const base = squashParent || resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
|
|
190
|
+
if (!base) {
|
|
207
191
|
log("[bkit-comply] cannot resolve a parent SHA (no commits?) — skipping grade");
|
|
208
192
|
return null;
|
|
209
193
|
}
|
|
210
194
|
const headSha = squashParent ? squashSha : undefined;
|
|
211
|
-
const violations = runGrader({ parentSha, phase, cwd, ...(headSha ? { headSha } : {}) });
|
|
195
|
+
const violations = runGrader({ parentSha: base, phase, cwd, ...(headSha ? { headSha } : {}) });
|
|
212
196
|
const rows = buildComplianceRows({
|
|
213
197
|
violations,
|
|
214
|
-
phase,
|
|
215
|
-
parentSha,
|
|
216
|
-
|
|
217
|
-
bkitVersion: readBkitVersion(),
|
|
198
|
+
workflow: phase,
|
|
199
|
+
parentSha: run?.parentSha ?? resolveGitSha("HEAD", cwd),
|
|
200
|
+
step: run?.step ?? "close-gate",
|
|
218
201
|
});
|
|
219
|
-
appendComplianceRows(rows,
|
|
202
|
+
appendComplianceRows(rows, cwd, log);
|
|
220
203
|
log(violations.length > 0
|
|
221
204
|
? `[bkit-comply] Compliance violations found:\n${formatComplianceSummary(violations)}`
|
|
222
205
|
: "[bkit-comply] All rules pass.");
|
|
@@ -247,34 +230,6 @@ export function formatComplianceSummary(violations) {
|
|
|
247
230
|
];
|
|
248
231
|
return lines.join("\n");
|
|
249
232
|
}
|
|
250
|
-
// ---------------------------------------------------------------------------
|
|
251
|
-
// bkitVersion reader (used by CLI dispatch and tests)
|
|
252
|
-
// ---------------------------------------------------------------------------
|
|
253
|
-
/**
|
|
254
|
-
* Read the bkit version from the package.json nearest to `searchFrom` (default: the
|
|
255
|
-
* running bkit package's root). Returns "0.0.0" on any read/parse error (fail-open).
|
|
256
|
-
*/
|
|
257
|
-
export function readBkitVersion(searchFrom) {
|
|
258
|
-
// Walk up looking for a package.json with a `version` field; stop at the filesystem root.
|
|
259
|
-
let dir = path.resolve(searchFrom ?? getPkgRoot());
|
|
260
|
-
for (let i = 0; i < 8; i++) {
|
|
261
|
-
const candidate = path.join(dir, "package.json");
|
|
262
|
-
if (fs.existsSync(candidate)) {
|
|
263
|
-
const read = readJsonFile(candidate);
|
|
264
|
-
// Fail-open: a package.json that cannot be read ends the search with the default.
|
|
265
|
-
if (!read.ok || read.value === null)
|
|
266
|
-
return "0.0.0";
|
|
267
|
-
const pkg = read.value;
|
|
268
|
-
if (typeof pkg.version === "string")
|
|
269
|
-
return pkg.version;
|
|
270
|
-
}
|
|
271
|
-
const parent = path.dirname(dir);
|
|
272
|
-
if (parent === dir)
|
|
273
|
-
break;
|
|
274
|
-
dir = parent;
|
|
275
|
-
}
|
|
276
|
-
return "0.0.0";
|
|
277
|
-
}
|
|
278
233
|
// comply — compliance grader (advisory, never gating, fail-open).
|
|
279
234
|
// Runs `runGrader` over `git diff parentSha..HEAD`, appends `kind:"compliance"`
|
|
280
235
|
// rows to `.bkit/stats.jsonl`, and logs violations. Always exits 0 (fail-open);
|
|
@@ -286,22 +241,25 @@ export function runComplyCommand(complyPhase) {
|
|
|
286
241
|
const cwd = process.cwd();
|
|
287
242
|
const phase = complyPhase ?? "unknown";
|
|
288
243
|
const logPrefix = "[bkit-comply]";
|
|
289
|
-
//
|
|
290
|
-
// matching /^[0-9a-f]{7,40}
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
const parentSha = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
|
|
294
|
-
if (!parentSha) {
|
|
244
|
+
// The grade's diff base MUST be a resolved hex SHA: diffPaths returns [] for anything
|
|
245
|
+
// not matching /^[0-9a-f]{7,40}$/. Resolves HEAD~1, else HEAD; neither → skip the grade.
|
|
246
|
+
const base = resolveGitSha("HEAD~1", cwd) || resolveGitSha("HEAD", cwd);
|
|
247
|
+
if (!base) {
|
|
295
248
|
console.log(`${logPrefix} cannot resolve a parent SHA (no commits?) — skipping grade`);
|
|
296
249
|
return;
|
|
297
250
|
}
|
|
298
|
-
console.log(`${logPrefix} Running compliance grader (phase=${phase},
|
|
299
|
-
const violations = runGrader({ parentSha, phase, cwd });
|
|
300
|
-
//
|
|
301
|
-
const
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
251
|
+
console.log(`${logPrefix} Running compliance grader (phase=${phase}, base=${base})`);
|
|
252
|
+
const violations = runGrader({ parentSha: base, phase, cwd });
|
|
253
|
+
// A row names the closing workflow it grades: without one, the grade is printed only.
|
|
254
|
+
const rows = complyPhase === null
|
|
255
|
+
? []
|
|
256
|
+
: buildComplianceRows({
|
|
257
|
+
violations,
|
|
258
|
+
workflow: complyPhase,
|
|
259
|
+
parentSha: resolveGitSha("HEAD", cwd),
|
|
260
|
+
step: "close-gate",
|
|
261
|
+
});
|
|
262
|
+
const written = complyPhase !== null && appendComplianceRows(rows, cwd);
|
|
305
263
|
if (violations.length > 0) {
|
|
306
264
|
const summary = formatComplianceSummary(violations);
|
|
307
265
|
console.log(`${logPrefix} Compliance violations found:\n${summary}`);
|
|
@@ -309,7 +267,12 @@ export function runComplyCommand(complyPhase) {
|
|
|
309
267
|
else {
|
|
310
268
|
console.log(`${logPrefix} All rules pass.`);
|
|
311
269
|
}
|
|
312
|
-
|
|
270
|
+
if (complyPhase === null) {
|
|
271
|
+
console.log(`${logPrefix} no --phase: rows not written to .bkit/stats.jsonl.`);
|
|
272
|
+
}
|
|
273
|
+
else if (written) {
|
|
274
|
+
console.log(`${logPrefix} Appended ${rows.length} compliance row(s) to .bkit/stats.jsonl (advisory — not gating).`);
|
|
275
|
+
}
|
|
313
276
|
}
|
|
314
277
|
catch (err) {
|
|
315
278
|
// Fail-open: any unexpected error in the dispatch body must not gate the workflow.
|
|
@@ -147,7 +147,7 @@ export async function runDoctor(modules, opencodeProvider) {
|
|
|
147
147
|
allFindings.push({
|
|
148
148
|
id: "opencode-provider-missing",
|
|
149
149
|
severity: "blocker",
|
|
150
|
-
detect: "`.opencode/` is present but no provider is recorded — neither package.json `bkit.
|
|
150
|
+
detect: "`.opencode/` is present but no provider is recorded — neither package.json `bkit.providers.opencode.default` nor an `opencode.json` provider block.",
|
|
151
151
|
action: `Re-run \`bkit install --opencode=<provider>\` (${OPENCODE_PROVIDERS.join(", ")}). Until then \`bkit check\` and \`bkit upgrade\` exit 1 rather than render every agent pin against a substitute provider.`,
|
|
152
152
|
});
|
|
153
153
|
}
|
|
@@ -185,7 +185,7 @@ export async function runDoctor(modules, opencodeProvider) {
|
|
|
185
185
|
let detectedProvider = detectOpencodeProvider(process.cwd());
|
|
186
186
|
if (opencodeProvider)
|
|
187
187
|
detectedProvider = opencodeProvider;
|
|
188
|
-
// Multi-provider: all installed providers. bkit.
|
|
188
|
+
// Multi-provider: all installed providers. bkit.providers.opencode.installed when populated,
|
|
189
189
|
// else the single detected provider.
|
|
190
190
|
const allProviders = detectOpencodeProviders(process.cwd());
|
|
191
191
|
const activeProvider = detectedProvider ?? allProviders[0] ?? null;
|
|
@@ -15,8 +15,9 @@ import { formatChecklist, readChangelogVersionDelta, runPostInstallCheck, writeA
|
|
|
15
15
|
import { collectTips } from "../../checks/tips/index.js";
|
|
16
16
|
import { findMissingOwnedHooks, detectOwnedHookMissing } from "../../checks/after/managed.js";
|
|
17
17
|
import { resolveTokens } from "../../install/placeholders.js";
|
|
18
|
-
import { parseModelLookup, applyModelOverrides, buildOpencodeModelLookup, buildAntigravityModelLookup, parseEffortMap, } from "../../render/models.js";
|
|
18
|
+
import { parseModelLookup, applyModelOverrides, unknownModelOverrides, buildOpencodeModelLookup, buildAntigravityModelLookup, parseEffortMap, } from "../../render/models.js";
|
|
19
19
|
import { getBkitDocsRoot } from "../../shared/package-roots.js";
|
|
20
|
+
import { migrateBkitLayout, migrateGithubProjectKey, migrateLinearTeamKey, } from "../../install/modules/core.js";
|
|
20
21
|
import { removeUnusedTrackerMcpEntries, runUninstall } from "./uninstall.js";
|
|
21
22
|
// ---------------------------------------------------------------------------
|
|
22
23
|
// Staging scratch area
|
|
@@ -43,7 +44,7 @@ export function discardAllStaging(cwd = process.cwd()) {
|
|
|
43
44
|
* The installed opencode provider, or exit(1) with the fix.
|
|
44
45
|
*
|
|
45
46
|
* `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
|
|
46
|
-
* consumer actually installed (package.json `bkit.
|
|
47
|
+
* consumer actually installed (package.json `bkit.providers.opencode.default`, else the opencode.json
|
|
47
48
|
* provider block). There is no default: a repo carrying `.opencode/` with no recorded
|
|
48
49
|
* provider is a broken install.
|
|
49
50
|
*
|
|
@@ -53,7 +54,7 @@ export function requireOpencodeProvider(cwd, context) {
|
|
|
53
54
|
const detected = detectOpencodeProvider(cwd);
|
|
54
55
|
if (!detected) {
|
|
55
56
|
console.error(`${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
|
|
56
|
-
`(package.json \`bkit.
|
|
57
|
+
`(package.json \`bkit.providers.opencode.default\` and .opencode/opencode.json are both silent). ` +
|
|
57
58
|
`Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`);
|
|
58
59
|
process.exit(1);
|
|
59
60
|
}
|
|
@@ -99,11 +100,20 @@ export function validateCloudTrackerMatch(cloudVariant, hasCloudModule, issueTra
|
|
|
99
100
|
? `Set the tracker first: bkit install --tracker=${requiredTracker} --auto=${cloudVariant}`
|
|
100
101
|
: `Re-run with the matching tracker: bkit install --tracker=${requiredTracker} --auto=${cloudVariant} (tracker switching is free).`));
|
|
101
102
|
}
|
|
103
|
+
/** `parent[key]` as an object, set to a fresh `{}` first when it is absent or not an object. */
|
|
104
|
+
function section(parent, key) {
|
|
105
|
+
const v = parent[key];
|
|
106
|
+
if (v !== null && typeof v === "object" && !Array.isArray(v))
|
|
107
|
+
return v;
|
|
108
|
+
const fresh = {};
|
|
109
|
+
parent[key] = fresh;
|
|
110
|
+
return fresh;
|
|
111
|
+
}
|
|
102
112
|
/**
|
|
103
113
|
* Detect the bkit opencode provider key a consumer installed.
|
|
104
114
|
*
|
|
105
115
|
* Resolution order:
|
|
106
|
-
* 1. `package.json` `bkit.
|
|
116
|
+
* 1. `package.json` `bkit.providers.opencode.default` — the authoritative record written on install.
|
|
107
117
|
* This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
|
|
108
118
|
* custom provider block.
|
|
109
119
|
* 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
|
|
@@ -136,7 +146,7 @@ export function detectOpencodeProvider(cwd) {
|
|
|
136
146
|
}
|
|
137
147
|
/**
|
|
138
148
|
* Returns all bkit-installed opencode providers from the consumer package.json
|
|
139
|
-
* `bkit.
|
|
149
|
+
* `bkit.providers.opencode.installed` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
|
|
140
150
|
* the field is absent.
|
|
141
151
|
*/
|
|
142
152
|
export function detectOpencodeProviders(cwd) {
|
|
@@ -183,6 +193,17 @@ export async function runInstall(args, upgradeReport = false) {
|
|
|
183
193
|
console.log(`${LOG_PREFIX} Checking advisories (read-only)`);
|
|
184
194
|
else if (dryRun)
|
|
185
195
|
console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
|
|
196
|
+
// The package.json key moves run before anything below reads `bkit` settings: the tracker,
|
|
197
|
+
// the opencode provider and the cloud agent are read from the new paths only, so a 5.x
|
|
198
|
+
// layout read first renders every host as if no tracker were set. The core module runs
|
|
199
|
+
// the same moves again; each is a no-op once applied. Check moves nothing and reports
|
|
200
|
+
// the old keys as drift.
|
|
201
|
+
const ws = { writes: [] };
|
|
202
|
+
if (!dryRun) {
|
|
203
|
+
migrateLinearTeamKey(false, ws, LOG_PREFIX);
|
|
204
|
+
migrateGithubProjectKey(false, ws, LOG_PREFIX);
|
|
205
|
+
migrateBkitLayout(false, ws, LOG_PREFIX);
|
|
206
|
+
}
|
|
186
207
|
// `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
|
|
187
208
|
// not to a fixed full set. `install` keeps its explicit resolved set, plus every installed
|
|
188
209
|
// host when `--tracker=` is given: each host renders tracker-specific commands, agents and
|
|
@@ -194,13 +215,13 @@ export async function runInstall(args, upgradeReport = false) {
|
|
|
194
215
|
: modules;
|
|
195
216
|
// RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
|
|
196
217
|
// `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
|
|
197
|
-
// (package.json `bkit.
|
|
218
|
+
// (package.json `bkit.providers.opencode.default`, else the opencode.json provider block). On install
|
|
198
219
|
// `?? detect` fires only when opencode joins as an installed host under `--tracker=`; with
|
|
199
220
|
// `--opencode=<provider>` the flag wins. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
|
|
200
221
|
// below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
|
|
201
222
|
// so the tracker-dependent opencode mcp block renders the same way on check.
|
|
202
223
|
const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
|
|
203
|
-
// Resolve issueTracker: --tracker= flag overrides; else read bkit.
|
|
224
|
+
// Resolve issueTracker: --tracker= flag overrides; else read bkit.tracker.default from consumer
|
|
204
225
|
// package.json; else default to "none".
|
|
205
226
|
// A `--tracker=` value always applies, whether first-set or a re-set of an
|
|
206
227
|
// already-recorded tracker.
|
|
@@ -294,7 +315,17 @@ export async function runInstall(args, upgradeReport = false) {
|
|
|
294
315
|
}
|
|
295
316
|
// Seed preflight advisories into ctx so modules can accumulate into the same list.
|
|
296
317
|
const advisories = [...preflightAdvisories];
|
|
297
|
-
const
|
|
318
|
+
const deadOverrides = modelLookup.size > 0
|
|
319
|
+
? unknownModelOverrides(consumerPromptsMdPath, new Set(modelLookup.keys()))
|
|
320
|
+
: [];
|
|
321
|
+
if (deadOverrides.length > 0) {
|
|
322
|
+
advisories.push({
|
|
323
|
+
id: "model-override-unknown-agent",
|
|
324
|
+
severity: "advisory",
|
|
325
|
+
detect: `.bkit/prompts.md § Model Overrides names agents bkit no longer ships: ${deadOverrides.join(", ")}. Those rows are not applied.`,
|
|
326
|
+
action: "Delete the rows, or move each pin to the agent that now does that work (see .bkit/prompts.md § Models).",
|
|
327
|
+
});
|
|
328
|
+
}
|
|
298
329
|
const postDispatch = [];
|
|
299
330
|
// Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
|
|
300
331
|
// validateCloudTrackerMatch for the full rationale. Checked BEFORE any
|
|
@@ -316,8 +347,8 @@ export async function runInstall(args, upgradeReport = false) {
|
|
|
316
347
|
}
|
|
317
348
|
// Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
|
|
318
349
|
// This preserves the "no files written on mismatch" invariant. Two fields are recorded:
|
|
319
|
-
// -
|
|
320
|
-
// -
|
|
350
|
+
// - tracker.default: when a `--tracker=` value was given this run.
|
|
351
|
+
// - providers.opencode.default: when an `--opencode=<provider>` value was given this run. This is
|
|
321
352
|
// the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
|
|
322
353
|
// for managed-auth gateways (opencode), whose opencode.json carries no provider block to
|
|
323
354
|
// detect from. Both are merged in one read-modify-write to avoid double-writing.
|
|
@@ -332,30 +363,30 @@ export async function runInstall(args, upgradeReport = false) {
|
|
|
332
363
|
const parsed = parseJson(raw);
|
|
333
364
|
if (parsed.ok) {
|
|
334
365
|
const pkg = parsed.value;
|
|
335
|
-
const bkit = (pkg
|
|
366
|
+
const bkit = section(pkg, "bkit");
|
|
336
367
|
if (persistTracker)
|
|
337
|
-
bkit.
|
|
368
|
+
section(bkit, "tracker").default = tracker;
|
|
338
369
|
if (persistProvider) {
|
|
339
|
-
|
|
370
|
+
const opencode = section(section(bkit, "providers"), "opencode");
|
|
371
|
+
opencode.default = opencodeProvider; // active (drives agent frontmatter)
|
|
340
372
|
// Update providers array (deduped).
|
|
341
|
-
const existingArr = Array.isArray(
|
|
342
|
-
? [...
|
|
373
|
+
const existingArr = Array.isArray(opencode.installed)
|
|
374
|
+
? [...opencode.installed]
|
|
343
375
|
: [];
|
|
344
376
|
if (!existingArr.includes(opencodeProvider)) {
|
|
345
377
|
existingArr.push(opencodeProvider);
|
|
346
378
|
}
|
|
347
|
-
|
|
379
|
+
opencode.installed = existingArr;
|
|
348
380
|
}
|
|
349
|
-
pkg.bkit = bkit;
|
|
350
381
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
351
382
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
352
383
|
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
353
384
|
fs.writeFileSync(consumerPkgPath2, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
|
|
354
385
|
if (persistTracker) {
|
|
355
|
-
console.log(`${LOG_PREFIX} Set bkit.
|
|
386
|
+
console.log(`${LOG_PREFIX} Set bkit.tracker.default = "${tracker}" in package.json`);
|
|
356
387
|
}
|
|
357
388
|
if (persistProvider) {
|
|
358
|
-
console.log(`${LOG_PREFIX} Set bkit.
|
|
389
|
+
console.log(`${LOG_PREFIX} Set bkit.providers.opencode.default = "${opencodeProvider}" and updated bkit.providers.opencode.installed in package.json`);
|
|
359
390
|
}
|
|
360
391
|
}
|
|
361
392
|
}
|