@cbartens/bkit 0.0.0-stage → 5.0.1
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 +417 -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 +417 -0
- package/.bkit/core/.bkit/cloud.md +493 -0
- package/.bkit/core/.bkit/comparison.md +321 -0
- package/.bkit/core/.bkit/install.md +401 -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 +470 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1550 -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 +149 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +530 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/suppression.ts +53 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +187 -0
- package/.bkit/core/engine/checks/before/files.ts +204 -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 +867 -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 +254 -0
- package/.bkit/core/engine/commands/install/install.ts +550 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +495 -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 +924 -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 +173 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +620 -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/payload-links.ts +150 -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 +649 -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 +86 -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 +433 -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 +97 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -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 +224 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -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 +1503 -0
- package/LICENSE.md +161 -0
- package/README.md +184 -2
- package/dist/checks/after/auth.js +140 -0
- package/dist/checks/after/ci-yml.js +681 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +431 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/suppression.js +39 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +163 -0
- package/dist/checks/before/files.js +187 -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 +688 -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 +209 -0
- package/dist/commands/install/install.js +475 -0
- package/dist/commands/install/uninstall.js +839 -0
- package/dist/commands/install/upgrade.js +782 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +363 -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 +818 -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 +151 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +531 -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/payload-links.js +119 -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,219 @@
|
|
|
1
|
+
// install/modules/codex.ts — the codex host module: `.codex/` agents and skills.
|
|
2
|
+
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { writeTier2, writeTier2JsonContained, ensureDir } from "../write.js";
|
|
6
|
+
import { managedVersionMarker, stampManagedVersion } from "../version-file.js";
|
|
7
|
+
import { applyCodexAgent, parseFrontmatter } from "../../render/hosts.js";
|
|
8
|
+
import {
|
|
9
|
+
getCoreRoot,
|
|
10
|
+
getSharedRoot,
|
|
11
|
+
getWorkflowsRoot,
|
|
12
|
+
getPromptsRoot,
|
|
13
|
+
} from "../../shared/package-roots.js";
|
|
14
|
+
import { type IssueTracker, DEFAULT_ISSUE_TRACKER } from "../manifest.js";
|
|
15
|
+
import { substituteWorkflow } from "../../render/trackers.js";
|
|
16
|
+
import type { ModuleContext } from "./index.js";
|
|
17
|
+
import {
|
|
18
|
+
BKIT_PREFIX,
|
|
19
|
+
installFile,
|
|
20
|
+
listMdFiles,
|
|
21
|
+
readInstallingVersion,
|
|
22
|
+
trackMirrorWrite,
|
|
23
|
+
} from "./core.js";
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Convert a workflow orchestrator (`.bkit/core/workflows/*.md`) into a Codex SKILL.md.
|
|
27
|
+
*
|
|
28
|
+
* Codex requires `name` and `description` in the skill frontmatter; the workflows already
|
|
29
|
+
* carry `description`, so `name` is added and the body is kept verbatim (it is the whole
|
|
30
|
+
* point — the workflow steps ARE the skill instructions). Tracker-conditional blocks are
|
|
31
|
+
* resolved first, exactly as for the other hosts' command mirrors.
|
|
32
|
+
*/
|
|
33
|
+
export function applyCodexSkill(
|
|
34
|
+
content: string,
|
|
35
|
+
skillName: string,
|
|
36
|
+
issueTracker: IssueTracker,
|
|
37
|
+
): string {
|
|
38
|
+
const resolved = substituteWorkflow(content, issueTracker).output;
|
|
39
|
+
const fmMatch = resolved.match(/^(---\r?\n)([\s\S]*?)(\r?\n---\r?\n?)/);
|
|
40
|
+
if (!fmMatch) {
|
|
41
|
+
return `---\nname: ${skillName}\ndescription: bkit ${skillName} workflow\n---\n\n${resolved}`;
|
|
42
|
+
}
|
|
43
|
+
const fmBlock = fmMatch[2];
|
|
44
|
+
const body = resolved.slice(fmMatch[0].length);
|
|
45
|
+
const parsed = parseFrontmatter(fmBlock);
|
|
46
|
+
const description = (parsed.get("description") ?? `bkit ${skillName} workflow`).replace(
|
|
47
|
+
/^"|"$/g,
|
|
48
|
+
"",
|
|
49
|
+
);
|
|
50
|
+
return `---\nname: ${skillName}\ndescription: "${description.replace(/"/g, '\\"')}"\n---\n${body}`;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
// ---------------------------------------------------------------------------
|
|
54
|
+
// runCodexModule — Codex CLI host (opt-in via --codex)
|
|
55
|
+
//
|
|
56
|
+
// Nullary flag, unlike --opencode: Codex has exactly one gateway (`openai`).
|
|
57
|
+
//
|
|
58
|
+
// Renders THREE things, two of them unlike any other host:
|
|
59
|
+
// .codex/agents/<name>.toml — TOML, not markdown-with-frontmatter
|
|
60
|
+
// .codex/hooks.json + hooks/ — GateGuard registration (PreToolUse / apply_patch)
|
|
61
|
+
// .agents/skills/bkit-<wf>/SKILL.md — workflow entry points, as SKILLS not commands
|
|
62
|
+
//
|
|
63
|
+
// Skills: Codex has NO project-scoped command surface (custom prompts live only in
|
|
64
|
+
// ~/.codex/prompts). Codex's skill search path INCLUDES `$REPO_ROOT/.agents/skills`.
|
|
65
|
+
// Workflows are invoked `$bkit-design` on Codex, not `/bkit-design`, and the skills are
|
|
66
|
+
// visible to every host.
|
|
67
|
+
//
|
|
68
|
+
// NOTE there is no `.codex/config.toml`: `openai` is a RESERVED built-in provider id in
|
|
69
|
+
// Codex; re-stating it is rejected.
|
|
70
|
+
// ---------------------------------------------------------------------------
|
|
71
|
+
|
|
72
|
+
/** Directory holding bkit-generated workflow skills, shared across hosts. */
|
|
73
|
+
export const CODEX_SKILLS_DIR = ".agents/skills";
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Render `.codex/agents/*.toml` and the workflow skills. Extracted so `bkit upgrade`
|
|
77
|
+
* re-renders them identically — bkit-owned output, force-overwritten.
|
|
78
|
+
*/
|
|
79
|
+
export function renderCodexAgentsSkills(ctx: ModuleContext): string[] {
|
|
80
|
+
const { dryRun, effortMap, logPrefix } = ctx;
|
|
81
|
+
const tag = dryRun ? "[dry-run] " : "";
|
|
82
|
+
const issueTracker = ctx.issueTracker ?? DEFAULT_ISSUE_TRACKER;
|
|
83
|
+
const version = ctx.version ?? readInstallingVersion();
|
|
84
|
+
const written: string[] = [];
|
|
85
|
+
const codexModelLookup = ctx.codexModelLookup;
|
|
86
|
+
if (!codexModelLookup) {
|
|
87
|
+
throw new Error("renderCodexAgentsSkills: ctx.codexModelLookup is required");
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// --- Agents: markdown+frontmatter -> TOML, managed-version marker as the first line ---
|
|
91
|
+
{
|
|
92
|
+
const src = getPromptsRoot();
|
|
93
|
+
const dest = ".codex/agents";
|
|
94
|
+
if (!dryRun) ensureDir(dest);
|
|
95
|
+
const files = listMdFiles(src, BKIT_PREFIX);
|
|
96
|
+
// Destination basenames are .toml, so the orphan sweep has to compare on stem.
|
|
97
|
+
const sourceStems = new Set(files.map((f) => f.replace(/\.md$/, "")));
|
|
98
|
+
|
|
99
|
+
for (const f of files) {
|
|
100
|
+
const stem = f.replace(/\.md$/, "");
|
|
101
|
+
const transform = (c: string) =>
|
|
102
|
+
`${managedVersionMarker(version, "hash")}\n` +
|
|
103
|
+
applyCodexAgent(substituteWorkflow(c, issueTracker).output, codexModelLookup, effortMap);
|
|
104
|
+
if (installFile(path.join(src, f), path.join(dest, `${stem}.toml`), transform, dryRun)) {
|
|
105
|
+
const rel = path.join(dest, `${stem}.toml`);
|
|
106
|
+
console.log(`${logPrefix} ${tag}write: ${rel}`);
|
|
107
|
+
trackMirrorWrite(ctx, rel, written);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
if (fs.existsSync(dest)) {
|
|
112
|
+
for (const f of fs.readdirSync(dest)) {
|
|
113
|
+
if (!f.endsWith(".toml")) continue;
|
|
114
|
+
if (!f.startsWith(BKIT_PREFIX)) continue;
|
|
115
|
+
if (!sourceStems.has(f.replace(/\.toml$/, ""))) {
|
|
116
|
+
const rel = path.join(dest, f);
|
|
117
|
+
if (!dryRun) fs.rmSync(path.join(dest, f));
|
|
118
|
+
console.log(`${logPrefix} ${tag}delete orphan: ${rel}`);
|
|
119
|
+
trackMirrorWrite(ctx, rel, written);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// --- Workflow skills: one directory per workflow, each holding SKILL.md ---
|
|
126
|
+
{
|
|
127
|
+
const src = getWorkflowsRoot();
|
|
128
|
+
const files = listMdFiles(src, BKIT_PREFIX);
|
|
129
|
+
const sourceStems = new Set(files.map((f) => f.replace(/\.md$/, "")));
|
|
130
|
+
if (!dryRun && files.length > 0) ensureDir(CODEX_SKILLS_DIR);
|
|
131
|
+
|
|
132
|
+
for (const f of files) {
|
|
133
|
+
const stem = f.replace(/\.md$/, "");
|
|
134
|
+
const dest = path.join(CODEX_SKILLS_DIR, stem, "SKILL.md");
|
|
135
|
+
if (!dryRun) ensureDir(path.dirname(dest));
|
|
136
|
+
const transform = (c: string) =>
|
|
137
|
+
stampManagedVersion(applyCodexSkill(c, stem, issueTracker), version);
|
|
138
|
+
if (installFile(path.join(src, f), dest, transform, dryRun)) {
|
|
139
|
+
console.log(`${logPrefix} ${tag}write: ${dest}`);
|
|
140
|
+
trackMirrorWrite(ctx, dest, written);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// Orphan sweep is bkit-prefix scoped: `.agents/skills/` is SHARED with third-party
|
|
145
|
+
// skills installed via skills.sh, so anything not named bkit-* is off limits here.
|
|
146
|
+
if (fs.existsSync(CODEX_SKILLS_DIR)) {
|
|
147
|
+
for (const d of fs.readdirSync(CODEX_SKILLS_DIR)) {
|
|
148
|
+
if (!d.startsWith(BKIT_PREFIX)) continue;
|
|
149
|
+
if (sourceStems.has(d)) continue;
|
|
150
|
+
const rel = path.join(CODEX_SKILLS_DIR, d);
|
|
151
|
+
if (!dryRun) fs.rmSync(rel, { recursive: true, force: true });
|
|
152
|
+
console.log(`${logPrefix} ${tag}delete orphan: ${rel}`);
|
|
153
|
+
trackMirrorWrite(ctx, rel, written);
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
return written;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
export function runCodexModule(ctx: ModuleContext): void {
|
|
162
|
+
const { dryRun, advisories, ws, logPrefix } = ctx;
|
|
163
|
+
const tag = dryRun ? "[dry-run] " : "";
|
|
164
|
+
|
|
165
|
+
renderCodexAgentsSkills(ctx);
|
|
166
|
+
|
|
167
|
+
const codexShared = path.join(getSharedRoot(), ".codex");
|
|
168
|
+
const codexHooks = path.join(getCoreRoot(), ".codex", "hooks");
|
|
169
|
+
|
|
170
|
+
// --- hooks.json — Tier-2 deep-contained (consumers may add their own event groups) ---
|
|
171
|
+
{
|
|
172
|
+
const jsonSrc = path.join(codexShared, "hooks.json");
|
|
173
|
+
const jsonDst = ".codex/hooks.json";
|
|
174
|
+
if (fs.existsSync(jsonSrc)) {
|
|
175
|
+
if (!dryRun) ensureDir(path.dirname(jsonDst));
|
|
176
|
+
const prevLen = ws.writes.length;
|
|
177
|
+
writeTier2JsonContained(jsonSrc, jsonDst, dryRun, ws);
|
|
178
|
+
if (ws.writes.length > prevLen) console.log(`${logPrefix} ${tag}codex: ${jsonDst}`);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
// --- bkit-gateguard.cjs — Tier-2 markered-text, twin of the Claude hook ---
|
|
183
|
+
{
|
|
184
|
+
const hookSrc = path.join(codexHooks, "bkit-gateguard.cjs");
|
|
185
|
+
const hookDst = ".codex/hooks/bkit-gateguard.cjs";
|
|
186
|
+
if (fs.existsSync(hookSrc)) {
|
|
187
|
+
if (!dryRun) ensureDir(path.dirname(hookDst));
|
|
188
|
+
const prevLen = ws.writes.length;
|
|
189
|
+
writeTier2(hookSrc, hookDst, ctx.tokens, "slash-comment", dryRun, ws);
|
|
190
|
+
if (ws.writes.length > prevLen) console.log(`${logPrefix} ${tag}codex: ${hookDst}`);
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
// --- bkit-guardrails.cjs — Tier-2 markered-text, twin of the Cursor hook ---
|
|
195
|
+
// Registered on matcher `Bash` in hooks.json above. Same decision engine as Cursor;
|
|
196
|
+
// the deny tier blocks, the ask tier is advisory because Codex parses but does not
|
|
197
|
+
// implement `permissionDecision: "ask"`.
|
|
198
|
+
{
|
|
199
|
+
const railSrc = path.join(codexHooks, "bkit-guardrails.cjs");
|
|
200
|
+
const railDst = ".codex/hooks/bkit-guardrails.cjs";
|
|
201
|
+
if (fs.existsSync(railSrc)) {
|
|
202
|
+
if (!dryRun) ensureDir(path.dirname(railDst));
|
|
203
|
+
const prevLen = ws.writes.length;
|
|
204
|
+
writeTier2(railSrc, railDst, ctx.tokens, "slash-comment", dryRun, ws);
|
|
205
|
+
if (ws.writes.length > prevLen) console.log(`${logPrefix} ${tag}codex: ${railDst}`);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
advisories.push({
|
|
210
|
+
id: "codex-setup",
|
|
211
|
+
severity: "advisory",
|
|
212
|
+
detect: "codex host installed (.codex/agents + .agents/skills/bkit-*).",
|
|
213
|
+
action:
|
|
214
|
+
"Three things that differ from the other hosts:\n" +
|
|
215
|
+
"1. TRUST THE LAYER. Codex loads project-local hooks only once the `.codex/` layer is trusted. Until then GateGuard is installed and never fires.\n" +
|
|
216
|
+
"2. Workflows are SKILLS here, not slash commands: invoke `$bkit-design`, not `/bkit-design`.\n" +
|
|
217
|
+
"3. Per-agent `tools:` is NOT enforced. Codex has no tool allowlist, so every agent gets the full built-in tool set. See .bkit/providers.md.",
|
|
218
|
+
});
|
|
219
|
+
}
|