@cbartens/bkit 0.0.0-stage → 5.0.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 +421 -0
- package/.bkit/core/.agents/context.md +95 -0
- package/.bkit/core/.agents/docs.md +62 -0
- package/.bkit/core/.agents/rules.md +147 -0
- package/.bkit/core/.agents/skills.md +43 -0
- package/.bkit/core/.bkit/LICENSE.md +151 -0
- package/.bkit/core/.bkit/README.md +421 -0
- package/.bkit/core/.bkit/cloud.md +502 -0
- package/.bkit/core/.bkit/comparison.md +318 -0
- package/.bkit/core/.bkit/install.md +496 -0
- package/.bkit/core/.bkit/jsonl.md +497 -0
- package/.bkit/core/.bkit/prompts.md +474 -0
- package/.bkit/core/.bkit/providers.md +598 -0
- package/.bkit/core/.bkit/templates.md +471 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1546 -0
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
- package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
- package/.bkit/core/AGENTS.md +77 -0
- package/.bkit/core/LICENSE.md +149 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
- package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
- package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
- package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
- package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
- package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
- package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
- package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
- package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
- package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
- package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
- package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
- package/.bkit/core/docs/templates/bkit-plan.md +476 -0
- package/.bkit/core/engine/checks/after/auth.ts +247 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +556 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/after/vercel.ts +101 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +201 -0
- package/.bkit/core/engine/checks/before/files.ts +202 -0
- package/.bkit/core/engine/checks/before/index.ts +206 -0
- package/.bkit/core/engine/checks/before/mcp.ts +127 -0
- package/.bkit/core/engine/checks/before/repo.ts +77 -0
- package/.bkit/core/engine/checks/before/version.ts +67 -0
- package/.bkit/core/engine/checks/status-holes.ts +479 -0
- package/.bkit/core/engine/cli.ts +871 -0
- package/.bkit/core/engine/commands/analysis.ts +550 -0
- package/.bkit/core/engine/commands/ci/ci.ts +483 -0
- package/.bkit/core/engine/commands/comply.ts +415 -0
- package/.bkit/core/engine/commands/harvest.ts +459 -0
- package/.bkit/core/engine/commands/install/check.ts +70 -0
- package/.bkit/core/engine/commands/install/doctor.ts +247 -0
- package/.bkit/core/engine/commands/install/install.ts +528 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +494 -0
- package/.bkit/core/engine/commands/registry.ts +53 -0
- package/.bkit/core/engine/commands/setup/setup.ts +184 -0
- package/.bkit/core/engine/commands/telemetry.ts +32 -0
- package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
- package/.bkit/core/engine/commands/workflow/context.ts +961 -0
- package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
- package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
- package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
- package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
- package/.bkit/core/engine/commands/workflow/status.ts +455 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
- package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
- package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
- package/.bkit/core/engine/install/cloud-env.ts +925 -0
- package/.bkit/core/engine/install/managed-block.ts +212 -0
- package/.bkit/core/engine/install/manifest.ts +448 -0
- package/.bkit/core/engine/install/modules/claude.ts +362 -0
- package/.bkit/core/engine/install/modules/cloud.ts +174 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +600 -0
- package/.bkit/core/engine/install/modules/cursor.ts +231 -0
- package/.bkit/core/engine/install/modules/index.ts +242 -0
- package/.bkit/core/engine/install/modules/opencode.ts +573 -0
- package/.bkit/core/engine/install/placeholders.ts +108 -0
- package/.bkit/core/engine/install/template-copies.ts +119 -0
- package/.bkit/core/engine/install/version-file.ts +284 -0
- package/.bkit/core/engine/install/write.ts +467 -0
- package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
- package/.bkit/core/engine/ledgers/status.ts +213 -0
- package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
- package/.bkit/core/engine/render/hosts.ts +372 -0
- package/.bkit/core/engine/render/models.ts +323 -0
- package/.bkit/core/engine/render/parts.ts +38 -0
- package/.bkit/core/engine/render/trackers.ts +170 -0
- package/.bkit/core/engine/shared/egress.ts +345 -0
- package/.bkit/core/engine/shared/json.ts +16 -0
- package/.bkit/core/engine/shared/log-prefix.ts +9 -0
- package/.bkit/core/engine/shared/package-json.ts +29 -0
- package/.bkit/core/engine/shared/package-manager.ts +38 -0
- package/.bkit/core/engine/shared/package-roots.ts +163 -0
- package/.bkit/core/engine/shared/protected-paths.ts +164 -0
- package/.bkit/core/engine/shared/settings.ts +72 -0
- package/.bkit/core/engine/shared/timeouts.ts +20 -0
- package/.bkit/core/engine/tools/wording.ts +748 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
- package/.bkit/core/hooks/gateguard-engine.js +193 -0
- package/.bkit/core/hooks/guardrails-shell.js +154 -0
- package/.bkit/core/hooks/guardrails-tiers.js +68 -0
- package/.bkit/core/hooks/preflight-linear.sh +73 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
- package/.bkit/core/prompts/bkit-build-summary.md +93 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
- package/.bkit/core/prompts/bkit-design-generate.md +110 -0
- package/.bkit/core/prompts/bkit-design-organise.md +85 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
- package/.bkit/core/prompts/bkit-design-spike.md +97 -0
- package/.bkit/core/prompts/bkit-design-summary.md +106 -0
- package/.bkit/core/prompts/bkit-design-update.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
- package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
- package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
- package/.bkit/core/prompts/bkit-plan-update.md +68 -0
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
- package/.bkit/core/workflows/bkit-auto.md +121 -0
- package/.bkit/core/workflows/bkit-build.md +802 -0
- package/.bkit/core/workflows/bkit-debug.md +642 -0
- package/.bkit/core/workflows/bkit-design.md +495 -0
- package/.bkit/core/workflows/bkit-plan.md +510 -0
- package/.bkit/core/workflows/bkit-ship.md +650 -0
- package/.bkit/shared/.bkit/.env.example +108 -0
- package/.bkit/shared/.claude/bkit-cloud.md +117 -0
- package/.bkit/shared/.claude/settings.json +88 -0
- package/.bkit/shared/.codex/hooks.json +26 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
- package/.bkit/shared/.cursor/hooks.json +26 -0
- package/.bkit/shared/.cursor/mcp.json +15 -0
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
- package/.bkit/shared/.gitattributes +37 -0
- package/.bkit/shared/.mcp.json +16 -0
- package/.bkit/shared/.opencode/opencode.json +62 -0
- package/.bkit/shared/CLAUDE.md +11 -0
- package/.bkit/shared/LICENSE.md +22 -0
- package/.bkit/shared/docs/architecture.md +19 -0
- package/.bkit/shared/docs/data-schema.md +19 -0
- package/.bkit/shared/docs/deployments.md +438 -0
- package/.bkit/shared/docs/design.md +39 -0
- package/.bkit/shared/docs/noise.md +19 -0
- package/.bkit/shared/docs/observability.md +25 -0
- package/.bkit/shared/docs/security.md +42 -0
- package/.bkit/shared/docs/setup.md +30 -0
- package/.bkit/shared/docs/technology.md +18 -0
- package/.bkit/shared/docs/testing.md +413 -0
- package/.bkit/shared/gitignore +92 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
- package/.bkit/templates/.cursor/Dockerfile +68 -0
- package/.bkit/templates/.cursor/environment.json +6 -0
- package/.bkit/templates/.cursor/settings.json +11 -0
- package/.bkit/templates/.envrc +7 -0
- package/.bkit/templates/.github/dependabot.yml +52 -0
- package/.bkit/templates/.github/renovate.json5 +239 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
- package/.bkit/templates/.graphifyignore +108 -0
- package/.bkit/templates/.husky/pre-commit +16 -0
- package/.bkit/templates/.husky/pre-push +91 -0
- package/.bkit/templates/.lintstagedrc.json +3 -0
- package/.bkit/templates/.prettierignore +41 -0
- package/.bkit/templates/.serena/project.yml +243 -0
- package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
- package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
- package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
- package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
- package/.bkit/templates/.vale.ini +67 -0
- package/.bkit/templates/LICENSE.md +22 -0
- package/.bkit/templates/context/bkit-cloudrun.md +84 -0
- package/.bkit/templates/context/bkit-expo.md +186 -0
- package/.bkit/templates/context/bkit-github.md +79 -0
- package/.bkit/templates/context/bkit-inngest.md +45 -0
- package/.bkit/templates/context/bkit-maestro.md +76 -0
- package/.bkit/templates/context/bkit-playwright.md +62 -0
- package/.bkit/templates/context/bkit-resend.md +36 -0
- package/.bkit/templates/context/bkit-sentry.md +65 -0
- package/.bkit/templates/context/bkit-serena.md +33 -0
- package/.bkit/templates/context/bkit-stripe.md +36 -0
- package/.bkit/templates/context/bkit-supabase.md +59 -0
- package/.bkit/templates/context/bkit-tavily.md +49 -0
- package/.bkit/templates/context/bkit-vercel.md +64 -0
- package/.bkit/templates/docs/capabilities.md +72 -0
- package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
- package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
- package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
- package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
- package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
- package/.bkit/templates/slop-scan.config.json +120 -0
- package/CHANGELOG.md +1486 -0
- package/LICENSE.md +161 -0
- package/README.md +185 -2
- package/dist/checks/after/auth.js +232 -0
- package/dist/checks/after/ci-yml.js +718 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +447 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/after/vercel.js +102 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +173 -0
- package/dist/checks/before/files.js +185 -0
- package/dist/checks/before/index.js +162 -0
- package/dist/checks/before/mcp.js +111 -0
- package/dist/checks/before/repo.js +71 -0
- package/dist/checks/before/version.js +60 -0
- package/dist/checks/status-holes.js +393 -0
- package/dist/cli.js +692 -0
- package/dist/commands/analysis.js +325 -0
- package/dist/commands/ci/ci.js +438 -0
- package/dist/commands/comply.js +310 -0
- package/dist/commands/harvest.js +354 -0
- package/dist/commands/install/check.js +61 -0
- package/dist/commands/install/doctor.js +207 -0
- package/dist/commands/install/install.js +461 -0
- package/dist/commands/install/uninstall.js +815 -0
- package/dist/commands/install/upgrade.js +771 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +362 -0
- package/dist/commands/registry.js +50 -0
- package/dist/commands/setup/setup.js +158 -0
- package/dist/commands/telemetry.js +29 -0
- package/dist/commands/workflow/branches.js +1265 -0
- package/dist/commands/workflow/context.js +846 -0
- package/dist/commands/workflow/counters.js +227 -0
- package/dist/commands/workflow/fids.js +224 -0
- package/dist/commands/workflow/issues.js +585 -0
- package/dist/commands/workflow/ledgers.js +472 -0
- package/dist/commands/workflow/locks.js +364 -0
- package/dist/commands/workflow/prs.js +904 -0
- package/dist/commands/workflow/repo.js +199 -0
- package/dist/commands/workflow/roadmap.js +495 -0
- package/dist/commands/workflow/runs.js +1717 -0
- package/dist/commands/workflow/runtime.js +257 -0
- package/dist/commands/workflow/skills.js +110 -0
- package/dist/commands/workflow/status.js +392 -0
- package/dist/commands/workflow/steps.js +1093 -0
- package/dist/commands/workflow/tests.js +144 -0
- package/dist/commands/workflow/workflows.js +1342 -0
- package/dist/commands/workflow/workstreams.js +141 -0
- package/dist/commands/workflow/worktrees.js +473 -0
- package/dist/install/cloud-env.js +819 -0
- package/dist/install/managed-block.js +182 -0
- package/dist/install/manifest.js +376 -0
- package/dist/install/modules/claude.js +288 -0
- package/dist/install/modules/cloud.js +152 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +511 -0
- package/dist/install/modules/cursor.js +186 -0
- package/dist/install/modules/index.js +152 -0
- package/dist/install/modules/opencode.js +504 -0
- package/dist/install/placeholders.js +87 -0
- package/dist/install/template-copies.js +106 -0
- package/dist/install/version-file.js +204 -0
- package/dist/install/write.js +342 -0
- package/dist/ledgers/clamp-log.js +27 -0
- package/dist/ledgers/status.js +156 -0
- package/dist/ledgers/telemetry.js +637 -0
- package/dist/render/hosts.js +339 -0
- package/dist/render/models.js +288 -0
- package/dist/render/parts.js +33 -0
- package/dist/render/trackers.js +135 -0
- package/dist/shared/egress.js +299 -0
- package/dist/shared/json.js +16 -0
- package/dist/shared/log-prefix.js +7 -0
- package/dist/shared/package-json.js +22 -0
- package/dist/shared/package-manager.js +32 -0
- package/dist/shared/package-roots.js +145 -0
- package/dist/shared/protected-paths.js +153 -0
- package/dist/shared/settings.js +44 -0
- package/dist/shared/timeouts.js +19 -0
- package/dist/tools/wording.js +680 -0
- package/package.json +101 -4
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# .bkit/.env — local secrets for MCP servers and agent tooling, shipped by bkit.
|
|
2
|
+
# {{BKIT_MANAGED_MARKER}}
|
|
3
|
+
#
|
|
4
|
+
# Copy this file to .bkit/.env (gitignored), fill in your values, then run:
|
|
5
|
+
# direnv allow
|
|
6
|
+
# direnv will auto-export these into your shell whenever you cd into this repo.
|
|
7
|
+
#
|
|
8
|
+
# Cloud sessions (Claude on the web, Cursor Background Agents) set the SAME
|
|
9
|
+
# variable names in their respective dashboards — never in this file.
|
|
10
|
+
|
|
11
|
+
# BKIT_NPM_TOKEN — npm granular access token with read + write access to the
|
|
12
|
+
# @cbartens scope. The Release workflow publishes @cbartens/bkit to npmjs.org
|
|
13
|
+
# with it (same name as the repo secret, Actions → Secrets), and local
|
|
14
|
+
# maintenance uses it too (`npm whoami`, manual publishes). npm is restricting
|
|
15
|
+
# tokens that bypass 2FA (account changes Aug 2026, direct publishing Jan 2027)
|
|
16
|
+
# — create a granular token and keep 2FA enrolled.
|
|
17
|
+
# Generate at: https://www.npmjs.com/settings/cbartens/tokens
|
|
18
|
+
BKIT_NPM_TOKEN=
|
|
19
|
+
|
|
20
|
+
# BKIT_GH_TOKEN_INSTALL — GitHub classic PAT with `read:packages` scope. Used by pnpm
|
|
21
|
+
# to authenticate to the GitHub Packages npm registry (npm.pkg.github.com) for
|
|
22
|
+
# @cbartens/* packages. Fine-grained PATs are rejected by GitHub Packages
|
|
23
|
+
# (HTTP 403) — must be classic.
|
|
24
|
+
# Generate at: https://github.com/settings/tokens (Tokens (classic) → Generate)
|
|
25
|
+
# The project .npmrc carries ONLY the @cbartens registry mapping; the auth token
|
|
26
|
+
# is written into pnpm's user-level config via `pnpm config set` (CI step, local
|
|
27
|
+
# once, Vercel installCommand) — version-proof across pnpm 10.x/11.x. pnpm >=10.34.3
|
|
28
|
+
# 401s on a project-.npmrc ${BKIT_GH_TOKEN_INSTALL} env-substitution. See KN-CORE-7.
|
|
29
|
+
BKIT_GH_TOKEN_INSTALL=
|
|
30
|
+
|
|
31
|
+
# Optional examples — not required bkit tooling. Listed so direnv has a name to
|
|
32
|
+
# load if you use that surface; leave blank otherwise.
|
|
33
|
+
|
|
34
|
+
# BKIT_GH_TOKEN — the general-purpose bkit GitHub token (fine-grained PAT). One token
|
|
35
|
+
# for every GitHub *API* operation bkit tooling performs:
|
|
36
|
+
# - the GitHub MCP server (api.githubcopilot.com/mcp/) via the Authorization header
|
|
37
|
+
# in .mcp.json / .cursor/mcp.json;
|
|
38
|
+
# - self-hosted Renovate's PLATFORM auth (repo Actions secret) when you copy
|
|
39
|
+
# the example `.github/workflows/bkit-renovate.yml` — opens PRs,
|
|
40
|
+
# pushes renovate/* branches, edits workflow SHAs, maintains the dashboard issue.
|
|
41
|
+
# Required Repository permissions (as labelled in the fine-grained-PAT UI; scope to the
|
|
42
|
+
# repos you work on): Contents: Read and write · Pull requests: Read and write · Issues:
|
|
43
|
+
# Read and write · Workflows: Read and write · Commit statuses: Read and write (Renovate
|
|
44
|
+
# reads a commit's CI state to open the PR + posts its own stability checks; without it it
|
|
45
|
+
# creates the renovate/* branch but 403s on /commits/{sha}/statuses and never opens the PR)
|
|
46
|
+
# · Dependabot alerts: Read (GitHub's vulnerability feed, for security-fix PRs) · Metadata:
|
|
47
|
+
# Read-only. (Actions: Read for the MCP server's run-status queries.) There is NO "Checks"
|
|
48
|
+
# permission on fine-grained PATs — check-run writes are App-only, so a PAT-based Renovate
|
|
49
|
+
# uses commit statuses instead.
|
|
50
|
+
# Self-hosted Renovate commit authorship: on a PERSONAL-account token also add the Account
|
|
51
|
+
# permission "Email addresses: Read" so commits use your verified email. ORG-owned tokens
|
|
52
|
+
# have NO Email-addresses permission — instead set the repo variable RENOVATE_GIT_AUTHOR
|
|
53
|
+
# (Settings -> Secrets and variables -> Actions -> Variables), e.g. `Renovate Bot <renovate@your-domain>`.
|
|
54
|
+
# This is a WRITE token — keep it SEPARATE from BKIT_GH_TOKEN_INSTALL, and do NOT put it
|
|
55
|
+
# on read-only surfaces (Vercel env / project .npmrc). It also CANNOT authenticate to
|
|
56
|
+
# GitHub Packages (fine-grained PATs get 403 there) — registry/lockfile auth stays on
|
|
57
|
+
# the classic BKIT_GH_TOKEN_INSTALL above (that is why Renovate's hostRules use _INSTALL).
|
|
58
|
+
# Generate at: https://github.com/settings/personal-access-tokens
|
|
59
|
+
BKIT_GH_TOKEN=
|
|
60
|
+
|
|
61
|
+
# BKIT_LINEAR_API_KEY — Linear personal API key. Used by the Linear MCP server
|
|
62
|
+
# (mcp.linear.app/mcp) and by the Linear preflight hook in
|
|
63
|
+
# .claude/hooks/bkit-preflight.sh and .cursor/hooks/bkit-preflight.sh.
|
|
64
|
+
# Generate at: https://linear.app/settings/api
|
|
65
|
+
BKIT_LINEAR_API_KEY=
|
|
66
|
+
|
|
67
|
+
# BKIT_ANTHROPIC_API_KEY — Anthropic API key. Only needed if you run Claude Code
|
|
68
|
+
# without a Claude subscription (pay-per-token mode). Subscription users leave
|
|
69
|
+
# blank.
|
|
70
|
+
# Generate at: https://console.anthropic.com/settings/keys
|
|
71
|
+
BKIT_ANTHROPIC_API_KEY=
|
|
72
|
+
|
|
73
|
+
# BKIT_CURSOR_API_KEY — Cursor API key. Only needed if you dispatch Cursor cloud
|
|
74
|
+
# agents from this shell (programmatic POST /v0/agents, model catalog queries
|
|
75
|
+
# via `curl https://api.cursor.com/v0/models -u "$BKIT_CURSOR_API_KEY:"`). The
|
|
76
|
+
# Cursor desktop IDE does NOT use this — it authenticates via its own login.
|
|
77
|
+
# Generate at: https://cursor.com/settings → API Keys
|
|
78
|
+
BKIT_CURSOR_API_KEY=
|
|
79
|
+
|
|
80
|
+
# BKIT_OPENCODE_API_KEY — OpenCode gateway API key (one key covers both plans). Used with
|
|
81
|
+
# `bkit install --opencode=opencode-zen` or `--opencode=opencode-go`. Zen is the full gateway
|
|
82
|
+
# (https://opencode.ai/zen/v1; ids `opencode-zen/<id>`); Go is the budget open-weight-only plan
|
|
83
|
+
# (https://opencode.ai/zen/go/v1; ids `opencode-go/<id>`). Default Go pins: minimax-m3 (opus),
|
|
84
|
+
# qwen3.7-plus (sonnet), deepseek-v4-pro/-flash — prefer pins that stay within the Go 5h usage window.
|
|
85
|
+
# Generate at: https://opencode.ai/auth (sign in → Create API Key).
|
|
86
|
+
BKIT_OPENCODE_API_KEY=
|
|
87
|
+
|
|
88
|
+
# BKIT_OPENROUTER_API_KEY — OpenRouter API key. Used with `bkit install --opencode=openrouter`.
|
|
89
|
+
# One key → every model (incl. :free variants) via openrouter.ai/api/v1. Key format: sk-or-…
|
|
90
|
+
# Generate at: https://openrouter.ai/keys
|
|
91
|
+
BKIT_OPENROUTER_API_KEY=
|
|
92
|
+
|
|
93
|
+
# BKIT_OLLAMA_API_KEY — Ollama API key. Used with `bkit install --opencode=ollama`
|
|
94
|
+
# (ollama.com/v1). Generate at: https://ollama.com/settings/keys
|
|
95
|
+
BKIT_OLLAMA_API_KEY=
|
|
96
|
+
|
|
97
|
+
# BKIT_TAVILY_API_KEY — preferred example for the `context=web` context-fetch block in
|
|
98
|
+
# .agents/context.md. Swap that block for any search API that returns url + snippet;
|
|
99
|
+
# rename this key to match. No key → the example self-skips. Cloud: same name in
|
|
100
|
+
# the dashboard. Generate at: https://app.tavily.com
|
|
101
|
+
BKIT_TAVILY_API_KEY=
|
|
102
|
+
|
|
103
|
+
# Add your own secrets below. This file is what direnv exports into every local
|
|
104
|
+
# agent shell (`dotenv_if_exists .bkit/.env` in `.envrc`) and what `bkit install`
|
|
105
|
+
# copies into the cloud dashboard paste block — so a key here reaches `/bkit-debug`
|
|
106
|
+
# (and any other agent bash) locally, and the same name is waiting in the dashboard
|
|
107
|
+
# for headless runs. App env (`.env.local`, Vercel/Supabase) is NOT on that path
|
|
108
|
+
# unless you append another `dotenv_if_exists` in `.envrc`. Gitignored; never commit.
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
<!-- GENERATED by `bkit install --claude` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
|
|
2
|
+
|
|
3
|
+
# Claude Code Cloud Environment — {{PROJECT_NAME}}
|
|
4
|
+
|
|
5
|
+
> 🔐 **CONTAINS REAL SECRETS**, resolved from this repo's `.envrc`. This file is
|
|
6
|
+
> gitignored and holds live tokens — never commit or share it. The values only
|
|
7
|
+
> leave your machine when you paste them into claude.ai.
|
|
8
|
+
>
|
|
9
|
+
> Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
|
|
10
|
+
> permissions, auth flows, sharing across repos): `.bkit/cloud.md`.
|
|
11
|
+
|
|
12
|
+
Cloud sessions can't see your local direnv, user-level pnpm token, or GitHub
|
|
13
|
+
Actions secrets. Paste the blocks below into a new environment at claude.ai/code.
|
|
14
|
+
|
|
15
|
+
## 1 · Where
|
|
16
|
+
|
|
17
|
+
[claude.ai/code](https://claude.ai/code) → environment selector → **+ Add
|
|
18
|
+
environment** → name it **{{PROJECT_NAME}}** (one env per repo — secrets are
|
|
19
|
+
per-repo) → fill the fields below → **Save**.
|
|
20
|
+
|
|
21
|
+
## 2 · Network access
|
|
22
|
+
|
|
23
|
+
@@CLOUD_NETWORK_ALLOWLIST@@
|
|
24
|
+
|
|
25
|
+
## 3 · Environment variables
|
|
26
|
+
|
|
27
|
+
Paste into the **Environment variables** field (`.env` format, one `KEY=value`
|
|
28
|
+
per line):
|
|
29
|
+
|
|
30
|
+
```dotenv
|
|
31
|
+
@@CLOUD_ENV_VARS@@
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
@@CLOUD_ENV_NOTES@@
|
|
35
|
+
|
|
36
|
+
## 4 · Setup script
|
|
37
|
+
|
|
38
|
+
Paste into the **Setup script** field. Runs once as root before the first
|
|
39
|
+
session; the resulting filesystem is snapshotted and reused, so later sessions
|
|
40
|
+
start fast.
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
#!/bin/bash
|
|
44
|
+
@@CLOUD_CACHE_BUST@@
|
|
45
|
+
set -euo pipefail
|
|
46
|
+
|
|
47
|
+
VALE_VERSION="3.9.1"
|
|
48
|
+
if ! command -v vale >/dev/null 2>&1; then
|
|
49
|
+
cd /tmp
|
|
50
|
+
curl -fsSLO --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz"
|
|
51
|
+
tar -xzf "vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -C /usr/local/bin vale
|
|
52
|
+
chmod +x /usr/local/bin/vale
|
|
53
|
+
fi
|
|
54
|
+
|
|
55
|
+
if ! command -v gh >/dev/null 2>&1; then
|
|
56
|
+
cd /tmp
|
|
57
|
+
# Resolve the latest gh tag via the /releases/latest redirect, then download the
|
|
58
|
+
# binary — same github.com host + install style as vale above (a setup script is
|
|
59
|
+
# snapshotted once, so "latest" is fine and needs no pin). Reliable regardless of
|
|
60
|
+
# the base image's apt repos; `apt install gh` is not (gh isn't in default repos).
|
|
61
|
+
GH_VERSION=$(curl -fsSL -o /dev/null -w '%{url_effective}' "https://github.com/cli/cli/releases/latest" | sed -E 's#.*/tag/v##')
|
|
62
|
+
curl -fsSLO --retry 3 --retry-all-errors "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.tar.gz"
|
|
63
|
+
tar -xzf "gh_${GH_VERSION}_linux_amd64.tar.gz" -C /usr/local/bin --strip-components=2 "gh_${GH_VERSION}_linux_amd64/bin/gh"
|
|
64
|
+
chmod +x /usr/local/bin/gh
|
|
65
|
+
fi
|
|
66
|
+
|
|
67
|
+
if ! command -v jq >/dev/null 2>&1; then
|
|
68
|
+
# jq is a single static binary — fetch it from the jqlang release (same github.com
|
|
69
|
+
# host + snapshot-once rationale as vale/gh above). context-fetch blocks, including the
|
|
70
|
+
# .bkit/templates/context/ ones, pipe their output through `| jq …` and assume it is
|
|
71
|
+
# present; the base image may not ship it.
|
|
72
|
+
curl -fsSL --retry 3 --retry-all-errors "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64" -o /usr/local/bin/jq
|
|
73
|
+
chmod +x /usr/local/bin/jq
|
|
74
|
+
fi
|
|
75
|
+
|
|
76
|
+
@@CLOUD_WORKSPACE_TRUST@@
|
|
77
|
+
|
|
78
|
+
@@CLOUD_USER_SETTINGS@@
|
|
79
|
+
|
|
80
|
+
@@CLOUD_COREPACK@@
|
|
81
|
+
|
|
82
|
+
@@CLOUD_CONTEXT_FETCH_PROVISION@@
|
|
83
|
+
|
|
84
|
+
echo "cloud env ready: $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Keep total runtime under ~5 minutes or the snapshot won't build. `pnpm install`
|
|
88
|
+
and `vale sync` are **not** here — they belong in `.claude/hooks/bkit-cloud-bootstrap.sh`
|
|
89
|
+
(installed by `bkit install --auto=claude`) so they re-run on resumed sessions.
|
|
90
|
+
|
|
91
|
+
## 5 · Verify (first session)
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
vale --version && gh --version && jq --version && pnpm -v
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Then confirm workspace trust. Unset, Claude Code ignores every `permissions.allow`
|
|
98
|
+
row in `.claude/settings.json` and reports it on stderr only, where no cloud
|
|
99
|
+
session shows it:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
jq -r --arg p "$(git rev-parse --show-toplevel)" \
|
|
103
|
+
'.projects[$p].hasTrustDialogAccepted // "MISSING"' "${CLAUDE_CONFIG_DIR:-$HOME}/.claude.json"
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
`true` = allow rows apply. `MISSING` = this container clones to a different path
|
|
107
|
+
than the setup script baked in; `.claude/hooks/bkit-cloud-bootstrap.sh` warns each
|
|
108
|
+
session — re-paste the setup script to fix the snapshot.
|
|
109
|
+
|
|
110
|
+
Your `/bkit-*` skills and bkit subagents load automatically from the committed
|
|
111
|
+
`.claude/` mirror — nothing to configure for those.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
`BKIT_GH_TOKEN` fine-grained PAT permissions, the `gh auth login --with-token`
|
|
116
|
+
step, MCP OAuth flow, and the one-environment-per-repo rationale all live in
|
|
117
|
+
`.bkit/cloud.md` § Claude Code on the web.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json.schemastore.org/claude-code-settings.json",
|
|
3
|
+
"permissions": {
|
|
4
|
+
"allow": [
|
|
5
|
+
"Skill(*)",
|
|
6
|
+
"Bash(*)",
|
|
7
|
+
"mcp__github__*",
|
|
8
|
+
"mcp__claude_ai_Linear__*",
|
|
9
|
+
"WebSearch",
|
|
10
|
+
"Bash(git push --force-with-lease:*)",
|
|
11
|
+
"Read(./.env.example)",
|
|
12
|
+
"Read(./**/.env.example)"
|
|
13
|
+
],
|
|
14
|
+
"deny": [
|
|
15
|
+
"Bash(rm -rf /*)",
|
|
16
|
+
"Bash(rm -rf ~/*)",
|
|
17
|
+
"Bash(rm -rf $HOME/*)",
|
|
18
|
+
"Bash(chmod -R 777 /:*)",
|
|
19
|
+
"Bash(git push --force)",
|
|
20
|
+
"Bash(git push --force *)",
|
|
21
|
+
"Bash(git push -f)",
|
|
22
|
+
"Bash(git push -f *)",
|
|
23
|
+
"Read(./**/*.pem)",
|
|
24
|
+
"Read(./**/*.p12)",
|
|
25
|
+
"Read(./**/id_rsa)"
|
|
26
|
+
],
|
|
27
|
+
"ask": [
|
|
28
|
+
"Bash(sudo:*)",
|
|
29
|
+
"Bash(brew install:*)",
|
|
30
|
+
"Bash(pnpm publish:*)",
|
|
31
|
+
"Bash(npm publish:*)",
|
|
32
|
+
"Bash(bun publish:*)",
|
|
33
|
+
"Bash(git reset --hard:*)",
|
|
34
|
+
"Bash(git clean -fd:*)",
|
|
35
|
+
"Bash(git clean -fdx:*)",
|
|
36
|
+
"Bash(git filter-branch:*)",
|
|
37
|
+
"Bash(git checkout -- .:*)",
|
|
38
|
+
"Bash(git restore .:*)",
|
|
39
|
+
"Bash(git stash drop:*)",
|
|
40
|
+
"Bash(git rebase -i:*)",
|
|
41
|
+
"Bash(gh repo delete:*)",
|
|
42
|
+
"Bash(gh pr close:*)",
|
|
43
|
+
"Bash(gh release delete:*)",
|
|
44
|
+
"Read(./.env)",
|
|
45
|
+
"Read(./.env.*)",
|
|
46
|
+
"Read(./**/.env)",
|
|
47
|
+
"Read(./**/.env.*)",
|
|
48
|
+
"Read(./.bkit/.env)"
|
|
49
|
+
],
|
|
50
|
+
"defaultMode": "acceptEdits"
|
|
51
|
+
},
|
|
52
|
+
"hooks": {
|
|
53
|
+
"SessionStart": [
|
|
54
|
+
{
|
|
55
|
+
"hooks": [
|
|
56
|
+
{
|
|
57
|
+
"type": "command",
|
|
58
|
+
"command": "bash .claude/hooks/bkit-preflight.sh"
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"type": "command",
|
|
62
|
+
"command": "test -f .claude/hooks/bkit-cloud-bootstrap.sh && bash .claude/hooks/bkit-cloud-bootstrap.sh || true"
|
|
63
|
+
}
|
|
64
|
+
]
|
|
65
|
+
}
|
|
66
|
+
],
|
|
67
|
+
"PreToolUse": [
|
|
68
|
+
{
|
|
69
|
+
"matcher": "Edit|Write|MultiEdit",
|
|
70
|
+
"hooks": [
|
|
71
|
+
{
|
|
72
|
+
"type": "command",
|
|
73
|
+
"command": "test -f .claude/hooks/bkit-gateguard.cjs && node .claude/hooks/bkit-gateguard.cjs || true"
|
|
74
|
+
}
|
|
75
|
+
]
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"matcher": "Bash",
|
|
79
|
+
"hooks": [
|
|
80
|
+
{
|
|
81
|
+
"type": "command",
|
|
82
|
+
"command": "test -f .claude/hooks/bkit-guardrails.cjs && node .claude/hooks/bkit-guardrails.cjs || true"
|
|
83
|
+
}
|
|
84
|
+
]
|
|
85
|
+
}
|
|
86
|
+
]
|
|
87
|
+
}
|
|
88
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"PreToolUse": [
|
|
4
|
+
{
|
|
5
|
+
"matcher": "apply_patch",
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "test -f .codex/hooks/bkit-gateguard.cjs && node .codex/hooks/bkit-gateguard.cjs || true",
|
|
10
|
+
"statusMessage": "bkit GateGuard"
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"matcher": "Bash",
|
|
16
|
+
"hooks": [
|
|
17
|
+
{
|
|
18
|
+
"type": "command",
|
|
19
|
+
"command": "test -f .codex/hooks/bkit-guardrails.cjs && node .codex/hooks/bkit-guardrails.cjs || true",
|
|
20
|
+
"statusMessage": "bkit guardrails"
|
|
21
|
+
}
|
|
22
|
+
]
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
<!-- GENERATED by `bkit install --cursor` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
|
|
2
|
+
|
|
3
|
+
# Cursor Cloud Agent Environment — {{PROJECT_NAME}}
|
|
4
|
+
|
|
5
|
+
> 🔐 **CONTAINS REAL SECRETS**, resolved from this repo's `.envrc`. This file is
|
|
6
|
+
> gitignored and holds live tokens — never commit or share it. The values only
|
|
7
|
+
> leave your machine when you paste them into Cursor's dashboard.
|
|
8
|
+
>
|
|
9
|
+
> Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
|
|
10
|
+
> permissions, tracker dispatch, sharing across repos): `.bkit/cloud.md`.
|
|
11
|
+
|
|
12
|
+
This is the Cursor twin of `.claude/bkit-cloud.md`: the **same bkit cloud environment**,
|
|
13
|
+
built by a different mechanic. Cursor **Cloud Agents**
|
|
14
|
+
bake the toolchain (vale, gh, jq, python3, corepack pnpm) into `.cursor/Dockerfile`,
|
|
15
|
+
and run the per-snapshot install from `.cursor/environment.json` — both ship in the
|
|
16
|
+
repo, nothing to paste. The only thing you add in the dashboard is the **secrets**
|
|
17
|
+
below.
|
|
18
|
+
|
|
19
|
+
## 1 · Where
|
|
20
|
+
|
|
21
|
+
Cloud Agents dashboard → **https://cursor.com/dashboard/cloud-agents** → your
|
|
22
|
+
environment → **Secrets** tab. (Secrets are scoped per environment — one set does not
|
|
23
|
+
leak to another. See `.bkit/cloud.md` § Sharing across repos → Cursor.)
|
|
24
|
+
|
|
25
|
+
## 2 · Secrets
|
|
26
|
+
|
|
27
|
+
Add **each** line below as a secret (Name = the key, Value = the value). Set the
|
|
28
|
+
**type** per the rule below — for bkit's tokens use **Runtime Secret**:
|
|
29
|
+
|
|
30
|
+
- **Runtime Secret** — loaded into the agent's environment **but redacted from the
|
|
31
|
+
agent's transcript/commits**. Use this for every token below: MCP servers, `gh`,
|
|
32
|
+
`pnpm`, and `bkit-preflight.sh` read them from the process env, while the agent never
|
|
33
|
+
sees the raw value. (Still visible to a human in the Terminal — that's expected.)
|
|
34
|
+
- **Environment Variable** — visible to the agent; only for non-secret config.
|
|
35
|
+
- **Build Secret** — Docker-build-time only; not needed unless you move the
|
|
36
|
+
`pnpm` auth into the Dockerfile (bkit runs it in `environment.json` `install`).
|
|
37
|
+
|
|
38
|
+
```dotenv
|
|
39
|
+
@@CLOUD_ENV_VARS@@
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
@@CLOUD_ENV_NOTES@@
|
|
43
|
+
|
|
44
|
+
- `LINEAR_ISSUE_ID` (Linear tracker) / `GITHUB_ISSUE_ID` (GitHub tracker) are injected
|
|
45
|
+
**per session** by the Cursor integration — do **not** add them here.
|
|
46
|
+
- `BKIT_GH_TOKEN` fine-grained PAT permissions are documented in `.bkit/cloud.md`
|
|
47
|
+
§ BKIT_GH_TOKEN permissions (identical scope to the Claude side).
|
|
48
|
+
- Secrets are encrypted at rest and in transit and scoped to the environment.
|
|
49
|
+
|
|
50
|
+
## 3 · Toolchain (in-repo — nothing to paste)
|
|
51
|
+
|
|
52
|
+
The base image bakes the **same tools at the same versions as the Claude setup
|
|
53
|
+
script** — vale 3.9.1, gh, jq, python3, corepack-pinned pnpm — so both clouds run an
|
|
54
|
+
identical bkit toolchain:
|
|
55
|
+
|
|
56
|
+
- `.cursor/Dockerfile` — image build, your copy of the template (keep its
|
|
57
|
+
`bkit toolchain` section as shipped; set Node major / Playwright / extra apt deps
|
|
58
|
+
outside it).
|
|
59
|
+
- `.cursor/environment.json` — per-snapshot `install` (`pnpm install
|
|
60
|
+
--frozen-lockfile` + `vale sync`), the analogue of Claude's
|
|
61
|
+
`.claude/hooks/bkit-cloud-bootstrap.sh`. (`install` / `start` / `terminals` are the
|
|
62
|
+
environment.json fields Cursor runs.)
|
|
63
|
+
|
|
64
|
+
After changing either, run `pnpm bkit install` and commit — the first session
|
|
65
|
+
rebuilds the image; later sessions reuse cached layers.
|
|
66
|
+
|
|
67
|
+
## 4 · Network access
|
|
68
|
+
|
|
69
|
+
@@CURSOR_NETWORK@@
|
|
70
|
+
@@CURSOR_CONTEXT_FETCH@@
|
|
71
|
+
## 5 · Verify (first session)
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
vale --version && gh --version && jq --version && pnpm -v && python3 --version
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Your `/bkit-*` commands and bkit subagents load automatically from the committed
|
|
78
|
+
`.cursor/` mirror — nothing to configure for those.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
Tracker dispatch (Linear `@cursor` mention / GitHub PR-label automation), the
|
|
83
|
+
`BKIT_GH_TOKEN` PAT permission table, and the one-environment-per-repo rationale all
|
|
84
|
+
live in `.bkit/cloud.md` § Cursor Cloud Agents.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 1,
|
|
3
|
+
"hooks": {
|
|
4
|
+
"sessionStart": [
|
|
5
|
+
{ "command": ".cursor/hooks/bkit-preflight.sh", "failClosed": true }
|
|
6
|
+
],
|
|
7
|
+
"sessionStop": [{ "command": "echo '[bkit] session stopped'" }],
|
|
8
|
+
"beforeShellExecution": [
|
|
9
|
+
{
|
|
10
|
+
"command": "node .cursor/hooks/bkit-guardrails.cjs",
|
|
11
|
+
"failClosed": true
|
|
12
|
+
}
|
|
13
|
+
],
|
|
14
|
+
"preToolUse": [
|
|
15
|
+
{
|
|
16
|
+
"command": "node .cursor/hooks/bkit-guardrails.cjs",
|
|
17
|
+
"matcher": "Read|TabRead",
|
|
18
|
+
"failClosed": true
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"command": "node .cursor/hooks/bkit-gateguard.cjs",
|
|
22
|
+
"matcher": "Write"
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"linear": {
|
|
4
|
+
"type": "http",
|
|
5
|
+
"url": "https://mcp.linear.app/mcp"
|
|
6
|
+
},
|
|
7
|
+
"github": {
|
|
8
|
+
"type": "http",
|
|
9
|
+
"url": "https://api.githubcopilot.com/mcp/",
|
|
10
|
+
"headers": {
|
|
11
|
+
"Authorization": "Bearer ${BKIT_GH_TOKEN}"
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# <!-- bkit:start -->
|
|
2
|
+
|
|
3
|
+
# {{BKIT_MANAGED_MARKER}}
|
|
4
|
+
|
|
5
|
+
# Append-only ledgers: union merge auto-concatenates both sides on conflict.
|
|
6
|
+
# EVERY ledger bkit workflows append to is listed — one left out blocks a merge
|
|
7
|
+
# over data that never conflicted, two branches having simply appended different
|
|
8
|
+
# rows. JSONL rows dedupe by identity tuple (kind, repo, key); union may interleave
|
|
9
|
+
# or duplicate lines, resolved by the reader — never a blocking merge conflict.
|
|
10
|
+
#
|
|
11
|
+
# Union makes append-only LOAD-BEARING, not a convention. It keeps both sides of a
|
|
12
|
+
# conflicting hunk, so editing a row in place leaves the stale copy alive beside its
|
|
13
|
+
# replacement — and the reader folds last-wins by `ts`, so the stale row wins
|
|
14
|
+
# whenever its `ts` is the later one. Correct a row by APPENDING one with the same
|
|
15
|
+
# `key` and a CURRENT `ts`; never edit or delete a line, and never write a future
|
|
16
|
+
# `ts` (it outranks every correction that follows it, permanently).
|
|
17
|
+
docs/knowledge.jsonl merge=union
|
|
18
|
+
docs/decisions.jsonl merge=union
|
|
19
|
+
docs/deferrals.jsonl merge=union
|
|
20
|
+
docs/failures.jsonl merge=union
|
|
21
|
+
.bkit/issues.jsonl merge=union
|
|
22
|
+
docs/roadmap.md merge=union
|
|
23
|
+
.bkit/stats.jsonl merge=union
|
|
24
|
+
|
|
25
|
+
# `.bkit/friction.jsonl` is deliberately absent: it is the one ledger rows are
|
|
26
|
+
# REMOVED from (`bkit harvest` drains it). Union would resurrect rows a drain
|
|
27
|
+
# deleted, so a conflict there carries real information and must stay blocking.
|
|
28
|
+
|
|
29
|
+
# Append-only NDJSON workflow status logs: union auto-concatenates both branches'
|
|
30
|
+
# appended lines server-side so a per-FID status log never blocks a merge.
|
|
31
|
+
# Safe iff strictly append-only (prior lines never mutated); the reader folds + dedupes
|
|
32
|
+
# by (workflow, step, parentSha, at) and orders by `at`, tolerating interleave/duplication.
|
|
33
|
+
# Scoped to bkit's status files only — NOT a blanket *.jsonl (union would corrupt a
|
|
34
|
+
# consumer's non-append-only .jsonl data on merge).
|
|
35
|
+
docs/plans/**/status.jsonl merge=union
|
|
36
|
+
|
|
37
|
+
# <!-- bkit:end -->
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"linear": {
|
|
4
|
+
"type": "http",
|
|
5
|
+
"url": "https://mcp.linear.app/mcp"
|
|
6
|
+
},
|
|
7
|
+
"github": {
|
|
8
|
+
"type": "http",
|
|
9
|
+
"url": "https://api.githubcopilot.com/mcp/",
|
|
10
|
+
"headers": {
|
|
11
|
+
"Authorization": "Bearer ${BKIT_GH_TOKEN}",
|
|
12
|
+
"X-MCP-Toolsets": "context,issues,pull_requests,repos,users,projects,actions"
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://opencode.ai/config.json",
|
|
3
|
+
"permission": {
|
|
4
|
+
"read": {
|
|
5
|
+
"*": "allow",
|
|
6
|
+
"*.env": "ask",
|
|
7
|
+
"*.env.*": "ask",
|
|
8
|
+
"*.env.example": "allow",
|
|
9
|
+
"*.pem": "deny",
|
|
10
|
+
"*.p12": "deny",
|
|
11
|
+
"*id_rsa": "deny"
|
|
12
|
+
},
|
|
13
|
+
"edit": "allow",
|
|
14
|
+
"grep": "allow",
|
|
15
|
+
"glob": "allow",
|
|
16
|
+
"task": "allow",
|
|
17
|
+
"websearch": "allow",
|
|
18
|
+
"webfetch": "ask",
|
|
19
|
+
"bash": {
|
|
20
|
+
"*": "allow",
|
|
21
|
+
"sudo *": "ask",
|
|
22
|
+
"brew install*": "ask",
|
|
23
|
+
"pnpm publish*": "ask",
|
|
24
|
+
"npm publish*": "ask",
|
|
25
|
+
"bun publish*": "ask",
|
|
26
|
+
"curl *": "ask",
|
|
27
|
+
"wget *": "ask",
|
|
28
|
+
"git reset --hard*": "ask",
|
|
29
|
+
"git clean -fd*": "ask",
|
|
30
|
+
"git clean -fdx*": "ask",
|
|
31
|
+
"git filter-branch*": "ask",
|
|
32
|
+
"git checkout -- .*": "ask",
|
|
33
|
+
"git restore .*": "ask",
|
|
34
|
+
"git stash drop*": "ask",
|
|
35
|
+
"git rebase -i*": "ask",
|
|
36
|
+
"gh repo delete*": "ask",
|
|
37
|
+
"gh pr close*": "ask",
|
|
38
|
+
"gh release delete*": "ask",
|
|
39
|
+
"chmod -R 777 /*": "deny",
|
|
40
|
+
"rm -rf /*": "deny",
|
|
41
|
+
"rm -rf ~/*": "deny",
|
|
42
|
+
"rm -rf $HOME/*": "deny",
|
|
43
|
+
"git push --force*": "deny",
|
|
44
|
+
"git push -f*": "deny",
|
|
45
|
+
"git push --force-with-lease*": "allow"
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"mcp": {
|
|
49
|
+
"@@OPENCODE_TRACKER_MCP@@": {}
|
|
50
|
+
},
|
|
51
|
+
"plugin": ["./plugin/bkit-gateguard.js"],
|
|
52
|
+
"provider": {
|
|
53
|
+
"@@OPENCODE_PROVIDER_KEY@@": {
|
|
54
|
+
"npm": "@ai-sdk/openai-compatible",
|
|
55
|
+
"name": "@@OPENCODE_PROVIDER_KEY@@",
|
|
56
|
+
"options": {
|
|
57
|
+
"baseURL": "@@OPENCODE_PROVIDER_BASE_URL@@",
|
|
58
|
+
"apiKey": "{env:@@OPENCODE_PROVIDER_ENV_VAR@@}"
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# CLAUDE.md
|
|
2
|
+
|
|
3
|
+
<!-- bkit:start -->
|
|
4
|
+
|
|
5
|
+
{{BKIT_MANAGED_MARKER}}
|
|
6
|
+
|
|
7
|
+
- **Rules:** Read `.agents/rules.md` → FOLLOW ALL rules.
|
|
8
|
+
|
|
9
|
+
**Memory hygiene:** Claude Code auto-memories (`MEMORY.md` + `memory/*.md`) are POINTERS, never copies. Facts in `docs/*.md`, `.agents/rules.md`, or `CLAUDE.md` → ONLY save path, section, and one-line hook. Issue states → query tracker or `docs/roadmap.md`; NEVER snapshot into memory.
|
|
10
|
+
|
|
11
|
+
<!-- bkit:end -->
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Licence for `.bkit/shared/`
|
|
2
|
+
|
|
3
|
+
Everything in this folder is licensed under the MIT No Attribution License (MIT-0) below. You can use, copy, change and share these files for any purpose, without keeping this notice.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
MIT No Attribution
|
|
8
|
+
|
|
9
|
+
Copyright 2026 Christian Bartens
|
|
10
|
+
|
|
11
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this
|
|
12
|
+
software and associated documentation files (the "Software"), to deal in the Software
|
|
13
|
+
without restriction, including without limitation the rights to use, copy, modify,
|
|
14
|
+
merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
|
|
15
|
+
permit persons to whom the Software is furnished to do so.
|
|
16
|
+
|
|
17
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
|
|
18
|
+
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
|
|
19
|
+
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
|
20
|
+
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
21
|
+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
22
|
+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
<!-- bkit:start -->
|
|
2
|
+
|
|
3
|
+
{{BKIT_MANAGED_MARKER}}
|
|
4
|
+
|
|
5
|
+
# Architecture
|
|
6
|
+
|
|
7
|
+
> [!CAUTION]
|
|
8
|
+
> **Purpose:** System design — service boundaries, deployment topology, integration sketch.
|
|
9
|
+
>
|
|
10
|
+
> **Rules:**
|
|
11
|
+
>
|
|
12
|
+
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
13
|
+
> - Notation: one job per mark — `.bkit/prompts.md` § `Notation`.
|
|
14
|
+
> - Describe current state / rules, not reasons / history; state what to do, not why.
|
|
15
|
+
> - Check `.agents/docs.md` index first and confirm topic belongs in this doc, not another.
|
|
16
|
+
> - Topology / boundaries only; operational rules and library lists → domain docs.
|
|
17
|
+
> - Update on package add / remove or boundary shift.
|
|
18
|
+
|
|
19
|
+
<!-- bkit:end -->
|