@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,117 @@
|
|
|
1
|
+
import { parseFindings, mergeFindings, normalizeLocation, lowDeferralKey, } from "./challenge.js";
|
|
2
|
+
import { parseDecisionItems } from "./decisions.js";
|
|
3
|
+
const artifacts = (row) => Array.isArray(row.artifacts)
|
|
4
|
+
? row.artifacts.filter((p) => typeof p === "string")
|
|
5
|
+
: [];
|
|
6
|
+
/** The latest assessment must cover this task, after its finding and last execution. */
|
|
7
|
+
export function taskVerified(input, task, after) {
|
|
8
|
+
const assessments = input.rows
|
|
9
|
+
.map((row, index) => ({ row, index }))
|
|
10
|
+
.filter(({ row }) => row.type === "step-done" && row.step === "build-plan-verify" && row.group === task.group);
|
|
11
|
+
const latest = assessments.at(-1);
|
|
12
|
+
if (!task.done ||
|
|
13
|
+
latest === undefined ||
|
|
14
|
+
latest.index <= after ||
|
|
15
|
+
latest.row.verdict !== "PASS" ||
|
|
16
|
+
(latest.row.failures !== undefined && latest.row.failures !== 0))
|
|
17
|
+
return false;
|
|
18
|
+
if (input.rows
|
|
19
|
+
.slice(latest.index + 1)
|
|
20
|
+
.some((r) => r.type === "step-done" &&
|
|
21
|
+
r.group === task.group &&
|
|
22
|
+
(r.step === "build-plan-tasks" || r.step === "build-plan-gaps-remediate")))
|
|
23
|
+
return false;
|
|
24
|
+
return artifacts(latest.row).some((p) => {
|
|
25
|
+
const header = (input.read(p) ?? "").split("<!-- verdict:end -->")[0];
|
|
26
|
+
const numbers = /^Tasks:[ \t]*(.*)$/m
|
|
27
|
+
.exec(header)?.[1]
|
|
28
|
+
?.split(",")
|
|
29
|
+
.map((n) => Number(n.trim())) ?? [];
|
|
30
|
+
return /^Verdict:[ \t]*PASS[ \t]*$/m.test(header) && numbers.includes(task.task);
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
/** Unreadable or incomplete evidence leaves the recorded assessment unresolved. */
|
|
34
|
+
export function challengeResolution(input, row, index, tasks) {
|
|
35
|
+
const paths = artifacts(row);
|
|
36
|
+
const round = row.round;
|
|
37
|
+
if (paths.length === 0 || typeof round !== "number")
|
|
38
|
+
return undefined;
|
|
39
|
+
const later = input.rows
|
|
40
|
+
.slice(index + 1)
|
|
41
|
+
.filter((r) => r.type === "step-done" && r.step === "build-challenge");
|
|
42
|
+
if (row.challengeFindings === undefined &&
|
|
43
|
+
later.some((r) => artifacts(r).some((p) => paths.includes(p)))) {
|
|
44
|
+
const latest = later.at(-1);
|
|
45
|
+
const roundTasks = tasks.filter((t) => (/\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? []).includes(round));
|
|
46
|
+
if (latest.verdict !== "PASS" ||
|
|
47
|
+
!paths.every((p) => artifacts(latest).includes(p)) ||
|
|
48
|
+
roundTasks.length === 0 ||
|
|
49
|
+
!roundTasks.every((t) => taskVerified(input, t, index)))
|
|
50
|
+
return undefined;
|
|
51
|
+
return {
|
|
52
|
+
resolved: [
|
|
53
|
+
`build-challenge round ${round}, resolved by build-plan-verify and the later passing challenge covering the same reports`,
|
|
54
|
+
],
|
|
55
|
+
failures: [],
|
|
56
|
+
concerns: [],
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
let findings;
|
|
60
|
+
if (row.challengeFindings !== undefined) {
|
|
61
|
+
const snapshot = row.challengeFindings;
|
|
62
|
+
if (!Array.isArray(snapshot) ||
|
|
63
|
+
!snapshot.every((f) => f !== null &&
|
|
64
|
+
typeof f === "object" &&
|
|
65
|
+
["CRITICAL", "HIGH", "MEDIUM", "LOW"].includes(String(f.severity)) &&
|
|
66
|
+
typeof f.location === "string" &&
|
|
67
|
+
typeof f.title === "string"))
|
|
68
|
+
return undefined;
|
|
69
|
+
findings = snapshot;
|
|
70
|
+
}
|
|
71
|
+
else {
|
|
72
|
+
const reports = paths.map((p) => input.read(p));
|
|
73
|
+
if (reports.some((t) => t === null))
|
|
74
|
+
return undefined;
|
|
75
|
+
try {
|
|
76
|
+
findings = mergeFindings(reports.map((t, i) => parseFindings(t, paths[i], input.root ?? process.cwd())), new Set()).findings;
|
|
77
|
+
}
|
|
78
|
+
catch (error) {
|
|
79
|
+
return {
|
|
80
|
+
resolved: [],
|
|
81
|
+
failures: row.verdict === "FAIL" ? [`build-challenge FAIL: ${String(error)}`] : [],
|
|
82
|
+
concerns: row.verdict === "CONCERNS" ? [`build-challenge CONCERNS: ${String(error)}`] : [],
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
if (findings.length === 0)
|
|
87
|
+
return undefined;
|
|
88
|
+
const result = { resolved: [], failures: [], concerns: [] };
|
|
89
|
+
for (const f of findings) {
|
|
90
|
+
const matches = tasks.filter((t) => {
|
|
91
|
+
const location = /\*\*Location:\*\*\s*([^\n·]+)/.exec(t.text)?.[1];
|
|
92
|
+
const severity = /\*\*Severity:\*\*\s*(\w+)/.exec(t.text)?.[1];
|
|
93
|
+
const rounds = /\*\*Round:\*\*\s*([\d, ]+)/.exec(t.text)?.[1]?.split(",").map(Number) ?? [];
|
|
94
|
+
return (location !== undefined &&
|
|
95
|
+
normalizeLocation(location, input.root ?? process.cwd()) === f.location &&
|
|
96
|
+
severity === f.severity &&
|
|
97
|
+
rounds.includes(round));
|
|
98
|
+
});
|
|
99
|
+
const label = `build-challenge round ${round}: ${f.severity} ${f.location}`;
|
|
100
|
+
const accepted = input.decisionFiles.some((p) => parseDecisionItems(input.read(p) ?? "").some((item) => /^Accept\b/.test(item.decision ?? "") &&
|
|
101
|
+
[...item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)].some((m) => normalizeLocation(m[0], input.root ?? process.cwd()) === f.location)));
|
|
102
|
+
const closed = f.severity === "LOW" &&
|
|
103
|
+
input.deferrals.some((d) => d.status === "CLOSED" &&
|
|
104
|
+
d.key === lowDeferralKey(input.fid, f.location) &&
|
|
105
|
+
typeof d.source === "string" &&
|
|
106
|
+
normalizeLocation(d.source, input.root ?? process.cwd()) === f.location);
|
|
107
|
+
if (accepted)
|
|
108
|
+
result.concerns.push(`${label}, accepted limitation`);
|
|
109
|
+
else if (closed)
|
|
110
|
+
result.resolved.push(`${label}, resolved by closed deferral`);
|
|
111
|
+
else if (matches.length === 1 && taskVerified(input, matches[0], index))
|
|
112
|
+
result.resolved.push(`${label}, resolved by build-plan-verify (group ${matches[0].group}, task ${matches[0].task})`);
|
|
113
|
+
else
|
|
114
|
+
(f.severity === "CRITICAL" ? result.failures : result.concerns).push(label);
|
|
115
|
+
}
|
|
116
|
+
return result;
|
|
117
|
+
}
|
|
@@ -2,9 +2,11 @@
|
|
|
2
2
|
// verdict, reasons and the recommended next command, from the run's status rows,
|
|
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
|
+
import { coversList } from "./plans.js";
|
|
5
6
|
import { issueIdOf } from "./fids.js";
|
|
6
7
|
import { parseDecisionItems } from "./decisions.js";
|
|
7
8
|
import { parsePlanBlocks } from "./plan-blocks.js";
|
|
9
|
+
import { challengeResolution, taskVerified } from "./summary-findings.js";
|
|
8
10
|
export const SUMMARY_WORKFLOWS = ["plan", "design", "build", "debug", "ship"];
|
|
9
11
|
/** Per workflow and verdict, the next command the summary recommends. */
|
|
10
12
|
export const NEXT_STEP = {
|
|
@@ -45,31 +47,35 @@ export function refOf(fid, tracker = "any") {
|
|
|
45
47
|
return /^[0-9]+$/.test(id) ? `#${id}` : id;
|
|
46
48
|
}
|
|
47
49
|
/**
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
* (`build-plan-execute`) or by a Decision Pause (`build-decision`).
|
|
50
|
+
* Review updates cover their review's findings. Group verification covers failed
|
|
51
|
+
* execution, but does not cover a remediation agent's separate warnings or flakes.
|
|
51
52
|
*/
|
|
52
|
-
const
|
|
53
|
+
const RESOLVED_BY = {
|
|
53
54
|
"plan/plan-review": ["plan-apply-review"],
|
|
54
55
|
"design/design-review": ["design-apply-review"],
|
|
55
|
-
"
|
|
56
|
-
"build/build-
|
|
56
|
+
"build/build-plan-tasks": ["build-plan-verify"],
|
|
57
|
+
"build/build-plan-gaps-remediate": ["build-plan-verify"],
|
|
57
58
|
};
|
|
58
59
|
const RUN_TESTS = new Set(["build-run-tests", "debug-run-tests"]);
|
|
59
60
|
const SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
|
|
60
61
|
const TEST_EXCEPTION = "**TEST EXCEPTION:**";
|
|
61
62
|
const str = (v) => (typeof v === "string" ? v : undefined);
|
|
62
63
|
const artifactsOf = (r) => Array.isArray(r.artifacts) ? r.artifacts.filter((a) => typeof a === "string") : [];
|
|
63
|
-
/**
|
|
64
|
+
/** A step row's task group (`group`, or debug's `subPlan`); undefined when it has none. */
|
|
65
|
+
const taskGroupOf = (r) => {
|
|
66
|
+
const taskGroup = r.group ?? r.subPlan;
|
|
67
|
+
return typeof taskGroup === "number" ? taskGroup : undefined;
|
|
68
|
+
};
|
|
69
|
+
/** The run's step rows grouped per step (and task group), in first-seen order. */
|
|
64
70
|
function stepGroups(rows) {
|
|
65
71
|
const groups = new Map();
|
|
66
72
|
rows.forEach((row, index) => {
|
|
67
73
|
const step = str(row.step);
|
|
68
74
|
if (row.type !== "step-done" || step === undefined)
|
|
69
75
|
return;
|
|
70
|
-
const
|
|
71
|
-
const
|
|
72
|
-
const key =
|
|
76
|
+
const sub = taskGroupOf(row);
|
|
77
|
+
const scope = sub === undefined ? step : `${step}#${sub}`;
|
|
78
|
+
const key = step === "build-challenge" && typeof row.round === "number" ? `${scope}@${row.round}` : scope;
|
|
73
79
|
const g = groups.get(key) ?? {
|
|
74
80
|
label: sub === undefined ? step : `${step} (group ${sub})`,
|
|
75
81
|
key,
|
|
@@ -100,11 +106,34 @@ function planSection(text, title) {
|
|
|
100
106
|
}
|
|
101
107
|
return out.join("\n").trim();
|
|
102
108
|
}
|
|
109
|
+
/**
|
|
110
|
+
* A TEST EXCEPTION field's entries from its 1-based plan `fieldLines` (`plan-blocks.ts`):
|
|
111
|
+
* the label line's inline value and each sub-bullet, continuation lines joined to the entry above.
|
|
112
|
+
*/
|
|
113
|
+
function exceptionEntries(lines, fieldLines) {
|
|
114
|
+
const out = [];
|
|
115
|
+
for (const n of fieldLines) {
|
|
116
|
+
const raw = lines[n - 1] ?? "";
|
|
117
|
+
const label = raw.indexOf(TEST_EXCEPTION);
|
|
118
|
+
const bullet = /^\s*- (.*)$/.exec(raw);
|
|
119
|
+
const text = (label >= 0 ? raw.slice(label + TEST_EXCEPTION.length) : (bullet?.[1] ?? raw)).trim();
|
|
120
|
+
if (text === "")
|
|
121
|
+
continue;
|
|
122
|
+
if (label < 0 && bullet === null && out.length > 0)
|
|
123
|
+
out[out.length - 1] += ` ${text}`;
|
|
124
|
+
else
|
|
125
|
+
out.push(text);
|
|
126
|
+
}
|
|
127
|
+
return out;
|
|
128
|
+
}
|
|
103
129
|
export function buildSummary(input) {
|
|
104
130
|
const { workflow } = input;
|
|
105
131
|
const groups = stepGroups(input.rows);
|
|
106
132
|
const fails = [];
|
|
107
133
|
const concerns = [];
|
|
134
|
+
const resolved = new Map();
|
|
135
|
+
const resolvedFindings = [];
|
|
136
|
+
const reassessed = [];
|
|
108
137
|
const read = (rel) => input.read(rel);
|
|
109
138
|
// Debug: a reproduce step that could not reproduce is a re-run, not a failure.
|
|
110
139
|
const reproduce = groups.find((g) => g.step === "debug-failure-reproduce");
|
|
@@ -123,35 +152,82 @@ export function buildSummary(input) {
|
|
|
123
152
|
}
|
|
124
153
|
for (const g of groups) {
|
|
125
154
|
const { row, index } = lastOf(g);
|
|
155
|
+
if (g.step === `${workflow}-summary`)
|
|
156
|
+
continue;
|
|
126
157
|
if (RUN_TESTS.has(g.step)) {
|
|
127
158
|
if (row.verdict === "FAIL")
|
|
128
159
|
fails.push(`${g.label} FAIL`);
|
|
129
160
|
continue;
|
|
130
161
|
}
|
|
131
|
-
if (row.verdict
|
|
132
|
-
concerns.push(`${g.label} CONCERNS`);
|
|
133
|
-
if (row.verdict !== "FAIL")
|
|
162
|
+
if (row.verdict !== "FAIL" && row.verdict !== "CONCERNS")
|
|
134
163
|
continue;
|
|
135
164
|
if (g.step === "debug-failure-reproduce" && notReproduced)
|
|
136
165
|
continue;
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
166
|
+
if (workflow === "build" && g.step === "build-challenge") {
|
|
167
|
+
const assessment = challengeResolution(input, row, index, tasks);
|
|
168
|
+
if (assessment !== undefined) {
|
|
169
|
+
fails.push(...assessment.failures);
|
|
170
|
+
concerns.push(...assessment.concerns);
|
|
171
|
+
resolvedFindings.push(...assessment.resolved);
|
|
172
|
+
continue;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
if (workflow === "build" &&
|
|
176
|
+
g.step === "build-plan-current" &&
|
|
177
|
+
tasks.length > 0 &&
|
|
178
|
+
tasks.every((t) => taskVerified(input, t, index))) {
|
|
179
|
+
resolved.set(g.key, "build-plan-verify");
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
const review = g.step === `${workflow}-review`;
|
|
183
|
+
const spike = workflow === "design" && g.step === "design-spike";
|
|
184
|
+
const answers = spike
|
|
185
|
+
? ["design-apply-review"]
|
|
186
|
+
: review || row.verdict === "FAIL"
|
|
187
|
+
? (RESOLVED_BY[`${workflow}/${g.step}`] ?? [])
|
|
188
|
+
: [];
|
|
189
|
+
const sub = taskGroupOf(row);
|
|
190
|
+
const answer = groups
|
|
191
|
+
.map(lastOf)
|
|
192
|
+
.find(({ row: r, index: i }) => i > index &&
|
|
193
|
+
answers.includes(String(r.step)) &&
|
|
194
|
+
(r.verdict === "PASS" || (review && r.verdict === "CONCERNS")) &&
|
|
195
|
+
(r.failures === undefined || r.failures === 0) &&
|
|
196
|
+
taskGroupOf(r) === sub &&
|
|
197
|
+
(!review || r.attempt === row.attempt));
|
|
198
|
+
if (answer !== undefined && spike) {
|
|
199
|
+
const reports = artifactsOf(row).map((p) => read(p));
|
|
200
|
+
const unsettled = reports.map((report) => report === null ? undefined : planSection(report, /^## Unsettled\s*$/));
|
|
201
|
+
if (unsettled.length > 0 &&
|
|
202
|
+
unsettled.every((section) => section !== undefined && section !== "")) {
|
|
203
|
+
if (unsettled.every((section) => /^None\.?$/i.test(section)))
|
|
204
|
+
resolved.set(g.key, String(answer.row.step));
|
|
205
|
+
else {
|
|
206
|
+
concerns.push("design-spike: unsettled claims remain");
|
|
207
|
+
reassessed.push("design-spike: design impact addressed by design-apply-review; unsettled claims remain");
|
|
208
|
+
}
|
|
209
|
+
continue;
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
if (answer !== undefined && !spike && answer.row.verdict === "CONCERNS")
|
|
213
|
+
reassessed.push(`${g.label} ${String(row.verdict)}, remaining findings assessed by ${String(answer.row.step)}`);
|
|
214
|
+
else if (answer !== undefined && !spike)
|
|
215
|
+
resolved.set(g.key, String(answer.row.step));
|
|
216
|
+
else if (row.verdict === "FAIL")
|
|
142
217
|
fails.push(`${g.label} FAIL`);
|
|
218
|
+
else
|
|
219
|
+
concerns.push(`${g.label} CONCERNS`);
|
|
143
220
|
}
|
|
144
221
|
// The Decision Pause: accepted items in this run's decision files.
|
|
145
222
|
const decided = groups
|
|
146
223
|
.filter((g) => g.step === "build-decision")
|
|
147
224
|
.flatMap((g) => g.rows.flatMap(({ row }) => artifactsOf(row)));
|
|
148
|
-
const
|
|
149
|
-
.
|
|
150
|
-
.
|
|
151
|
-
.map((l) => `${rel}: ${l.trim()}`));
|
|
225
|
+
const acceptItems = decided.flatMap((rel) => parseDecisionItems(read(rel) ?? "")
|
|
226
|
+
.filter((i) => /^Accept\b/.test(i.decision ?? ""))
|
|
227
|
+
.map((i) => ({ assumed: i.assumed, line: `${rel}: Decision: ${i.decision}` })));
|
|
152
228
|
// `Accept (assumed)`: taken without the owner (`ask: false` or headless); ship asks to confirm.
|
|
153
|
-
const assumed =
|
|
154
|
-
const accepted =
|
|
229
|
+
const assumed = acceptItems.filter((a) => a.assumed).map((a) => a.line);
|
|
230
|
+
const accepted = acceptItems.filter((a) => !a.assumed).map((a) => a.line);
|
|
155
231
|
if (accepted.length > 0)
|
|
156
232
|
concerns.push(`${accepted.length} item(s) accepted at the Decision Pause`);
|
|
157
233
|
if (assumed.length > 0)
|
|
@@ -165,7 +241,7 @@ export function buildSummary(input) {
|
|
|
165
241
|
if (unconfirmed.length > 0)
|
|
166
242
|
concerns.push(`shipped with ${unconfirmed.length} assumed item(s) the owner did not confirm`);
|
|
167
243
|
if (input.deferralsAdded > 0)
|
|
168
|
-
concerns.push(`${input.deferralsAdded} deferral(s)
|
|
244
|
+
concerns.push(`${input.deferralsAdded} deferral(s) from this run remain open`);
|
|
169
245
|
const verdict = fails.length > 0 ? "FAIL" : concerns.length > 0 ? "CONCERNS" : "PASS";
|
|
170
246
|
const reasons = [...fails, ...concerns];
|
|
171
247
|
// Next step.
|
|
@@ -174,10 +250,9 @@ export function buildSummary(input) {
|
|
|
174
250
|
let nextStep = step.command === undefined ? (step.line ?? "") : withRef(step.command);
|
|
175
251
|
if (workflow === "debug" && notReproduced)
|
|
176
252
|
nextStep = `${withRef("/bkit-debug")} [repro]`;
|
|
177
|
-
const
|
|
178
|
-
if (workflow === "design" && step.command === "/bkit-plan" &&
|
|
179
|
-
nextStep =
|
|
180
|
-
"File the Suggested Workstreams issues, then /bkit-plan <first root workstream's new issue>";
|
|
253
|
+
const suggested = input.suggestedPlans ?? [];
|
|
254
|
+
if (workflow === "design" && step.command === "/bkit-plan" && suggested.length > 1)
|
|
255
|
+
nextStep = "File the Suggested Plans issues, then /bkit-plan <first root plan's new issue>";
|
|
181
256
|
// Sections.
|
|
182
257
|
const out = [
|
|
183
258
|
`Verdict: ${verdict}`,
|
|
@@ -192,12 +267,14 @@ export function buildSummary(input) {
|
|
|
192
267
|
"",
|
|
193
268
|
...(reasons.length > 0
|
|
194
269
|
? reasons.map((r) => `- ${r}`)
|
|
195
|
-
: [
|
|
270
|
+
: [
|
|
271
|
+
"- No unresolved finding, failing check, open task, accepted limitation or open deferral.",
|
|
272
|
+
]),
|
|
196
273
|
];
|
|
197
274
|
if (workflow === "build")
|
|
198
275
|
out.push("", input.plans.length === 0
|
|
199
276
|
? "Plan tasks: no plan file."
|
|
200
|
-
: `Plan tasks: ${tasks.filter((t) => t.done).length} of ${tasks.length} ticked in ${input.plans.map((p) => `\`${p.path}\``).join(", ")}
|
|
277
|
+
: `Plan tasks: ${tasks.filter((t) => t.done).length} of ${tasks.length} ticked in ${input.plans.map((p) => `\`${p.path}\``).join(", ")}.`, "", input.publish === false ? "Publish: held" : "Publish: pr", ...(input.publish === false ? ["", "Docs: not synced (ship syncs on landing)"] : []));
|
|
201
278
|
out.push("", "## Steps", "", "| Step | Verdict | Failures | Attempts | Artifact |", "| --- | --- | --- | --- | --- |");
|
|
202
279
|
for (const g of groups) {
|
|
203
280
|
const { row } = lastOf(g);
|
|
@@ -206,6 +283,22 @@ export function buildSummary(input) {
|
|
|
206
283
|
.join(", ");
|
|
207
284
|
out.push(`| ${g.label} | ${str(row.verdict) ?? "-"} | ${typeof row.failures === "number" ? row.failures : "-"} | ${g.rows.length} | ${artifact || "-"} |`);
|
|
208
285
|
}
|
|
286
|
+
out.push("", "## Resolved Findings", "");
|
|
287
|
+
const resolutions = groups
|
|
288
|
+
.filter((g) => resolved.has(g.key))
|
|
289
|
+
.map((g) => `- ${g.label} ${String(lastOf(g).row.verdict)}, resolved by ${resolved.get(g.key)}`);
|
|
290
|
+
resolutions.push(...resolvedFindings.map((r) => `- ${r}`));
|
|
291
|
+
out.push(...(resolutions.length > 0 ? resolutions : ["None"]));
|
|
292
|
+
if (reassessed.length > 0)
|
|
293
|
+
out.push("", "## Reassessed Findings", "", ...reassessed.map((r) => `- ${r}`));
|
|
294
|
+
out.push("", "## Assessment History", "", "| Step | Verdict | Attempt | Artifact |", "| --- | --- | --- | --- |");
|
|
295
|
+
for (const { g, row } of groups
|
|
296
|
+
.flatMap((g) => g.rows.map(({ row, index }) => ({ g, row, index })))
|
|
297
|
+
.sort((a, b) => a.index - b.index)) {
|
|
298
|
+
out.push(`| ${g.label} | ${str(row.verdict) ?? "-"} | ${String(row.attempt ?? "-")} | ${artifactsOf(row)
|
|
299
|
+
.map((a) => `\`${a}\``)
|
|
300
|
+
.join(", ") || "-"} |`);
|
|
301
|
+
}
|
|
209
302
|
if (workflow === "build") {
|
|
210
303
|
const appended = tasks.filter((t) => SEVERITY.test(t.text));
|
|
211
304
|
const low = input.deferrals.filter((r) => r.by?.step === "build-challenge");
|
|
@@ -219,7 +312,7 @@ export function buildSummary(input) {
|
|
|
219
312
|
for (const t of appended)
|
|
220
313
|
out.push(`- Task ${t.task} — ${SEVERITY.exec(t.text)[1]} — ${t.done ? "ticked" : "not ticked"} (\`${t.path}\`)`);
|
|
221
314
|
for (const r of low)
|
|
222
|
-
out.push(`- LOW, deferred: ${String(r.key ?? "")} — ${String(r.description ?? "")}`);
|
|
315
|
+
out.push(`- LOW, ${r.status === "CLOSED" ? "closed" : "deferred"}: ${String(r.key ?? "")} — ${String(r.description ?? "")}`);
|
|
223
316
|
}
|
|
224
317
|
if (workflow === "build" || workflow === "debug") {
|
|
225
318
|
const runs = groups.filter((g) => RUN_TESTS.has(g.step)).flatMap((g) => g.rows);
|
|
@@ -234,13 +327,11 @@ export function buildSummary(input) {
|
|
|
234
327
|
out.push("", "## Acceptance Scenario", "", planSection(final, /Acceptance Scenario/) || "None", "", "## Open Questions", "", planSection(final, /Open Questions/) || "None");
|
|
235
328
|
}
|
|
236
329
|
if (workflow === "design") {
|
|
237
|
-
out.push("", "## Suggested
|
|
238
|
-
if (
|
|
330
|
+
out.push("", "## Suggested Plans", "");
|
|
331
|
+
if (suggested.length === 0)
|
|
239
332
|
out.push("None");
|
|
240
|
-
for (const
|
|
241
|
-
out.push(`### ${
|
|
242
|
-
if (streams.length > 1)
|
|
243
|
-
out.push("File these as one issue each? Body per .bkit/trackers.md § Issue shapes; file in Requires order.");
|
|
333
|
+
for (const p of suggested)
|
|
334
|
+
out.push(`### ${p.id}: ${p.name}`, "", `Covers: ${coversList(p, input.workstreams ?? []) || "None"}`, `Requires: ${p.requiresText || "None"}`, "");
|
|
244
335
|
out.push("", "## Open Questions", "", planSection(input.organised ?? "", /Risks & Open Questions/) || "None");
|
|
245
336
|
}
|
|
246
337
|
if (workflow === "ship" && input.pr !== undefined) {
|
|
@@ -252,8 +343,18 @@ export function buildSummary(input) {
|
|
|
252
343
|
// Risks and action items.
|
|
253
344
|
const items = [];
|
|
254
345
|
for (const g of groups) {
|
|
346
|
+
if (resolved.has(g.key))
|
|
347
|
+
continue;
|
|
255
348
|
for (const rel of artifactsOf(lastOf(g).row).filter((a) => a.endsWith("-log.md"))) {
|
|
256
|
-
|
|
349
|
+
const dispositions = new Map();
|
|
350
|
+
for (const line of (read(rel) ?? "").split("\n")) {
|
|
351
|
+
const entry = /^(BLOCKED|DONE)\s*—\s*((?:task|step|gap)\s+\d+)\b/i.exec(line);
|
|
352
|
+
if (entry !== null)
|
|
353
|
+
dispositions.set(entry[2].toLowerCase(), line);
|
|
354
|
+
else if (/^BLOCKED\b/.test(line))
|
|
355
|
+
dispositions.set(line, line);
|
|
356
|
+
}
|
|
357
|
+
for (const line of [...dispositions.values()].filter((l) => /^BLOCKED\b/.test(l)))
|
|
257
358
|
items.push(`- ${line} (\`${rel}\`)`);
|
|
258
359
|
}
|
|
259
360
|
}
|
|
@@ -264,8 +365,20 @@ export function buildSummary(input) {
|
|
|
264
365
|
items.push(`- \`${rel}\`: no decision recorded`);
|
|
265
366
|
}
|
|
266
367
|
for (const p of input.plans) {
|
|
267
|
-
|
|
268
|
-
|
|
368
|
+
const lines = p.text.split(/\r?\n/);
|
|
369
|
+
const covered = new Set();
|
|
370
|
+
for (const t of tasks.filter((x) => x.path === p.path && x.testException !== undefined)) {
|
|
371
|
+
const fieldLines = t.testException.lines;
|
|
372
|
+
for (const n of fieldLines)
|
|
373
|
+
covered.add(n);
|
|
374
|
+
const entries = exceptionEntries(lines, fieldLines);
|
|
375
|
+
for (const e of entries.length > 0 ? entries : ["no reason recorded"])
|
|
376
|
+
items.push(`- TEST EXCEPTION, task ${t.task}: ${e} (\`${p.path}\`)`);
|
|
377
|
+
}
|
|
378
|
+
lines.forEach((l, i) => {
|
|
379
|
+
if (l.includes(TEST_EXCEPTION) && !covered.has(i + 1))
|
|
380
|
+
items.push(`- \`${p.path}\`: ${l.trim()}`);
|
|
381
|
+
});
|
|
269
382
|
}
|
|
270
383
|
out.push("", "## Risks and Action Items", "", ...(items.length > 0 ? items : ["None"]));
|
|
271
384
|
out.push("", "## Recommended Next Step", "", "```text", nextStep, "```");
|