@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,220 @@
|
|
|
1
|
+
// bkit repo info|preflight — the repo facts every phase workflow's Step 1 derives,
|
|
2
|
+
// and the advisory dispatch-permission preflight ship's Step 1 runs.
|
|
3
|
+
//
|
|
4
|
+
// `owner/repo` comes from `gh repo view`; when gh is missing, unauthed, or
|
|
5
|
+
// answers nothing, from the `origin` remote URL instead (the MCP fallback the
|
|
6
|
+
// workflows already describe: "parse git remote"). The current branch, how far it
|
|
7
|
+
// trails `origin/dev`, the main checkout, and the bkit binary every later block
|
|
8
|
+
// calls ride along so Step 1 is one call.
|
|
9
|
+
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
|
|
13
|
+
import { parseRemoteUrlToSlug } from "../../ledgers/telemetry.js";
|
|
14
|
+
import { EXIT, git, repoRoot, runGit, runTool, type CommandSpec } from "../lib.js";
|
|
15
|
+
|
|
16
|
+
/** Exit code: neither gh nor the origin remote named an owner/repo. */
|
|
17
|
+
export const EXIT_NO_REPO = 3;
|
|
18
|
+
/** Exit code: HEAD is detached, so there is no current branch (and --allow-detached was not given). */
|
|
19
|
+
export const EXIT_DETACHED = 4;
|
|
20
|
+
|
|
21
|
+
/** `owner/repo` split once, or null unless both halves are non-empty and there is exactly one slash. */
|
|
22
|
+
export function splitSlug(slug: string): { owner: string; repo: string } | null {
|
|
23
|
+
const m = /^([^/\s]+)\/([^/\s]+)$/.exec(slug.trim());
|
|
24
|
+
return m ? { owner: m[1]!, repo: m[2]! } : null;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** `owner/repo` from gh, else the origin remote. */
|
|
28
|
+
export function resolveOwnerRepo(
|
|
29
|
+
cwd: string,
|
|
30
|
+
): { ownerRepo: string; source: "gh" | "remote" } | null {
|
|
31
|
+
const gh = runTool(
|
|
32
|
+
"gh",
|
|
33
|
+
["repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"],
|
|
34
|
+
cwd,
|
|
35
|
+
);
|
|
36
|
+
if (gh.status === 0 && splitSlug(gh.stdout)) return { ownerRepo: gh.stdout.trim(), source: "gh" };
|
|
37
|
+
const url = git(cwd, ["remote", "get-url", "origin"]);
|
|
38
|
+
const slug = url ? parseRemoteUrlToSlug(url) : "";
|
|
39
|
+
return splitSlug(slug) ? { ownerRepo: slug, source: "remote" } : null;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* How far HEAD trails `origin/dev`, from whatever was last fetched. null when
|
|
44
|
+
* `origin/dev` is not known locally: "0 behind" there would be a false claim.
|
|
45
|
+
*/
|
|
46
|
+
export function behindDev(cwd: string): { behindDev: number | null; divergedAgo: string | null } {
|
|
47
|
+
const behind = git(cwd, ["rev-list", "--count", "HEAD..origin/dev"]);
|
|
48
|
+
if (behind === null) return { behindDev: null, divergedAgo: null };
|
|
49
|
+
const mb = git(cwd, ["merge-base", "HEAD", "origin/dev"]);
|
|
50
|
+
const ago = mb ? git(cwd, ["show", "-s", "--format=%ar", mb]) : null;
|
|
51
|
+
return { behindDev: Number(behind), divergedAgo: ago || null };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* The bkit binary every later block calls: the repo-pinned one first — it matches
|
|
56
|
+
* the version this repo installed — else `bkit` on PATH (a checkout whose
|
|
57
|
+
* node_modules was pruned, or a globally installed bkit). The pinned path is
|
|
58
|
+
* returned even when nothing exists, so the failure names the expected location.
|
|
59
|
+
*/
|
|
60
|
+
export function resolveBkitBinary(root: string): string {
|
|
61
|
+
const pinned = path.join(root, "node_modules", ".bin", "bkit");
|
|
62
|
+
if (fs.existsSync(pinned)) return pinned;
|
|
63
|
+
for (const dir of (process.env.PATH ?? "").split(path.delimiter)) {
|
|
64
|
+
if (dir === "") continue;
|
|
65
|
+
const candidate = path.join(dir, "bkit");
|
|
66
|
+
try {
|
|
67
|
+
fs.accessSync(candidate, fs.constants.X_OK);
|
|
68
|
+
return candidate;
|
|
69
|
+
} catch {
|
|
70
|
+
// keep looking
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return pinned;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* The Step 1 dispatch-permission preflight: can `gh` read this repo's Actions
|
|
78
|
+
* permissions? Advisory only — a false just warns that `gh workflow run` may 403;
|
|
79
|
+
* it never stops the run. gh missing or unauthed is not an error (the runtime row
|
|
80
|
+
* already recorded `runtimeGithubCli`, and the workflow falls back to MCP).
|
|
81
|
+
*/
|
|
82
|
+
export function actionsPermissionsReadable(
|
|
83
|
+
cwd: string,
|
|
84
|
+
ownerRepo: string,
|
|
85
|
+
): { readable: boolean; status: number; detail: string } {
|
|
86
|
+
const res = runTool("gh", ["api", `repos/${ownerRepo}/actions/permissions`], cwd);
|
|
87
|
+
const detail =
|
|
88
|
+
res.stderr
|
|
89
|
+
.split("\n")
|
|
90
|
+
.filter((l) => l.trim() !== "")
|
|
91
|
+
.at(-1) ?? "";
|
|
92
|
+
return { readable: res.found && res.status === 0, status: res.status, detail };
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export const repoCommand: CommandSpec = {
|
|
96
|
+
noun: "repo",
|
|
97
|
+
summary: "Repo facts for Step 1: owner/repo, current branch, and how far it trails dev.",
|
|
98
|
+
verbs: {
|
|
99
|
+
info: {
|
|
100
|
+
summary:
|
|
101
|
+
"owner/repo (gh, else the origin remote), the current branch, and commits behind origin/dev.",
|
|
102
|
+
flags: [
|
|
103
|
+
{
|
|
104
|
+
name: "fetch",
|
|
105
|
+
type: "boolean",
|
|
106
|
+
help: "git fetch origin dev first, so behindDev is current (a failed fetch is logged, not fatal)",
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
name: "allow-detached",
|
|
110
|
+
type: "boolean",
|
|
111
|
+
help: "a detached HEAD is not an error: branch is null (CI checkouts)",
|
|
112
|
+
},
|
|
113
|
+
],
|
|
114
|
+
output: {
|
|
115
|
+
ownerRepo: "owner/repo",
|
|
116
|
+
owner: "owner half",
|
|
117
|
+
repo: "repo half",
|
|
118
|
+
source: "gh | remote — where ownerRepo came from",
|
|
119
|
+
branch: "current branch (null on a detached HEAD)",
|
|
120
|
+
behindDev: "commits on origin/dev not in HEAD (null when origin/dev is unknown locally)",
|
|
121
|
+
divergedAgo: "age of the merge-base with origin/dev, e.g. '3 days ago' (null when unknown)",
|
|
122
|
+
repoRoot: "the main checkout (the same from any worktree)",
|
|
123
|
+
bkit: "the bkit binary the workflow blocks call: <repoRoot>/node_modules/.bin/bkit, else `bkit` on PATH",
|
|
124
|
+
outboxRoot: "<git common dir>/bkit-outbox: per-run scratch files, never committed",
|
|
125
|
+
},
|
|
126
|
+
exitCodes: {
|
|
127
|
+
[EXIT_NO_REPO]: "neither gh nor the origin remote named an owner/repo",
|
|
128
|
+
[EXIT_DETACHED]: "detached HEAD and no --allow-detached: there is no branch to work on",
|
|
129
|
+
},
|
|
130
|
+
run: (ctx) => {
|
|
131
|
+
if (ctx.flags.fetch === true) {
|
|
132
|
+
const res = runGit(ctx.cwd, ["fetch", "origin", "dev"]);
|
|
133
|
+
if (!res.ok)
|
|
134
|
+
ctx.log(
|
|
135
|
+
`git fetch origin dev failed — behindDev is as of the last fetch: ${res.stderr}`,
|
|
136
|
+
);
|
|
137
|
+
}
|
|
138
|
+
const resolved = resolveOwnerRepo(ctx.cwd);
|
|
139
|
+
if (!resolved) {
|
|
140
|
+
ctx.log(
|
|
141
|
+
"could not resolve owner/repo: gh repo view failed and the origin remote is missing or unparseable",
|
|
142
|
+
);
|
|
143
|
+
return EXIT_NO_REPO;
|
|
144
|
+
}
|
|
145
|
+
if (resolved.source === "remote")
|
|
146
|
+
ctx.log("gh unavailable — owner/repo parsed from the origin remote");
|
|
147
|
+
const { owner, repo } = splitSlug(resolved.ownerRepo)!;
|
|
148
|
+
const branch = git(ctx.cwd, ["branch", "--show-current"]) || null;
|
|
149
|
+
const behind = behindDev(ctx.cwd);
|
|
150
|
+
if (behind.behindDev === null) {
|
|
151
|
+
ctx.log("origin/dev not found locally — cannot say how far this branch trails dev");
|
|
152
|
+
} else {
|
|
153
|
+
ctx.log(
|
|
154
|
+
`branch is ${behind.behindDev} commits behind dev / ${behind.divergedAgo ?? "unknown"} since divergence`,
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
const root = repoRoot(ctx.cwd);
|
|
158
|
+
const common = git(ctx.cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
|
|
159
|
+
ctx.emit({
|
|
160
|
+
...resolved,
|
|
161
|
+
owner,
|
|
162
|
+
repo,
|
|
163
|
+
branch,
|
|
164
|
+
...behind,
|
|
165
|
+
repoRoot: root,
|
|
166
|
+
bkit: resolveBkitBinary(root),
|
|
167
|
+
outboxRoot: path.join(common ?? path.join(root, ".git"), "bkit-outbox"),
|
|
168
|
+
});
|
|
169
|
+
if (branch === null && ctx.flags.allowDetached !== true) {
|
|
170
|
+
ctx.log("HEAD is detached — no current branch");
|
|
171
|
+
return EXIT_DETACHED;
|
|
172
|
+
}
|
|
173
|
+
return EXIT.OK;
|
|
174
|
+
},
|
|
175
|
+
},
|
|
176
|
+
preflight: {
|
|
177
|
+
summary:
|
|
178
|
+
"Advisory: whether gh can read the repo's Actions permissions (dispatch may 403 without them).",
|
|
179
|
+
flags: [
|
|
180
|
+
{
|
|
181
|
+
name: "owner-repo",
|
|
182
|
+
type: "string",
|
|
183
|
+
help: "owner/repo to check (default: resolved from gh, else the origin remote)",
|
|
184
|
+
},
|
|
185
|
+
],
|
|
186
|
+
output: {
|
|
187
|
+
ownerRepo: "owner/repo checked",
|
|
188
|
+
actionsPermissionsReadable: "gh could read repos/<owner>/<repo>/actions/permissions",
|
|
189
|
+
status: "the gh api exit code (127 when gh is not on PATH)",
|
|
190
|
+
warning: "an advisory line when the read failed, else null",
|
|
191
|
+
},
|
|
192
|
+
exitCodes: {
|
|
193
|
+
[EXIT_NO_REPO]: "neither --owner-repo, gh, nor the origin remote named an owner/repo",
|
|
194
|
+
},
|
|
195
|
+
run: (ctx) => {
|
|
196
|
+
const given = typeof ctx.flags.ownerRepo === "string" ? ctx.flags.ownerRepo.trim() : "";
|
|
197
|
+
const resolved = given !== "" ? splitSlug(given) : null;
|
|
198
|
+
const ownerRepo =
|
|
199
|
+
given !== "" ? (resolved ? given : null) : (resolveOwnerRepo(ctx.cwd)?.ownerRepo ?? null);
|
|
200
|
+
if (ownerRepo === null) {
|
|
201
|
+
ctx.log("could not resolve owner/repo for the dispatch preflight");
|
|
202
|
+
return EXIT_NO_REPO;
|
|
203
|
+
}
|
|
204
|
+
const r = actionsPermissionsReadable(ctx.cwd, ownerRepo);
|
|
205
|
+
const detail = r.detail ? `: ${r.detail}` : "";
|
|
206
|
+
const warning = r.readable
|
|
207
|
+
? null
|
|
208
|
+
: `actions:write preflight — gh could not read repos/${ownerRepo}/actions/permissions (exit ${String(r.status)}${detail}); gh workflow run may 403`;
|
|
209
|
+
if (warning) ctx.log(warning);
|
|
210
|
+
ctx.emit({
|
|
211
|
+
ownerRepo,
|
|
212
|
+
actionsPermissionsReadable: r.readable,
|
|
213
|
+
status: r.status,
|
|
214
|
+
warning,
|
|
215
|
+
});
|
|
216
|
+
return EXIT.OK;
|
|
217
|
+
},
|
|
218
|
+
},
|
|
219
|
+
},
|
|
220
|
+
};
|