@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
package/dist/commands/lib.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
// commands/lib.ts — what every `bkit <noun> <verb>` command shares.
|
|
2
2
|
//
|
|
3
|
-
// Flag parsing, one
|
|
3
|
+
// Flag parsing, one output object on stdout (text, or JSON with `--json`),
|
|
4
|
+
// `[bkit-<noun>]`-tagged logs on stderr,
|
|
4
5
|
// the exit-code table, `--help` rendering, and the repo facts several workflow
|
|
5
6
|
// steps each re-derived by hand: repo root, UTC month, where `status.jsonl` lives,
|
|
6
7
|
// the skip-CI tokens, and which branches are shared. A command declares its flags,
|
|
@@ -10,7 +11,11 @@ import { spawnSync } from "node:child_process";
|
|
|
10
11
|
import * as fs from "node:fs";
|
|
11
12
|
import * as os from "node:os";
|
|
12
13
|
import * as path from "node:path";
|
|
13
|
-
import {
|
|
14
|
+
import { appendFrictionRow, appendJournalRow, engineCallRow, frictionRow, journalEnabled, launchedByGit, rebasePaused, shouldRecordFriction, } from "../ledgers/journal.js";
|
|
15
|
+
import { fold } from "../ledgers/status.js";
|
|
16
|
+
import { gitEnv, resolveGitSha } from "../ledgers/telemetry.js";
|
|
17
|
+
import { parseJson } from "../shared/json.js";
|
|
18
|
+
import { renderText } from "../shared/text.js";
|
|
14
19
|
// ---------------------------------------------------------------------------
|
|
15
20
|
// Exit codes
|
|
16
21
|
// ---------------------------------------------------------------------------
|
|
@@ -47,6 +52,38 @@ export class CommandError extends Error {
|
|
|
47
52
|
this.code = code;
|
|
48
53
|
}
|
|
49
54
|
}
|
|
55
|
+
/** Parse a whole-number flag, using its fallback only when absent. */
|
|
56
|
+
export const wholeNumber = (v, flag, fallback, min = 0) => {
|
|
57
|
+
if (v === undefined)
|
|
58
|
+
return fallback;
|
|
59
|
+
const s = String(v);
|
|
60
|
+
if (!/^[0-9]+$/.test(s) || Number(s) < min) {
|
|
61
|
+
throw new CommandError(EXIT.USAGE, `--${flag} takes a whole number >= ${min} (got "${s}")`);
|
|
62
|
+
}
|
|
63
|
+
return Number(s);
|
|
64
|
+
};
|
|
65
|
+
/** The holder named by this run when its tests-lock wait gave up. */
|
|
66
|
+
export function testsLockHolder(log, who) {
|
|
67
|
+
const prefix = `[machine-lock] ❌ ${who} gave up after `;
|
|
68
|
+
for (const line of log.split(/\r?\n/)) {
|
|
69
|
+
if (!line.startsWith(prefix))
|
|
70
|
+
continue;
|
|
71
|
+
const holder = /^\d+s waiting for tests, in use by (.+)$/.exec(line.slice(prefix.length));
|
|
72
|
+
if (holder)
|
|
73
|
+
return holder[1];
|
|
74
|
+
}
|
|
75
|
+
return null;
|
|
76
|
+
}
|
|
77
|
+
/** Classify only a tests-lock outcome, leaving gate and nested-lock failures intact. */
|
|
78
|
+
export function classifyLockExit({ exitCode, log, who, }) {
|
|
79
|
+
const lines = log.split(/\r?\n/);
|
|
80
|
+
if (exitCode === 75 && testsLockHolder(log, who) !== null)
|
|
81
|
+
return "lock-wait";
|
|
82
|
+
if (exitCode === 73 &&
|
|
83
|
+
lines.some((line) => /^\[machine-lock\] ❌ (?:could not take the lock for tests:|cannot take tests while holding )/.test(line)))
|
|
84
|
+
return "could-not-run";
|
|
85
|
+
return "gate";
|
|
86
|
+
}
|
|
50
87
|
// ---------------------------------------------------------------------------
|
|
51
88
|
// Flags
|
|
52
89
|
// ---------------------------------------------------------------------------
|
|
@@ -178,8 +215,8 @@ export function verbHelp(cmd, verb) {
|
|
|
178
215
|
"Flags:",
|
|
179
216
|
flags.length ? table(flags) : " none",
|
|
180
217
|
"",
|
|
181
|
-
"Output (one
|
|
182
|
-
table(Object.entries(spec.output)),
|
|
218
|
+
"Output (one object on stdout: `key: value` text, JSON with --json):",
|
|
219
|
+
table(Object.entries(spec.output).map(([key, help]) => [key, help + omitNote(spec, key)])),
|
|
183
220
|
"",
|
|
184
221
|
"Exit codes:",
|
|
185
222
|
table(exitCodeRows(spec.exitCodes)),
|
|
@@ -195,6 +232,174 @@ const processIo = {
|
|
|
195
232
|
stderr: (t) => process.stderr.write(t),
|
|
196
233
|
};
|
|
197
234
|
const isHelp = (arg) => arg === "--help" || arg === "-h";
|
|
235
|
+
/** Global boolean flag every verb takes; it is removed before the verb's own flags parse. */
|
|
236
|
+
const JSON_FLAG = "--json";
|
|
237
|
+
/** `output` less the keys `spec.textOmit` leaves out of text. */
|
|
238
|
+
function textOutput(spec, output) {
|
|
239
|
+
const omit = new Set((spec.textOmit ?? []).flatMap((o) => typeof o === "string" ? [o] : o.when(output[o.key], output) ? [o.key] : []));
|
|
240
|
+
return Object.fromEntries(Object.entries(output).filter(([k]) => !omit.has(k)));
|
|
241
|
+
}
|
|
242
|
+
/** `--help`'s note on an output key text leaves out: always, or only when it does not matter. */
|
|
243
|
+
function omitNote(spec, key) {
|
|
244
|
+
const o = (spec.textOmit ?? []).find((x) => (typeof x === "string" ? x : x.key) === key);
|
|
245
|
+
if (o === undefined)
|
|
246
|
+
return "";
|
|
247
|
+
return typeof o === "string" ? " (--json only)" : " (text: only when it matters)";
|
|
248
|
+
}
|
|
249
|
+
/** Row types `fold` reads; the other rows a `status.jsonl` carries (engine-call, ...) stay out of it. */
|
|
250
|
+
const FOLD_TYPES = new Set([
|
|
251
|
+
"workflow-started",
|
|
252
|
+
"step-done",
|
|
253
|
+
"workflow-meta",
|
|
254
|
+
"workflow-done",
|
|
255
|
+
"workflow-failed",
|
|
256
|
+
]);
|
|
257
|
+
/** Most `status.jsonl` files `resolveActiveRun` reads when it walks a checkout. */
|
|
258
|
+
const ACTIVE_RUN_SCAN_CAP = 500;
|
|
259
|
+
/** The workflow of the last run in `file` when that run is IN_PROGRESS, else undefined. */
|
|
260
|
+
function inProgressWorkflow(file) {
|
|
261
|
+
if (!fs.existsSync(file))
|
|
262
|
+
return undefined;
|
|
263
|
+
const events = [];
|
|
264
|
+
for (const line of fs.readFileSync(file, "utf-8").split("\n")) {
|
|
265
|
+
if (line.trim() === "")
|
|
266
|
+
continue;
|
|
267
|
+
const parsed = parseJson(line);
|
|
268
|
+
if (!parsed.ok || parsed.value === null || typeof parsed.value !== "object")
|
|
269
|
+
continue;
|
|
270
|
+
const type = parsed.value.type;
|
|
271
|
+
if (typeof type === "string" && FOLD_TYPES.has(type))
|
|
272
|
+
events.push(parsed.value);
|
|
273
|
+
}
|
|
274
|
+
const last = fold(events).at(-1);
|
|
275
|
+
return last?.status === "IN_PROGRESS" ? last.workflow : undefined;
|
|
276
|
+
}
|
|
277
|
+
/** The directories under `dir`, by name; none when `dir` is missing. */
|
|
278
|
+
function subdirs(dir) {
|
|
279
|
+
if (!fs.existsSync(dir))
|
|
280
|
+
return [];
|
|
281
|
+
return fs
|
|
282
|
+
.readdirSync(dir, { withFileTypes: true })
|
|
283
|
+
.filter((e) => e.isDirectory())
|
|
284
|
+
.map((e) => e.name);
|
|
285
|
+
}
|
|
286
|
+
/**
|
|
287
|
+
* The run a command call belongs to, or undefined. In order: the command's own
|
|
288
|
+
* `--file`; `--fid` (+ `--month`, default this UTC month) through `statusLocation`;
|
|
289
|
+
* the single IN_PROGRESS run among the `docs/plans/<month>/logs/<fid>/status.jsonl`
|
|
290
|
+
* files under the cwd's git toplevel (capped), only `--fid`'s own when it is set, so a
|
|
291
|
+
* run from an earlier month is found and another feature's run never is. From the main checkout a feature
|
|
292
|
+
* worktree's run is not found, so an out-of-worktree call is skipped, never
|
|
293
|
+
* attributed to another run. Reads with this module's own `node:fs` and `parseJson`
|
|
294
|
+
* and folds with `ledgers/status.ts`, so it never imports a `commands/**` module.
|
|
295
|
+
*/
|
|
296
|
+
export function resolveActiveRun(opts) {
|
|
297
|
+
// A `--file` that is a run's `status.jsonl` names that run; any other file (a plan or
|
|
298
|
+
// design doc) says nothing about the run and falls through to `--fid` and the scan.
|
|
299
|
+
if (opts.file !== undefined && path.basename(opts.file) === "status.jsonl") {
|
|
300
|
+
const file = path.resolve(opts.cwd, opts.file);
|
|
301
|
+
const workflow = inProgressWorkflow(file);
|
|
302
|
+
const logs = path.dirname(path.dirname(file));
|
|
303
|
+
if (workflow === undefined ||
|
|
304
|
+
path.basename(logs) !== "logs" ||
|
|
305
|
+
path.basename(path.dirname(path.dirname(logs))) !== "plans") {
|
|
306
|
+
return undefined;
|
|
307
|
+
}
|
|
308
|
+
return {
|
|
309
|
+
workflow,
|
|
310
|
+
file,
|
|
311
|
+
bookRoot: path.dirname(path.dirname(path.dirname(path.dirname(logs)))),
|
|
312
|
+
};
|
|
313
|
+
}
|
|
314
|
+
if (opts.fid !== undefined) {
|
|
315
|
+
try {
|
|
316
|
+
const loc = statusLocation({
|
|
317
|
+
cwd: opts.cwd,
|
|
318
|
+
workflow: opts.workflow ?? "build",
|
|
319
|
+
fid: opts.fid,
|
|
320
|
+
month: opts.month ?? utcMonth(),
|
|
321
|
+
});
|
|
322
|
+
const workflow = inProgressWorkflow(loc.path);
|
|
323
|
+
if (workflow !== undefined)
|
|
324
|
+
return { workflow, file: loc.path, bookRoot: loc.bookRoot };
|
|
325
|
+
}
|
|
326
|
+
catch (err) {
|
|
327
|
+
if (!(err instanceof CommandError))
|
|
328
|
+
throw err;
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
const top = git(opts.cwd, ["rev-parse", "--show-toplevel"]);
|
|
332
|
+
if (top === null)
|
|
333
|
+
return undefined;
|
|
334
|
+
const found = [];
|
|
335
|
+
let read = 0;
|
|
336
|
+
for (const month of subdirs(path.join(top, "docs", "plans"))) {
|
|
337
|
+
for (const fid of subdirs(path.join(top, "docs", "plans", month, "logs"))) {
|
|
338
|
+
if (++read > ACTIVE_RUN_SCAN_CAP)
|
|
339
|
+
return undefined;
|
|
340
|
+
if (opts.fid !== undefined && fid !== opts.fid)
|
|
341
|
+
continue;
|
|
342
|
+
const file = path.join(top, statusRelPath(month, fid));
|
|
343
|
+
const workflow = inProgressWorkflow(file);
|
|
344
|
+
if (workflow !== undefined)
|
|
345
|
+
found.push({ workflow, file, bookRoot: top });
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
return found.length === 1 ? found[0] : undefined;
|
|
349
|
+
}
|
|
350
|
+
/** The journal `runCommand` uses unless a caller injects one: writes into the active run's own books. */
|
|
351
|
+
function engineJournal() {
|
|
352
|
+
let resolved = false;
|
|
353
|
+
let run;
|
|
354
|
+
const active = (i) => {
|
|
355
|
+
if (!resolved) {
|
|
356
|
+
resolved = true;
|
|
357
|
+
const text = (v) => (typeof v === "string" ? v : undefined);
|
|
358
|
+
run = resolveActiveRun({
|
|
359
|
+
cwd: i.cwd,
|
|
360
|
+
file: text(i.flags["file"]),
|
|
361
|
+
fid: text(i.flags["fid"]),
|
|
362
|
+
month: text(i.flags["month"]),
|
|
363
|
+
workflow: text(i.flags["workflow"]),
|
|
364
|
+
});
|
|
365
|
+
}
|
|
366
|
+
return run;
|
|
367
|
+
};
|
|
368
|
+
return {
|
|
369
|
+
call(i) {
|
|
370
|
+
// A call git launched (a hook's `bkit disk prune`) writes no row to the tracked status file.
|
|
371
|
+
if (!journalEnabled() || launchedByGit())
|
|
372
|
+
return;
|
|
373
|
+
const r = active(i);
|
|
374
|
+
// A paused rebase refuses `--continue` while the tracked status file has an unstaged row.
|
|
375
|
+
if (r === undefined || rebasePaused(path.dirname(r.file)))
|
|
376
|
+
return;
|
|
377
|
+
const wrote = appendJournalRow(r.file, engineCallRow({ workflow: r.workflow, noun: i.noun, verb: i.verb, flags: i.argv }));
|
|
378
|
+
if (!wrote.ok)
|
|
379
|
+
throw new Error(wrote.error);
|
|
380
|
+
},
|
|
381
|
+
failure(i) {
|
|
382
|
+
if (!journalEnabled())
|
|
383
|
+
return;
|
|
384
|
+
const r = active(i);
|
|
385
|
+
if (r === undefined)
|
|
386
|
+
return;
|
|
387
|
+
const step = i.flags["step"];
|
|
388
|
+
const row = frictionRow({
|
|
389
|
+
workflow: r.workflow,
|
|
390
|
+
step: typeof step === "string" ? step : undefined,
|
|
391
|
+
noun: i.noun,
|
|
392
|
+
verb: i.verb,
|
|
393
|
+
code: i.code,
|
|
394
|
+
bookRoot: r.bookRoot,
|
|
395
|
+
parentSha: resolveGitSha("HEAD", r.bookRoot),
|
|
396
|
+
});
|
|
397
|
+
const wrote = appendFrictionRow(r.bookRoot, row);
|
|
398
|
+
if (!wrote.ok)
|
|
399
|
+
throw new Error(wrote.error);
|
|
400
|
+
},
|
|
401
|
+
};
|
|
402
|
+
}
|
|
198
403
|
/**
|
|
199
404
|
* Run `argv` (without the leading `bkit`) if it names a registered command.
|
|
200
405
|
* Returns the exit code, or null when `argv` is not a command, so the caller falls
|
|
@@ -231,42 +436,80 @@ export async function runCommand(argv, commands, options) {
|
|
|
231
436
|
const ctx = {
|
|
232
437
|
flags: {},
|
|
233
438
|
cwd: options.cwd ?? process.cwd(),
|
|
439
|
+
json: false,
|
|
234
440
|
log: (message) => io.stderr(`${tag} ${message}\n`),
|
|
235
441
|
emit: (output) => {
|
|
236
442
|
if (emitted)
|
|
237
|
-
throw new Error(`${tag} ${verb} emitted twice — one
|
|
443
|
+
throw new Error(`${tag} ${verb} emitted twice — one output object per run`);
|
|
238
444
|
emitted = true;
|
|
239
|
-
io.stdout(`${JSON.stringify(output)}\n`);
|
|
445
|
+
io.stdout(ctx.json ? `${JSON.stringify(output)}\n` : renderText(textOutput(spec, output)));
|
|
240
446
|
},
|
|
241
447
|
};
|
|
448
|
+
// The journal never changes the verb's exit code, output or throw: each write is
|
|
449
|
+
// swallowed, and the first failure logs one line.
|
|
450
|
+
const journal = options.journal ?? engineJournal();
|
|
451
|
+
let journalWarned = false;
|
|
452
|
+
const guarded = (write) => {
|
|
453
|
+
try {
|
|
454
|
+
write();
|
|
455
|
+
}
|
|
456
|
+
catch (err) {
|
|
457
|
+
if (journalWarned)
|
|
458
|
+
return;
|
|
459
|
+
journalWarned = true;
|
|
460
|
+
io.stderr(`[bkit-telemetry] journal write failed: ${err.message}\n`);
|
|
461
|
+
}
|
|
462
|
+
};
|
|
463
|
+
const excluded = new Set([...Object.keys(SHARED_EXIT_CODES), ...Object.keys(spec.exitCodes ?? {})].map(Number));
|
|
464
|
+
let input;
|
|
465
|
+
/** undefined: not dispatched; null: the verb threw; a number: its exit code. */
|
|
466
|
+
let outcome;
|
|
242
467
|
try {
|
|
243
|
-
|
|
244
|
-
|
|
468
|
+
const own = rest.filter((arg) => arg !== JSON_FLAG);
|
|
469
|
+
if (own.some((arg) => arg.startsWith(`${JSON_FLAG}=`))) {
|
|
470
|
+
throw new CommandError(EXIT.USAGE, `${JSON_FLAG} takes no value`);
|
|
471
|
+
}
|
|
472
|
+
ctx.json = own.length !== rest.length;
|
|
473
|
+
ctx.flags = parseFlags(own, spec.flags);
|
|
474
|
+
input = { noun: cmd.noun, verb, argv: rest, flags: ctx.flags, cwd: ctx.cwd };
|
|
475
|
+
const entered = input;
|
|
476
|
+
guarded(() => journal.call(entered));
|
|
477
|
+
outcome = null;
|
|
478
|
+
const code = await spec.run(ctx);
|
|
479
|
+
outcome = code;
|
|
480
|
+
return code;
|
|
245
481
|
}
|
|
246
482
|
catch (err) {
|
|
247
483
|
if (!(err instanceof CommandError))
|
|
248
484
|
throw err;
|
|
249
485
|
io.stderr(`${tag} ${err.message}\n`);
|
|
486
|
+
outcome = err.code;
|
|
250
487
|
return err.code;
|
|
251
488
|
}
|
|
489
|
+
finally {
|
|
490
|
+
if (input !== undefined && outcome !== undefined && shouldRecordFriction(outcome, excluded)) {
|
|
491
|
+
const failed = { ...input, code: outcome };
|
|
492
|
+
guarded(() => journal.failure(failed));
|
|
493
|
+
}
|
|
494
|
+
}
|
|
252
495
|
}
|
|
253
496
|
// ---------------------------------------------------------------------------
|
|
254
497
|
// Repo facts
|
|
255
498
|
// ---------------------------------------------------------------------------
|
|
256
|
-
/** Captured stdout / stderr cap for
|
|
257
|
-
const OUTPUT_LIMIT = 1 << 26;
|
|
499
|
+
/** Captured stdout / stderr cap for every git / gh spawn; hook output (pre-push) counts. */
|
|
500
|
+
export const OUTPUT_LIMIT = 1 << 26;
|
|
258
501
|
/** Spawn error as a stderr lead line: ENOBUFS names the limit, anything else Node's message. */
|
|
259
502
|
function spawnErrorText(cmd, args, err) {
|
|
260
503
|
return err.code === "ENOBUFS"
|
|
261
504
|
? `${cmd} ${args[0] ?? ""}: output passed the ${OUTPUT_LIMIT / (1 << 20)} MiB limit (ENOBUFS)`
|
|
262
505
|
: err.message;
|
|
263
506
|
}
|
|
264
|
-
/** `git <args>` in `cwd`, never throwing: exit status plus trimmed stdout / stderr. */
|
|
265
|
-
export function runGit(cwd, args) {
|
|
507
|
+
/** `git <args>` in `cwd`, never throwing: exit status plus trimmed stdout / stderr; `env` adds vars. */
|
|
508
|
+
export function runGit(cwd, args, env = {}) {
|
|
266
509
|
const res = spawnSync("git", args, {
|
|
267
510
|
cwd,
|
|
268
511
|
encoding: "utf-8",
|
|
269
|
-
env: gitEnv(),
|
|
512
|
+
env: { ...gitEnv(), ...env },
|
|
270
513
|
maxBuffer: OUTPUT_LIMIT,
|
|
271
514
|
});
|
|
272
515
|
const stderr = (res.stderr ?? "").trim();
|
|
@@ -283,12 +526,21 @@ export function git(cwd, args) {
|
|
|
283
526
|
const res = runGit(cwd, args);
|
|
284
527
|
return res.ok ? res.stdout : null;
|
|
285
528
|
}
|
|
529
|
+
/**
|
|
530
|
+
* True when git's ignore rules match `rel` in `cwd`. A tracked file reads as not
|
|
531
|
+
* ignored, so an ignored `rel` is always an untracked file git would refuse to
|
|
532
|
+
* `add` when a pathspec names it (the guard `:(exclude)` and `--pathspec-from-file`
|
|
533
|
+
* trip). Check before naming a path in an add pathspec.
|
|
534
|
+
*/
|
|
535
|
+
export function isIgnoredPath(cwd, rel) {
|
|
536
|
+
return runGit(cwd, ["check-ignore", "-q", "--", rel]).ok;
|
|
537
|
+
}
|
|
286
538
|
/** `JSON.parse` as a result instead of a throw; each caller says what bad input means for it. */
|
|
287
539
|
// Shared with the files that are not commands (checks, install): re-exported here
|
|
288
540
|
// for the command modules that already import it from this module.
|
|
289
541
|
export { parseJson } from "../shared/json.js";
|
|
290
542
|
// The shared-branch rule (`dev`, `main`) lives in shared/ so checks can read it too.
|
|
291
|
-
export { DEV, isSharedBranch } from "../shared/branches.js";
|
|
543
|
+
export { DEV, MAIN, isSharedBranch } from "../shared/branches.js";
|
|
292
544
|
/**
|
|
293
545
|
* Run a tool other than git, never throwing. Hook-exported GIT_* vars are scrubbed
|
|
294
546
|
* so gh and friends answer for `cwd`; `input` goes to stdin.
|
|
@@ -297,7 +549,7 @@ export function runTool(cmd, args, cwd, opts = {}) {
|
|
|
297
549
|
const res = spawnSync(cmd, args, {
|
|
298
550
|
cwd,
|
|
299
551
|
encoding: "utf-8",
|
|
300
|
-
env: gitEnv(),
|
|
552
|
+
env: { ...gitEnv(), ...opts.env },
|
|
301
553
|
input: opts.input,
|
|
302
554
|
maxBuffer: OUTPUT_LIMIT,
|
|
303
555
|
});
|
|
@@ -316,9 +568,9 @@ export function runTool(cmd, args, cwd, opts = {}) {
|
|
|
316
568
|
};
|
|
317
569
|
}
|
|
318
570
|
const signalNumber = (signal) => (signal ? os.constants.signals[signal] : undefined) ?? 1;
|
|
319
|
-
/** `gh <args>` in `cwd`, never throwing; `input` goes to stdin. */
|
|
320
|
-
export function runGh(cwd, args, input) {
|
|
321
|
-
const res = runTool("gh", args, cwd, { input });
|
|
571
|
+
/** `gh <args>` in `cwd`, never throwing; `input` goes to stdin; `env` is added to the child's. */
|
|
572
|
+
export function runGh(cwd, args, input, env) {
|
|
573
|
+
const res = runTool("gh", args, cwd, { input, env });
|
|
322
574
|
return {
|
|
323
575
|
ok: res.found && res.status === 0,
|
|
324
576
|
stdout: res.stdout.trim(),
|
|
@@ -333,15 +585,37 @@ export function runGh(cwd, args, input) {
|
|
|
333
585
|
* (its own credentials) can.
|
|
334
586
|
*/
|
|
335
587
|
export const ghUnavailable = (res) => res.missing || res.status === 4 || (!res.ok && /\bHTTP 403\b/.test(res.stderr));
|
|
588
|
+
/**
|
|
589
|
+
* The main checkout's root from any worktree, or `null` when not inside a git repo.
|
|
590
|
+
* `--git-common-dir` points at the shared `.git`, so a linked worktree resolves to the
|
|
591
|
+
* same root as the main one.
|
|
592
|
+
*/
|
|
593
|
+
export function mainCheckoutRoot(cwd) {
|
|
594
|
+
const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
|
|
595
|
+
return common ? path.dirname(common) : null;
|
|
596
|
+
}
|
|
336
597
|
/**
|
|
337
598
|
* The main checkout's root, from any worktree. `--git-common-dir` points at the
|
|
338
599
|
* shared `.git`, so a linked worktree resolves to the same root as the main one.
|
|
339
600
|
*/
|
|
340
601
|
export function repoRoot(cwd) {
|
|
341
|
-
const
|
|
342
|
-
if (!
|
|
602
|
+
const root = mainCheckoutRoot(cwd);
|
|
603
|
+
if (!root)
|
|
343
604
|
throw new CommandError(EXIT.USAGE, `not inside a git repository: ${cwd}`);
|
|
344
|
-
return
|
|
605
|
+
return root;
|
|
606
|
+
}
|
|
607
|
+
/** `<git common dir>/bkit-outbox`: per-run scratch files, never committed; null outside a git repo. */
|
|
608
|
+
export function outboxRoot(cwd) {
|
|
609
|
+
const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
|
|
610
|
+
return common ? path.join(common, "bkit-outbox") : null;
|
|
611
|
+
}
|
|
612
|
+
/** An outbox path as a committed record names it: relative to the main checkout, never a home path. */
|
|
613
|
+
export function outboxRel(cwd, file) {
|
|
614
|
+
const root = outboxRoot(cwd);
|
|
615
|
+
if (root === null)
|
|
616
|
+
return file;
|
|
617
|
+
const rel = path.relative(path.dirname(path.dirname(root)), file);
|
|
618
|
+
return rel.startsWith("..") || path.isAbsolute(rel) ? file : rel.split(path.sep).join("/");
|
|
345
619
|
}
|
|
346
620
|
/** `YYYYMM` in UTC, so every workflow picks the same month bucket at a month boundary. */
|
|
347
621
|
export function utcMonth(now = new Date()) {
|
|
@@ -7,13 +7,17 @@
|
|
|
7
7
|
import { ciCommand } from "./ci/ci.js";
|
|
8
8
|
import { setupCommand } from "./setup/setup.js";
|
|
9
9
|
import { branchesCommand } from "./workflow/branches.js";
|
|
10
|
+
import { challengeCommand } from "./workflow/challenge.js";
|
|
11
|
+
import { completenessCommand } from "./workflow/completeness.js";
|
|
10
12
|
import { contextCommand } from "./workflow/context.js";
|
|
11
13
|
import { countersCommand } from "./workflow/counters.js";
|
|
14
|
+
import { decisionsCommand } from "./workflow/decisions.js";
|
|
12
15
|
import { diskCommand } from "./workflow/disk.js";
|
|
13
16
|
import { fidsCommand } from "./workflow/fids.js";
|
|
14
17
|
import { issuesCommand } from "./workflow/issues.js";
|
|
15
18
|
import { ledgersCommand } from "./workflow/ledgers.js";
|
|
16
19
|
import { locksCommand } from "./workflow/locks.js";
|
|
20
|
+
import { plansCommand } from "./workflow/plans.js";
|
|
17
21
|
import { prsCommand } from "./workflow/prs.js";
|
|
18
22
|
import { repoCommand } from "./workflow/repo.js";
|
|
19
23
|
import { roadmapCommand } from "./workflow/roadmap.js";
|
|
@@ -22,18 +26,21 @@ import { runtimeCommand } from "./workflow/runtime.js";
|
|
|
22
26
|
import { skillsCommand } from "./workflow/skills.js";
|
|
23
27
|
import { statusCommand } from "./workflow/status.js";
|
|
24
28
|
import { stepsCommand } from "./workflow/steps.js";
|
|
29
|
+
import { tasksCommand } from "./workflow/tasks.js";
|
|
25
30
|
import { testsCommand } from "./workflow/tests.js";
|
|
26
31
|
import { workflowsCommand } from "./workflow/workflows.js";
|
|
27
|
-
import { workstreamsCommand } from "./workflow/workstreams.js";
|
|
28
32
|
import { worktreesCommand } from "./workflow/worktrees.js";
|
|
29
33
|
export const COMMANDS = [
|
|
30
34
|
statusCommand,
|
|
31
35
|
countersCommand,
|
|
32
36
|
stepsCommand,
|
|
37
|
+
tasksCommand,
|
|
33
38
|
runtimeCommand,
|
|
34
39
|
repoCommand,
|
|
35
40
|
fidsCommand,
|
|
36
41
|
testsCommand,
|
|
42
|
+
challengeCommand,
|
|
43
|
+
decisionsCommand,
|
|
37
44
|
locksCommand,
|
|
38
45
|
workflowsCommand,
|
|
39
46
|
worktreesCommand,
|
|
@@ -46,7 +53,8 @@ export const COMMANDS = [
|
|
|
46
53
|
ledgersCommand,
|
|
47
54
|
contextCommand,
|
|
48
55
|
roadmapCommand,
|
|
49
|
-
|
|
56
|
+
plansCommand,
|
|
57
|
+
completenessCommand,
|
|
50
58
|
ciCommand,
|
|
51
59
|
setupCommand,
|
|
52
60
|
];
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// The policy also binds admins. `dev` is left unprotected — operators choose
|
|
6
6
|
// direct-push or feat/PR.
|
|
7
7
|
//
|
|
8
|
-
// The required check is `bkit.
|
|
8
|
+
// The required check is `bkit.testing.ciCapstone`, the always-on job that asserts every
|
|
9
9
|
// expected tier ran and passed, so "required check green" means validated, not
|
|
10
10
|
// merely "the tests job did not fail". Before requiring it the command checks a
|
|
11
11
|
// job by that name exists in the CI workflow: a required check no job produces
|
|
@@ -16,9 +16,9 @@ import { readBkitConfig } from "../../shared/settings.js";
|
|
|
16
16
|
import { CommandError, EXIT, parseJson, repoRoot, runGh, } from "../lib.js";
|
|
17
17
|
/** Exit code: `gh repo view` did not name the repository. */
|
|
18
18
|
export const EXIT_NO_REPO = 3;
|
|
19
|
-
/** Exit code: the CI workflow file named by `bkit.ciWorkflow` does not exist. */
|
|
19
|
+
/** Exit code: the CI workflow file named by `bkit.testing.ciWorkflow` does not exist. */
|
|
20
20
|
export const EXIT_NO_CI_WORKFLOW = 4;
|
|
21
|
-
/** Exit code: the CI workflow has no job named `bkit.
|
|
21
|
+
/** Exit code: the CI workflow has no job named `bkit.testing.ciCapstone`. */
|
|
22
22
|
export const EXIT_NO_CAPSTONE_JOB = 5;
|
|
23
23
|
/** Exit code: a `gh api` call failed. */
|
|
24
24
|
export const EXIT_GH_API_FAILED = 6;
|
|
@@ -123,6 +123,7 @@ export const setupCommand = {
|
|
|
123
123
|
verbs: {
|
|
124
124
|
"protect-main": {
|
|
125
125
|
summary: "Apply bkit's branch protection to main, requiring the capstone check.",
|
|
126
|
+
use: "by-hand",
|
|
126
127
|
flags: [
|
|
127
128
|
{
|
|
128
129
|
name: "dry-run",
|
|
@@ -138,8 +139,8 @@ export const setupCommand = {
|
|
|
138
139
|
output: {
|
|
139
140
|
repo: "owner/name the policy targets",
|
|
140
141
|
branch: "always main",
|
|
141
|
-
requiredCheck: "the required status check (bkit.
|
|
142
|
-
ciWorkflow: "the CI workflow checked for that job (bkit.ciWorkflow)",
|
|
142
|
+
requiredCheck: "the required status check (bkit.testing.ciCapstone)",
|
|
143
|
+
ciWorkflow: "the CI workflow checked for that job (bkit.testing.ciWorkflow)",
|
|
143
144
|
dryRun: "true with --dry-run",
|
|
144
145
|
applied: "true when the policy was written to GitHub",
|
|
145
146
|
payload: "the protection body sent (or that would be sent)",
|
|
@@ -148,8 +149,8 @@ export const setupCommand = {
|
|
|
148
149
|
},
|
|
149
150
|
exitCodes: {
|
|
150
151
|
[EXIT_NO_REPO]: "gh repo view could not name the repository",
|
|
151
|
-
[EXIT_NO_CI_WORKFLOW]: "the CI workflow file (bkit.ciWorkflow) does not exist",
|
|
152
|
-
[EXIT_NO_CAPSTONE_JOB]: "the CI workflow has no job named bkit.
|
|
152
|
+
[EXIT_NO_CI_WORKFLOW]: "the CI workflow file (bkit.testing.ciWorkflow) does not exist",
|
|
153
|
+
[EXIT_NO_CAPSTONE_JOB]: "the CI workflow has no job named bkit.testing.ciCapstone",
|
|
153
154
|
[EXIT_GH_API_FAILED]: "a gh api call failed",
|
|
154
155
|
},
|
|
155
156
|
run: protectMain,
|