@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
|
@@ -30,6 +30,16 @@
|
|
|
30
30
|
"statusMessage": "bkit ReadGuard"
|
|
31
31
|
}
|
|
32
32
|
]
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"matcher": "write_to_file|replace_file_content|view_file|run_command",
|
|
36
|
+
"hooks": [
|
|
37
|
+
{
|
|
38
|
+
"type": "command",
|
|
39
|
+
"command": "f=hooks/bkit-rules.cjs; test -f \"$f\" || f=.agents/plugins/bkit/$f; test -f \"$f\" && node \"$f\" || true",
|
|
40
|
+
"statusMessage": "bkit rules"
|
|
41
|
+
}
|
|
42
|
+
]
|
|
33
43
|
}
|
|
34
44
|
]
|
|
35
45
|
}
|
|
@@ -32,6 +32,7 @@ start fast.
|
|
|
32
32
|
#!/bin/bash
|
|
33
33
|
@@CLOUD_CACHE_BUST@@
|
|
34
34
|
set -euo pipefail
|
|
35
|
+
# bkit-toolchain:start
|
|
35
36
|
|
|
36
37
|
# Every download is pinned to a version and checked against its published sha256
|
|
37
38
|
# before it is unpacked or made executable. The image targets linux/amd64.
|
|
@@ -39,8 +40,8 @@ set -euo pipefail
|
|
|
39
40
|
# `.bkit/templates/.cursor/Dockerfile`. bkit needs Node >=24 and the base image ships
|
|
40
41
|
# older majors, so this one goes into /usr/local and leads PATH for every step below.
|
|
41
42
|
# renovate: datasource=node-version depName=node
|
|
42
|
-
NODE_VERSION="24.
|
|
43
|
-
NODE_SHA256="
|
|
43
|
+
NODE_VERSION="24.22.1"
|
|
44
|
+
NODE_SHA256="6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6"
|
|
44
45
|
if [ "$(/usr/local/bin/node --version 2>/dev/null || true)" != "v${NODE_VERSION}" ]; then
|
|
45
46
|
command -v xz >/dev/null 2>&1 || { apt-get update && apt-get install -y --no-install-recommends xz-utils; }
|
|
46
47
|
cd /tmp
|
|
@@ -53,8 +54,8 @@ export PATH="/usr/local/bin:$PATH"
|
|
|
53
54
|
hash -r
|
|
54
55
|
|
|
55
56
|
# renovate: datasource=github-releases depName=errata-ai/vale
|
|
56
|
-
VALE_VERSION="3.
|
|
57
|
-
VALE_SHA256="
|
|
57
|
+
VALE_VERSION="3.24.0"
|
|
58
|
+
VALE_SHA256="867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
|
|
58
59
|
if ! command -v vale >/dev/null 2>&1; then
|
|
59
60
|
cd /tmp
|
|
60
61
|
curl -fsSLO --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz"
|
|
@@ -64,8 +65,8 @@ if ! command -v vale >/dev/null 2>&1; then
|
|
|
64
65
|
fi
|
|
65
66
|
|
|
66
67
|
# renovate: datasource=github-releases depName=cli/cli
|
|
67
|
-
GH_VERSION="2.
|
|
68
|
-
GH_SHA256="
|
|
68
|
+
GH_VERSION="2.103.0"
|
|
69
|
+
GH_SHA256="fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786"
|
|
69
70
|
if ! command -v gh >/dev/null 2>&1; then
|
|
70
71
|
cd /tmp
|
|
71
72
|
# Pinned release tarball from github.com (same host + install style as vale above),
|
|
@@ -78,8 +79,8 @@ if ! command -v gh >/dev/null 2>&1; then
|
|
|
78
79
|
fi
|
|
79
80
|
|
|
80
81
|
# renovate: datasource=github-releases depName=jqlang/jq extractVersion=^jq-(?<version>.+)$
|
|
81
|
-
JQ_VERSION="1.
|
|
82
|
-
JQ_SHA256="
|
|
82
|
+
JQ_VERSION="1.8.2"
|
|
83
|
+
JQ_SHA256="b1c22172dd303f3be49e935aa56aa48a8b7a46e0bc838b4997d3bb451495870f"
|
|
83
84
|
if ! command -v jq >/dev/null 2>&1; then
|
|
84
85
|
# jq is a single static binary — fetched from the jqlang release (same github.com
|
|
85
86
|
# host as vale/gh above) and checked against the release's sha256sum.txt before it is
|
|
@@ -91,6 +92,7 @@ if ! command -v jq >/dev/null 2>&1; then
|
|
|
91
92
|
install -m 0755 jq-linux-amd64 /usr/local/bin/jq
|
|
92
93
|
rm -f jq-linux-amd64
|
|
93
94
|
fi
|
|
95
|
+
# bkit-toolchain:end
|
|
94
96
|
|
|
95
97
|
@@CLOUD_WORKSPACE_TRUST@@
|
|
96
98
|
|
|
@@ -100,7 +102,7 @@ fi
|
|
|
100
102
|
|
|
101
103
|
@@CLOUD_CONTEXT_FETCH_PROVISION@@
|
|
102
104
|
|
|
103
|
-
echo "cloud
|
|
105
|
+
echo "cloud setup done: node $(node --version), $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)${BKIT_UNAVAILABLE:+ — UNAVAILABLE: $BKIT_UNAVAILABLE}"
|
|
104
106
|
```
|
|
105
107
|
|
|
106
108
|
Keep total runtime under ~5 minutes or the snapshot won't build. `pnpm install`
|
|
@@ -124,7 +126,7 @@ per line):
|
|
|
124
126
|
node --version && vale --version && gh --version && jq --version && pnpm -v
|
|
125
127
|
```
|
|
126
128
|
|
|
127
|
-
`node --version` must print `v24.
|
|
129
|
+
`node --version` must print `v24.22.1`. An older version means the session `PATH`
|
|
128
130
|
puts the image's own Node ahead of `/usr/local/bin`.
|
|
129
131
|
|
|
130
132
|
Then confirm workspace trust. Unset, Claude Code ignores every `permissions.allow`
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
<!-- GENERATED by `bkit install --codex` — do NOT edit or commit. Regenerated every install/upgrade; holds resolved secrets and is gitignored. Reference: .bkit/cloud.md -->
|
|
2
|
+
|
|
3
|
+
# Codex Cloud Environment — {{PROJECT_NAME}}
|
|
4
|
+
|
|
5
|
+
> 🔐 **CONTAINS REAL SECRETS**, resolved from this repo's `.envrc`. This file is
|
|
6
|
+
> gitignored and holds live tokens — never commit or share it. The values only
|
|
7
|
+
> leave your machine when you paste them into ChatGPT's Codex settings.
|
|
8
|
+
>
|
|
9
|
+
> Regenerated on every `bkit install` / `bkit upgrade`. Full reference (PAT
|
|
10
|
+
> permissions, sharing across repos): `.bkit/cloud.md`.
|
|
11
|
+
|
|
12
|
+
This is the Codex twin of `.claude/bkit-cloud.md`: the **same bkit cloud environment**,
|
|
13
|
+
built by Codex's mechanics — a pasted **Install script** plus the environment's
|
|
14
|
+
variables. Cloud tasks can't see your local direnv, user-level pnpm token, or GitHub
|
|
15
|
+
Actions secrets.
|
|
16
|
+
|
|
17
|
+
## 1 · Where
|
|
18
|
+
|
|
19
|
+
ChatGPT → **Settings > Codex Cloud > Environments** → **Create environment** → pick
|
|
20
|
+
this repo → name it **{{PROJECT_NAME}}** (one env per repo — secrets are per-repo) →
|
|
21
|
+
fill the fields below → save.
|
|
22
|
+
|
|
23
|
+
## 2 · Network access
|
|
24
|
+
|
|
25
|
+
@@CODEX_NETWORK@@
|
|
26
|
+
|
|
27
|
+
## 3 · Install script
|
|
28
|
+
|
|
29
|
+
Paste into the **Install script** field. Same pinned, sha256-checked toolchain as the
|
|
30
|
+
Claude setup script, plus the repo install Claude runs from its bootstrap hook:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
#!/bin/bash
|
|
34
|
+
set -euo pipefail
|
|
35
|
+
REPO_ROOT="$(git rev-parse --show-toplevel)"
|
|
36
|
+
# Recorded first: the toolchain's download steps `cd /tmp`, where no repo is found.
|
|
37
|
+
|
|
38
|
+
@@CODEX_TOOLCHAIN@@
|
|
39
|
+
|
|
40
|
+
@@CLOUD_COREPACK@@
|
|
41
|
+
|
|
42
|
+
@@CLOUD_CONTEXT_FETCH_PROVISION@@
|
|
43
|
+
|
|
44
|
+
cd "$REPO_ROOT"
|
|
45
|
+
if [ -f pnpm-lock.yaml ]; then pnpm install --frozen-lockfile; fi
|
|
46
|
+
if [ -f .vale.ini ]; then vale sync; fi
|
|
47
|
+
if [ -n "${BKIT_GH_TOKEN:-}" ]; then
|
|
48
|
+
printf '%s' "$BKIT_GH_TOKEN" | gh auth login --with-token \
|
|
49
|
+
|| echo "[cloud-setup] gh auth login failed (non-blocking); gh will be unauthenticated" >&2
|
|
50
|
+
fi
|
|
51
|
+
|
|
52
|
+
echo "cloud setup done: node $(node --version), $(vale --version), $(gh --version | head -1), jq $(jq --version), pnpm $(pnpm -v)${BKIT_UNAVAILABLE:+ — UNAVAILABLE: $BKIT_UNAVAILABLE (see .bkit/.unavailable)}"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## 4 · Environment variables
|
|
56
|
+
|
|
57
|
+
Paste into **Environment variables** (**Paste your .env or type a key**):
|
|
58
|
+
|
|
59
|
+
```dotenv
|
|
60
|
+
@@CLOUD_ENV_VARS@@
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
@@CLOUD_ENV_NOTES@@
|
|
64
|
+
|
|
65
|
+
- **Environment variables** reach every program as-is — MCP servers, `gh`, `pnpm` and
|
|
66
|
+
bkit read them from the process env. Every line above goes here.
|
|
67
|
+
- **Network secrets** (Key, Value, **Allowed domains**) are optional hardening for a
|
|
68
|
+
token used ONLY over HTTP to known hosts: programs see a placeholder and the proxy
|
|
69
|
+
swaps in the real value for the allowed destinations, during setup and tasks. A
|
|
70
|
+
token a program reads directly (e.g. `printf '%s' "$BKIT_GH_TOKEN" | gh auth login`)
|
|
71
|
+
breaks there — keep those as environment variables.
|
|
72
|
+
- **Personal vault** shares a secret across **All environments** or **Selected
|
|
73
|
+
environments** — use it for a token several repos reuse (e.g. `BKIT_GH_TOKEN`).
|
|
74
|
+
- `BKIT_GH_TOKEN` PAT permissions (fine-grained for one owner, classic across owners) are
|
|
75
|
+
documented in `.bkit/cloud.md` § `BKIT_GH_TOKEN` — token permissions (identical scope
|
|
76
|
+
to the Claude side).
|
|
77
|
+
|
|
78
|
+
## 5 · Hooks and guardrails
|
|
79
|
+
|
|
80
|
+
Repository skills (`.agents/skills/bkit-*`, invoked `$bkit-design`) load in cloud
|
|
81
|
+
tasks. Codex's cloud docs say nothing about **hooks**: treat GateGuard, ReadGuard and
|
|
82
|
+
the guardrails hook from `.codex/hooks.json` as **unproven** in cloud tasks — review
|
|
83
|
+
cloud diffs as unguarded. Locally those hooks fire only once the `.codex/` layer is
|
|
84
|
+
trusted (`.bkit/providers.md` § Codex CLI — three deviations).
|
|
85
|
+
|
|
86
|
+
## 6 · Verify (first task)
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
node --version && vale --version && gh --version && jq --version && pnpm -v && gh auth status
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
`node --version` must print the `NODE_VERSION` from the install script. An older
|
|
93
|
+
version means the task `PATH` puts the image's own Node ahead of `/usr/local/bin`.
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
`BKIT_GH_TOKEN` PAT permissions, the one-environment-per-repo rationale and the
|
|
98
|
+
cloud-agent support matrix all live in `.bkit/cloud.md` § Codex Cloud.
|
|
@@ -30,6 +30,26 @@
|
|
|
30
30
|
"statusMessage": "bkit ReadGuard"
|
|
31
31
|
}
|
|
32
32
|
]
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"matcher": "apply_patch",
|
|
36
|
+
"hooks": [
|
|
37
|
+
{
|
|
38
|
+
"type": "command",
|
|
39
|
+
"command": "test -f .codex/hooks/bkit-rules.cjs && node .codex/hooks/bkit-rules.cjs || true",
|
|
40
|
+
"statusMessage": "bkit rules"
|
|
41
|
+
}
|
|
42
|
+
]
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"matcher": "Bash",
|
|
46
|
+
"hooks": [
|
|
47
|
+
{
|
|
48
|
+
"type": "command",
|
|
49
|
+
"command": "test -f .codex/hooks/bkit-rules.cjs && node .codex/hooks/bkit-rules.cjs || true",
|
|
50
|
+
"statusMessage": "bkit rules"
|
|
51
|
+
}
|
|
52
|
+
]
|
|
33
53
|
}
|
|
34
54
|
],
|
|
35
55
|
"PreCompact": [
|
|
@@ -50,15 +50,15 @@ Add **each** line below as a secret (Name = the key, Value = the value). Set the
|
|
|
50
50
|
## 3 · Toolchain (in-repo — nothing to paste)
|
|
51
51
|
|
|
52
52
|
The base image bakes the **same tools at the same versions as the Claude setup
|
|
53
|
-
script** — vale 3.
|
|
53
|
+
script** — vale 3.24.0, gh, jq, python3, corepack-pinned pnpm — so both clouds run an
|
|
54
54
|
identical bkit toolchain:
|
|
55
55
|
|
|
56
56
|
- `.cursor/Dockerfile` — image build, your copy of the template (keep its
|
|
57
57
|
`bkit toolchain` section as shipped; set Node major / Playwright / extra apt deps
|
|
58
58
|
outside it).
|
|
59
59
|
- `.cursor/environment.json` — per-snapshot `install` (`pnpm install
|
|
60
|
-
--frozen-lockfile` + `vale sync`), the analogue
|
|
61
|
-
`.claude/hooks/bkit-cloud-bootstrap.sh`. (`install` / `start` / `terminals` are the
|
|
60
|
+
--frozen-lockfile` + `vale sync` + `pnpm exec bkit context provision`), the analogue
|
|
61
|
+
of Claude's `.claude/hooks/bkit-cloud-bootstrap.sh`. (`install` / `start` / `terminals` are the
|
|
62
62
|
environment.json fields Cursor runs.)
|
|
63
63
|
|
|
64
64
|
After changing either, run `pnpm bkit install` and commit — the first session
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
"mcp": {
|
|
102
102
|
"@@OPENCODE_TRACKER_MCP@@": {}
|
|
103
103
|
},
|
|
104
|
-
"plugin": ["./plugin/bkit-gateguard.js", "./plugin/bkit-readguard.js"],
|
|
104
|
+
"plugin": ["./plugin/bkit-gateguard.js", "./plugin/bkit-readguard.js", "./plugin/bkit-rules.js"],
|
|
105
105
|
"provider": {
|
|
106
106
|
"@@OPENCODE_PROVIDER_KEY@@": {
|
|
107
107
|
"npm": "@ai-sdk/openai-compatible",
|
package/.bkit/shared/CLAUDE.md
CHANGED
|
@@ -6,6 +6,10 @@
|
|
|
6
6
|
|
|
7
7
|
- **Rules file:** Read `.agents/rules.md` → follow all rules.
|
|
8
8
|
|
|
9
|
-
**Memory hygiene:** Claude Code auto-memories (`MEMORY.md` + `memory/*.md`) are pointers, never copies.
|
|
9
|
+
**Memory hygiene:** Claude Code auto-memories (`MEMORY.md` + `memory/*.md`) are pointers, never copies.
|
|
10
|
+
|
|
11
|
+
- For a fact in `docs/*.md`, `.agents/rules.md` or `CLAUDE.md`, save only its path, its section and a one-line hook.
|
|
12
|
+
- Query the tracker or `docs/roadmap.md` for an issue's state.
|
|
13
|
+
- Never save a snapshot of an issue's state in memory.
|
|
10
14
|
|
|
11
15
|
<!-- bkit:end -->
|
package/.bkit/shared/GEMINI.md
CHANGED
|
@@ -6,6 +6,9 @@
|
|
|
6
6
|
|
|
7
7
|
- **Rules file:** Read `.agents/rules.md` → follow all rules.
|
|
8
8
|
|
|
9
|
-
**Memory hygiene:**
|
|
9
|
+
**Memory hygiene:** Durable facts live in `docs/*.md`, `.agents/rules.md` or this file. Antigravity loads `GEMINI.md` as a workspace rule, so keep this file a pointer, never a copy.
|
|
10
|
+
|
|
11
|
+
- Query the tracker or `docs/roadmap.md` for an issue's state.
|
|
12
|
+
- Never save a snapshot of an issue's state here.
|
|
10
13
|
|
|
11
14
|
<!-- bkit:end -->
|
|
@@ -5,15 +5,12 @@
|
|
|
5
5
|
# Architecture
|
|
6
6
|
|
|
7
7
|
> [!CAUTION]
|
|
8
|
-
> **Purpose:**
|
|
8
|
+
> **Purpose:** The system design: service boundaries, deployment topology and an integration sketch.
|
|
9
9
|
>
|
|
10
10
|
> **Rules:**
|
|
11
11
|
>
|
|
12
|
-
> -
|
|
13
|
-
> -
|
|
14
|
-
> -
|
|
15
|
-
> - Check `.agents/docs.md` index first and confirm topic belongs in this doc, not another.
|
|
16
|
-
> - Topology / boundaries only; operational rules and library lists → domain docs.
|
|
17
|
-
> - Update on package add / remove or boundary shift.
|
|
12
|
+
> - Follow `.bkit/authoring.md` § All Agent-Read Files and § Docs when you edit this file.
|
|
13
|
+
> - Hold topology and boundaries only. Operational rules and library lists go in the domain docs.
|
|
14
|
+
> - Update this file when a package is added or removed, or a boundary shifts.
|
|
18
15
|
|
|
19
16
|
<!-- bkit:end -->
|
|
@@ -5,15 +5,12 @@
|
|
|
5
5
|
# Data Schema
|
|
6
6
|
|
|
7
7
|
> [!CAUTION]
|
|
8
|
-
> **Purpose:**
|
|
8
|
+
> **Purpose:** The active production database schema: entities / tables, fields, access policies (e.g. RLS), indices and triggers.
|
|
9
9
|
>
|
|
10
10
|
> **Rules:**
|
|
11
11
|
>
|
|
12
|
-
> -
|
|
13
|
-
> -
|
|
14
|
-
> -
|
|
15
|
-
> - Check `.agents/docs.md` index first and confirm topic belongs in this doc, not another.
|
|
16
|
-
> - One section / table: `Field | Type | Unique | Notes`, `Indices`, `Pending`.
|
|
17
|
-
> - Fields whose existence is a decision: link `decisions.jsonl` ADR; do not restate rationale.
|
|
12
|
+
> - Follow `.bkit/authoring.md` § All Agent-Read Files and § Docs when you edit this file.
|
|
13
|
+
> - Give each table one section, holding a `Field | Type | Unique | Notes` table, `Indices` and `Pending`.
|
|
14
|
+
> - For a field whose existence is a decision, link its ADR in `decisions.jsonl`, and do not restate the rationale.
|
|
18
15
|
|
|
19
16
|
<!-- bkit:end -->
|