@cbartens/bkit 5.5.1 → 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 +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -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 +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- 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 +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- 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/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- 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 +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- 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 +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- 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/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- 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 +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- 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 +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- 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 +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -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/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- 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 +289 -174
- 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 +45 -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 +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- 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 +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- 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 +10 -2
- 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 +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- 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/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- 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 +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /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
|
@@ -14,34 +14,76 @@
|
|
|
14
14
|
# Revert-branch bypass: on a revert branch the unit and integration tiers are skipped; lint +
|
|
15
15
|
# typecheck still run.
|
|
16
16
|
#
|
|
17
|
-
# Min push: every changed file
|
|
18
|
-
#
|
|
19
|
-
# never `[skip ci]`.
|
|
17
|
+
# Min push: every changed file is one bkit writes or one that `bkit.testing.minPushPaths`
|
|
18
|
+
# adds (package.json; .bkit/templates.md § Git hooks — Husky) → `bkit:gate:min` replaces the
|
|
19
|
+
# full gate; MIN_PUSH=1 for repo extras. Files decide, never `[skip ci]`.
|
|
20
20
|
set -e
|
|
21
21
|
|
|
22
|
+
# Log: the hook runs itself once more with everything it prints copied to tmp/pre-push.log,
|
|
23
|
+
# rewritten each push, so a reader whose output was cut short, or who pushed in the
|
|
24
|
+
# background, still has the whole run. The path is printed first (tail -f it while the push
|
|
25
|
+
# runs) and last, with the exit code. Git's ref list on stdin reaches the inner run unchanged,
|
|
26
|
+
# and the hook exits with the inner run's code. Output goes to stderr, where git sends a
|
|
27
|
+
# hook's output anyway. `git push --no-verify`, and a checkout without husky installed (a
|
|
28
|
+
# linked worktree), run no hook and write no log.
|
|
29
|
+
if [ -z "${BKIT_PRE_PUSH_LOGGED:-}" ]; then
|
|
30
|
+
PRE_PUSH_LOG=tmp/pre-push.log
|
|
31
|
+
PRE_PUSH_RC_FILE=$(mktemp)
|
|
32
|
+
mkdir -p tmp
|
|
33
|
+
{
|
|
34
|
+
echo "[pre-push] log: $PRE_PUSH_LOG"
|
|
35
|
+
pre_push_rc=0
|
|
36
|
+
BKIT_PRE_PUSH_LOGGED=1 FORCE_COLOR=1 sh "$0" "$@" 2>&1 || pre_push_rc=$?
|
|
37
|
+
echo "[pre-push] log: $PRE_PUSH_LOG (exit $pre_push_rc)"
|
|
38
|
+
echo "$pre_push_rc" > "$PRE_PUSH_RC_FILE"
|
|
39
|
+
} | tee "$PRE_PUSH_LOG" >&2
|
|
40
|
+
pre_push_rc=$(cat "$PRE_PUSH_RC_FILE")
|
|
41
|
+
rm -f "$PRE_PUSH_RC_FILE"
|
|
42
|
+
exit "$pre_push_rc"
|
|
43
|
+
fi
|
|
44
|
+
|
|
45
|
+
# Git exports GIT_DIR to a hook and everything it starts (from a linked worktree:
|
|
46
|
+
# <main>/.git/worktrees/<name>). It beats a child's cwd and -C, so a test's `git -C "$tmp" init`
|
|
47
|
+
# re-initialises this repo (core.bare=true in the shared .git/config) and a fixture's
|
|
48
|
+
# `git config user.email` lands here too. The hook runs from the work tree root, so git finds
|
|
49
|
+
# the repo without them.
|
|
50
|
+
unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE
|
|
51
|
+
|
|
22
52
|
# ── delete-only push: nothing leaves this machine, so there is nothing to gate ──
|
|
23
53
|
# `git push origin --delete <branch>` runs this hook too. Git feeds one line per ref on
|
|
24
54
|
# stdin — "<local-ref> <local-sha> <remote-ref> <remote-sha>" — and a deleted ref has an
|
|
25
55
|
# all-zero local sha. When EVERY line is a delete, the push carries no commits. A push
|
|
26
56
|
# mixing a delete with a real update still gates, and so does an empty ref list. Reading
|
|
27
57
|
# stdin here is safe: every later command redirects from /dev/null. `[ -t 0 ]` keeps a
|
|
28
|
-
# hand-run hook from hanging. The loop also sets PUSH_DEV_SHA (commit pushed to dev)
|
|
29
|
-
#
|
|
30
|
-
#
|
|
58
|
+
# hand-run hook from hanging. The loop also sets PUSH_DEV_SHA (commit pushed to dev) and
|
|
59
|
+
# PUSH_BRANCH_SHA (commit pushed to the current branch, empty when the push does not update
|
|
60
|
+
# it) for repo extras (e.g. scripts/graphify/bkit-graph-pre-push.sh), PUSH_SHAS (every pushed
|
|
61
|
+
# commit), PUSH_SHARED_SHAS (those pushed to dev / main) and PUSH_BRANCH_REMOTE_SHA (the head
|
|
62
|
+
# the remote holds for the current branch, empty when it holds none), which the CI-suppressor
|
|
63
|
+
# guard below hands to `bkit ci bookkeeping-push`.
|
|
64
|
+
BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
|
|
31
65
|
PUSH_SAW_REF=0
|
|
32
66
|
PUSH_HAS_COMMITS=0
|
|
33
67
|
PUSH_DEV_SHA=""
|
|
68
|
+
PUSH_BRANCH_SHA=""
|
|
34
69
|
PUSH_SHAS=""
|
|
70
|
+
PUSH_UPDATES=""
|
|
35
71
|
PUSH_SHARED_SHAS=""
|
|
72
|
+
PUSH_BRANCH_REMOTE_SHA=""
|
|
36
73
|
if [ ! -t 0 ]; then
|
|
37
|
-
while read -r _push_local_ref push_local_sha push_remote_ref
|
|
74
|
+
while read -r _push_local_ref push_local_sha push_remote_ref push_remote_sha; do
|
|
38
75
|
[ -n "$push_local_sha" ] || continue
|
|
39
76
|
PUSH_SAW_REF=1
|
|
40
77
|
case "$push_local_sha" in
|
|
41
78
|
*[!0]*)
|
|
42
79
|
PUSH_HAS_COMMITS=1
|
|
43
80
|
PUSH_SHAS="$PUSH_SHAS $push_local_sha"
|
|
81
|
+
PUSH_UPDATES="$PUSH_UPDATES --update=$push_remote_sha:$push_local_sha"
|
|
44
82
|
[ "$push_remote_ref" = "refs/heads/dev" ] && PUSH_DEV_SHA="$push_local_sha"
|
|
83
|
+
if [ "$push_remote_ref" = "refs/heads/$BRANCH" ]; then
|
|
84
|
+
PUSH_BRANCH_SHA="$push_local_sha"
|
|
85
|
+
case "$push_remote_sha" in *[!0]*) PUSH_BRANCH_REMOTE_SHA="$push_remote_sha" ;; esac
|
|
86
|
+
fi
|
|
45
87
|
case "$push_remote_ref" in
|
|
46
88
|
refs/heads/dev|refs/heads/main) PUSH_SHARED_SHAS="$PUSH_SHARED_SHAS $push_local_sha" ;;
|
|
47
89
|
esac
|
|
@@ -55,7 +97,6 @@ if [ "$PUSH_SAW_REF" = "1" ] && [ "$PUSH_HAS_COMMITS" = "0" ]; then
|
|
|
55
97
|
fi
|
|
56
98
|
# ── end delete-only push
|
|
57
99
|
|
|
58
|
-
BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
|
|
59
100
|
HEAD_SUBJECT=$(git log -1 --pretty=%s 2>/dev/null || echo "")
|
|
60
101
|
IS_REVERT=0
|
|
61
102
|
case "$BRANCH" in
|
|
@@ -71,6 +112,12 @@ esac
|
|
|
71
112
|
# -> allowed ([skip ci] pushes for mid-loop status, abort handover). dev/main exempt;
|
|
72
113
|
# gh absent -> allow. `bkit ci skip-token` exits 0 when HEAD's message carries one of
|
|
73
114
|
# the tokens GitHub honours; bkit owns that list.
|
|
115
|
+
# Exception, the same one ship's merge gate makes: a push that adds only files on ship's
|
|
116
|
+
# `--scope=pr` allow-list (.bkit/workflows.md § `/bkit-ship` — 14 steps) on top of the
|
|
117
|
+
# head the remote already holds leaves nothing new for CI to test, so the PR's checks at
|
|
118
|
+
# that head still cover the code. `bkit ci bookkeeping-push` exits 0 for exactly that
|
|
119
|
+
# shape. A rewritten head (force-push) or any code file still blocks. The merge gate
|
|
120
|
+
# (`bkit runs gate --validated=`) stays the authority on what merges.
|
|
74
121
|
case "$BRANCH" in
|
|
75
122
|
dev|main) ;;
|
|
76
123
|
*)
|
|
@@ -79,9 +126,14 @@ case "$BRANCH" in
|
|
|
79
126
|
# strip hook-injected GIT_DIR/GIT_WORK_TREE so gh resolves the repo from cwd (worktree-safe)
|
|
80
127
|
OPEN_PR=$(env -u GIT_DIR -u GIT_WORK_TREE gh pr list --head "$BRANCH" --state open --json number --jq '.[0].number' 2>/dev/null || echo "")
|
|
81
128
|
if [ -n "$OPEN_PR" ]; then
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
129
|
+
if [ -n "$PUSH_BRANCH_REMOTE_SHA" ] &&
|
|
130
|
+
pnpm -s bkit ci bookkeeping-push --from="$PUSH_BRANCH_REMOTE_SHA" < /dev/null > /dev/null; then
|
|
131
|
+
echo "[pre-push] HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open, but every file changed since the remote head $PUSH_BRANCH_REMOTE_SHA is bookkeeping — the PR's checks at that head still cover the code; allowing." >&2
|
|
132
|
+
else
|
|
133
|
+
echo "[pre-push] BLOCKED: HEAD on '$BRANCH' carries a CI-suppressing token and PR #$OPEN_PR is open — its checks would stay vacuously green." >&2
|
|
134
|
+
echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
|
|
135
|
+
exit 1
|
|
136
|
+
fi
|
|
85
137
|
fi
|
|
86
138
|
else
|
|
87
139
|
echo "[pre-push] WARN: HEAD on '$BRANCH' carries a CI-suppressing token but gh is unavailable to check for an open PR; allowing. If a PR is open, ensure HEAD triggers CI." >&2
|
|
@@ -90,16 +142,13 @@ case "$BRANCH" in
|
|
|
90
142
|
;;
|
|
91
143
|
esac
|
|
92
144
|
|
|
93
|
-
# Min push:
|
|
94
|
-
#
|
|
95
|
-
#
|
|
96
|
-
# evidence reads as a pass.
|
|
145
|
+
# Min push: every outgoing ref is either bookkeeping since its integration base,
|
|
146
|
+
# or a bookkeeping increment over a locally checked ancestor of its remote head.
|
|
147
|
+
# Missing evidence, code or rewritten history keeps the full gate.
|
|
97
148
|
MIN_PUSH=0
|
|
98
|
-
if [ -n "$
|
|
99
|
-
MIN_PUSH_REFS=""
|
|
100
|
-
for push_sha in $PUSH_SHAS; do MIN_PUSH_REFS="$MIN_PUSH_REFS --ref=$push_sha"; done
|
|
149
|
+
if [ -n "$PUSH_UPDATES" ]; then
|
|
101
150
|
# shellcheck disable=SC2086 # hex SHAs only: word-splitting is the point
|
|
102
|
-
if pnpm -s bkit ci min-push $
|
|
151
|
+
if pnpm -s bkit ci min-push $PUSH_UPDATES < /dev/null > /dev/null; then
|
|
103
152
|
MIN_PUSH=1
|
|
104
153
|
fi
|
|
105
154
|
fi
|
|
@@ -109,9 +158,8 @@ fi
|
|
|
109
158
|
# the open-PR guard above (workflows push `[skip ci]` code heads mid-run).
|
|
110
159
|
for push_sha in $PUSH_SHARED_SHAS; do
|
|
111
160
|
if pnpm -s bkit ci skip-token --ref="$push_sha" < /dev/null > /dev/null; then
|
|
112
|
-
if
|
|
113
|
-
|
|
114
|
-
echo "[pre-push] BLOCKED: $push_sha carries a CI-suppressing token and changes files outside bkit.minPushPaths — that code would land on dev / main with no CI run." >&2
|
|
161
|
+
if ! pnpm -s bkit ci min-push --ref="$push_sha" < /dev/null > /dev/null; then
|
|
162
|
+
echo "[pre-push] BLOCKED: $push_sha carries a CI-suppressing token and changes files outside the min-push paths (what bkit writes, plus bkit.testing.minPushPaths) — that code would land on dev / main with no CI run." >&2
|
|
115
163
|
echo "[pre-push] Add a clean trigger commit and re-push: git commit --allow-empty -m \"chore: trigger CI\" && git push" >&2
|
|
116
164
|
exit 1
|
|
117
165
|
fi
|
|
@@ -129,14 +177,25 @@ done
|
|
|
129
177
|
# Fix: `pnpm bkit install`, stage the regenerated files, commit, push.
|
|
130
178
|
pnpm bkit check < /dev/null
|
|
131
179
|
|
|
180
|
+
# Dependency audit — the same gate CI's static lane runs. A high or critical advisory
|
|
181
|
+
# stops the push here, so a remote run is not spent on a red this machine could have
|
|
182
|
+
# caught. It reads the advisory registry: the push it precedes needs the network anyway.
|
|
183
|
+
# Fails closed — a blocking advisory, an unusable answer or an unreachable registry stops
|
|
184
|
+
# the push, never a pass on no answer. `--unreachable=warn` relaxes only the last of those.
|
|
185
|
+
# A recommendation: adopt it, and CI stops being the first place an advisory is seen.
|
|
186
|
+
# Skipped until scripts/ci/ holds the script (bkit install never writes it).
|
|
187
|
+
if [ -f scripts/ci/bkit-check-dependency-audit.mjs ]; then
|
|
188
|
+
node scripts/ci/bkit-check-dependency-audit.mjs < /dev/null
|
|
189
|
+
fi
|
|
190
|
+
|
|
132
191
|
# Slop base on a dev push — the commit CI's slop scan compares against: the head of the last
|
|
133
|
-
# green CI push run on dev, else origin/dev (scripts/ci/lanes/resolve-push-base.mjs, the
|
|
192
|
+
# green CI push run on dev, else origin/dev (scripts/ci/lanes/bkit-resolve-push-base.mjs, the
|
|
134
193
|
# script CI's planner runs, in local mode). Exported as SLOP_BASE_REF, which `bkit ci slop`
|
|
135
194
|
# reads, so a finding a red push already landed on dev fails here as it does in CI. Other
|
|
136
195
|
# branches keep the merge-base default. Skipped until scripts/ci/lanes/ holds the script.
|
|
137
|
-
if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/resolve-push-base.mjs ]; then
|
|
196
|
+
if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/bkit-resolve-push-base.mjs ]; then
|
|
138
197
|
PUSH_BASE_SOURCE_FILE=$(mktemp)
|
|
139
|
-
CI_PUSH_BASE=$(SOURCE_FILE="$PUSH_BASE_SOURCE_FILE" node scripts/ci/lanes/resolve-push-base.mjs \
|
|
198
|
+
CI_PUSH_BASE=$(SOURCE_FILE="$PUSH_BASE_SOURCE_FILE" node scripts/ci/lanes/bkit-resolve-push-base.mjs \
|
|
140
199
|
--local --branch=dev --head="$PUSH_DEV_SHA" < /dev/null || echo "")
|
|
141
200
|
CI_PUSH_BASE_SOURCE=$(cat "$PUSH_BASE_SOURCE_FILE" 2>/dev/null || echo "unknown")
|
|
142
201
|
rm -f "$PUSH_BASE_SOURCE_FILE"
|
|
@@ -155,12 +214,13 @@ if [ -n "$PUSH_DEV_SHA" ] && [ -f scripts/ci/lanes/resolve-push-base.mjs ]; then
|
|
|
155
214
|
fi
|
|
156
215
|
fi
|
|
157
216
|
|
|
158
|
-
# Capability register (graphify, .bkit/templates.md § graphify) — blocks a push to dev
|
|
159
|
-
# docs/capabilities.md is not what the pushed
|
|
160
|
-
# branches. Skipped until scripts/graphify/ holds the
|
|
161
|
-
# no source the register is built from.
|
|
217
|
+
# Capability register (graphify, .bkit/templates.md § graphify) — blocks a push to dev, and a
|
|
218
|
+
# push of a branch with an open PR into dev, when docs/capabilities.md is not what the pushed
|
|
219
|
+
# commit builds (~30s); warn-only on other branches. Skipped until scripts/graphify/ holds the
|
|
220
|
+
# script, and on a min push: it changes no source the register is built from.
|
|
162
221
|
if [ "$MIN_PUSH" != "1" ] && [ -f scripts/graphify/bkit-graph-pre-push.sh ]; then
|
|
163
|
-
PUSH_DEV_SHA="$PUSH_DEV_SHA" IS_REVERT="$IS_REVERT"
|
|
222
|
+
PUSH_DEV_SHA="$PUSH_DEV_SHA" BRANCH="$BRANCH" PUSH_BRANCH_SHA="$PUSH_BRANCH_SHA" IS_REVERT="$IS_REVERT" \
|
|
223
|
+
bash scripts/graphify/bkit-graph-pre-push.sh < /dev/null
|
|
164
224
|
fi
|
|
165
225
|
|
|
166
226
|
# tmp/ prune — deletes files under tmp/ untouched for 7+ days. Not a gate: a failed
|
|
@@ -174,17 +234,17 @@ fi
|
|
|
174
234
|
# the bkit agent workflows and prompts dispatch through. Edit the scripts, not this
|
|
175
235
|
# hook. Fast repo extras go ABOVE, with `bkit check`; slow ones BELOW.
|
|
176
236
|
# Min push: `bkit:gate:min` only. Revert path drops the suite only: prose
|
|
177
|
-
# and slop:delta still run. Otherwise the deepest push gate package.json declares.
|
|
237
|
+
# and bkit:slop:delta still run. Otherwise the deepest push gate package.json declares.
|
|
178
238
|
if [ "$MIN_PUSH" = "1" ]; then
|
|
179
239
|
echo "[pre-push] min push — bkit:gate:min instead of the full gate" >&2
|
|
180
|
-
pnpm bkit:gate:min < /dev/null
|
|
240
|
+
pnpm -s bkit ci push-gate --gate=bkit:gate:min < /dev/null
|
|
181
241
|
elif [ "$IS_REVERT" = "1" ]; then
|
|
182
242
|
echo "[pre-push] revert branch/commit detected — skipping the test suite"
|
|
183
|
-
pnpm bkit:gate:static < /dev/null
|
|
243
|
+
pnpm -s bkit ci push-gate --gate=bkit:gate:static < /dev/null
|
|
184
244
|
elif grep -q '"bkit:gate:static-unit-integration"[[:space:]]*:' package.json 2>/dev/null; then
|
|
185
|
-
pnpm bkit:gate:static-unit-integration < /dev/null
|
|
245
|
+
pnpm -s bkit ci push-gate --gate=bkit:gate:static-unit-integration < /dev/null
|
|
186
246
|
else
|
|
187
|
-
pnpm bkit:gate:static-unit < /dev/null
|
|
247
|
+
pnpm -s bkit ci push-gate --gate=bkit:gate:static-unit < /dev/null
|
|
188
248
|
fi
|
|
189
249
|
|
|
190
250
|
# Slow repo extras go here, above the disk prune. Ones that need Docker, a database or a
|
|
@@ -193,7 +253,7 @@ fi
|
|
|
193
253
|
|
|
194
254
|
# disk prune — keep this block last, so it runs only once every gate above passed. Starts
|
|
195
255
|
# your max cleanup steps (`bkit disk prune`, .bkit/templates.md § Disk prune) in the
|
|
196
|
-
# background, at most once a day, or hourly while free disk is under bkit.
|
|
256
|
+
# background, at most once a day, or hourly while free disk is under bkit.workflows.minFreeGb;
|
|
197
257
|
# with no step files it does nothing. Not a gate: a failure warns and the push goes on.
|
|
198
258
|
pnpm -s bkit disk prune --mode=max --auto < /dev/null > /dev/null ||
|
|
199
259
|
echo "[pre-push] WARN: disk prune failed; push continues" >&2
|
|
@@ -39,6 +39,12 @@ pnpm-lock.yaml
|
|
|
39
39
|
# never be byte-equal to what the renderer emits and every close would carry a
|
|
40
40
|
# formatting-only diff. The fold's output is the source of truth.
|
|
41
41
|
docs/roadmap.md
|
|
42
|
+
# Workflow run logs — gate output (`bkit tests run` / `red` / `green`), the
|
|
43
|
+
# `bkit context diff` / `brief` records, step reports and the run's
|
|
44
|
+
# `status.jsonl`, committed beside a run's artifacts. The text is a run record,
|
|
45
|
+
# not hand-written markdown: prettier would escape and reflow it, and a gate's
|
|
46
|
+
# format check would then fail on another feature's log merged in from the base.
|
|
47
|
+
docs/plans/*/logs/**
|
|
42
48
|
# bkit's reference copies of its templates — refreshed by `bkit upgrade`, never
|
|
43
49
|
# formatted by this repo.
|
|
44
50
|
.bkit/templates/
|
|
@@ -5,38 +5,38 @@ MinAlertLevel = warning
|
|
|
5
5
|
Packages = write-good
|
|
6
6
|
|
|
7
7
|
[.agents/**]
|
|
8
|
-
BasedOnStyles =
|
|
8
|
+
BasedOnStyles = Bkit
|
|
9
9
|
|
|
10
10
|
# Vendored skill content — third-party docs loaded under multiple paths
|
|
11
11
|
# depending on harness. Each path needs its own scope block.
|
|
12
12
|
[**/.agents/skills/**/*.md]
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
13
|
+
Bkit.LLMSlop = NO
|
|
14
|
+
Bkit.Hedging = NO
|
|
15
|
+
Bkit.Filler = NO
|
|
16
|
+
Bkit.Verbose = NO
|
|
17
17
|
|
|
18
18
|
[**/.claude/skills/**/*.md]
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
19
|
+
Bkit.LLMSlop = NO
|
|
20
|
+
Bkit.Hedging = NO
|
|
21
|
+
Bkit.Filler = NO
|
|
22
|
+
Bkit.Verbose = NO
|
|
23
23
|
|
|
24
24
|
[**/.cursor/skills/**/*.md]
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
25
|
+
Bkit.LLMSlop = NO
|
|
26
|
+
Bkit.Hedging = NO
|
|
27
|
+
Bkit.Filler = NO
|
|
28
|
+
Bkit.Verbose = NO
|
|
29
29
|
|
|
30
30
|
# Meta-prompt about prose compression: enumerates hedging/verbose phrases
|
|
31
|
-
# verbatim as examples of what to strip, so
|
|
31
|
+
# verbatim as examples of what to strip, so Bkit rules self-trigger.
|
|
32
32
|
[**/bkit-utility-compress-markdown.md]
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
33
|
+
Bkit.LLMSlop = NO
|
|
34
|
+
Bkit.Hedging = NO
|
|
35
|
+
Bkit.Filler = NO
|
|
36
|
+
Bkit.Verbose = NO
|
|
37
37
|
|
|
38
38
|
[*.md]
|
|
39
|
-
BasedOnStyles = write-good,
|
|
39
|
+
BasedOnStyles = write-good, Bkit
|
|
40
40
|
write-good.ThereIs = warning
|
|
41
41
|
write-good.Passive = NO
|
|
42
42
|
write-good.TooWordy = NO
|
|
@@ -49,19 +49,19 @@ write-good.Weasel = NO
|
|
|
49
49
|
# disabling, so each rule must be turned off explicitly. Leading `**/` so
|
|
50
50
|
# lint-staged's absolute paths also match.
|
|
51
51
|
[**/docs/plans/**/*.md]
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
52
|
+
Bkit.LLMSlop = NO
|
|
53
|
+
Bkit.Hedging = NO
|
|
54
|
+
Bkit.Filler = NO
|
|
55
|
+
Bkit.Verbose = NO
|
|
56
56
|
write-good.ThereIs = NO
|
|
57
57
|
write-good.So = NO
|
|
58
58
|
|
|
59
59
|
# bkit's reference copies of its templates (.bkit/templates/) — refreshed by
|
|
60
60
|
# `bkit upgrade`, not this repo's prose. Every rule off, as for docs/plans above.
|
|
61
61
|
[**/.bkit/templates/**/*.md]
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
62
|
+
Bkit.LLMSlop = NO
|
|
63
|
+
Bkit.Hedging = NO
|
|
64
|
+
Bkit.Filler = NO
|
|
65
|
+
Bkit.Verbose = NO
|
|
66
66
|
write-good.ThereIs = NO
|
|
67
67
|
write-good.So = NO
|
|
@@ -3,29 +3,35 @@
|
|
|
3
3
|
|
|
4
4
|
# Google Cloud Run — container logs
|
|
5
5
|
|
|
6
|
-
Fits: services running on Google Cloud Run. `context=runtime
|
|
6
|
+
Fits: services running on Google Cloud Run. The `context=runtime` block runs `gcloud logging read` on `cloud_run_revision` and returns the `severity>=ERROR` lines plus the platform's `Memory limit … exceeded` lines. Those lines are container kills (503 / SIGKILL exit 137). The app itself never logs them, and an error tracker never sees them, because the container dies before its SDK flushes.
|
|
7
7
|
|
|
8
|
-
- Secret: none locally after `gcloud auth login`.
|
|
9
|
-
-
|
|
10
|
-
-
|
|
8
|
+
- Secret: none locally after `gcloud auth login`.
|
|
9
|
+
- Secret in headless runs (cloud agents): `GCP_CLIENT_EMAIL` and `GCP_PRIVATE_KEY` of a service account with `roles/logging.viewer`. The block activates the service account only when the gcloud login cannot mint a token (no login, or a stale one). It does so in a throwaway gcloud config that it deletes on exit, so your own gcloud config is never switched.
|
|
10
|
+
- Non-secret: `GCP_PROJECT_ID`. Uncomment its line in the block so cloud agents inherit it.
|
|
11
|
+
- **If** dev and prod are separate projects → use the `GCP_PROJECT_ID` whose logs you want.
|
|
12
|
+
- Optional non-secret: `GCP_SERVICE` narrows the read to one service. The other knobs are `SINCE`, `GCP_N` and `GCP_FILTER`.
|
|
13
|
+
- CLI: `gcloud`. The provision block installs it in cloud, and GitHub-hosted Ubuntu runners already ship it. The block also uses `node` to build the key file.
|
|
11
14
|
|
|
12
15
|
Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`.
|
|
13
16
|
|
|
14
17
|
<!-- context-fetch:start cloudrun context=runtime -->
|
|
15
18
|
|
|
16
19
|
```bash
|
|
17
|
-
# GCP Cloud Run
|
|
20
|
+
# GCP Cloud Run container logs (read-only): platform and container errors, including OOM kills
|
|
18
21
|
# ("Memory limit of NNNN MiB exceeded" → 503 / SIGKILL exit 137) that never reach the app's own
|
|
19
22
|
# logs or its error tracker.
|
|
20
|
-
# GCP_PROJECT_ID is non-secret
|
|
21
|
-
# Optional GCP_SERVICE narrows to one service
|
|
23
|
+
# GCP_PROJECT_ID is non-secret. Uncomment and set the line below so cloud agents inherit it.
|
|
24
|
+
# Optional GCP_SERVICE narrows the read to one service. Unset, the block reads every
|
|
25
|
+
# cloud_run_revision in the project:
|
|
22
26
|
# GCP_PROJECT_ID="your-gcp-project-id"
|
|
23
27
|
# GCP_SERVICE="your-service-name"
|
|
24
|
-
# Headless auth: active gcloud login
|
|
25
|
-
# login lists ACTIVE yet fails every read with reauth.
|
|
26
|
-
#
|
|
27
|
-
#
|
|
28
|
-
#
|
|
28
|
+
# Headless auth: the block uses the active gcloud login only when `print-access-token` works. A
|
|
29
|
+
# stale user login still lists as ACTIVE, yet fails every read with reauth. With no working
|
|
30
|
+
# login, the block uses a service account built from GCP_CLIENT_EMAIL and GCP_PRIVATE_KEY (the
|
|
31
|
+
# `\n`-escaped PEM, un-escaped) in a throwaway CLOUDSDK_CONFIG, and leaves the operator's gcloud
|
|
32
|
+
# config untouched. Locally, run `gcloud auth login` once and skip both variables.
|
|
33
|
+
# A failed `gcloud logging read` → `skipped`.
|
|
34
|
+
# PII-safe: the block prints scalar and id fields only, never the raw payload.
|
|
29
35
|
# Customise: GCP_SERVICE; SINCE freshness; GCP_N; GCP_FILTER (add textPayload:"<prefix>" for app stdout). Positive control (suggested): run once with GCP_FILTER widened to a known log line; nothing back = reader broken, not clean.
|
|
30
36
|
command -v gcloud >/dev/null 2>&1 \
|
|
31
37
|
|| { echo "[context-fetch:cloudrun] skipped — gcloud CLI missing" >&2; exit 0; }
|
|
@@ -76,9 +82,11 @@ jq '[.[] | {timestamp, severity,
|
|
|
76
82
|
<!-- context-fetch:provision cloudrun -->
|
|
77
83
|
|
|
78
84
|
```bash
|
|
79
|
-
# Install the gcloud CLI in cloud if absent
|
|
80
|
-
#
|
|
81
|
-
#
|
|
85
|
+
# Install the gcloud CLI in cloud if it is absent. The block guards itself and does nothing when
|
|
86
|
+
# the CLI is present.
|
|
87
|
+
# The install script needs no root and no apt. With --disable-prompts it writes the SDK to $HOME
|
|
88
|
+
# and appends it to the shell profile, so later context-fetch shells, which source the profile,
|
|
89
|
+
# find it.
|
|
82
90
|
command -v gcloud >/dev/null 2>&1 \
|
|
83
91
|
|| curl -sSL https://sdk.cloud.google.com | bash -s -- --disable-prompts >/dev/null 2>&1
|
|
84
92
|
```
|