@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,102 @@
|
|
|
1
|
+
# Example self-hosted Renovate runner. Copy it to `.github/workflows/bkit-renovate.yml`
|
|
2
|
+
# and own it.
|
|
3
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
4
|
+
# Rules live in `.github/renovate.json5` (Renovate clones the repo and reads that file).
|
|
5
|
+
#
|
|
6
|
+
# Runs `renovatebot/github-action` on `ubuntu-latest` (~16 GB).
|
|
7
|
+
# Edit `runs-on` yourself (a GitHub larger runner, a Depot label, or a self-hosted
|
|
8
|
+
# alias). Keep ≥16 GB of headroom.
|
|
9
|
+
#
|
|
10
|
+
# MUTUAL EXCLUSION: suspend the Mend Renovate App for this repo, or both open the
|
|
11
|
+
# same `renovate/*` PRs. GitHub UI → Settings → Applications → Renovate → Configure
|
|
12
|
+
# → remove this repo. No `gh api` equivalent.
|
|
13
|
+
#
|
|
14
|
+
# SHA-pin the action. This file is yours, so Renovate may bump the pin. Do NOT add
|
|
15
|
+
# this path to renovate.json5 `ignorePaths`.
|
|
16
|
+
name: Renovate
|
|
17
|
+
|
|
18
|
+
on:
|
|
19
|
+
workflow_dispatch:
|
|
20
|
+
inputs:
|
|
21
|
+
logLevel:
|
|
22
|
+
description: "Renovate log level (info | debug)"
|
|
23
|
+
required: false
|
|
24
|
+
default: "info"
|
|
25
|
+
type: string
|
|
26
|
+
dryRun:
|
|
27
|
+
description: "Dry-run mode (full | null)"
|
|
28
|
+
required: false
|
|
29
|
+
default: "null"
|
|
30
|
+
type: string
|
|
31
|
+
schedule:
|
|
32
|
+
# Wake the bot once a day, at an off-hour minute. Renovate's OWN schedule in
|
|
33
|
+
# renovate.json5 ("before 6am on Monday") gates when normal update PRs open;
|
|
34
|
+
# osvVulnerabilityAlerts CVE PRs bypass it and open on the next daily wake.
|
|
35
|
+
# Do NOT narrow this cron to Monday-only.
|
|
36
|
+
- cron: "17 6 * * *"
|
|
37
|
+
|
|
38
|
+
# Least privilege: Renovate authenticates EVERY GitHub operation with BKIT_GH_TOKEN
|
|
39
|
+
# below (a fine-grained PAT or App token — NOT GITHUB_TOKEN). The job GITHUB_TOKEN
|
|
40
|
+
# needs no write scope.
|
|
41
|
+
permissions:
|
|
42
|
+
contents: read
|
|
43
|
+
|
|
44
|
+
# Serialise runs — one Renovate process at a time on the renovate/* branches and the
|
|
45
|
+
# Dependency Dashboard issue. Queue, never cancel.
|
|
46
|
+
concurrency:
|
|
47
|
+
group: renovate
|
|
48
|
+
cancel-in-progress: false
|
|
49
|
+
|
|
50
|
+
jobs:
|
|
51
|
+
renovate:
|
|
52
|
+
runs-on: ubuntu-latest # ~16 GB. Edit this label in your copy.
|
|
53
|
+
timeout-minutes: 30
|
|
54
|
+
steps:
|
|
55
|
+
# No checkout / configurationFile: Renovate clones the repo itself and
|
|
56
|
+
# autodiscovers `.github/renovate.json5` as the repo config from the default
|
|
57
|
+
# branch — the same file Mend reads. (For a MULTI-repo self-hosted bot instead,
|
|
58
|
+
# split a global config.js and pass it via `configurationFile:`.)
|
|
59
|
+
#
|
|
60
|
+
# HARDENING (durable, no annual expiry) — mint a GitHub App token instead of a
|
|
61
|
+
# PAT. Add before this step:
|
|
62
|
+
# - uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
|
|
63
|
+
# id: app-token
|
|
64
|
+
# with:
|
|
65
|
+
# app-id: ${{ secrets.RENOVATE_APP_ID }}
|
|
66
|
+
# private-key: ${{ secrets.RENOVATE_APP_PRIVATE_KEY }}
|
|
67
|
+
# then set `token: ${{ steps.app-token.outputs.token }}` below.
|
|
68
|
+
- uses: renovatebot/github-action@dd5302ec17783b2fc721b19ae7209b57b1587765 # v46.1.17
|
|
69
|
+
with:
|
|
70
|
+
# Fine-grained PAT secret (default). Repository permissions (this repo):
|
|
71
|
+
# Contents: Read and write · Pull requests: Read and write ·
|
|
72
|
+
# Workflows: Read and write (the github-actions manager edits
|
|
73
|
+
# .github/workflows/* SHAs) · Issues: Read and write (Dependency Dashboard) ·
|
|
74
|
+
# Dependabot alerts: Read (GitHub's vulnerability feed) · Metadata: Read-only.
|
|
75
|
+
# (Personal-account tokens only: Account permission "Email addresses: Read" lets
|
|
76
|
+
# Renovate use your verified email as the git author — org-owned tokens have no
|
|
77
|
+
# such permission, so set RENOVATE_GIT_AUTHOR below instead.)
|
|
78
|
+
token: ${{ secrets.BKIT_GH_TOKEN }}
|
|
79
|
+
env:
|
|
80
|
+
# Scope to THIS repo only — never org-wide autodiscover.
|
|
81
|
+
RENOVATE_REPOSITORIES: ${{ github.repository }}
|
|
82
|
+
RENOVATE_AUTODISCOVER: "false"
|
|
83
|
+
RENOVATE_PLATFORM: github
|
|
84
|
+
# Commit author for Renovate's branches. Optional but recommended on ORG repos:
|
|
85
|
+
# org-owned fine-grained PATs cannot grant "Email addresses", so Renovate can't
|
|
86
|
+
# read your email and falls back to the Mend bot author (Unverified commits).
|
|
87
|
+
# Set the repo variable RENOVATE_GIT_AUTHOR (Settings -> Secrets and variables ->
|
|
88
|
+
# Actions -> Variables), e.g. `Renovate Bot <renovate@your-domain>`. Leave the
|
|
89
|
+
# variable unset on personal-account repos where the token has Email addresses: Read.
|
|
90
|
+
RENOVATE_GIT_AUTHOR: ${{ vars.RENOVATE_GIT_AUTHOR }}
|
|
91
|
+
# allowedEnv is a GLOBAL-only Renovate option (security): it allow-lists which
|
|
92
|
+
# env-var names the repo config's `env:` block may set. renovate.json5 ships
|
|
93
|
+
# `env: { PNPM_WORKERS, PNPM_MAX_WORKERS }` — without this the config
|
|
94
|
+
# is REJECTED ("Env variable name PNPM_WORKERS is not allowed by this bot's
|
|
95
|
+
# allowedEnv") and Renovate does nothing. Mend allows these via its safeEnv
|
|
96
|
+
# preset; self-hosted must set it explicitly. Glob covers any future PNPM_* var.
|
|
97
|
+
RENOVATE_ALLOWED_ENV: "PNPM_*"
|
|
98
|
+
LOG_LEVEL: ${{ inputs.logLevel || 'info' }}
|
|
99
|
+
RENOVATE_DRY_RUN: ${{ inputs.dryRun || 'null' }}
|
|
100
|
+
# This env block declares NO ANTHROPIC_API_KEY / BKIT_LINEAR_API_KEY
|
|
101
|
+
# — the Renovate runner must never see them (docs/security.md § Supply-Chain
|
|
102
|
+
# token isolation). Do not add them.
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# Example. Copy to `.graphifyignore` and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
# graphify corpus scope. Same syntax as .gitignore.
|
|
4
|
+
# .gitignore is read automatically and merged with this file; patterns here are
|
|
5
|
+
# evaluated last and only ever exclude more. Everything already ignored by
|
|
6
|
+
# .gitignore (node_modules/, dist/, migration/, *.csv, tmp/, .worktrees/) needs
|
|
7
|
+
# no entry here.
|
|
8
|
+
|
|
9
|
+
# ---------------------------------------------------------------------------
|
|
10
|
+
# 1. Everything an LLM would have to read.
|
|
11
|
+
#
|
|
12
|
+
# graphify parses code locally with tree-sitter and never calls a model for it.
|
|
13
|
+
# Docs, PDFs, images, office files and video are the ONLY paths that reach a
|
|
14
|
+
# backend. `--code-only` skips them per run, but that flag is per-invocation and
|
|
15
|
+
# there is no persistent equivalent — .graphifyrc supports only viz_node_limit
|
|
16
|
+
# and no GRAPHIFY_CODE_ONLY env var exists. Excluding the file types here makes
|
|
17
|
+
# the corpus structurally code-only, so a bare `graphify extract .` or
|
|
18
|
+
# `/graphify .` has nothing to send even without the flag.
|
|
19
|
+
#
|
|
20
|
+
# Counts at time of writing: 4148 .md, 52 .png, 27 .html, 22 .yaml/.yml, 8 .pdf,
|
|
21
|
+
# 7 .txt, 5 .jpg/.jpeg, 2 .xlsx, 2 .docx. `*.md` alone leaves 125 files behind.
|
|
22
|
+
*.md
|
|
23
|
+
*.mdx
|
|
24
|
+
*.qmd
|
|
25
|
+
*.rst
|
|
26
|
+
*.txt
|
|
27
|
+
*.html
|
|
28
|
+
*.yaml
|
|
29
|
+
*.yml
|
|
30
|
+
*.pdf
|
|
31
|
+
*.docx
|
|
32
|
+
*.xlsx
|
|
33
|
+
*.png
|
|
34
|
+
*.jpg
|
|
35
|
+
*.jpeg
|
|
36
|
+
*.webp
|
|
37
|
+
*.gif
|
|
38
|
+
# graphify's image detection is wider than the extensions its README lists.
|
|
39
|
+
# With only the four documented types excluded, a run still reported
|
|
40
|
+
# "7 non-code file(s) (0 docs, 0 papers, 7 images)" — 3 .svg, 2 .heic, 2 .avif.
|
|
41
|
+
# The rest of the raster set is listed so the guarantee survives someone
|
|
42
|
+
# committing a .bmp rather than breaking silently.
|
|
43
|
+
*.svg
|
|
44
|
+
*.heic
|
|
45
|
+
*.avif
|
|
46
|
+
*.bmp
|
|
47
|
+
*.tif
|
|
48
|
+
*.tiff
|
|
49
|
+
*.ico
|
|
50
|
+
*.heif
|
|
51
|
+
*.mp4
|
|
52
|
+
*.mov
|
|
53
|
+
*.mp3
|
|
54
|
+
*.wav
|
|
55
|
+
|
|
56
|
+
# Four binary image fixtures (photo.heic / photo.avif under
|
|
57
|
+
# packages/services/src/inbound/__fixtures__/attachments/ and
|
|
58
|
+
# apps/run/docling/benchmark/corpus/) still appear on the extract's
|
|
59
|
+
# "skipping N non-code file(s)" line and do NOT respond to any ignore rule,
|
|
60
|
+
# including excluding their directory outright. That counter is computed before
|
|
61
|
+
# ignore filtering for the image class; graphify's source contains no reference
|
|
62
|
+
# to "heic" or "avif", so it classifies them from the OS mime database. They
|
|
63
|
+
# never enter manifest.json, so nothing reads them. Do NOT exclude those two
|
|
64
|
+
# directories to zero the counter — both contain real TypeScript (corpus.ts,
|
|
65
|
+
# expected.ts, manifest.ts) and dropping them costs 23 code nodes.
|
|
66
|
+
|
|
67
|
+
# ---------------------------------------------------------------------------
|
|
68
|
+
# 2. Agent harness — config, hooks and tool state, not application code.
|
|
69
|
+
# Left in, these contributed ~450 nodes and dominated the god-node ranking:
|
|
70
|
+
# .opencode/opencode.json alone yielded 112 nodes and .claude/settings.json 71.
|
|
71
|
+
# .serena/ self-ignores only its cache and project.local.yml, so the rest of it
|
|
72
|
+
# is visible to graphify; it is another agent's working state either way.
|
|
73
|
+
.agents/skills/
|
|
74
|
+
.bkit/
|
|
75
|
+
.claude/
|
|
76
|
+
.codex/
|
|
77
|
+
.cursor/
|
|
78
|
+
.opencode/
|
|
79
|
+
.serena/
|
|
80
|
+
|
|
81
|
+
# Generated plan and design artefacts. The markdown is already covered above;
|
|
82
|
+
# this line is for the 27 .json and 59 .jsonl files under the same tree, which
|
|
83
|
+
# graphify treats as code.
|
|
84
|
+
docs/plans/
|
|
85
|
+
|
|
86
|
+
# ---------------------------------------------------------------------------
|
|
87
|
+
# 3. Build and tooling JSON. `.json` is a code extension to graphify, so these
|
|
88
|
+
# are parsed as source and every top-level key becomes a node with no manifest
|
|
89
|
+
# semantics behind it — 206 nodes of task and env-var names for turbo.json,
|
|
90
|
+
# whose `globalEnv` key ranks as a god node at 41 edges when parsed.
|
|
91
|
+
#
|
|
92
|
+
# package.json is NOT excluded, and must never be. graphify reads the workspace
|
|
93
|
+
# `name` fields out of the CORPUS to resolve a workspace package specifier;
|
|
94
|
+
# excluding package.json silently destroys cross-package resolution. Measured on
|
|
95
|
+
# this repo with identical tsconfigs: 104 cross-package edges over 4 package
|
|
96
|
+
# pairs with it excluded, 217 over 35 with it present. It is worth the two noise
|
|
97
|
+
# nodes it costs (`scripts` and `test`, the JSON keys shared by 22 workspaces).
|
|
98
|
+
#
|
|
99
|
+
# tsconfig.json IS excluded and that is safe — graphify reads tsconfig `paths`
|
|
100
|
+
# whether or not the file is in the corpus. Verified by A/B: identical
|
|
101
|
+
# cross-package edge counts either way.
|
|
102
|
+
**/turbo.json
|
|
103
|
+
**/tsconfig.json
|
|
104
|
+
|
|
105
|
+
# ---------------------------------------------------------------------------
|
|
106
|
+
# Deliberately NOT excluded: apps/web/e2e/ (321 nodes) and **/*.test.ts. They
|
|
107
|
+
# are real code with real call edges, and dropping them would blind the
|
|
108
|
+
# `graphify affected` blast-radius query to its test callers.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
#!/usr/bin/env sh
|
|
2
|
+
# bkit pre-commit. Example. Copy into the repo and own it.
|
|
3
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
4
|
+
#
|
|
5
|
+
# FAST local gate only: format staged files (seconds). Heavier gates
|
|
6
|
+
# (typecheck/unit/format:check/prose) and the enforcing slop gate (slop:delta) are in
|
|
7
|
+
# pre-push; integration/E2E/@live run ONLY in CI (bkit-tests / bkit-tests-live, enforced
|
|
8
|
+
# by bkit-tests-check) — see bkit-ci.yml § FULL CI SCAFFOLD REFERENCE. Rule: anything needing
|
|
9
|
+
# a deployed URL, a DB, or >a few seconds belongs in a CI tier, not a hook. (lint:slop is `slop-scan scan` — report-only, never
|
|
10
|
+
# fails; the gate that fails on NEW findings is `slop:delta`, which runs in pre-push.)
|
|
11
|
+
#
|
|
12
|
+
# WHAT it runs lives in package.json `bkit:gate:format`, not here — the same script
|
|
13
|
+
# the bkit agent workflows dispatch through; change the gate there. Add repo-specific
|
|
14
|
+
# extras BELOW this line.
|
|
15
|
+
set -e
|
|
16
|
+
pnpm bkit:gate:format
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
#!/usr/bin/env sh
|
|
2
|
+
# bkit pre-push. Example. Copy into the repo and own it.
|
|
3
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
4
|
+
#
|
|
5
|
+
# FAST deterministic gates only: the `bkit:gate` script (typecheck + unit tests +
|
|
6
|
+
# format:check + prose + the enforcing slop gate) plus the bkit drift gate (no
|
|
7
|
+
# Docker/network) — the full deterministic mirror of CI. Heavier tiers run in CI, NOT
|
|
8
|
+
# here: integration + E2E -> bkit-tests (gated on web_affected / run_e2e); @live ->
|
|
9
|
+
# bkit-tests-live; "did the planned tiers run?" -> bkit-tests-check. See bkit-ci.yml § FULL
|
|
10
|
+
# CI SCAFFOLD REFERENCE — keep slow/network/deploy checks OUT. Turbo monorepos: scope
|
|
11
|
+
# tests inside the `bkit:gate*` scripts with
|
|
12
|
+
# `--filter="...[origin/<default>]"`; never add integration/E2E/@live.
|
|
13
|
+
#
|
|
14
|
+
# Revert-branch bypass: on a revert branch the suite is skipped; lint + typecheck still run.
|
|
15
|
+
set -e
|
|
16
|
+
|
|
17
|
+
# ── delete-only push: nothing leaves this machine, so there is nothing to gate ──
|
|
18
|
+
# `git push origin --delete <branch>` runs this hook too. Git feeds one line per ref on
|
|
19
|
+
# stdin — "<local-ref> <local-sha> <remote-ref> <remote-sha>" — and a deleted ref has an
|
|
20
|
+
# all-zero local sha. When EVERY line is a delete, the push carries no commits. A push
|
|
21
|
+
# mixing a delete with a real update still gates, and so does an empty ref list. Reading
|
|
22
|
+
# stdin here is safe: every later command redirects from /dev/null. `[ -t 0 ]` keeps a
|
|
23
|
+
# hand-run hook from hanging.
|
|
24
|
+
PUSH_SAW_REF=0
|
|
25
|
+
PUSH_HAS_COMMITS=0
|
|
26
|
+
if [ ! -t 0 ]; then
|
|
27
|
+
while read -r _push_local_ref push_local_sha _push_remote_ref _push_remote_sha; do
|
|
28
|
+
[ -n "$push_local_sha" ] || continue
|
|
29
|
+
PUSH_SAW_REF=1
|
|
30
|
+
case "$push_local_sha" in
|
|
31
|
+
*[!0]*) PUSH_HAS_COMMITS=1 ;;
|
|
32
|
+
esac
|
|
33
|
+
done
|
|
34
|
+
fi
|
|
35
|
+
if [ "$PUSH_SAW_REF" = "1" ] && [ "$PUSH_HAS_COMMITS" = "0" ]; then
|
|
36
|
+
echo "[pre-push] delete-only push — no commits to check, gates skipped" >&2
|
|
37
|
+
exit 0
|
|
38
|
+
fi
|
|
39
|
+
# ── end delete-only push
|
|
40
|
+
|
|
41
|
+
BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
|
|
42
|
+
HEAD_SUBJECT=$(git log -1 --pretty=%s 2>/dev/null || echo "")
|
|
43
|
+
IS_REVERT=0
|
|
44
|
+
case "$BRANCH" in
|
|
45
|
+
revert-*) IS_REVERT=1 ;;
|
|
46
|
+
esac
|
|
47
|
+
case "$HEAD_SUBJECT" in
|
|
48
|
+
'Revert "'*) IS_REVERT=1 ;;
|
|
49
|
+
esac
|
|
50
|
+
|
|
51
|
+
# CI-suppressor HEAD guard: blocks a push whose HEAD commit carries a [skip ci]-class
|
|
52
|
+
# token while the branch has an OPEN PR (that token silences GitHub's pull_request
|
|
53
|
+
# trigger). Covers manual pushes (rebase + force-push, post-close commits). No open PR
|
|
54
|
+
# -> allowed ([skip ci] pushes for mid-loop status, abort handover). dev/main exempt;
|
|
55
|
+
# gh absent -> allow. `bkit ci skip-token` exits 0 when HEAD's message carries one of
|
|
56
|
+
# the tokens GitHub honours; bkit owns that list.
|
|
57
|
+
case "$BRANCH" in
|
|
58
|
+
dev|main) ;;
|
|
59
|
+
*)
|
|
60
|
+
if pnpm -s bkit ci skip-token < /dev/null > /dev/null; then
|
|
61
|
+
if command -v gh >/dev/null 2>&1; then
|
|
62
|
+
# strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
|
|
63
|
+
OPEN_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$BRANCH" --state open --json number --jq '.[0].number' 2>/dev/null || echo "")
|
|
64
|
+
if [ -n "$OPEN_PR" ]; then
|
|
65
|
+
echo "[pre-push] BLOCKED: HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open — its checks would stay vacuously green." >&2
|
|
66
|
+
echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
|
|
67
|
+
exit 1
|
|
68
|
+
fi
|
|
69
|
+
else
|
|
70
|
+
echo "[pre-push] WARN: HEAD on '$BRANCH' carries a CI-suppressing token but gh is unavailable to check for an open PR; allowing. If a PR is open, ensure HEAD triggers CI." >&2
|
|
71
|
+
fi
|
|
72
|
+
fi
|
|
73
|
+
;;
|
|
74
|
+
esac
|
|
75
|
+
|
|
76
|
+
# WHAT each gate runs lives in package.json, not here — the same `bkit:gate*` scripts
|
|
77
|
+
# the bkit agent workflows and prompts dispatch through. Edit the scripts, not this
|
|
78
|
+
# hook. Repo-specific extras go BELOW this block.
|
|
79
|
+
# Revert path drops the suite only: prose and slop:delta still run.
|
|
80
|
+
if [ "$IS_REVERT" = "1" ]; then
|
|
81
|
+
echo "[pre-push] revert branch/commit detected — skipping the test suite"
|
|
82
|
+
pnpm bkit:gate:static < /dev/null
|
|
83
|
+
else
|
|
84
|
+
pnpm bkit:gate:static-unit < /dev/null
|
|
85
|
+
fi
|
|
86
|
+
|
|
87
|
+
# bkit mirror-drift gate — fails fast if `.agents/*` was edited without `bkit install`
|
|
88
|
+
# regenerating the `.claude/*`/`.cursor/*` mirrors (same check CI runs).
|
|
89
|
+
# Outside the gate scripts: it validates the bkit install, not your source.
|
|
90
|
+
# Fix: `pnpm bkit install`, stage the regenerated files, commit, push.
|
|
91
|
+
pnpm bkit check < /dev/null
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
|
|
4
|
+
node_modules/
|
|
5
|
+
dist/
|
|
6
|
+
.agents/skills/
|
|
7
|
+
# Canonical-overwrite content (CANONICAL_OVERWRITE_RELPATHS in bkit's install engine):
|
|
8
|
+
# bkit force-overwrites these on every install, so consumer prettier must not
|
|
9
|
+
# lint them. Width-sensitive rewrites would be reverted next install. The
|
|
10
|
+
# .opencode agent + command mirrors are force-overwritten just like .claude /
|
|
11
|
+
# .cursor (the managed-version marker and transform output are the source of
|
|
12
|
+
# truth, not a prettier rewrite). .opencode/plugin/ is listed for the same
|
|
13
|
+
# reason as .claude/ and .cursor/: its hook is a render of the template, and
|
|
14
|
+
# leaving it lintable would let prettier reformat the mirror but not the two ignored
|
|
15
|
+
# twins, silently diverging three copies that must stay byte-identical.
|
|
16
|
+
.claude/
|
|
17
|
+
.cursor/
|
|
18
|
+
.codex/
|
|
19
|
+
.opencode/agents/
|
|
20
|
+
.opencode/commands/
|
|
21
|
+
.opencode/plugin/
|
|
22
|
+
.github/
|
|
23
|
+
.husky/_/
|
|
24
|
+
*.tsbuildinfo
|
|
25
|
+
pnpm-lock.yaml
|
|
26
|
+
# bkit-written / reconciled files — bkit writes these with its own JSON.stringify
|
|
27
|
+
# layout (2-space, expanded arrays) and consumers have no prettier at install
|
|
28
|
+
# time, so prettier must not reformat them or the next install / `bkit check`
|
|
29
|
+
# would just revert the rewrite (permanent drift).
|
|
30
|
+
.mcp.json
|
|
31
|
+
.bkit/.env.example
|
|
32
|
+
.opencode/opencode.json
|
|
33
|
+
# Generated projection — `bkit roadmap fold` FULLY regenerates the
|
|
34
|
+
# `roadmap-status` marker block on every workflow close, emitting unpadded
|
|
35
|
+
# markdown tables. Prettier would re-pad them, so the committed board would
|
|
36
|
+
# never be byte-equal to what the renderer emits and every close would carry a
|
|
37
|
+
# formatting-only diff. The fold's output is the source of truth.
|
|
38
|
+
docs/roadmap.md
|
|
39
|
+
# bkit's reference copies of its templates — refreshed by `bkit upgrade`, never
|
|
40
|
+
# formatted by this repo.
|
|
41
|
+
.bkit/templates/
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
# Example. Copy to `.serena/project.yml` and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
# Set project_name and typescript_version to this repo.
|
|
4
|
+
# typescript_version must match package.json, not Serena's bundled compiler.
|
|
5
|
+
# the name by which the project can be referenced within Serena/when chatting with the LLM.
|
|
6
|
+
project_name: "your-repo"
|
|
7
|
+
|
|
8
|
+
# list of language servers to start when using the LSP backend; choose from:
|
|
9
|
+
# ada al angular ansible bash
|
|
10
|
+
# bsl clojure cpp cpp_ccls crystal
|
|
11
|
+
# csharp csharp_omnisharp cue dart deno
|
|
12
|
+
# elixir elm erlang fortran fsharp
|
|
13
|
+
# gdscript gleam go groovy haskell
|
|
14
|
+
# haxe hlsl html java json
|
|
15
|
+
# julia kotlin latex lean4 lua
|
|
16
|
+
# luau markdown matlab msl nextflow
|
|
17
|
+
# nix ocaml pascal perl php
|
|
18
|
+
# php_phpactor php_phpantom powershell python python_basedpyright
|
|
19
|
+
# python_jedi python_pyrefly python_ty qml r
|
|
20
|
+
# rego ruby ruby_solargraph rust scala
|
|
21
|
+
# scss solidity svelte swift systemverilog
|
|
22
|
+
# terraform toml typescript typescript_vts vue
|
|
23
|
+
# wolfram yaml zig
|
|
24
|
+
# (This list may be outdated; generated with scripts/print_language_list.py;
|
|
25
|
+
# For the current list, see values of the LanguageServerId enum here:
|
|
26
|
+
# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py)
|
|
27
|
+
# For some languages, there are several alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
|
|
28
|
+
# Note:
|
|
29
|
+
# - For C, use cpp
|
|
30
|
+
# - For JavaScript, use typescript
|
|
31
|
+
# - For Angular projects, use angular (subsumes typescript+html; requires `npm install` in the project root)
|
|
32
|
+
# - For Svelte projects, use svelte (subsumes typescript/javascript for .svelte projects; requires npm)
|
|
33
|
+
# - For Deno projects, use deno (serves the same .ts/.js files as typescript; requires the deno CLI on PATH)
|
|
34
|
+
# - For SCSS / Sass / plain CSS, use scss (some-sass-language-server handles all three)
|
|
35
|
+
# - For Free Pascal/Lazarus, use pascal
|
|
36
|
+
# Special requirements:
|
|
37
|
+
# Some language servers require additional setup/installations.
|
|
38
|
+
# See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
|
|
39
|
+
# When using multiple language servers, the first language server that supports a given file will be used for that file.
|
|
40
|
+
# The first language server is the default language and the respective language server will be used as a fallback.
|
|
41
|
+
# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
|
|
42
|
+
language_servers:
|
|
43
|
+
- typescript
|
|
44
|
+
|
|
45
|
+
# the encoding used by text files in the project
|
|
46
|
+
# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
|
|
47
|
+
encoding: "utf-8"
|
|
48
|
+
|
|
49
|
+
# optional shell command to run before the language backend (LSP or JetBrains) is initialised.
|
|
50
|
+
# the command runs in the project root directory and is only executed if the project is trusted
|
|
51
|
+
# (see trusted_project_path_patterns in the global configuration).
|
|
52
|
+
# serena waits for the command to exit: a non-zero exit code is logged as an error but does not
|
|
53
|
+
# abort activation. a per-project timeout (activation_command_timeout, default 180s) is the safety
|
|
54
|
+
# backstop for non-terminating commands; on expiry the process is killed and activation continues.
|
|
55
|
+
# example: activation_command: "npx nx run-many -t build"
|
|
56
|
+
activation_command:
|
|
57
|
+
|
|
58
|
+
# maximum time in seconds to wait for activation_command to complete before killing it (default 180s).
|
|
59
|
+
# must be a positive number.
|
|
60
|
+
activation_command_timeout: 180
|
|
61
|
+
|
|
62
|
+
# line ending convention to use when writing source files.
|
|
63
|
+
# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default)
|
|
64
|
+
# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings.
|
|
65
|
+
line_ending:
|
|
66
|
+
|
|
67
|
+
# The language backend to use for this project.
|
|
68
|
+
# If not set, the global setting from serena_config.yml is used.
|
|
69
|
+
# Valid values: LSP, JetBrains
|
|
70
|
+
# Note: the backend is fixed at startup. If a project with a different backend
|
|
71
|
+
# is activated post-init, an error will be returned.
|
|
72
|
+
language_backend:
|
|
73
|
+
|
|
74
|
+
# whether to use project's .gitignore files to ignore files
|
|
75
|
+
ignore_all_files_in_gitignore: true
|
|
76
|
+
|
|
77
|
+
# advanced configuration option allowing to configure language server-specific options.
|
|
78
|
+
# Maps the language key to the options.
|
|
79
|
+
# The settings are considered only if the project is trusted (see global configuration to define trusted projects).
|
|
80
|
+
# See https://oraios.github.io/serena/02-usage/050_configuration.html#language-server-specific-settings
|
|
81
|
+
ls_specific_settings:
|
|
82
|
+
typescript:
|
|
83
|
+
# tsserver has to resolve the whole project graph before it emits its first
|
|
84
|
+
# $/progress token, and on a repo this size that takes longer than Serena's
|
|
85
|
+
# 5s default grace — past which Serena assumes no indexing was needed and
|
|
86
|
+
# answers a cross-file reference query from a half-built graph.
|
|
87
|
+
indexing_start_grace: 30.0
|
|
88
|
+
indexing_timeout: 180.0
|
|
89
|
+
# Match the repo's own TypeScript (package.json) instead of Serena's bundled
|
|
90
|
+
# 5.9.3, so the server analyses the code with the compiler that compiles it.
|
|
91
|
+
# TypeScript 7+ ships no tsserver and the server will not start on it: keep
|
|
92
|
+
# 5.9.3 there. Ignored unless this project is trusted (see above).
|
|
93
|
+
typescript_version: "5.9.3"
|
|
94
|
+
|
|
95
|
+
# list of workspace folder paths (LSP backend only).
|
|
96
|
+
# These folders will be used to build up Serena's symbol index.
|
|
97
|
+
# Paths must be within the project root and should thus be relative to the project root.
|
|
98
|
+
# Furthermore, the paths should not be filtered by ignore settings.
|
|
99
|
+
# Default setting: The entire project root folder (".") is considered.
|
|
100
|
+
# In (large) monorepos, this can be used to index only subfolders of the project root, e.g.
|
|
101
|
+
# ls_workspace_folders:
|
|
102
|
+
# - "./subproject1"
|
|
103
|
+
# - "./subproject2"
|
|
104
|
+
ls_workspace_folders: ["."]
|
|
105
|
+
|
|
106
|
+
# list of additional workspace folder paths for cross-package reference support.
|
|
107
|
+
# Paths can be absolute or relative to the project root.
|
|
108
|
+
# Each folder is registered as an LSP workspace folder, enabling language servers to discover
|
|
109
|
+
# symbols and references across package boundaries, but these folders are not indexed by Serena,
|
|
110
|
+
# i.e. the respective symbols will not be found using Serena's symbol search tools.
|
|
111
|
+
# Example:
|
|
112
|
+
# additional_workspace_folders:
|
|
113
|
+
# - ../sibling-package
|
|
114
|
+
# - ../shared-lib
|
|
115
|
+
ls_additional_workspace_folders: []
|
|
116
|
+
|
|
117
|
+
# list of additional paths to ignore in this project.
|
|
118
|
+
# Same syntax as gitignore, so you can use * and **.
|
|
119
|
+
# Important: quote patterns that start with `*`, otherwise YAML treats them as aliases.
|
|
120
|
+
# Example:
|
|
121
|
+
# ignored_paths:
|
|
122
|
+
# - "examples/**"
|
|
123
|
+
# - ".worktrees/**"
|
|
124
|
+
# - "**/bin/**"
|
|
125
|
+
# - "**/obj/**"
|
|
126
|
+
# Note: global ignored_paths from serena_config.yml are also applied additively.
|
|
127
|
+
ignored_paths:
|
|
128
|
+
# Anything gitignored is already out (ignore_all_files_in_gitignore above), so
|
|
129
|
+
# docs/graphify-out/, graph.json, node_modules/, packages/*/dist/, migration/ and
|
|
130
|
+
# coverage/ need no entry here. What follows is tracked code that still must
|
|
131
|
+
# not be indexed.
|
|
132
|
+
#
|
|
133
|
+
# Full-tree checkouts of this same repo. Gitignored too, listed anyway because
|
|
134
|
+
# indexing them would return every symbol twice from find_referencing_symbols.
|
|
135
|
+
- ".worktrees/**"
|
|
136
|
+
- ".slop-scan-base/**"
|
|
137
|
+
- ".claude/worktrees/**"
|
|
138
|
+
# Agent harness, not application code. gateguard exists three times over —
|
|
139
|
+
# .claude/hooks/bkit-gateguard.cjs and .cursor/hooks/bkit-gateguard.cjs are byte-
|
|
140
|
+
# identical and .opencode/plugin/bkit-gateguard.js is the same logic as an ES
|
|
141
|
+
# module — so one symbol answers three times. Left in, this is also what the
|
|
142
|
+
# language server reaches first: `serena project health-check` picked
|
|
143
|
+
# alreadyWarned() out of gateguard as the repo's sample symbol.
|
|
144
|
+
- ".claude/**"
|
|
145
|
+
- ".cursor/**"
|
|
146
|
+
- ".opencode/**"
|
|
147
|
+
- ".bkit/**"
|
|
148
|
+
- ".agents/skills/**"
|
|
149
|
+
# Committed compiler output that duplicates TypeScript source. Drop the
|
|
150
|
+
# line if this repo has none.
|
|
151
|
+
- "apps/mobile/dist-plugins/**"
|
|
152
|
+
|
|
153
|
+
# whether the project is in read-only mode
|
|
154
|
+
# If set to true, all editing tools will be disabled and attempts to use them will result in an error
|
|
155
|
+
# Added on 2025-04-18
|
|
156
|
+
read_only: true
|
|
157
|
+
|
|
158
|
+
# list of tool names to exclude.
|
|
159
|
+
# This extends the existing exclusions (e.g. from the global configuration)
|
|
160
|
+
# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
|
|
161
|
+
# bkit agents are granted every Serena tool (`mcp__serena__*`), so this list is
|
|
162
|
+
# what keeps Serena read-only for them: it excludes every tool that writes files,
|
|
163
|
+
# memories or project config, runs code or commands, or opens a browser, across
|
|
164
|
+
# all contexts (claude-code, ide, codex). Serena edits bypass the Edit/Write hooks
|
|
165
|
+
# that gate every other agent edit. read_only above refuses the editing tools at
|
|
166
|
+
# call time but does NOT remove them from the tools/list the client sees (measured
|
|
167
|
+
# on 1.7.0). Remove an entry only to let agents use that tool.
|
|
168
|
+
excluded_tools:
|
|
169
|
+
- "activate_project"
|
|
170
|
+
- "create_text_file"
|
|
171
|
+
- "delete_lines"
|
|
172
|
+
- "delete_memory"
|
|
173
|
+
- "edit_memory"
|
|
174
|
+
- "execute_shell_command"
|
|
175
|
+
- "insert_after_symbol"
|
|
176
|
+
- "insert_at_line"
|
|
177
|
+
- "insert_before_symbol"
|
|
178
|
+
- "jet_brains_debug"
|
|
179
|
+
- "jet_brains_inline_symbol"
|
|
180
|
+
- "jet_brains_move"
|
|
181
|
+
- "jet_brains_rename"
|
|
182
|
+
- "jet_brains_safe_delete"
|
|
183
|
+
- "onboarding"
|
|
184
|
+
- "open_dashboard"
|
|
185
|
+
- "remove_project"
|
|
186
|
+
- "rename_memory"
|
|
187
|
+
- "rename_symbol"
|
|
188
|
+
- "replace_content"
|
|
189
|
+
- "replace_in_files"
|
|
190
|
+
- "replace_lines"
|
|
191
|
+
- "replace_symbol_body"
|
|
192
|
+
- "safe_delete_symbol"
|
|
193
|
+
- "write_memory"
|
|
194
|
+
|
|
195
|
+
# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default).
|
|
196
|
+
# This extends the existing inclusions (e.g. from the global configuration).
|
|
197
|
+
# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
|
|
198
|
+
included_optional_tools: []
|
|
199
|
+
|
|
200
|
+
# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
|
|
201
|
+
# This cannot be combined with non-empty excluded_tools or included_optional_tools.
|
|
202
|
+
# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
|
|
203
|
+
fixed_tools: []
|
|
204
|
+
|
|
205
|
+
# list of mode names that are to be activated by default, overriding the setting in the global configuration.
|
|
206
|
+
# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
|
|
207
|
+
# If the setting is undefined/empty, the default_modes from the global configuration (serena_config.yml) apply.
|
|
208
|
+
# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
|
|
209
|
+
# Therefore, you can set this to [] if you do not want the default modes defined in the global config to apply
|
|
210
|
+
# for this project.
|
|
211
|
+
# This setting can, in turn, be overridden by CLI parameters (--mode).
|
|
212
|
+
# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
|
|
213
|
+
default_modes:
|
|
214
|
+
|
|
215
|
+
# list of mode names to be activated additionally for this project, e.g. ["query-projects"]
|
|
216
|
+
# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
|
|
217
|
+
# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
|
|
218
|
+
# no-memories: this repo's knowledge lives in docs/*.md and the append-only
|
|
219
|
+
# docs/*.jsonl ledgers. A second, unmanaged store under .serena/memories/ would
|
|
220
|
+
# drift from them with nothing keeping the two consistent.
|
|
221
|
+
added_modes: ["no-memories"]
|
|
222
|
+
|
|
223
|
+
# initial prompt for the project. It will always be given to the LLM upon activating the project
|
|
224
|
+
# (contrary to the memories, which are loaded on demand).
|
|
225
|
+
initial_prompt: ""
|
|
226
|
+
|
|
227
|
+
# time budget (seconds) per tool call for the retrieval of additional symbol information
|
|
228
|
+
# such as docstrings or parameter information.
|
|
229
|
+
# This overrides the corresponding setting in the global configuration; see the documentation there.
|
|
230
|
+
# If null or missing, use the setting from the global configuration.
|
|
231
|
+
symbol_info_budget:
|
|
232
|
+
|
|
233
|
+
# list of regex patterns which, when matched, mark a memory entry as read‑only.
|
|
234
|
+
# Extends the list from the global configuration, merging the two lists.
|
|
235
|
+
read_only_memory_patterns: []
|
|
236
|
+
|
|
237
|
+
# list of regex patterns for memories to completely ignore.
|
|
238
|
+
# Matching memories will not appear in list_memories or activate_project output
|
|
239
|
+
# and cannot be accessed via read_memory or write_memory.
|
|
240
|
+
# To access ignored memory files, use the read_file tool on the raw file path.
|
|
241
|
+
# Extends the list from the global configuration, merging the two lists.
|
|
242
|
+
# Example: ["_archive/.*", "_episodes/.*"]
|
|
243
|
+
ignored_memory_patterns: []
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
extends: existence
|
|
4
|
+
message: "Filler: '%s' — delete."
|
|
5
|
+
level: warning
|
|
6
|
+
tokens:
|
|
7
|
+
- basically
|
|
8
|
+
- essentially
|
|
9
|
+
- as mentioned
|
|
10
|
+
- it should be noted
|
|
11
|
+
- as a matter of fact
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
extends: existence
|
|
4
|
+
message: "Hedging: '%s' — remove or commit to a position."
|
|
5
|
+
level: warning
|
|
6
|
+
tokens:
|
|
7
|
+
- it seems like
|
|
8
|
+
- perhaps
|
|
9
|
+
- might be
|
|
10
|
+
- arguably
|
|
11
|
+
- it's worth noting
|
|
12
|
+
- it could be argued
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
extends: existence
|
|
4
|
+
message: "LLM slop: '%s' — rewrite in direct voice."
|
|
5
|
+
level: error
|
|
6
|
+
tokens:
|
|
7
|
+
- I'd be happy to
|
|
8
|
+
- great question
|
|
9
|
+
- I hope this helps
|
|
10
|
+
- feel free to
|
|
11
|
+
- don't hesitate to
|
|
12
|
+
- let me know if
|
|
13
|
+
- let me explain
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
extends: substitution
|
|
4
|
+
message: "Verbose: use '%s' instead of '%s'."
|
|
5
|
+
level: warning
|
|
6
|
+
swap:
|
|
7
|
+
in the event that: if
|
|
8
|
+
at this point in time: now
|
|
9
|
+
in order to: to
|
|
10
|
+
due to the fact that: because
|
|
11
|
+
for the purpose of: to
|
|
12
|
+
on a daily basis: daily
|