@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
|
@@ -0,0 +1,378 @@
|
|
|
1
|
+
// commands/workflow/tasks.ts — the plan's task boxes as a command.
|
|
2
|
+
//
|
|
3
|
+
// The tick a verified group hands over: `tick` addresses each task by the heading line
|
|
4
|
+
// inside the block `parsePlanBlocks` returns (`line`..`end`), rewrites only that line's
|
|
5
|
+
// box `[ ]` -> `[x]` and leaves every other byte of the plan as it was. Idempotent: a
|
|
6
|
+
// task already ticked is not rewritten and never repeated in `ticked`. `--green` reads a
|
|
7
|
+
// `bkit tests green` report and drops every task it gaps, so a group's gap-free tasks
|
|
8
|
+
// tick without the caller re-reading the report.
|
|
9
|
+
//
|
|
10
|
+
// `open` reads the execute log for the group's `DONE` / `BLOCKED` lines; `currency`
|
|
11
|
+
// matches each task's `CREATE` / `READ` / `UPDATE` / `DELETE` paths and symbols against
|
|
12
|
+
// `{base}...{against}` and prints the matched paths, needles and diff hunks — the
|
|
13
|
+
// mechanical half of the plan-currency judgement, which stays with the agent.
|
|
14
|
+
import * as fs from "node:fs";
|
|
15
|
+
import * as path from "node:path";
|
|
16
|
+
import { parseJson } from "../../shared/json.js";
|
|
17
|
+
import { CommandError, EXIT, git, runGit } from "../lib.js";
|
|
18
|
+
import { EXIT_DIFF_FAILED, fetchRemoteRef } from "./branches.js";
|
|
19
|
+
import { DIFF_BASE } from "./context.js";
|
|
20
|
+
import { NO_MARKERS_REASON, parsePlanBlocks, } from "./plan-blocks.js";
|
|
21
|
+
import { positiveInt, str } from "./status.js";
|
|
22
|
+
import { doneTasks } from "./tests.js";
|
|
23
|
+
/** A task's heading line: the box and the number the tick addresses. */
|
|
24
|
+
const TASK_BOX = /^(\s*)- \[([ xX])\] \*\*TASK (\d+):\*\*/;
|
|
25
|
+
/** A `tests green` report's gap line: `- Task {N} \`{kind}\` — …`. */
|
|
26
|
+
const REPORT_GAP = /^-\s+Task\s+(\d+)\s+`/gm;
|
|
27
|
+
/** The plan at `arg`, its blocks parsed: exit 2 for no such file or a block that does not parse, 1 for no task blocks. */
|
|
28
|
+
function readPlan(cwd, arg) {
|
|
29
|
+
const file = path.resolve(cwd, arg);
|
|
30
|
+
if (fs.statSync(file, { throwIfNoEntry: false })?.isFile() !== true)
|
|
31
|
+
throw new CommandError(EXIT.USAGE, `${arg} does not exist`);
|
|
32
|
+
const text = fs.readFileSync(file, "utf-8");
|
|
33
|
+
const blocks = parsePlanBlocks(text);
|
|
34
|
+
const error = blocks.errors[0];
|
|
35
|
+
if (error !== undefined)
|
|
36
|
+
throw new CommandError(EXIT.USAGE, `${arg}:${error.line}: ${error.message} — run \`bkit tests plan-check\``);
|
|
37
|
+
if (blocks.tasks.length === 0)
|
|
38
|
+
throw new CommandError(EXIT.NO, `${arg}: ${NO_MARKERS_REASON}`);
|
|
39
|
+
return { file, text, groups: blocks.groups, tasks: blocks.tasks };
|
|
40
|
+
}
|
|
41
|
+
/** The tasks of `group`: exit 2 when the plan has no such group. */
|
|
42
|
+
function groupTasks(plan, arg, group) {
|
|
43
|
+
if (!plan.groups.some((g) => g.group === group))
|
|
44
|
+
throw new CommandError(EXIT.USAGE, `${arg} has no GROUP ${group}`);
|
|
45
|
+
return plan.tasks.filter((t) => t.group === group);
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* The task numbers a repeated value names: comma- or space-separated, each a positive
|
|
49
|
+
* integer. The token `none` names nothing to tick, so the verify header's empty form
|
|
50
|
+
* (`Tasks: none`) passes straight through as `ticked: []`.
|
|
51
|
+
*/
|
|
52
|
+
function taskNumbers(values, flag) {
|
|
53
|
+
const numbers = [];
|
|
54
|
+
let none = false;
|
|
55
|
+
for (const value of values)
|
|
56
|
+
for (const token of value.split(/[\s,]+/).filter((t) => t !== "")) {
|
|
57
|
+
if (token.toLowerCase() === "none") {
|
|
58
|
+
none = true;
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
if (!/^[1-9][0-9]*$/.test(token))
|
|
62
|
+
throw new CommandError(EXIT.USAGE, `--${flag} must name positive task numbers, got "${token}"`);
|
|
63
|
+
const n = Number(token);
|
|
64
|
+
if (!numbers.includes(n))
|
|
65
|
+
numbers.push(n);
|
|
66
|
+
}
|
|
67
|
+
if (numbers.length === 0 && !none)
|
|
68
|
+
throw new CommandError(EXIT.USAGE, `--${flag} names no task`);
|
|
69
|
+
return numbers;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The task numbers a `bkit tests green` report gaps: the `- Task {N} \`{kind}\`` lines of
|
|
73
|
+
* its `## Gaps` section, or the `gaps` array of its `--json` payload.
|
|
74
|
+
*/
|
|
75
|
+
export function gappedTasks(text) {
|
|
76
|
+
const json = parseJson(text);
|
|
77
|
+
if (json.ok && typeof json.value === "object" && json.value !== null) {
|
|
78
|
+
const gaps = json.value.gaps;
|
|
79
|
+
if (Array.isArray(gaps))
|
|
80
|
+
return gaps
|
|
81
|
+
.map((g) => (typeof g === "object" && g !== null ? g.task : null))
|
|
82
|
+
.filter((t) => typeof t === "number");
|
|
83
|
+
}
|
|
84
|
+
return [...text.matchAll(REPORT_GAP)].map((m) => Number(m[1]));
|
|
85
|
+
}
|
|
86
|
+
/** `task`'s heading line inside its block: its box and number, or null when the block holds none. */
|
|
87
|
+
function headBox(lines, task) {
|
|
88
|
+
for (let i = task.line - 1; i < task.end; i++) {
|
|
89
|
+
const box = TASK_BOX.exec(lines[i]);
|
|
90
|
+
if (box !== null && Number(box[3]) === task.task)
|
|
91
|
+
return { index: i, ticked: box[2] !== " " };
|
|
92
|
+
}
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
/** The refs a task names: its four path-and-symbol fields. */
|
|
96
|
+
const taskRefs = (task) => [
|
|
97
|
+
...task.create,
|
|
98
|
+
...task.read,
|
|
99
|
+
...task.update,
|
|
100
|
+
...task.delete,
|
|
101
|
+
];
|
|
102
|
+
/**
|
|
103
|
+
* A plan symbol as a `git diff -S` needle: a Markdown section's heading text, a flag,
|
|
104
|
+
* or the leading identifier of an applied symbol (`doneTasks(log, verbs)` -> `doneTasks`).
|
|
105
|
+
*/
|
|
106
|
+
export function needleOf(symbol) {
|
|
107
|
+
const s = symbol.trim();
|
|
108
|
+
if (s === "")
|
|
109
|
+
return undefined;
|
|
110
|
+
const heading = /^§\s*(.+)$/.exec(s);
|
|
111
|
+
if (heading)
|
|
112
|
+
return heading[1].trim();
|
|
113
|
+
const token = /^(--?[\w-]+|[A-Za-z_$][\w$]*)/.exec(s)?.[0];
|
|
114
|
+
if (token === undefined)
|
|
115
|
+
return s;
|
|
116
|
+
return /^[A-Za-z_$][\w$]*\s*[(\[]/.test(s) || token === s ? token : s;
|
|
117
|
+
}
|
|
118
|
+
/** `paths` as git printed them, split on NUL; empty output is no path. */
|
|
119
|
+
const splitPaths = (stdout) => stdout.split("\0").filter(Boolean);
|
|
120
|
+
/** A workflow run log: another feature's record, never code a plan task reads or changes. */
|
|
121
|
+
const RUN_LOG = /^docs\/plans\/[^/]+\/logs\//;
|
|
122
|
+
export const tasksCommand = {
|
|
123
|
+
noun: "tasks",
|
|
124
|
+
summary: "Tick a plan's task boxes, from the tasks a verify judged satisfied.",
|
|
125
|
+
verbs: {
|
|
126
|
+
tick: {
|
|
127
|
+
summary: "Tick the named tasks of one task group, less those a `tests green` report gaps; exit 0 ticked (including none), 1 a plan with no task blocks, 2 a bad flag value or plan.",
|
|
128
|
+
use: "workflow",
|
|
129
|
+
flags: [
|
|
130
|
+
{
|
|
131
|
+
name: "plan",
|
|
132
|
+
type: "string",
|
|
133
|
+
required: true,
|
|
134
|
+
help: "plan file holding the task blocks",
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
name: "group",
|
|
138
|
+
type: "string",
|
|
139
|
+
required: true,
|
|
140
|
+
help: "the task group whose tasks are candidates (positive integer)",
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
name: "tasks",
|
|
144
|
+
type: "string",
|
|
145
|
+
repeatable: true,
|
|
146
|
+
help: "the task numbers to tick, comma-separated or once per number; `none` ticks nothing (one of --tasks / --green)",
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
name: "green",
|
|
150
|
+
type: "string",
|
|
151
|
+
help: "a `bkit tests green` report: every task it gaps stays unticked (one of --tasks / --green)",
|
|
152
|
+
},
|
|
153
|
+
],
|
|
154
|
+
output: {
|
|
155
|
+
plan: "the plan file ticked, as given",
|
|
156
|
+
group: "the group whose tasks were candidates",
|
|
157
|
+
ticked: "[task numbers] ticked by this call; a task already ticked is not repeated",
|
|
158
|
+
},
|
|
159
|
+
run: (ctx) => {
|
|
160
|
+
const planArg = String(ctx.flags.plan);
|
|
161
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
162
|
+
if (group === undefined)
|
|
163
|
+
throw new CommandError(EXIT.USAGE, "missing required flag --group");
|
|
164
|
+
const tasksFlag = ctx.flags.tasks;
|
|
165
|
+
const greenArg = str(ctx.flags.green);
|
|
166
|
+
if (greenArg === "")
|
|
167
|
+
throw new CommandError(EXIT.USAGE, "--green must be non-empty");
|
|
168
|
+
if (tasksFlag === undefined && greenArg === undefined)
|
|
169
|
+
throw new CommandError(EXIT.USAGE, "give one of --tasks and --green");
|
|
170
|
+
const plan = readPlan(ctx.cwd, planArg);
|
|
171
|
+
const candidates = groupTasks(plan, planArg, group);
|
|
172
|
+
const named = tasksFlag === undefined ? undefined : taskNumbers(tasksFlag, "tasks");
|
|
173
|
+
for (const n of named ?? []) {
|
|
174
|
+
const task = plan.tasks.find((t) => t.task === n);
|
|
175
|
+
if (task === undefined)
|
|
176
|
+
throw new CommandError(EXIT.USAGE, `${planArg} has no TASK ${n}`);
|
|
177
|
+
if (task.group !== group)
|
|
178
|
+
throw new CommandError(EXIT.USAGE, `TASK ${n} is in group ${task.group}, not group ${group}`);
|
|
179
|
+
}
|
|
180
|
+
const gapped = new Set();
|
|
181
|
+
if (greenArg !== undefined) {
|
|
182
|
+
const greenFile = path.resolve(ctx.cwd, greenArg);
|
|
183
|
+
if (fs.statSync(greenFile, { throwIfNoEntry: false })?.isFile() !== true)
|
|
184
|
+
throw new CommandError(EXIT.USAGE, `--green ${greenArg} does not exist`);
|
|
185
|
+
for (const n of gappedTasks(fs.readFileSync(greenFile, "utf-8")))
|
|
186
|
+
gapped.add(n);
|
|
187
|
+
}
|
|
188
|
+
const wanted = named ?? candidates.map((t) => t.task);
|
|
189
|
+
const lines = plan.text.split(/\r?\n/);
|
|
190
|
+
const eol = plan.text.includes("\r\n") ? "\r\n" : "\n";
|
|
191
|
+
const ticked = [];
|
|
192
|
+
for (const n of wanted) {
|
|
193
|
+
if (gapped.has(n))
|
|
194
|
+
continue;
|
|
195
|
+
const task = candidates.find((t) => t.task === n);
|
|
196
|
+
if (task === undefined)
|
|
197
|
+
continue;
|
|
198
|
+
const head = headBox(lines, task);
|
|
199
|
+
if (head === null || head.ticked)
|
|
200
|
+
continue;
|
|
201
|
+
lines[head.index] = lines[head.index].replace(/^(\s*)- \[ \] /, "$1- [x] ");
|
|
202
|
+
ticked.push(n);
|
|
203
|
+
}
|
|
204
|
+
if (ticked.length > 0)
|
|
205
|
+
fs.writeFileSync(plan.file, lines.join(eol));
|
|
206
|
+
for (const n of ticked)
|
|
207
|
+
ctx.log(`ticked TASK ${n}`);
|
|
208
|
+
ctx.emit({
|
|
209
|
+
plan: planArg,
|
|
210
|
+
group,
|
|
211
|
+
ticked,
|
|
212
|
+
});
|
|
213
|
+
return EXIT.OK;
|
|
214
|
+
},
|
|
215
|
+
},
|
|
216
|
+
open: {
|
|
217
|
+
summary: "Print the group's tasks holding neither a `DONE` nor a `BLOCKED` line in the plan-execute log, and whether any is open; exit 0 (including none), 1 a plan with no task blocks, 2 a missing file or group.",
|
|
218
|
+
use: "by-hand",
|
|
219
|
+
flags: [
|
|
220
|
+
{
|
|
221
|
+
name: "plan",
|
|
222
|
+
type: "string",
|
|
223
|
+
required: true,
|
|
224
|
+
help: "plan file holding the task blocks",
|
|
225
|
+
},
|
|
226
|
+
{
|
|
227
|
+
name: "group",
|
|
228
|
+
type: "string",
|
|
229
|
+
required: true,
|
|
230
|
+
help: "the task group whose tasks are read (positive integer)",
|
|
231
|
+
},
|
|
232
|
+
{
|
|
233
|
+
name: "log",
|
|
234
|
+
type: "string",
|
|
235
|
+
required: true,
|
|
236
|
+
help: "the plan-execute log holding its `DONE` / `BLOCKED — TASK {N}` lines",
|
|
237
|
+
},
|
|
238
|
+
],
|
|
239
|
+
output: {
|
|
240
|
+
plan: "the plan file read, as given",
|
|
241
|
+
group: "the group whose tasks were read",
|
|
242
|
+
tasks: "[task numbers] the group's tasks with neither a `DONE` nor a `BLOCKED` line",
|
|
243
|
+
handover: "true when at least one task is open, else false",
|
|
244
|
+
},
|
|
245
|
+
run: (ctx) => {
|
|
246
|
+
const planArg = String(ctx.flags.plan);
|
|
247
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
248
|
+
if (group === undefined)
|
|
249
|
+
throw new CommandError(EXIT.USAGE, "missing required flag --group");
|
|
250
|
+
const logArg = String(ctx.flags.log);
|
|
251
|
+
const logFile = path.resolve(ctx.cwd, logArg);
|
|
252
|
+
if (fs.statSync(logFile, { throwIfNoEntry: false })?.isFile() !== true)
|
|
253
|
+
throw new CommandError(EXIT.USAGE, `--log ${logArg} does not exist`);
|
|
254
|
+
const plan = readPlan(ctx.cwd, planArg);
|
|
255
|
+
const candidates = groupTasks(plan, planArg, group);
|
|
256
|
+
const closed = new Set(doneTasks(fs.readFileSync(logFile, "utf-8"), ["DONE", "BLOCKED"]));
|
|
257
|
+
// The log decides, not the box: a ticked task with no log line is still open.
|
|
258
|
+
const open = candidates.filter((t) => !closed.has(t.task)).map((t) => t.task);
|
|
259
|
+
for (const n of open)
|
|
260
|
+
ctx.log(`TASK ${n} is open`);
|
|
261
|
+
ctx.emit({ plan: planArg, group, tasks: open, handover: open.length > 0 });
|
|
262
|
+
return EXIT.OK;
|
|
263
|
+
},
|
|
264
|
+
},
|
|
265
|
+
currency: {
|
|
266
|
+
summary: "Print each task whose CREATE / READ / UPDATE / DELETE paths or symbols moved between --base and --against, with its matched paths, needles and diff hunks (run logs under docs/plans/*/logs/ are left out); exit 0 (including no match), 1 a plan with no task blocks, 2 a bad plan.",
|
|
267
|
+
use: "by-hand",
|
|
268
|
+
flags: [
|
|
269
|
+
{
|
|
270
|
+
name: "plan",
|
|
271
|
+
type: "string",
|
|
272
|
+
required: true,
|
|
273
|
+
help: "plan file holding the task blocks",
|
|
274
|
+
},
|
|
275
|
+
{
|
|
276
|
+
name: "base",
|
|
277
|
+
type: "string",
|
|
278
|
+
help: "the commit the plan was written against (default origin/dev)",
|
|
279
|
+
},
|
|
280
|
+
{
|
|
281
|
+
name: "against",
|
|
282
|
+
type: "string",
|
|
283
|
+
help: "the commit landed changes are judged on (default origin/dev)",
|
|
284
|
+
},
|
|
285
|
+
],
|
|
286
|
+
output: {
|
|
287
|
+
plan: "the plan file read, as given",
|
|
288
|
+
base: "the commit the plan was written against",
|
|
289
|
+
against: "the commit landed changes were judged on",
|
|
290
|
+
tasks: "each matched task ({task, group, paths, needles, hunks}): the changed paths and the needles that moved, and the diff over those paths only",
|
|
291
|
+
},
|
|
292
|
+
exitCodes: {
|
|
293
|
+
[EXIT_DIFF_FAILED]: "--base or --against does not resolve, or git diff failed",
|
|
294
|
+
},
|
|
295
|
+
run: (ctx) => {
|
|
296
|
+
const planArg = String(ctx.flags.plan);
|
|
297
|
+
const base = str(ctx.flags.base) ?? DIFF_BASE;
|
|
298
|
+
const against = str(ctx.flags.against) ?? DIFF_BASE;
|
|
299
|
+
if (base === "")
|
|
300
|
+
throw new CommandError(EXIT.USAGE, "--base must be non-empty");
|
|
301
|
+
if (against === "")
|
|
302
|
+
throw new CommandError(EXIT.USAGE, "--against must be non-empty");
|
|
303
|
+
const plan = readPlan(ctx.cwd, planArg);
|
|
304
|
+
const top = git(ctx.cwd, ["rev-parse", "--show-toplevel"]);
|
|
305
|
+
if (top === null)
|
|
306
|
+
throw new CommandError(EXIT.USAGE, `not inside a git work tree: ${ctx.cwd}`);
|
|
307
|
+
for (const ref of [base, against]) {
|
|
308
|
+
const fetched = fetchRemoteRef(top, ref);
|
|
309
|
+
if (fetched !== null && !fetched.ok)
|
|
310
|
+
ctx.log(`git fetch for ${ref} failed — judging against the last fetch: ${fetched.stderr}`);
|
|
311
|
+
if (git(top, ["rev-parse", "-q", "--verify", `${ref}^{commit}`]) === null)
|
|
312
|
+
throw new CommandError(EXIT_DIFF_FAILED, `${ref} does not resolve to a commit`);
|
|
313
|
+
}
|
|
314
|
+
const range = `${base}...${against}`;
|
|
315
|
+
const changed = runGit(top, ["diff", "--name-only", "-z", "--no-renames", range]);
|
|
316
|
+
if (!changed.ok)
|
|
317
|
+
throw new CommandError(EXIT_DIFF_FAILED, `git diff ${range} failed: ${changed.stderr}`);
|
|
318
|
+
const changedPaths = splitPaths(changed.stdout).filter((p) => !RUN_LOG.test(p));
|
|
319
|
+
const needleCache = new Map();
|
|
320
|
+
/** The paths `needle` moved in, read once per needle. */
|
|
321
|
+
const needleMoves = (needle) => {
|
|
322
|
+
const cached = needleCache.get(needle);
|
|
323
|
+
if (cached !== undefined)
|
|
324
|
+
return cached;
|
|
325
|
+
const diff = runGit(top, [
|
|
326
|
+
"diff",
|
|
327
|
+
"--no-renames",
|
|
328
|
+
"-S",
|
|
329
|
+
needle,
|
|
330
|
+
"--name-only",
|
|
331
|
+
"-z",
|
|
332
|
+
range,
|
|
333
|
+
]);
|
|
334
|
+
if (!diff.ok)
|
|
335
|
+
throw new CommandError(EXIT_DIFF_FAILED, `git diff ${range} -S${needle} failed: ${diff.stderr}`);
|
|
336
|
+
const paths = splitPaths(diff.stdout).filter((p) => !RUN_LOG.test(p));
|
|
337
|
+
needleCache.set(needle, paths);
|
|
338
|
+
return paths;
|
|
339
|
+
};
|
|
340
|
+
const tasks = [];
|
|
341
|
+
for (const task of plan.tasks) {
|
|
342
|
+
const refs = taskRefs(task);
|
|
343
|
+
const files = [...new Set(refs.map((r) => r.file.trim()).filter((f) => f !== ""))];
|
|
344
|
+
const paths = changedPaths.filter((p) => files.some((f) => p === f || p.startsWith(`${f}/`)));
|
|
345
|
+
const needles = [];
|
|
346
|
+
for (const ref of refs) {
|
|
347
|
+
if (ref.symbol === undefined)
|
|
348
|
+
continue;
|
|
349
|
+
const needle = needleOf(ref.symbol);
|
|
350
|
+
if (needle === undefined || needles.includes(needle))
|
|
351
|
+
continue;
|
|
352
|
+
if (needleMoves(needle).length > 0)
|
|
353
|
+
needles.push(needle);
|
|
354
|
+
}
|
|
355
|
+
const matched = paths.length > 0
|
|
356
|
+
? paths
|
|
357
|
+
: [...new Set(needles.flatMap((needle) => needleMoves(needle)))].sort();
|
|
358
|
+
if (matched.length === 0)
|
|
359
|
+
continue;
|
|
360
|
+
const diff = runGit(top, ["diff", "--no-renames", range, "--", ...matched]);
|
|
361
|
+
if (!diff.ok)
|
|
362
|
+
throw new CommandError(EXIT_DIFF_FAILED, `git diff ${range} failed: ${diff.stderr}`);
|
|
363
|
+
tasks.push({
|
|
364
|
+
task: task.task,
|
|
365
|
+
group: task.group,
|
|
366
|
+
paths: matched,
|
|
367
|
+
needles,
|
|
368
|
+
hunks: diff.stdout === "" ? [] : diff.stdout.split("\n"),
|
|
369
|
+
});
|
|
370
|
+
}
|
|
371
|
+
for (const t of tasks)
|
|
372
|
+
ctx.log(`TASK ${t.task}: ${t.paths.join(", ")}`);
|
|
373
|
+
ctx.emit({ plan: planArg, base, against, tasks });
|
|
374
|
+
return EXIT.OK;
|
|
375
|
+
},
|
|
376
|
+
},
|
|
377
|
+
},
|
|
378
|
+
};
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
// Where one named test sits in its file, and which of the file's other lines it runs —
|
|
2
|
+
// read from indentation alone, with no parser for any language, so `tests green` can
|
|
3
|
+
// tell an edit to a planned test from an edit elsewhere in the same file.
|
|
4
|
+
//
|
|
5
|
+
// A block is a line plus every following line indented deeper, plus a closing line at
|
|
6
|
+
// its own indent (`}`, `)`, `]`, `end`), and the deeper lines after that line when it
|
|
7
|
+
// opens again (`} else {`, `): T {`). A test's block starts at the line declaring it
|
|
8
|
+
// (`declaredName`). What a test runs: its own block, the lines of the blocks around it,
|
|
9
|
+
// and each item in those scopes that is not a test — a hook or bare statement always, a
|
|
10
|
+
// declaration only when the test, or code it runs, names it. Pure text in, no fs.
|
|
11
|
+
/** A test declaration's name on `line`, or null when the line declares no test. */
|
|
12
|
+
export function declaredName(line) {
|
|
13
|
+
const call = /\b(?:it|test|suite|describe|context|bench)(?:\.[a-z]+)*\s*\(\s*(["'`])(.+?)\1/.exec(line);
|
|
14
|
+
if (call !== null)
|
|
15
|
+
return call[2];
|
|
16
|
+
const go = /\bfunc\s+(Test\w+)\s*\(/.exec(line);
|
|
17
|
+
if (go !== null)
|
|
18
|
+
return go[1];
|
|
19
|
+
const py = /\bdef\s+(test_\w+)\s*\(/.exec(line);
|
|
20
|
+
if (py !== null)
|
|
21
|
+
return py[1];
|
|
22
|
+
if (/@Test\b/.test(line)) {
|
|
23
|
+
const java = /\b(?:void|fun)\s+(\w+)\s*\(/.exec(line);
|
|
24
|
+
return java?.[1] ?? line.trim();
|
|
25
|
+
}
|
|
26
|
+
return null;
|
|
27
|
+
}
|
|
28
|
+
/** A test call whose name is on the next line: `it(` alone, as a formatter wraps a long name. */
|
|
29
|
+
const WRAPPED_CALL = /\b(?:it|test|suite|describe|context|bench)(?:\.[a-z]+)*\s*\(\s*$/;
|
|
30
|
+
const CLOSER = /^\s*(?:[}\])]|end\b)/;
|
|
31
|
+
const REOPENS = /(?:[{([]|\bdo)\s*$/;
|
|
32
|
+
const QUOTED = /"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|`(?:[^`\\]|\\.)*`/g;
|
|
33
|
+
const WORD = /[A-Za-z_$][\w$]*/g;
|
|
34
|
+
const IMPORT = /^\s*(?:import|from|use|using|require|include)\b|\brequire\s*\(/;
|
|
35
|
+
const IMPORT_WORDS = new Set([
|
|
36
|
+
"import",
|
|
37
|
+
"from",
|
|
38
|
+
"as",
|
|
39
|
+
"type",
|
|
40
|
+
"use",
|
|
41
|
+
"using",
|
|
42
|
+
"require",
|
|
43
|
+
"include",
|
|
44
|
+
]);
|
|
45
|
+
const DECLARED = /\b(?:function\*?|def|fn|func|class|interface|type|enum|struct|trait|module|const|let|var|val)\s+(?:\([^)]*\)\s*)?([A-Za-z_$][\w$]*)/;
|
|
46
|
+
const ASSIGNED = /^\s*(?:export\s+)?([A-Za-z_$][\w$]*)\s*(?::[^=]+)?=(?![=>])/;
|
|
47
|
+
const blank = (line) => line.trim() === "";
|
|
48
|
+
const indent = (line) => /^\s*/.exec(line)[0].length;
|
|
49
|
+
/** The test name the block starting at `i` declares, its wrapped name included. */
|
|
50
|
+
function openerName(lines, i) {
|
|
51
|
+
const own = declaredName(lines[i]);
|
|
52
|
+
if (own !== null || !WRAPPED_CALL.test(lines[i]))
|
|
53
|
+
return own;
|
|
54
|
+
const next = lines.slice(i + 1).find((l) => !blank(l));
|
|
55
|
+
return next === undefined ? null : declaredName(`${lines[i].trimEnd()}${next.trim()}`);
|
|
56
|
+
}
|
|
57
|
+
/** 0-based last line of the block starting at `start`. */
|
|
58
|
+
function blockEnd(lines, start) {
|
|
59
|
+
const own = indent(lines[start]);
|
|
60
|
+
let end = start;
|
|
61
|
+
let i = start + 1;
|
|
62
|
+
for (;;) {
|
|
63
|
+
while (i < lines.length && (blank(lines[i]) || indent(lines[i]) > own)) {
|
|
64
|
+
if (!blank(lines[i]))
|
|
65
|
+
end = i;
|
|
66
|
+
i++;
|
|
67
|
+
}
|
|
68
|
+
if (i >= lines.length || indent(lines[i]) !== own || !CLOSER.test(lines[i]))
|
|
69
|
+
return end;
|
|
70
|
+
end = i++;
|
|
71
|
+
if (!REOPENS.test(lines[end]))
|
|
72
|
+
return end;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
/** The blocks enclosing line `t`, innermost first, as their start lines. */
|
|
76
|
+
function ancestors(lines, t) {
|
|
77
|
+
const out = [];
|
|
78
|
+
let cur = t;
|
|
79
|
+
for (let i = t - 1; i >= 0; i--) {
|
|
80
|
+
if (blank(lines[i]) || indent(lines[i]) >= indent(lines[cur]))
|
|
81
|
+
continue;
|
|
82
|
+
if (blockEnd(lines, i) < t)
|
|
83
|
+
continue;
|
|
84
|
+
out.push(i);
|
|
85
|
+
cur = i;
|
|
86
|
+
}
|
|
87
|
+
return out;
|
|
88
|
+
}
|
|
89
|
+
/** The start lines of the items directly inside the block at `scope` (-1: the whole file). */
|
|
90
|
+
function items(lines, scope) {
|
|
91
|
+
const own = scope === -1 ? -1 : indent(lines[scope]);
|
|
92
|
+
const last = scope === -1 ? lines.length - 1 : blockEnd(lines, scope);
|
|
93
|
+
const out = [];
|
|
94
|
+
for (let i = scope + 1; i <= last; i++) {
|
|
95
|
+
if (blank(lines[i]) || indent(lines[i]) <= own)
|
|
96
|
+
continue;
|
|
97
|
+
out.push(i);
|
|
98
|
+
i = blockEnd(lines, i);
|
|
99
|
+
}
|
|
100
|
+
return out;
|
|
101
|
+
}
|
|
102
|
+
/** The names a declaration or import line binds; empty for a hook, call or bare statement. */
|
|
103
|
+
function declaredNames(line) {
|
|
104
|
+
if (IMPORT.test(line))
|
|
105
|
+
return (line.replace(QUOTED, "").match(WORD) ?? []).filter((w) => !IMPORT_WORDS.has(w));
|
|
106
|
+
const name = DECLARED.exec(line)?.[1] ?? ASSIGNED.exec(line)?.[1];
|
|
107
|
+
return name === undefined ? [] : [name];
|
|
108
|
+
}
|
|
109
|
+
/** The 0-based start of the one block declaring `want`, or null when none or several do. */
|
|
110
|
+
function findTest(lines, want) {
|
|
111
|
+
const hits = [];
|
|
112
|
+
for (let i = 0; i < lines.length; i++) {
|
|
113
|
+
const name = openerName(lines, i);
|
|
114
|
+
if (name !== null && (name === want || want.endsWith(` ${name}`)))
|
|
115
|
+
hits.push({ at: i, name });
|
|
116
|
+
}
|
|
117
|
+
const exact = hits.filter((h) => h.name === want);
|
|
118
|
+
let pick = exact.length > 0 ? exact : hits;
|
|
119
|
+
if (pick.length > 1)
|
|
120
|
+
pick = pick.filter((h) => ancestors(lines, h.at).every((a) => {
|
|
121
|
+
const outer = openerName(lines, a);
|
|
122
|
+
return outer === null || want.includes(outer);
|
|
123
|
+
}));
|
|
124
|
+
return pick.length === 1 ? pick[0].at : null;
|
|
125
|
+
}
|
|
126
|
+
function sideOf(text, want) {
|
|
127
|
+
const lines = text.split(/\r?\n/);
|
|
128
|
+
const start = findTest(lines, want);
|
|
129
|
+
if (start === null)
|
|
130
|
+
return null;
|
|
131
|
+
const end = blockEnd(lines, start);
|
|
132
|
+
const scopes = ancestors(lines, start);
|
|
133
|
+
const words = (from, to) => lines
|
|
134
|
+
.slice(from, to + 1)
|
|
135
|
+
.join("\n")
|
|
136
|
+
.match(WORD) ?? [];
|
|
137
|
+
const reachable = new Set(words(start, end));
|
|
138
|
+
const around = new Map([...scopes, -1]
|
|
139
|
+
.flatMap((s) => items(lines, s))
|
|
140
|
+
.filter((i) => i !== start && !scopes.includes(i))
|
|
141
|
+
.map((i) => [
|
|
142
|
+
i,
|
|
143
|
+
{
|
|
144
|
+
end: blockEnd(lines, i),
|
|
145
|
+
runs: false,
|
|
146
|
+
test: openerName(lines, i) !== null,
|
|
147
|
+
names: declaredNames(lines[i]),
|
|
148
|
+
},
|
|
149
|
+
]));
|
|
150
|
+
// A hook or bare statement runs; a declaration runs once the test or code it runs names it.
|
|
151
|
+
for (let grew = true; grew;) {
|
|
152
|
+
grew = false;
|
|
153
|
+
for (const [i, item] of around) {
|
|
154
|
+
if (item.runs || item.test)
|
|
155
|
+
continue;
|
|
156
|
+
if (item.names.length > 0 && !item.names.some((n) => reachable.has(n)))
|
|
157
|
+
continue;
|
|
158
|
+
item.runs = true;
|
|
159
|
+
grew = true;
|
|
160
|
+
for (const w of words(i, item.end))
|
|
161
|
+
reachable.add(w);
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
return { lines, start, end, scopes, around };
|
|
165
|
+
}
|
|
166
|
+
/** A uniquely named test's source, enclosing declarations and reachable setup, or null if ambiguous. */
|
|
167
|
+
export function testSource(text, want) {
|
|
168
|
+
const side = sideOf(text, want);
|
|
169
|
+
if (side === null)
|
|
170
|
+
return null;
|
|
171
|
+
return [
|
|
172
|
+
...side.scopes.map((at) => side.lines[at]),
|
|
173
|
+
...[...side.around]
|
|
174
|
+
.filter(([, item]) => item.runs)
|
|
175
|
+
.flatMap(([at, item]) => side.lines.slice(at, item.end + 1)),
|
|
176
|
+
...side.lines.slice(side.start, side.end + 1),
|
|
177
|
+
];
|
|
178
|
+
}
|
|
179
|
+
/** The 1-based lines a `git diff -U0` removes from its old file and adds to its new one. */
|
|
180
|
+
export function diffLines(diff) {
|
|
181
|
+
const removed = [];
|
|
182
|
+
const added = [];
|
|
183
|
+
for (const m of diff.matchAll(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/gm)) {
|
|
184
|
+
const span = (at, n) => Array.from({ length: n === undefined ? 1 : Number(n) }, (_, k) => Number(at) + k);
|
|
185
|
+
removed.push(...span(m[1], m[2]));
|
|
186
|
+
added.push(...span(m[3], m[4]));
|
|
187
|
+
}
|
|
188
|
+
return { removed, added };
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* How the test `want` changed from `before` to `after`, given the 1-based lines a diff
|
|
192
|
+
* removes from `before` and adds to `after`. Null when either copy does not declare the
|
|
193
|
+
* test in exactly one block: the caller then judges the whole file.
|
|
194
|
+
*/
|
|
195
|
+
export function testChange(before, after, want, changed) {
|
|
196
|
+
const old = sideOf(before, want);
|
|
197
|
+
const now = sideOf(after, want);
|
|
198
|
+
if (old === null || now === null)
|
|
199
|
+
return null;
|
|
200
|
+
const body = (s) => {
|
|
201
|
+
const base = indent(s.lines[s.start]);
|
|
202
|
+
return s.lines
|
|
203
|
+
.slice(s.start, s.end + 1)
|
|
204
|
+
.filter((l) => !blank(l))
|
|
205
|
+
.map((l) => l.slice(Math.min(base, indent(l))).trimEnd())
|
|
206
|
+
.join("\n");
|
|
207
|
+
};
|
|
208
|
+
const runs = new Set();
|
|
209
|
+
const judge = (s, line) => {
|
|
210
|
+
const at = line - 1;
|
|
211
|
+
if (at < 0 || at >= s.lines.length || blank(s.lines[at]))
|
|
212
|
+
return;
|
|
213
|
+
if (at >= s.start && at <= s.end)
|
|
214
|
+
return;
|
|
215
|
+
for (const [i, item] of s.around)
|
|
216
|
+
if (at >= i && at <= item.end) {
|
|
217
|
+
if (item.runs)
|
|
218
|
+
runs.add(s.lines[i].trim());
|
|
219
|
+
return;
|
|
220
|
+
}
|
|
221
|
+
// In no item: a line of a block around the test itself (its opener, a closer).
|
|
222
|
+
const scope = s.scopes.find((a) => a <= at && at <= blockEnd(s.lines, a));
|
|
223
|
+
if (scope !== undefined)
|
|
224
|
+
runs.add(s.lines[scope].trim());
|
|
225
|
+
};
|
|
226
|
+
for (const line of changed.removed)
|
|
227
|
+
judge(old, line);
|
|
228
|
+
for (const line of changed.added)
|
|
229
|
+
judge(now, line);
|
|
230
|
+
return { body: body(old) !== body(now), runs: [...runs] };
|
|
231
|
+
}
|