@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -71,9 +71,17 @@ function judge(cwd, wt, fid) {
|
|
|
71
71
|
const git = (...args) => spawnSync("git", ["-C", wt, ...args], { encoding: "utf8" });
|
|
72
72
|
if (fs.globSync(path.join(cwd, "docs/plans/*/logs", fid, ".lock")).length > 0)
|
|
73
73
|
return { keep: "a bkit workflow holds its lock" };
|
|
74
|
+
// git in a plain folder inside the checkout answers for the checkout itself, so a folder is
|
|
75
|
+
// a worktree only when git names it as its own top.
|
|
76
|
+
if (
|
|
77
|
+
!fs.existsSync(wt) ||
|
|
78
|
+
git("rev-parse", "--show-toplevel").stdout.trim() !== fs.realpathSync(wt)
|
|
79
|
+
)
|
|
80
|
+
return { note: "not a git worktree; delete the folder if unneeded" };
|
|
74
81
|
if (idleDays(wt) < 2) return { keep: "committed to in the last 2 days" };
|
|
75
82
|
const status = git("status", "--porcelain");
|
|
76
|
-
if (status.status !== 0)
|
|
83
|
+
if (status.status !== 0)
|
|
84
|
+
return { note: `git status failed (\`git -C .worktrees/${fid} status\`)` };
|
|
77
85
|
if (status.stdout.trim() !== "")
|
|
78
86
|
return { note: `uncommitted or untracked files (\`git -C .worktrees/${fid} status\`)` };
|
|
79
87
|
if (git("rev-list", "HEAD", "--not", "--remotes").stdout.trim() !== "") {
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
#!/usr/bin/env python3
|
|
6
6
|
"""Compute per-capability drift status by literal-pattern scan, for the generated diagram.
|
|
7
7
|
|
|
8
|
-
Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Reads
|
|
8
|
+
Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Reads
|
|
9
9
|
bkit-graph-drift-rules.json, walks the source tree once, and writes an overlay JSON
|
|
10
10
|
that bkit-graphify-rollup.py paints onto the Mermaid nodes.
|
|
11
11
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
#!/usr/bin/env python3
|
|
6
6
|
"""Find modules that do work when they are imported, and count who pays for it.
|
|
7
7
|
|
|
8
|
-
Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON that
|
|
8
|
+
Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON that
|
|
9
9
|
bkit-graphify-rollup.py renders as the import-time side-effect table in
|
|
10
10
|
docs/capabilities.md.
|
|
11
11
|
|
|
@@ -135,7 +135,7 @@ def inside_callable(path, line):
|
|
|
135
135
|
# --- who imports this, transitively -------------------------------------------
|
|
136
136
|
# graph.json already carries the imports graphify cannot resolve — a `.js`
|
|
137
137
|
# specifier never reaching a `.tsx` file, and workspace subpaths through an
|
|
138
|
-
# `exports` map. bkit-graph-repair.py injects them during `pnpm graph`, so they are
|
|
138
|
+
# `exports` map. bkit-graph-repair.py injects them during `pnpm bkit:graph`, so they are
|
|
139
139
|
# read here like any other edge; warns if graph.json lacks any of them.
|
|
140
140
|
INBOUND = collections.defaultdict(set)
|
|
141
141
|
for link in raw["links"]:
|
|
@@ -232,5 +232,5 @@ print(f"[eager] {REPAIRED} of those edges came from bkit-graph-repair.py — imp
|
|
|
232
232
|
f"graphify cannot resolve (.js -> .tsx, workspace exports subpaths)")
|
|
233
233
|
if ungraphed:
|
|
234
234
|
print(f"[eager] {ungraphed} scanned files absent from graph.json (column-0 filter only) "
|
|
235
|
-
f"— run 'pnpm graph:update' to close the gap", file=sys.stderr)
|
|
235
|
+
f"— run 'pnpm bkit:graph:update' to close the gap", file=sys.stderr)
|
|
236
236
|
print(f"[eager] wrote {args.eager_out}", file=sys.stderr)
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Example. Copy into the repo and own it.
|
|
2
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
3
|
+
# List the docs to embed into in GRAPH_EMBED_DOCS (bkit-graphify.sh).
|
|
4
|
+
|
|
5
|
+
#!/usr/bin/env python3
|
|
6
|
+
"""Copy the packages diagram from the capability register into other docs.
|
|
7
|
+
|
|
8
|
+
Called by `pnpm bkit:graph:rollup`, `:register` and `:refresh` (write) and by
|
|
9
|
+
`pnpm bkit:graph:check` (--check), scripts/graphify/bkit-graphify.sh, for every doc in
|
|
10
|
+
GRAPH_EMBED_DOCS. Runs on system python (stdlib only).
|
|
11
|
+
|
|
12
|
+
bkit-graph-embed.py <capabilities.md> <doc>... [--check]
|
|
13
|
+
|
|
14
|
+
Each doc holds one block between the two markers below. Write mode replaces what
|
|
15
|
+
is between them with the fenced Mermaid block under `## Architecture — packages`
|
|
16
|
+
in the register, byte for byte. --check writes nothing and exits 1 when any doc's
|
|
17
|
+
block differs. A doc without both markers exits 2: a listed doc that cannot take
|
|
18
|
+
the diagram is a setup error, not a clean result.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
import argparse
|
|
22
|
+
import re
|
|
23
|
+
import sys
|
|
24
|
+
|
|
25
|
+
START, END = "<!-- graph:packages:start -->", "<!-- graph:packages:end -->"
|
|
26
|
+
HEADING = "## Architecture — packages"
|
|
27
|
+
|
|
28
|
+
ap = argparse.ArgumentParser()
|
|
29
|
+
ap.add_argument("capabilities_doc")
|
|
30
|
+
ap.add_argument("docs", nargs="+")
|
|
31
|
+
ap.add_argument("--check", action="store_true")
|
|
32
|
+
args = ap.parse_args()
|
|
33
|
+
|
|
34
|
+
register = open(args.capabilities_doc, encoding="utf-8").read()
|
|
35
|
+
if HEADING not in register:
|
|
36
|
+
sys.exit(f"[graph] {args.capabilities_doc}: no `{HEADING}` section — run pnpm bkit:graph:rollup first")
|
|
37
|
+
m = re.search(r"```mermaid\n.*?\n```", register.split(HEADING, 1)[1], re.S)
|
|
38
|
+
if not m:
|
|
39
|
+
sys.exit(f"[graph] {args.capabilities_doc}: `{HEADING}` has no ```mermaid block")
|
|
40
|
+
block = f"{START}\n\n{m.group(0)}\n\n{END}"
|
|
41
|
+
|
|
42
|
+
stale = []
|
|
43
|
+
for doc in args.docs:
|
|
44
|
+
text = open(doc, encoding="utf-8").read()
|
|
45
|
+
if text.count(START) != 1 or text.count(END) != 1 or text.index(START) > text.index(END):
|
|
46
|
+
print(f"[graph] {doc}: needs exactly one {START} … {END} pair", file=sys.stderr)
|
|
47
|
+
sys.exit(2)
|
|
48
|
+
head, rest = text.split(START, 1)
|
|
49
|
+
tail = rest.split(END, 1)[1]
|
|
50
|
+
fresh = head + block + tail
|
|
51
|
+
if fresh == text:
|
|
52
|
+
continue
|
|
53
|
+
if args.check:
|
|
54
|
+
stale.append(doc)
|
|
55
|
+
else:
|
|
56
|
+
with open(doc, "w", encoding="utf-8") as fh:
|
|
57
|
+
fh.write(fresh)
|
|
58
|
+
print(f"[graph] {doc}: packages diagram rewritten")
|
|
59
|
+
|
|
60
|
+
if stale:
|
|
61
|
+
print(f"[graph] DRIFT: the packages diagram in {', '.join(stale)} is not the one in "
|
|
62
|
+
f"{args.capabilities_doc}.", file=sys.stderr)
|
|
63
|
+
sys.exit(1)
|
|
@@ -9,7 +9,7 @@ the sibling `graph-*.py` scripts, which are standalone and cannot be imported
|
|
|
9
9
|
themselves.
|
|
10
10
|
|
|
11
11
|
ONE WRITER. `bkit-graph-repair.py` is the only script that writes
|
|
12
|
-
`resolved_import_edges()` into graph.json, during `pnpm graph`, so `graphify affected` /
|
|
12
|
+
`resolved_import_edges()` into graph.json, during `pnpm bkit:graph`, so `graphify affected` /
|
|
13
13
|
`explain` / `path` / `query` see the same edges these scripts do. bkit-graph-eager.py
|
|
14
14
|
and bkit-graphify-rollup.py call `warn_if_unrepaired()`, which compares the same set
|
|
15
15
|
against graph.json, and otherwise just read the graph.
|
|
@@ -147,7 +147,7 @@ def warn_if_unrepaired(graph, who, stream=None):
|
|
|
147
147
|
if missing:
|
|
148
148
|
print(f"[{who}] WARNING: graph.json lacks {len(missing)} imports that "
|
|
149
149
|
f"bkit-graph-repair.py adds, so reachability and blast-radius numbers "
|
|
150
|
-
f"below are UNDERSTATED. Run 'pnpm graph:update'.",
|
|
150
|
+
f"below are UNDERSTATED. Run 'pnpm bkit:graph:update'.",
|
|
151
151
|
file=stream or _sys.stderr)
|
|
152
152
|
return repair_state(graph)
|
|
153
153
|
|
|
@@ -4,39 +4,90 @@
|
|
|
4
4
|
# copy lacks that call → re-copy the "Capability register" block from the template.
|
|
5
5
|
# bkit install does not write this file and does not overwrite a copy.
|
|
6
6
|
#
|
|
7
|
-
# Capability register current
|
|
8
|
-
#
|
|
9
|
-
#
|
|
7
|
+
# Capability register current wherever CI checks it. BLOCKS a push to dev, and a push of a
|
|
8
|
+
# branch with an open PR into dev, when docs/capabilities.md is not what the pushed commit
|
|
9
|
+
# builds: CI's Check Capability Register fails both. Reads PUSH_DEV_SHA (commit pushed to dev),
|
|
10
|
+
# BRANCH (the checked-out branch) and PUSH_BRANCH_SHA (commit pushed to that branch, empty when
|
|
11
|
+
# the push does not update it), set by the bkit pre-push template while reading git's ref list
|
|
12
|
+
# on stdin; stdin is consumed by now. An older hook copy sets no BRANCH / PUSH_BRANCH_SHA → the
|
|
13
|
+
# checked-out branch and HEAD stand in.
|
|
10
14
|
#
|
|
11
15
|
# graphify reads the working tree → check runs in a throwaway checkout of the pushed commit
|
|
12
16
|
# (`check-at`): uncommitted edits, a concurrent session's included, cannot change the answer.
|
|
13
17
|
# Other graphify release → blocked, with the install command. graphify NOT INSTALLED → warn
|
|
14
18
|
# only, saying the check did not run: a cloud session without it must still push; CI's Check
|
|
15
|
-
# Capability Register runs the same check on every push to dev
|
|
16
|
-
#
|
|
19
|
+
# Capability Register runs the same check on every push to dev and every pull request. The
|
|
20
|
+
# open-PR lookup needs gh: gh NOT INSTALLED, or its call FAILING (offline, not signed in) →
|
|
21
|
+
# warn only, as with graphify; a lookup that cannot answer is never read as "no PR". Revert pushes
|
|
22
|
+
# (IS_REVERT=1) skip it, as they skip the test tiers. A branch with no open PR → warn-only
|
|
23
|
+
# staleness note.
|
|
17
24
|
CAP_DOC="docs/capabilities.md"
|
|
18
25
|
if [ -f scripts/graphify/bkit-graphify.sh ] && [ -f "$CAP_DOC" ]; then
|
|
19
|
-
|
|
26
|
+
# The commit to check, and what the push is; empty → the warn-only note.
|
|
27
|
+
CAP_GATE_SHA=""
|
|
28
|
+
CAP_GATE_WHAT=""
|
|
29
|
+
if [ "${IS_REVERT:-0}" = "1" ]; then
|
|
30
|
+
:
|
|
31
|
+
elif [ -n "${PUSH_DEV_SHA:-}" ]; then
|
|
32
|
+
CAP_GATE_SHA="$PUSH_DEV_SHA"
|
|
33
|
+
CAP_GATE_WHAT="this push to dev"
|
|
34
|
+
else
|
|
35
|
+
CAP_BRANCH="${BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")}"
|
|
36
|
+
if [ -n "${PUSH_BRANCH_SHA+set}" ]; then
|
|
37
|
+
CAP_PUSHED="$PUSH_BRANCH_SHA"
|
|
38
|
+
else
|
|
39
|
+
CAP_PUSHED=$(git rev-parse HEAD 2>/dev/null || echo "")
|
|
40
|
+
fi
|
|
41
|
+
case "$CAP_BRANCH" in
|
|
42
|
+
"" | HEAD | dev | main) ;;
|
|
43
|
+
*)
|
|
44
|
+
if [ -z "$CAP_PUSHED" ]; then
|
|
45
|
+
:
|
|
46
|
+
else
|
|
47
|
+
# Why the lookup could not answer; empty → it answered (a PR number, or none).
|
|
48
|
+
CAP_UNKNOWN=""
|
|
49
|
+
if ! command -v gh >/dev/null 2>&1; then
|
|
50
|
+
CAP_UNKNOWN="gh is not installed"
|
|
51
|
+
# strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
|
|
52
|
+
elif CAP_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$CAP_BRANCH" --base dev --state open --json number --jq '.[0].number' 2>/dev/null); then
|
|
53
|
+
if [ -n "$CAP_PR" ]; then
|
|
54
|
+
CAP_GATE_SHA="$CAP_PUSHED"
|
|
55
|
+
CAP_GATE_WHAT="PR #$CAP_PR into dev"
|
|
56
|
+
fi
|
|
57
|
+
else
|
|
58
|
+
CAP_UNKNOWN="gh pr list failed (offline, or gh not signed in)"
|
|
59
|
+
fi
|
|
60
|
+
if [ -n "$CAP_UNKNOWN" ]; then
|
|
61
|
+
echo "[pre-push] WARNING: $CAP_DOC was NOT checked — $CAP_UNKNOWN, so whether '$CAP_BRANCH' has an open PR is unknown." >&2
|
|
62
|
+
echo "[pre-push] If a PR is open, CI's Check Capability Register fails it on a stale register; run" >&2
|
|
63
|
+
echo "[pre-push] pnpm bkit:graph:refresh, commit, and push again." >&2
|
|
64
|
+
fi
|
|
65
|
+
fi
|
|
66
|
+
;;
|
|
67
|
+
esac
|
|
68
|
+
fi
|
|
69
|
+
if [ -n "$CAP_GATE_SHA" ]; then
|
|
20
70
|
if ! command -v graphify >/dev/null 2>&1; then
|
|
21
71
|
echo "[pre-push] WARNING: $CAP_DOC was NOT checked — graphify is not installed." >&2
|
|
22
|
-
echo "[pre-push] CI's Check Capability Register checks it
|
|
23
|
-
echo "[pre-push] pnpm graph:refresh, commit, and push again. Install graphify to check before pushing:" >&2
|
|
72
|
+
echo "[pre-push] CI's Check Capability Register checks it for $CAP_GATE_WHAT; if it reds there, run" >&2
|
|
73
|
+
echo "[pre-push] pnpm bkit:graph:refresh, commit, and push again. Install graphify to check before pushing:" >&2
|
|
24
74
|
echo "[pre-push] brew install uv && uv tool install '$(bash scripts/graphify/bkit-graphify.sh spec)'" >&2
|
|
25
|
-
elif ! bash scripts/graphify/bkit-graphify.sh check-at "$
|
|
26
|
-
echo "[pre-push] BLOCKED: $CAP_DOC is not what the pushed commit builds (diff above)." >&2
|
|
27
|
-
echo "[pre-push] Fix: pnpm graph:refresh
|
|
75
|
+
elif ! bash scripts/graphify/bkit-graphify.sh check-at "$CAP_GATE_SHA" < /dev/null; then
|
|
76
|
+
echo "[pre-push] BLOCKED: $CAP_DOC is not what the pushed commit builds (diff above); CI fails $CAP_GATE_WHAT on it." >&2
|
|
77
|
+
echo "[pre-push] Fix: pnpm bkit:graph:refresh, git add the files it rewrote, git commit, then push again." >&2
|
|
28
78
|
exit 1
|
|
29
79
|
fi
|
|
30
80
|
else
|
|
31
|
-
# Warn-only.
|
|
32
|
-
#
|
|
33
|
-
|
|
34
|
-
|
|
81
|
+
# Warn-only. Staleness = source files changed since the last commit that changed the
|
|
82
|
+
# register. A rebuild that changes nothing commits nothing, so the count can include
|
|
83
|
+
# files that left the register as it was.
|
|
84
|
+
CAP_SHA=$(git log -1 --format=%h -- "$CAP_DOC" 2>/dev/null || true)
|
|
85
|
+
if [ -n "$CAP_SHA" ]; then
|
|
35
86
|
CAP_CHANGED=$(git diff --name-only "$CAP_SHA..HEAD" -- '*.ts' '*.tsx' 2>/dev/null | wc -l | tr -d ' ')
|
|
36
87
|
if [ "${CAP_CHANGED:-0}" -gt 0 ]; then
|
|
37
|
-
echo "[pre-push] NOTE: $CAP_DOC
|
|
38
|
-
echo "[pre-push] Refresh when convenient: pnpm graph:refresh" >&2
|
|
39
|
-
echo "[pre-push] Not a gate on this branch
|
|
88
|
+
echo "[pre-push] NOTE: $CAP_DOC last changed in $CAP_SHA; $CAP_CHANGED source files changed since." >&2
|
|
89
|
+
echo "[pre-push] Refresh when convenient: pnpm bkit:graph:refresh" >&2
|
|
90
|
+
echo "[pre-push] Not a gate on this branch until it has an open PR into dev; a push to dev is blocked until it is current." >&2
|
|
40
91
|
fi
|
|
41
92
|
fi
|
|
42
93
|
fi
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
#!/usr/bin/env python3
|
|
6
6
|
"""Inject the import edges graphify could not resolve back into graph.json.
|
|
7
7
|
|
|
8
|
-
Called by `pnpm graph`, `:clean` and `:update` (scripts/graphify/bkit-graphify.sh),
|
|
8
|
+
Called by `pnpm bkit:graph`, `:clean` and `:update` (scripts/graphify/bkit-graphify.sh),
|
|
9
9
|
between `extract` and `cluster-only`.
|
|
10
10
|
|
|
11
11
|
bkit-graph-repair.py <graph.json> [--rules R] [--quiet]
|
|
@@ -16,9 +16,9 @@ checks, the generated doc, and `graphify affected`, `god-nodes`, `explain`,
|
|
|
16
16
|
this step says so.
|
|
17
17
|
|
|
18
18
|
`graphify update` rewrites graph.json without the injected edges, so every
|
|
19
|
-
wrapper command that writes the file (`pnpm graph`, `:clean`, `:update`) runs
|
|
19
|
+
wrapper command that writes the file (`pnpm bkit:graph`, `:clean`, `:update`) runs
|
|
20
20
|
this step at the end. The step is idempotent: after a raw `graphify update .`,
|
|
21
|
-
run `pnpm graph:update`.
|
|
21
|
+
run `pnpm bkit:graph:update`.
|
|
22
22
|
|
|
23
23
|
ORDER MATTERS: this runs BEFORE clustering, so communities, the god-node
|
|
24
24
|
ranking and the cycle list in graph-report.md are computed from the repaired graph.
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
#!/usr/bin/env python3
|
|
6
6
|
"""Link user-facing routes to the backend capabilities they reach.
|
|
7
7
|
|
|
8
|
-
Called by `pnpm graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
|
|
8
|
+
Called by `pnpm bkit:graph:rollup` (scripts/graphify/bkit-graphify.sh). Writes a JSON the
|
|
9
9
|
capabilities doc renders as its route layer.
|
|
10
10
|
|
|
11
11
|
bkit-graph-surface.py <graph.json> <surface-out.json> [--quiet]
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
#!/usr/bin/env python3
|
|
6
6
|
"""Export the full symbol graph to GraphML for Gephi / yEd.
|
|
7
7
|
|
|
8
|
-
Called by `pnpm graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
|
|
8
|
+
Called by `pnpm bkit:graph:graphml` (scripts/graphify/bkit-graphify.sh) through GRAPHIFY'S
|
|
9
9
|
OWN interpreter — it imports graphify itself.
|
|
10
10
|
|
|
11
11
|
bkit-graphify-graphml.py <graph.json> <out.graphml>
|