@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
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// checks/before/context-fetch.ts — the context-fetch blocks in `.agents/context.md`: present,
|
|
2
|
-
// covering each context, sources enabled, provision blocks in place.
|
|
2
|
+
// covering each context, sources enabled, provision blocks in place, output bounded.
|
|
3
3
|
import * as fs from "node:fs";
|
|
4
4
|
import * as path from "node:path";
|
|
5
5
|
import { getTemplatesRoot } from "../../shared/package-roots.js";
|
|
@@ -82,6 +82,176 @@ function parseContextFetchStarts(section) {
|
|
|
82
82
|
}
|
|
83
83
|
return out;
|
|
84
84
|
}
|
|
85
|
+
/**
|
|
86
|
+
* Parse a consumer section into its `context-fetch` blocks, each with its fenced body. Only
|
|
87
|
+
* NAMED start blocks can be matched to a provision sibling (keyed by name), so an unnamed
|
|
88
|
+
* block is parked under `""`. The `bkit context` runner (commands/workflow/context.ts) and
|
|
89
|
+
* these advisories read the same markers.
|
|
90
|
+
*/
|
|
91
|
+
function parseContextFetchBlocks(consumer) {
|
|
92
|
+
const blocks = [];
|
|
93
|
+
let cur = null;
|
|
94
|
+
let inFence = false;
|
|
95
|
+
for (const line of consumer.split("\n")) {
|
|
96
|
+
const startM = parseContextFetchStart(line);
|
|
97
|
+
const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
|
|
98
|
+
if (startM) {
|
|
99
|
+
cur = { kind: "start", name: startM.name, context: startM.context, body: [] };
|
|
100
|
+
inFence = false;
|
|
101
|
+
blocks.push(cur);
|
|
102
|
+
continue;
|
|
103
|
+
}
|
|
104
|
+
if (provM) {
|
|
105
|
+
cur = { kind: "provision", name: provM[1], context: "", body: [] };
|
|
106
|
+
inFence = false;
|
|
107
|
+
blocks.push(cur);
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
|
|
111
|
+
cur = null;
|
|
112
|
+
inFence = false;
|
|
113
|
+
continue;
|
|
114
|
+
}
|
|
115
|
+
if (cur && /^```/.test(line)) {
|
|
116
|
+
inFence = !inFence;
|
|
117
|
+
continue;
|
|
118
|
+
}
|
|
119
|
+
if (cur && inFence)
|
|
120
|
+
cur.body.push(line);
|
|
121
|
+
}
|
|
122
|
+
return blocks;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Drop shell comments from a block body before matching bound markers, so a bound named
|
|
126
|
+
* only in the block's mandated `# Customise:` comment never makes an unbounded block look
|
|
127
|
+
* bounded. A full-line comment is always a comment; a `#` at the start of a word outside
|
|
128
|
+
* quotes begins one too (the shell rule), including straight after a control operator
|
|
129
|
+
* (`;`, `|`, `&`, `(`, `)`). A `#` inside quotes (a `jq` regex, a banner) is data and
|
|
130
|
+
* stays, or `printf "===== # ====="` would read as a comment and truncate the line. Quote
|
|
131
|
+
* state persists across lines because a quoted `jq` program may span several. A heredoc
|
|
132
|
+
* body (`<<WORD`, `<<'WORD'`, `<<-WORD` up to the line holding only `WORD`) is data: it is
|
|
133
|
+
* kept whole and its quotes and `#` change nothing, so an apostrophe in it never leaves
|
|
134
|
+
* the lines after its terminator read as quoted. A `<<<` here-string opens no body.
|
|
135
|
+
*/
|
|
136
|
+
function stripShellComments(text) {
|
|
137
|
+
const out = [];
|
|
138
|
+
let quote = null;
|
|
139
|
+
let escaped = false;
|
|
140
|
+
// Terminators of the heredocs opened so far, in the order their bodies follow.
|
|
141
|
+
const heredocs = [];
|
|
142
|
+
for (const line of text.split("\n")) {
|
|
143
|
+
const open = heredocs[0];
|
|
144
|
+
if (open) {
|
|
145
|
+
out.push(line);
|
|
146
|
+
if ((open.tabs ? line.replace(/^\t+/, "") : line) === open.word)
|
|
147
|
+
heredocs.shift();
|
|
148
|
+
continue;
|
|
149
|
+
}
|
|
150
|
+
let end = line.length;
|
|
151
|
+
for (let i = 0; i < line.length; i++) {
|
|
152
|
+
const ch = line[i];
|
|
153
|
+
if (quote === "'") {
|
|
154
|
+
if (ch === "'")
|
|
155
|
+
quote = null;
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
158
|
+
if (quote === '"') {
|
|
159
|
+
if (escaped)
|
|
160
|
+
escaped = false;
|
|
161
|
+
else if (ch === "\\")
|
|
162
|
+
escaped = true;
|
|
163
|
+
else if (ch === '"')
|
|
164
|
+
quote = null;
|
|
165
|
+
continue;
|
|
166
|
+
}
|
|
167
|
+
if (ch === "\\") {
|
|
168
|
+
i++;
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
if (ch === "'" || ch === '"') {
|
|
172
|
+
quote = ch;
|
|
173
|
+
continue;
|
|
174
|
+
}
|
|
175
|
+
if (ch === "<" && line[i + 1] === "<") {
|
|
176
|
+
if (line[i + 2] === "<") {
|
|
177
|
+
i += 2; // `<<<` here-string
|
|
178
|
+
continue;
|
|
179
|
+
}
|
|
180
|
+
const heredoc = /^<<(-?)[ \t]*\\?(["']?)([A-Za-z_]\w*)\2/.exec(line.slice(i));
|
|
181
|
+
if (heredoc)
|
|
182
|
+
heredocs.push({ word: heredoc[3], tabs: heredoc[1] === "-" });
|
|
183
|
+
i += heredoc ? heredoc[0].length - 1 : 1;
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
if (ch === "#" && (i === 0 || /[\s;|&()]/.test(line[i - 1]))) {
|
|
187
|
+
end = i;
|
|
188
|
+
break;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
out.push(line.slice(0, end));
|
|
192
|
+
}
|
|
193
|
+
return out.join("\n");
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Markers proving a `context-fetch` block bounds its own stdout at the source, matched
|
|
197
|
+
* against the block body with its shell comments removed. One entry maps to a real bound in
|
|
198
|
+
* a shipped block: a row / line cap (`--limit`, an API or SQL `limit`, `per_page`, `head` /
|
|
199
|
+
* `tail` / `--tail`, `--stat-count`, any `--max-*` such as `--max-rows` / `--max-pages` /
|
|
200
|
+
* `--max-items` / `--max-results`, `max_results`, `grep -m` / `rg -m` / `--max-count`,
|
|
201
|
+
* `--page-size` / `--per-page` / `--first`, a jq / Python slice `[0:N]`, a `sed -n 'A,Bp'`
|
|
202
|
+
* range, an `awk 'NR<=N'` guard, a `size` field), a page / count cap (`*_MAX_*`,
|
|
203
|
+
* `*_MAX_PAGES`, a `*_N` knob, a shell loop `-lt` guard), or a window / severity filter
|
|
204
|
+
* (`--since` / `--until` / `--freshness` / `SINCE` / `UNTIL` / `statsPeriod` / a lowercase
|
|
205
|
+
* `since=` / `until=`, a `severity` / `level` filter). A timeout, retry, redirect or
|
|
206
|
+
* connection setting (`--max-time`, `curl -m`, `--max-redirs`), a tool's own verbosity
|
|
207
|
+
* (`--log-level=`) and a hyphenated `*-size=` flag (`--buffer-size=`) cap nothing the block
|
|
208
|
+
* prints and never count. The tavily block counts as bounded on its `max_results:5` and
|
|
209
|
+
* `head -c` alone. A body is unbounded only when it matches none.
|
|
210
|
+
*/
|
|
211
|
+
const CONTEXT_FETCH_BOUND_RES = [
|
|
212
|
+
// Row / line caps.
|
|
213
|
+
/--limit\b/,
|
|
214
|
+
/\blimit\b["']?[ \t]*[=:]?[ \t]*["'$]?\d/i,
|
|
215
|
+
/(^|[\s|;(])head[ \t]+-/,
|
|
216
|
+
/(^|[\s|;(])tail[ \t]+-/,
|
|
217
|
+
/--tail[= ]/,
|
|
218
|
+
/--stat-count/,
|
|
219
|
+
// --max-pages / --max-items / --max-results / --max-rows / --max-count; not --max-time.
|
|
220
|
+
/--max-(?!(?:time|redirs|retries|wait|duration|age|connections)(?![\w-]))[\w-]+/,
|
|
221
|
+
/max_results/,
|
|
222
|
+
/\bper_page\b["']?[ \t]*[=:][ \t]*["'$]?\d/i,
|
|
223
|
+
/--page-size\b/,
|
|
224
|
+
/--per-page\b/,
|
|
225
|
+
/--first\b/,
|
|
226
|
+
/\b(?:[ef]?grep|rg)\b[^\n|;&]*[ \t]-m[ \t]*["'$]?\d/, // grep -m 20, not curl -m 30
|
|
227
|
+
/--max-count\b/,
|
|
228
|
+
/[\[(][ \t]*\d*[ \t]*:[ \t]*\d+/, // jq / Python slice: .[0:10], [:10], [0:10]
|
|
229
|
+
/\bsed\b[^\n]*[ \t]-n[ \t]*['"]?[0-9]+[ \t]*,[ \t]*[0-9]+p/, // sed -n '1,200p'
|
|
230
|
+
/\bNR[ \t]*<=?[ \t]*[0-9$]/, // awk 'NR<=500'
|
|
231
|
+
/(?<!\w)(?<!\w-)size["']?[ \t]*[=:][ \t]*["']?\d/i, // request / option body field, not --buffer-size=
|
|
232
|
+
// Page / count caps.
|
|
233
|
+
/_MAX_/,
|
|
234
|
+
/[A-Z][A-Z0-9]*_N\b/,
|
|
235
|
+
/(^|[\s|;(])-l[et][ \t]+["'$]?\d/, // shell loop guard: [ "$N" -lt 20 ]
|
|
236
|
+
// Window / severity filters.
|
|
237
|
+
/--since\b/,
|
|
238
|
+
/--until\b/,
|
|
239
|
+
/--freshness\b/,
|
|
240
|
+
/\bsince[ \t]*[=:]/i, // since=1h, since: 2h
|
|
241
|
+
/\buntil[ \t]*[=:]/i,
|
|
242
|
+
/SINCE/,
|
|
243
|
+
/UNTIL/,
|
|
244
|
+
/statsPeriod/,
|
|
245
|
+
/--severity\b/,
|
|
246
|
+
/\bseverity[ \t]*([=:]|[<>]=?)/i,
|
|
247
|
+
/--level\b/,
|
|
248
|
+
/(?<!\w)(?<!log-)level[ \t]*([=:]|[<>]=?)/i, // not --log-level=
|
|
249
|
+
];
|
|
250
|
+
/** True when a `context-fetch` block body carries at least one output bound (see the list). */
|
|
251
|
+
export function blockBoundsOutput(body) {
|
|
252
|
+
const text = stripShellComments(body.join("\n"));
|
|
253
|
+
return CONTEXT_FETCH_BOUND_RES.some((re) => re.test(text));
|
|
254
|
+
}
|
|
85
255
|
/**
|
|
86
256
|
* Map of context-fetch source name -> predicate proving THIS repo actually runs
|
|
87
257
|
* that backend. Evidence-gates `context-fetch-source-not-enabled`
|
|
@@ -329,38 +499,8 @@ export function detectContextFetchProvisionMissing(cwd) {
|
|
|
329
499
|
const consumer = content.slice(endIdx);
|
|
330
500
|
if (contextFetchDismissesAll(consumer))
|
|
331
501
|
return null;
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
let inFence = false;
|
|
335
|
-
for (const line of consumer.split("\n")) {
|
|
336
|
-
const startM = parseContextFetchStart(line);
|
|
337
|
-
const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
|
|
338
|
-
if (startM) {
|
|
339
|
-
// Unnamed blocks cannot be matched to a provision sibling (which is keyed
|
|
340
|
-
// by name), so they are parked under "" and filtered out downstream.
|
|
341
|
-
cur = { kind: "start", name: startM.name, body: [] };
|
|
342
|
-
inFence = false;
|
|
343
|
-
blocks.push(cur);
|
|
344
|
-
continue;
|
|
345
|
-
}
|
|
346
|
-
if (provM) {
|
|
347
|
-
cur = { kind: "provision", name: provM[1], body: [] };
|
|
348
|
-
inFence = false;
|
|
349
|
-
blocks.push(cur);
|
|
350
|
-
continue;
|
|
351
|
-
}
|
|
352
|
-
if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
|
|
353
|
-
cur = null;
|
|
354
|
-
inFence = false;
|
|
355
|
-
continue;
|
|
356
|
-
}
|
|
357
|
-
if (cur && /^```/.test(line)) {
|
|
358
|
-
inFence = !inFence;
|
|
359
|
-
continue;
|
|
360
|
-
}
|
|
361
|
-
if (cur && inFence)
|
|
362
|
-
cur.body.push(line);
|
|
363
|
-
}
|
|
502
|
+
// Parse the consumer section into named start / provision blocks with fenced bodies.
|
|
503
|
+
const blocks = parseContextFetchBlocks(consumer);
|
|
364
504
|
const provisionNames = new Set(blocks.filter((b) => b.kind === "provision").map((b) => b.name));
|
|
365
505
|
const provisionBody = blocks
|
|
366
506
|
.filter((b) => b.kind === "provision")
|
|
@@ -404,3 +544,48 @@ export function detectContextFetchProvisionMissing(cwd) {
|
|
|
404
544
|
action: `For each flagged block, add a sibling \`<!-- context-fetch:provision <name> -->\` block below \`<!-- bkit:end -->\` — SAME name as the fetch block — whose bash body installs the CLI, self-guarded and install-only: \`command -v ${firstCli} >/dev/null 2>&1 || <install ${firstCli}>\` (e.g. \`pnpm add -g ${firstCli}\` for an npm-published CLI). If \`.bkit/templates/context/\` ships a ready-made \`context-fetch:provision ${firstName}\` recipe, copy that. Then re-run \`bkit install\` so the recipe bakes into \`.claude/bkit-cloud.md\`'s setup script; \`.claude/hooks/bkit-cloud-bootstrap.sh\` runs the same recipe on gh-runner / resumed sessions. A block that fetches via an MCP tool or only universal tools (curl/jq/date) needs no provision.`,
|
|
405
545
|
};
|
|
406
546
|
}
|
|
547
|
+
/**
|
|
548
|
+
* Advisory: the consumer section enables a `context-fetch` block whose bash body bounds no
|
|
549
|
+
* output — no row / line cap, page cap or window filter. `/bkit-debug` runs every enabled
|
|
550
|
+
* block and writes its stdout straight into that context's artifact, so an unbounded block
|
|
551
|
+
* downloads a whole-run dump; only the post-hoc 3000-line / 400 KB clamp catches it, and
|
|
552
|
+
* the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.
|
|
553
|
+
*
|
|
554
|
+
* Distinct from `context-fetch-missing` (which owns the no-blocks case): this only runs
|
|
555
|
+
* once at least one block exists. The blanket opt-out (`<!-- context-fetch:none intentional -->`)
|
|
556
|
+
* dismisses it; a context-scoped marker (`context-fetch:none e2e`) does not, because the
|
|
557
|
+
* runner still runs a block that is present.
|
|
558
|
+
*/
|
|
559
|
+
export function detectContextFetchUnbounded(cwd) {
|
|
560
|
+
const filePath = path.join(cwd, ".agents", "context.md");
|
|
561
|
+
if (!fs.existsSync(filePath))
|
|
562
|
+
return null;
|
|
563
|
+
const content = fs.readFileSync(filePath, "utf-8");
|
|
564
|
+
const endIdx = content.search(/^<!-- bkit:end -->$/m);
|
|
565
|
+
if (endIdx === -1)
|
|
566
|
+
return null;
|
|
567
|
+
const consumer = content.slice(endIdx);
|
|
568
|
+
if (contextFetchDismissesAll(consumer))
|
|
569
|
+
return null;
|
|
570
|
+
// Only the blocks the runner actually runs can download anything: a block whose
|
|
571
|
+
// `context=` is unknown is narrated NOT RUN, and one with no fenced body is refused
|
|
572
|
+
// before it runs (`bkit context list-blocks` / `run-block`). Neither is bounded here.
|
|
573
|
+
const runnable = parseContextFetchBlocks(consumer).filter((b) => b.kind === "start" &&
|
|
574
|
+
CONTEXT_FETCH_CONTEXTS.includes(b.context) &&
|
|
575
|
+
b.body.some((l) => l.trim() !== ""));
|
|
576
|
+
// No runnable block => `context-fetch-missing` owns the empty case (no double-fire).
|
|
577
|
+
if (runnable.length === 0)
|
|
578
|
+
return null;
|
|
579
|
+
const unbounded = runnable.filter((b) => !blockBoundsOutput(b.body));
|
|
580
|
+
if (unbounded.length === 0)
|
|
581
|
+
return null;
|
|
582
|
+
const items = unbounded.map((b) => `${b.name || "(unnamed)"} (\`context=${b.context}\`)`);
|
|
583
|
+
const list = items.join(", ");
|
|
584
|
+
const plural = items.length > 1;
|
|
585
|
+
return {
|
|
586
|
+
id: "context-fetch-unbounded",
|
|
587
|
+
severity: "advisory",
|
|
588
|
+
detect: `\`.agents/context.md\` enables context-fetch block${plural ? "s" : ""} below \`<!-- bkit:end -->\` that bound no output: ${list}. \`/bkit-debug\` runs every enabled block and writes its stdout straight into that context's artifact, so ${plural ? "these blocks" : "this block"} download${plural ? "" : "s"} a whole-run dump — only the post-hoc 3000-line / 400 KB clamp catches it, and the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.`,
|
|
589
|
+
action: `Bound each flagged block at the source: add a row / line cap (\`--limit N\`, \`head -n N\`, \`tail -n N\` / \`--tail N\`, \`--stat-count N\`, \`grep -m N\` / \`--max-count N\`, a \`--max-*\` row or page cap (\`--max-rows N\`, \`--max-pages N\`, \`--max-items N\`, \`--max-results N\`),\`--page-size N\` / \`--per-page N\` / \`--first N\`, a jq / SQL slice (\`.[0:N]\`, \`limit N\`), a \`sed -n 'A,Bp'\` / \`awk 'NR<=N'\` range, the API's \`max_results\` / \`per_page\` / \`limit\` param, or a request-body \`size\` field), a page cap (\`<NAME>_MAX_PAGES\`, a \`*_N\` count variable, or a shell loop guard \`[ "$N" -lt M ]\`), or a window / severity filter (\`--since\` / \`--until\` / \`--freshness\` / \`SINCE\` / \`UNTIL\`, \`statsPeriod\`, or a \`severity\` / \`level\` filter) in the block body — not only in its \`# Customise:\` comment. A timeout (\`--max-time\`, \`curl -m\`) or the tool's own \`--log-level\` caps nothing the block prints. Raise the cap only when the cause sits outside the kept window: \`/bkit-debug\` clamps the artifact post hoc at 3000 lines / 400 KB (head 500 + tail 1000 + every error-matching line), so an unbounded dump can drop the very failure lines a diagnosis needs.`,
|
|
590
|
+
};
|
|
591
|
+
}
|
|
@@ -13,7 +13,7 @@ const TRACKER_TOKENS = {
|
|
|
13
13
|
description: "Linear personal API key for the Linear MCP server and the Linear preflight hook (generate at https://linear.app/settings/api)",
|
|
14
14
|
},
|
|
15
15
|
jira: {
|
|
16
|
-
key: "
|
|
16
|
+
key: "BKIT_JIRA_API_KEY",
|
|
17
17
|
description: 'Atlassian API token with scopes for the app "Atlassian MCP V2", sent as Bearer to the Jira MCP server (create at https://id.atlassian.com/manage-profile/security/api-tokens; see .bkit/trackers.md § jira)',
|
|
18
18
|
},
|
|
19
19
|
};
|
|
@@ -28,7 +28,7 @@ function tokenKeys(tracker) {
|
|
|
28
28
|
* copied it to .bkit/.env and filled in their tokens.
|
|
29
29
|
*/
|
|
30
30
|
// `tracker` adds its own token to the token prose (`TRACKER_TOKENS`). Defaults to
|
|
31
|
-
// `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.
|
|
31
|
+
// `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.tracker.default`.
|
|
32
32
|
export function detectMissingDotenv(cwd, tracker = "linear") {
|
|
33
33
|
const examplePath = path.join(cwd, ".bkit", ".env.example");
|
|
34
34
|
const envPath = path.join(cwd, ".bkit", ".env");
|
|
@@ -41,7 +41,7 @@ export function detectMissingDotenv(cwd, tracker = "linear") {
|
|
|
41
41
|
id: "mcp-env-missing-dotenv",
|
|
42
42
|
severity: "advisory",
|
|
43
43
|
detect: `.bkit/.env.example exists but .bkit/.env does not. MCP servers and agent tooling will not have access to ${tokens}.`,
|
|
44
|
-
action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}). Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
|
|
44
|
+
action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}) — in a git worktree, copy the main checkout's .bkit/.env instead, or run \`bkit worktrees setup\` to link it. Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
|
|
45
45
|
};
|
|
46
46
|
}
|
|
47
47
|
/**
|
|
@@ -7,6 +7,7 @@ import { extractManagedBlock, stripManagedBlock } from "../../install/managed-bl
|
|
|
7
7
|
import { readTemplate } from "../../render/parts.js";
|
|
8
8
|
import { findTemplateSource, getPkgRoot } from "../../shared/package-roots.js";
|
|
9
9
|
import { parseJson } from "../../shared/json.js";
|
|
10
|
+
import { ciWorkflowPath } from "../../shared/settings.js";
|
|
10
11
|
/**
|
|
11
12
|
* Strip out content inside bkit-managed block markers (HTML and slash style).
|
|
12
13
|
* Used by detectors that need to inspect only consumer-owned content.
|
|
@@ -67,11 +68,12 @@ export function detectGitignoreBlockDuplicates(cwd) {
|
|
|
67
68
|
* surfaces — pure cost (artifact upload + storage) with zero diagnostic payoff.
|
|
68
69
|
*
|
|
69
70
|
* "Hostile" gap per the BAR-224 signal-vs-noise classification. Reads the consumer's
|
|
70
|
-
* own bkit-ci.yml, active lines only: YAML comment lines are dropped first, so a commented
|
|
71
|
+
* own CI workflow (`bkit.testing.ciWorkflow`, default `bkit-ci.yml`), active lines only: YAML comment lines are dropped first, so a commented
|
|
71
72
|
* template stub or a commented-out example never fires.
|
|
72
73
|
*/
|
|
73
74
|
export function detectPlaywrightReporterHostile(cwd) {
|
|
74
|
-
const
|
|
75
|
+
const ciRel = ciWorkflowPath(cwd);
|
|
76
|
+
const ciPath = path.join(cwd, ciRel);
|
|
75
77
|
if (!fs.existsSync(ciPath))
|
|
76
78
|
return null;
|
|
77
79
|
const content = fs.readFileSync(ciPath, "utf-8");
|
|
@@ -92,7 +94,7 @@ export function detectPlaywrightReporterHostile(cwd) {
|
|
|
92
94
|
return {
|
|
93
95
|
id: "playwright-reporter-line-override-hostile",
|
|
94
96
|
severity: "advisory",
|
|
95
|
-
detect:
|
|
97
|
+
detect: `${ciRel} has a \`playwright test\` invocation that passes \`--reporter=line\`. Under \`[verbose ci]\` with \`--trace=on\`, trace artifacts are written but no reporter surfaces them — pure cost.`,
|
|
96
98
|
action: 'Drop the `--reporter=line` flag so `playwright.config.ts`\'s configured reporter chain runs (typically `[list, html, github, json]`). Verbose-aware pattern: have `test:e2e` read `VERBOSE_CI` and append `--trace=on` to its own `playwright test` call (e.g. `TRACE=; [ "$VERBOSE_CI" = "1" ] && TRACE=--trace=on; playwright test $TRACE`), then run it plainly as `pnpm test:e2e` — do NOT pass `--trace=on` through a turbo / pnpm `-- --trace=on` passthrough, which appends to the script string and breaks any test:e2e ending in a bash construct (fi / done / esac). Never pass `--reporter`. Note that `--video` and `--screenshot` are NOT Playwright CLI flags (they\'re `use:` keys in playwright.config.ts); the trace.zip already captures snapshots / network / console / source. Default-mode output stays clean via the config\'s `list` reporter.',
|
|
97
99
|
};
|
|
98
100
|
}
|
|
@@ -10,12 +10,13 @@
|
|
|
10
10
|
// readBkitConfig — from shared/settings.ts (the consumer's `bkit` settings)
|
|
11
11
|
// readInstallingVersion — from shared/package-json.ts (the version of the bkit doing the install)
|
|
12
12
|
// readTemplate — from render/parts.ts (template with its shared parts spliced in)
|
|
13
|
+
// parsePlanBlocks — from commands/workflow/plan-blocks.ts (a plan's group and task blocks)
|
|
13
14
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
14
15
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
15
|
-
import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, } from "./repo.js";
|
|
16
|
+
import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, detectInvalidAskSettings, detectBuildPublish, detectInvalidTaskCaps, detectTaskCapFormStale, detectUnmarkedPlans, } from "./repo.js";
|
|
16
17
|
import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
|
|
17
18
|
import { detectBkitVersionMajorDowngrade, detectBkitVersionPinStale } from "./version.js";
|
|
18
|
-
import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, } from "./context-fetch.js";
|
|
19
|
+
import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, detectContextFetchUnbounded, } from "./context-fetch.js";
|
|
19
20
|
import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
|
|
20
21
|
// ---------------------------------------------------------------------------
|
|
21
22
|
// Internal helper
|
|
@@ -42,7 +43,7 @@ export function dedupeById(findings) {
|
|
|
42
43
|
* installingVersion: used by detectBkitVersionMajorDowngrade; defaults to the
|
|
43
44
|
* package's own version read from its package.json at runtime.
|
|
44
45
|
* issueTracker: when provided, narrows tracker-specific checks (e.g. MCP server
|
|
45
|
-
* requirements). When omitted, read from consumer's `bkit.
|
|
46
|
+
* requirements). When omitted, read from consumer's `bkit.tracker.default` in package.json.
|
|
46
47
|
*
|
|
47
48
|
* GitHub tracker gate: when `issueTracker === "github"`, the Linear preflight
|
|
48
49
|
* gate is a no-op — the GitHub gate is enforced by workflow Step 1 via MCP.
|
|
@@ -87,6 +88,19 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
|
|
|
87
88
|
const versionPinStale = detectBkitVersionPinStale(cwd);
|
|
88
89
|
if (versionPinStale)
|
|
89
90
|
advisories.push(versionPinStale);
|
|
91
|
+
const invalidTaskCaps = detectInvalidTaskCaps(cwd);
|
|
92
|
+
if (invalidTaskCaps)
|
|
93
|
+
advisories.push(invalidTaskCaps);
|
|
94
|
+
advisories.push(...detectBuildPublish(cwd));
|
|
95
|
+
const taskCapFormStale = detectTaskCapFormStale(cwd);
|
|
96
|
+
if (taskCapFormStale)
|
|
97
|
+
advisories.push(taskCapFormStale);
|
|
98
|
+
const invalidAsks = detectInvalidAskSettings(cwd);
|
|
99
|
+
if (invalidAsks)
|
|
100
|
+
advisories.push(invalidAsks);
|
|
101
|
+
const unmarkedPlans = detectUnmarkedPlans(cwd);
|
|
102
|
+
if (unmarkedPlans)
|
|
103
|
+
advisories.push(unmarkedPlans);
|
|
90
104
|
// BAR-224: [verbose ci] marker advisories
|
|
91
105
|
const playwrightReporterHostile = detectPlaywrightReporterHostile(cwd);
|
|
92
106
|
if (playwrightReporterHostile)
|
|
@@ -103,6 +117,9 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
|
|
|
103
117
|
const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
|
|
104
118
|
if (contextFetchProvision)
|
|
105
119
|
advisories.push(contextFetchProvision);
|
|
120
|
+
const contextFetchUnbounded = detectContextFetchUnbounded(cwd);
|
|
121
|
+
if (contextFetchUnbounded)
|
|
122
|
+
advisories.push(contextFetchUnbounded);
|
|
106
123
|
// bkit-not-on-path advisory — suggest the shell alias for local development.
|
|
107
124
|
const bkitNotOnPath = detectBkitNotOnPath();
|
|
108
125
|
if (bkitNotOnPath)
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
// checks/before/repo.ts — repo preconditions: package.json present and parseable, a git repo,
|
|
2
|
-
// bkit on PATH.
|
|
2
|
+
// valid plan caps, a change issue form showing them, plans in task-block form, bkit on PATH.
|
|
3
3
|
import * as fs from "node:fs";
|
|
4
4
|
import * as path from "node:path";
|
|
5
5
|
import { spawnSync } from "node:child_process";
|
|
6
|
-
import {
|
|
6
|
+
import { parsePlanBlocks } from "../../commands/workflow/plan-blocks.js";
|
|
7
|
+
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
8
|
+
import { ASK_POINTS, CONFIG_DEFAULTS, invalidAskSettings, invalidBuildPublish, invalidTaskCaps, limitKey, readBkitConfig, } from "../../shared/settings.js";
|
|
7
9
|
import { isCloudOrCi } from "./env.js";
|
|
8
10
|
// ---------------------------------------------------------------------------
|
|
9
11
|
// Blocker detectors
|
|
@@ -43,6 +45,199 @@ export function detectNotGitRepo(cwd, modules) {
|
|
|
43
45
|
action: "Run `git init` to initialise a git repo, then re-run. bkit installs into a git repository — its managed .gitignore/.gitattributes blocks require one (core is implicit; there is no --core flag to omit).",
|
|
44
46
|
};
|
|
45
47
|
}
|
|
48
|
+
/**
|
|
49
|
+
* Advisory: `package.json` `bkit.workflows.tasks` holds a plan cap that is not an integer >= 1.
|
|
50
|
+
* Each such key falls back to its default in `readBkitConfig`.
|
|
51
|
+
*/
|
|
52
|
+
export function detectInvalidTaskCaps(cwd) {
|
|
53
|
+
const workflows = bkitWorkflows(cwd);
|
|
54
|
+
if (workflows === null)
|
|
55
|
+
return null;
|
|
56
|
+
const bad = invalidTaskCaps(workflows.tasks);
|
|
57
|
+
if (bad.length === 0)
|
|
58
|
+
return null;
|
|
59
|
+
const caps = CONFIG_DEFAULTS.tasks;
|
|
60
|
+
const keys = bad[0] === "tasks" ? Object.keys(caps) : bad;
|
|
61
|
+
const named = bad.map((k) => `\`bkit.workflows.${k === "tasks" ? k : `tasks.${k}`}\``).join(", ");
|
|
62
|
+
return {
|
|
63
|
+
id: "bkit-tasks-invalid",
|
|
64
|
+
severity: "advisory",
|
|
65
|
+
detect: `package.json ${named} is not a whole number of 1 or more, so the plan check uses the default instead.`,
|
|
66
|
+
action: `Set each to a whole number of 1 or more in package.json, or delete it to keep the default: ${keys
|
|
67
|
+
.map((k) => `\`bkit.workflows.tasks.${k}\` (default ${caps[k]})`)
|
|
68
|
+
.join(", ")}.`,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Advisory: `package.json` `bkit.workflows.build.publish` holds a refused or invalid value.
|
|
73
|
+
* `remote: false` is refused (a cloud run always publishes); a non-object block or a
|
|
74
|
+
* non-boolean `local` falls back to its default. One finding per key.
|
|
75
|
+
*/
|
|
76
|
+
export function detectBuildPublish(cwd) {
|
|
77
|
+
const workflows = bkitWorkflows(cwd);
|
|
78
|
+
if (workflows === null)
|
|
79
|
+
return [];
|
|
80
|
+
const out = [];
|
|
81
|
+
const publish = workflows.build?.publish;
|
|
82
|
+
if (publish !== null &&
|
|
83
|
+
typeof publish === "object" &&
|
|
84
|
+
!Array.isArray(publish) &&
|
|
85
|
+
publish.remote !== undefined &&
|
|
86
|
+
publish.remote !== true) {
|
|
87
|
+
out.push({
|
|
88
|
+
id: "bkit-build-publish-remote",
|
|
89
|
+
severity: "advisory",
|
|
90
|
+
detect: "package.json `bkit.workflows.build.publish.remote` is not `true`, so a cloud or CI run still publishes.",
|
|
91
|
+
action: "Delete `bkit.workflows.build.publish.remote` or set it to `true`; hold a local build with `bkit.workflows.build.publish.local` set to `false`.",
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
const bad = invalidBuildPublish(workflows.build);
|
|
95
|
+
if (bad.length > 0) {
|
|
96
|
+
out.push({
|
|
97
|
+
id: "bkit-build-publish-invalid",
|
|
98
|
+
severity: "advisory",
|
|
99
|
+
detect: `package.json ${bad.map((k) => `\`bkit.workflows.${k}\``).join(", ")} is not ${bad[0] === "build.publish.local" ? "a boolean" : "an object"}, so the default (publish) is used instead.`,
|
|
100
|
+
action: "Set `bkit.workflows.build.publish.local` to `true` or `false`, or delete the block to keep the default (`true`).",
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
return out;
|
|
104
|
+
}
|
|
105
|
+
const TASK_CAP_KEY = /`bkit\.workflows\.tasks\.(\w+)`/g;
|
|
106
|
+
/**
|
|
107
|
+
* Each `bkit.workflows.tasks.<key>` the text names with a `(default N)` after it, on the same
|
|
108
|
+
* line and before the next named key.
|
|
109
|
+
*/
|
|
110
|
+
export function taskCapDefaultsNamed(text) {
|
|
111
|
+
const hits = [...text.matchAll(TASK_CAP_KEY)];
|
|
112
|
+
return hits.flatMap((m, i) => {
|
|
113
|
+
const from = m.index + m[0].length;
|
|
114
|
+
const lineEnd = text.indexOf("\n", from);
|
|
115
|
+
const end = Math.min(hits[i + 1]?.index ?? text.length, lineEnd === -1 ? text.length : lineEnd);
|
|
116
|
+
const n = /\(default (\d+)\)/.exec(text.slice(from, end));
|
|
117
|
+
return n ? [{ key: m[1], value: Number(n[1]) }] : [];
|
|
118
|
+
});
|
|
119
|
+
}
|
|
120
|
+
const CHANGE_FORM = ".github/ISSUE_TEMPLATE/bkit-change.yml";
|
|
121
|
+
/**
|
|
122
|
+
* Advisory: the change issue form names a plan cap with a `(default N)` that differs from the
|
|
123
|
+
* value `readBkitConfig` gives for that key.
|
|
124
|
+
*/
|
|
125
|
+
export function detectTaskCapFormStale(cwd) {
|
|
126
|
+
const file = path.join(cwd, CHANGE_FORM);
|
|
127
|
+
if (!fs.existsSync(file))
|
|
128
|
+
return null;
|
|
129
|
+
const caps = readBkitConfig(cwd).tasks;
|
|
130
|
+
const isCap = (k) => Object.hasOwn(caps, k);
|
|
131
|
+
const stale = new Map();
|
|
132
|
+
for (const { key, value } of taskCapDefaultsNamed(fs.readFileSync(file, "utf-8"))) {
|
|
133
|
+
if (isCap(key) && caps[key] !== value)
|
|
134
|
+
stale.set(key, value);
|
|
135
|
+
}
|
|
136
|
+
if (stale.size === 0)
|
|
137
|
+
return null;
|
|
138
|
+
const rows = [...stale];
|
|
139
|
+
return {
|
|
140
|
+
id: "bkit-tasks-form-stale",
|
|
141
|
+
severity: "advisory",
|
|
142
|
+
detect: `${CHANGE_FORM} shows plan caps that differ from package.json: ${rows
|
|
143
|
+
.map(([k, v]) => `\`bkit.workflows.tasks.${k}\` (default ${v}) is ${caps[k]}`)
|
|
144
|
+
.join(", ")}.`,
|
|
145
|
+
action: `In ${CHANGE_FORM}, change the number in each "(default N)" after the key: ${rows
|
|
146
|
+
.map(([k, v]) => `\`bkit.workflows.tasks.${k}\` "(default ${v})" → "(default ${caps[k]})"`)
|
|
147
|
+
.join(", ")}. Or set the key in package.json \`bkit.workflows.tasks\` to the number the form shows.`,
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
/** `package.json` `bkit.workflows` as an object; null when the file or block is unusable. */
|
|
151
|
+
function bkitWorkflows(cwd) {
|
|
152
|
+
const read = readJsonFile(path.join(cwd, "package.json"));
|
|
153
|
+
if (!read.ok)
|
|
154
|
+
return null;
|
|
155
|
+
const bkit = read.value?.bkit;
|
|
156
|
+
if (bkit === null || typeof bkit !== "object" || Array.isArray(bkit))
|
|
157
|
+
return null;
|
|
158
|
+
const workflows = bkit.workflows;
|
|
159
|
+
return workflows !== null && typeof workflows === "object" && !Array.isArray(workflows)
|
|
160
|
+
? workflows
|
|
161
|
+
: {};
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* Advisory when a `bkit.workflows.<workflow>.<point>` block holds an `ask` that is not
|
|
165
|
+
* true/false, a limit that is not a whole number of 1 or more, or is not an object. Each such
|
|
166
|
+
* key falls back to its default in `readBkitConfig`.
|
|
167
|
+
*/
|
|
168
|
+
export function detectInvalidAskSettings(cwd) {
|
|
169
|
+
const workflows = bkitWorkflows(cwd);
|
|
170
|
+
if (workflows === null)
|
|
171
|
+
return null;
|
|
172
|
+
const bad = invalidAskSettings(workflows);
|
|
173
|
+
if (bad.length === 0)
|
|
174
|
+
return null;
|
|
175
|
+
const defaults = bad.map((k) => {
|
|
176
|
+
const point = ASK_POINTS.find((p) => k === p || k.startsWith(`${p}.`));
|
|
177
|
+
const d = CONFIG_DEFAULTS.asks[point];
|
|
178
|
+
return `\`bkit.workflows.${point}\` (default \`{ "ask": ${d.ask}, "${limitKey(point)}": ${d.max} }\`)`;
|
|
179
|
+
});
|
|
180
|
+
return {
|
|
181
|
+
id: "bkit-ask-settings-invalid",
|
|
182
|
+
severity: "advisory",
|
|
183
|
+
detect: `package.json ${bad.map((k) => `\`bkit.workflows.${k}\``).join(", ")} is not valid (\`ask\` takes true or false, a limit a whole number of 1 or more), so the default is used instead.`,
|
|
184
|
+
action: `Fix or delete each in package.json: ${[...new Set(defaults)].join(", ")}.`,
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
const PLAN_FILE = /^(.+)-plan\.md$/;
|
|
188
|
+
/** The FID's `docs/plans/{month}/logs/{FID}/status.jsonl` holds a ship `workflow-done` row. */
|
|
189
|
+
function fidShipped(monthDir, fid) {
|
|
190
|
+
const file = path.join(monthDir, "logs", fid, "status.jsonl");
|
|
191
|
+
if (!fs.existsSync(file))
|
|
192
|
+
return false;
|
|
193
|
+
return fs
|
|
194
|
+
.readFileSync(file, "utf-8")
|
|
195
|
+
.split("\n")
|
|
196
|
+
.some((line) => {
|
|
197
|
+
const row = parseJson(line);
|
|
198
|
+
if (!row.ok || typeof row.value !== "object" || row.value === null)
|
|
199
|
+
return false;
|
|
200
|
+
const { type, workflow } = row.value;
|
|
201
|
+
return type === "workflow-done" && workflow === "ship";
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* Advisory: a `docs/plans/{YYYYMM}/{FID}-plan.md` whose FID has not shipped holds no task
|
|
206
|
+
* blocks, so `/bkit-build` Step 3 converts it on the FID's next build. `archive/` and
|
|
207
|
+
* `logs/` sit below the month folder and are not read.
|
|
208
|
+
*/
|
|
209
|
+
export function detectUnmarkedPlans(cwd) {
|
|
210
|
+
const plans = path.join(cwd, "docs", "plans");
|
|
211
|
+
if (!fs.existsSync(plans))
|
|
212
|
+
return null;
|
|
213
|
+
const unmarked = [];
|
|
214
|
+
for (const month of fs.readdirSync(plans, { withFileTypes: true })) {
|
|
215
|
+
if (!month.isDirectory())
|
|
216
|
+
continue;
|
|
217
|
+
const monthDir = path.join(plans, month.name);
|
|
218
|
+
for (const entry of fs.readdirSync(monthDir, { withFileTypes: true })) {
|
|
219
|
+
const fid = entry.isFile() ? PLAN_FILE.exec(entry.name)?.[1] : undefined;
|
|
220
|
+
if (fid === undefined)
|
|
221
|
+
continue;
|
|
222
|
+
const text = fs.readFileSync(path.join(monthDir, entry.name), "utf-8");
|
|
223
|
+
if (parsePlanBlocks(text).tasks.length > 0 || fidShipped(monthDir, fid))
|
|
224
|
+
continue;
|
|
225
|
+
unmarked.push(`docs/plans/${month.name}/${entry.name}`);
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
if (unmarked.length === 0)
|
|
229
|
+
return null;
|
|
230
|
+
unmarked.sort();
|
|
231
|
+
const one = unmarked.length === 1;
|
|
232
|
+
return {
|
|
233
|
+
id: "plan-task-markers-missing",
|
|
234
|
+
severity: "advisory",
|
|
235
|
+
detect: `${unmarked.length} ${one ? "plan has" : "plans have"} no task markers and will be converted to group and task blocks on the next \`/bkit-build\` of ${one ? "its" : "their"} FID: ${unmarked
|
|
236
|
+
.map((p) => `\`${p}\``)
|
|
237
|
+
.join(", ")}.`,
|
|
238
|
+
action: "Nothing to do by hand: this matters only for builds still to run, and plans of shipped FIDs are not listed.",
|
|
239
|
+
};
|
|
240
|
+
}
|
|
46
241
|
/**
|
|
47
242
|
* Advisory: `bkit` is not on PATH.
|
|
48
243
|
* bkit is a devDependency — without a shell alias, every invocation requires
|