@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,232 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
# Adapt app roots, the workspace package scope, and the rules JSON to this repo.
|
|
4
|
+
|
|
5
|
+
#!/usr/bin/env python3
|
|
6
|
+
"""Link user-facing routes to the backend capabilities they reach.
|
|
7
|
+
|
|
8
|
+
Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
|
|
9
|
+
capabilities doc renders as its route layer.
|
|
10
|
+
|
|
11
|
+
bkit-graph-surface.py <graph.json> <surface-out.json> [--quiet]
|
|
12
|
+
|
|
13
|
+
THE CHAIN:
|
|
14
|
+
|
|
15
|
+
apps/web/src/app/[locale]/items/page.tsx filesystem — one page.tsx per route
|
|
16
|
+
-> api.v1.items | "/api/v1/items" literal at the CALLING SYMBOL
|
|
17
|
+
-> v1.ts .route("/v1/items", itemsRouter) + its import line
|
|
18
|
+
-> routes/items.ts imports @scope/services/items
|
|
19
|
+
-> services/items, already a lane in the register
|
|
20
|
+
|
|
21
|
+
Replace `apps/web`, `apps/mobile`, `packages/api`, and `@scope` with this repo.
|
|
22
|
+
|
|
23
|
+
Hop 1 is a literal scan (the static import graph does NOT cross the HTTP
|
|
24
|
+
boundary). Both call styles are read — Hono's typed RPC (`api.v1.items.$get`)
|
|
25
|
+
and raw URL strings (`/api/v1/items`).
|
|
26
|
+
|
|
27
|
+
ATTRIBUTION IS SYMBOL-LEVEL, NOT FILE-LEVEL. Whole-line comments are stripped,
|
|
28
|
+
and a literal counts for the symbol whose line range contains it. graphify gives
|
|
29
|
+
one line per symbol, so a symbol's range runs to the next symbol's line in the
|
|
30
|
+
same file.
|
|
31
|
+
"""
|
|
32
|
+
|
|
33
|
+
import argparse
|
|
34
|
+
import collections
|
|
35
|
+
import json
|
|
36
|
+
import os
|
|
37
|
+
import re
|
|
38
|
+
|
|
39
|
+
ap = argparse.ArgumentParser()
|
|
40
|
+
ap.add_argument("graph_json")
|
|
41
|
+
ap.add_argument("surface_out")
|
|
42
|
+
ap.add_argument("--quiet", action="store_true")
|
|
43
|
+
ap.add_argument("--max-hops", type=int, default=3)
|
|
44
|
+
ap.add_argument("--external-rules")
|
|
45
|
+
args = ap.parse_args()
|
|
46
|
+
|
|
47
|
+
raw = json.load(open(args.graph_json))
|
|
48
|
+
ns = {n["id"]: n for n in raw["nodes"]}
|
|
49
|
+
WALKABLE = {"calls", "imports_from", "imports", "references", "method", "indirect_call"}
|
|
50
|
+
|
|
51
|
+
# --- symbol line ranges -----------------------------------------------------
|
|
52
|
+
lines_by_file = collections.defaultdict(list)
|
|
53
|
+
for n in raw["nodes"]:
|
|
54
|
+
f, loc = str(n.get("source_file") or ""), str(n.get("source_location") or "")
|
|
55
|
+
m = re.fullmatch(r"L(\d+)", loc)
|
|
56
|
+
if f and m:
|
|
57
|
+
lines_by_file[f].append((int(m.group(1)), n["id"]))
|
|
58
|
+
ranges = {}
|
|
59
|
+
for f, entries in lines_by_file.items():
|
|
60
|
+
entries.sort()
|
|
61
|
+
for i, (ln, nid) in enumerate(entries):
|
|
62
|
+
end = entries[i + 1][0] if i + 1 < len(entries) else 10**9
|
|
63
|
+
ranges[nid] = (ln, end)
|
|
64
|
+
|
|
65
|
+
# --- endpoint literals, comments stripped -----------------------------------
|
|
66
|
+
EP = re.compile(r"/api/v1/([a-z][a-z-]*)|[\"'`]/v1/([a-z][a-z-]*)|\bapi\.v1\.([a-z][a-zA-Z-]*)|\bapi\.v1\[[\"']([a-z][a-z-]*)")
|
|
67
|
+
_file_eps = {}
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def endpoints_in(path):
|
|
71
|
+
"""Endpoint segment -> sorted line numbers, for one file, comments removed."""
|
|
72
|
+
if path not in _file_eps:
|
|
73
|
+
out = collections.defaultdict(list)
|
|
74
|
+
if os.path.exists(path):
|
|
75
|
+
for i, line in enumerate(open(path, encoding="utf-8", errors="ignore"), 1):
|
|
76
|
+
s = line.strip()
|
|
77
|
+
if s.startswith(("//", "*", "/*")):
|
|
78
|
+
continue
|
|
79
|
+
for m in EP.finditer(line):
|
|
80
|
+
out[next(g for g in m.groups() if g)].append(i)
|
|
81
|
+
_file_eps[path] = dict(out)
|
|
82
|
+
return _file_eps[path]
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
# --- hop 1: walk out of each route file, symbol by symbol -------------------
|
|
86
|
+
out_edges = collections.defaultdict(list)
|
|
87
|
+
for l in raw["links"]:
|
|
88
|
+
if l.get("relation") in WALKABLE:
|
|
89
|
+
out_edges[l["source"]].append(l["target"])
|
|
90
|
+
|
|
91
|
+
IN_APP = ("apps/web", "apps/mobile", "packages/ui")
|
|
92
|
+
ROUTE_GLOBS = (
|
|
93
|
+
(re.compile(r"^apps/web/src/app/(.+)/page\.tsx$"), "web"),
|
|
94
|
+
(re.compile(r"^apps/mobile/app/(.+)\.tsx$"), "native"),
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
def route_label(path):
|
|
99
|
+
for rx, platform in ROUTE_GLOBS:
|
|
100
|
+
m = rx.match(path)
|
|
101
|
+
if m:
|
|
102
|
+
r = "/" + m.group(1)
|
|
103
|
+
r = re.sub(r"^/\[locale\]", "", r) or "/"
|
|
104
|
+
# __tests__/ and *.test.tsx sit inside apps/mobile/app, so the route
|
|
105
|
+
# glob matches them; they are not routes a user can navigate to.
|
|
106
|
+
if (r.endswith(("/_layout", ".test")) or "/+" in r or "__tests__" in r
|
|
107
|
+
or "/_" in r):
|
|
108
|
+
return None, None
|
|
109
|
+
return r, platform
|
|
110
|
+
return None, None
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
routes = {}
|
|
114
|
+
for path in sorted({str(n.get("source_file") or "") for n in raw["nodes"]}):
|
|
115
|
+
label, platform = route_label(path)
|
|
116
|
+
if label:
|
|
117
|
+
routes[path] = (label, platform)
|
|
118
|
+
|
|
119
|
+
surface = {}
|
|
120
|
+
for path, (label, platform) in routes.items():
|
|
121
|
+
seeds = [nid for nid, (f, _) in
|
|
122
|
+
((nid, (str(ns[nid].get("source_file") or ""), 0)) for nid in ns)
|
|
123
|
+
if f == path]
|
|
124
|
+
seen, frontier = set(seeds), set(seeds)
|
|
125
|
+
for _ in range(args.max_hops):
|
|
126
|
+
nxt = set()
|
|
127
|
+
for nid in frontier:
|
|
128
|
+
for t in out_edges.get(nid, ()):
|
|
129
|
+
tf = str(ns.get(t, {}).get("source_file") or "")
|
|
130
|
+
if t not in seen and tf.startswith(IN_APP):
|
|
131
|
+
seen.add(t)
|
|
132
|
+
nxt.add(t)
|
|
133
|
+
frontier = nxt
|
|
134
|
+
hits = collections.defaultdict(set)
|
|
135
|
+
for nid in seen:
|
|
136
|
+
f = str(ns.get(nid, {}).get("source_file") or "")
|
|
137
|
+
lo, hi = ranges.get(nid, (0, 0))
|
|
138
|
+
for seg, lns in endpoints_in(f).items():
|
|
139
|
+
for ln in lns:
|
|
140
|
+
if lo <= ln < hi:
|
|
141
|
+
hits[seg].add(f"{f}:{ln}")
|
|
142
|
+
if hits:
|
|
143
|
+
surface[label] = {"platform": platform, "file": path,
|
|
144
|
+
"endpoints": {k: sorted(v) for k, v in sorted(hits.items())}}
|
|
145
|
+
|
|
146
|
+
# --- hops 2 and 3: endpoint -> router file -> service domains ---------------
|
|
147
|
+
v1 = open("packages/api/src/v1.ts", encoding="utf-8").read() if os.path.exists("packages/api/src/v1.ts") else ""
|
|
148
|
+
router_file = dict(re.findall(r'import\s*\{\s*(\w+)\s*\}\s*from\s*"\./routes/([\w-]+)\.js"', v1))
|
|
149
|
+
seg_router = collections.defaultdict(set)
|
|
150
|
+
for seg, var in re.findall(r'\.route\("/v1/([a-z][a-z-]*)",\s*(\w+)\)', v1):
|
|
151
|
+
if var in router_file:
|
|
152
|
+
seg_router[seg].add(router_file[var])
|
|
153
|
+
|
|
154
|
+
seg_services = {}
|
|
155
|
+
for seg, files in seg_router.items():
|
|
156
|
+
doms = set()
|
|
157
|
+
for rf in files:
|
|
158
|
+
p = f"packages/api/src/routes/{rf}.ts"
|
|
159
|
+
if os.path.exists(p):
|
|
160
|
+
# Replace @scope with this repo's workspace services scope.
|
|
161
|
+
doms |= set(re.findall(r"@scope/services/([a-z-]+)", open(p, encoding="utf-8").read()))
|
|
162
|
+
seg_services[seg] = {"routers": sorted(files), "services": sorted(doms)}
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
# --- hop 4: backend modules -> external providers ---------------------------
|
|
167
|
+
# SDK-first, URL-fallback: a provider is matched by SDK import, else discovered from
|
|
168
|
+
# a URL hostname even when no rule names it. Test code's callers are dropped by
|
|
169
|
+
# bkit-graphify-rollup.py's is_test_code, and social links and example hosts by
|
|
170
|
+
# hide_nodes in the doc, not here.
|
|
171
|
+
BY_MODULE = lambda p: "/".join(p.split("/")[:-1][:4]) or p.split("/")[0]
|
|
172
|
+
SKIP_DIR = {"node_modules", "dist", ".next", ".turbo", "coverage", "build", ".git"}
|
|
173
|
+
SKIP_FILE = (".test.", ".spec.", ".d.ts", ".config.")
|
|
174
|
+
URL = re.compile(r"https://([a-z0-9.-]+\.[a-z]{2,})(/[A-Za-z0-9/_.:-]*)?")
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
def scan_external(rules_path):
|
|
178
|
+
providers = json.load(open(rules_path))["providers"] if rules_path and os.path.exists(rules_path) else []
|
|
179
|
+
host_owner, sdk_owner, env_owner = {}, {}, {}
|
|
180
|
+
for r in providers:
|
|
181
|
+
for h in r.get("hosts", []):
|
|
182
|
+
host_owner[h] = r["provider"]
|
|
183
|
+
for m in r.get("sdk", []):
|
|
184
|
+
sdk_owner[m] = r["provider"]
|
|
185
|
+
for e in r.get("env", []):
|
|
186
|
+
env_owner[e] = r["provider"]
|
|
187
|
+
found = collections.defaultdict(lambda: {"endpoints": collections.defaultdict(set),
|
|
188
|
+
"callers": set(), "via": set()})
|
|
189
|
+
for root in ("packages", "apps"):
|
|
190
|
+
for dp, dn, fn in os.walk(root):
|
|
191
|
+
dn[:] = [d for d in dn if d not in SKIP_DIR]
|
|
192
|
+
if "/e2e" in dp or "/tests" in dp or "__tests__" in dp or "__fixtures__" in dp:
|
|
193
|
+
continue
|
|
194
|
+
for f in fn:
|
|
195
|
+
if not f.endswith((".ts", ".tsx")) or any(x in f for x in SKIP_FILE):
|
|
196
|
+
continue
|
|
197
|
+
path = os.path.join(dp, f)
|
|
198
|
+
mod = BY_MODULE(path)
|
|
199
|
+
for i, line in enumerate(open(path, encoding="utf-8", errors="ignore"), 1):
|
|
200
|
+
if line.strip().startswith(("//", "*", "/*")):
|
|
201
|
+
continue
|
|
202
|
+
for spec, prov in sdk_owner.items():
|
|
203
|
+
if f'from "{spec}"' in line:
|
|
204
|
+
found[prov]["callers"].add(mod)
|
|
205
|
+
found[prov]["via"].add("sdk")
|
|
206
|
+
for var, prov in env_owner.items():
|
|
207
|
+
if f"env.{var}" in line:
|
|
208
|
+
found[prov]["callers"].add(mod)
|
|
209
|
+
found[prov]["via"].add("env")
|
|
210
|
+
for m in URL.finditer(line):
|
|
211
|
+
host, sub = m.group(1), (m.group(2) or "/").rstrip("/") or "/"
|
|
212
|
+
prov = host_owner.get(host, host)
|
|
213
|
+
found[prov]["endpoints"][sub].add(f"{path}:{i}")
|
|
214
|
+
found[prov]["callers"].add(mod)
|
|
215
|
+
found[prov]["via"].add("url")
|
|
216
|
+
return {p: {"endpoints": {k: sorted(v) for k, v in sorted(d["endpoints"].items())},
|
|
217
|
+
"callers": sorted(d["callers"]), "via": sorted(d["via"])}
|
|
218
|
+
for p, d in sorted(found.items())}
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
EXTERNAL = scan_external(args.external_rules)
|
|
222
|
+
|
|
223
|
+
json.dump({"routes": surface, "endpoints": seg_services, "external": EXTERNAL},
|
|
224
|
+
open(args.surface_out, "w"), indent=1)
|
|
225
|
+
|
|
226
|
+
if not args.quiet:
|
|
227
|
+
for label, d in sorted(surface.items()):
|
|
228
|
+
svc = sorted({s for seg in d["endpoints"] for s in seg_services.get(seg, {}).get("services", [])})
|
|
229
|
+
print(f"[surface] {d['platform']:6} {label:32} {','.join(sorted(d['endpoints'])) or '—'}"
|
|
230
|
+
+ (f" -> {','.join(svc)}" if svc else ""))
|
|
231
|
+
print(f"[surface] {len(surface)} routes, {len(seg_services)} endpoints, "
|
|
232
|
+
f"{len(EXTERNAL)} external providers -> {args.surface_out}")
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
# Adapt app roots, the workspace package scope, and the rules JSON to this repo.
|
|
4
|
+
|
|
5
|
+
#!/usr/bin/env python3
|
|
6
|
+
"""Export the full symbol graph to GraphML for Gephi / yEd.
|
|
7
|
+
|
|
8
|
+
Called by `pnpm graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
|
|
9
|
+
OWN interpreter — it imports graphify itself.
|
|
10
|
+
|
|
11
|
+
bkit-graphify-graphml.py <graph.json> <out.graphml>
|
|
12
|
+
|
|
13
|
+
The graphify CLI has no --graphml flag (only the /graphify skill has one, which
|
|
14
|
+
this repo does not install; see docs/setup.md § Code Graph, "Never run"), so this
|
|
15
|
+
calls to_graphml() directly. Community IDs are carried through so Gephi can
|
|
16
|
+
partition on them.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
import collections
|
|
20
|
+
import sys
|
|
21
|
+
from pathlib import Path
|
|
22
|
+
|
|
23
|
+
from graphify.affected import load_graph
|
|
24
|
+
from graphify.export import to_graphml
|
|
25
|
+
|
|
26
|
+
GRAPH_JSON, OUT_GRAPHML = sys.argv[1:3]
|
|
27
|
+
|
|
28
|
+
G = load_graph(Path(GRAPH_JSON))
|
|
29
|
+
comms = collections.defaultdict(list)
|
|
30
|
+
for nid, attrs in G.nodes(data=True):
|
|
31
|
+
c = attrs.get("community")
|
|
32
|
+
if c is not None:
|
|
33
|
+
comms[c].append(nid)
|
|
34
|
+
Path(OUT_GRAPHML).parent.mkdir(parents=True, exist_ok=True)
|
|
35
|
+
to_graphml(G, dict(comms), OUT_GRAPHML)
|
|
36
|
+
print(f"[graph] {G.number_of_nodes()} nodes, {G.number_of_edges()} edges, {len(comms)} communities")
|