@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
|
@@ -98,7 +98,7 @@ function gitDenyRule(g) {
|
|
|
98
98
|
if (g.long.has("--force") || g.short.has("f") || g.args.some((a) => a.startsWith("+"))) {
|
|
99
99
|
return {
|
|
100
100
|
what: "git force-push",
|
|
101
|
-
fix: "
|
|
101
|
+
fix: "NEVER force-push (--force, -f or a +refspec). Use a normal push, or --force-with-lease only when the user explicitly asks for it on a personal branch.",
|
|
102
102
|
};
|
|
103
103
|
}
|
|
104
104
|
return null;
|
|
@@ -153,13 +153,13 @@ function denyRule(c) {
|
|
|
153
153
|
) {
|
|
154
154
|
return {
|
|
155
155
|
what: "recursive delete of a filesystem root",
|
|
156
|
-
fix: "
|
|
156
|
+
fix: "NEVER run rm -rf against /, ~, or $HOME. Narrow the path to the target directory.",
|
|
157
157
|
};
|
|
158
158
|
}
|
|
159
159
|
if (/\bchmod\s+-R\s+777\s+\//.test(c)) {
|
|
160
160
|
return {
|
|
161
161
|
what: "chmod -R 777 on the filesystem root",
|
|
162
|
-
fix: "
|
|
162
|
+
fix: "NEVER make the filesystem root world-writable.",
|
|
163
163
|
};
|
|
164
164
|
}
|
|
165
165
|
return null;
|
|
@@ -4,16 +4,16 @@
|
|
|
4
4
|
|
|
5
5
|
# BKIT_LINEAR_API_KEY required to call the Linear GraphQL API.
|
|
6
6
|
if [[ -z "${BKIT_LINEAR_API_KEY:-}" ]]; then
|
|
7
|
-
echo "Guard pre-check: FAIL
|
|
8
|
-
emit_context "Guard pre-check: FAIL
|
|
7
|
+
echo "Guard pre-check: FAIL. BKIT_LINEAR_API_KEY not set, so ${LINEAR_ISSUE_ID:-(unset)} cannot be validated." >&2
|
|
8
|
+
emit_context "Guard pre-check: FAIL. BKIT_LINEAR_API_KEY is not set, so bkit cannot check ${LINEAR_ISSUE_ID:-(unset)}. HARD STOP: refuse any Linear-related work. Report the failure to the user, then stop."
|
|
9
9
|
exit 1
|
|
10
10
|
fi
|
|
11
11
|
|
|
12
12
|
# LINEAR_ISSUE_ID required (Claude's trigger above already demands it; a Cursor Cloud
|
|
13
13
|
# Agent sets it from workflow context).
|
|
14
14
|
if [[ -z "${LINEAR_ISSUE_ID:-}" ]]; then
|
|
15
|
-
echo "Guard pre-check: FAIL
|
|
16
|
-
emit_context "Guard pre-check: FAIL
|
|
15
|
+
echo "Guard pre-check: FAIL. LINEAR_ISSUE_ID not set." >&2
|
|
16
|
+
emit_context "Guard pre-check: FAIL. LINEAR_ISSUE_ID is not set. HARD STOP: refuse any Linear-related work. Report the failure to the user, then stop."
|
|
17
17
|
exit 1
|
|
18
18
|
fi
|
|
19
19
|
|
|
@@ -31,8 +31,8 @@ RESPONSE=$(curl -sS \
|
|
|
31
31
|
-H "Authorization: ${BKIT_LINEAR_API_KEY}" \
|
|
32
32
|
--data "$BODY" \
|
|
33
33
|
"https://api.linear.app/graphql" 2>/dev/null) || {
|
|
34
|
-
echo "Guard pre-check: FAIL
|
|
35
|
-
emit_context "Guard pre-check: FAIL
|
|
34
|
+
echo "Guard pre-check: FAIL. Linear API request failed for ${LINEAR_ISSUE_ID}." >&2
|
|
35
|
+
emit_context "Guard pre-check: FAIL. The Linear API could not be reached for ${LINEAR_ISSUE_ID}. HARD STOP: refuse any Linear-related work. Report the failure to the user, then stop."
|
|
36
36
|
exit 1
|
|
37
37
|
}
|
|
38
38
|
|
|
@@ -60,12 +60,12 @@ fi
|
|
|
60
60
|
|
|
61
61
|
# Guard 2: Issue must not be in a terminal state.
|
|
62
62
|
if [[ "$ISSUE_STATE" == "Cancelled" || "$ISSUE_STATE" == "Done" ]]; then
|
|
63
|
-
FAIL_REASON="
|
|
63
|
+
FAIL_REASON="the issue is in a terminal state (${ISSUE_STATE})"
|
|
64
64
|
fi
|
|
65
65
|
|
|
66
66
|
if [[ -n "$FAIL_REASON" ]]; then
|
|
67
|
-
echo "Guard pre-check: FAIL
|
|
68
|
-
emit_context "Guard pre-check: FAIL
|
|
67
|
+
echo "Guard pre-check: FAIL. Issue ${ISSUE_ID_DISPLAY}: ${FAIL_REASON}" >&2
|
|
68
|
+
emit_context "Guard pre-check: FAIL. Issue ${ISSUE_ID_DISPLAY}: ${FAIL_REASON}. HARD STOP: refuse any Linear-related work on this issue. Report the failure to the user, then stop."
|
|
69
69
|
exit 1
|
|
70
70
|
fi
|
|
71
71
|
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# --- Rules-read advisory: the one session-start nudge (bkit renders it from this one
|
|
2
|
+
# source into each SessionStart host's hook). Advisory only: it names `.agents/rules.md`
|
|
3
|
+
# and no other file, never blocks a session and never changes the exit code. Needs
|
|
4
|
+
# `emit_context`, which the host's own code above defines.
|
|
5
|
+
|
|
6
|
+
BKIT_RULES_ADVISORY='[bkit] Required reading before any other action: read `.agents/rules.md` and follow every rule in it.'
|
|
7
|
+
|
|
8
|
+
emit_context "$BKIT_RULES_ADVISORY"
|
|
@@ -148,10 +148,17 @@ function isCovered(ranges, [start, end]) {
|
|
|
148
148
|
return mergeRanges(ranges).some(([s, e]) => s <= start && end <= e);
|
|
149
149
|
}
|
|
150
150
|
|
|
151
|
+
// Per user: on a temp dir users share (Linux `/tmp`) another user's copy cannot be written.
|
|
151
152
|
function readStateDir() {
|
|
152
|
-
return path.join(
|
|
153
|
+
return path.join(
|
|
154
|
+
os.tmpdir(),
|
|
155
|
+
typeof process.getuid === "function" ? `bkit-readguard-${process.getuid()}` : "bkit-readguard",
|
|
156
|
+
);
|
|
153
157
|
}
|
|
154
158
|
|
|
159
|
+
// Read logs this process could not write, standing in for them for the process's life.
|
|
160
|
+
const readLogsInProcess = new Map();
|
|
161
|
+
|
|
155
162
|
function safeKey(value, fallback) {
|
|
156
163
|
const s = typeof value === "string" ? value.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 128) : "";
|
|
157
164
|
return s || fallback;
|
|
@@ -169,6 +176,7 @@ function readLogFile(sessionId, agentId) {
|
|
|
169
176
|
// Absent log is the normal first-read case (guarded, no throw); a corrupt one throws
|
|
170
177
|
// to the host's top-level fail-open boundary and that one call no-ops.
|
|
171
178
|
function loadReadLog(file) {
|
|
179
|
+
if (readLogsInProcess.has(file)) return readLogsInProcess.get(file);
|
|
172
180
|
if (!fs.existsSync(file)) return { files: {} };
|
|
173
181
|
const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
|
|
174
182
|
return parsed && typeof parsed.files === "object" && parsed.files ? parsed : { files: {} };
|
|
@@ -191,9 +199,12 @@ function gcOldReadLogs() {
|
|
|
191
199
|
* conversation is summarised: earlier read output is no longer in context.
|
|
192
200
|
*/
|
|
193
201
|
function resetReadLog(sessionId) {
|
|
202
|
+
const prefix = `${safeKey(sessionId, "no-session")}.`;
|
|
203
|
+
for (const file of readLogsInProcess.keys()) {
|
|
204
|
+
if (path.basename(file).startsWith(prefix)) readLogsInProcess.delete(file);
|
|
205
|
+
}
|
|
194
206
|
const dir = readStateDir();
|
|
195
207
|
if (!fs.existsSync(dir)) return;
|
|
196
|
-
const prefix = `${safeKey(sessionId, "no-session")}.`;
|
|
197
208
|
for (const name of fs.readdirSync(dir)) {
|
|
198
209
|
if (name.startsWith(prefix)) fs.rmSync(path.join(dir, name), { force: true });
|
|
199
210
|
}
|
|
@@ -210,17 +221,20 @@ function repeatReadMessage(repeats, cwd) {
|
|
|
210
221
|
`- \`${displayPath(file, cwd)}\` lines ${range[0]}-${range[1] === OPEN_END ? "end" : range[1]}`,
|
|
211
222
|
);
|
|
212
223
|
return (
|
|
213
|
-
`[bkit ReadGuard] Repeat read this conversation
|
|
224
|
+
`[bkit ReadGuard] Repeat read in this conversation. These lines are unchanged since your last read:\n` +
|
|
214
225
|
`${lines.join("\n")}\n` +
|
|
215
|
-
`Use the earlier output
|
|
216
|
-
`
|
|
226
|
+
`Use the earlier output instead of reading these lines again.\n` +
|
|
227
|
+
`If that output is no longer in your context (summarised, or read by another agent), re-read the lines.\n` +
|
|
228
|
+
`Advisory: proceed once satisfied.`
|
|
217
229
|
);
|
|
218
230
|
}
|
|
219
231
|
|
|
220
232
|
/**
|
|
221
233
|
* The advisory for reading `targets` again, or null when ReadGuard is off, nothing is
|
|
222
234
|
* trackable, or no target repeats an earlier read of the same unchanged file by the
|
|
223
|
-
* same (session, agent). Records every trackable target.
|
|
235
|
+
* same (session, agent). Records every trackable target. Fail-open: a log write error
|
|
236
|
+
* still returns the note and the process keeps the log, so a long-lived host (opencode)
|
|
237
|
+
* still sees its repeats.
|
|
224
238
|
*/
|
|
225
239
|
function repeatReadAdvice(targets, sessionId, agentId, cwd) {
|
|
226
240
|
if (process.env.BKIT_READGUARD === "off") return null;
|
|
@@ -249,11 +263,16 @@ function repeatReadAdvice(targets, sessionId, agentId, cwd) {
|
|
|
249
263
|
changed = true;
|
|
250
264
|
}
|
|
251
265
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
266
|
+
try {
|
|
267
|
+
if (changed) {
|
|
268
|
+
fs.mkdirSync(readStateDir(), { recursive: true });
|
|
269
|
+
fs.writeFileSync(logFile, JSON.stringify(log), "utf-8");
|
|
270
|
+
readLogsInProcess.delete(logFile);
|
|
271
|
+
}
|
|
272
|
+
gcOldReadLogs();
|
|
273
|
+
} catch {
|
|
274
|
+
readLogsInProcess.set(logFile, log);
|
|
255
275
|
}
|
|
256
|
-
gcOldReadLogs();
|
|
257
276
|
|
|
258
277
|
return repeats.length > 0 ? repeatReadMessage(repeats, cwd) : null;
|
|
259
278
|
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
// --- Rules-read advisory: the one first-tool-call nudge (bkit renders it from this one
|
|
2
|
+
// source into every host hook whose host has no session-start event: opencode, Codex,
|
|
3
|
+
// Antigravity). Advisory only: it names `.agents/rules.md` and no other file, never blocks
|
|
4
|
+
// and never throws. Needs `fs`, `os` and `path` in scope; the host's own code above
|
|
5
|
+
// declares them. Plain declarations only — no `export` and no `import`: renderParts copies
|
|
6
|
+
// these bytes into each host template, so either would make the rendered CJS hook invalid.
|
|
7
|
+
|
|
8
|
+
const RULES_READ_ADVISORY =
|
|
9
|
+
"[bkit] Required reading before any other action: read `.agents/rules.md` and follow every rule in it.";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* The OS-temp dir holding one state file per session the advisory already reached. Per
|
|
13
|
+
* user: on a temp dir users share (Linux `/tmp`) another user's copy cannot be written.
|
|
14
|
+
*/
|
|
15
|
+
function rulesAdvisoryStateDir() {
|
|
16
|
+
const user = typeof process.getuid === "function" ? `-${process.getuid()}` : "";
|
|
17
|
+
return path.join(os.tmpdir(), `bkit-rules-advisory${user}`);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** State files this process could not write, standing in for them for the process's life. */
|
|
21
|
+
const rulesAdvisedInProcess = new Set();
|
|
22
|
+
|
|
23
|
+
/** One state file per session id; a payload with no id falls back to one shared bucket. */
|
|
24
|
+
function rulesAdvisoryFile(sessionId) {
|
|
25
|
+
const safe =
|
|
26
|
+
typeof sessionId === "string" ? sessionId.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 128) : "";
|
|
27
|
+
return path.join(rulesAdvisoryStateDir(), `${safe || "no-session"}.json`);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Opportunistic TTL: drops state files older than 24h. */
|
|
31
|
+
function rulesAdvisoryGc() {
|
|
32
|
+
const dir = rulesAdvisoryStateDir();
|
|
33
|
+
if (!fs.existsSync(dir)) return;
|
|
34
|
+
const cutoff = Date.now() - 24 * 60 * 60 * 1000;
|
|
35
|
+
for (const name of fs.readdirSync(dir)) {
|
|
36
|
+
const file = path.join(dir, name);
|
|
37
|
+
const stat = fs.statSync(file, { throwIfNoEntry: false });
|
|
38
|
+
if (stat && stat.mtimeMs < cutoff) fs.rmSync(file, { force: true });
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* The advisory the first time `sessionId` is seen, null after. State lives in the OS temp
|
|
44
|
+
* dir — never in the consumer repo — and is GC'd after 24h. Fail-open: a state-file error
|
|
45
|
+
* returns the advisory instead of throwing, so the nudge is never lost to a bad state, and
|
|
46
|
+
* the process remembers it, so a long-lived host (opencode) does not repeat it every call.
|
|
47
|
+
*/
|
|
48
|
+
function rulesReadAdviceOnce(sessionId) {
|
|
49
|
+
const file = rulesAdvisoryFile(sessionId);
|
|
50
|
+
try {
|
|
51
|
+
if (fs.existsSync(file)) return null;
|
|
52
|
+
fs.mkdirSync(rulesAdvisoryStateDir(), { recursive: true });
|
|
53
|
+
fs.writeFileSync(file, JSON.stringify({ at: Date.now() }), "utf-8");
|
|
54
|
+
rulesAdvisoryGc();
|
|
55
|
+
return RULES_READ_ADVISORY;
|
|
56
|
+
} catch {
|
|
57
|
+
if (rulesAdvisedInProcess.has(file)) return null;
|
|
58
|
+
rulesAdvisedInProcess.add(file);
|
|
59
|
+
return RULES_READ_ADVISORY;
|
|
60
|
+
}
|
|
61
|
+
}
|