@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -0,0 +1,484 @@
|
|
|
1
|
+
// bkit decisions compose|apply|pending — the build's decision files, from question to ship.
|
|
2
|
+
//
|
|
3
|
+
// A decision file (`docs/plans/{YYYYMM}/logs/{FID}/build-decision-{RUN}-{N}.md`) holds header
|
|
4
|
+
// lines, an optional progress block, then one item per question:
|
|
5
|
+
//
|
|
6
|
+
// **Q{n} — {title}:** {question}
|
|
7
|
+
// Options: A) {A} / B) {B}
|
|
8
|
+
// Recommended: A) {A} — {reason} (a hard blocker: `No recommendation — {why}`)
|
|
9
|
+
// Decision: {answer} — {words} (once decided)
|
|
10
|
+
//
|
|
11
|
+
// `apply --by=headless` takes each recommendation when nobody can or should be asked: an
|
|
12
|
+
// `Accept` is written `Accept (assumed)` and the file says `Status: ASSUMED`. It never writes a
|
|
13
|
+
// `docs/decisions.jsonl` row or a `TEST EXCEPTION`: only the owner's words do. Ship lists the
|
|
14
|
+
// assumed items with `pending`; the owner confirms each (`apply --by=owner --confirm`, which
|
|
15
|
+
// writes the real acceptance) or rejects it, and `pending --defer` writes one `needs-decision`
|
|
16
|
+
// deferral per item nobody confirmed.
|
|
17
|
+
import * as fs from "node:fs";
|
|
18
|
+
import * as path from "node:path";
|
|
19
|
+
import { readJsonFile } from "../../shared/json.js";
|
|
20
|
+
import { CommandError, EXIT, git } from "../lib.js";
|
|
21
|
+
import { loopProgress } from "./counters.js";
|
|
22
|
+
import { appendLedgerRows } from "./ledgers.js";
|
|
23
|
+
import { classifyAt } from "./runtime.js";
|
|
24
|
+
import { positiveInt, str } from "./status.js";
|
|
25
|
+
/** Exit code: `apply --by=headless` left hard blockers (no recommendation) for the owner. */
|
|
26
|
+
export const EXIT_HARD_BLOCKERS = 4;
|
|
27
|
+
const ITEM_SPLIT = /^(?=\*\*Q\d+ — )/m;
|
|
28
|
+
const lineOf = (text, key) => new RegExp(`^${key}:[ \\t]*(.+?)[ \\t]*$`, "m").exec(text)?.[1] ?? null;
|
|
29
|
+
/** Options one item may hold: one per letter, `A` to `Z`. */
|
|
30
|
+
const MAX_OPTIONS = 26;
|
|
31
|
+
/** `A`, `B`, … for option index `i`. */
|
|
32
|
+
const letterAt = (i) => String.fromCharCode(65 + i);
|
|
33
|
+
/** An option entry's leading letter (`A) `) dropped, so a parsed name stays bare. */
|
|
34
|
+
const bareName = (s) => s.replace(/^[A-Z]\)[ \t]*/, "");
|
|
35
|
+
/** A reply opening on an option letter: `B`, `B)`, `B — …`, `B) {option} …`, `B {option} …`. */
|
|
36
|
+
const LETTER_REPLY = /^([A-Za-z])(?:\)|(?=[ \t—:,.-]|$))[ \t]*(?:[—:,.-][ \t]*)?/;
|
|
37
|
+
/**
|
|
38
|
+
* An answer read as the option it names. A leading letter of `options` (either case, with or
|
|
39
|
+
* without `)`) becomes the option it labels: `B`, `B) Reject` and `B — too risky` read as
|
|
40
|
+
* `Reject`, `Reject` and `Reject — too risky`. Any other answer is returned unchanged; with
|
|
41
|
+
* no options known, only a leading `A) ` is dropped.
|
|
42
|
+
*/
|
|
43
|
+
export function optionAnswer(answer, options) {
|
|
44
|
+
if (options.length === 0)
|
|
45
|
+
return bareName(answer);
|
|
46
|
+
const m = LETTER_REPLY.exec(answer);
|
|
47
|
+
const name = m === null ? undefined : options[m[1].toUpperCase().charCodeAt(0) - 65];
|
|
48
|
+
if (m === null || name === undefined)
|
|
49
|
+
return answer;
|
|
50
|
+
const rest = answer.slice(m[0].length);
|
|
51
|
+
if (rest.toLowerCase().startsWith(name.toLowerCase()))
|
|
52
|
+
return name + rest.slice(name.length);
|
|
53
|
+
if (rest === "")
|
|
54
|
+
return name;
|
|
55
|
+
return /[)—:,.-]/.test(m[0]) ? `${name} — ${rest}` : answer;
|
|
56
|
+
}
|
|
57
|
+
/** The option list as it is written: `A) {A} / B) {B}`. */
|
|
58
|
+
const letteredOptions = (options) => options.map((o, i) => `${letterAt(i)}) ${o}`).join(" / ");
|
|
59
|
+
/** The letter `name` holds in `options`, or null when it is not one of them. */
|
|
60
|
+
const letterOf = (options, name) => options.includes(name) ? letterAt(options.indexOf(name)) : null;
|
|
61
|
+
/** The items of a decision file's text, in file order. */
|
|
62
|
+
export function parseDecisionItems(text) {
|
|
63
|
+
return text
|
|
64
|
+
.split(ITEM_SPLIT)
|
|
65
|
+
.slice(1)
|
|
66
|
+
.map((part) => {
|
|
67
|
+
const head = /^\*\*Q(\d+) — (.+?):\*\*/.exec(part);
|
|
68
|
+
const rec = lineOf(part, "Recommended");
|
|
69
|
+
const none = /^No recommendation\b/m.test(part);
|
|
70
|
+
const [option, ...why] = (rec ?? "").split(" — ");
|
|
71
|
+
const options = (lineOf(part, "Options") ?? "")
|
|
72
|
+
.split(" / ")
|
|
73
|
+
.map((o) => bareName(o.trim()))
|
|
74
|
+
.filter(Boolean);
|
|
75
|
+
const answer = lineOf(part, "Decision");
|
|
76
|
+
const decision = answer === null ? null : optionAnswer(answer, options);
|
|
77
|
+
return {
|
|
78
|
+
n: Number(head?.[1] ?? 0),
|
|
79
|
+
title: head?.[2] ?? "",
|
|
80
|
+
text: part.trimEnd(),
|
|
81
|
+
options,
|
|
82
|
+
recommended: none || rec === null ? null : bareName((option ?? "").trim()),
|
|
83
|
+
reason: why.join(" — ").trim(),
|
|
84
|
+
decision,
|
|
85
|
+
assumed: decision !== null && /^Accept \(assumed\)/.test(decision),
|
|
86
|
+
rejected: lineOf(part, "Rejected") !== null,
|
|
87
|
+
deferred: lineOf(part, "Deferred") !== null,
|
|
88
|
+
};
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
/** `Status:` set to `status`. */
|
|
92
|
+
const withStatus = (text, status) => /^Status:.*$/m.test(text)
|
|
93
|
+
? text.replace(/^Status:.*$/m, `Status: ${status}`)
|
|
94
|
+
: `Status: ${status}\n${text}`;
|
|
95
|
+
/** `extra` lines added under item `n`'s last line. */
|
|
96
|
+
function addUnder(text, n, extra, replace) {
|
|
97
|
+
const parts = text.split(ITEM_SPLIT);
|
|
98
|
+
const i = parts.findIndex((p) => p.startsWith(`**Q${n} — `));
|
|
99
|
+
if (i < 0)
|
|
100
|
+
throw new CommandError(EXIT.USAGE, `no Q${n} in the decision file`);
|
|
101
|
+
const body = parts[i].trimEnd().split("\n");
|
|
102
|
+
const kept = replace === undefined ? body : body.filter((l) => !replace.test(l));
|
|
103
|
+
const trail = parts[i].slice(parts[i].trimEnd().length) || "\n\n";
|
|
104
|
+
parts[i] = [...kept, ...extra].join("\n") + trail;
|
|
105
|
+
return parts.join("");
|
|
106
|
+
}
|
|
107
|
+
/** The status a file's items leave it in. */
|
|
108
|
+
function statusOf(items) {
|
|
109
|
+
if (items.some((i) => i.decision === null))
|
|
110
|
+
return "OPEN";
|
|
111
|
+
return items.some((i) => i.assumed && !i.deferred) ? "ASSUMED" : "DECIDED";
|
|
112
|
+
}
|
|
113
|
+
const today = () => new Date().toISOString().slice(0, 10);
|
|
114
|
+
const readText = (file) => {
|
|
115
|
+
if (!fs.existsSync(file))
|
|
116
|
+
throw new CommandError(EXIT.USAGE, `${file} does not exist`);
|
|
117
|
+
return fs.readFileSync(file, "utf-8");
|
|
118
|
+
};
|
|
119
|
+
/** `FID` and run/decision numbers from a `.../logs/{FID}/build-decision-{RUN}-{N}.md` path. */
|
|
120
|
+
function fileRef(file) {
|
|
121
|
+
const fid = path.basename(path.dirname(file));
|
|
122
|
+
const m = /build-decision-(\d+)-(\d+)\.md$/.exec(file);
|
|
123
|
+
return { fid, ref: m ? `run ${m[1]} decision ${m[2]}` : path.basename(file) };
|
|
124
|
+
}
|
|
125
|
+
const slug = (s) => s
|
|
126
|
+
.toLowerCase()
|
|
127
|
+
.replace(/[^a-z0-9]+/g, "-")
|
|
128
|
+
.replace(/^-+|-+$/g, "")
|
|
129
|
+
.slice(0, 60);
|
|
130
|
+
const LOOPS = {
|
|
131
|
+
verify: {
|
|
132
|
+
title: "Verify",
|
|
133
|
+
check: "build-plan-verify",
|
|
134
|
+
fix: "build-plan-gaps-remediate",
|
|
135
|
+
point: "verify",
|
|
136
|
+
},
|
|
137
|
+
tests: {
|
|
138
|
+
title: "Tests",
|
|
139
|
+
check: "build-run-tests",
|
|
140
|
+
fix: "build-failure-diagnose",
|
|
141
|
+
point: "tests",
|
|
142
|
+
},
|
|
143
|
+
};
|
|
144
|
+
function composeItems(raw) {
|
|
145
|
+
if (!Array.isArray(raw))
|
|
146
|
+
throw new CommandError(EXIT.USAGE, "--items must hold a JSON array");
|
|
147
|
+
return raw.map((r, i) => {
|
|
148
|
+
const o = (r ?? {});
|
|
149
|
+
const s = (k) => (typeof o[k] === "string" ? o[k].trim() : "");
|
|
150
|
+
const options = Array.isArray(o.options) ? o.options.filter((x) => typeof x === "string") : [];
|
|
151
|
+
if (s("title") === "" || s("question") === "" || options.length === 0)
|
|
152
|
+
throw new CommandError(EXIT.USAGE, `item ${i + 1}: needs title, question and options`);
|
|
153
|
+
if (options.length > MAX_OPTIONS)
|
|
154
|
+
throw new CommandError(EXIT.USAGE, `item ${i + 1}: at most ${MAX_OPTIONS} options (A-Z)`);
|
|
155
|
+
if (s("noRecommendation") === "" && !options.includes(s("recommended")))
|
|
156
|
+
throw new CommandError(EXIT.USAGE, `item ${i + 1}: recommended must be one of its options, or set noRecommendation`);
|
|
157
|
+
return {
|
|
158
|
+
title: s("title"),
|
|
159
|
+
question: s("question"),
|
|
160
|
+
options: options,
|
|
161
|
+
recommended: s("recommended"),
|
|
162
|
+
reason: s("reason"),
|
|
163
|
+
noRecommendation: s("noRecommendation"),
|
|
164
|
+
};
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
const itemLines = (n, it) => {
|
|
168
|
+
const rec = it.recommended ?? "";
|
|
169
|
+
const letter = letterOf(it.options, rec);
|
|
170
|
+
return [
|
|
171
|
+
`**Q${n} — ${it.title}:** ${it.question}`,
|
|
172
|
+
`Options: ${letteredOptions(it.options)}`,
|
|
173
|
+
it.noRecommendation
|
|
174
|
+
? `No recommendation — ${it.noRecommendation}`
|
|
175
|
+
: `Recommended: ${letter === null ? rec : `${letter}) ${rec}`} — ${it.reason || "the orchestrator's call"}`,
|
|
176
|
+
];
|
|
177
|
+
};
|
|
178
|
+
// ---------------------------------------------------------------------------
|
|
179
|
+
// apply
|
|
180
|
+
// ---------------------------------------------------------------------------
|
|
181
|
+
/** Each undecided item's recommendation written in; hard blockers left for the owner. */
|
|
182
|
+
export function applyRecommendations(text, runtime, why) {
|
|
183
|
+
const items = parseDecisionItems(text);
|
|
184
|
+
const loopItem = items.find((i) => i.options.includes("Try again"));
|
|
185
|
+
const loop = loopItem?.decision?.split(" — ")[0] ?? loopItem?.recommended ?? null;
|
|
186
|
+
const applied = [];
|
|
187
|
+
const hardBlockers = [];
|
|
188
|
+
let out = text;
|
|
189
|
+
for (const it of items) {
|
|
190
|
+
if (it.decision !== null)
|
|
191
|
+
continue;
|
|
192
|
+
// `Try again` settles the loop alone; the items wait for the next round.
|
|
193
|
+
if (it !== loopItem && loop === "Try again")
|
|
194
|
+
continue;
|
|
195
|
+
if (it.recommended === null) {
|
|
196
|
+
hardBlockers.push(it.n);
|
|
197
|
+
continue;
|
|
198
|
+
}
|
|
199
|
+
const line = it.recommended === "Accept"
|
|
200
|
+
? `Decision: Accept (assumed) — ${it.reason} (${why}, ${runtime}, ${today()})`
|
|
201
|
+
: `Decision: ${it.recommended} — recommended; applied without asking (${runtime})`;
|
|
202
|
+
out = addUnder(out, it.n, [line]);
|
|
203
|
+
applied.push(it.n);
|
|
204
|
+
}
|
|
205
|
+
out = withStatus(out, statusOf(parseDecisionItems(out)));
|
|
206
|
+
return { text: out, applied, hardBlockers, loop };
|
|
207
|
+
}
|
|
208
|
+
/** The `decision` row an owner's confirmation writes. */
|
|
209
|
+
function decisionRow(file, it, reason) {
|
|
210
|
+
const { fid, ref } = fileRef(file);
|
|
211
|
+
return {
|
|
212
|
+
kind: "decision",
|
|
213
|
+
key: `${slug(fid)}-accepted-${slug(it.title)}`,
|
|
214
|
+
by: { workflow: "ship", step: "ship-confirm-decisions" },
|
|
215
|
+
references: [fid, file],
|
|
216
|
+
summary: `${fid}: ${it.title} accepted (${ref}, confirmed at ship)`,
|
|
217
|
+
rationale: `accepted by owner: ${reason}`,
|
|
218
|
+
status: "ACTIVE",
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
/** The `deferral` row an unconfirmed assumed item becomes. */
|
|
222
|
+
function deferralRow(file, it) {
|
|
223
|
+
const { fid, ref } = fileRef(file);
|
|
224
|
+
const severity = /\b(CRITICAL|HIGH|MEDIUM|LOW)\b/.exec(it.text)?.[1] ?? "MEDIUM";
|
|
225
|
+
return {
|
|
226
|
+
kind: "deferral",
|
|
227
|
+
key: `${slug(fid)}-assumed-${slug(it.title)}`,
|
|
228
|
+
by: { workflow: "ship", step: "ship-confirm-decisions" },
|
|
229
|
+
references: [fid, file],
|
|
230
|
+
type: "issue",
|
|
231
|
+
category: "other",
|
|
232
|
+
severity,
|
|
233
|
+
reason: "needs-decision",
|
|
234
|
+
summary: `${fid}: ${it.title} accepted without the owner (${ref})`,
|
|
235
|
+
description: `Decision needed: accept or fix "${it.title}". Options: ${letteredOptions(it.options)}. ${it.rejected ? "The owner rejected the assumed accept at ship." : "Nobody confirmed the assumed accept before the merge."} Item: ${it.text.split("\n")[0]}`,
|
|
236
|
+
status: "OPEN",
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
/** Every `build-decision-*.md` under `logDir`, in name order. */
|
|
240
|
+
function decisionFiles(logDir) {
|
|
241
|
+
return fs.existsSync(logDir)
|
|
242
|
+
? fs
|
|
243
|
+
.readdirSync(logDir)
|
|
244
|
+
.filter((f) => /^build-decision-\d+-\d+\.md$/.test(f))
|
|
245
|
+
.sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))
|
|
246
|
+
.map((f) => path.join(logDir, f))
|
|
247
|
+
: [];
|
|
248
|
+
}
|
|
249
|
+
const root = (cwd, flag) => path.resolve(cwd, str(flag) ?? git(cwd, ["rev-parse", "--show-toplevel"]) ?? ".");
|
|
250
|
+
// ---------------------------------------------------------------------------
|
|
251
|
+
// Command
|
|
252
|
+
// ---------------------------------------------------------------------------
|
|
253
|
+
export const decisionsCommand = {
|
|
254
|
+
noun: "decisions",
|
|
255
|
+
summary: "Build decision files: write questions, apply recommendations, list assumed items.",
|
|
256
|
+
verbs: {
|
|
257
|
+
compose: {
|
|
258
|
+
summary: "Write a decision file in the one question layout, with loop progress when asked.",
|
|
259
|
+
use: "workflow",
|
|
260
|
+
flags: [
|
|
261
|
+
{ name: "out", type: "string", required: true, help: "the decision file to write" },
|
|
262
|
+
{
|
|
263
|
+
name: "header",
|
|
264
|
+
type: "string",
|
|
265
|
+
repeatable: true,
|
|
266
|
+
help: "Key=Value header line (Status: OPEN is written first)",
|
|
267
|
+
},
|
|
268
|
+
{
|
|
269
|
+
name: "items",
|
|
270
|
+
type: "string",
|
|
271
|
+
help: "JSON file: [{title, question, options, recommended, reason} | {…, noRecommendation}]",
|
|
272
|
+
},
|
|
273
|
+
{
|
|
274
|
+
name: "loop",
|
|
275
|
+
type: "string",
|
|
276
|
+
help: "verify | tests: add the progress block and the loop question as Q1",
|
|
277
|
+
},
|
|
278
|
+
{ name: "file", type: "string", help: "status.jsonl, with --loop" },
|
|
279
|
+
{ name: "group", type: "string", help: "with --loop=verify: the task group" },
|
|
280
|
+
{ name: "attempt", type: "string", help: "with --loop: the attempt just failed" },
|
|
281
|
+
{ name: "max", type: "string", help: "with --loop: the point's maxAttempts" },
|
|
282
|
+
],
|
|
283
|
+
output: {
|
|
284
|
+
file: "the decision file written",
|
|
285
|
+
questions: "number of questions",
|
|
286
|
+
loopRecommended: "Try again | Decide (with --loop), else null",
|
|
287
|
+
},
|
|
288
|
+
run: (ctx) => {
|
|
289
|
+
const out = path.resolve(ctx.cwd, String(ctx.flags.out));
|
|
290
|
+
const headers = (ctx.flags.header ?? []).map((h) => {
|
|
291
|
+
const eq = h.indexOf("=");
|
|
292
|
+
if (eq <= 0)
|
|
293
|
+
throw new CommandError(EXIT.USAGE, `--header ${h}: must be Key=Value`);
|
|
294
|
+
return `${h.slice(0, eq)}: ${h.slice(eq + 1)}`;
|
|
295
|
+
});
|
|
296
|
+
let items = [];
|
|
297
|
+
if (ctx.flags.items !== undefined) {
|
|
298
|
+
const read = readJsonFile(path.resolve(ctx.cwd, String(ctx.flags.items)));
|
|
299
|
+
if (!read.ok)
|
|
300
|
+
throw new CommandError(EXIT.USAGE, "--items is missing or not JSON");
|
|
301
|
+
items = composeItems(read.value);
|
|
302
|
+
}
|
|
303
|
+
const lines = ["Status: OPEN", ...headers.filter((h) => !h.startsWith("Status:")), ""];
|
|
304
|
+
let loopRecommended = null;
|
|
305
|
+
const loopName = str(ctx.flags.loop);
|
|
306
|
+
if (loopName !== undefined) {
|
|
307
|
+
const loop = LOOPS[loopName];
|
|
308
|
+
if (loop === undefined)
|
|
309
|
+
throw new CommandError(EXIT.USAGE, "--loop must be verify or tests");
|
|
310
|
+
if (ctx.flags.file === undefined)
|
|
311
|
+
throw new CommandError(EXIT.USAGE, "--loop needs --file");
|
|
312
|
+
const p = loopProgress(path.resolve(ctx.cwd, String(ctx.flags.file)), ctx.cwd, "build", loop.check, loop.fix, positiveInt(ctx.flags.group, "group"));
|
|
313
|
+
const attempt = str(ctx.flags.attempt) ?? String(p.rounds.length);
|
|
314
|
+
const max = str(ctx.flags.max) ?? "?";
|
|
315
|
+
const changed = p.codeChanged === null ? "unknown" : p.codeChanged ? "yes" : "no";
|
|
316
|
+
const trendLine = {
|
|
317
|
+
"first-round": "This was the first round, so there is no trend yet.",
|
|
318
|
+
closing: "Fewer problems after each round, and the code changed.",
|
|
319
|
+
stuck: "No fewer problems, or the code did not change.",
|
|
320
|
+
worse: "More problems than the first round.",
|
|
321
|
+
}[p.trend];
|
|
322
|
+
loopRecommended = p.recommend === "stop" ? "Decide" : "Try again";
|
|
323
|
+
lines.push(`build ${loop.point}: attempt ${attempt} of ${max}`, "", "## Progress", "", `Problems after each round: ${p.counts || "none recorded"}`, `Code changed: ${changed}`, `Strategy: ${p.lastStrategy ?? "none"} → next ${p.nextStrategy}${p.finalSpent ? " (FINAL already used)" : ""}`, `Minutes per round: ${p.minutesPerRound ?? "unknown"}`, `Trend: ${p.trend}`, "", ...itemLines(1, {
|
|
324
|
+
title: loop.title,
|
|
325
|
+
question: loopRecommended === "Try again"
|
|
326
|
+
? `another fix round? ${trendLine}`
|
|
327
|
+
: `decide the items below instead of another round? ${trendLine}`,
|
|
328
|
+
options: items.length > 0 ? ["Try again", "Decide"] : ["Try again", "Stop"],
|
|
329
|
+
recommended: items.length > 0 || loopRecommended === "Try again" ? loopRecommended : "Stop",
|
|
330
|
+
reason: loopRecommended === "Try again"
|
|
331
|
+
? "the last round made progress"
|
|
332
|
+
: "another round is unlikely to close the remaining items",
|
|
333
|
+
}), "");
|
|
334
|
+
if (items.length === 0 && loopRecommended === "Decide")
|
|
335
|
+
loopRecommended = "Stop";
|
|
336
|
+
}
|
|
337
|
+
const first = loopName === undefined ? 1 : 2;
|
|
338
|
+
items.forEach((it, i) => lines.push(...itemLines(first + i, it), ""));
|
|
339
|
+
lines.push('Reply per question. "yes" takes every recommendation. "stop" writes a handover; the run can be resumed.', "");
|
|
340
|
+
fs.mkdirSync(path.dirname(out), { recursive: true });
|
|
341
|
+
fs.writeFileSync(out, lines.join("\n"), "utf-8");
|
|
342
|
+
ctx.emit({
|
|
343
|
+
file: path.relative(ctx.cwd, out),
|
|
344
|
+
questions: items.length + (loopName === undefined ? 0 : 1),
|
|
345
|
+
loopRecommended,
|
|
346
|
+
});
|
|
347
|
+
return EXIT.OK;
|
|
348
|
+
},
|
|
349
|
+
},
|
|
350
|
+
apply: {
|
|
351
|
+
summary: "Settle a decision file's items: --by=headless takes each recommendation; --by=owner confirms or rejects one assumed item.",
|
|
352
|
+
use: "workflow",
|
|
353
|
+
flags: [
|
|
354
|
+
{ name: "file", type: "string", required: true, help: "the decision file" },
|
|
355
|
+
{ name: "by", type: "string", required: true, help: "headless | owner" },
|
|
356
|
+
{ name: "q", type: "string", help: "--by=owner: the question number" },
|
|
357
|
+
{ name: "confirm", type: "boolean", help: "--by=owner: confirm the assumed Accept" },
|
|
358
|
+
{ name: "reject", type: "boolean", help: "--by=owner: reject the assumed Accept" },
|
|
359
|
+
{ name: "reason", type: "string", help: "--by=owner: the owner's words" },
|
|
360
|
+
{
|
|
361
|
+
name: "root",
|
|
362
|
+
type: "string",
|
|
363
|
+
help: "--by=owner: the checkout the ledgers live in (default: the repo top)",
|
|
364
|
+
},
|
|
365
|
+
],
|
|
366
|
+
output: {
|
|
367
|
+
status: "the file's Status after the call: OPEN | ASSUMED | DECIDED",
|
|
368
|
+
applied: "--by=headless: question numbers settled on their recommendation",
|
|
369
|
+
hardBlockers: "--by=headless: question numbers with no recommendation, left for the owner",
|
|
370
|
+
loop: "--by=headless: the loop answer (Try again | Decide | Stop), or null",
|
|
371
|
+
fixNow: "--by=headless: question numbers settled as Fix now",
|
|
372
|
+
decisionKey: "--by=owner --confirm: key of the decision row written",
|
|
373
|
+
},
|
|
374
|
+
exitCodes: {
|
|
375
|
+
[EXIT_HARD_BLOCKERS]: "--by=headless: hard blockers remain (headless → Failure Path; a session asks them)",
|
|
376
|
+
},
|
|
377
|
+
run: (ctx) => {
|
|
378
|
+
const file = path.resolve(ctx.cwd, String(ctx.flags.file));
|
|
379
|
+
const text = readText(file);
|
|
380
|
+
const by = String(ctx.flags.by);
|
|
381
|
+
if (by === "headless") {
|
|
382
|
+
const runtime = classifyAt(ctx.cwd);
|
|
383
|
+
const r = applyRecommendations(text, runtime, runtime === "GITHUB_ACTION" ? "headless" : "ask:false");
|
|
384
|
+
fs.writeFileSync(file, r.text, "utf-8");
|
|
385
|
+
const after = parseDecisionItems(r.text);
|
|
386
|
+
ctx.emit({
|
|
387
|
+
status: /^Status:[ \t]*(\S+)/m.exec(r.text)?.[1] ?? "OPEN",
|
|
388
|
+
applied: r.applied,
|
|
389
|
+
hardBlockers: r.hardBlockers,
|
|
390
|
+
loop: r.loop,
|
|
391
|
+
fixNow: after.filter((i) => i.decision?.startsWith("Fix now")).map((i) => i.n),
|
|
392
|
+
});
|
|
393
|
+
if (r.hardBlockers.length > 0)
|
|
394
|
+
ctx.log(`hard blockers need the owner: Q${r.hardBlockers.join(", Q")}`);
|
|
395
|
+
return r.hardBlockers.length > 0 ? EXIT_HARD_BLOCKERS : EXIT.OK;
|
|
396
|
+
}
|
|
397
|
+
if (by !== "owner")
|
|
398
|
+
throw new CommandError(EXIT.USAGE, "--by must be headless or owner");
|
|
399
|
+
const n = positiveInt(ctx.flags.q, "q");
|
|
400
|
+
const reason = str(ctx.flags.reason);
|
|
401
|
+
if (n === undefined ||
|
|
402
|
+
reason === undefined ||
|
|
403
|
+
(ctx.flags.confirm === true) === (ctx.flags.reject === true))
|
|
404
|
+
throw new CommandError(EXIT.USAGE, "--by=owner needs --q, --reason and one of --confirm / --reject");
|
|
405
|
+
const it = parseDecisionItems(text).find((i) => i.n === n);
|
|
406
|
+
if (it === undefined || !it.assumed)
|
|
407
|
+
throw new CommandError(EXIT.USAGE, `Q${n} is not an assumed Accept in ${path.basename(file)}`);
|
|
408
|
+
let out;
|
|
409
|
+
let decisionKey = null;
|
|
410
|
+
if (ctx.flags.confirm === true) {
|
|
411
|
+
const row = decisionRow(path.relative(root(ctx.cwd, ctx.flags.root), file), it, reason);
|
|
412
|
+
appendLedgerRows(root(ctx.cwd, ctx.flags.root), "decisions", [row]);
|
|
413
|
+
decisionKey = String(row.key);
|
|
414
|
+
out = addUnder(text, n, [`Decision: Accept — ${reason} (owner, confirmed at ship, ${today()})`], /^(Decision|Rejected):/);
|
|
415
|
+
}
|
|
416
|
+
else {
|
|
417
|
+
out = addUnder(text, n, [`Rejected: ${reason} (owner, ${today()})`], /^Rejected:/);
|
|
418
|
+
}
|
|
419
|
+
out = withStatus(out, statusOf(parseDecisionItems(out)));
|
|
420
|
+
fs.writeFileSync(file, out, "utf-8");
|
|
421
|
+
ctx.emit({ status: /^Status:[ \t]*(\S+)/m.exec(out)?.[1] ?? "OPEN", decisionKey });
|
|
422
|
+
return EXIT.OK;
|
|
423
|
+
},
|
|
424
|
+
},
|
|
425
|
+
pending: {
|
|
426
|
+
summary: "List the feature's assumed Accepts nobody confirmed; --defer writes one needs-decision deferral per item.",
|
|
427
|
+
use: "workflow",
|
|
428
|
+
flags: [
|
|
429
|
+
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
430
|
+
{ name: "month", type: "string", required: true, help: "YYYYMM of the feature's logs" },
|
|
431
|
+
{
|
|
432
|
+
name: "root",
|
|
433
|
+
type: "string",
|
|
434
|
+
help: "the checkout the plans and ledgers live in (default: the repo top)",
|
|
435
|
+
},
|
|
436
|
+
{
|
|
437
|
+
name: "defer",
|
|
438
|
+
type: "boolean",
|
|
439
|
+
help: "write a deferral row per listed item and mark it Deferred",
|
|
440
|
+
},
|
|
441
|
+
],
|
|
442
|
+
output: {
|
|
443
|
+
items: "[{file, q, title, reason, state: pending|rejected}]",
|
|
444
|
+
count: "items listed",
|
|
445
|
+
deferred: "--defer: deferral keys written",
|
|
446
|
+
},
|
|
447
|
+
run: (ctx) => {
|
|
448
|
+
const top = root(ctx.cwd, ctx.flags.root);
|
|
449
|
+
const month = String(ctx.flags.month);
|
|
450
|
+
if (!/^[0-9]{6}$/.test(month))
|
|
451
|
+
throw new CommandError(EXIT.USAGE, "--month must be YYYYMM");
|
|
452
|
+
const logDir = path.join(top, "docs", "plans", month, "logs", String(ctx.flags.fid));
|
|
453
|
+
const items = [];
|
|
454
|
+
const rows = [];
|
|
455
|
+
for (const abs of decisionFiles(logDir)) {
|
|
456
|
+
const rel = path.relative(top, abs);
|
|
457
|
+
let text = fs.readFileSync(abs, "utf-8");
|
|
458
|
+
for (const it of parseDecisionItems(text)) {
|
|
459
|
+
if (!it.assumed || it.deferred)
|
|
460
|
+
continue;
|
|
461
|
+
items.push({
|
|
462
|
+
file: rel,
|
|
463
|
+
q: it.n,
|
|
464
|
+
title: it.title,
|
|
465
|
+
reason: it.reason,
|
|
466
|
+
state: it.rejected ? "rejected" : "pending",
|
|
467
|
+
});
|
|
468
|
+
if (ctx.flags.defer === true) {
|
|
469
|
+
rows.push(deferralRow(rel, it));
|
|
470
|
+
text = addUnder(text, it.n, [`Deferred: needs-decision (${today()})`]);
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
if (ctx.flags.defer === true) {
|
|
474
|
+
text = withStatus(text, statusOf(parseDecisionItems(text)));
|
|
475
|
+
fs.writeFileSync(abs, text, "utf-8");
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
const deferred = rows.length > 0 ? appendLedgerRows(top, "deferrals", rows).keys : [];
|
|
479
|
+
ctx.emit({ items, count: items.length, deferred });
|
|
480
|
+
return EXIT.OK;
|
|
481
|
+
},
|
|
482
|
+
},
|
|
483
|
+
},
|
|
484
|
+
};
|