@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
package/.bkit/shared/gitignore
CHANGED
|
@@ -50,6 +50,9 @@ docs/plans/*/logs/**/.rebase-failed
|
|
|
50
50
|
# Cursor background-agent runtime marker
|
|
51
51
|
.bkit/.runtime-cursor
|
|
52
52
|
|
|
53
|
+
# Provision recipes that failed in this cloud environment (`bkit context provision`)
|
|
54
|
+
.bkit/.unavailable
|
|
55
|
+
|
|
53
56
|
.bkit/.roadmap-shortlist.json
|
|
54
57
|
.bkit/.roadmap-reverse-sync.json
|
|
55
58
|
|
|
@@ -57,12 +60,13 @@ docs/plans/*/logs/**/.rebase-failed
|
|
|
57
60
|
.claude/scheduled_tasks.lock
|
|
58
61
|
|
|
59
62
|
# Cloud setup docs — `bkit install` inlines resolved .envrc secrets; never commit.
|
|
60
|
-
# One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor
|
|
63
|
+
# One per host: .claude/bkit-cloud.md (Claude Code web), .cursor/bkit-cloud.md (Cursor Cloud Agents), .codex/bkit-cloud.md (Codex Cloud)
|
|
61
64
|
.claude/bkit-cloud.md
|
|
62
65
|
.cursor/bkit-cloud.md
|
|
66
|
+
.codex/bkit-cloud.md
|
|
63
67
|
|
|
64
68
|
# Claude native worktrees (isolation:worktree / EnterWorktree) — transient full-tree
|
|
65
|
-
# copies; ignore or slop:delta double-counts the checkout
|
|
69
|
+
# copies; ignore or bkit:slop:delta double-counts the checkout
|
|
66
70
|
.claude/worktrees/
|
|
67
71
|
|
|
68
72
|
# cursor / opencode — no project-local worktree or runtime dir to ignore.
|
|
@@ -128,28 +128,27 @@ fi
|
|
|
128
128
|
# bkit runs whatever `context-fetch:provision` recipe each block carries (self-guarded with
|
|
129
129
|
# `command -v <cli> || <install>`), so no stack name is baked into bkit. Runs every session
|
|
130
130
|
# (a no-op once the CLI is present); the web setup script bakes the same recipes into its
|
|
131
|
-
# snapshot, so this is the gh-runner + resumed-session path. `bkit context
|
|
132
|
-
#
|
|
133
|
-
#
|
|
134
|
-
#
|
|
131
|
+
# snapshot, so this is the gh-runner + resumed-session path. `bkit context provision`
|
|
132
|
+
# (installed by the `pnpm install` above) runs the same region the setup scripts inline:
|
|
133
|
+
# each recipe on its own, a failure named with its last error line, and the failures listed
|
|
134
|
+
# in .bkit/.unavailable. See .agents/context.md.
|
|
135
135
|
if [ -f .agents/context.md ]; then
|
|
136
136
|
BKIT="$REPO_ROOT/node_modules/.bin/bkit"
|
|
137
|
-
if [ ! -x "$BKIT" ]
|
|
138
|
-
log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit)
|
|
137
|
+
if [ ! -x "$BKIT" ]; then
|
|
138
|
+
log "context-fetch provisioning: SKIPPED — bkit (node_modules/.bin/bkit) is missing. Fix: a working 'pnpm install'."
|
|
139
139
|
else
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
log "provisioning context-fetch CLIs from .agents/context.md"
|
|
143
|
-
# pnpm refuses `add -g` unless its global-bin dir is on PATH (corepack pnpm skips
|
|
144
|
-
# `pnpm setup`); export it so `pnpm add -g` provision recipes don't self-skip. Mirrors
|
|
145
|
-
# the web setup script's provision region, which bkit's install engine renders.
|
|
146
|
-
export PNPM_HOME="${PNPM_HOME:-$HOME/.local/share/pnpm}"
|
|
147
|
-
export PATH="$PNPM_HOME:$PNPM_HOME/bin:$PATH"
|
|
148
|
-
printf '%s\n' "$PROVISION" | bash || log "context-fetch CLI provisioning failed (non-blocking)"
|
|
149
|
-
fi
|
|
140
|
+
log "provisioning from .agents/context.md (bkit context provision)"
|
|
141
|
+
"$BKIT" context provision >/dev/null || log "bkit context provision did not run (non-blocking)"
|
|
150
142
|
fi
|
|
151
143
|
fi
|
|
152
144
|
|
|
145
|
+
# SessionStart stdout is added to the session's context: tell the agent what setup could
|
|
146
|
+
# not provide, so it treats those as absent instead of retrying their install.
|
|
147
|
+
if [ -s .bkit/.unavailable ]; then
|
|
148
|
+
printf 'Cloud setup could not provide these in this session (setup failed; treat them as absent, do not retry the install):\n'
|
|
149
|
+
cat .bkit/.unavailable
|
|
150
|
+
fi
|
|
151
|
+
|
|
153
152
|
# --- Per-repo install steps -------------------------------------------------
|
|
154
153
|
# Add your own steps here. Examples:
|
|
155
154
|
#
|
|
@@ -18,13 +18,17 @@ FROM ubuntu:26.04@sha256:2260313b31c8c011cd2eebe728008efac1b3982be73eb71348ea264
|
|
|
18
18
|
# --- Consumer-owned: base system + Node ------------------------------------
|
|
19
19
|
# bkit's toolchain assumes curl, ca-certificates, and Node >=24 are on PATH
|
|
20
20
|
# before the bkit toolchain section runs. Pin Node to match your repo's `engines.node`.
|
|
21
|
+
# apt packages here and below carry no version: they track the pinned base release,
|
|
22
|
+
# security updates included. `pkg=<version>` pins break rebuilds once Ubuntu drops
|
|
23
|
+
# the superseded version from its mirrors; tools whose version matters are pinned
|
|
24
|
+
# and checksum-checked outside apt.
|
|
21
25
|
RUN apt-get update && apt-get install -y --no-install-recommends \
|
|
22
26
|
curl ca-certificates xz-utils \
|
|
23
27
|
&& rm -rf /var/lib/apt/lists/*
|
|
24
28
|
# Node — nodejs.org tarball checked against SHASUMS256.txt (linux-x64).
|
|
25
29
|
# renovate: datasource=node-version depName=node
|
|
26
|
-
ARG NODE_VERSION=24.
|
|
27
|
-
ARG NODE_SHA256=
|
|
30
|
+
ARG NODE_VERSION=24.22.1
|
|
31
|
+
ARG NODE_SHA256=6c172a9ab6718f7b801fb5a7bd486af2ee5e32758086a04b84fcce2aa77095e6
|
|
28
32
|
RUN cd /tmp \
|
|
29
33
|
&& curl -fsSLO --retry 3 --retry-all-errors "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
|
30
34
|
&& echo "${NODE_SHA256} node-v${NODE_VERSION}-linux-x64.tar.xz" | sha256sum -c - \
|
|
@@ -43,18 +47,18 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
|
|
|
43
47
|
|
|
44
48
|
# gh CLI — git push, PR ops, CI cache lookup. Release tarball checked against the release's checksums.txt.
|
|
45
49
|
# renovate: datasource=github-releases depName=cli/cli
|
|
46
|
-
ARG GH_VERSION=2.
|
|
47
|
-
ARG GH_SHA256=
|
|
50
|
+
ARG GH_VERSION=2.103.0
|
|
51
|
+
ARG GH_SHA256=fdd768eb70f6409f80fcfa9f3a1c0adf0fc98d827ab3ce0bed2ac22762c5d786
|
|
48
52
|
RUN cd /tmp \
|
|
49
53
|
&& curl -fsSLO --retry 3 --retry-all-errors "https://github.com/cli/cli/releases/download/v${GH_VERSION}/gh_${GH_VERSION}_linux_amd64.tar.gz" \
|
|
50
54
|
&& echo "${GH_SHA256} gh_${GH_VERSION}_linux_amd64.tar.gz" | sha256sum -c - \
|
|
51
55
|
&& tar -xzf "gh_${GH_VERSION}_linux_amd64.tar.gz" -C /usr/local/bin --strip-components=2 "gh_${GH_VERSION}_linux_amd64/bin/gh" \
|
|
52
56
|
&& rm -f "gh_${GH_VERSION}_linux_amd64.tar.gz"
|
|
53
57
|
|
|
54
|
-
# vale — `pnpm lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
|
|
58
|
+
# vale — `pnpm bkit:lint:prose`. Version pinned for snapshot reproducibility; tarball checked before extract.
|
|
55
59
|
# renovate: datasource=github-releases depName=errata-ai/vale
|
|
56
|
-
ARG VALE_VERSION=3.
|
|
57
|
-
ARG VALE_SHA256=
|
|
60
|
+
ARG VALE_VERSION=3.24.0
|
|
61
|
+
ARG VALE_SHA256=867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214
|
|
58
62
|
RUN cd /tmp \
|
|
59
63
|
&& 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" \
|
|
60
64
|
&& echo "${VALE_SHA256} vale_${VALE_VERSION}_Linux_64-bit.tar.gz" | sha256sum -c - \
|
|
@@ -64,7 +68,7 @@ RUN cd /tmp \
|
|
|
64
68
|
|
|
65
69
|
# pnpm — corepack-pinned to match `packageManager` in package.json.
|
|
66
70
|
# renovate: datasource=npm depName=pnpm
|
|
67
|
-
ARG PNPM_VERSION=10.34.
|
|
71
|
+
ARG PNPM_VERSION=10.34.7
|
|
68
72
|
RUN corepack enable && corepack prepare "pnpm@${PNPM_VERSION}" --activate
|
|
69
73
|
|
|
70
74
|
# --- Consumer extensions ---------------------------------------------------
|
|
@@ -9,10 +9,12 @@ body:
|
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
11
|
Next step:
|
|
12
|
-
-
|
|
13
|
-
-
|
|
12
|
+
- **If** a test or CI run already fails → run `/bkit-debug #<issue number>` on the branch the fix should land on. Debug commits to the branch it runs on.
|
|
13
|
+
- **If** nothing fails yet → run `/bkit-debug #<issue number> [repro]`. It writes a test that fails the way this report describes, then fixes the code until the test passes. **If** no test fails → it stops and says so.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
**If** the bug is intermittent → add `[soak]`. Debug then works one step per attempt, either adding logging or trying one fix, instead of one diagnosis and one fix:
|
|
16
|
+
- With `[repro]` → the test it writes repeats the scenario until it fails.
|
|
17
|
+
- Without `[repro]` → soak starts only from a test or CI run that already fails. **If** every test passes → the run writes its summary and changes no code.
|
|
16
18
|
- type: textarea
|
|
17
19
|
id: failing
|
|
18
20
|
attributes:
|
|
@@ -37,7 +39,7 @@ body:
|
|
|
37
39
|
id: steps
|
|
38
40
|
attributes:
|
|
39
41
|
label: Steps to reproduce
|
|
40
|
-
description: Numbered
|
|
42
|
+
description: Numbered steps from a clean start.
|
|
41
43
|
placeholder: |
|
|
42
44
|
1.
|
|
43
45
|
2.
|
|
@@ -56,22 +58,22 @@ body:
|
|
|
56
58
|
id: area
|
|
57
59
|
attributes:
|
|
58
60
|
label: Affected area
|
|
59
|
-
description: The route, command, file or module that misbehaves. Files named here are treated as what to fix
|
|
61
|
+
description: The route, command, file or module that misbehaves. Files named here are treated as what to fix. Files seen only in a stack trace are not.
|
|
60
62
|
- type: textarea
|
|
61
63
|
id: where
|
|
62
64
|
attributes:
|
|
63
65
|
label: Where and when
|
|
64
|
-
description:
|
|
66
|
+
description: The environment (for example production or preview), the version or commit, when it was first and last seen in UTC, and the last version that worked.
|
|
65
67
|
- type: textarea
|
|
66
68
|
id: evidence
|
|
67
69
|
attributes:
|
|
68
70
|
label: Evidence
|
|
69
|
-
description: Logs, error-tracker IDs or links, screenshots.
|
|
71
|
+
description: Logs, error-tracker IDs or links, and screenshots.
|
|
70
72
|
- type: textarea
|
|
71
73
|
id: references
|
|
72
74
|
attributes:
|
|
73
75
|
label: References
|
|
74
|
-
description: Related issues with their
|
|
76
|
+
description: Related issues with their titles, the feature that introduced the bug, and ledger rows by `key`. Nothing fetches these, so write exact keys and numbers that agents can search for.
|
|
75
77
|
placeholder: |
|
|
76
78
|
Related: #<number> — <its title>
|
|
77
79
|
Introduced by: 41-csv-import
|
|
@@ -8,24 +8,23 @@ body:
|
|
|
8
8
|
- type: markdown
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
|
-
Write this as the plan
|
|
12
|
-
- `/bkit-plan #<issue number>` turns
|
|
13
|
-
- `/bkit-build #<issue number>` converts this issue into a plan, then builds it
|
|
14
|
-
- `build:lite` builds from this issue too but checks nothing: no failing-test proof, gates, PR or CI.
|
|
11
|
+
Write this issue as the plan. A build with no plan converts this issue into one.
|
|
12
|
+
- `/bkit-plan #<issue number>` turns this issue into a checked plan. The build then proves each **TEST FIRST** test fails before its code exists.
|
|
13
|
+
- `/bkit-build #<issue number>` converts this issue into a plan, then builds it. It proves each **TEST FIRST** test fails before its code exists.
|
|
15
14
|
|
|
16
|
-
Keep the title short
|
|
15
|
+
Keep the title short, because it names the feature folder. Nothing ticks boxes in an issue.
|
|
17
16
|
- type: textarea
|
|
18
17
|
id: narrative
|
|
19
18
|
attributes:
|
|
20
19
|
label: Narrative
|
|
21
|
-
description: One or two sentences from the user's side
|
|
20
|
+
description: One or two sentences from the user's side, saying what they do and what they get back.
|
|
22
21
|
validations:
|
|
23
22
|
required: true
|
|
24
23
|
- type: textarea
|
|
25
24
|
id: success-criteria
|
|
26
25
|
attributes:
|
|
27
26
|
label: Success Criteria
|
|
28
|
-
description: Up to five outcomes you can observe that prove it works.
|
|
27
|
+
description: Up to five outcomes you can observe that prove it works. List outcomes, not steps.
|
|
29
28
|
placeholder: |
|
|
30
29
|
- A user who saves an item sees it in the list within 2s
|
|
31
30
|
validations:
|
|
@@ -44,7 +43,7 @@ body:
|
|
|
44
43
|
attributes:
|
|
45
44
|
label: Derived Test Matrix
|
|
46
45
|
description: |
|
|
47
|
-
One row per behaviour above, each covered by exactly one task.
|
|
46
|
+
One row per behaviour above, each covered by exactly one task. The type is the lowest tier that really exercises the behaviour, named as in `docs/testing.md`: Unit, Integration, E2E, @live (golden) or fresh-DB replay. The test must fail when the behaviour breaks.
|
|
48
47
|
placeholder: |
|
|
49
48
|
| Test description | Type | Target file |
|
|
50
49
|
| --- | --- | --- |
|
|
@@ -56,10 +55,23 @@ body:
|
|
|
56
55
|
attributes:
|
|
57
56
|
label: Tasks
|
|
58
57
|
description: |
|
|
59
|
-
|
|
58
|
+
List the tasks in build order. The preferred shape is the same group and task blocks a plan uses:
|
|
59
|
+
- Each group holds up to `bkit.workflows.tasks.maxPerGroup` tasks (default 5) and `bkit.workflows.tasks.maxTestsPerGroup` **TEST FIRST** tests (default 25).
|
|
60
|
+
- Each task is a block. Task numbers are unique across the issue.
|
|
61
|
+
- **CREATE** / **READ** / **UPDATE** / **DELETE**: one line per file the task touches, as `` `symbol` in `file`: what to do `` or `` `file`: what to do ``.
|
|
62
|
+
- **DEPENDS ON**: the numbers of the tasks it builds on, in the same group or an earlier one.
|
|
63
|
+
- **DONE WHEN**: a check you can verify in the code. For example, a file exists, a test passes, or a behaviour is observable.
|
|
64
|
+
- **TEST FIRST**: the matrix tests that fail before the code exists. A task has 1 to `bkit.workflows.tasks.maxTestsPerTask` tests (default 10), across up to `bkit.workflows.tasks.maxTestFilesPerTask` test files (default 3). Write one line each, as `` `test file` `test name` fails on what goes wrong ``.
|
|
65
|
+
- **If** the task is docs, config, a pure refactor, or covered by E2E / @live only → write `n/a — reason` under **TEST FIRST**.
|
|
66
|
+
- **TEST EXCEPTION**: written only by the owner. It lists the tests you accept without a proven red, each written as in **TEST FIRST** and ending `— reason`. It counts once it is committed alone in the plan.
|
|
67
|
+
- A **TEST EXCEPTION** written here is a request. The build copies it word for word and does not honour it until the owner confirms it at the build's Decision Pause, where Accept rewrites it with the owner's reason and date.
|
|
68
|
+
|
|
69
|
+
Free text works too. The build converts it.
|
|
70
|
+
|
|
71
|
+
A plan file for this issue wins. Once one exists, the build reads its tasks only from the plan, never from here.
|
|
60
72
|
placeholder: |
|
|
61
73
|
<!-- bkit:group 1 start -->
|
|
62
|
-
### GROUP 1: Saving items
|
|
74
|
+
### TASK GROUP 1: Saving items
|
|
63
75
|
<!-- bkit:task 1 start -->
|
|
64
76
|
- [ ] **TASK 1:** Refuse an empty item name
|
|
65
77
|
- **UPDATE:** `saveItem` in `path/to/items`: refuse an empty name
|
|
@@ -86,7 +98,7 @@ body:
|
|
|
86
98
|
id: open-questions
|
|
87
99
|
attributes:
|
|
88
100
|
label: Open Questions & Assumptions
|
|
89
|
-
description:
|
|
101
|
+
description: List each one with its options, your recommendation, and the default if nobody answers.
|
|
90
102
|
- type: textarea
|
|
91
103
|
id: breaking-changes
|
|
92
104
|
attributes:
|
|
@@ -102,7 +114,7 @@ body:
|
|
|
102
114
|
attributes:
|
|
103
115
|
label: References
|
|
104
116
|
description: |
|
|
105
|
-
The plan reads `**Parent design:**` and `**Audit reports:**` lines
|
|
117
|
+
The plan reads the `**Parent design:**` and `**Audit reports:**` lines. The build refuses to start while an issue in the blocked-by block is open. Write these lines and the blocked-by block exactly as shown. Nothing fetches the other references, so use exact paths, ledger `key`s, and issue numbers with their titles.
|
|
106
118
|
placeholder: |
|
|
107
119
|
**Parent design:** [42-offline-sync-design.md](https://github.com/<owner>/<repo>/blob/dev/docs/plans/202610/42-offline-sync-design.md)
|
|
108
120
|
**Audit reports:** docs/audits/202610/security.md (findings security-3, security-5)
|
|
@@ -8,7 +8,7 @@ body:
|
|
|
8
8
|
- type: markdown
|
|
9
9
|
attributes:
|
|
10
10
|
value: |
|
|
11
|
-
Next step: `/bkit-design #<issue number>`. Design asks only what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short
|
|
11
|
+
Next step: `/bkit-design #<issue number>`. Design asks only about what this issue leaves open, so every decision you settle here is one question fewer. Keep the title short. It names the feature folder, and it is not read as input.
|
|
12
12
|
- type: textarea
|
|
13
13
|
id: problem
|
|
14
14
|
attributes:
|
|
@@ -27,7 +27,7 @@ body:
|
|
|
27
27
|
id: success-criteria
|
|
28
28
|
attributes:
|
|
29
29
|
label: Success criteria
|
|
30
|
-
description: Up to five outcomes you could measure.
|
|
30
|
+
description: Up to five outcomes you could measure. List outcomes, not steps.
|
|
31
31
|
placeholder: |
|
|
32
32
|
- A user who saves an item sees it in the list within 2s
|
|
33
33
|
- type: textarea
|
|
@@ -49,7 +49,7 @@ body:
|
|
|
49
49
|
id: references
|
|
50
50
|
attributes:
|
|
51
51
|
label: References
|
|
52
|
-
description: Related issues with their
|
|
52
|
+
description: Related issues with their titles, earlier attempts, docs paths, and ledger rows by `key`. Nothing fetches these, so write exact paths and keys that agents can search for.
|
|
53
53
|
placeholder: |
|
|
54
54
|
Related: #<number> — <its title>
|
|
55
55
|
Docs: docs/architecture.md § Sync
|
|
@@ -35,12 +35,17 @@
|
|
|
35
35
|
// `dev`'s config over `main`'s for dev-targeted runs, so config edits on `dev`
|
|
36
36
|
// apply to them. This option is itself read from `main`, so it needs one merge
|
|
37
37
|
// to `main` before dev-side config edits apply.
|
|
38
|
+
// The merge appends list options (`customManagers`, `packageRules`) instead of
|
|
39
|
+
// replacing them: each custom manager runs twice, so the dashboard lists its
|
|
40
|
+
// files twice and the run logs "Cannot find replaceString" for the second pass.
|
|
41
|
+
// PRs still open once. A rule deleted on `dev` keeps applying until `main` drops it.
|
|
38
42
|
// See docs/deployments.md § Dependency updaters.
|
|
39
43
|
useBaseBranchConfig: "merge",
|
|
40
44
|
|
|
41
|
-
// Weekly batched runs
|
|
42
|
-
//
|
|
43
|
-
|
|
45
|
+
// Weekly batched runs: every hour of Monday (UTC). The daily bkit-renovate.yml cron
|
|
46
|
+
// can start hours after its set time, so a window of a few hours would miss it.
|
|
47
|
+
// CVE-driven updates are not held to this schedule (`osvVulnerabilityAlerts` below).
|
|
48
|
+
schedule: ["* * * * 1"],
|
|
44
49
|
timezone: "UTC",
|
|
45
50
|
|
|
46
51
|
// CVE alerts → Renovate opens a PR immediately, outside the weekly schedule.
|
|
@@ -71,10 +76,11 @@
|
|
|
71
76
|
|
|
72
77
|
// Lockfile maintenance — picks up indirect-dependency updates that a
|
|
73
78
|
// direct-dependency bump alone wouldn't catch. Monthly: it rewrites the whole
|
|
74
|
-
// lockfile, so a weekly PR is mostly churn.
|
|
79
|
+
// lockfile, so a weekly PR is mostly churn. Every hour of the 1st (UTC), for the
|
|
80
|
+
// same late-start reason as `schedule` above.
|
|
75
81
|
lockFileMaintenance: {
|
|
76
82
|
enabled: true,
|
|
77
|
-
schedule: ["
|
|
83
|
+
schedule: ["* * 1 * *"],
|
|
78
84
|
},
|
|
79
85
|
|
|
80
86
|
// Rebase a Renovate PR only when it conflicts. The default re-bases every open PR
|
|
@@ -123,7 +129,8 @@
|
|
|
123
129
|
// bash "$RUNNER_TEMP/download-actionlint.bash" 1.7.12 (installer-script version argument)
|
|
124
130
|
// Pins paired with a checksum (Vale, gh, jq, Node, actionlint) get the new VERSION
|
|
125
131
|
// from Renovate, but the sha256 beside it stays old: update it by hand in the same
|
|
126
|
-
// PR, or the install fails closed.
|
|
132
|
+
// PR, or the install fails closed. CI's Check Pinned Checksums step (`bkit ci pins`)
|
|
133
|
+
// fails the PR until it matches. See the NOTE in the docker images rule below.
|
|
127
134
|
// ─────────────────────────────────────────────────────────────────────
|
|
128
135
|
customManagers: [
|
|
129
136
|
{
|
|
@@ -294,6 +301,27 @@
|
|
|
294
301
|
groupName: "docker images",
|
|
295
302
|
automerge: false,
|
|
296
303
|
},
|
|
304
|
+
|
|
305
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
306
|
+
// Pins the `customManagers` entry finds (Dockerfile, bkit-cloud.md, workflows,
|
|
307
|
+
// scripts) land in ONE reviewed PR, so their hand-edited checksums are fixed
|
|
308
|
+
// once. The Dockerfile pnpm pin instead joins the non-major group, so it moves
|
|
309
|
+
// in the same PR as `packageManager` in package.json.
|
|
310
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
311
|
+
{
|
|
312
|
+
matchManagers: ["custom.regex"],
|
|
313
|
+
groupName: "pinned tools",
|
|
314
|
+
automerge: false,
|
|
315
|
+
},
|
|
316
|
+
{
|
|
317
|
+
matchManagers: ["custom.regex"],
|
|
318
|
+
matchDepNames: ["pnpm"],
|
|
319
|
+
matchUpdateTypes: ["minor", "patch"],
|
|
320
|
+
groupName: "non-major dependencies",
|
|
321
|
+
automerge: true,
|
|
322
|
+
automergeType: "pr",
|
|
323
|
+
platformAutomerge: true,
|
|
324
|
+
},
|
|
297
325
|
],
|
|
298
326
|
|
|
299
327
|
// Where to send PRs. `dev` per baseBranchPatterns above.
|
|
@@ -58,7 +58,7 @@ jobs:
|
|
|
58
58
|
steps:
|
|
59
59
|
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
60
60
|
with:
|
|
61
|
-
# Full history so slop:delta can materialise the PR base ref as a worktree.
|
|
61
|
+
# Full history so bkit:slop:delta can materialise the PR base ref as a worktree.
|
|
62
62
|
fetch-depth: 0
|
|
63
63
|
|
|
64
64
|
# Node/TS toolchain region. On a non-Node repo, replace these steps with your
|
|
@@ -191,15 +191,15 @@ jobs:
|
|
|
191
191
|
run: pnpm format:check
|
|
192
192
|
|
|
193
193
|
# vale is not on the runner and .vale/styles/ is gitignored, so without this step
|
|
194
|
-
# `pnpm lint:prose` guard-skips (write-good missing) and the prose gate is silently
|
|
194
|
+
# `pnpm bkit:lint:prose` guard-skips (write-good missing) and the prose gate is silently
|
|
195
195
|
# dead. Pinned tarball + `vale sync` (else E100: write-good missing).
|
|
196
196
|
- name: Install Vale
|
|
197
197
|
env:
|
|
198
198
|
# renovate: datasource=github-releases depName=errata-ai/vale
|
|
199
|
-
VALE_VERSION: "3.
|
|
199
|
+
VALE_VERSION: "3.24.0"
|
|
200
200
|
# sha256 of vale_${VALE_VERSION}_Linux_64-bit.tar.gz (from the release's checksums.txt).
|
|
201
201
|
# Bump alongside VALE_VERSION; verified before extract so a tampered/CDN-swapped tarball fails closed.
|
|
202
|
-
VALE_SHA256: "
|
|
202
|
+
VALE_SHA256: "867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
|
|
203
203
|
run: |
|
|
204
204
|
curl -fsSL --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o "$RUNNER_TEMP/vale.tar.gz"
|
|
205
205
|
echo "${VALE_SHA256} $RUNNER_TEMP/vale.tar.gz" | sha256sum -c -
|
|
@@ -213,7 +213,7 @@ jobs:
|
|
|
213
213
|
done
|
|
214
214
|
|
|
215
215
|
- name: Run Vale Prose Lint
|
|
216
|
-
run: pnpm lint:prose
|
|
216
|
+
run: pnpm bkit:lint:prose
|
|
217
217
|
|
|
218
218
|
- name: Run Slop Scan
|
|
219
219
|
run: pnpm lint:slop
|
|
@@ -225,7 +225,7 @@ jobs:
|
|
|
225
225
|
if: github.event_name == 'pull_request'
|
|
226
226
|
env:
|
|
227
227
|
BASE_SHA: ${{ github.event.pull_request.base.sha }}
|
|
228
|
-
run: pnpm slop:delta "$BASE_SHA"
|
|
228
|
+
run: pnpm bkit:slop:delta "$BASE_SHA"
|
|
229
229
|
|
|
230
230
|
# actionlint validates .github/workflows/* with GitHub-Actions-aware rules
|
|
231
231
|
# (${{ }} expression syntax, shellcheck on run: blocks). A YAML linter accepts
|
|
@@ -247,36 +247,55 @@ jobs:
|
|
|
247
247
|
- name: Run bkit Check
|
|
248
248
|
run: pnpm bkit check
|
|
249
249
|
|
|
250
|
+
# Version + sha256 pins: Renovate bumps a *_VERSION and leaves its *_SHA256, so the
|
|
251
|
+
# break shows only when the image is rebuilt. This downloads each pinned tool and fails
|
|
252
|
+
# the PR naming the tool whose hash differs. deployments.md § Dependency updaters.
|
|
253
|
+
# Self-skips when the repo has no .cursor/Dockerfile.
|
|
254
|
+
- name: Check Pinned Checksums
|
|
255
|
+
if: hashFiles('.cursor/Dockerfile') != ''
|
|
256
|
+
run: pnpm bkit ci pins --file=.cursor/Dockerfile
|
|
257
|
+
|
|
250
258
|
# Dependency-audit gate: fails on a high or critical advisory in the lockfile that
|
|
251
|
-
# scripts/ci/accepted-advisories.json does not accept with a reason and an in-date expiry.
|
|
259
|
+
# scripts/ci/bkit-accepted-advisories.json does not accept with a reason and an in-date expiry.
|
|
252
260
|
# Self-skips when the guard is absent — a repo that did not adopt
|
|
253
|
-
# scripts/ci/check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
|
|
261
|
+
# scripts/ci/bkit-check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
|
|
254
262
|
- name: Check Dependency Audit
|
|
255
|
-
if: hashFiles('scripts/ci/check-dependency-audit.mjs') != ''
|
|
256
|
-
run: node scripts/ci/check-dependency-audit.mjs
|
|
263
|
+
if: hashFiles('scripts/ci/bkit-check-dependency-audit.mjs') != ''
|
|
264
|
+
run: node scripts/ci/bkit-check-dependency-audit.mjs
|
|
257
265
|
|
|
258
266
|
# Capability-register freshness gate: rebuild the graph with graphify and fail when
|
|
259
267
|
# docs/capabilities.md is not what this tree produces, so the register cannot drift
|
|
260
268
|
# silently. Self-skips when the graphify wrapper is absent — a repo that did not adopt
|
|
261
269
|
# scripts/graphify/ is a no-op. graphify is pinned because its output must match the
|
|
262
270
|
# committed register to the byte: bump GRAPHIFY_SPEC (bkit-graphify.sh) and refresh the register together.
|
|
263
|
-
#
|
|
264
|
-
#
|
|
271
|
+
# Every event, PRs included, judging the tree that lands. A pull_request checkout is
|
|
272
|
+
# GitHub's test merge of the PR into its base: the tree a squash merge puts on the base,
|
|
273
|
+
# so its verdict is the post-merge push run's verdict. A PR behind its base can red here
|
|
274
|
+
# with a clean head, when two branches' registers merge line by line into a file no
|
|
275
|
+
# rebuild produces; merging the base into the branch, `pnpm bkit:graph:refresh` and a commit
|
|
276
|
+
# clear it. `check-at HEAD` rebuilds in a throwaway worktree of the checked-out commit —
|
|
277
|
+
# the same primitive the pre-push gate runs — so the release installed, the script run
|
|
278
|
+
# and the register judged all come from that one tree.
|
|
265
279
|
- name: Setup uv
|
|
266
|
-
if:
|
|
267
|
-
uses: astral-sh/setup-uv@
|
|
280
|
+
if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
|
|
281
|
+
uses: astral-sh/setup-uv@18d369b23da25a81e9458561248e1aafff6a70fa # v10.3.1
|
|
268
282
|
with:
|
|
269
|
-
version: "0.13.
|
|
283
|
+
version: "0.13.4"
|
|
270
284
|
|
|
271
285
|
- name: Check Capability Register
|
|
272
|
-
if:
|
|
286
|
+
if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
|
|
273
287
|
# graphify release pinned once: GRAPHIFY_SPEC in bkit-graphify.sh. Same release here,
|
|
274
288
|
# in the pre-push gate and by hand.
|
|
275
289
|
run: |
|
|
276
290
|
uv tool install "$(bash scripts/graphify/bkit-graphify.sh spec)"
|
|
277
291
|
# `uv tool install` drops the shim in ~/.local/bin, not on this step's PATH.
|
|
278
292
|
export PATH="$HOME/.local/bin:$PATH"
|
|
279
|
-
|
|
293
|
+
if ! bash scripts/graphify/bkit-graphify.sh check-at HEAD; then
|
|
294
|
+
if [ "$GITHUB_EVENT_NAME" = pull_request ]; then
|
|
295
|
+
echo "::error title=Capability register::Checked this PR merged into $GITHUB_BASE_REF. If the branch is behind $GITHUB_BASE_REF, merge $GITHUB_BASE_REF into it first, then pnpm bkit:graph:refresh, commit and push."
|
|
296
|
+
fi
|
|
297
|
+
exit 1
|
|
298
|
+
fi
|
|
280
299
|
|
|
281
300
|
# ── bkit-tests-unit ───────────────────────────────────────────────────────
|
|
282
301
|
# Unit lane. Parallel sibling of bkit-tests-static. Integration, E2E, deploy-await,
|
|
@@ -472,7 +491,7 @@ jobs:
|
|
|
472
491
|
# # the floor as its target, to the job summary; comments on same-repo PRs only. No floor yet → drop
|
|
473
492
|
# # vite-config-path (a missing file only warns, on every run).
|
|
474
493
|
# if: ${{ !cancelled() && hashFiles('coverage/unit/coverage-summary.json') != '' }}
|
|
475
|
-
# uses: davelosert/vitest-coverage-report-action@
|
|
494
|
+
# uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
|
|
476
495
|
# with:
|
|
477
496
|
# name: unit
|
|
478
497
|
# json-summary-path: coverage/unit/coverage-summary.json
|
|
@@ -484,7 +503,7 @@ jobs:
|
|
|
484
503
|
# - name: Report Integration Coverage on PR
|
|
485
504
|
# # hashFiles guard: skip cleanly when the repo has no integration tier (no coverage/integration report produced).
|
|
486
505
|
# if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/integration/coverage-summary.json') != ''
|
|
487
|
-
# uses: davelosert/vitest-coverage-report-action@
|
|
506
|
+
# uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
|
|
488
507
|
# with:
|
|
489
508
|
# name: integration
|
|
490
509
|
# json-summary-path: coverage/integration/coverage-summary.json
|
|
@@ -576,7 +595,7 @@ jobs:
|
|
|
576
595
|
# - name: Report E2E Coverage on PR
|
|
577
596
|
# # Same gate as Run E2E Tests (coverage exists only if E2E ran); hashFiles skips repos that produced no E2E report.
|
|
578
597
|
# if: (steps.detect.outputs.should_run_full == 'true' || steps.e2e-paths.outputs.needs_e2e == 'true') && github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/e2e/coverage-summary.json') != ''
|
|
579
|
-
# uses: davelosert/vitest-coverage-report-action@
|
|
598
|
+
# uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
|
|
580
599
|
# with:
|
|
581
600
|
# name: e2e
|
|
582
601
|
# json-summary-path: coverage/e2e/coverage-summary.json
|
|
@@ -610,7 +629,7 @@ jobs:
|
|
|
610
629
|
# always(): a concurrency cancel must not stamp a failure. Each lane must succeed; a failed,
|
|
611
630
|
# skipped or cancelled lane reds it. A lane that writes an executed-test count must have run
|
|
612
631
|
# more than 0 tests. Each lane you adopt from the reference below joins needs: and the assert.
|
|
613
|
-
# The assert is scripts/ci/check-capstone.mjs, required with this file (copy it from
|
|
632
|
+
# The assert is scripts/ci/bkit-check-capstone.mjs, required with this file (copy it from
|
|
614
633
|
# .bkit/templates/scripts/ci/); the step reds when the script is missing.
|
|
615
634
|
bkit-tests-check:
|
|
616
635
|
needs: [bkit-tests-static, bkit-tests-unit]
|
|
@@ -624,8 +643,8 @@ jobs:
|
|
|
624
643
|
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
625
644
|
|
|
626
645
|
- name: Assert Lanes Passed
|
|
627
|
-
# The verdict is scripts/ci/check-capstone.mjs (copy it with this file from
|
|
628
|
-
# .bkit/templates/scripts/ci/; check-capstone.test.mjs tests it). Every lane in LANES
|
|
646
|
+
# The verdict is scripts/ci/bkit-check-capstone.mjs (copy it with this file from
|
|
647
|
+
# .bkit/templates/scripts/ci/; bkit-check-capstone.test.mjs tests it). Every lane in LANES
|
|
629
648
|
# must succeed; a lane with a *_RAN variable must have run more than 0 tests.
|
|
630
649
|
# EMPTY_COUNT=warn: a lane that writes no count yet warns instead of failing; delete it
|
|
631
650
|
# once every counted lane writes one. Add each lane you adopt to LANES and to its
|
|
@@ -637,26 +656,11 @@ jobs:
|
|
|
637
656
|
UNIT_RESULT: ${{ needs.bkit-tests-unit.result }}
|
|
638
657
|
UNIT_RAN: ${{ needs.bkit-tests-unit.outputs.tests_ran }}
|
|
639
658
|
run: |
|
|
640
|
-
if [ ! -f scripts/ci/check-capstone.mjs ]; then
|
|
641
|
-
echo "::error::scripts/ci/check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
|
|
659
|
+
if [ ! -f scripts/ci/bkit-check-capstone.mjs ]; then
|
|
660
|
+
echo "::error::scripts/ci/bkit-check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
|
|
642
661
|
exit 1
|
|
643
662
|
fi
|
|
644
|
-
node scripts/ci/check-capstone.mjs
|
|
645
|
-
|
|
646
|
-
# bkit-stub:smoke — Post-CI smoke triggered by workflow_run on {{DEFAULT_BRANCH}}. To enable: copy the YAML below into .github/workflows/smoke.yml (separate file — workflow_run cannot share a file with push/pull_request) and delete this stub header.
|
|
647
|
-
# name: Smoke
|
|
648
|
-
# on:
|
|
649
|
-
# workflow_run:
|
|
650
|
-
# workflows: ["CI"]
|
|
651
|
-
# types: [completed]
|
|
652
|
-
# branches: [{{DEFAULT_BRANCH}}]
|
|
653
|
-
# jobs:
|
|
654
|
-
# smoke:
|
|
655
|
-
# if: github.event.workflow_run.conclusion == 'success'
|
|
656
|
-
# runs-on: ubuntu-latest
|
|
657
|
-
# steps:
|
|
658
|
-
# - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
659
|
-
# - run: ./scripts/ci/smoke-test.sh
|
|
663
|
+
node scripts/ci/bkit-check-capstone.mjs
|
|
660
664
|
|
|
661
665
|
# =============================================================================
|
|
662
666
|
# FULL CI SCAFFOLD REFERENCE — job graph, needs, if, step names. This is the target.
|
|
@@ -737,7 +741,7 @@ jobs:
|
|
|
737
741
|
# # package.json, which pins turbo EXACTLY — never typed here, or this lane drifts from every
|
|
738
742
|
# # install-bearing lane: npm i -g "turbo@$(node -p "require('./package.json').devDependencies.turbo")"
|
|
739
743
|
# - name: Resolve Base Ref # [M] push base = the branch's last green run; shipped:
|
|
740
|
-
# # scripts/ci/lanes/resolve-push-base.mjs (falls back to github.event.before). deployments.md
|
|
744
|
+
# # scripts/ci/lanes/bkit-resolve-push-base.mjs (falls back to github.event.before). deployments.md
|
|
741
745
|
# # § One run per branch or pull request.
|
|
742
746
|
# bkit-stub:affected-graph — [M] turbo changed-packages. Stdout ≠ stderr. deployments.md § turbo `//`.
|
|
743
747
|
# - name: Detect Affected Packages # [M] sets web_affected / global_dep_changed
|
|
@@ -791,13 +795,13 @@ jobs:
|
|
|
791
795
|
# - name: Run Lint # [U] static checks FAIL-FAST before env pull; PRs scope --filter=...[origin/<base>]
|
|
792
796
|
# - name: Run Typecheck # [U]
|
|
793
797
|
# - name: Run Prettier # [U] CI-side format gate (hook-bypass net)
|
|
794
|
-
# - name: Run Vale Prose Lint # [U] same root lint:prose pre-push runs (local==CI)
|
|
798
|
+
# - name: Run Vale Prose Lint # [U] same root bkit:lint:prose pre-push runs (local==CI)
|
|
795
799
|
# - name: Run Slop Scan (full) # [U] advisory baseline
|
|
796
800
|
# - name: Run Slop Scan (delta) # every event, against the planner base. deployments.md § One run.
|
|
797
801
|
# - name: Tear Down Base Worktree # if: always()
|
|
798
802
|
# - name: Run bkit Check # [U] drift gate (same as pre-push); catches --no-verify/web-edit/cloud drift
|
|
799
|
-
# - name: Check Accepted Divergences # [U] node scripts/ci/check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
|
|
800
|
-
# - name: Check Dependency Audit # [U] node scripts/ci/check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
|
|
803
|
+
# - name: Check Accepted Divergences # [U] node scripts/ci/bkit-check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
|
|
804
|
+
# - name: Check Dependency Audit # [U] node scripts/ci/bkit-check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
|
|
801
805
|
# - name: Pull Vercel Env Vars # [D] preview vs prod env by branch; set CI_ENV_FILE; FAIL-FAST if critical secrets empty
|
|
802
806
|
# - name: Assert Environment Shape # [D] env-shape checker (e.g. env-check.sh)
|
|
803
807
|
# # Resolve URL and remote db push are NOT steps in this catalogue.
|
|
@@ -1008,11 +1012,10 @@ jobs:
|
|
|
1008
1012
|
# setting (e.g. Vercel Deployment Checks) stays empty — this job is the promotion.
|
|
1009
1013
|
#
|
|
1010
1014
|
# === JOB 6 — health (separate workflow) ===
|
|
1011
|
-
# bkit-stub:health — copy
|
|
1012
|
-
#
|
|
1013
|
-
#
|
|
1014
|
-
#
|
|
1015
|
-
# DROP if you have no deployed health URL.
|
|
1015
|
+
# bkit-stub:health — copy .bkit/templates/.github/workflows/bkit-health.yml to
|
|
1016
|
+
# .github/workflows/bkit-health.yml. WHEN: bkit-tests-deploy promotes and you have a live health URL.
|
|
1017
|
+
# Runs after every finished CI run on {{DEFAULT_BRANCH}}, green or red, and probes only when production
|
|
1018
|
+
# serves that run's commit. Not a required check. DROP if you have no deployed health URL.
|
|
1016
1019
|
#
|
|
1017
1020
|
# COMPOSES WITH bkit-cloud.yml: it routes on workflow_run.conclusion (success->ship, failure->debug);
|
|
1018
1021
|
# a red bkit-tests-check turns the whole run red, so the router reads the capstone for free. See .bkit/cloud.md.
|