@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
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
import {
|
|
2
|
+
parseFindings,
|
|
3
|
+
mergeFindings,
|
|
4
|
+
normalizeLocation,
|
|
5
|
+
lowDeferralKey,
|
|
6
|
+
type Finding,
|
|
7
|
+
} from "./challenge.js";
|
|
8
|
+
import type { PlanTaskBlock } from "./plan-blocks.js";
|
|
9
|
+
import type { SummaryInput } from "./summary.js";
|
|
10
|
+
import { parseDecisionItems } from "./decisions.js";
|
|
11
|
+
|
|
12
|
+
type Row = Record<string, unknown>;
|
|
13
|
+
type Task = PlanTaskBlock & { path: string };
|
|
14
|
+
|
|
15
|
+
const artifacts = (row: Row): string[] =>
|
|
16
|
+
Array.isArray(row.artifacts)
|
|
17
|
+
? row.artifacts.filter((p): p is string => typeof p === "string")
|
|
18
|
+
: [];
|
|
19
|
+
|
|
20
|
+
/** The latest assessment must cover this task, after its finding and last execution. */
|
|
21
|
+
export function taskVerified(input: SummaryInput, task: Task, after: number): boolean {
|
|
22
|
+
const assessments = input.rows
|
|
23
|
+
.map((row, index) => ({ row, index }))
|
|
24
|
+
.filter(
|
|
25
|
+
({ row }) =>
|
|
26
|
+
row.type === "step-done" && row.step === "build-plan-verify" && row.group === task.group,
|
|
27
|
+
);
|
|
28
|
+
const latest = assessments.at(-1);
|
|
29
|
+
if (
|
|
30
|
+
!task.done ||
|
|
31
|
+
latest === undefined ||
|
|
32
|
+
latest.index <= after ||
|
|
33
|
+
latest.row.verdict !== "PASS" ||
|
|
34
|
+
(latest.row.failures !== undefined && latest.row.failures !== 0)
|
|
35
|
+
)
|
|
36
|
+
return false;
|
|
37
|
+
if (
|
|
38
|
+
input.rows
|
|
39
|
+
.slice(latest.index + 1)
|
|
40
|
+
.some(
|
|
41
|
+
(r) =>
|
|
42
|
+
r.type === "step-done" &&
|
|
43
|
+
r.group === task.group &&
|
|
44
|
+
(r.step === "build-plan-tasks" || r.step === "build-plan-gaps-remediate"),
|
|
45
|
+
)
|
|
46
|
+
)
|
|
47
|
+
return false;
|
|
48
|
+
return artifacts(latest.row).some((p) => {
|
|
49
|
+
const header = (input.read(p) ?? "").split("<!-- verdict:end -->")[0]!;
|
|
50
|
+
const numbers =
|
|
51
|
+
/^Tasks:[ \t]*(.*)$/m
|
|
52
|
+
.exec(header)?.[1]
|
|
53
|
+
?.split(",")
|
|
54
|
+
.map((n) => Number(n.trim())) ?? [];
|
|
55
|
+
return /^Verdict:[ \t]*PASS[ \t]*$/m.test(header) && numbers.includes(task.task);
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export interface ChallengeResolution {
|
|
60
|
+
resolved: string[];
|
|
61
|
+
failures: string[];
|
|
62
|
+
concerns: string[];
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** Unreadable or incomplete evidence leaves the recorded assessment unresolved. */
|
|
66
|
+
export function challengeResolution(
|
|
67
|
+
input: SummaryInput,
|
|
68
|
+
row: Row,
|
|
69
|
+
index: number,
|
|
70
|
+
tasks: Task[],
|
|
71
|
+
): ChallengeResolution | undefined {
|
|
72
|
+
const paths = artifacts(row);
|
|
73
|
+
const round = row.round;
|
|
74
|
+
if (paths.length === 0 || typeof round !== "number") return undefined;
|
|
75
|
+
const later = input.rows
|
|
76
|
+
.slice(index + 1)
|
|
77
|
+
.filter((r) => r.type === "step-done" && r.step === "build-challenge");
|
|
78
|
+
if (
|
|
79
|
+
row.challengeFindings === undefined &&
|
|
80
|
+
later.some((r) => artifacts(r).some((p) => paths.includes(p)))
|
|
81
|
+
) {
|
|
82
|
+
const latest = later.at(-1)!;
|
|
83
|
+
const roundTasks = tasks.filter((t) =>
|
|
84
|
+
(/\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? []).includes(
|
|
85
|
+
round,
|
|
86
|
+
),
|
|
87
|
+
);
|
|
88
|
+
if (
|
|
89
|
+
latest.verdict !== "PASS" ||
|
|
90
|
+
!paths.every((p) => artifacts(latest).includes(p)) ||
|
|
91
|
+
roundTasks.length === 0 ||
|
|
92
|
+
!roundTasks.every((t) => taskVerified(input, t, index))
|
|
93
|
+
)
|
|
94
|
+
return undefined;
|
|
95
|
+
return {
|
|
96
|
+
resolved: [
|
|
97
|
+
`build-challenge round ${round}, resolved by build-plan-verify and the later passing challenge covering the same reports`,
|
|
98
|
+
],
|
|
99
|
+
failures: [],
|
|
100
|
+
concerns: [],
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
let findings: Pick<Finding, "severity" | "location" | "title">[];
|
|
104
|
+
if (row.challengeFindings !== undefined) {
|
|
105
|
+
const snapshot = row.challengeFindings;
|
|
106
|
+
if (
|
|
107
|
+
!Array.isArray(snapshot) ||
|
|
108
|
+
!snapshot.every(
|
|
109
|
+
(f): f is Pick<Finding, "severity" | "location" | "title"> =>
|
|
110
|
+
f !== null &&
|
|
111
|
+
typeof f === "object" &&
|
|
112
|
+
["CRITICAL", "HIGH", "MEDIUM", "LOW"].includes(String(f.severity)) &&
|
|
113
|
+
typeof f.location === "string" &&
|
|
114
|
+
typeof f.title === "string",
|
|
115
|
+
)
|
|
116
|
+
)
|
|
117
|
+
return undefined;
|
|
118
|
+
findings = snapshot;
|
|
119
|
+
} else {
|
|
120
|
+
const reports = paths.map((p) => input.read(p));
|
|
121
|
+
if (reports.some((t) => t === null)) return undefined;
|
|
122
|
+
try {
|
|
123
|
+
findings = mergeFindings(
|
|
124
|
+
reports.map((t, i) => parseFindings(t!, paths[i]!, input.root ?? process.cwd())),
|
|
125
|
+
new Set(),
|
|
126
|
+
).findings;
|
|
127
|
+
} catch (error) {
|
|
128
|
+
return {
|
|
129
|
+
resolved: [],
|
|
130
|
+
failures: row.verdict === "FAIL" ? [`build-challenge FAIL: ${String(error)}`] : [],
|
|
131
|
+
concerns: row.verdict === "CONCERNS" ? [`build-challenge CONCERNS: ${String(error)}`] : [],
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
if (findings.length === 0) return undefined;
|
|
136
|
+
const result: ChallengeResolution = { resolved: [], failures: [], concerns: [] };
|
|
137
|
+
for (const f of findings) {
|
|
138
|
+
const matches = tasks.filter((t) => {
|
|
139
|
+
const location = /\*\*Location:\*\*\s*([^\n·]+)/.exec(t.text)?.[1];
|
|
140
|
+
const severity = /\*\*Severity:\*\*\s*(\w+)/.exec(t.text)?.[1];
|
|
141
|
+
const rounds = /\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? [];
|
|
142
|
+
return (
|
|
143
|
+
location !== undefined &&
|
|
144
|
+
normalizeLocation(location, input.root ?? process.cwd()) === f.location &&
|
|
145
|
+
severity === f.severity &&
|
|
146
|
+
rounds.includes(round)
|
|
147
|
+
);
|
|
148
|
+
});
|
|
149
|
+
const label = `build-challenge round ${round}: ${f.severity} ${f.location}`;
|
|
150
|
+
const accepted = input.decisionFiles.some((p) =>
|
|
151
|
+
parseDecisionItems(input.read(p) ?? "").some(
|
|
152
|
+
(item) =>
|
|
153
|
+
/^Accept\b/.test(item.decision ?? "") &&
|
|
154
|
+
[...item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)].some(
|
|
155
|
+
(m) => normalizeLocation(m[0], input.root ?? process.cwd()) === f.location,
|
|
156
|
+
),
|
|
157
|
+
),
|
|
158
|
+
);
|
|
159
|
+
const closed =
|
|
160
|
+
f.severity === "LOW" &&
|
|
161
|
+
input.deferrals.some(
|
|
162
|
+
(d) =>
|
|
163
|
+
d.status === "CLOSED" &&
|
|
164
|
+
d.key === lowDeferralKey(input.fid, f.location) &&
|
|
165
|
+
typeof d.source === "string" &&
|
|
166
|
+
normalizeLocation(d.source, input.root ?? process.cwd()) === f.location,
|
|
167
|
+
);
|
|
168
|
+
if (accepted) result.concerns.push(`${label}, accepted limitation`);
|
|
169
|
+
else if (closed) result.resolved.push(`${label}, resolved by closed deferral`);
|
|
170
|
+
else if (matches.length === 1 && taskVerified(input, matches[0]!, index))
|
|
171
|
+
result.resolved.push(
|
|
172
|
+
`${label}, resolved by build-plan-verify (group ${matches[0]!.group}, task ${matches[0]!.task})`,
|
|
173
|
+
);
|
|
174
|
+
else (f.severity === "CRITICAL" ? result.failures : result.concerns).push(label);
|
|
175
|
+
}
|
|
176
|
+
return result;
|
|
177
|
+
}
|
|
@@ -3,10 +3,11 @@
|
|
|
3
3
|
// its log files, the plan and the ledger rows it added. Pure: the caller reads the
|
|
4
4
|
// disk and passes `read` for the log files.
|
|
5
5
|
|
|
6
|
-
import type
|
|
6
|
+
import { coversList, type Plan, type Workstream } from "./plans.js";
|
|
7
7
|
import { issueIdOf, type FidTracker } from "./fids.js";
|
|
8
8
|
import { parseDecisionItems } from "./decisions.js";
|
|
9
9
|
import { parsePlanBlocks } from "./plan-blocks.js";
|
|
10
|
+
import { challengeResolution, taskVerified } from "./summary-findings.js";
|
|
10
11
|
|
|
11
12
|
export const SUMMARY_WORKFLOWS = ["plan", "design", "build", "debug", "ship"] as const;
|
|
12
13
|
export type SummaryWorkflow = (typeof SUMMARY_WORKFLOWS)[number];
|
|
@@ -59,15 +60,14 @@ export function refOf(fid: string, tracker: FidTracker = "any"): string | undefi
|
|
|
59
60
|
}
|
|
60
61
|
|
|
61
62
|
/**
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
* (`build-plan-execute`) or by a Decision Pause (`build-decision`).
|
|
63
|
+
* Review updates cover their review's findings. Group verification covers failed
|
|
64
|
+
* execution, but does not cover a remediation agent's separate warnings or flakes.
|
|
65
65
|
*/
|
|
66
|
-
const
|
|
66
|
+
const RESOLVED_BY: Readonly<Record<string, readonly string[]>> = {
|
|
67
67
|
"plan/plan-review": ["plan-apply-review"],
|
|
68
68
|
"design/design-review": ["design-apply-review"],
|
|
69
|
-
"
|
|
70
|
-
"build/build-
|
|
69
|
+
"build/build-plan-tasks": ["build-plan-verify"],
|
|
70
|
+
"build/build-plan-gaps-remediate": ["build-plan-verify"],
|
|
71
71
|
};
|
|
72
72
|
|
|
73
73
|
const RUN_TESTS = new Set(["build-run-tests", "debug-run-tests"]);
|
|
@@ -77,6 +77,8 @@ const TEST_EXCEPTION = "**TEST EXCEPTION:**";
|
|
|
77
77
|
type Row = Record<string, unknown>;
|
|
78
78
|
|
|
79
79
|
export interface SummaryInput {
|
|
80
|
+
/** Checkout root for normalising finding locations. */
|
|
81
|
+
root?: string;
|
|
80
82
|
workflow: SummaryWorkflow;
|
|
81
83
|
fid: string;
|
|
82
84
|
/** `refOf(fid)`; undefined = no tracker reference. */
|
|
@@ -85,18 +87,22 @@ export interface SummaryInput {
|
|
|
85
87
|
rows: Row[];
|
|
86
88
|
/** The plan files the run worked from, repo-relative path and text. */
|
|
87
89
|
plans: Array<{ path: string; text: string }>;
|
|
88
|
-
/**
|
|
90
|
+
/** Current deferrals whose keys this workflow touched since the run started, including closed ones. */
|
|
89
91
|
deferrals: Row[];
|
|
90
|
-
/**
|
|
92
|
+
/** Number of those distinct keys still open. */
|
|
91
93
|
deferralsAdded: number;
|
|
92
94
|
/** build and ship: every `build-decision-*.md` in the log folder, repo-relative. */
|
|
93
95
|
decisionFiles: string[];
|
|
94
96
|
/** A repo-relative file's text, or null when it is missing. */
|
|
95
97
|
read: (rel: string) => string | null;
|
|
96
|
-
/** design: the workstreams `
|
|
98
|
+
/** design: the workstreams `plans parse` reads from the organised design. */
|
|
97
99
|
workstreams?: Workstream[];
|
|
100
|
+
/** design: the plans `plans parse` reads from the organised design. */
|
|
101
|
+
suggestedPlans?: Plan[];
|
|
98
102
|
/** design: the organised design's text; its `## Risks & Open Questions` becomes `## Open Questions`. */
|
|
99
103
|
organised?: string;
|
|
104
|
+
/** build: `false` = the run held (no push, no PR); absent or `true` = it publishes. */
|
|
105
|
+
publish?: boolean;
|
|
100
106
|
/** ship: the PR's size; absent when `gh` could not read it. */
|
|
101
107
|
pr?: { number: number; additions: number; deletions: number; changedFiles: number };
|
|
102
108
|
}
|
|
@@ -119,16 +125,22 @@ interface StepGroup {
|
|
|
119
125
|
const str = (v: unknown) => (typeof v === "string" ? v : undefined);
|
|
120
126
|
const artifactsOf = (r: Row) =>
|
|
121
127
|
Array.isArray(r.artifacts) ? r.artifacts.filter((a): a is string => typeof a === "string") : [];
|
|
128
|
+
/** A step row's task group (`group`, or debug's `subPlan`); undefined when it has none. */
|
|
129
|
+
const taskGroupOf = (r: Row) => {
|
|
130
|
+
const taskGroup = r.group ?? r.subPlan;
|
|
131
|
+
return typeof taskGroup === "number" ? taskGroup : undefined;
|
|
132
|
+
};
|
|
122
133
|
|
|
123
|
-
/** The run's step rows grouped per step (and
|
|
134
|
+
/** The run's step rows grouped per step (and task group), in first-seen order. */
|
|
124
135
|
function stepGroups(rows: Row[]): StepGroup[] {
|
|
125
136
|
const groups = new Map<string, StepGroup>();
|
|
126
137
|
rows.forEach((row, index) => {
|
|
127
138
|
const step = str(row.step);
|
|
128
139
|
if (row.type !== "step-done" || step === undefined) return;
|
|
129
|
-
const
|
|
130
|
-
const
|
|
131
|
-
const key =
|
|
140
|
+
const sub = taskGroupOf(row);
|
|
141
|
+
const scope = sub === undefined ? step : `${step}#${sub}`;
|
|
142
|
+
const key =
|
|
143
|
+
step === "build-challenge" && typeof row.round === "number" ? `${scope}@${row.round}` : scope;
|
|
132
144
|
const g = groups.get(key) ?? {
|
|
133
145
|
label: sub === undefined ? step : `${step} (group ${sub})`,
|
|
134
146
|
key,
|
|
@@ -158,11 +170,34 @@ function planSection(text: string, title: RegExp): string | undefined {
|
|
|
158
170
|
return out.join("\n").trim();
|
|
159
171
|
}
|
|
160
172
|
|
|
173
|
+
/**
|
|
174
|
+
* A TEST EXCEPTION field's entries from its 1-based plan `fieldLines` (`plan-blocks.ts`):
|
|
175
|
+
* the label line's inline value and each sub-bullet, continuation lines joined to the entry above.
|
|
176
|
+
*/
|
|
177
|
+
function exceptionEntries(lines: string[], fieldLines: number[]): string[] {
|
|
178
|
+
const out: string[] = [];
|
|
179
|
+
for (const n of fieldLines) {
|
|
180
|
+
const raw = lines[n - 1] ?? "";
|
|
181
|
+
const label = raw.indexOf(TEST_EXCEPTION);
|
|
182
|
+
const bullet = /^\s*- (.*)$/.exec(raw);
|
|
183
|
+
const text = (
|
|
184
|
+
label >= 0 ? raw.slice(label + TEST_EXCEPTION.length) : (bullet?.[1] ?? raw)
|
|
185
|
+
).trim();
|
|
186
|
+
if (text === "") continue;
|
|
187
|
+
if (label < 0 && bullet === null && out.length > 0) out[out.length - 1] += ` ${text}`;
|
|
188
|
+
else out.push(text);
|
|
189
|
+
}
|
|
190
|
+
return out;
|
|
191
|
+
}
|
|
192
|
+
|
|
161
193
|
export function buildSummary(input: SummaryInput): Summary {
|
|
162
194
|
const { workflow } = input;
|
|
163
195
|
const groups = stepGroups(input.rows);
|
|
164
196
|
const fails: string[] = [];
|
|
165
197
|
const concerns: string[] = [];
|
|
198
|
+
const resolved = new Map<string, string>();
|
|
199
|
+
const resolvedFindings: string[] = [];
|
|
200
|
+
const reassessed: string[] = [];
|
|
166
201
|
const read = (rel: string) => input.read(rel);
|
|
167
202
|
|
|
168
203
|
// Debug: a reproduce step that could not reproduce is a re-run, not a failure.
|
|
@@ -186,35 +221,91 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
186
221
|
|
|
187
222
|
for (const g of groups) {
|
|
188
223
|
const { row, index } = lastOf(g);
|
|
224
|
+
if (g.step === `${workflow}-summary`) continue;
|
|
189
225
|
if (RUN_TESTS.has(g.step)) {
|
|
190
226
|
if (row.verdict === "FAIL") fails.push(`${g.label} FAIL`);
|
|
191
227
|
continue;
|
|
192
228
|
}
|
|
193
|
-
if (row.verdict
|
|
194
|
-
if (row.verdict !== "FAIL") continue;
|
|
229
|
+
if (row.verdict !== "FAIL" && row.verdict !== "CONCERNS") continue;
|
|
195
230
|
if (g.step === "debug-failure-reproduce" && notReproduced) continue;
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
(
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
231
|
+
if (workflow === "build" && g.step === "build-challenge") {
|
|
232
|
+
const assessment = challengeResolution(input, row, index, tasks);
|
|
233
|
+
if (assessment !== undefined) {
|
|
234
|
+
fails.push(...assessment.failures);
|
|
235
|
+
concerns.push(...assessment.concerns);
|
|
236
|
+
resolvedFindings.push(...assessment.resolved);
|
|
237
|
+
continue;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
if (
|
|
241
|
+
workflow === "build" &&
|
|
242
|
+
g.step === "build-plan-current" &&
|
|
243
|
+
tasks.length > 0 &&
|
|
244
|
+
tasks.every((t) => taskVerified(input, t, index))
|
|
245
|
+
) {
|
|
246
|
+
resolved.set(g.key, "build-plan-verify");
|
|
247
|
+
continue;
|
|
248
|
+
}
|
|
249
|
+
const review = g.step === `${workflow}-review`;
|
|
250
|
+
const spike = workflow === "design" && g.step === "design-spike";
|
|
251
|
+
const answers = spike
|
|
252
|
+
? ["design-apply-review"]
|
|
253
|
+
: review || row.verdict === "FAIL"
|
|
254
|
+
? (RESOLVED_BY[`${workflow}/${g.step}`] ?? [])
|
|
255
|
+
: [];
|
|
256
|
+
const sub = taskGroupOf(row);
|
|
257
|
+
const answer = groups
|
|
258
|
+
.map(lastOf)
|
|
259
|
+
.find(
|
|
260
|
+
({ row: r, index: i }) =>
|
|
261
|
+
i > index &&
|
|
262
|
+
answers.includes(String(r.step)) &&
|
|
263
|
+
(r.verdict === "PASS" || (review && r.verdict === "CONCERNS")) &&
|
|
264
|
+
(r.failures === undefined || r.failures === 0) &&
|
|
265
|
+
taskGroupOf(r) === sub &&
|
|
266
|
+
(!review || r.attempt === row.attempt),
|
|
267
|
+
);
|
|
268
|
+
if (answer !== undefined && spike) {
|
|
269
|
+
const reports = artifactsOf(row).map((p) => read(p));
|
|
270
|
+
const unsettled = reports.map((report) =>
|
|
271
|
+
report === null ? undefined : planSection(report, /^## Unsettled\s*$/),
|
|
272
|
+
);
|
|
273
|
+
if (
|
|
274
|
+
unsettled.length > 0 &&
|
|
275
|
+
unsettled.every((section) => section !== undefined && section !== "")
|
|
276
|
+
) {
|
|
277
|
+
if (unsettled.every((section) => /^None\.?$/i.test(section!)))
|
|
278
|
+
resolved.set(g.key, String(answer.row.step));
|
|
279
|
+
else {
|
|
280
|
+
concerns.push("design-spike: unsettled claims remain");
|
|
281
|
+
reassessed.push(
|
|
282
|
+
"design-spike: design impact addressed by design-apply-review; unsettled claims remain",
|
|
283
|
+
);
|
|
284
|
+
}
|
|
285
|
+
continue;
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
if (answer !== undefined && !spike && answer.row.verdict === "CONCERNS")
|
|
289
|
+
reassessed.push(
|
|
290
|
+
`${g.label} ${String(row.verdict)}, remaining findings assessed by ${String(answer.row.step)}`,
|
|
291
|
+
);
|
|
292
|
+
else if (answer !== undefined && !spike) resolved.set(g.key, String(answer.row.step));
|
|
293
|
+
else if (row.verdict === "FAIL") fails.push(`${g.label} FAIL`);
|
|
294
|
+
else concerns.push(`${g.label} CONCERNS`);
|
|
203
295
|
}
|
|
204
296
|
|
|
205
297
|
// The Decision Pause: accepted items in this run's decision files.
|
|
206
298
|
const decided = groups
|
|
207
299
|
.filter((g) => g.step === "build-decision")
|
|
208
300
|
.flatMap((g) => g.rows.flatMap(({ row }) => artifactsOf(row)));
|
|
209
|
-
const
|
|
210
|
-
(read(rel) ?? "")
|
|
211
|
-
.
|
|
212
|
-
.
|
|
213
|
-
.map((l) => `${rel}: ${l.trim()}`),
|
|
301
|
+
const acceptItems = decided.flatMap((rel) =>
|
|
302
|
+
parseDecisionItems(read(rel) ?? "")
|
|
303
|
+
.filter((i) => /^Accept\b/.test(i.decision ?? ""))
|
|
304
|
+
.map((i) => ({ assumed: i.assumed, line: `${rel}: Decision: ${i.decision}` })),
|
|
214
305
|
);
|
|
215
306
|
// `Accept (assumed)`: taken without the owner (`ask: false` or headless); ship asks to confirm.
|
|
216
|
-
const assumed =
|
|
217
|
-
const accepted =
|
|
307
|
+
const assumed = acceptItems.filter((a) => a.assumed).map((a) => a.line);
|
|
308
|
+
const accepted = acceptItems.filter((a) => !a.assumed).map((a) => a.line);
|
|
218
309
|
if (accepted.length > 0)
|
|
219
310
|
concerns.push(`${accepted.length} item(s) accepted at the Decision Pause`);
|
|
220
311
|
if (assumed.length > 0)
|
|
@@ -233,7 +324,7 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
233
324
|
if (unconfirmed.length > 0)
|
|
234
325
|
concerns.push(`shipped with ${unconfirmed.length} assumed item(s) the owner did not confirm`);
|
|
235
326
|
if (input.deferralsAdded > 0)
|
|
236
|
-
concerns.push(`${input.deferralsAdded} deferral(s)
|
|
327
|
+
concerns.push(`${input.deferralsAdded} deferral(s) from this run remain open`);
|
|
237
328
|
|
|
238
329
|
const verdict: SummaryVerdict =
|
|
239
330
|
fails.length > 0 ? "FAIL" : concerns.length > 0 ? "CONCERNS" : "PASS";
|
|
@@ -244,10 +335,9 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
244
335
|
const withRef = (cmd: string) => (input.ref === undefined ? cmd : `${cmd} ${input.ref}`);
|
|
245
336
|
let nextStep = step.command === undefined ? (step.line ?? "") : withRef(step.command);
|
|
246
337
|
if (workflow === "debug" && notReproduced) nextStep = `${withRef("/bkit-debug")} [repro]`;
|
|
247
|
-
const
|
|
248
|
-
if (workflow === "design" && step.command === "/bkit-plan" &&
|
|
249
|
-
nextStep =
|
|
250
|
-
"File the Suggested Workstreams issues, then /bkit-plan <first root workstream's new issue>";
|
|
338
|
+
const suggested = input.suggestedPlans ?? [];
|
|
339
|
+
if (workflow === "design" && step.command === "/bkit-plan" && suggested.length > 1)
|
|
340
|
+
nextStep = "File the Suggested Plans issues, then /bkit-plan <first root plan's new issue>";
|
|
251
341
|
|
|
252
342
|
// Sections.
|
|
253
343
|
const out: string[] = [
|
|
@@ -263,7 +353,9 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
263
353
|
"",
|
|
264
354
|
...(reasons.length > 0
|
|
265
355
|
? reasons.map((r) => `- ${r}`)
|
|
266
|
-
: [
|
|
356
|
+
: [
|
|
357
|
+
"- No unresolved finding, failing check, open task, accepted limitation or open deferral.",
|
|
358
|
+
]),
|
|
267
359
|
];
|
|
268
360
|
if (workflow === "build")
|
|
269
361
|
out.push(
|
|
@@ -271,6 +363,9 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
271
363
|
input.plans.length === 0
|
|
272
364
|
? "Plan tasks: no plan file."
|
|
273
365
|
: `Plan tasks: ${tasks.filter((t) => t.done).length} of ${tasks.length} ticked in ${input.plans.map((p) => `\`${p.path}\``).join(", ")}.`,
|
|
366
|
+
"",
|
|
367
|
+
input.publish === false ? "Publish: held" : "Publish: pr",
|
|
368
|
+
...(input.publish === false ? ["", "Docs: not synced (ship syncs on landing)"] : []),
|
|
274
369
|
);
|
|
275
370
|
|
|
276
371
|
out.push(
|
|
@@ -290,6 +385,35 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
290
385
|
);
|
|
291
386
|
}
|
|
292
387
|
|
|
388
|
+
out.push("", "## Resolved Findings", "");
|
|
389
|
+
const resolutions = groups
|
|
390
|
+
.filter((g) => resolved.has(g.key))
|
|
391
|
+
.map(
|
|
392
|
+
(g) => `- ${g.label} ${String(lastOf(g).row.verdict)}, resolved by ${resolved.get(g.key)!}`,
|
|
393
|
+
);
|
|
394
|
+
resolutions.push(...resolvedFindings.map((r) => `- ${r}`));
|
|
395
|
+
out.push(...(resolutions.length > 0 ? resolutions : ["None"]));
|
|
396
|
+
if (reassessed.length > 0)
|
|
397
|
+
out.push("", "## Reassessed Findings", "", ...reassessed.map((r) => `- ${r}`));
|
|
398
|
+
out.push(
|
|
399
|
+
"",
|
|
400
|
+
"## Assessment History",
|
|
401
|
+
"",
|
|
402
|
+
"| Step | Verdict | Attempt | Artifact |",
|
|
403
|
+
"| --- | --- | --- | --- |",
|
|
404
|
+
);
|
|
405
|
+
for (const { g, row } of groups
|
|
406
|
+
.flatMap((g) => g.rows.map(({ row, index }) => ({ g, row, index })))
|
|
407
|
+
.sort((a, b) => a.index - b.index)) {
|
|
408
|
+
out.push(
|
|
409
|
+
`| ${g.label} | ${str(row.verdict) ?? "-"} | ${String(row.attempt ?? "-")} | ${
|
|
410
|
+
artifactsOf(row)
|
|
411
|
+
.map((a) => `\`${a}\``)
|
|
412
|
+
.join(", ") || "-"
|
|
413
|
+
} |`,
|
|
414
|
+
);
|
|
415
|
+
}
|
|
416
|
+
|
|
293
417
|
if (workflow === "build") {
|
|
294
418
|
const appended = tasks.filter((t) => SEVERITY.test(t.text));
|
|
295
419
|
const low = input.deferrals.filter(
|
|
@@ -308,7 +432,9 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
308
432
|
`- Task ${t.task} — ${SEVERITY.exec(t.text)![1]} — ${t.done ? "ticked" : "not ticked"} (\`${t.path}\`)`,
|
|
309
433
|
);
|
|
310
434
|
for (const r of low)
|
|
311
|
-
out.push(
|
|
435
|
+
out.push(
|
|
436
|
+
`- LOW, ${r.status === "CLOSED" ? "closed" : "deferred"}: ${String(r.key ?? "")} — ${String(r.description ?? "")}`,
|
|
437
|
+
);
|
|
312
438
|
}
|
|
313
439
|
|
|
314
440
|
if (workflow === "build" || workflow === "debug") {
|
|
@@ -336,13 +462,15 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
336
462
|
}
|
|
337
463
|
|
|
338
464
|
if (workflow === "design") {
|
|
339
|
-
out.push("", "## Suggested
|
|
340
|
-
if (
|
|
341
|
-
for (const
|
|
342
|
-
out.push(`### ${w.id}: ${w.name}`, "", `Requires: ${w.requiresText || "None"}`, "");
|
|
343
|
-
if (streams.length > 1)
|
|
465
|
+
out.push("", "## Suggested Plans", "");
|
|
466
|
+
if (suggested.length === 0) out.push("None");
|
|
467
|
+
for (const p of suggested)
|
|
344
468
|
out.push(
|
|
345
|
-
|
|
469
|
+
`### ${p.id}: ${p.name}`,
|
|
470
|
+
"",
|
|
471
|
+
`Covers: ${coversList(p, input.workstreams ?? []) || "None"}`,
|
|
472
|
+
`Requires: ${p.requiresText || "None"}`,
|
|
473
|
+
"",
|
|
346
474
|
);
|
|
347
475
|
out.push(
|
|
348
476
|
"",
|
|
@@ -374,8 +502,15 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
374
502
|
// Risks and action items.
|
|
375
503
|
const items: string[] = [];
|
|
376
504
|
for (const g of groups) {
|
|
505
|
+
if (resolved.has(g.key)) continue;
|
|
377
506
|
for (const rel of artifactsOf(lastOf(g).row).filter((a) => a.endsWith("-log.md"))) {
|
|
378
|
-
|
|
507
|
+
const dispositions = new Map<string, string>();
|
|
508
|
+
for (const line of (read(rel) ?? "").split("\n")) {
|
|
509
|
+
const entry = /^(BLOCKED|DONE)\s*—\s*((?:task|step|gap)\s+\d+)\b/i.exec(line);
|
|
510
|
+
if (entry !== null) dispositions.set(entry[2]!.toLowerCase(), line);
|
|
511
|
+
else if (/^BLOCKED\b/.test(line)) dispositions.set(line, line);
|
|
512
|
+
}
|
|
513
|
+
for (const line of [...dispositions.values()].filter((l) => /^BLOCKED\b/.test(l)))
|
|
379
514
|
items.push(`- ${line} (\`${rel}\`)`);
|
|
380
515
|
}
|
|
381
516
|
}
|
|
@@ -385,8 +520,19 @@ export function buildSummary(input: SummaryInput): Summary {
|
|
|
385
520
|
if (!/^Decision:/m.test(read(rel) ?? "")) items.push(`- \`${rel}\`: no decision recorded`);
|
|
386
521
|
}
|
|
387
522
|
for (const p of input.plans) {
|
|
388
|
-
|
|
389
|
-
|
|
523
|
+
const lines = p.text.split(/\r?\n/);
|
|
524
|
+
const covered = new Set<number>();
|
|
525
|
+
for (const t of tasks.filter((x) => x.path === p.path && x.testException !== undefined)) {
|
|
526
|
+
const fieldLines = t.testException!.lines;
|
|
527
|
+
for (const n of fieldLines) covered.add(n);
|
|
528
|
+
const entries = exceptionEntries(lines, fieldLines);
|
|
529
|
+
for (const e of entries.length > 0 ? entries : ["no reason recorded"])
|
|
530
|
+
items.push(`- TEST EXCEPTION, task ${t.task}: ${e} (\`${p.path}\`)`);
|
|
531
|
+
}
|
|
532
|
+
lines.forEach((l, i) => {
|
|
533
|
+
if (l.includes(TEST_EXCEPTION) && !covered.has(i + 1))
|
|
534
|
+
items.push(`- \`${p.path}\`: ${l.trim()}`);
|
|
535
|
+
});
|
|
390
536
|
}
|
|
391
537
|
out.push("", "## Risks and Action Items", "", ...(items.length > 0 ? items : ["None"]));
|
|
392
538
|
|