@cbartens/bkit 6.0.0 → 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 +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -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 +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- 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 +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- 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/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- 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 +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- 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 +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- 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/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- 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 +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- 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 +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- 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 +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -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/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- 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 +282 -176
- 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 +24 -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 +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- 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 +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- 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 +9 -1
- 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 +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- 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/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- 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 +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /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
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// task blocks between lowercase HTML-comment markers, each task's uppercase fields.
|
|
3
3
|
//
|
|
4
4
|
// <!-- bkit:group N start -->
|
|
5
|
-
// ### GROUP N: {title}
|
|
5
|
+
// ### TASK GROUP N: {title} (`### GROUP N: {title}` is read too)
|
|
6
6
|
// <!-- bkit:task M start -->
|
|
7
7
|
// - [ ] **TASK M:** {title}
|
|
8
8
|
// - **UPDATE:** `symbol` in `file`: what changes
|
|
@@ -27,18 +27,18 @@ export const PLAN_FIELDS = [
|
|
|
27
27
|
"TEST FIRST",
|
|
28
28
|
"TEST EXCEPTION",
|
|
29
29
|
];
|
|
30
|
+
/** Why every plan reader (`tests`, `tasks`, `ledgers triage`) refuses a plan with no task blocks. */
|
|
31
|
+
export const NO_MARKERS_REASON = "this plan has no task markers; run /bkit-build again to convert it";
|
|
30
32
|
const tableCells = (row) => row
|
|
31
33
|
.split("|")
|
|
32
34
|
.slice(1, -1)
|
|
33
35
|
.map((c) => c.trim());
|
|
34
36
|
/**
|
|
35
|
-
* The
|
|
36
|
-
*
|
|
37
|
-
* cell gives its backticked paths, normalised. No heading, table or `File` column → null.
|
|
37
|
+
* The first table under the first heading matching `heading`, before the next heading of
|
|
38
|
+
* the same or a higher level: the header line's index and its cells. No heading or table → null.
|
|
38
39
|
*/
|
|
39
|
-
|
|
40
|
-
const
|
|
41
|
-
const start = lines.findIndex((l) => /^#{2,4} .*Reuse Inventory/i.test(l));
|
|
40
|
+
function firstTable(lines, heading) {
|
|
41
|
+
const start = lines.findIndex((l) => heading.test(l));
|
|
42
42
|
if (start < 0)
|
|
43
43
|
return null;
|
|
44
44
|
const level = /^#+/.exec(lines[start])[0].length;
|
|
@@ -51,13 +51,24 @@ export function reuseInventory(text) {
|
|
|
51
51
|
}
|
|
52
52
|
if (head < 0)
|
|
53
53
|
return null;
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
54
|
+
return { head, cols: tableCells(lines[head]) };
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* The plan's Reuse Inventory: the first table under the first heading naming Reuse
|
|
58
|
+
* Inventory, before the next heading of the same or a higher level. Each row's `File`
|
|
59
|
+
* cell gives its backticked paths, normalised. No heading, table or `File` column → null.
|
|
60
|
+
*/
|
|
61
|
+
export function reuseInventory(text) {
|
|
62
|
+
const lines = text.split(/\r?\n/);
|
|
63
|
+
const table = firstTable(lines, /^#{2,4} .*Reuse Inventory/i);
|
|
64
|
+
if (table === null)
|
|
65
|
+
return null;
|
|
66
|
+
const file = table.cols.findIndex((c) => /^file\b/i.test(c));
|
|
67
|
+
const decision = table.cols.findIndex((c) => /^decision\b/i.test(c));
|
|
57
68
|
if (file < 0)
|
|
58
69
|
return null;
|
|
59
70
|
const rows = [];
|
|
60
|
-
for (let i = head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
|
|
71
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
|
|
61
72
|
const cells = tableCells(lines[i]);
|
|
62
73
|
rows.push({
|
|
63
74
|
line: lines[i],
|
|
@@ -65,7 +76,60 @@ export function reuseInventory(text) {
|
|
|
65
76
|
decision: decision < 0 ? "" : (cells[decision] ?? ""),
|
|
66
77
|
});
|
|
67
78
|
}
|
|
68
|
-
return { head: lines.slice(head, head + 2), rows };
|
|
79
|
+
return { head: lines.slice(table.head, table.head + 2), rows };
|
|
80
|
+
}
|
|
81
|
+
/** The plan's `Derived Test Matrix` over `tableCells`; null when the plan has no such table. */
|
|
82
|
+
export function derivedTestMatrix(text) {
|
|
83
|
+
const lines = text.split(/\r?\n/);
|
|
84
|
+
const table = firstTable(lines, /^#{2,4} .*Derived Test Matrix/i);
|
|
85
|
+
if (table === null)
|
|
86
|
+
return null;
|
|
87
|
+
const column = table.cols.findIndex((c) => /^task\b/i.test(c));
|
|
88
|
+
const rows = [];
|
|
89
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
|
|
90
|
+
const cells = tableCells(lines[i]);
|
|
91
|
+
rows.push({
|
|
92
|
+
line: lines[i],
|
|
93
|
+
number: i + 1,
|
|
94
|
+
cells,
|
|
95
|
+
tasks: column < 0 ? [] : [...(cells[column] ?? "").matchAll(/\d+/g)].map((m) => Number(m[0])),
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
return {
|
|
99
|
+
head: lines.slice(table.head, table.head + 2),
|
|
100
|
+
line: table.head + 1,
|
|
101
|
+
taskColumn: column < 0 ? null : column,
|
|
102
|
+
rows,
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
/** The plan's `Supersession Inventory` rows over `tableCells`; null when the plan has no such table. */
|
|
106
|
+
export function supersessionInventory(text) {
|
|
107
|
+
const lines = text.split(/\r?\n/);
|
|
108
|
+
const table = firstTable(lines, /^#{2,4} .*Supersession Inventory/i);
|
|
109
|
+
if (table === null)
|
|
110
|
+
return null;
|
|
111
|
+
const column = table.cols.findIndex((c) => /^existing\b/i.test(c));
|
|
112
|
+
const rows = [];
|
|
113
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++) {
|
|
114
|
+
const cells = tableCells(lines[i]);
|
|
115
|
+
rows.push({
|
|
116
|
+
line: lines[i],
|
|
117
|
+
number: i + 1,
|
|
118
|
+
files: spansOf(cells[column < 0 ? 0 : column] ?? "").map((f) => path.posix.normalize(f)),
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
return rows;
|
|
122
|
+
}
|
|
123
|
+
/** The plan's `Out of Scope` rows over `tableCells`; null when the plan has no such table. */
|
|
124
|
+
export function outOfScope(text) {
|
|
125
|
+
const lines = text.split(/\r?\n/);
|
|
126
|
+
const table = firstTable(lines, /^#{2,4} .*Out of Scope/i);
|
|
127
|
+
if (table === null)
|
|
128
|
+
return null;
|
|
129
|
+
const rows = [];
|
|
130
|
+
for (let i = table.head + 2; i < lines.length && /^\s*\|/.test(lines[i]); i++)
|
|
131
|
+
rows.push({ line: lines[i], number: i + 1, cells: tableCells(lines[i]) });
|
|
132
|
+
return rows;
|
|
69
133
|
}
|
|
70
134
|
/** The error for a code fence opened at `line` and never closed. */
|
|
71
135
|
export const fenceNeverClosed = (line) => `the code fence at line ${line} is never closed; nothing after it is read`;
|
|
@@ -77,7 +141,7 @@ const SINGLE_FIELDS = new Set([
|
|
|
77
141
|
"TEST EXCEPTION",
|
|
78
142
|
]);
|
|
79
143
|
const MARKER = /^\s*<!--\s*bkit:(group|task)\s+(\d+)\s+(start|end)\s*-->\s*$/;
|
|
80
|
-
const GROUP_HEAD = /^###\s+GROUP\s+(\d+):\s*(.*)$/;
|
|
144
|
+
const GROUP_HEAD = /^###\s+(?:TASK\s+)?GROUP\s+(\d+):\s*(.*)$/;
|
|
81
145
|
const TASK_HEAD = /^\s*- \[([ xX])\] \*\*TASK (\d+):\*\*\s*(.*)$/;
|
|
82
146
|
const LABEL_LINE = /^(\s*)(?:- )?\*\*([A-Za-z][A-Za-z -]*?):\*\*\s*(.*)$/;
|
|
83
147
|
const SUB_BULLET = /^(\s*)- (.*)$/;
|
|
@@ -258,7 +322,7 @@ export function parsePlanBlocks(text) {
|
|
|
258
322
|
if (want.kind === "group") {
|
|
259
323
|
const h = GROUP_HEAD.exec(raw);
|
|
260
324
|
if (h === null)
|
|
261
|
-
err(n, `GROUP ${want.n} (line ${want.line}) is not followed by \`### GROUP ${want.n}: {title}\``);
|
|
325
|
+
err(n, `GROUP ${want.n} (line ${want.line}) is not followed by \`### TASK GROUP ${want.n}: {title}\``);
|
|
262
326
|
else if (Number(h[1]) !== want.n)
|
|
263
327
|
err(n, `heading says GROUP ${h[1]}, its marker at line ${want.line} says GROUP ${want.n}`);
|
|
264
328
|
else if (group !== null)
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
// bkit plans parse|comment — design Step 11: read the organised design's
|
|
2
|
+
// `## Suggested Workstreams` and `## Suggested Plans` and build the advisory comment
|
|
3
|
+
// for the feature's own issue.
|
|
4
|
+
//
|
|
5
|
+
// A workstream is a logical unit of the design; a plan is the filed unit (one issue,
|
|
6
|
+
// one plan doc, one branch / PR) covering one or more workstreams. Advisory only.
|
|
7
|
+
// Workflows never create tracker issues, comment on another issue, or set blockers,
|
|
8
|
+
// so nothing here matches plans to issues or builds blocked-by bodies. The tracker
|
|
9
|
+
// write itself stays an MCP call in the workflow; this prepares its body.
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
import { CommandError, EXIT } from "../lib.js";
|
|
13
|
+
import { COMMENT_FILE_OUTPUT, GENERATED_MARKER, commentFileOf, stampMarker } from "./tracker.js";
|
|
14
|
+
/** Exit code: no workstream parsed — the workflow's Failure Path. */
|
|
15
|
+
export const EXIT_NONE = 3;
|
|
16
|
+
const HEADING = /^(#{1,6})\s+(.*?)\s*$/;
|
|
17
|
+
const INLINE = /^\W*(Requires|Covers)\W*:\**\s*(.*)$/i;
|
|
18
|
+
/**
|
|
19
|
+
* Every `### {PREFIX}-{N}: {NAME}` block under the LAST `## {title}` heading (the
|
|
20
|
+
* organise step appends it after a verbatim copy of the design), with the first
|
|
21
|
+
* value line of each `####` subsection. An inline `Requires: [...]` or `Covers: [...]`
|
|
22
|
+
* line directly under the block heading is read too.
|
|
23
|
+
*/
|
|
24
|
+
function sectionBlocks(md, title, prefix) {
|
|
25
|
+
const lines = md.split("\n");
|
|
26
|
+
let start = -1;
|
|
27
|
+
lines.forEach((l, i) => {
|
|
28
|
+
if (new RegExp(`^##\\s+${title}\\s*$`).test(l))
|
|
29
|
+
start = i;
|
|
30
|
+
});
|
|
31
|
+
if (start === -1)
|
|
32
|
+
return [];
|
|
33
|
+
const blockHeading = new RegExp(`^###\\s+${prefix}-(\\d+):\\s*(.*?)\\s*$`);
|
|
34
|
+
const out = [];
|
|
35
|
+
let current;
|
|
36
|
+
/** The `####` subsection the line sits in; undefined directly under the block heading. */
|
|
37
|
+
let sub;
|
|
38
|
+
for (const line of lines.slice(start + 1)) {
|
|
39
|
+
const h = HEADING.exec(line);
|
|
40
|
+
if (h && h[1].length <= 2)
|
|
41
|
+
break;
|
|
42
|
+
const b = blockHeading.exec(line);
|
|
43
|
+
if (b) {
|
|
44
|
+
current = { n: Number(b[1]), name: b[2], fields: {} };
|
|
45
|
+
sub = undefined;
|
|
46
|
+
out.push(current);
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
if (!current)
|
|
50
|
+
continue;
|
|
51
|
+
if (h) {
|
|
52
|
+
sub = h[2].toLowerCase();
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
const inline = sub === undefined ? INLINE.exec(line) : null;
|
|
56
|
+
const key = sub ?? inline?.[1].toLowerCase();
|
|
57
|
+
const value = (sub === undefined ? inline?.[2] : line)?.trim();
|
|
58
|
+
if (key !== undefined && value && current.fields[key] === undefined)
|
|
59
|
+
current.fields[key] = value;
|
|
60
|
+
}
|
|
61
|
+
return out;
|
|
62
|
+
}
|
|
63
|
+
const ids = (text, prefix) => text.match(new RegExp(`${prefix}-\\d+`, "g")) ?? [];
|
|
64
|
+
/** Every `### WS-{N}: {NAME}` block under the last `## Suggested Workstreams`, with its `Requires`. */
|
|
65
|
+
export function parseWorkstreams(md) {
|
|
66
|
+
return sectionBlocks(md, "Suggested Workstreams", "WS").map((b) => {
|
|
67
|
+
const requiresText = b.fields.requires ?? "";
|
|
68
|
+
return {
|
|
69
|
+
id: `WS-${b.n}`,
|
|
70
|
+
n: b.n,
|
|
71
|
+
name: b.name,
|
|
72
|
+
requires: ids(requiresText, "WS"),
|
|
73
|
+
requiresText,
|
|
74
|
+
};
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Every `### P-{N}: {NAME}` block under the last `## Suggested Plans`, with its
|
|
79
|
+
* `Covers` and `Requires`. A design with no plan block yields one plan per
|
|
80
|
+
* workstream: `P-{N}` covers `WS-{N}`, its `Requires` mapped to plan ids.
|
|
81
|
+
*/
|
|
82
|
+
export function parsePlans(md) {
|
|
83
|
+
const plans = sectionBlocks(md, "Suggested Plans", "P").map((b) => {
|
|
84
|
+
const requiresText = b.fields.requires ?? "";
|
|
85
|
+
return {
|
|
86
|
+
id: `P-${b.n}`,
|
|
87
|
+
n: b.n,
|
|
88
|
+
name: b.name,
|
|
89
|
+
covers: ids(b.fields.covers ?? "", "WS"),
|
|
90
|
+
requires: ids(requiresText, "P"),
|
|
91
|
+
requiresText,
|
|
92
|
+
};
|
|
93
|
+
});
|
|
94
|
+
if (plans.length > 0)
|
|
95
|
+
return plans;
|
|
96
|
+
return parseWorkstreams(md).map((w) => ({
|
|
97
|
+
id: `P-${w.n}`,
|
|
98
|
+
n: w.n,
|
|
99
|
+
name: w.name,
|
|
100
|
+
covers: [w.id],
|
|
101
|
+
requires: w.requires.map((r) => r.replace("WS-", "P-")),
|
|
102
|
+
requiresText: w.requiresText.replace(/WS-(\d+)/g, "P-$1"),
|
|
103
|
+
}));
|
|
104
|
+
}
|
|
105
|
+
/** `[]` or `[P-1, P-2]`. */
|
|
106
|
+
export const requiresList = (p) => `[${p.requires.join(", ")}]`;
|
|
107
|
+
/** `WS-1 (Data model), WS-2 (API)`: a plan's covered workstreams with their names. */
|
|
108
|
+
export function coversList(p, ws) {
|
|
109
|
+
return p.covers
|
|
110
|
+
.map((id) => {
|
|
111
|
+
const name = ws.find((w) => w.id === id)?.name;
|
|
112
|
+
return name === undefined ? id : `${id} (${name})`;
|
|
113
|
+
})
|
|
114
|
+
.join(", ");
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* The Step 11 comment: one line per plan with its covered workstreams, the filing
|
|
118
|
+
* line (one issue per plan; a single plan is planned on this issue), then the design
|
|
119
|
+
* doc link.
|
|
120
|
+
*/
|
|
121
|
+
export function commentBody(plans, ws, opts) {
|
|
122
|
+
const doc = `docs/plans/${opts.month}/${opts.fid}-design.md`;
|
|
123
|
+
const url = `https://github.com/${opts.ownerRepo}/blob/dev/${doc}`;
|
|
124
|
+
const filing = plans.length === 1
|
|
125
|
+
? "One plan covers every workstream: plan it on this issue, no new issue."
|
|
126
|
+
: `Filing one issue per plan: put \`**Parent design:** [${opts.fid}-design.md](${url})\` and \`**Workstreams:** {its Covers ids}\` in its body, and list the plan issues it requires in a blocked-by block (.bkit/trackers.md § Issue shapes).`;
|
|
127
|
+
const lines = [
|
|
128
|
+
GENERATED_MARKER,
|
|
129
|
+
"### Step 11 — Suggested Plans",
|
|
130
|
+
"Advisory only. NEVER auto-trigger.",
|
|
131
|
+
...plans.map((p) => `- ${p.id}: ${p.name}. Covers: ${coversList(p, ws)}. Requires: ${requiresList(p)}`),
|
|
132
|
+
filing,
|
|
133
|
+
`[${doc}](${url})`,
|
|
134
|
+
];
|
|
135
|
+
return stampMarker(lines.join("\n"));
|
|
136
|
+
}
|
|
137
|
+
const ARTIFACT_FLAG = {
|
|
138
|
+
name: "artifact",
|
|
139
|
+
type: "string",
|
|
140
|
+
required: true,
|
|
141
|
+
help: "the organised design, docs/plans/{YYYYMM}/logs/{FID}/design-v3-organised.md",
|
|
142
|
+
};
|
|
143
|
+
function read(ctx) {
|
|
144
|
+
const file = path.resolve(ctx.cwd, String(ctx.flags.artifact));
|
|
145
|
+
if (!fs.existsSync(file))
|
|
146
|
+
throw new CommandError(EXIT.USAGE, `--artifact ${file} does not exist`);
|
|
147
|
+
const md = fs.readFileSync(file, "utf-8");
|
|
148
|
+
const workstreams = parseWorkstreams(md);
|
|
149
|
+
if (workstreams.length === 0) {
|
|
150
|
+
throw new CommandError(EXIT_NONE, `no "### WS-{N}: {NAME}" block under "## Suggested Workstreams" in ${file}`);
|
|
151
|
+
}
|
|
152
|
+
return { workstreams, plans: parsePlans(md) };
|
|
153
|
+
}
|
|
154
|
+
export const plansCommand = {
|
|
155
|
+
noun: "plans",
|
|
156
|
+
summary: "Parse the organised design's suggested plans and workstreams and build the advisory comment.",
|
|
157
|
+
verbs: {
|
|
158
|
+
parse: {
|
|
159
|
+
summary: "List each P-{N} with its name, Covers and Requires; one plan per workstream when the design has no Suggested Plans.",
|
|
160
|
+
use: "by-hand",
|
|
161
|
+
flags: [ARTIFACT_FLAG],
|
|
162
|
+
output: {
|
|
163
|
+
plans: "[{id, n, name, covers, requires, requiresText}] in file order",
|
|
164
|
+
workstreams: "[{id, n, name, requires, requiresText}] in file order",
|
|
165
|
+
},
|
|
166
|
+
exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
|
|
167
|
+
run: (ctx) => {
|
|
168
|
+
const { workstreams, plans } = read(ctx);
|
|
169
|
+
ctx.emit({ plans, workstreams });
|
|
170
|
+
return EXIT.OK;
|
|
171
|
+
},
|
|
172
|
+
},
|
|
173
|
+
comment: {
|
|
174
|
+
summary: "The Step 11 comment body for the feature's own issue (posted via MCP by the workflow).",
|
|
175
|
+
use: "workflow",
|
|
176
|
+
flags: [
|
|
177
|
+
ARTIFACT_FLAG,
|
|
178
|
+
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
179
|
+
{ name: "month", type: "string", required: true, help: "YYYYMM bucket of the design doc" },
|
|
180
|
+
{
|
|
181
|
+
name: "owner-repo",
|
|
182
|
+
type: "string",
|
|
183
|
+
required: true,
|
|
184
|
+
help: "owner/repo for the design doc link",
|
|
185
|
+
},
|
|
186
|
+
],
|
|
187
|
+
output: {
|
|
188
|
+
comment: "the comment body",
|
|
189
|
+
commentFile: COMMENT_FILE_OUTPUT,
|
|
190
|
+
plans: "the parsed plans",
|
|
191
|
+
},
|
|
192
|
+
exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
|
|
193
|
+
run: (ctx) => {
|
|
194
|
+
const { workstreams, plans } = read(ctx);
|
|
195
|
+
const body = commentBody(plans, workstreams, {
|
|
196
|
+
ownerRepo: String(ctx.flags.ownerRepo),
|
|
197
|
+
month: String(ctx.flags.month),
|
|
198
|
+
fid: String(ctx.flags.fid),
|
|
199
|
+
});
|
|
200
|
+
ctx.emit({ comment: body, commentFile: commentFileOf(ctx.cwd, body), plans });
|
|
201
|
+
return EXIT.OK;
|
|
202
|
+
},
|
|
203
|
+
},
|
|
204
|
+
},
|
|
205
|
+
};
|
|
@@ -392,9 +392,9 @@ export function devRequiresChecks(gh, repo) {
|
|
|
392
392
|
return gh(["api", `repos/${repo}/branches/dev/protection/required_status_checks`]).ok;
|
|
393
393
|
}
|
|
394
394
|
/**
|
|
395
|
-
* Request a server-side base-into-head refresh
|
|
396
|
-
*
|
|
397
|
-
*
|
|
395
|
+
* Request a server-side base-into-head refresh. GitHub authors the merge commit,
|
|
396
|
+
* so bkit cannot set its message and there is no local head to read back. Ship
|
|
397
|
+
* does not call it: its Step 4 merges origin/dev locally (`branches sync --merge`). gh missing →
|
|
398
398
|
* EXIT.USE_MCP (route through `update_pull_request_branch`).
|
|
399
399
|
*
|
|
400
400
|
* `onlyIfRequired`: refresh only when dev requires status checks. Otherwise the
|
|
@@ -685,6 +685,7 @@ export const prsCommand = {
|
|
|
685
685
|
verbs: {
|
|
686
686
|
open: {
|
|
687
687
|
summary: "Open a PR whose body carries the bkit:issue / bkit:fid marker (exit 80: use MCP).",
|
|
688
|
+
use: "workflow",
|
|
688
689
|
flags: [
|
|
689
690
|
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
690
691
|
{ name: "title", type: "string", required: true, help: "PR title (no skip-CI token)" },
|
|
@@ -742,6 +743,7 @@ export const prsCommand = {
|
|
|
742
743
|
},
|
|
743
744
|
probe: {
|
|
744
745
|
summary: "The open (or open-then-merged) PR for a branch, or one PR by number.",
|
|
746
|
+
use: "by-hand",
|
|
745
747
|
flags: [
|
|
746
748
|
HEAD_FLAG,
|
|
747
749
|
{ name: "base", type: "string", help: "only PRs into this base (default: any base)" },
|
|
@@ -779,6 +781,7 @@ export const prsCommand = {
|
|
|
779
781
|
},
|
|
780
782
|
merge: {
|
|
781
783
|
summary: "Squash-merge a PR with an empty body (skipped when already MERGED) and read its state back.",
|
|
784
|
+
use: "workflow",
|
|
782
785
|
flags: [
|
|
783
786
|
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
784
787
|
{
|
|
@@ -851,6 +854,7 @@ export const prsCommand = {
|
|
|
851
854
|
},
|
|
852
855
|
"update-branch": {
|
|
853
856
|
summary: "Refresh a PR's head from its base server-side (exit 80: use update_pull_request_branch).",
|
|
857
|
+
use: "workflow",
|
|
854
858
|
flags: [
|
|
855
859
|
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
856
860
|
{
|
|
@@ -880,6 +884,7 @@ export const prsCommand = {
|
|
|
880
884
|
},
|
|
881
885
|
checks: {
|
|
882
886
|
summary: "A PR's check rollup, classified: green when present and none failed or pending (exit 80: use MCP).",
|
|
887
|
+
use: "by-hand",
|
|
883
888
|
flags: [{ name: "number", type: "string", required: true, help: "the PR number" }],
|
|
884
889
|
output: {
|
|
885
890
|
number: "the PR number",
|
|
@@ -905,6 +910,7 @@ export const prsCommand = {
|
|
|
905
910
|
},
|
|
906
911
|
"verbose-ci": {
|
|
907
912
|
summary: "Add ` bkit [verbose ci]` to a PR title, or strip it (with an optional `bkit ` prefix); a no-op when already so.",
|
|
913
|
+
use: "workflow",
|
|
908
914
|
flags: [
|
|
909
915
|
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
910
916
|
{ name: "state", type: "string", required: true, help: "on | off" },
|
|
@@ -956,6 +962,7 @@ export const prsCommand = {
|
|
|
956
962
|
},
|
|
957
963
|
"scan-body": {
|
|
958
964
|
summary: "Check a landed commit's body (not its subject) for a CI-suppressing token.",
|
|
965
|
+
use: "by-hand",
|
|
959
966
|
flags: [
|
|
960
967
|
{ name: "sha", type: "string", required: true, help: "the landed commit" },
|
|
961
968
|
{
|
|
@@ -974,6 +981,7 @@ export const prsCommand = {
|
|
|
974
981
|
},
|
|
975
982
|
"cross-check": {
|
|
976
983
|
summary: "An mcp close with gh recorded unavailable must have a transport-fallback row.",
|
|
984
|
+
use: "workflow",
|
|
977
985
|
flags: [
|
|
978
986
|
FILE_FLAG,
|
|
979
987
|
{
|
|
@@ -994,6 +1002,7 @@ export const prsCommand = {
|
|
|
994
1002
|
},
|
|
995
1003
|
"transport-row": {
|
|
996
1004
|
summary: "Append a transport-fallback or close-transport audit row to status.jsonl.",
|
|
1005
|
+
use: "workflow",
|
|
997
1006
|
flags: [
|
|
998
1007
|
FILE_FLAG,
|
|
999
1008
|
{ name: "kind", type: "string", required: true, help: "fallback | close" },
|
|
@@ -119,6 +119,7 @@ export const repoCommand = {
|
|
|
119
119
|
verbs: {
|
|
120
120
|
info: {
|
|
121
121
|
summary: "owner/repo (gh, else the origin remote), the current branch, and commits behind origin/dev.",
|
|
122
|
+
use: "by-hand",
|
|
122
123
|
flags: [
|
|
123
124
|
{
|
|
124
125
|
name: "fetch",
|
|
@@ -154,6 +155,8 @@ export const repoCommand = {
|
|
|
154
155
|
trackerProgress: "the state an issue moves to when work starts: package.json bkit.tracker.<tracker>.progress for the wired tracker, at its default when unset (github `In progress`, linear `started`, jira `In Progress`); null under none",
|
|
155
156
|
trackerReview: "the state an issue moves to when it is handed to a human: package.json bkit.tracker.<tracker>.review for the wired tracker, at its default when unset (github `In review`, linear `In Review`, jira `In Review`); null under none",
|
|
156
157
|
tasks: "{maxPerGroup, maxTestsPerGroup, maxTestsPerTask, maxTestFilesPerTask}: the plan caps from package.json bkit.workflows.tasks, each missing or invalid key at its default",
|
|
158
|
+
buildPublishRemote: "boolean: the remote build ending from package.json bkit.workflows.build.publish.remote; always true, a false value is refused",
|
|
159
|
+
buildPublishLocal: "boolean: the local build ending from package.json bkit.workflows.build.publish.local; true publishes, false holds; true when unset or invalid",
|
|
157
160
|
},
|
|
158
161
|
exitCodes: {
|
|
159
162
|
[EXIT_NO_REPO]: "neither gh nor the origin remote named an owner/repo",
|
|
@@ -207,6 +210,8 @@ export const repoCommand = {
|
|
|
207
210
|
trackerProgress: states?.progress ?? null,
|
|
208
211
|
trackerReview: states?.review ?? null,
|
|
209
212
|
tasks: config.tasks,
|
|
213
|
+
buildPublishRemote: config.buildPublish.remote,
|
|
214
|
+
buildPublishLocal: config.buildPublish.local,
|
|
210
215
|
});
|
|
211
216
|
if (branch === null && ctx.flags.allowDetached !== true) {
|
|
212
217
|
ctx.log("HEAD is detached — no current branch");
|
|
@@ -217,6 +222,7 @@ export const repoCommand = {
|
|
|
217
222
|
},
|
|
218
223
|
preflight: {
|
|
219
224
|
summary: "Advisory: whether gh can read the repo's Actions permissions (dispatch may 403 without them).",
|
|
225
|
+
use: "by-hand",
|
|
220
226
|
flags: [
|
|
221
227
|
{
|
|
222
228
|
name: "owner-repo",
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// a bad ledger or an unwritable board, and never gates the caller's close.
|
|
17
17
|
import * as fs from "node:fs";
|
|
18
18
|
import * as path from "node:path";
|
|
19
|
-
import { SCHEMA, compareTs, mintTs, parse, resolveRepoSlug, validate, } from "../../ledgers/telemetry.js";
|
|
19
|
+
import { SCHEMA, compareTs, mintTs, parse, resolveRepoSlug, validate, withLineage, } from "../../ledgers/telemetry.js";
|
|
20
20
|
import { readBkitVersion } from "../../install/version-file.js";
|
|
21
21
|
import { CommandError, DEV, EXIT, git, parseJson, repoRoot, runGit, } from "../lib.js";
|
|
22
22
|
import { landDir, pushToDev } from "../land.js";
|
|
@@ -39,6 +39,20 @@ export const MARKERS = {
|
|
|
39
39
|
analysisStart: "<!-- bkit:roadmap-analysis start -->",
|
|
40
40
|
analysisEnd: "<!-- bkit:roadmap-analysis end -->",
|
|
41
41
|
};
|
|
42
|
+
/** Title and rules box a new board opens with; the consumer owns both once the file exists. */
|
|
43
|
+
export const SEEDED_HEAD = [
|
|
44
|
+
"# Roadmap",
|
|
45
|
+
"",
|
|
46
|
+
"> [!CAUTION]",
|
|
47
|
+
"> **Purpose:** Phase board of every bkit feature, projected from `.bkit/issues.jsonl`, plus the best-next-step analysis and your notes.",
|
|
48
|
+
">",
|
|
49
|
+
"> **Rules:**",
|
|
50
|
+
">",
|
|
51
|
+
"> - Follow `.bkit/authoring.md` § All Agent-Read Files and § Docs when you edit the parts that are yours.",
|
|
52
|
+
"> - Text above the first marker and the `## Notes` blocks are yours; bkit never overwrites them.",
|
|
53
|
+
"> - Everything between the `bkit:roadmap-status` markers is generated: `bkit roadmap fold` rewrites it on every run, so a hand edit there is lost. Append to `.bkit/issues.jsonl` instead.",
|
|
54
|
+
"> - Everything between the `bkit:roadmap-analysis` markers belongs to `@bkit-utility-update-roadmap`, which rewrites it on every run.",
|
|
55
|
+
].join("\n");
|
|
42
56
|
const ANALYSIS_PLACEHOLDER = "_(no analysis yet; run @bkit-utility-update-roadmap to populate)_";
|
|
43
57
|
const NOTES_PRE_PLACEHOLDER = "## Notes\n\n_(above the bkit list — yours, never overwritten)_";
|
|
44
58
|
const NOTES_POST_PLACEHOLDER = "## Notes\n\n_(end of the board — yours, never overwritten)_";
|
|
@@ -199,7 +213,7 @@ export function foldBoard(p, current, now) {
|
|
|
199
213
|
// never rewrites it. The generated-tables warning lives in the status block,
|
|
200
214
|
// so its wording stays true as the region's rules change.
|
|
201
215
|
if (blank(head))
|
|
202
|
-
head =
|
|
216
|
+
head = SEEDED_HEAD;
|
|
203
217
|
let merge = adopted;
|
|
204
218
|
if (!blank(tail))
|
|
205
219
|
merge = appendNotes(merge, tail);
|
|
@@ -223,11 +237,15 @@ export function foldBoard(p, current, now) {
|
|
|
223
237
|
return { board: `${board}\n`, log };
|
|
224
238
|
}
|
|
225
239
|
const EMPTY = { designed: [], planned: [], built: [], debugged: [], shipped: [] };
|
|
226
|
-
/**
|
|
227
|
-
export
|
|
240
|
+
/** The `_(refreshed …)_` stamp for this moment, to the second. */
|
|
241
|
+
export const refreshStamp = () => new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
242
|
+
/**
|
|
243
|
+
* Re-render `<root>/docs/roadmap.md` from `<root>/.bkit/issues.jsonl`, stamped
|
|
244
|
+
* `now`; never throws for a bad ledger or board.
|
|
245
|
+
*/
|
|
246
|
+
export function foldRoadmap(root, log, now = refreshStamp()) {
|
|
228
247
|
const md = path.join(root, "docs", "roadmap.md");
|
|
229
248
|
const ledger = path.join(root, ".bkit", "issues.jsonl");
|
|
230
|
-
const now = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
231
249
|
let projection = EMPTY;
|
|
232
250
|
let malformed = 0;
|
|
233
251
|
const raw = fs.existsSync(ledger) && fs.statSync(ledger).isFile() ? fs.readFileSync(ledger, "utf-8") : "";
|
|
@@ -292,11 +310,13 @@ function appendLedgerRow(root, row) {
|
|
|
292
310
|
}
|
|
293
311
|
}
|
|
294
312
|
/**
|
|
295
|
-
* Append the feature's roadmap row
|
|
296
|
-
*
|
|
297
|
-
*
|
|
313
|
+
* Append the feature's roadmap row under `root`, then re-render the board stamped
|
|
314
|
+
* `now`. A row built from `workflow` / `fid`, or a `row` without `updates`, gets
|
|
315
|
+
* `firstTs` + `updates` carried forward from the FID's rows already in the ledger;
|
|
316
|
+
* a `row` that carries `updates` (one an earlier call printed) is appended byte
|
|
317
|
+
* for byte. Fail-open: a failed append or render is logged and reported, never thrown.
|
|
298
318
|
*/
|
|
299
|
-
export function appendFeature(root, o, log) {
|
|
319
|
+
export function appendFeature(root, o, log, now = refreshStamp()) {
|
|
300
320
|
let row;
|
|
301
321
|
if (o.row !== undefined) {
|
|
302
322
|
const parsed = parseJson(o.row);
|
|
@@ -318,13 +338,19 @@ export function appendFeature(root, o, log) {
|
|
|
318
338
|
step: o.step ?? `${o.workflow}-close-workflow`,
|
|
319
339
|
});
|
|
320
340
|
}
|
|
341
|
+
const ledger = path.join(root, ".bkit", "issues.jsonl");
|
|
342
|
+
const prior = fs.existsSync(ledger) && fs.statSync(ledger).isFile()
|
|
343
|
+
? parse(fs.readFileSync(ledger, "utf-8")).events
|
|
344
|
+
: [];
|
|
345
|
+
if (o.row === undefined || !("updates" in row))
|
|
346
|
+
row = withLineage(prior, row);
|
|
321
347
|
const check = validate(row);
|
|
322
348
|
if (!check.ok)
|
|
323
349
|
throw new CommandError(EXIT.USAGE, `not a valid feature row: ${check.reason}`);
|
|
324
350
|
const problem = appendLedgerRow(root, row);
|
|
325
351
|
if (problem)
|
|
326
|
-
log(`append failed: ${
|
|
327
|
-
const board = foldRoadmap(root, log);
|
|
352
|
+
log(`append failed: ${ledger} — ${problem}`);
|
|
353
|
+
const board = foldRoadmap(root, log, now);
|
|
328
354
|
return { row, appended: problem === undefined, written: board.written, path: board.path };
|
|
329
355
|
}
|
|
330
356
|
function feature(ctx) {
|
|
@@ -341,17 +367,21 @@ function feature(ctx) {
|
|
|
341
367
|
const ROADMAP_FILES = [".bkit/issues.jsonl", "docs/roadmap.md"];
|
|
342
368
|
/**
|
|
343
369
|
* Build / debug close: append the feature row in the worktree, then land the
|
|
344
|
-
* SAME row on `dev` through a throwaway origin/dev checkout (`pushToDev`).
|
|
345
|
-
*
|
|
346
|
-
*
|
|
347
|
-
*
|
|
370
|
+
* SAME row on `dev` through a throwaway origin/dev checkout (`pushToDev`). Both
|
|
371
|
+
* sides get the row's exact bytes and one shared refresh stamp, so the branch and
|
|
372
|
+
* dev make the same change to `.bkit/issues.jsonl` and `docs/roadmap.md` and the
|
|
373
|
+
* feature PR merges without a conflict on either. The main checkout is never
|
|
374
|
+
* touched. Skipped when the run's own checkout is on dev (the row rides that
|
|
375
|
+
* branch's commit). Fail-open throughout: the feat-side row is already written
|
|
376
|
+
* and reaches dev with ship's merge.
|
|
348
377
|
*/
|
|
349
378
|
async function mirror(ctx) {
|
|
350
379
|
const workflow = String(ctx.flags.workflow);
|
|
351
380
|
const fid = String(ctx.flags.fid);
|
|
352
381
|
const wt = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
|
|
353
382
|
const root = repoRoot(ctx.cwd);
|
|
354
|
-
const
|
|
383
|
+
const now = refreshStamp();
|
|
384
|
+
const feat = appendFeature(wt, { workflow, fid }, ctx.log, now);
|
|
355
385
|
const done = (mirrored, skipped) => {
|
|
356
386
|
if (skipped)
|
|
357
387
|
ctx.log(`skipping the dev-side roadmap mirror — ${skipped} (feat-side row already written)`);
|
|
@@ -368,7 +398,7 @@ async function mirror(ctx) {
|
|
|
368
398
|
dir: landDir(root, fid),
|
|
369
399
|
build: (dir) => {
|
|
370
400
|
committed = "";
|
|
371
|
-
if (!appendFeature(dir, { row: JSON.stringify(feat.row) }, ctx.log).appended) {
|
|
401
|
+
if (!appendFeature(dir, { row: JSON.stringify(feat.row) }, ctx.log, now).appended) {
|
|
372
402
|
committed = "row not appended on dev";
|
|
373
403
|
return;
|
|
374
404
|
}
|
|
@@ -420,6 +450,7 @@ export const roadmapCommand = {
|
|
|
420
450
|
verbs: {
|
|
421
451
|
fold: {
|
|
422
452
|
summary: "Rewrite the status tables; carry notes, analysis and the consumer's head through.",
|
|
453
|
+
use: "by-hand",
|
|
423
454
|
flags: [
|
|
424
455
|
{
|
|
425
456
|
name: "root",
|
|
@@ -437,6 +468,7 @@ export const roadmapCommand = {
|
|
|
437
468
|
},
|
|
438
469
|
feature: {
|
|
439
470
|
summary: "Append the feature's roadmap row to .bkit/issues.jsonl, then re-render the board (fail-open).",
|
|
471
|
+
use: "workflow",
|
|
440
472
|
flags: [
|
|
441
473
|
{
|
|
442
474
|
name: "root",
|
|
@@ -476,6 +508,7 @@ export const roadmapCommand = {
|
|
|
476
508
|
},
|
|
477
509
|
mirror: {
|
|
478
510
|
summary: "Build / debug close: append the feature row in the worktree, then land the same row on dev through a throwaway origin/dev checkout (fail-open).",
|
|
511
|
+
use: "workflow",
|
|
479
512
|
flags: [
|
|
480
513
|
{ name: "workflow", type: "string", required: true, help: "build | debug" },
|
|
481
514
|
{ name: "fid", type: "string", required: true, help: "feature id (the row's key)" },
|