@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// checks/before/context-fetch.ts — the context-fetch blocks in `.agents/context.md`: present,
|
|
2
|
-
// covering each context, sources enabled, provision blocks in place.
|
|
2
|
+
// covering each context, sources enabled, provision blocks in place, output bounded.
|
|
3
3
|
import * as fs from "node:fs";
|
|
4
4
|
import * as path from "node:path";
|
|
5
5
|
import { getTemplatesRoot } from "../../shared/package-roots.js";
|
|
@@ -82,6 +82,176 @@ function parseContextFetchStarts(section) {
|
|
|
82
82
|
}
|
|
83
83
|
return out;
|
|
84
84
|
}
|
|
85
|
+
/**
|
|
86
|
+
* Parse a consumer section into its `context-fetch` blocks, each with its fenced body. Only
|
|
87
|
+
* NAMED start blocks can be matched to a provision sibling (keyed by name), so an unnamed
|
|
88
|
+
* block is parked under `""`. The `bkit context` runner (commands/workflow/context.ts) and
|
|
89
|
+
* these advisories read the same markers.
|
|
90
|
+
*/
|
|
91
|
+
function parseContextFetchBlocks(consumer) {
|
|
92
|
+
const blocks = [];
|
|
93
|
+
let cur = null;
|
|
94
|
+
let inFence = false;
|
|
95
|
+
for (const line of consumer.split("\n")) {
|
|
96
|
+
const startM = parseContextFetchStart(line);
|
|
97
|
+
const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
|
|
98
|
+
if (startM) {
|
|
99
|
+
cur = { kind: "start", name: startM.name, context: startM.context, body: [] };
|
|
100
|
+
inFence = false;
|
|
101
|
+
blocks.push(cur);
|
|
102
|
+
continue;
|
|
103
|
+
}
|
|
104
|
+
if (provM) {
|
|
105
|
+
cur = { kind: "provision", name: provM[1], context: "", body: [] };
|
|
106
|
+
inFence = false;
|
|
107
|
+
blocks.push(cur);
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
|
|
111
|
+
cur = null;
|
|
112
|
+
inFence = false;
|
|
113
|
+
continue;
|
|
114
|
+
}
|
|
115
|
+
if (cur && /^```/.test(line)) {
|
|
116
|
+
inFence = !inFence;
|
|
117
|
+
continue;
|
|
118
|
+
}
|
|
119
|
+
if (cur && inFence)
|
|
120
|
+
cur.body.push(line);
|
|
121
|
+
}
|
|
122
|
+
return blocks;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Drop shell comments from a block body before matching bound markers, so a bound named
|
|
126
|
+
* only in the block's mandated `# Customise:` comment never makes an unbounded block look
|
|
127
|
+
* bounded. A full-line comment is always a comment; a `#` at the start of a word outside
|
|
128
|
+
* quotes begins one too (the shell rule), including straight after a control operator
|
|
129
|
+
* (`;`, `|`, `&`, `(`, `)`). A `#` inside quotes (a `jq` regex, a banner) is data and
|
|
130
|
+
* stays, or `printf "===== # ====="` would read as a comment and truncate the line. Quote
|
|
131
|
+
* state persists across lines because a quoted `jq` program may span several. A heredoc
|
|
132
|
+
* body (`<<WORD`, `<<'WORD'`, `<<-WORD` up to the line holding only `WORD`) is data: it is
|
|
133
|
+
* kept whole and its quotes and `#` change nothing, so an apostrophe in it never leaves
|
|
134
|
+
* the lines after its terminator read as quoted. A `<<<` here-string opens no body.
|
|
135
|
+
*/
|
|
136
|
+
function stripShellComments(text) {
|
|
137
|
+
const out = [];
|
|
138
|
+
let quote = null;
|
|
139
|
+
let escaped = false;
|
|
140
|
+
// Terminators of the heredocs opened so far, in the order their bodies follow.
|
|
141
|
+
const heredocs = [];
|
|
142
|
+
for (const line of text.split("\n")) {
|
|
143
|
+
const open = heredocs[0];
|
|
144
|
+
if (open) {
|
|
145
|
+
out.push(line);
|
|
146
|
+
if ((open.tabs ? line.replace(/^\t+/, "") : line) === open.word)
|
|
147
|
+
heredocs.shift();
|
|
148
|
+
continue;
|
|
149
|
+
}
|
|
150
|
+
let end = line.length;
|
|
151
|
+
for (let i = 0; i < line.length; i++) {
|
|
152
|
+
const ch = line[i];
|
|
153
|
+
if (quote === "'") {
|
|
154
|
+
if (ch === "'")
|
|
155
|
+
quote = null;
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
158
|
+
if (quote === '"') {
|
|
159
|
+
if (escaped)
|
|
160
|
+
escaped = false;
|
|
161
|
+
else if (ch === "\\")
|
|
162
|
+
escaped = true;
|
|
163
|
+
else if (ch === '"')
|
|
164
|
+
quote = null;
|
|
165
|
+
continue;
|
|
166
|
+
}
|
|
167
|
+
if (ch === "\\") {
|
|
168
|
+
i++;
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
if (ch === "'" || ch === '"') {
|
|
172
|
+
quote = ch;
|
|
173
|
+
continue;
|
|
174
|
+
}
|
|
175
|
+
if (ch === "<" && line[i + 1] === "<") {
|
|
176
|
+
if (line[i + 2] === "<") {
|
|
177
|
+
i += 2; // `<<<` here-string
|
|
178
|
+
continue;
|
|
179
|
+
}
|
|
180
|
+
const heredoc = /^<<(-?)[ \t]*\\?(["']?)([A-Za-z_]\w*)\2/.exec(line.slice(i));
|
|
181
|
+
if (heredoc)
|
|
182
|
+
heredocs.push({ word: heredoc[3], tabs: heredoc[1] === "-" });
|
|
183
|
+
i += heredoc ? heredoc[0].length - 1 : 1;
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
if (ch === "#" && (i === 0 || /[\s;|&()]/.test(line[i - 1]))) {
|
|
187
|
+
end = i;
|
|
188
|
+
break;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
out.push(line.slice(0, end));
|
|
192
|
+
}
|
|
193
|
+
return out.join("\n");
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Markers proving a `context-fetch` block bounds its own stdout at the source, matched
|
|
197
|
+
* against the block body with its shell comments removed. One entry maps to a real bound in
|
|
198
|
+
* a shipped block: a row / line cap (`--limit`, an API or SQL `limit`, `per_page`, `head` /
|
|
199
|
+
* `tail` / `--tail`, `--stat-count`, any `--max-*` such as `--max-rows` / `--max-pages` /
|
|
200
|
+
* `--max-items` / `--max-results`, `max_results`, `grep -m` / `rg -m` / `--max-count`,
|
|
201
|
+
* `--page-size` / `--per-page` / `--first`, a jq / Python slice `[0:N]`, a `sed -n 'A,Bp'`
|
|
202
|
+
* range, an `awk 'NR<=N'` guard, a `size` field), a page / count cap (`*_MAX_*`,
|
|
203
|
+
* `*_MAX_PAGES`, a `*_N` knob, a shell loop `-lt` guard), or a window / severity filter
|
|
204
|
+
* (`--since` / `--until` / `--freshness` / `SINCE` / `UNTIL` / `statsPeriod` / a lowercase
|
|
205
|
+
* `since=` / `until=`, a `severity` / `level` filter). A timeout, retry, redirect or
|
|
206
|
+
* connection setting (`--max-time`, `curl -m`, `--max-redirs`), a tool's own verbosity
|
|
207
|
+
* (`--log-level=`) and a hyphenated `*-size=` flag (`--buffer-size=`) cap nothing the block
|
|
208
|
+
* prints and never count. The tavily block counts as bounded on its `max_results:5` and
|
|
209
|
+
* `head -c` alone. A body is unbounded only when it matches none.
|
|
210
|
+
*/
|
|
211
|
+
const CONTEXT_FETCH_BOUND_RES = [
|
|
212
|
+
// Row / line caps.
|
|
213
|
+
/--limit\b/,
|
|
214
|
+
/\blimit\b["']?[ \t]*[=:]?[ \t]*["'$]?\d/i,
|
|
215
|
+
/(^|[\s|;(])head[ \t]+-/,
|
|
216
|
+
/(^|[\s|;(])tail[ \t]+-/,
|
|
217
|
+
/--tail[= ]/,
|
|
218
|
+
/--stat-count/,
|
|
219
|
+
// --max-pages / --max-items / --max-results / --max-rows / --max-count; not --max-time.
|
|
220
|
+
/--max-(?!(?:time|redirs|retries|wait|duration|age|connections)(?![\w-]))[\w-]+/,
|
|
221
|
+
/max_results/,
|
|
222
|
+
/\bper_page\b["']?[ \t]*[=:][ \t]*["'$]?\d/i,
|
|
223
|
+
/--page-size\b/,
|
|
224
|
+
/--per-page\b/,
|
|
225
|
+
/--first\b/,
|
|
226
|
+
/\b(?:[ef]?grep|rg)\b[^\n|;&]*[ \t]-m[ \t]*["'$]?\d/, // grep -m 20, not curl -m 30
|
|
227
|
+
/--max-count\b/,
|
|
228
|
+
/[\[(][ \t]*\d*[ \t]*:[ \t]*\d+/, // jq / Python slice: .[0:10], [:10], [0:10]
|
|
229
|
+
/\bsed\b[^\n]*[ \t]-n[ \t]*['"]?[0-9]+[ \t]*,[ \t]*[0-9]+p/, // sed -n '1,200p'
|
|
230
|
+
/\bNR[ \t]*<=?[ \t]*[0-9$]/, // awk 'NR<=500'
|
|
231
|
+
/(?<!\w)(?<!\w-)size["']?[ \t]*[=:][ \t]*["']?\d/i, // request / option body field, not --buffer-size=
|
|
232
|
+
// Page / count caps.
|
|
233
|
+
/_MAX_/,
|
|
234
|
+
/[A-Z][A-Z0-9]*_N\b/,
|
|
235
|
+
/(^|[\s|;(])-l[et][ \t]+["'$]?\d/, // shell loop guard: [ "$N" -lt 20 ]
|
|
236
|
+
// Window / severity filters.
|
|
237
|
+
/--since\b/,
|
|
238
|
+
/--until\b/,
|
|
239
|
+
/--freshness\b/,
|
|
240
|
+
/\bsince[ \t]*[=:]/i, // since=1h, since: 2h
|
|
241
|
+
/\buntil[ \t]*[=:]/i,
|
|
242
|
+
/SINCE/,
|
|
243
|
+
/UNTIL/,
|
|
244
|
+
/statsPeriod/,
|
|
245
|
+
/--severity\b/,
|
|
246
|
+
/\bseverity[ \t]*([=:]|[<>]=?)/i,
|
|
247
|
+
/--level\b/,
|
|
248
|
+
/(?<!\w)(?<!log-)level[ \t]*([=:]|[<>]=?)/i, // not --log-level=
|
|
249
|
+
];
|
|
250
|
+
/** True when a `context-fetch` block body carries at least one output bound (see the list). */
|
|
251
|
+
export function blockBoundsOutput(body) {
|
|
252
|
+
const text = stripShellComments(body.join("\n"));
|
|
253
|
+
return CONTEXT_FETCH_BOUND_RES.some((re) => re.test(text));
|
|
254
|
+
}
|
|
85
255
|
/**
|
|
86
256
|
* Map of context-fetch source name -> predicate proving THIS repo actually runs
|
|
87
257
|
* that backend. Evidence-gates `context-fetch-source-not-enabled`
|
|
@@ -329,38 +499,8 @@ export function detectContextFetchProvisionMissing(cwd) {
|
|
|
329
499
|
const consumer = content.slice(endIdx);
|
|
330
500
|
if (contextFetchDismissesAll(consumer))
|
|
331
501
|
return null;
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
let inFence = false;
|
|
335
|
-
for (const line of consumer.split("\n")) {
|
|
336
|
-
const startM = parseContextFetchStart(line);
|
|
337
|
-
const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
|
|
338
|
-
if (startM) {
|
|
339
|
-
// Unnamed blocks cannot be matched to a provision sibling (which is keyed
|
|
340
|
-
// by name), so they are parked under "" and filtered out downstream.
|
|
341
|
-
cur = { kind: "start", name: startM.name, body: [] };
|
|
342
|
-
inFence = false;
|
|
343
|
-
blocks.push(cur);
|
|
344
|
-
continue;
|
|
345
|
-
}
|
|
346
|
-
if (provM) {
|
|
347
|
-
cur = { kind: "provision", name: provM[1], body: [] };
|
|
348
|
-
inFence = false;
|
|
349
|
-
blocks.push(cur);
|
|
350
|
-
continue;
|
|
351
|
-
}
|
|
352
|
-
if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
|
|
353
|
-
cur = null;
|
|
354
|
-
inFence = false;
|
|
355
|
-
continue;
|
|
356
|
-
}
|
|
357
|
-
if (cur && /^```/.test(line)) {
|
|
358
|
-
inFence = !inFence;
|
|
359
|
-
continue;
|
|
360
|
-
}
|
|
361
|
-
if (cur && inFence)
|
|
362
|
-
cur.body.push(line);
|
|
363
|
-
}
|
|
502
|
+
// Parse the consumer section into named start / provision blocks with fenced bodies.
|
|
503
|
+
const blocks = parseContextFetchBlocks(consumer);
|
|
364
504
|
const provisionNames = new Set(blocks.filter((b) => b.kind === "provision").map((b) => b.name));
|
|
365
505
|
const provisionBody = blocks
|
|
366
506
|
.filter((b) => b.kind === "provision")
|
|
@@ -404,3 +544,48 @@ export function detectContextFetchProvisionMissing(cwd) {
|
|
|
404
544
|
action: `For each flagged block, add a sibling \`<!-- context-fetch:provision <name> -->\` block below \`<!-- bkit:end -->\` — SAME name as the fetch block — whose bash body installs the CLI, self-guarded and install-only: \`command -v ${firstCli} >/dev/null 2>&1 || <install ${firstCli}>\` (e.g. \`pnpm add -g ${firstCli}\` for an npm-published CLI). If \`.bkit/templates/context/\` ships a ready-made \`context-fetch:provision ${firstName}\` recipe, copy that. Then re-run \`bkit install\` so the recipe bakes into \`.claude/bkit-cloud.md\`'s setup script; \`.claude/hooks/bkit-cloud-bootstrap.sh\` runs the same recipe on gh-runner / resumed sessions. A block that fetches via an MCP tool or only universal tools (curl/jq/date) needs no provision.`,
|
|
405
545
|
};
|
|
406
546
|
}
|
|
547
|
+
/**
|
|
548
|
+
* Advisory: the consumer section enables a `context-fetch` block whose bash body bounds no
|
|
549
|
+
* output — no row / line cap, page cap or window filter. `/bkit-debug` runs every enabled
|
|
550
|
+
* block and writes its stdout straight into that context's artifact, so an unbounded block
|
|
551
|
+
* downloads a whole-run dump; only the post-hoc 3000-line / 400 KB clamp catches it, and
|
|
552
|
+
* the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.
|
|
553
|
+
*
|
|
554
|
+
* Distinct from `context-fetch-missing` (which owns the no-blocks case): this only runs
|
|
555
|
+
* once at least one block exists. The blanket opt-out (`<!-- context-fetch:none intentional -->`)
|
|
556
|
+
* dismisses it; a context-scoped marker (`context-fetch:none e2e`) does not, because the
|
|
557
|
+
* runner still runs a block that is present.
|
|
558
|
+
*/
|
|
559
|
+
export function detectContextFetchUnbounded(cwd) {
|
|
560
|
+
const filePath = path.join(cwd, ".agents", "context.md");
|
|
561
|
+
if (!fs.existsSync(filePath))
|
|
562
|
+
return null;
|
|
563
|
+
const content = fs.readFileSync(filePath, "utf-8");
|
|
564
|
+
const endIdx = content.search(/^<!-- bkit:end -->$/m);
|
|
565
|
+
if (endIdx === -1)
|
|
566
|
+
return null;
|
|
567
|
+
const consumer = content.slice(endIdx);
|
|
568
|
+
if (contextFetchDismissesAll(consumer))
|
|
569
|
+
return null;
|
|
570
|
+
// Only the blocks the runner actually runs can download anything: a block whose
|
|
571
|
+
// `context=` is unknown is narrated NOT RUN, and one with no fenced body is refused
|
|
572
|
+
// before it runs (`bkit context list-blocks` / `run-block`). Neither is bounded here.
|
|
573
|
+
const runnable = parseContextFetchBlocks(consumer).filter((b) => b.kind === "start" &&
|
|
574
|
+
CONTEXT_FETCH_CONTEXTS.includes(b.context) &&
|
|
575
|
+
b.body.some((l) => l.trim() !== ""));
|
|
576
|
+
// No runnable block => `context-fetch-missing` owns the empty case (no double-fire).
|
|
577
|
+
if (runnable.length === 0)
|
|
578
|
+
return null;
|
|
579
|
+
const unbounded = runnable.filter((b) => !blockBoundsOutput(b.body));
|
|
580
|
+
if (unbounded.length === 0)
|
|
581
|
+
return null;
|
|
582
|
+
const items = unbounded.map((b) => `${b.name || "(unnamed)"} (\`context=${b.context}\`)`);
|
|
583
|
+
const list = items.join(", ");
|
|
584
|
+
const plural = items.length > 1;
|
|
585
|
+
return {
|
|
586
|
+
id: "context-fetch-unbounded",
|
|
587
|
+
severity: "advisory",
|
|
588
|
+
detect: `\`.agents/context.md\` enables context-fetch block${plural ? "s" : ""} below \`<!-- bkit:end -->\` that bound no output: ${list}. \`/bkit-debug\` runs every enabled block and writes its stdout straight into that context's artifact, so ${plural ? "these blocks" : "this block"} download${plural ? "" : "s"} a whole-run dump — only the post-hoc 3000-line / 400 KB clamp catches it, and the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.`,
|
|
589
|
+
action: `Bound each flagged block at the source: add a row / line cap (\`--limit N\`, \`head -n N\`, \`tail -n N\` / \`--tail N\`, \`--stat-count N\`, \`grep -m N\` / \`--max-count N\`, a \`--max-*\` row or page cap (\`--max-rows N\`, \`--max-pages N\`, \`--max-items N\`, \`--max-results N\`),\`--page-size N\` / \`--per-page N\` / \`--first N\`, a jq / SQL slice (\`.[0:N]\`, \`limit N\`), a \`sed -n 'A,Bp'\` / \`awk 'NR<=N'\` range, the API's \`max_results\` / \`per_page\` / \`limit\` param, or a request-body \`size\` field), a page cap (\`<NAME>_MAX_PAGES\`, a \`*_N\` count variable, or a shell loop guard \`[ "$N" -lt M ]\`), or a window / severity filter (\`--since\` / \`--until\` / \`--freshness\` / \`SINCE\` / \`UNTIL\`, \`statsPeriod\`, or a \`severity\` / \`level\` filter) in the block body — not only in its \`# Customise:\` comment. A timeout (\`--max-time\`, \`curl -m\`) or the tool's own \`--log-level\` caps nothing the block prints. Raise the cap only when the cause sits outside the kept window: \`/bkit-debug\` clamps the artifact post hoc at 3000 lines / 400 KB (head 500 + tail 1000 + every error-matching line), so an unbounded dump can drop the very failure lines a diagnosis needs.`,
|
|
590
|
+
};
|
|
591
|
+
}
|
|
@@ -41,7 +41,7 @@ export function detectMissingDotenv(cwd, tracker = "linear") {
|
|
|
41
41
|
id: "mcp-env-missing-dotenv",
|
|
42
42
|
severity: "advisory",
|
|
43
43
|
detect: `.bkit/.env.example exists but .bkit/.env does not. MCP servers and agent tooling will not have access to ${tokens}.`,
|
|
44
|
-
action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}). Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
|
|
44
|
+
action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}) — in a git worktree, copy the main checkout's .bkit/.env instead, or run \`bkit worktrees setup\` to link it. Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
|
|
45
45
|
};
|
|
46
46
|
}
|
|
47
47
|
/**
|
|
@@ -13,10 +13,10 @@
|
|
|
13
13
|
// parsePlanBlocks — from commands/workflow/plan-blocks.ts (a plan's group and task blocks)
|
|
14
14
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
15
15
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
16
|
-
import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, detectInvalidAskSettings, detectInvalidTaskCaps, detectTaskCapFormStale, detectUnmarkedPlans, } from "./repo.js";
|
|
16
|
+
import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, detectInvalidAskSettings, detectBuildPublish, detectInvalidTaskCaps, detectTaskCapFormStale, detectUnmarkedPlans, } from "./repo.js";
|
|
17
17
|
import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
|
|
18
18
|
import { detectBkitVersionMajorDowngrade, detectBkitVersionPinStale } from "./version.js";
|
|
19
|
-
import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, } from "./context-fetch.js";
|
|
19
|
+
import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, detectContextFetchUnbounded, } from "./context-fetch.js";
|
|
20
20
|
import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
|
|
21
21
|
// ---------------------------------------------------------------------------
|
|
22
22
|
// Internal helper
|
|
@@ -91,6 +91,7 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
|
|
|
91
91
|
const invalidTaskCaps = detectInvalidTaskCaps(cwd);
|
|
92
92
|
if (invalidTaskCaps)
|
|
93
93
|
advisories.push(invalidTaskCaps);
|
|
94
|
+
advisories.push(...detectBuildPublish(cwd));
|
|
94
95
|
const taskCapFormStale = detectTaskCapFormStale(cwd);
|
|
95
96
|
if (taskCapFormStale)
|
|
96
97
|
advisories.push(taskCapFormStale);
|
|
@@ -116,6 +117,9 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
|
|
|
116
117
|
const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
|
|
117
118
|
if (contextFetchProvision)
|
|
118
119
|
advisories.push(contextFetchProvision);
|
|
120
|
+
const contextFetchUnbounded = detectContextFetchUnbounded(cwd);
|
|
121
|
+
if (contextFetchUnbounded)
|
|
122
|
+
advisories.push(contextFetchUnbounded);
|
|
119
123
|
// bkit-not-on-path advisory — suggest the shell alias for local development.
|
|
120
124
|
const bkitNotOnPath = detectBkitNotOnPath();
|
|
121
125
|
if (bkitNotOnPath)
|
|
@@ -5,7 +5,7 @@ import * as path from "node:path";
|
|
|
5
5
|
import { spawnSync } from "node:child_process";
|
|
6
6
|
import { parsePlanBlocks } from "../../commands/workflow/plan-blocks.js";
|
|
7
7
|
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
8
|
-
import { ASK_POINTS, CONFIG_DEFAULTS, invalidAskSettings, invalidTaskCaps, limitKey, readBkitConfig, } from "../../shared/settings.js";
|
|
8
|
+
import { ASK_POINTS, CONFIG_DEFAULTS, invalidAskSettings, invalidBuildPublish, invalidTaskCaps, limitKey, readBkitConfig, } from "../../shared/settings.js";
|
|
9
9
|
import { isCloudOrCi } from "./env.js";
|
|
10
10
|
// ---------------------------------------------------------------------------
|
|
11
11
|
// Blocker detectors
|
|
@@ -68,6 +68,40 @@ export function detectInvalidTaskCaps(cwd) {
|
|
|
68
68
|
.join(", ")}.`,
|
|
69
69
|
};
|
|
70
70
|
}
|
|
71
|
+
/**
|
|
72
|
+
* Advisory: `package.json` `bkit.workflows.build.publish` holds a refused or invalid value.
|
|
73
|
+
* `remote: false` is refused (a cloud run always publishes); a non-object block or a
|
|
74
|
+
* non-boolean `local` falls back to its default. One finding per key.
|
|
75
|
+
*/
|
|
76
|
+
export function detectBuildPublish(cwd) {
|
|
77
|
+
const workflows = bkitWorkflows(cwd);
|
|
78
|
+
if (workflows === null)
|
|
79
|
+
return [];
|
|
80
|
+
const out = [];
|
|
81
|
+
const publish = workflows.build?.publish;
|
|
82
|
+
if (publish !== null &&
|
|
83
|
+
typeof publish === "object" &&
|
|
84
|
+
!Array.isArray(publish) &&
|
|
85
|
+
publish.remote !== undefined &&
|
|
86
|
+
publish.remote !== true) {
|
|
87
|
+
out.push({
|
|
88
|
+
id: "bkit-build-publish-remote",
|
|
89
|
+
severity: "advisory",
|
|
90
|
+
detect: "package.json `bkit.workflows.build.publish.remote` is not `true`, so a cloud or CI run still publishes.",
|
|
91
|
+
action: "Delete `bkit.workflows.build.publish.remote` or set it to `true`; hold a local build with `bkit.workflows.build.publish.local` set to `false`.",
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
const bad = invalidBuildPublish(workflows.build);
|
|
95
|
+
if (bad.length > 0) {
|
|
96
|
+
out.push({
|
|
97
|
+
id: "bkit-build-publish-invalid",
|
|
98
|
+
severity: "advisory",
|
|
99
|
+
detect: `package.json ${bad.map((k) => `\`bkit.workflows.${k}\``).join(", ")} is not ${bad[0] === "build.publish.local" ? "a boolean" : "an object"}, so the default (publish) is used instead.`,
|
|
100
|
+
action: "Set `bkit.workflows.build.publish.local` to `true` or `false`, or delete the block to keep the default (`true`).",
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
return out;
|
|
104
|
+
}
|
|
71
105
|
const TASK_CAP_KEY = /`bkit\.workflows\.tasks\.(\w+)`/g;
|
|
72
106
|
/**
|
|
73
107
|
* Each `bkit.workflows.tasks.<key>` the text names with a `(default N)` after it, on the same
|