@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,691 @@
|
|
|
1
|
+
// The one reader of a plan's (or a change-shape issue's) task section: groups and
|
|
2
|
+
// task blocks between lowercase HTML-comment markers, each task's uppercase fields.
|
|
3
|
+
//
|
|
4
|
+
// <!-- bkit:group N start -->
|
|
5
|
+
// ### TASK GROUP N: {title} (`### GROUP N: {title}` is read too)
|
|
6
|
+
// <!-- bkit:task M start -->
|
|
7
|
+
// - [ ] **TASK M:** {title}
|
|
8
|
+
// - **UPDATE:** `symbol` in `file`: what changes
|
|
9
|
+
// - **DONE WHEN:** ...
|
|
10
|
+
// - **TEST FIRST:**
|
|
11
|
+
// - `test file` `test name` fails on ...
|
|
12
|
+
// <!-- bkit:task M end -->
|
|
13
|
+
// <!-- bkit:group N end -->
|
|
14
|
+
//
|
|
15
|
+
// Pure text in, groups / tasks / line-numbered errors out; no file-system access, so
|
|
16
|
+
// `tests`, `challenge` and the run facts share it. Fenced code is skipped. Task-like
|
|
17
|
+
// text outside every task block is an error of kind `stray`, never silently unread.
|
|
18
|
+
|
|
19
|
+
import * as path from "node:path";
|
|
20
|
+
|
|
21
|
+
/** The task fields, written in uppercase as `**LABEL:**`. */
|
|
22
|
+
export const PLAN_FIELDS = [
|
|
23
|
+
"CREATE",
|
|
24
|
+
"READ",
|
|
25
|
+
"UPDATE",
|
|
26
|
+
"DELETE",
|
|
27
|
+
"DEPENDS ON",
|
|
28
|
+
"DONE WHEN",
|
|
29
|
+
"TEST FIRST",
|
|
30
|
+
"TEST EXCEPTION",
|
|
31
|
+
] as const;
|
|
32
|
+
export type PlanField = (typeof PLAN_FIELDS)[number];
|
|
33
|
+
|
|
34
|
+
/** Why every plan reader (`tests`, `tasks`, `ledgers triage`) refuses a plan with no task blocks. */
|
|
35
|
+
export const NO_MARKERS_REASON =
|
|
36
|
+
"this plan has no task markers; run /bkit-build again to convert it";
|
|
37
|
+
|
|
38
|
+
/** A CREATE / READ / UPDATE / DELETE line: `` `symbol` in `file`: what ``, or `` `file`: what ``. */
|
|
39
|
+
export interface PlanRef {
|
|
40
|
+
/** Absent on the file-only form. A Markdown section is `§ heading text`. */
|
|
41
|
+
symbol?: string;
|
|
42
|
+
file: string;
|
|
43
|
+
what: string;
|
|
44
|
+
/** 1-based plan line. */
|
|
45
|
+
line: number;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export interface PlanTest {
|
|
49
|
+
test: string;
|
|
50
|
+
name: string;
|
|
51
|
+
line: number;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export interface PlanTestFirst {
|
|
55
|
+
line: number;
|
|
56
|
+
/** The `n/a — {reason}` reason, when the task names no test. */
|
|
57
|
+
na?: string;
|
|
58
|
+
tests: PlanTest[];
|
|
59
|
+
/** 1-based lines of entries that are neither a test nor `n/a`. */
|
|
60
|
+
malformed: number[];
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** An owner-accepted missing red: the tests it covers and its 1-based plan lines. */
|
|
64
|
+
export interface PlanTestException {
|
|
65
|
+
tests: PlanTest[];
|
|
66
|
+
lines: number[];
|
|
67
|
+
/** The field's text, entries joined: the reason when the task names no test. */
|
|
68
|
+
text: string;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export interface PlanTaskBlock {
|
|
72
|
+
task: number;
|
|
73
|
+
group: number;
|
|
74
|
+
title: string;
|
|
75
|
+
/** The task's box is ticked `[x]`. */
|
|
76
|
+
done: boolean;
|
|
77
|
+
/** 1-based lines of its start and end markers. */
|
|
78
|
+
line: number;
|
|
79
|
+
end: number;
|
|
80
|
+
create: PlanRef[];
|
|
81
|
+
read: PlanRef[];
|
|
82
|
+
update: PlanRef[];
|
|
83
|
+
delete: PlanRef[];
|
|
84
|
+
dependsOn: number[];
|
|
85
|
+
doneWhen?: string;
|
|
86
|
+
testFirst?: PlanTestFirst;
|
|
87
|
+
testException?: PlanTestException;
|
|
88
|
+
/** The block's lines, markers included. */
|
|
89
|
+
text: string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface PlanGroup {
|
|
93
|
+
group: number;
|
|
94
|
+
title: string;
|
|
95
|
+
line: number;
|
|
96
|
+
end: number;
|
|
97
|
+
tasks: PlanTaskBlock[];
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export interface PlanBlockError {
|
|
101
|
+
line: number;
|
|
102
|
+
/** `format`: a malformed block; `stray`: task-like text outside every task block. */
|
|
103
|
+
kind: "format" | "stray";
|
|
104
|
+
message: string;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
export interface PlanBlocks {
|
|
108
|
+
groups: PlanGroup[];
|
|
109
|
+
tasks: PlanTaskBlock[];
|
|
110
|
+
errors: PlanBlockError[];
|
|
111
|
+
/** 1-based line of a code fence that never closes: nothing after it is read. */
|
|
112
|
+
fenceOpen?: number;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** One Reuse Inventory row: the line as written, its `File` cell's paths and its `Decision` cell. */
|
|
116
|
+
export interface InventoryRow {
|
|
117
|
+
line: string;
|
|
118
|
+
files: string[];
|
|
119
|
+
decision: string;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** The Reuse Inventory table: its header and separator lines, and its rows. */
|
|
123
|
+
export interface ReuseInventory {
|
|
124
|
+
head: string[];
|
|
125
|
+
rows: InventoryRow[];
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
const tableCells = (row: string) =>
|
|
129
|
+
row
|
|
130
|
+
.split("|")
|
|
131
|
+
.slice(1, -1)
|
|
132
|
+
.map((c) => c.trim());
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* The first table under the first heading matching `heading`, before the next heading of
|
|
136
|
+
* the same or a higher level: the header line's index and its cells. No heading or table → null.
|
|
137
|
+
*/
|
|
138
|
+
function firstTable(lines: string[], heading: RegExp): { head: number; cols: string[] } | null {
|
|
139
|
+
const start = lines.findIndex((l) => heading.test(l));
|
|
140
|
+
if (start < 0) return null;
|
|
141
|
+
const level = /^#+/.exec(lines[start]!)![0].length;
|
|
142
|
+
const ends = (l: string) => new RegExp(`^#{1,${level}} `).test(l);
|
|
143
|
+
let head = -1;
|
|
144
|
+
for (let i = start + 1; i < lines.length && !ends(lines[i]!); i++)
|
|
145
|
+
if (/^\s*\|/.test(lines[i]!)) {
|
|
146
|
+
head = i;
|
|
147
|
+
break;
|
|
148
|
+
}
|
|
149
|
+
if (head < 0) return null;
|
|
150
|
+
return { head, cols: tableCells(lines[head]!) };
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* The plan's Reuse Inventory: the first table under the first heading naming Reuse
|
|
155
|
+
* Inventory, before the next heading of the same or a higher level. Each row's `File`
|
|
156
|
+
* cell gives its backticked paths, normalised. No heading, table or `File` column → null.
|
|
157
|
+
*/
|
|
158
|
+
export function reuseInventory(text: string): ReuseInventory | null {
|
|
159
|
+
const lines = text.split(/\r?\n/);
|
|
160
|
+
const table = firstTable(lines, /^#{2,4} .*Reuse Inventory/i);
|
|
161
|
+
if (table === null) return null;
|
|
162
|
+
const file = table.cols.findIndex((c) => /^file\b/i.test(c));
|
|
163
|
+
const decision = table.cols.findIndex((c) => /^decision\b/i.test(c));
|
|
164
|
+
if (file < 0) return null;
|
|
165
|
+
const rows: InventoryRow[] = [];
|
|
166
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]!); i++) {
|
|
167
|
+
const cells = tableCells(lines[i]!);
|
|
168
|
+
rows.push({
|
|
169
|
+
line: lines[i]!,
|
|
170
|
+
files: [...(cells[file] ?? "").matchAll(/`([^`]+)`/g)].map((m) =>
|
|
171
|
+
path.posix.normalize(m[1]!),
|
|
172
|
+
),
|
|
173
|
+
decision: decision < 0 ? "" : (cells[decision] ?? ""),
|
|
174
|
+
});
|
|
175
|
+
}
|
|
176
|
+
return { head: lines.slice(table.head, table.head + 2), rows };
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** One `Derived Test Matrix` row: its cells, its line, and the tasks its `Task` cell names. */
|
|
180
|
+
export interface MatrixRow {
|
|
181
|
+
/** The row as written. */
|
|
182
|
+
line: string;
|
|
183
|
+
/** 1-based plan line. */
|
|
184
|
+
number: number;
|
|
185
|
+
/** The row's cells, in header order. */
|
|
186
|
+
cells: string[];
|
|
187
|
+
/** The task numbers its `Task` cell names. */
|
|
188
|
+
tasks: number[];
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** The plan's `Derived Test Matrix` table: its header, the `Task` column and its rows. */
|
|
192
|
+
export interface DerivedTestMatrix {
|
|
193
|
+
/** The header and separator lines. */
|
|
194
|
+
head: string[];
|
|
195
|
+
/** 1-based line of the header row. */
|
|
196
|
+
line: number;
|
|
197
|
+
/** The `Task` column's index; null when the header carries none. */
|
|
198
|
+
taskColumn: number | null;
|
|
199
|
+
rows: MatrixRow[];
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** One `Supersession Inventory` row: its line and the backticked paths it names. */
|
|
203
|
+
export interface SupersessionRow {
|
|
204
|
+
/** The row as written. */
|
|
205
|
+
line: string;
|
|
206
|
+
/** 1-based plan line. */
|
|
207
|
+
number: number;
|
|
208
|
+
/** The row's backticked paths, normalised. */
|
|
209
|
+
files: string[];
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** The plan's `Derived Test Matrix` over `tableCells`; null when the plan has no such table. */
|
|
213
|
+
export function derivedTestMatrix(text: string): DerivedTestMatrix | null {
|
|
214
|
+
const lines = text.split(/\r?\n/);
|
|
215
|
+
const table = firstTable(lines, /^#{2,4} .*Derived Test Matrix/i);
|
|
216
|
+
if (table === null) return null;
|
|
217
|
+
const column = table.cols.findIndex((c) => /^task\b/i.test(c));
|
|
218
|
+
const rows: MatrixRow[] = [];
|
|
219
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]!); i++) {
|
|
220
|
+
const cells = tableCells(lines[i]!);
|
|
221
|
+
rows.push({
|
|
222
|
+
line: lines[i]!,
|
|
223
|
+
number: i + 1,
|
|
224
|
+
cells,
|
|
225
|
+
tasks: column < 0 ? [] : [...(cells[column] ?? "").matchAll(/\d+/g)].map((m) => Number(m[0])),
|
|
226
|
+
});
|
|
227
|
+
}
|
|
228
|
+
return {
|
|
229
|
+
head: lines.slice(table.head, table.head + 2),
|
|
230
|
+
line: table.head + 1,
|
|
231
|
+
taskColumn: column < 0 ? null : column,
|
|
232
|
+
rows,
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
/** The plan's `Supersession Inventory` rows over `tableCells`; null when the plan has no such table. */
|
|
237
|
+
export function supersessionInventory(text: string): SupersessionRow[] | null {
|
|
238
|
+
const lines = text.split(/\r?\n/);
|
|
239
|
+
const table = firstTable(lines, /^#{2,4} .*Supersession Inventory/i);
|
|
240
|
+
if (table === null) return null;
|
|
241
|
+
const column = table.cols.findIndex((c) => /^existing\b/i.test(c));
|
|
242
|
+
const rows: SupersessionRow[] = [];
|
|
243
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]!); i++) {
|
|
244
|
+
const cells = tableCells(lines[i]!);
|
|
245
|
+
rows.push({
|
|
246
|
+
line: lines[i]!,
|
|
247
|
+
number: i + 1,
|
|
248
|
+
files: spansOf(cells[column < 0 ? 0 : column] ?? "").map((f) => path.posix.normalize(f)),
|
|
249
|
+
});
|
|
250
|
+
}
|
|
251
|
+
return rows;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/** One `Out of Scope` row: the line as written, its 1-based line, and its cells. */
|
|
255
|
+
export interface OutOfScopeRow {
|
|
256
|
+
/** The row as written. */
|
|
257
|
+
line: string;
|
|
258
|
+
/** 1-based plan line. */
|
|
259
|
+
number: number;
|
|
260
|
+
/** The row's cells, in header order. */
|
|
261
|
+
cells: string[];
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
/** The plan's `Out of Scope` rows over `tableCells`; null when the plan has no such table. */
|
|
265
|
+
export function outOfScope(text: string): OutOfScopeRow[] | null {
|
|
266
|
+
const lines = text.split(/\r?\n/);
|
|
267
|
+
const table = firstTable(lines, /^#{2,4} .*Out of Scope/i);
|
|
268
|
+
if (table === null) return null;
|
|
269
|
+
const rows: OutOfScopeRow[] = [];
|
|
270
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]!); i++)
|
|
271
|
+
rows.push({ line: lines[i]!, number: i + 1, cells: tableCells(lines[i]!) });
|
|
272
|
+
return rows;
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
/** The error for a code fence opened at `line` and never closed. */
|
|
276
|
+
export const fenceNeverClosed = (line: number) =>
|
|
277
|
+
`the code fence at line ${line} is never closed; nothing after it is read`;
|
|
278
|
+
|
|
279
|
+
/** The fields a task writes at most once; CREATE / READ / UPDATE / DELETE repeat, one line per ref. */
|
|
280
|
+
const SINGLE_FIELDS: ReadonlySet<PlanField> = new Set([
|
|
281
|
+
"DEPENDS ON",
|
|
282
|
+
"DONE WHEN",
|
|
283
|
+
"TEST FIRST",
|
|
284
|
+
"TEST EXCEPTION",
|
|
285
|
+
]);
|
|
286
|
+
|
|
287
|
+
const MARKER = /^\s*<!--\s*bkit:(group|task)\s+(\d+)\s+(start|end)\s*-->\s*$/;
|
|
288
|
+
const GROUP_HEAD = /^###\s+(?:TASK\s+)?GROUP\s+(\d+):\s*(.*)$/;
|
|
289
|
+
const TASK_HEAD = /^\s*- \[([ xX])\] \*\*TASK (\d+):\*\*\s*(.*)$/;
|
|
290
|
+
const LABEL_LINE = /^(\s*)(?:- )?\*\*([A-Za-z][A-Za-z -]*?):\*\*\s*(.*)$/;
|
|
291
|
+
const SUB_BULLET = /^(\s*)- (.*)$/;
|
|
292
|
+
const FENCE = /^\s*(`{3,}|~{3,})/;
|
|
293
|
+
const FENCE_CLOSE = /^\s*(`{3,}|~{3,})\s*$/;
|
|
294
|
+
const STRAY_TASK = /\*\*\s*task\s+\d+/i;
|
|
295
|
+
/** A bold `**TASK N:**` inside a task block other than its own task line. */
|
|
296
|
+
const INNER_TASK = /(?<!\S)\*\*task\s+\d+\s*:?\s*\*\*/i;
|
|
297
|
+
const STRAY_FIELD = new RegExp(
|
|
298
|
+
String.raw`\*\*\s*(${[...PLAN_FIELDS, "TEST-ORDER EXCEPTION"].join("|")})\s*(?::\*\*|\*\*\s*:)`,
|
|
299
|
+
"i",
|
|
300
|
+
);
|
|
301
|
+
|
|
302
|
+
/** `text` with inline code spans removed: prose naming a label is not the label. */
|
|
303
|
+
const withoutCode = (text: string) => text.replace(/(`+)[\s\S]*?\1/g, "");
|
|
304
|
+
|
|
305
|
+
const spansOf = (text: string) => [...text.matchAll(/`([^`]+)`/g)].map((m) => m[1]!.trim());
|
|
306
|
+
|
|
307
|
+
/** A CREATE / READ / UPDATE / DELETE value, or null when it is none of the forms. */
|
|
308
|
+
export function parseRef(value: string, line: number): PlanRef | null {
|
|
309
|
+
const v = value.trim();
|
|
310
|
+
const sym = /^`([^`]+)`\s+in\s+`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
|
|
311
|
+
if (sym)
|
|
312
|
+
return { symbol: sym[1]!.trim(), file: sym[2]!.trim(), what: (sym[3] ?? "").trim(), line };
|
|
313
|
+
const section = /^(§[^`]*?)\s+in\s+`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
|
|
314
|
+
if (section)
|
|
315
|
+
return {
|
|
316
|
+
symbol: section[1]!.trim(),
|
|
317
|
+
file: section[2]!.trim(),
|
|
318
|
+
what: (section[3] ?? "").trim(),
|
|
319
|
+
line,
|
|
320
|
+
};
|
|
321
|
+
const file = /^`([^`]+)`\s*(?::\s*([\s\S]*))?$/.exec(v);
|
|
322
|
+
if (file) return { file: file[1]!.trim(), what: (file[2] ?? "").trim(), line };
|
|
323
|
+
return null;
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
interface FieldEntry {
|
|
327
|
+
label: PlanField;
|
|
328
|
+
line: number;
|
|
329
|
+
value: string;
|
|
330
|
+
indent: number;
|
|
331
|
+
items: Array<{ line: number; text: string }>;
|
|
332
|
+
last: number;
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
const testOf = (text: string, line: number): PlanTest | null => {
|
|
336
|
+
const spans = spansOf(text);
|
|
337
|
+
return spans.length >= 2
|
|
338
|
+
? { test: path.posix.normalize(spans[0]!), name: spans[1]!, line }
|
|
339
|
+
: null;
|
|
340
|
+
};
|
|
341
|
+
|
|
342
|
+
/** One task's fields from its entries; format errors are pushed to `errors`. */
|
|
343
|
+
function taskFromFields(
|
|
344
|
+
head: { task: number; group: number; title: string; done: boolean; line: number; end: number },
|
|
345
|
+
fields: FieldEntry[],
|
|
346
|
+
text: string,
|
|
347
|
+
errors: PlanBlockError[],
|
|
348
|
+
): PlanTaskBlock {
|
|
349
|
+
const t: PlanTaskBlock = {
|
|
350
|
+
...head,
|
|
351
|
+
create: [],
|
|
352
|
+
read: [],
|
|
353
|
+
update: [],
|
|
354
|
+
delete: [],
|
|
355
|
+
dependsOn: [],
|
|
356
|
+
text,
|
|
357
|
+
};
|
|
358
|
+
const refs: Record<string, PlanRef[]> = {
|
|
359
|
+
CREATE: t.create,
|
|
360
|
+
READ: t.read,
|
|
361
|
+
UPDATE: t.update,
|
|
362
|
+
DELETE: t.delete,
|
|
363
|
+
};
|
|
364
|
+
for (const f of fields) {
|
|
365
|
+
const entries = [
|
|
366
|
+
...(f.value.trim() === "" ? [] : [{ line: f.line, text: f.value }]),
|
|
367
|
+
...f.items,
|
|
368
|
+
];
|
|
369
|
+
if (f.label in refs) {
|
|
370
|
+
if (entries.length === 0)
|
|
371
|
+
errors.push({
|
|
372
|
+
line: f.line,
|
|
373
|
+
kind: "format",
|
|
374
|
+
message: `TASK ${t.task}: ${f.label} is empty`,
|
|
375
|
+
});
|
|
376
|
+
for (const e of entries) {
|
|
377
|
+
const ref = parseRef(e.text, e.line);
|
|
378
|
+
if (ref === null)
|
|
379
|
+
errors.push({
|
|
380
|
+
line: e.line,
|
|
381
|
+
kind: "format",
|
|
382
|
+
message: `TASK ${t.task}: ${f.label} is neither \`symbol\` in \`file\`: what nor \`file\`: what`,
|
|
383
|
+
});
|
|
384
|
+
else refs[f.label]!.push(ref);
|
|
385
|
+
}
|
|
386
|
+
} else if (f.label === "DEPENDS ON") {
|
|
387
|
+
// `TASK N` names when the entry has them, else bare numbers as the template writes them;
|
|
388
|
+
// an entry starting `none` names no task, whatever follows it. `GROUP N` numbers name
|
|
389
|
+
// groups, never tasks.
|
|
390
|
+
for (const e of entries) {
|
|
391
|
+
if (/^none\b/i.test(e.text.trim())) continue;
|
|
392
|
+
const text = e.text.replace(/\bGROUPS?\s+\d+(?:\s*(?:,|&|-|–|and)\s*\d+)*/gi, "");
|
|
393
|
+
const named = [...text.matchAll(/TASK\s+(\d+)/gi)];
|
|
394
|
+
const nums = named.length > 0 ? named : [...text.matchAll(/\b(\d+)\b/g)];
|
|
395
|
+
for (const m of nums) t.dependsOn.push(Number(m[1]));
|
|
396
|
+
}
|
|
397
|
+
} else if (f.label === "DONE WHEN") {
|
|
398
|
+
t.doneWhen = entries.map((e) => e.text.trim()).join(" ");
|
|
399
|
+
} else if (f.label === "TEST FIRST") {
|
|
400
|
+
const tf: PlanTestFirst = { line: f.line, tests: [], malformed: [] };
|
|
401
|
+
for (const e of entries) {
|
|
402
|
+
if (/^n\/a\b/i.test(e.text.trim())) {
|
|
403
|
+
tf.na = e.text.trim().replace(/^n\/a\s*[—–-]?\s*/i, "");
|
|
404
|
+
continue;
|
|
405
|
+
}
|
|
406
|
+
const test = testOf(e.text, e.line);
|
|
407
|
+
if (test === null) tf.malformed.push(e.line);
|
|
408
|
+
else tf.tests.push(test);
|
|
409
|
+
}
|
|
410
|
+
t.testFirst = tf;
|
|
411
|
+
} else {
|
|
412
|
+
const tests = entries.map((e) => testOf(e.text, e.line)).filter((x) => x !== null);
|
|
413
|
+
const lines = Array.from({ length: f.last - f.line + 1 }, (_, k) => f.line + k);
|
|
414
|
+
t.testException = { tests, lines, text: entries.map((e) => e.text.trim()).join(" ") };
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
return t;
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
/** Groups, tasks and errors of a plan's (or issue's) task section. */
|
|
421
|
+
export function parsePlanBlocks(text: string): PlanBlocks {
|
|
422
|
+
const lines = text.split(/\r?\n/);
|
|
423
|
+
const errors: PlanBlockError[] = [];
|
|
424
|
+
const groups: PlanGroup[] = [];
|
|
425
|
+
const tasks: PlanTaskBlock[] = [];
|
|
426
|
+
const groupSeen = new Map<number, number>();
|
|
427
|
+
const taskSeen = new Map<number, number>();
|
|
428
|
+
const err = (line: number, message: string) => errors.push({ line, kind: "format", message });
|
|
429
|
+
/**
|
|
430
|
+
* Group numbers ascend through the file: the build runs groups in file order. Task numbers
|
|
431
|
+
* ascend within a group, so a Decision Pause task numbered above the plan's highest can join
|
|
432
|
+
* the paused group.
|
|
433
|
+
*/
|
|
434
|
+
let lastGroup = 0;
|
|
435
|
+
let lastTask = 0;
|
|
436
|
+
const numbered = (kind: "GROUP" | "TASK", no: number, last: number, n: number) => {
|
|
437
|
+
if (no === 0) err(n, `${kind} 0: ${kind.toLowerCase()} numbers start at 1`);
|
|
438
|
+
else if (no <= last)
|
|
439
|
+
err(
|
|
440
|
+
n,
|
|
441
|
+
`${kind} ${no} comes after ${kind} ${last}; number ${kind.toLowerCase()}s in ascending order`,
|
|
442
|
+
);
|
|
443
|
+
};
|
|
444
|
+
|
|
445
|
+
let fence: string | null = null;
|
|
446
|
+
let fenceLine = 0;
|
|
447
|
+
let group: PlanGroup | null = null;
|
|
448
|
+
let task: {
|
|
449
|
+
task: number;
|
|
450
|
+
line: number;
|
|
451
|
+
head: RegExpExecArray | null;
|
|
452
|
+
fields: FieldEntry[];
|
|
453
|
+
/** The field later lines continue; null after a line that is no field. */
|
|
454
|
+
current: FieldEntry | null;
|
|
455
|
+
counted: boolean;
|
|
456
|
+
} | null = null;
|
|
457
|
+
/** The marker whose next non-blank line must be its heading. */
|
|
458
|
+
let expect: { kind: "group" | "task"; n: number; line: number } | null = null;
|
|
459
|
+
|
|
460
|
+
const closeTask = (end: number) => {
|
|
461
|
+
const open = task!;
|
|
462
|
+
task = null;
|
|
463
|
+
if (!open.counted) return;
|
|
464
|
+
const block = taskFromFields(
|
|
465
|
+
{
|
|
466
|
+
task: open.task,
|
|
467
|
+
group: group?.group ?? 0,
|
|
468
|
+
title: (open.head?.[3] ?? "").trim(),
|
|
469
|
+
done: open.head !== null && open.head[1] !== " ",
|
|
470
|
+
line: open.line,
|
|
471
|
+
end,
|
|
472
|
+
},
|
|
473
|
+
open.fields,
|
|
474
|
+
lines.slice(open.line - 1, end).join("\n"),
|
|
475
|
+
errors,
|
|
476
|
+
);
|
|
477
|
+
tasks.push(block);
|
|
478
|
+
group?.tasks.push(block);
|
|
479
|
+
};
|
|
480
|
+
|
|
481
|
+
for (const [i, raw] of lines.entries()) {
|
|
482
|
+
const n = i + 1;
|
|
483
|
+
const fenceMark = FENCE.exec(raw)?.[1];
|
|
484
|
+
// A closing fence carries no info string: only the fence characters and spaces.
|
|
485
|
+
const closes = fence !== null && fenceMark?.startsWith(fence) === true && FENCE_CLOSE.test(raw);
|
|
486
|
+
if (fenceMark !== undefined && (fence === null || closes)) {
|
|
487
|
+
fence = fence === null ? fenceMark : null;
|
|
488
|
+
fenceLine = n;
|
|
489
|
+
continue;
|
|
490
|
+
}
|
|
491
|
+
if (fence !== null) continue;
|
|
492
|
+
|
|
493
|
+
if (expect !== null && raw.trim() !== "") {
|
|
494
|
+
const want = expect;
|
|
495
|
+
expect = null;
|
|
496
|
+
if (want.kind === "group") {
|
|
497
|
+
const h = GROUP_HEAD.exec(raw);
|
|
498
|
+
if (h === null)
|
|
499
|
+
err(
|
|
500
|
+
n,
|
|
501
|
+
`GROUP ${want.n} (line ${want.line}) is not followed by \`### TASK GROUP ${want.n}: {title}\``,
|
|
502
|
+
);
|
|
503
|
+
else if (Number(h[1]) !== want.n)
|
|
504
|
+
err(
|
|
505
|
+
n,
|
|
506
|
+
`heading says GROUP ${h[1]}, its marker at line ${want.line} says GROUP ${want.n}`,
|
|
507
|
+
);
|
|
508
|
+
else if (group !== null) group.title = h[2]!.trim();
|
|
509
|
+
if (h !== null) continue;
|
|
510
|
+
} else {
|
|
511
|
+
const h = TASK_HEAD.exec(raw);
|
|
512
|
+
if (h === null)
|
|
513
|
+
err(
|
|
514
|
+
n,
|
|
515
|
+
`TASK ${want.n} (line ${want.line}) is not followed by \`- [ ] **TASK ${want.n}:** {title}\``,
|
|
516
|
+
);
|
|
517
|
+
else if (Number(h[2]) !== want.n)
|
|
518
|
+
err(
|
|
519
|
+
n,
|
|
520
|
+
`task line says TASK ${h[2]}, its marker at line ${want.line} says TASK ${want.n}`,
|
|
521
|
+
);
|
|
522
|
+
else if (task !== null) task.head = h;
|
|
523
|
+
if (h !== null) continue;
|
|
524
|
+
}
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
const marker = MARKER.exec(raw);
|
|
528
|
+
if (marker) {
|
|
529
|
+
const kind = marker[1] === "group" ? "group" : "task";
|
|
530
|
+
const edge = marker[3];
|
|
531
|
+
const no = Number(marker[2]);
|
|
532
|
+
if (kind === "group" && edge === "start") {
|
|
533
|
+
if (task !== null) {
|
|
534
|
+
err(n, `GROUP ${no} starts inside TASK ${task.task} (line ${task.line})`);
|
|
535
|
+
closeTask(n - 1);
|
|
536
|
+
}
|
|
537
|
+
if (group !== null)
|
|
538
|
+
err(n, `GROUP ${no} starts inside GROUP ${group.group} (line ${group.line})`);
|
|
539
|
+
if (groupSeen.has(no)) err(n, `GROUP ${no} is already used at line ${groupSeen.get(no)}`);
|
|
540
|
+
else {
|
|
541
|
+
groupSeen.set(no, n);
|
|
542
|
+
numbered("GROUP", no, lastGroup, n);
|
|
543
|
+
lastGroup = no;
|
|
544
|
+
}
|
|
545
|
+
lastTask = 0;
|
|
546
|
+
group = { group: no, title: "", line: n, end: n, tasks: [] };
|
|
547
|
+
groups.push(group);
|
|
548
|
+
expect = { kind, n: no, line: n };
|
|
549
|
+
} else if (kind === "task" && edge === "start") {
|
|
550
|
+
if (task !== null) {
|
|
551
|
+
err(n, `TASK ${no} starts inside TASK ${task.task} (line ${task.line})`);
|
|
552
|
+
closeTask(n - 1);
|
|
553
|
+
}
|
|
554
|
+
if (group === null)
|
|
555
|
+
err(n, `TASK ${no} starts outside a group: wrap it in \`<!-- bkit:group N start -->\``);
|
|
556
|
+
const dup = taskSeen.has(no);
|
|
557
|
+
if (dup)
|
|
558
|
+
err(
|
|
559
|
+
n,
|
|
560
|
+
`TASK ${no} is already used at line ${taskSeen.get(no)}; task numbers are unique in the plan`,
|
|
561
|
+
);
|
|
562
|
+
else {
|
|
563
|
+
taskSeen.set(no, n);
|
|
564
|
+
numbered("TASK", no, lastTask, n);
|
|
565
|
+
lastTask = no;
|
|
566
|
+
}
|
|
567
|
+
task = {
|
|
568
|
+
task: no,
|
|
569
|
+
line: n,
|
|
570
|
+
head: null,
|
|
571
|
+
fields: [],
|
|
572
|
+
current: null,
|
|
573
|
+
counted: group !== null && !dup,
|
|
574
|
+
};
|
|
575
|
+
expect = { kind, n: no, line: n };
|
|
576
|
+
} else if (kind === "task") {
|
|
577
|
+
if (task === null) err(n, `\`<!-- bkit:task ${no} end -->\` has no open TASK ${no}`);
|
|
578
|
+
else {
|
|
579
|
+
if (task.task !== no)
|
|
580
|
+
err(
|
|
581
|
+
n,
|
|
582
|
+
`\`<!-- bkit:task ${no} end -->\` closes TASK ${task.task}, opened at line ${task.line}`,
|
|
583
|
+
);
|
|
584
|
+
closeTask(n);
|
|
585
|
+
}
|
|
586
|
+
} else {
|
|
587
|
+
if (task !== null) {
|
|
588
|
+
err(n, `GROUP ${no} ends inside TASK ${task.task} (line ${task.line})`);
|
|
589
|
+
closeTask(n - 1);
|
|
590
|
+
}
|
|
591
|
+
if (group === null) err(n, `\`<!-- bkit:group ${no} end -->\` has no open GROUP ${no}`);
|
|
592
|
+
else {
|
|
593
|
+
if (group.group !== no)
|
|
594
|
+
err(
|
|
595
|
+
n,
|
|
596
|
+
`\`<!-- bkit:group ${no} end -->\` closes GROUP ${group.group}, opened at line ${group.line}`,
|
|
597
|
+
);
|
|
598
|
+
group.end = n;
|
|
599
|
+
group = null;
|
|
600
|
+
}
|
|
601
|
+
}
|
|
602
|
+
continue;
|
|
603
|
+
}
|
|
604
|
+
|
|
605
|
+
if (task !== null) {
|
|
606
|
+
if (INNER_TASK.test(withoutCode(raw))) {
|
|
607
|
+
err(
|
|
608
|
+
n,
|
|
609
|
+
`TASK ${task.task}: a second task line inside its block; give that task its own \`<!-- bkit:task N start -->\` block`,
|
|
610
|
+
);
|
|
611
|
+
task.current = null;
|
|
612
|
+
continue;
|
|
613
|
+
}
|
|
614
|
+
const label = LABEL_LINE.exec(raw);
|
|
615
|
+
if (label) {
|
|
616
|
+
const name = label[2]!.trim();
|
|
617
|
+
const known = PLAN_FIELDS.find((f) => f === name);
|
|
618
|
+
const first = task.fields.find((f) => f.label === known);
|
|
619
|
+
if (known !== undefined && SINGLE_FIELDS.has(known) && first !== undefined) {
|
|
620
|
+
err(
|
|
621
|
+
n,
|
|
622
|
+
`TASK ${task.task}: **${known}:** is written twice (first at line ${first.line}); write each field once`,
|
|
623
|
+
);
|
|
624
|
+
task.current = null;
|
|
625
|
+
continue;
|
|
626
|
+
}
|
|
627
|
+
if (known !== undefined) {
|
|
628
|
+
task.current = {
|
|
629
|
+
label: known,
|
|
630
|
+
line: n,
|
|
631
|
+
value: label[3]!,
|
|
632
|
+
indent: label[1]!.length,
|
|
633
|
+
items: [],
|
|
634
|
+
last: n,
|
|
635
|
+
};
|
|
636
|
+
task.fields.push(task.current);
|
|
637
|
+
continue;
|
|
638
|
+
}
|
|
639
|
+
if (PLAN_FIELDS.some((f) => f === name.toUpperCase()))
|
|
640
|
+
err(n, `TASK ${task.task}: write the label in uppercase: **${name.toUpperCase()}:**`);
|
|
641
|
+
else if (/^[A-Z][A-Z -]*$/.test(name))
|
|
642
|
+
err(
|
|
643
|
+
n,
|
|
644
|
+
`TASK ${task.task}: unknown label **${name}:** (fields: ${PLAN_FIELDS.join(", ")})`,
|
|
645
|
+
);
|
|
646
|
+
task.current = null;
|
|
647
|
+
continue;
|
|
648
|
+
}
|
|
649
|
+
const field = task.current;
|
|
650
|
+
if (field === null || raw.trim() === "") continue;
|
|
651
|
+
const bullet = SUB_BULLET.exec(raw);
|
|
652
|
+
if (bullet && bullet[1]!.length <= field.indent) task.current = null;
|
|
653
|
+
else {
|
|
654
|
+
if (bullet) field.items.push({ line: n, text: bullet[2]! });
|
|
655
|
+
else if (field.items.length > 0) field.items.at(-1)!.text += ` ${raw.trim()}`;
|
|
656
|
+
else field.value += ` ${raw.trim()}`;
|
|
657
|
+
field.last = n;
|
|
658
|
+
}
|
|
659
|
+
continue;
|
|
660
|
+
}
|
|
661
|
+
|
|
662
|
+
if (raw.trim() === "") continue;
|
|
663
|
+
const prose = withoutCode(raw);
|
|
664
|
+
if (STRAY_TASK.test(prose) || STRAY_FIELD.test(prose))
|
|
665
|
+
errors.push({
|
|
666
|
+
line: n,
|
|
667
|
+
kind: "stray",
|
|
668
|
+
message: `task-like text outside every task block: ${raw.trim()}`,
|
|
669
|
+
});
|
|
670
|
+
}
|
|
671
|
+
|
|
672
|
+
if (fence !== null) err(fenceLine, fenceNeverClosed(fenceLine));
|
|
673
|
+
if (task !== null) {
|
|
674
|
+
const open = task as { task: number; line: number };
|
|
675
|
+
err(open.line, `TASK ${open.task} has no \`<!-- bkit:task ${open.task} end -->\``);
|
|
676
|
+
closeTask(lines.length);
|
|
677
|
+
}
|
|
678
|
+
if (group !== null) {
|
|
679
|
+
const open = group as PlanGroup;
|
|
680
|
+
err(open.line, `GROUP ${open.group} has no \`<!-- bkit:group ${open.group} end -->\``);
|
|
681
|
+
open.end = lines.length;
|
|
682
|
+
}
|
|
683
|
+
if (expect !== null) {
|
|
684
|
+
const want = expect as { kind: string; n: number; line: number };
|
|
685
|
+
err(want.line, `${want.kind.toUpperCase()} ${want.n} has no heading line`);
|
|
686
|
+
}
|
|
687
|
+
errors.sort((a, b) => a.line - b.line);
|
|
688
|
+
return fence === null
|
|
689
|
+
? { groups, tasks, errors }
|
|
690
|
+
: { groups, tasks, errors, fenceOpen: fenceLine };
|
|
691
|
+
}
|