@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
// install/context-ci-workflow.ts — the CI-run lookup in the consumer's `context=ci` and
|
|
2
|
+
// `context=e2e` blocks in `.agents/context.md`.
|
|
3
|
+
//
|
|
4
|
+
// A lookup without `--workflow` takes the newest run of any workflow on the branch. Other
|
|
5
|
+
// workflows (a security scan, a cloud agent) often finish after CI and pass, so the block reads
|
|
6
|
+
// their run and reports nothing failing. The consumer owns the copies below
|
|
7
|
+
// `<!-- bkit:end -->`, so upgrade rewrites a lookup only when it is byte-identical to the line
|
|
8
|
+
// an older bkit template carried. Register: docs/migrations.md.
|
|
9
|
+
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
|
|
13
|
+
import { readBkitConfig } from "../shared/settings.js";
|
|
14
|
+
import { findLineAnchoredMarkers, selectMarkers } from "./managed-block.js";
|
|
15
|
+
import type { WriteSet } from "./write.js";
|
|
16
|
+
|
|
17
|
+
const CONTEXT_FILE = path.join(".agents", "context.md");
|
|
18
|
+
const LOOKUP_TAIL = '=$(gh run list --branch "$(git branch --show-current)" --limit 1 \\';
|
|
19
|
+
/** The shipped lookup's first line: `RUN_JSON` in `bkit-github.md`, `RUN_ID` in the e2e blocks. */
|
|
20
|
+
const SHIPPED_LOOKUP = new RegExp(
|
|
21
|
+
`^(RUN_JSON|RUN_ID)${LOOKUP_TAIL.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`,
|
|
22
|
+
);
|
|
23
|
+
/** Any lookup of the current branch's runs, shipped or edited. */
|
|
24
|
+
const ANY_LOOKUP = /gh run list --branch "\$\(git branch --show-current\)"/;
|
|
25
|
+
const NAMES_WORKFLOW = /(?:^|\s)(?:--workflow|-w)(?:\s|=)/;
|
|
26
|
+
const PLAIN_FILE_NAME = /^[\w.-]+$/;
|
|
27
|
+
|
|
28
|
+
export interface CiLookupResult {
|
|
29
|
+
/** The file with every shipped lookup below `<!-- bkit:end -->` scoped to the CI workflow. */
|
|
30
|
+
content: string;
|
|
31
|
+
/** How many lookups were rewritten. */
|
|
32
|
+
rewritten: number;
|
|
33
|
+
/** Lookups below `<!-- bkit:end -->` that read every workflow's runs and were left as written. */
|
|
34
|
+
unscoped: string[];
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Rewrites each shipped CI-run lookup below the first line-anchored `<!-- bkit:end -->` so it
|
|
39
|
+
* reads only `workflow`'s runs: a `CI_WORKFLOW="${CI_WORKFLOW:-<workflow>}"` line goes above
|
|
40
|
+
* it, and the lookup gains `--workflow "$CI_WORKFLOW"`. A lookup that names a workflow on
|
|
41
|
+
* either line is already scoped and stays. An edited lookup, or any lookup when `workflow` is
|
|
42
|
+
* not a plain file name, stays and is listed in `unscoped`. A line ending in CR keeps it.
|
|
43
|
+
*/
|
|
44
|
+
export function scopeCiRunLookups(content: string, workflow: string): CiLookupResult {
|
|
45
|
+
const endAt = findLineAnchoredMarkers(content, selectMarkers("html-comment")[1])[0];
|
|
46
|
+
if (endAt === undefined) return { content, rewritten: 0, unscoped: [] };
|
|
47
|
+
const lines = content.slice(endAt).split("\n");
|
|
48
|
+
const plainName = PLAIN_FILE_NAME.test(workflow);
|
|
49
|
+
const out: string[] = [];
|
|
50
|
+
const unscoped: string[] = [];
|
|
51
|
+
let rewritten = 0;
|
|
52
|
+
lines.forEach((line, i) => {
|
|
53
|
+
const bare = line.replace(/\r$/, "");
|
|
54
|
+
const next = lines[i + 1] ?? "";
|
|
55
|
+
if (!ANY_LOOKUP.test(bare) || NAMES_WORKFLOW.test(bare) || NAMES_WORKFLOW.test(next)) {
|
|
56
|
+
out.push(line);
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
if (!plainName || !SHIPPED_LOOKUP.test(bare)) {
|
|
60
|
+
unscoped.push(bare);
|
|
61
|
+
out.push(line);
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
const cr = line.endsWith("\r") ? "\r" : "";
|
|
65
|
+
out.push(`CI_WORKFLOW="\${CI_WORKFLOW:-${workflow}}"${cr}`);
|
|
66
|
+
out.push(line.replace(" --limit 1 ", ' --workflow "$CI_WORKFLOW" --limit 1 '));
|
|
67
|
+
rewritten++;
|
|
68
|
+
});
|
|
69
|
+
if (rewritten === 0) return { content, rewritten, unscoped };
|
|
70
|
+
return { content: content.slice(0, endAt) + out.join("\n"), rewritten, unscoped };
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** Absolute paths already named in this process. */
|
|
74
|
+
const warned = new Set<string>();
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Migration (installs up to 6.0.x, `docs/migrations.md`): scopes each shipped CI-run lookup in
|
|
78
|
+
* `.agents/context.md` to the workflow file `bkit.testing.ciWorkflow` names. Recorded in ws as
|
|
79
|
+
* an update; the canonical hash covers the managed block only. A lookup it leaves unscoped is
|
|
80
|
+
* named once per process, so the consumer can add `--workflow` by hand.
|
|
81
|
+
*/
|
|
82
|
+
export function migrateContextCiWorkflow(dryRun: boolean, ws: WriteSet, logPrefix: string): void {
|
|
83
|
+
if (!fs.lstatSync(CONTEXT_FILE, { throwIfNoEntry: false })?.isFile()) return;
|
|
84
|
+
const workflow = readBkitConfig(process.cwd()).ciWorkflow;
|
|
85
|
+
const result = scopeCiRunLookups(fs.readFileSync(CONTEXT_FILE, "utf-8"), workflow);
|
|
86
|
+
// Upgrade runs this pass again as its closing dry-run check, so each file is named once.
|
|
87
|
+
const abs = path.resolve(CONTEXT_FILE);
|
|
88
|
+
if (result.unscoped.length > 0 && !warned.has(abs)) {
|
|
89
|
+
warned.add(abs);
|
|
90
|
+
console.warn(
|
|
91
|
+
`${logPrefix} ${CONTEXT_FILE}: ${result.unscoped.length} CI run lookup(s) read the newest run of every workflow on the branch, so a later passing workflow hides a failed ${workflow} run. Add \`--workflow "${workflow}"\` to each \`gh run list --branch\` line by hand (the shipped form in .bkit/templates/context/bkit-github.md shows how).`,
|
|
92
|
+
);
|
|
93
|
+
}
|
|
94
|
+
if (result.rewritten === 0) return;
|
|
95
|
+
if (!dryRun) fs.writeFileSync(CONTEXT_FILE, result.content, "utf-8");
|
|
96
|
+
if (!ws.writes.some((w) => path.normalize(w.path) === CONTEXT_FILE)) {
|
|
97
|
+
ws.writes.push({ path: CONTEXT_FILE, action: "update" });
|
|
98
|
+
}
|
|
99
|
+
console.log(
|
|
100
|
+
`${logPrefix} ${dryRun ? "[dry-run] " : ""}core: ${CONTEXT_FILE} — CI run lookups now read only ${workflow} runs (${result.rewritten})`,
|
|
101
|
+
);
|
|
102
|
+
}
|
|
@@ -65,7 +65,7 @@ export type ModuleName =
|
|
|
65
65
|
export const ISSUE_TRACKERS = ["github", "linear", "jira", "none"] as const;
|
|
66
66
|
export type IssueTracker = (typeof ISSUE_TRACKERS)[number];
|
|
67
67
|
|
|
68
|
-
/** Default tracker when consumer manifest has no `bkit.
|
|
68
|
+
/** Default tracker when consumer manifest has no `bkit.tracker.default` field. */
|
|
69
69
|
export const DEFAULT_ISSUE_TRACKER: IssueTracker = "none";
|
|
70
70
|
|
|
71
71
|
/**
|
|
@@ -94,17 +94,17 @@ export function parseIssueTracker(value: unknown): IssueTracker | null {
|
|
|
94
94
|
* presence). Requires `tracker=github` + local opencode host (`bkit install --opencode=<provider>`).
|
|
95
95
|
* - `none` — explicit opt-out; silences the post-install nudge advisory.
|
|
96
96
|
*
|
|
97
|
-
* Recorded in `package.json` `bkit.
|
|
97
|
+
* Recorded in `package.json` `bkit.cloud.agent`. Presence of the adopted copy
|
|
98
98
|
* (`bkit-cloud.yml` for github-host variants; `.cursor/Dockerfile` for cursor) is the authoritative
|
|
99
99
|
* "active" signal; the package.json field only distinguishes an opt-out from
|
|
100
100
|
* an undecided install.
|
|
101
101
|
*
|
|
102
|
-
* Single self-describing field (mirrors `bkit.
|
|
102
|
+
* Single self-describing field (mirrors `bkit.tracker.default`).
|
|
103
103
|
*/
|
|
104
104
|
export const CLOUD_MODES = ["claude", "cursor", "opencode", "none"] as const;
|
|
105
105
|
export type CloudAgents = (typeof CLOUD_MODES)[number];
|
|
106
106
|
|
|
107
|
-
/** Default when consumer manifest has no `bkit.
|
|
107
|
+
/** Default when consumer manifest has no `bkit.cloud.agent` field (undecided). */
|
|
108
108
|
export const DEFAULT_CLOUD_AGENTS: CloudAgents = "none";
|
|
109
109
|
|
|
110
110
|
/** Narrow an unknown string to `CloudAgents` or return `null` if invalid. */
|
|
@@ -137,18 +137,20 @@ const CORE_MANIFEST: ManifestEntry[] = [
|
|
|
137
137
|
// `.bkit/core/.bkit/` and are read from there at runtime (getBkitDocsRoot); these
|
|
138
138
|
// consumer copies are force-overwritten mirrors (writeTier1) so a consumer can read
|
|
139
139
|
// them in-repo. Whole file is bkit-owned → byte-equal-text (refreshed every install);
|
|
140
|
-
// prompts.md
|
|
140
|
+
// prompts.md is markered-text, keeping the consumer section below `bkit:end`.
|
|
141
|
+
{ path: ".bkit/authoring.md", format: "byte-equal-text", module: "core" },
|
|
141
142
|
{ path: ".bkit/cloud.md", format: "byte-equal-text", module: "core" },
|
|
143
|
+
{ path: ".bkit/cli.md", format: "byte-equal-text", module: "core" },
|
|
142
144
|
{ path: ".bkit/comparison.md", format: "byte-equal-text", module: "core" },
|
|
143
145
|
{ path: ".bkit/install.md", format: "byte-equal-text", module: "core" },
|
|
144
146
|
{ path: ".bkit/jsonl.md", format: "byte-equal-text", module: "core" },
|
|
145
147
|
// The MIT notice that travels with the files bkit writes: the full text and copyright
|
|
146
148
|
// notice. Sourced from `.bkit/core/.bkit/LICENSE.md`.
|
|
147
149
|
{ path: ".bkit/LICENSE.md", format: "byte-equal-text", module: "core" },
|
|
148
|
-
{ path: ".bkit/lite.md", format: "markered-text", module: "core" },
|
|
149
150
|
{ path: ".bkit/pipeline.md", format: "byte-equal-text", module: "core" },
|
|
150
151
|
{ path: ".bkit/providers.md", format: "byte-equal-text", module: "core" },
|
|
151
152
|
{ path: ".bkit/prompts.md", format: "markered-text", module: "core" },
|
|
153
|
+
{ path: ".bkit/router.md", format: "byte-equal-text", module: "core" },
|
|
152
154
|
{ path: ".bkit/templates.md", format: "byte-equal-text", module: "core" },
|
|
153
155
|
{ path: ".bkit/trackers.md", format: "byte-equal-text", module: "core" },
|
|
154
156
|
{ path: ".bkit/workflows.md", format: "byte-equal-text", module: "core" },
|
|
@@ -208,7 +210,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
|
|
|
208
210
|
// (bkit-tests-static / -unit / -integration / -e2e / -live). Where a step is not a
|
|
209
211
|
// tier (`format`, the ship gate) the name spells out the actual steps. One exception:
|
|
210
212
|
// `min` sits off the chain: the least a push runs, on a push that changes no code
|
|
211
|
-
// (`bkit.minPushPaths`); its steps are whatever that push can still break.
|
|
213
|
+
// (what bkit writes, plus `bkit.testing.minPushPaths`); its steps are whatever that push can still break.
|
|
212
214
|
//
|
|
213
215
|
// The consumer owns every value: a turbo monorepo writes `turbo run … --filter`,
|
|
214
216
|
// a Python repo writes `ruff check && pytest`. bkit never reads a value — only
|
|
@@ -217,7 +219,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
|
|
|
217
219
|
// Seeded by core on every install and upgrade (seedCorePackageJsonScripts,
|
|
218
220
|
// install/modules/index.ts): add-if-missing, so a name already present is never touched,
|
|
219
221
|
// and uninstall leaves every name in place. The tool scripts the defaults chain
|
|
220
|
-
// (typecheck, lint, format:check, lint:prose, slop:delta, lint-staged) are the
|
|
222
|
+
// (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta, lint-staged) are the
|
|
221
223
|
// consumer's to add — `.bkit/templates.md` lists them; the
|
|
222
224
|
// `gate-missing-called-scripts` advisory names any that are missing.
|
|
223
225
|
//
|
|
@@ -226,7 +228,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
|
|
|
226
228
|
// directly, one step each.
|
|
227
229
|
//
|
|
228
230
|
// `lint:slop` is in no gate: `slop-scan scan` is report-only and never fails. The gate
|
|
229
|
-
// that fails on new findings is `slop:delta`.
|
|
231
|
+
// that fails on new findings is `bkit:slop:delta`.
|
|
230
232
|
//
|
|
231
233
|
// NOT SEEDED: the three deeper gates (…-integration, …-integration-e2e,
|
|
232
234
|
// …-integration-e2e-live) are absent unless the consumer writes them. Each is one line
|
|
@@ -238,17 +240,17 @@ export const BKIT_GATE_SCRIPTS: Readonly<Record<string, string>> = {
|
|
|
238
240
|
// `.husky/pre-commit`: prettier --write over staged files, and nothing else —
|
|
239
241
|
// seconds, not minutes. Prose is a whole-repo scan, so it gates at pre-push.
|
|
240
242
|
"bkit:gate:format": "pnpm lint-staged",
|
|
241
|
-
// `.husky/pre-push` on a min push (every file
|
|
243
|
+
// `.husky/pre-push` on a min push (every file is one bkit writes or `bkit.testing.minPushPaths` adds): no code, so
|
|
242
244
|
// no typecheck, lint or tests. Off the chain. Add any test that reads a min-push file.
|
|
243
|
-
"bkit:gate:min": "pnpm format:check && pnpm lint:prose && pnpm slop:delta",
|
|
245
|
+
"bkit:gate:min": "pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
|
|
244
246
|
// Everything that needs no test runner. Every part has a matching step in the
|
|
245
247
|
// bkit-tests-static CI job; audits/templates/template-ci-yml.test.ts fails when one is missing.
|
|
246
248
|
// Callers: build's plan-execute loop between tasks, and the `.husky/pre-push` revert
|
|
247
249
|
// path.
|
|
248
250
|
"bkit:gate:static":
|
|
249
|
-
"pnpm typecheck && pnpm lint && pnpm format:check && pnpm lint:prose && pnpm slop:delta",
|
|
251
|
+
"pnpm typecheck && pnpm lint && pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
|
|
250
252
|
// The default local gate: `.husky/pre-push` (when no `…-integration` gate is declared),
|
|
251
|
-
// build
|
|
253
|
+
// build Steps 8 and 12, the remediates. `pnpm test` is the unit tier only: a test file the
|
|
252
254
|
// integration gate also runs must not match it.
|
|
253
255
|
"bkit:gate:static-unit": "pnpm bkit:gate:static && pnpm test",
|
|
254
256
|
// Ship's conflict-resolve, the only caller whose dependency graph may have just
|
|
@@ -277,22 +279,30 @@ export const BKIT_GATE_SCRIPTS: Readonly<Record<string, string>> = {
|
|
|
277
279
|
export const BKIT_DEBUG_GATES: readonly string[] = [
|
|
278
280
|
"bkit:gate:static-unit-integration-e2e-live",
|
|
279
281
|
"bkit:gate:static-unit-integration-e2e",
|
|
282
|
+
"bkit:gate:static-unit-integration",
|
|
280
283
|
"bkit:gate:static-unit",
|
|
281
284
|
];
|
|
282
285
|
|
|
283
286
|
/**
|
|
284
|
-
* What `/bkit-build` Step
|
|
287
|
+
* What `/bkit-build` Step 12 will run, in DESCENDING order — first one declared wins.
|
|
288
|
+
* The Step 8 group gate runs `BKIT_GROUP_GATES` instead.
|
|
285
289
|
*
|
|
286
290
|
* Build stops at integration; E2E and live are not in this list.
|
|
287
291
|
*
|
|
288
|
-
*
|
|
289
|
-
*
|
|
292
|
+
* Declaring `bkit:gate:static-unit-integration` (never seeded) opts Step 12 and the
|
|
293
|
+
* pre-push hook into the integration tier.
|
|
290
294
|
*/
|
|
291
295
|
export const BKIT_BUILD_GATES: readonly string[] = [
|
|
292
296
|
"bkit:gate:static-unit-integration",
|
|
293
297
|
"bkit:gate:static-unit",
|
|
294
298
|
];
|
|
295
299
|
|
|
300
|
+
/**
|
|
301
|
+
* What `/bkit-build` Step 8 runs after every group but the last, and hands the Step 9 fix
|
|
302
|
+
* round: static checks and the unit tier. Integration runs once, at Step 12.
|
|
303
|
+
*/
|
|
304
|
+
export const BKIT_GROUP_GATES: readonly string[] = ["bkit:gate:static-unit"];
|
|
305
|
+
|
|
296
306
|
/**
|
|
297
307
|
* What `.husky/pre-push` runs on a full push, in DESCENDING order — first one declared wins.
|
|
298
308
|
*
|
|
@@ -312,6 +322,23 @@ export const BKIT_PUSH_GATES: readonly string[] = [
|
|
|
312
322
|
*/
|
|
313
323
|
export const BKIT_TEST_FILE_SCRIPT = "bkit:test:file";
|
|
314
324
|
|
|
325
|
+
/**
|
|
326
|
+
* Lints ONE test file — `pnpm bkit:lint:file <repo-relative path>`, exit 0 when clean.
|
|
327
|
+
* `bkit tests red` runs it before recording a red, so a lint rewrite never lands after
|
|
328
|
+
* the red. Never seeded: install, check and upgrade advise when `bkit:test:file` is
|
|
329
|
+
* declared and this is not (detectGateAdvisories).
|
|
330
|
+
*/
|
|
331
|
+
export const BKIT_LINT_FILE_SCRIPT = "bkit:lint:file";
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* Checks only what changed — `pnpm bkit:gate:changed <repo-relative path>...`, exit 0
|
|
335
|
+
* when clean: the tests that import the files, the tests that name their paths, and
|
|
336
|
+
* static checks on the files. `bkit tests changed` passes the files and falls back to a
|
|
337
|
+
* whole gate when this is undeclared. Never seeded: install, check and upgrade advise
|
|
338
|
+
* when it is missing (detectGateAdvisories).
|
|
339
|
+
*/
|
|
340
|
+
export const BKIT_GATE_CHANGED_SCRIPT = "bkit:gate:changed";
|
|
341
|
+
|
|
315
342
|
/**
|
|
316
343
|
* The deeper gates, shallowest first, with what declaring each one costs.
|
|
317
344
|
*
|
|
@@ -410,6 +437,13 @@ export const OPENCODE_MANIFEST: ManifestEntry[] = [
|
|
|
410
437
|
format: "markered-text",
|
|
411
438
|
module: "opencode",
|
|
412
439
|
},
|
|
440
|
+
// bkit-rules.js — same split as bkit-gateguard.js. Delivers the rules-read advisory
|
|
441
|
+
// on the session's first tool call (opencode has no session-start event).
|
|
442
|
+
{
|
|
443
|
+
path: ".opencode/plugin/bkit-rules.js",
|
|
444
|
+
format: "markered-text",
|
|
445
|
+
module: "opencode",
|
|
446
|
+
},
|
|
413
447
|
// Agent and command mirrors are managed dynamically (not listed individually here —
|
|
414
448
|
// the exact set depends on the bkit-prefix prompt/workflow files at install time).
|
|
415
449
|
// Uninstall uses the BKIT_PREFIX filter for .opencode/agents/ and .opencode/commands/.
|
|
@@ -447,6 +481,14 @@ export const CODEX_MANIFEST: ManifestEntry[] = [
|
|
|
447
481
|
format: "markered-text",
|
|
448
482
|
module: "codex",
|
|
449
483
|
},
|
|
484
|
+
// bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
|
|
485
|
+
// session as `additionalContext` on the first tool call (Codex has no session-start
|
|
486
|
+
// event). Registered on two single-value matchers, `apply_patch` and `Bash`.
|
|
487
|
+
{
|
|
488
|
+
path: ".codex/hooks/bkit-rules.cjs",
|
|
489
|
+
format: "markered-text",
|
|
490
|
+
module: "codex",
|
|
491
|
+
},
|
|
450
492
|
// Agent mirrors (.codex/agents/*.toml) and workflow skills (.agents/skills/bkit-*/) are
|
|
451
493
|
// managed dynamically — the set follows the bkit-prefix prompt/workflow files at install.
|
|
452
494
|
];
|
|
@@ -484,6 +526,14 @@ export const ANTIGRAVITY_MANIFEST: ManifestEntry[] = [
|
|
|
484
526
|
format: "markered-text",
|
|
485
527
|
module: "antigravity",
|
|
486
528
|
},
|
|
529
|
+
// bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
|
|
530
|
+
// session by denying the first tool call with the advisory as the reason (Antigravity's
|
|
531
|
+
// only channel to the model); the identical retry is allowed.
|
|
532
|
+
{
|
|
533
|
+
path: ".agents/plugins/bkit/hooks/bkit-rules.cjs",
|
|
534
|
+
format: "markered-text",
|
|
535
|
+
module: "antigravity",
|
|
536
|
+
},
|
|
487
537
|
// Root GEMINI.md — Antigravity workspace-rule redirect to .agents/rules.md, owned by the
|
|
488
538
|
// antigravity module: `uninstall --antigravity` removes it; other installs leave it.
|
|
489
539
|
{ path: "GEMINI.md", format: "markered-text", module: "antigravity" },
|
|
@@ -497,7 +547,7 @@ export const ANTIGRAVITY_MANIFEST: ManifestEntry[] = [
|
|
|
497
547
|
// (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent files
|
|
498
548
|
// (.cursor/Dockerfile, .cursor/environment.json) ship as templates
|
|
499
549
|
// (`.bkit/templates.md`); the consumer copies and owns them. Each variant only
|
|
500
|
-
// records `bkit.
|
|
550
|
+
// records `bkit.cloud.agent` and prints its setup advisories.
|
|
501
551
|
export const CLOUD_MANIFEST_CLAUDE: ManifestEntry[] = [];
|
|
502
552
|
|
|
503
553
|
export const CLOUD_MANIFEST_OPENCODE: ManifestEntry[] = [];
|
|
@@ -198,8 +198,9 @@ export function runAntigravityModule(ctx: ModuleContext): void {
|
|
|
198
198
|
}
|
|
199
199
|
}
|
|
200
200
|
|
|
201
|
-
// --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text,
|
|
202
|
-
|
|
201
|
+
// --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
|
|
202
|
+
// twins of the Claude/Codex hooks ---
|
|
203
|
+
for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
|
|
203
204
|
const hookSrc = path.join(pluginHooksSrc, hook);
|
|
204
205
|
const hookDst = path.join(ANTIGRAVITY_HOOKS_DIR, hook);
|
|
205
206
|
if (fs.existsSync(hookSrc)) {
|
|
@@ -15,11 +15,12 @@ import type { ModuleContext } from "./index.js";
|
|
|
15
15
|
|
|
16
16
|
/**
|
|
17
17
|
* Persist a `bkit.<field>` value into the consumer's package.json so the
|
|
18
|
-
* post-install advisory can tell "deliberately none" from "undecided".
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
18
|
+
* post-install advisory can tell "deliberately none" from "undecided". `field` is a
|
|
19
|
+
* dotted path (`cloud.agent`); each missing section on the way is created. Mirrors
|
|
20
|
+
* the `bkit.tracker.default` persist logic in commands/install/install.ts. Used for the opt-in
|
|
21
|
+
* decisions recorded by their owning modules (`cloud.agent`). No-op
|
|
22
|
+
* on dry-run, when package.json is absent/unparseable, or when a section on the path
|
|
23
|
+
* holds a non-object (non-fatal — the config file presence is still the primary signal).
|
|
23
24
|
*/
|
|
24
25
|
function setConsumerBkitField(field: string, value: string, dryRun: boolean): void {
|
|
25
26
|
if (dryRun) return;
|
|
@@ -30,10 +31,17 @@ function setConsumerBkitField(field: string, value: string, dryRun: boolean): vo
|
|
|
30
31
|
const parsed = parseJson(raw);
|
|
31
32
|
if (!parsed.ok) return;
|
|
32
33
|
const pkg = parsed.value as Record<string, unknown>;
|
|
33
|
-
const
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
const keys = ["bkit", ...field.split(".")];
|
|
35
|
+
const leaf = keys.pop()!;
|
|
36
|
+
let parent = pkg;
|
|
37
|
+
for (const k of keys) {
|
|
38
|
+
parent[k] ??= {};
|
|
39
|
+
const next = parent[k];
|
|
40
|
+
if (next === null || typeof next !== "object" || Array.isArray(next)) return;
|
|
41
|
+
parent = next as Record<string, unknown>;
|
|
42
|
+
}
|
|
43
|
+
if (parent[leaf] === value) return; // already set — avoid a no-op rewrite
|
|
44
|
+
parent[leaf] = value;
|
|
37
45
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
38
46
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
39
47
|
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
@@ -46,7 +54,7 @@ function setConsumerBkitField(field: string, value: string, dryRun: boolean): vo
|
|
|
46
54
|
// The cloud workflow is a template (`.bkit/templates.md`). Shared first step of the
|
|
47
55
|
// claude and opencode setup advisories.
|
|
48
56
|
const CLOUD_WORKFLOW_ADOPT_STEP =
|
|
49
|
-
" - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
|
|
57
|
+
" - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file after you copy it. The one exception is a brand migration: `bkit upgrade` rewrites exact shipped old names in it and leaves any edited line. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
|
|
50
58
|
|
|
51
59
|
// ---------------------------------------------------------------------------
|
|
52
60
|
// runCloudModule — opt-in cloud-agent integration
|
|
@@ -54,7 +62,7 @@ const CLOUD_WORKFLOW_ADOPT_STEP =
|
|
|
54
62
|
//
|
|
55
63
|
// NOT shipped by a default install — opt-in via `bkit install --auto=<variant>`,
|
|
56
64
|
// so a default install ships ZERO cloud footprint. Every variant records
|
|
57
|
-
// `bkit.
|
|
65
|
+
// `bkit.cloud.agent` and prints its setup advisories; none writes a file. The cloud
|
|
58
66
|
// workflow (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent
|
|
59
67
|
// files (.cursor/Dockerfile, .cursor/environment.json) are templates the advisories
|
|
60
68
|
// point at.
|
|
@@ -72,7 +80,7 @@ export function runCloudModule(ctx: ModuleContext): void {
|
|
|
72
80
|
// --- cloud=claude: GitHub-tracker path ---
|
|
73
81
|
|
|
74
82
|
// Record the variant so the post-install advisory and `bkit check` stay consistent.
|
|
75
|
-
setConsumerBkitField("
|
|
83
|
+
setConsumerBkitField("cloud.agent", "claude", dryRun);
|
|
76
84
|
|
|
77
85
|
// Advisory — cloud=claude setup checklist (App required; id-token: write).
|
|
78
86
|
advisories.push({
|
|
@@ -102,7 +110,7 @@ export function runCloudModule(ctx: ModuleContext): void {
|
|
|
102
110
|
"Cloud env config splits across the repo (`.claude/hooks/bkit-cloud-bootstrap.sh`, a copy-and-own template you adopt) and the Claude app dashboard (setup script + env vars + auth tokens, manual).",
|
|
103
111
|
action:
|
|
104
112
|
"Two locations to touch — full recipe in bkit's `cloud.md`.\n\n" +
|
|
105
|
-
"IN REPO (copy-and-own; bkit never writes it):\n" +
|
|
113
|
+
"IN REPO (copy-and-own; bkit never writes it, apart from brand migrations that rewrite exact shipped old names):\n" +
|
|
106
114
|
" - Adopt `.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh` as `.claude/hooks/bkit-cloud-bootstrap.sh` and edit it freely — the baseline runs `pnpm install` / `vale sync` and the gh login on each cloud session; add your own repo-specific steps (Supabase start, turbo prebuild, etc. — examples inlined). The `.claude/settings.json` SessionStart entry runs it only when present (`test -f … || true`).\n\n" +
|
|
107
115
|
"IN CLAUDE APP (claude.ai/code → environment selector → + Add environment):\n" +
|
|
108
116
|
" - Name: the repo name (e.g. `acme-web`) — one environment per repo, since secrets are per-repo.\n" +
|
|
@@ -115,7 +123,7 @@ export function runCloudModule(ctx: ModuleContext): void {
|
|
|
115
123
|
// --- cloud=opencode: GitHub-tracker path (same bkit-cloud.yml template, no OIDC) ---
|
|
116
124
|
|
|
117
125
|
// Record the variant.
|
|
118
|
-
setConsumerBkitField("
|
|
126
|
+
setConsumerBkitField("cloud.agent", "opencode", dryRun);
|
|
119
127
|
|
|
120
128
|
// Advisory — cloud=opencode setup checklist.
|
|
121
129
|
advisories.push({
|
|
@@ -138,7 +146,7 @@ export function runCloudModule(ctx: ModuleContext): void {
|
|
|
138
146
|
// --- cloud=cursor: Linear-tracker path ---
|
|
139
147
|
|
|
140
148
|
// Record the variant.
|
|
141
|
-
setConsumerBkitField("
|
|
149
|
+
setConsumerBkitField("cloud.agent", "cursor", dryRun);
|
|
142
150
|
|
|
143
151
|
// Advisory — cloud=cursor setup checklist.
|
|
144
152
|
advisories.push({
|
|
@@ -155,7 +163,7 @@ export function runCloudModule(ctx: ModuleContext): void {
|
|
|
155
163
|
" - Allowed concurrency: latest-supersedes.\n" +
|
|
156
164
|
" - Set `BKIT_LINEAR_API_KEY` as a **Runtime Secret** in the Cloud Agents dashboard (https://cursor.com/dashboard/cloud-agents) → your environment → Secrets tab.\n" +
|
|
157
165
|
" - Label the issue `bkit:auto` in Linear before pushing the build commit.\n\n" +
|
|
158
|
-
"IN REPO (copy each template and own it; bkit never writes or overwrites these files — see `.bkit/templates.md`):\n" +
|
|
166
|
+
"IN REPO (copy each template and own it; bkit never writes or overwrites these files, apart from brand migrations that rewrite exact shipped old names — see `.bkit/templates.md`):\n" +
|
|
159
167
|
" - `.bkit/templates/.cursor/Dockerfile` → `.cursor/Dockerfile`: change Node major if `engines.node` differs from 20; add Playwright / Supabase CLI / extra apt deps.\n" +
|
|
160
168
|
" - `.bkit/templates/.cursor/environment.json` → `.cursor/environment.json`: set `install` / `start` / `terminals[]` / `env` for your stack.",
|
|
161
169
|
});
|
|
@@ -14,6 +14,7 @@ import {
|
|
|
14
14
|
import { type IssueTracker, DEFAULT_ISSUE_TRACKER } from "../manifest.js";
|
|
15
15
|
import { substituteWorkflow } from "../../render/trackers.js";
|
|
16
16
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
17
|
+
import { writeCodexCloudDoc } from "../cloud-env.js";
|
|
17
18
|
import type { ModuleContext } from "./index.js";
|
|
18
19
|
import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
|
|
19
20
|
|
|
@@ -168,8 +169,9 @@ export function runCodexModule(ctx: ModuleContext): void {
|
|
|
168
169
|
}
|
|
169
170
|
}
|
|
170
171
|
|
|
171
|
-
// --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text,
|
|
172
|
-
|
|
172
|
+
// --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
|
|
173
|
+
// twins of the Claude hooks ---
|
|
174
|
+
for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
|
|
173
175
|
const hookSrc = path.join(codexHooks, hook);
|
|
174
176
|
const hookDst = `.codex/hooks/${hook}`;
|
|
175
177
|
if (fs.existsSync(hookSrc)) {
|
|
@@ -195,6 +197,17 @@ export function runCodexModule(ctx: ModuleContext): void {
|
|
|
195
197
|
}
|
|
196
198
|
}
|
|
197
199
|
|
|
200
|
+
// Generated copy-paste-ready Codex Cloud setup doc — `.codex/bkit-cloud.md`. Twin of
|
|
201
|
+
// `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL secret
|
|
202
|
+
// values resolved from `.envrc`, never enters ws.writes / canonicalHashes / `bkit check`
|
|
203
|
+
// drift. Skipped on dry-run (`bkit check`), which never writes secrets. Upgrade
|
|
204
|
+
// regenerates it via the same helper (see runUpgrade caller).
|
|
205
|
+
if (!dryRun && writeCodexCloudDoc(process.cwd(), ctx.tokens)) {
|
|
206
|
+
console.log(
|
|
207
|
+
`${logPrefix} ${tag}codex: .codex/bkit-cloud.md (generated — gitignored, holds resolved secrets)`,
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
|
|
198
211
|
advisories.push({
|
|
199
212
|
id: "codex-setup",
|
|
200
213
|
severity: "advisory",
|