@cbartens/bkit 5.5.1 → 6.0.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 +30 -20
- package/.bkit/core/.agents/docs.md +1 -0
- package/.bkit/core/.agents/rules.md +35 -26
- package/.bkit/core/.bkit/README.md +29 -19
- package/.bkit/core/.bkit/authoring.md +117 -0
- package/.bkit/core/.bkit/cloud.md +11 -11
- package/.bkit/core/.bkit/comparison.md +5 -5
- package/.bkit/core/.bkit/install.md +19 -18
- package/.bkit/core/.bkit/jsonl.md +202 -122
- package/.bkit/core/.bkit/lite.md +1 -1
- package/.bkit/core/.bkit/pipeline.md +49 -52
- package/.bkit/core/.bkit/prompts.md +91 -167
- package/.bkit/core/.bkit/providers.md +29 -32
- package/.bkit/core/.bkit/templates.md +12 -11
- package/.bkit/core/.bkit/trackers.md +51 -28
- package/.bkit/core/.bkit/workflows.md +394 -355
- package/.bkit/core/AGENTS.md +16 -22
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-agents.md +19 -43
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +11 -35
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-config.md +18 -42
- package/.bkit/core/docs/templates/bkit-audit-cost.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-database.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +15 -38
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +11 -35
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +18 -42
- package/.bkit/core/docs/templates/bkit-audit-failures.md +13 -37
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-gates.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-issues.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-llm.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-logs.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-models.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-repo.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-security.md +13 -37
- package/.bkit/core/docs/templates/bkit-audit-slop.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-testing.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-usability.md +16 -40
- package/.bkit/core/docs/templates/bkit-plan.md +97 -226
- package/.bkit/core/engine/checks/after/ci-yml.ts +39 -29
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +10 -7
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +46 -91
- package/.bkit/core/engine/checks/before/env.ts +2 -2
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +18 -1
- package/.bkit/core/engine/checks/before/repo.ts +168 -2
- package/.bkit/core/engine/checks/tips/catalogue.ts +16 -5
- package/.bkit/core/engine/checks/tips/detect.ts +34 -0
- package/.bkit/core/engine/checks/tips/index.ts +6 -6
- package/.bkit/core/engine/cli.ts +20 -53
- package/.bkit/core/engine/commands/analysis.ts +171 -140
- package/.bkit/core/engine/commands/ci/ci.ts +6 -6
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +65 -28
- package/.bkit/core/engine/commands/land.ts +18 -12
- package/.bkit/core/engine/commands/lib.ts +79 -17
- package/.bkit/core/engine/commands/registry.ts +4 -0
- package/.bkit/core/engine/commands/setup/setup.ts +7 -7
- package/.bkit/core/engine/commands/stats.ts +204 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +741 -62
- package/.bkit/core/engine/commands/workflow/challenge.ts +673 -0
- package/.bkit/core/engine/commands/workflow/context.ts +853 -29
- package/.bkit/core/engine/commands/workflow/counters.ts +267 -84
- package/.bkit/core/engine/commands/workflow/decisions.ts +541 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +2 -2
- package/.bkit/core/engine/commands/workflow/fids.ts +793 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +407 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +884 -27
- package/.bkit/core/engine/commands/workflow/locks.ts +26 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +582 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +166 -30
- package/.bkit/core/engine/commands/workflow/repo.ts +58 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +16 -7
- package/.bkit/core/engine/commands/workflow/run-facts.ts +501 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +179 -49
- package/.bkit/core/engine/commands/workflow/runtime.ts +22 -1
- package/.bkit/core/engine/commands/workflow/status.ts +142 -29
- package/.bkit/core/engine/commands/workflow/step-table.ts +339 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +213 -88
- package/.bkit/core/engine/commands/workflow/summary.ts +398 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1013 -148
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +984 -207
- package/.bkit/core/engine/commands/workflow/workstreams.ts +11 -5
- package/.bkit/core/engine/commands/workflow/worktrees.ts +185 -8
- package/.bkit/core/engine/install/manifest.ts +11 -9
- package/.bkit/core/engine/install/modules/cloud.ts +21 -13
- package/.bkit/core/engine/install/modules/core.ts +250 -3
- package/.bkit/core/engine/install/modules/opencode.ts +2 -2
- package/.bkit/core/engine/install/version-file.ts +6 -2
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +92 -15
- package/.bkit/core/engine/ledgers/telemetry.ts +1261 -254
- package/.bkit/core/engine/render/hosts.ts +4 -0
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/egress.ts +7 -0
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/settings.ts +157 -20
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +834 -0
- package/.bkit/core/engine/tools/instructions.ts +1751 -0
- package/.bkit/core/hooks/gateguard-engine.js +24 -23
- package/.bkit/core/hooks/guardrails-shell.js +2 -3
- package/.bkit/core/hooks/guardrails-tiers.js +7 -1
- package/.bkit/core/hooks/readguard-engine.js +2 -2
- package/.bkit/core/prompts/bkit-audit-generate.md +62 -25
- package/.bkit/core/prompts/bkit-build-challenge-1.md +40 -17
- package/.bkit/core/prompts/bkit-build-challenge-2.md +44 -17
- package/.bkit/core/prompts/bkit-build-install-skills.md +26 -13
- package/.bkit/core/prompts/bkit-build-plan-convert.md +74 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +26 -13
- package/.bkit/core/prompts/bkit-build-plan-execute.md +74 -26
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +64 -23
- package/.bkit/core/prompts/bkit-build-plan-verify.md +57 -33
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +29 -15
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +34 -14
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +34 -17
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +26 -13
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +31 -16
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +21 -11
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +20 -11
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +20 -11
- package/.bkit/core/prompts/bkit-design-generate.md +32 -14
- package/.bkit/core/prompts/bkit-design-organise.md +25 -12
- package/.bkit/core/prompts/bkit-design-review-1.md +31 -15
- package/.bkit/core/prompts/bkit-design-review-2.md +28 -13
- package/.bkit/core/prompts/bkit-design-spike.md +30 -13
- package/.bkit/core/prompts/bkit-design-update.md +33 -19
- package/.bkit/core/prompts/bkit-plan-generate.md +72 -18
- package/.bkit/core/prompts/bkit-plan-review-1.md +50 -27
- package/.bkit/core/prompts/bkit-plan-review-2.md +59 -28
- package/.bkit/core/prompts/bkit-plan-scope-check.md +109 -0
- package/.bkit/core/prompts/bkit-plan-update.md +61 -24
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +27 -15
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +31 -16
- package/.bkit/core/prompts/bkit-ship-update-docs.md +29 -14
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +24 -14
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +32 -14
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +29 -14
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +27 -12
- package/.bkit/core/prompts/bkit-utility-update-failures.md +31 -14
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +33 -14
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +38 -17
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +41 -18
- package/.bkit/core/workflows/bkit-auto.md +54 -46
- package/.bkit/core/workflows/bkit-build.md +577 -458
- package/.bkit/core/workflows/bkit-debug.md +348 -333
- package/.bkit/core/workflows/bkit-design.md +201 -237
- package/.bkit/core/workflows/bkit-plan.md +210 -321
- package/.bkit/core/workflows/bkit-ship.md +328 -278
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/settings.json +11 -0
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +11 -0
- package/.bkit/shared/CLAUDE.md +2 -2
- package/.bkit/shared/GEMINI.md +2 -2
- package/.bkit/shared/docs/architecture.md +1 -1
- package/.bkit/shared/docs/data-schema.md +1 -1
- package/.bkit/shared/docs/deployments.md +11 -11
- package/.bkit/shared/docs/design.md +1 -1
- package/.bkit/shared/docs/noise.md +1 -1
- package/.bkit/shared/docs/observability.md +2 -2
- package/.bkit/shared/docs/security.md +1 -1
- package/.bkit/shared/docs/setup.md +1 -1
- package/.bkit/shared/docs/technology.md +1 -1
- package/.bkit/shared/docs/testing.md +16 -7
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +26 -5
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1 -1
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
- package/.bkit/templates/.husky/pre-push +4 -4
- package/.bkit/templates/.prettierignore +7 -0
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
- package/CHANGELOG.md +112 -0
- package/README.md +50 -35
- package/dist/checks/after/ci-yml.js +39 -28
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +11 -8
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +39 -82
- package/dist/checks/before/env.js +2 -2
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +15 -2
- package/dist/checks/before/repo.js +163 -2
- package/dist/checks/tips/catalogue.js +14 -5
- package/dist/checks/tips/detect.js +32 -0
- package/dist/checks/tips/index.js +4 -4
- package/dist/cli.js +19 -47
- package/dist/commands/analysis.js +109 -100
- package/dist/commands/ci/ci.js +6 -6
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +59 -28
- package/dist/commands/land.js +16 -12
- package/dist/commands/lib.js +51 -16
- package/dist/commands/registry.js +4 -0
- package/dist/commands/setup/setup.js +7 -7
- package/dist/commands/stats.js +136 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +656 -56
- package/dist/commands/workflow/challenge.js +556 -0
- package/dist/commands/workflow/context.js +709 -30
- package/dist/commands/workflow/counters.js +208 -75
- package/dist/commands/workflow/decisions.js +441 -0
- package/dist/commands/workflow/disk.js +2 -2
- package/dist/commands/workflow/fids.js +689 -33
- package/dist/commands/workflow/issues.js +343 -59
- package/dist/commands/workflow/ledgers.js +762 -27
- package/dist/commands/workflow/locks.js +24 -2
- package/dist/commands/workflow/plan-blocks.js +437 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/prs.js +142 -32
- package/dist/commands/workflow/repo.js +52 -8
- package/dist/commands/workflow/roadmap.js +9 -7
- package/dist/commands/workflow/run-facts.js +426 -0
- package/dist/commands/workflow/runs.js +144 -43
- package/dist/commands/workflow/runtime.js +12 -1
- package/dist/commands/workflow/status.js +130 -29
- package/dist/commands/workflow/step-table.js +276 -0
- package/dist/commands/workflow/steps.js +171 -80
- package/dist/commands/workflow/summary.js +275 -0
- package/dist/commands/workflow/tests.js +834 -136
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +834 -195
- package/dist/commands/workflow/workstreams.js +11 -5
- package/dist/commands/workflow/worktrees.js +147 -9
- package/dist/install/manifest.js +11 -9
- package/dist/install/modules/cloud.js +22 -13
- package/dist/install/modules/core.js +247 -3
- package/dist/install/modules/opencode.js +2 -2
- package/dist/install/version-file.js +6 -2
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +61 -8
- package/dist/ledgers/telemetry.js +905 -124
- package/dist/render/hosts.js +4 -0
- package/dist/render/models.js +12 -0
- package/dist/shared/branches.js +3 -1
- package/dist/shared/egress.js +7 -0
- package/dist/shared/json.js +20 -7
- package/dist/shared/settings.js +125 -17
- package/dist/shared/text.js +333 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +721 -0
- package/dist/tools/instructions.js +1579 -0
- package/package.json +113 -24
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/dist/commands/harvest.js +0 -353
- package/dist/tools/wording.js +0 -680
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
// The summary a phase workflow writes at its Summary step (`bkit workflows summary`):
|
|
2
|
+
// verdict, reasons and the recommended next command, from the run's status rows,
|
|
3
|
+
// its log files, the plan and the ledger rows it added. Pure: the caller reads the
|
|
4
|
+
// disk and passes `read` for the log files.
|
|
5
|
+
import { issueIdOf } from "./fids.js";
|
|
6
|
+
import { parseDecisionItems } from "./decisions.js";
|
|
7
|
+
import { parsePlanBlocks } from "./plan-blocks.js";
|
|
8
|
+
export const SUMMARY_WORKFLOWS = ["plan", "design", "build", "debug", "ship"];
|
|
9
|
+
/** Per workflow and verdict, the next command the summary recommends. */
|
|
10
|
+
export const NEXT_STEP = {
|
|
11
|
+
plan: {
|
|
12
|
+
PASS: { command: "/bkit-build" },
|
|
13
|
+
CONCERNS: { command: "/bkit-build", or: "/bkit-plan" },
|
|
14
|
+
FAIL: { command: "/bkit-plan" },
|
|
15
|
+
},
|
|
16
|
+
design: {
|
|
17
|
+
PASS: { command: "/bkit-plan" },
|
|
18
|
+
CONCERNS: { command: "/bkit-plan", or: "/bkit-design" },
|
|
19
|
+
FAIL: { command: "/bkit-design" },
|
|
20
|
+
},
|
|
21
|
+
debug: {
|
|
22
|
+
PASS: { command: "/bkit-ship" },
|
|
23
|
+
CONCERNS: { command: "/bkit-ship", or: "/bkit-debug" },
|
|
24
|
+
FAIL: { line: "Manual handover — no bkit command; see the debug handover." },
|
|
25
|
+
},
|
|
26
|
+
build: {
|
|
27
|
+
PASS: { command: "/bkit-ship" },
|
|
28
|
+
CONCERNS: { command: "/bkit-ship" },
|
|
29
|
+
FAIL: { command: "/bkit-debug" },
|
|
30
|
+
},
|
|
31
|
+
ship: {
|
|
32
|
+
PASS: { line: "No further bkit command — feature shipped." },
|
|
33
|
+
CONCERNS: { line: "No further bkit command — feature shipped." },
|
|
34
|
+
FAIL: { command: "/bkit-ship" },
|
|
35
|
+
},
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* The issue reference a FID carries: `160-slug` → `#160`, `abc-123-slug` →
|
|
39
|
+
* `ABC-123`; undefined when the FID has no issue segment for `tracker`.
|
|
40
|
+
*/
|
|
41
|
+
export function refOf(fid, tracker = "any") {
|
|
42
|
+
const id = issueIdOf(fid, tracker);
|
|
43
|
+
if (id === null)
|
|
44
|
+
return undefined;
|
|
45
|
+
return /^[0-9]+$/.test(id) ? `#${id}` : id;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* A critique step whose FAIL a later step of the same workflow answers; the run
|
|
49
|
+
* carried on past it. A build challenge is answered by its fix tasks running
|
|
50
|
+
* (`build-plan-execute`) or by a Decision Pause (`build-decision`).
|
|
51
|
+
*/
|
|
52
|
+
const ANSWERED_BY = {
|
|
53
|
+
"plan/plan-review": ["plan-apply-review"],
|
|
54
|
+
"design/design-review": ["design-apply-review"],
|
|
55
|
+
"design/design-spike": ["design-apply-review"],
|
|
56
|
+
"build/build-challenge": ["build-plan-execute", "build-decision"],
|
|
57
|
+
};
|
|
58
|
+
const RUN_TESTS = new Set(["build-run-tests", "debug-run-tests"]);
|
|
59
|
+
const SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
|
|
60
|
+
const TEST_EXCEPTION = "**TEST EXCEPTION:**";
|
|
61
|
+
const str = (v) => (typeof v === "string" ? v : undefined);
|
|
62
|
+
const artifactsOf = (r) => Array.isArray(r.artifacts) ? r.artifacts.filter((a) => typeof a === "string") : [];
|
|
63
|
+
/** The run's step rows grouped per step (and plan group), in first-seen order. */
|
|
64
|
+
function stepGroups(rows) {
|
|
65
|
+
const groups = new Map();
|
|
66
|
+
rows.forEach((row, index) => {
|
|
67
|
+
const step = str(row.step);
|
|
68
|
+
if (row.type !== "step-done" || step === undefined)
|
|
69
|
+
return;
|
|
70
|
+
const planGroup = row.group ?? row.subPlan;
|
|
71
|
+
const sub = typeof planGroup === "number" ? planGroup : undefined;
|
|
72
|
+
const key = sub === undefined ? step : `${step}#${sub}`;
|
|
73
|
+
const g = groups.get(key) ?? {
|
|
74
|
+
label: sub === undefined ? step : `${step} (group ${sub})`,
|
|
75
|
+
key,
|
|
76
|
+
step,
|
|
77
|
+
rows: [],
|
|
78
|
+
};
|
|
79
|
+
g.rows.push({ row, index });
|
|
80
|
+
groups.set(key, g);
|
|
81
|
+
});
|
|
82
|
+
return [...groups.values()];
|
|
83
|
+
}
|
|
84
|
+
const lastOf = (g) => g.rows.at(-1);
|
|
85
|
+
/** A level-2 section whose heading matches `title`, minus the template's non-content subsections. */
|
|
86
|
+
function planSection(text, title) {
|
|
87
|
+
const lines = text.split("\n");
|
|
88
|
+
const start = lines.findIndex((l) => /^## /.test(l) && title.test(l));
|
|
89
|
+
if (start < 0)
|
|
90
|
+
return undefined;
|
|
91
|
+
const out = [];
|
|
92
|
+
let skip = false;
|
|
93
|
+
for (const line of lines.slice(start + 1)) {
|
|
94
|
+
if (/^## /.test(line))
|
|
95
|
+
break;
|
|
96
|
+
if (/^### /.test(line))
|
|
97
|
+
skip = /Derived Test Matrix|Human Confirmation/.test(line);
|
|
98
|
+
if (!skip)
|
|
99
|
+
out.push(line);
|
|
100
|
+
}
|
|
101
|
+
return out.join("\n").trim();
|
|
102
|
+
}
|
|
103
|
+
export function buildSummary(input) {
|
|
104
|
+
const { workflow } = input;
|
|
105
|
+
const groups = stepGroups(input.rows);
|
|
106
|
+
const fails = [];
|
|
107
|
+
const concerns = [];
|
|
108
|
+
const read = (rel) => input.read(rel);
|
|
109
|
+
// Debug: a reproduce step that could not reproduce is a re-run, not a failure.
|
|
110
|
+
const reproduce = groups.find((g) => g.step === "debug-failure-reproduce");
|
|
111
|
+
const reproText = reproduce ? read(artifactsOf(lastOf(reproduce).row)[0] ?? "") : null;
|
|
112
|
+
const notReproduced = reproText !== null && /^Reproduced:\s*NO\b/m.test(reproText);
|
|
113
|
+
if (notReproduced)
|
|
114
|
+
concerns.push("Reproduced: NO");
|
|
115
|
+
// Plan tasks: every unticked task of the plan files; a build always has a plan.
|
|
116
|
+
const tasks = input.plans.flatMap((p) => parsePlanBlocks(p.text).tasks.map((t) => ({ ...t, path: p.path })));
|
|
117
|
+
if (workflow === "build" && input.plans.length === 0)
|
|
118
|
+
fails.push("No plan file");
|
|
119
|
+
if (workflow === "build")
|
|
120
|
+
for (const t of tasks.filter((x) => !x.done)) {
|
|
121
|
+
const sev = SEVERITY.exec(t.text)?.[1];
|
|
122
|
+
fails.push(`Task ${t.task} not done (${t.path})${sev === undefined ? "" : ` — ${sev} challenge finding`}`);
|
|
123
|
+
}
|
|
124
|
+
for (const g of groups) {
|
|
125
|
+
const { row, index } = lastOf(g);
|
|
126
|
+
if (RUN_TESTS.has(g.step)) {
|
|
127
|
+
if (row.verdict === "FAIL")
|
|
128
|
+
fails.push(`${g.label} FAIL`);
|
|
129
|
+
continue;
|
|
130
|
+
}
|
|
131
|
+
if (row.verdict === "CONCERNS")
|
|
132
|
+
concerns.push(`${g.label} CONCERNS`);
|
|
133
|
+
if (row.verdict !== "FAIL")
|
|
134
|
+
continue;
|
|
135
|
+
if (g.step === "debug-failure-reproduce" && notReproduced)
|
|
136
|
+
continue;
|
|
137
|
+
const answers = ANSWERED_BY[`${workflow}/${g.step}`] ?? [];
|
|
138
|
+
const answeredBy = input.rows.find((r, i) => i > index && r.type === "step-done" && answers.includes(String(r.step)))?.step;
|
|
139
|
+
if (answeredBy !== undefined)
|
|
140
|
+
concerns.push(`${g.label} FAIL, answered by ${String(answeredBy)}`);
|
|
141
|
+
else
|
|
142
|
+
fails.push(`${g.label} FAIL`);
|
|
143
|
+
}
|
|
144
|
+
// The Decision Pause: accepted items in this run's decision files.
|
|
145
|
+
const decided = groups
|
|
146
|
+
.filter((g) => g.step === "build-decision")
|
|
147
|
+
.flatMap((g) => g.rows.flatMap(({ row }) => artifactsOf(row)));
|
|
148
|
+
const acceptLines = decided.flatMap((rel) => (read(rel) ?? "")
|
|
149
|
+
.split("\n")
|
|
150
|
+
.filter((l) => /^Decision:\s*Accept\b/.test(l.trim()))
|
|
151
|
+
.map((l) => `${rel}: ${l.trim()}`));
|
|
152
|
+
// `Accept (assumed)`: taken without the owner (`ask: false` or headless); ship asks to confirm.
|
|
153
|
+
const assumed = acceptLines.filter((a) => /Decision:\s*Accept \(assumed\)/.test(a));
|
|
154
|
+
const accepted = acceptLines.filter((a) => !assumed.includes(a));
|
|
155
|
+
if (accepted.length > 0)
|
|
156
|
+
concerns.push(`${accepted.length} item(s) accepted at the Decision Pause`);
|
|
157
|
+
if (assumed.length > 0)
|
|
158
|
+
concerns.push(`${assumed.length} item(s) accepted without the owner (assumed; ship asks to confirm)`);
|
|
159
|
+
// Ship: assumed Accepts the owner rejected or never confirmed; ship merged anyway.
|
|
160
|
+
const unconfirmed = workflow === "ship"
|
|
161
|
+
? input.decisionFiles.flatMap((rel) => parseDecisionItems(read(rel) ?? "")
|
|
162
|
+
.filter((i) => i.assumed)
|
|
163
|
+
.map((i) => `\`${rel}\` Q${i.n} — ${i.title}${i.rejected ? " (rejected)" : ""}`))
|
|
164
|
+
: [];
|
|
165
|
+
if (unconfirmed.length > 0)
|
|
166
|
+
concerns.push(`shipped with ${unconfirmed.length} assumed item(s) the owner did not confirm`);
|
|
167
|
+
if (input.deferralsAdded > 0)
|
|
168
|
+
concerns.push(`${input.deferralsAdded} deferral(s) written this run`);
|
|
169
|
+
const verdict = fails.length > 0 ? "FAIL" : concerns.length > 0 ? "CONCERNS" : "PASS";
|
|
170
|
+
const reasons = [...fails, ...concerns];
|
|
171
|
+
// Next step.
|
|
172
|
+
const step = NEXT_STEP[workflow][verdict];
|
|
173
|
+
const withRef = (cmd) => (input.ref === undefined ? cmd : `${cmd} ${input.ref}`);
|
|
174
|
+
let nextStep = step.command === undefined ? (step.line ?? "") : withRef(step.command);
|
|
175
|
+
if (workflow === "debug" && notReproduced)
|
|
176
|
+
nextStep = `${withRef("/bkit-debug")} [repro]`;
|
|
177
|
+
const streams = input.workstreams ?? [];
|
|
178
|
+
if (workflow === "design" && step.command === "/bkit-plan" && streams.length > 1)
|
|
179
|
+
nextStep =
|
|
180
|
+
"File the Suggested Workstreams issues, then /bkit-plan <first root workstream's new issue>";
|
|
181
|
+
// Sections.
|
|
182
|
+
const out = [
|
|
183
|
+
`Verdict: ${verdict}`,
|
|
184
|
+
`Failures: ${fails.length}`,
|
|
185
|
+
"<!-- verdict:end -->",
|
|
186
|
+
"",
|
|
187
|
+
`# ${workflow[0].toUpperCase()}${workflow.slice(1)} Summary`,
|
|
188
|
+
"",
|
|
189
|
+
"## Verdict",
|
|
190
|
+
"",
|
|
191
|
+
verdict,
|
|
192
|
+
"",
|
|
193
|
+
...(reasons.length > 0
|
|
194
|
+
? reasons.map((r) => `- ${r}`)
|
|
195
|
+
: ["- No failing step, open task, accepted item or new deferral."]),
|
|
196
|
+
];
|
|
197
|
+
if (workflow === "build")
|
|
198
|
+
out.push("", input.plans.length === 0
|
|
199
|
+
? "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(", ")}.`);
|
|
201
|
+
out.push("", "## Steps", "", "| Step | Verdict | Failures | Attempts | Artifact |", "| --- | --- | --- | --- | --- |");
|
|
202
|
+
for (const g of groups) {
|
|
203
|
+
const { row } = lastOf(g);
|
|
204
|
+
const artifact = artifactsOf(row)
|
|
205
|
+
.map((a) => `\`${a}\``)
|
|
206
|
+
.join(", ");
|
|
207
|
+
out.push(`| ${g.label} | ${str(row.verdict) ?? "-"} | ${typeof row.failures === "number" ? row.failures : "-"} | ${g.rows.length} | ${artifact || "-"} |`);
|
|
208
|
+
}
|
|
209
|
+
if (workflow === "build") {
|
|
210
|
+
const appended = tasks.filter((t) => SEVERITY.test(t.text));
|
|
211
|
+
const low = input.deferrals.filter((r) => r.by?.step === "build-challenge");
|
|
212
|
+
const gate = input.rows.filter((r) => r.type === "challenge-gate").at(-1);
|
|
213
|
+
const skipped = gate?.skipped === true;
|
|
214
|
+
out.push("", "## Challenge", "");
|
|
215
|
+
if (skipped)
|
|
216
|
+
out.push(`- challenge-1 skipped: small change (${String(gate.linesChanged)} lines, ${String(gate.filesChanged)} files)`);
|
|
217
|
+
if (appended.length === 0 && low.length === 0 && !skipped)
|
|
218
|
+
out.push("None");
|
|
219
|
+
for (const t of appended)
|
|
220
|
+
out.push(`- Task ${t.task} — ${SEVERITY.exec(t.text)[1]} — ${t.done ? "ticked" : "not ticked"} (\`${t.path}\`)`);
|
|
221
|
+
for (const r of low)
|
|
222
|
+
out.push(`- LOW, deferred: ${String(r.key ?? "")} — ${String(r.description ?? "")}`);
|
|
223
|
+
}
|
|
224
|
+
if (workflow === "build" || workflow === "debug") {
|
|
225
|
+
const runs = groups.filter((g) => RUN_TESTS.has(g.step)).flatMap((g) => g.rows);
|
|
226
|
+
out.push("", "## Tests", "");
|
|
227
|
+
if (runs.length === 0)
|
|
228
|
+
out.push("None recorded.");
|
|
229
|
+
for (const { row } of runs)
|
|
230
|
+
out.push(`- Attempt ${String(row.attempt ?? "?")}: ${str(row.verdict) ?? "-"}, failures ${typeof row.failures === "number" ? row.failures : "-"}, ran \`${str(row.scope) ?? "unknown"}\``);
|
|
231
|
+
}
|
|
232
|
+
if (workflow === "plan") {
|
|
233
|
+
const final = input.plans.at(-1)?.text ?? "";
|
|
234
|
+
out.push("", "## Acceptance Scenario", "", planSection(final, /Acceptance Scenario/) || "None", "", "## Open Questions", "", planSection(final, /Open Questions/) || "None");
|
|
235
|
+
}
|
|
236
|
+
if (workflow === "design") {
|
|
237
|
+
out.push("", "## Suggested Workstreams", "");
|
|
238
|
+
if (streams.length === 0)
|
|
239
|
+
out.push("None");
|
|
240
|
+
for (const w of streams)
|
|
241
|
+
out.push(`### ${w.id}: ${w.name}`, "", `Requires: ${w.requiresText || "None"}`, "");
|
|
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.");
|
|
244
|
+
out.push("", "## Open Questions", "", planSection(input.organised ?? "", /Risks & Open Questions/) || "None");
|
|
245
|
+
}
|
|
246
|
+
if (workflow === "ship" && input.pr !== undefined) {
|
|
247
|
+
const pr = input.pr;
|
|
248
|
+
out.push("", "## Pull Request", "", `PR #${pr.number}: +${pr.additions} / -${pr.deletions} lines across ${pr.changedFiles} files.`);
|
|
249
|
+
}
|
|
250
|
+
if (unconfirmed.length > 0)
|
|
251
|
+
out.push("", "## Ship Completed with Assumed Items", "", "Accepted without the owner and not confirmed; each is a `needs-decision` deferral.", "", ...unconfirmed.map((u) => `- ${u}`));
|
|
252
|
+
// Risks and action items.
|
|
253
|
+
const items = [];
|
|
254
|
+
for (const g of groups) {
|
|
255
|
+
for (const rel of artifactsOf(lastOf(g).row).filter((a) => a.endsWith("-log.md"))) {
|
|
256
|
+
for (const line of (read(rel) ?? "").split("\n").filter((l) => /^BLOCKED\b/.test(l)))
|
|
257
|
+
items.push(`- ${line} (\`${rel}\`)`);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
items.push(...accepted.map((a) => `- Accepted: ${a}`));
|
|
261
|
+
items.push(...assumed.map((a) => `- Assumed, not confirmed: ${a}`));
|
|
262
|
+
for (const rel of workflow === "build" ? input.decisionFiles : []) {
|
|
263
|
+
if (!/^Decision:/m.test(read(rel) ?? ""))
|
|
264
|
+
items.push(`- \`${rel}\`: no decision recorded`);
|
|
265
|
+
}
|
|
266
|
+
for (const p of input.plans) {
|
|
267
|
+
for (const line of p.text.split("\n").filter((l) => l.includes(TEST_EXCEPTION)))
|
|
268
|
+
items.push(`- \`${p.path}\`: ${line.trim()}`);
|
|
269
|
+
}
|
|
270
|
+
out.push("", "## Risks and Action Items", "", ...(items.length > 0 ? items : ["None"]));
|
|
271
|
+
out.push("", "## Recommended Next Step", "", "```text", nextStep, "```");
|
|
272
|
+
if (step.or !== undefined && !notReproduced)
|
|
273
|
+
out.push("", `Or, to address the reasons first: \`${withRef(step.or)}\``);
|
|
274
|
+
return { verdict, failures: fails.length, reasons, nextStep, markdown: `${out.join("\n")}\n` };
|
|
275
|
+
}
|