@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
package/dist/install/manifest.js
CHANGED
|
@@ -25,7 +25,7 @@ export const OPTIN_MODULES = new Set(["cloud", "opencode", "codex", "antigravity
|
|
|
25
25
|
* `render/trackers.ts`.
|
|
26
26
|
*/
|
|
27
27
|
export const ISSUE_TRACKERS = ["github", "linear", "jira", "none"];
|
|
28
|
-
/** Default tracker when consumer manifest has no `bkit.
|
|
28
|
+
/** Default tracker when consumer manifest has no `bkit.tracker.default` field. */
|
|
29
29
|
export const DEFAULT_ISSUE_TRACKER = "none";
|
|
30
30
|
/**
|
|
31
31
|
* Narrow an unknown string to `IssueTracker` or return `null` if invalid.
|
|
@@ -51,15 +51,15 @@ export function parseIssueTracker(value) {
|
|
|
51
51
|
* presence). Requires `tracker=github` + local opencode host (`bkit install --opencode=<provider>`).
|
|
52
52
|
* - `none` — explicit opt-out; silences the post-install nudge advisory.
|
|
53
53
|
*
|
|
54
|
-
* Recorded in `package.json` `bkit.
|
|
54
|
+
* Recorded in `package.json` `bkit.cloud.agent`. Presence of the adopted copy
|
|
55
55
|
* (`bkit-cloud.yml` for github-host variants; `.cursor/Dockerfile` for cursor) is the authoritative
|
|
56
56
|
* "active" signal; the package.json field only distinguishes an opt-out from
|
|
57
57
|
* an undecided install.
|
|
58
58
|
*
|
|
59
|
-
* Single self-describing field (mirrors `bkit.
|
|
59
|
+
* Single self-describing field (mirrors `bkit.tracker.default`).
|
|
60
60
|
*/
|
|
61
61
|
export const CLOUD_MODES = ["claude", "cursor", "opencode", "none"];
|
|
62
|
-
/** Default when consumer manifest has no `bkit.
|
|
62
|
+
/** Default when consumer manifest has no `bkit.cloud.agent` field (undecided). */
|
|
63
63
|
export const DEFAULT_CLOUD_AGENTS = "none";
|
|
64
64
|
/** Narrow an unknown string to `CloudAgents` or return `null` if invalid. */
|
|
65
65
|
export function parseCloudAgents(value) {
|
|
@@ -89,18 +89,20 @@ const CORE_MANIFEST = [
|
|
|
89
89
|
// `.bkit/core/.bkit/` and are read from there at runtime (getBkitDocsRoot); these
|
|
90
90
|
// consumer copies are force-overwritten mirrors (writeTier1) so a consumer can read
|
|
91
91
|
// them in-repo. Whole file is bkit-owned → byte-equal-text (refreshed every install);
|
|
92
|
-
// prompts.md
|
|
92
|
+
// prompts.md is markered-text, keeping the consumer section below `bkit:end`.
|
|
93
|
+
{ path: ".bkit/authoring.md", format: "byte-equal-text", module: "core" },
|
|
93
94
|
{ path: ".bkit/cloud.md", format: "byte-equal-text", module: "core" },
|
|
95
|
+
{ path: ".bkit/cli.md", format: "byte-equal-text", module: "core" },
|
|
94
96
|
{ path: ".bkit/comparison.md", format: "byte-equal-text", module: "core" },
|
|
95
97
|
{ path: ".bkit/install.md", format: "byte-equal-text", module: "core" },
|
|
96
98
|
{ path: ".bkit/jsonl.md", format: "byte-equal-text", module: "core" },
|
|
97
99
|
// The MIT notice that travels with the files bkit writes: the full text and copyright
|
|
98
100
|
// notice. Sourced from `.bkit/core/.bkit/LICENSE.md`.
|
|
99
101
|
{ path: ".bkit/LICENSE.md", format: "byte-equal-text", module: "core" },
|
|
100
|
-
{ path: ".bkit/lite.md", format: "markered-text", module: "core" },
|
|
101
102
|
{ path: ".bkit/pipeline.md", format: "byte-equal-text", module: "core" },
|
|
102
103
|
{ path: ".bkit/providers.md", format: "byte-equal-text", module: "core" },
|
|
103
104
|
{ path: ".bkit/prompts.md", format: "markered-text", module: "core" },
|
|
105
|
+
{ path: ".bkit/router.md", format: "byte-equal-text", module: "core" },
|
|
104
106
|
{ path: ".bkit/templates.md", format: "byte-equal-text", module: "core" },
|
|
105
107
|
{ path: ".bkit/trackers.md", format: "byte-equal-text", module: "core" },
|
|
106
108
|
{ path: ".bkit/workflows.md", format: "byte-equal-text", module: "core" },
|
|
@@ -158,7 +160,7 @@ const CLAUDE_MANIFEST = [
|
|
|
158
160
|
// (bkit-tests-static / -unit / -integration / -e2e / -live). Where a step is not a
|
|
159
161
|
// tier (`format`, the ship gate) the name spells out the actual steps. One exception:
|
|
160
162
|
// `min` sits off the chain: the least a push runs, on a push that changes no code
|
|
161
|
-
// (`bkit.minPushPaths`); its steps are whatever that push can still break.
|
|
163
|
+
// (what bkit writes, plus `bkit.testing.minPushPaths`); its steps are whatever that push can still break.
|
|
162
164
|
//
|
|
163
165
|
// The consumer owns every value: a turbo monorepo writes `turbo run … --filter`,
|
|
164
166
|
// a Python repo writes `ruff check && pytest`. bkit never reads a value — only
|
|
@@ -167,7 +169,7 @@ const CLAUDE_MANIFEST = [
|
|
|
167
169
|
// Seeded by core on every install and upgrade (seedCorePackageJsonScripts,
|
|
168
170
|
// install/modules/index.ts): add-if-missing, so a name already present is never touched,
|
|
169
171
|
// and uninstall leaves every name in place. The tool scripts the defaults chain
|
|
170
|
-
// (typecheck, lint, format:check, lint:prose, slop:delta, lint-staged) are the
|
|
172
|
+
// (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta, lint-staged) are the
|
|
171
173
|
// consumer's to add — `.bkit/templates.md` lists them; the
|
|
172
174
|
// `gate-missing-called-scripts` advisory names any that are missing.
|
|
173
175
|
//
|
|
@@ -176,7 +178,7 @@ const CLAUDE_MANIFEST = [
|
|
|
176
178
|
// directly, one step each.
|
|
177
179
|
//
|
|
178
180
|
// `lint:slop` is in no gate: `slop-scan scan` is report-only and never fails. The gate
|
|
179
|
-
// that fails on new findings is `slop:delta`.
|
|
181
|
+
// that fails on new findings is `bkit:slop:delta`.
|
|
180
182
|
//
|
|
181
183
|
// NOT SEEDED: the three deeper gates (…-integration, …-integration-e2e,
|
|
182
184
|
// …-integration-e2e-live) are absent unless the consumer writes them. Each is one line
|
|
@@ -188,16 +190,16 @@ export const BKIT_GATE_SCRIPTS = {
|
|
|
188
190
|
// `.husky/pre-commit`: prettier --write over staged files, and nothing else —
|
|
189
191
|
// seconds, not minutes. Prose is a whole-repo scan, so it gates at pre-push.
|
|
190
192
|
"bkit:gate:format": "pnpm lint-staged",
|
|
191
|
-
// `.husky/pre-push` on a min push (every file
|
|
193
|
+
// `.husky/pre-push` on a min push (every file is one bkit writes or `bkit.testing.minPushPaths` adds): no code, so
|
|
192
194
|
// no typecheck, lint or tests. Off the chain. Add any test that reads a min-push file.
|
|
193
|
-
"bkit:gate:min": "pnpm format:check && pnpm lint:prose && pnpm slop:delta",
|
|
195
|
+
"bkit:gate:min": "pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
|
|
194
196
|
// Everything that needs no test runner. Every part has a matching step in the
|
|
195
197
|
// bkit-tests-static CI job; audits/templates/template-ci-yml.test.ts fails when one is missing.
|
|
196
198
|
// Callers: build's plan-execute loop between tasks, and the `.husky/pre-push` revert
|
|
197
199
|
// path.
|
|
198
|
-
"bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm lint:prose && pnpm slop:delta",
|
|
200
|
+
"bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
|
|
199
201
|
// The default local gate: `.husky/pre-push` (when no `…-integration` gate is declared),
|
|
200
|
-
// build
|
|
202
|
+
// build Steps 8 and 12, the remediates. `pnpm test` is the unit tier only: a test file the
|
|
201
203
|
// integration gate also runs must not match it.
|
|
202
204
|
"bkit:gate:static-unit": "pnpm bkit:gate:static && pnpm test",
|
|
203
205
|
// Ship's conflict-resolve, the only caller whose dependency graph may have just
|
|
@@ -224,20 +226,27 @@ export const BKIT_GATE_SCRIPTS = {
|
|
|
224
226
|
export const BKIT_DEBUG_GATES = [
|
|
225
227
|
"bkit:gate:static-unit-integration-e2e-live",
|
|
226
228
|
"bkit:gate:static-unit-integration-e2e",
|
|
229
|
+
"bkit:gate:static-unit-integration",
|
|
227
230
|
"bkit:gate:static-unit",
|
|
228
231
|
];
|
|
229
232
|
/**
|
|
230
|
-
* What `/bkit-build` Step
|
|
233
|
+
* What `/bkit-build` Step 12 will run, in DESCENDING order — first one declared wins.
|
|
234
|
+
* The Step 8 group gate runs `BKIT_GROUP_GATES` instead.
|
|
231
235
|
*
|
|
232
236
|
* Build stops at integration; E2E and live are not in this list.
|
|
233
237
|
*
|
|
234
|
-
*
|
|
235
|
-
*
|
|
238
|
+
* Declaring `bkit:gate:static-unit-integration` (never seeded) opts Step 12 and the
|
|
239
|
+
* pre-push hook into the integration tier.
|
|
236
240
|
*/
|
|
237
241
|
export const BKIT_BUILD_GATES = [
|
|
238
242
|
"bkit:gate:static-unit-integration",
|
|
239
243
|
"bkit:gate:static-unit",
|
|
240
244
|
];
|
|
245
|
+
/**
|
|
246
|
+
* What `/bkit-build` Step 8 runs after every group but the last, and hands the Step 9 fix
|
|
247
|
+
* round: static checks and the unit tier. Integration runs once, at Step 12.
|
|
248
|
+
*/
|
|
249
|
+
export const BKIT_GROUP_GATES = ["bkit:gate:static-unit"];
|
|
241
250
|
/**
|
|
242
251
|
* What `.husky/pre-push` runs on a full push, in DESCENDING order — first one declared wins.
|
|
243
252
|
*
|
|
@@ -255,6 +264,21 @@ export const BKIT_PUSH_GATES = [
|
|
|
255
264
|
* upgrade advise when it is missing (detectGateAdvisories).
|
|
256
265
|
*/
|
|
257
266
|
export const BKIT_TEST_FILE_SCRIPT = "bkit:test:file";
|
|
267
|
+
/**
|
|
268
|
+
* Lints ONE test file — `pnpm bkit:lint:file <repo-relative path>`, exit 0 when clean.
|
|
269
|
+
* `bkit tests red` runs it before recording a red, so a lint rewrite never lands after
|
|
270
|
+
* the red. Never seeded: install, check and upgrade advise when `bkit:test:file` is
|
|
271
|
+
* declared and this is not (detectGateAdvisories).
|
|
272
|
+
*/
|
|
273
|
+
export const BKIT_LINT_FILE_SCRIPT = "bkit:lint:file";
|
|
274
|
+
/**
|
|
275
|
+
* Checks only what changed — `pnpm bkit:gate:changed <repo-relative path>...`, exit 0
|
|
276
|
+
* when clean: the tests that import the files, the tests that name their paths, and
|
|
277
|
+
* static checks on the files. `bkit tests changed` passes the files and falls back to a
|
|
278
|
+
* whole gate when this is undeclared. Never seeded: install, check and upgrade advise
|
|
279
|
+
* when it is missing (detectGateAdvisories).
|
|
280
|
+
*/
|
|
281
|
+
export const BKIT_GATE_CHANGED_SCRIPT = "bkit:gate:changed";
|
|
258
282
|
/**
|
|
259
283
|
* The deeper gates, shallowest first, with what declaring each one costs.
|
|
260
284
|
*
|
|
@@ -347,6 +371,13 @@ export const OPENCODE_MANIFEST = [
|
|
|
347
371
|
format: "markered-text",
|
|
348
372
|
module: "opencode",
|
|
349
373
|
},
|
|
374
|
+
// bkit-rules.js — same split as bkit-gateguard.js. Delivers the rules-read advisory
|
|
375
|
+
// on the session's first tool call (opencode has no session-start event).
|
|
376
|
+
{
|
|
377
|
+
path: ".opencode/plugin/bkit-rules.js",
|
|
378
|
+
format: "markered-text",
|
|
379
|
+
module: "opencode",
|
|
380
|
+
},
|
|
350
381
|
// Agent and command mirrors are managed dynamically (not listed individually here —
|
|
351
382
|
// the exact set depends on the bkit-prefix prompt/workflow files at install time).
|
|
352
383
|
// Uninstall uses the BKIT_PREFIX filter for .opencode/agents/ and .opencode/commands/.
|
|
@@ -383,6 +414,14 @@ export const CODEX_MANIFEST = [
|
|
|
383
414
|
format: "markered-text",
|
|
384
415
|
module: "codex",
|
|
385
416
|
},
|
|
417
|
+
// bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
|
|
418
|
+
// session as `additionalContext` on the first tool call (Codex has no session-start
|
|
419
|
+
// event). Registered on two single-value matchers, `apply_patch` and `Bash`.
|
|
420
|
+
{
|
|
421
|
+
path: ".codex/hooks/bkit-rules.cjs",
|
|
422
|
+
format: "markered-text",
|
|
423
|
+
module: "codex",
|
|
424
|
+
},
|
|
386
425
|
// Agent mirrors (.codex/agents/*.toml) and workflow skills (.agents/skills/bkit-*/) are
|
|
387
426
|
// managed dynamically — the set follows the bkit-prefix prompt/workflow files at install.
|
|
388
427
|
];
|
|
@@ -419,6 +458,14 @@ export const ANTIGRAVITY_MANIFEST = [
|
|
|
419
458
|
format: "markered-text",
|
|
420
459
|
module: "antigravity",
|
|
421
460
|
},
|
|
461
|
+
// bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
|
|
462
|
+
// session by denying the first tool call with the advisory as the reason (Antigravity's
|
|
463
|
+
// only channel to the model); the identical retry is allowed.
|
|
464
|
+
{
|
|
465
|
+
path: ".agents/plugins/bkit/hooks/bkit-rules.cjs",
|
|
466
|
+
format: "markered-text",
|
|
467
|
+
module: "antigravity",
|
|
468
|
+
},
|
|
422
469
|
// Root GEMINI.md — Antigravity workspace-rule redirect to .agents/rules.md, owned by the
|
|
423
470
|
// antigravity module: `uninstall --antigravity` removes it; other installs leave it.
|
|
424
471
|
{ path: "GEMINI.md", format: "markered-text", module: "antigravity" },
|
|
@@ -431,7 +478,7 @@ export const ANTIGRAVITY_MANIFEST = [
|
|
|
431
478
|
// (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent files
|
|
432
479
|
// (.cursor/Dockerfile, .cursor/environment.json) ship as templates
|
|
433
480
|
// (`.bkit/templates.md`); the consumer copies and owns them. Each variant only
|
|
434
|
-
// records `bkit.
|
|
481
|
+
// records `bkit.cloud.agent` and prints its setup advisories.
|
|
435
482
|
export const CLOUD_MANIFEST_CLAUDE = [];
|
|
436
483
|
export const CLOUD_MANIFEST_OPENCODE = [];
|
|
437
484
|
export const CLOUD_MANIFEST_CURSOR = [];
|
|
@@ -161,8 +161,9 @@ export function runAntigravityModule(ctx) {
|
|
|
161
161
|
console.log(`${logPrefix} ${tag}antigravity: ${jsonDst}`);
|
|
162
162
|
}
|
|
163
163
|
}
|
|
164
|
-
// --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text,
|
|
165
|
-
|
|
164
|
+
// --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
|
|
165
|
+
// twins of the Claude/Codex hooks ---
|
|
166
|
+
for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
|
|
166
167
|
const hookSrc = path.join(pluginHooksSrc, hook);
|
|
167
168
|
const hookDst = path.join(ANTIGRAVITY_HOOKS_DIR, hook);
|
|
168
169
|
if (fs.existsSync(hookSrc)) {
|
|
@@ -10,11 +10,12 @@ import { parseJson } from "../../shared/json.js";
|
|
|
10
10
|
// ---------------------------------------------------------------------------
|
|
11
11
|
/**
|
|
12
12
|
* Persist a `bkit.<field>` value into the consumer's package.json so the
|
|
13
|
-
* post-install advisory can tell "deliberately none" from "undecided".
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
13
|
+
* post-install advisory can tell "deliberately none" from "undecided". `field` is a
|
|
14
|
+
* dotted path (`cloud.agent`); each missing section on the way is created. Mirrors
|
|
15
|
+
* the `bkit.tracker.default` persist logic in commands/install/install.ts. Used for the opt-in
|
|
16
|
+
* decisions recorded by their owning modules (`cloud.agent`). No-op
|
|
17
|
+
* on dry-run, when package.json is absent/unparseable, or when a section on the path
|
|
18
|
+
* holds a non-object (non-fatal — the config file presence is still the primary signal).
|
|
18
19
|
*/
|
|
19
20
|
function setConsumerBkitField(field, value, dryRun) {
|
|
20
21
|
if (dryRun)
|
|
@@ -28,11 +29,19 @@ function setConsumerBkitField(field, value, dryRun) {
|
|
|
28
29
|
if (!parsed.ok)
|
|
29
30
|
return;
|
|
30
31
|
const pkg = parsed.value;
|
|
31
|
-
const
|
|
32
|
-
|
|
32
|
+
const keys = ["bkit", ...field.split(".")];
|
|
33
|
+
const leaf = keys.pop();
|
|
34
|
+
let parent = pkg;
|
|
35
|
+
for (const k of keys) {
|
|
36
|
+
parent[k] ??= {};
|
|
37
|
+
const next = parent[k];
|
|
38
|
+
if (next === null || typeof next !== "object" || Array.isArray(next))
|
|
39
|
+
return;
|
|
40
|
+
parent = next;
|
|
41
|
+
}
|
|
42
|
+
if (parent[leaf] === value)
|
|
33
43
|
return; // already set — avoid a no-op rewrite
|
|
34
|
-
|
|
35
|
-
pkg.bkit = bkit;
|
|
44
|
+
parent[leaf] = value;
|
|
36
45
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
37
46
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
38
47
|
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
@@ -44,14 +53,14 @@ function setConsumerBkitField(field, value, dryRun) {
|
|
|
44
53
|
}
|
|
45
54
|
// The cloud workflow is a template (`.bkit/templates.md`). Shared first step of the
|
|
46
55
|
// claude and opencode setup advisories.
|
|
47
|
-
const CLOUD_WORKFLOW_ADOPT_STEP = " - 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";
|
|
56
|
+
const CLOUD_WORKFLOW_ADOPT_STEP = " - 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";
|
|
48
57
|
// ---------------------------------------------------------------------------
|
|
49
58
|
// runCloudModule — opt-in cloud-agent integration
|
|
50
59
|
// ---------------------------------------------------------------------------
|
|
51
60
|
//
|
|
52
61
|
// NOT shipped by a default install — opt-in via `bkit install --auto=<variant>`,
|
|
53
62
|
// so a default install ships ZERO cloud footprint. Every variant records
|
|
54
|
-
// `bkit.
|
|
63
|
+
// `bkit.cloud.agent` and prints its setup advisories; none writes a file. The cloud
|
|
55
64
|
// workflow (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent
|
|
56
65
|
// files (.cursor/Dockerfile, .cursor/environment.json) are templates the advisories
|
|
57
66
|
// point at.
|
|
@@ -66,7 +75,7 @@ export function runCloudModule(ctx) {
|
|
|
66
75
|
if (variant === "claude") {
|
|
67
76
|
// --- cloud=claude: GitHub-tracker path ---
|
|
68
77
|
// Record the variant so the post-install advisory and `bkit check` stay consistent.
|
|
69
|
-
setConsumerBkitField("
|
|
78
|
+
setConsumerBkitField("cloud.agent", "claude", dryRun);
|
|
70
79
|
// Advisory — cloud=claude setup checklist (App required; id-token: write).
|
|
71
80
|
advisories.push({
|
|
72
81
|
id: "bkit-cloud-setup",
|
|
@@ -90,7 +99,7 @@ export function runCloudModule(ctx) {
|
|
|
90
99
|
severity: "advisory",
|
|
91
100
|
detect: "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).",
|
|
92
101
|
action: "Two locations to touch — full recipe in bkit's `cloud.md`.\n\n" +
|
|
93
|
-
"IN REPO (copy-and-own; bkit never writes it):\n" +
|
|
102
|
+
"IN REPO (copy-and-own; bkit never writes it, apart from brand migrations that rewrite exact shipped old names):\n" +
|
|
94
103
|
" - 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" +
|
|
95
104
|
"IN CLAUDE APP (claude.ai/code → environment selector → + Add environment):\n" +
|
|
96
105
|
" - Name: the repo name (e.g. `acme-web`) — one environment per repo, since secrets are per-repo.\n" +
|
|
@@ -103,7 +112,7 @@ export function runCloudModule(ctx) {
|
|
|
103
112
|
else if (variant === "opencode") {
|
|
104
113
|
// --- cloud=opencode: GitHub-tracker path (same bkit-cloud.yml template, no OIDC) ---
|
|
105
114
|
// Record the variant.
|
|
106
|
-
setConsumerBkitField("
|
|
115
|
+
setConsumerBkitField("cloud.agent", "opencode", dryRun);
|
|
107
116
|
// Advisory — cloud=opencode setup checklist.
|
|
108
117
|
advisories.push({
|
|
109
118
|
id: "bkit-cloud-setup",
|
|
@@ -123,7 +132,7 @@ export function runCloudModule(ctx) {
|
|
|
123
132
|
else {
|
|
124
133
|
// --- cloud=cursor: Linear-tracker path ---
|
|
125
134
|
// Record the variant.
|
|
126
|
-
setConsumerBkitField("
|
|
135
|
+
setConsumerBkitField("cloud.agent", "cursor", dryRun);
|
|
127
136
|
// Advisory — cloud=cursor setup checklist.
|
|
128
137
|
advisories.push({
|
|
129
138
|
id: "bkit-cloud-setup",
|
|
@@ -137,7 +146,7 @@ export function runCloudModule(ctx) {
|
|
|
137
146
|
" - Allowed concurrency: latest-supersedes.\n" +
|
|
138
147
|
" - 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" +
|
|
139
148
|
" - Label the issue `bkit:auto` in Linear before pushing the build commit.\n\n" +
|
|
140
|
-
"IN REPO (copy each template and own it; bkit never writes or overwrites these files — see `.bkit/templates.md`):\n" +
|
|
149
|
+
"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" +
|
|
141
150
|
" - `.bkit/templates/.cursor/Dockerfile` → `.cursor/Dockerfile`: change Node major if `engines.node` differs from 20; add Playwright / Supabase CLI / extra apt deps.\n" +
|
|
142
151
|
" - `.bkit/templates/.cursor/environment.json` → `.cursor/environment.json`: set `install` / `start` / `terminals[]` / `env` for your stack.",
|
|
143
152
|
});
|
|
@@ -8,6 +8,7 @@ import { getCoreRoot, getSharedRoot, getWorkflowsRoot, getPromptsRoot, } from ".
|
|
|
8
8
|
import { DEFAULT_ISSUE_TRACKER } from "../manifest.js";
|
|
9
9
|
import { substituteWorkflow } from "../../render/trackers.js";
|
|
10
10
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
11
|
+
import { writeCodexCloudDoc } from "../cloud-env.js";
|
|
11
12
|
import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
|
|
12
13
|
/**
|
|
13
14
|
* Convert a workflow orchestrator (`.bkit/core/workflows/*.md`) into a Codex SKILL.md.
|
|
@@ -141,8 +142,9 @@ export function runCodexModule(ctx) {
|
|
|
141
142
|
console.log(`${logPrefix} ${tag}codex: ${jsonDst}`);
|
|
142
143
|
}
|
|
143
144
|
}
|
|
144
|
-
// --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text,
|
|
145
|
-
|
|
145
|
+
// --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
|
|
146
|
+
// twins of the Claude hooks ---
|
|
147
|
+
for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
|
|
146
148
|
const hookSrc = path.join(codexHooks, hook);
|
|
147
149
|
const hookDst = `.codex/hooks/${hook}`;
|
|
148
150
|
if (fs.existsSync(hookSrc)) {
|
|
@@ -170,6 +172,14 @@ export function runCodexModule(ctx) {
|
|
|
170
172
|
console.log(`${logPrefix} ${tag}codex: ${railDst}`);
|
|
171
173
|
}
|
|
172
174
|
}
|
|
175
|
+
// Generated copy-paste-ready Codex Cloud setup doc — `.codex/bkit-cloud.md`. Twin of
|
|
176
|
+
// `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL secret
|
|
177
|
+
// values resolved from `.envrc`, never enters ws.writes / canonicalHashes / `bkit check`
|
|
178
|
+
// drift. Skipped on dry-run (`bkit check`), which never writes secrets. Upgrade
|
|
179
|
+
// regenerates it via the same helper (see runUpgrade caller).
|
|
180
|
+
if (!dryRun && writeCodexCloudDoc(process.cwd(), ctx.tokens)) {
|
|
181
|
+
console.log(`${logPrefix} ${tag}codex: .codex/bkit-cloud.md (generated — gitignored, holds resolved secrets)`);
|
|
182
|
+
}
|
|
173
183
|
advisories.push({
|
|
174
184
|
id: "codex-setup",
|
|
175
185
|
severity: "advisory",
|