@cbartens/bkit 5.5.0 → 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 +51 -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 +20 -20
- 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 +106 -167
- package/.bkit/core/.bkit/providers.md +29 -32
- package/.bkit/core/.bkit/templates.md +44 -18
- package/.bkit/core/.bkit/trackers.md +60 -28
- package/.bkit/core/.bkit/workflows.md +399 -359
- 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 -30
- package/.bkit/core/engine/checks/after/github.ts +101 -72
- package/.bkit/core/engine/checks/after/index.ts +10 -12
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +47 -92
- 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 +10 -7
- 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 +427 -105
- 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 +59 -7
- 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 +276 -22
- 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 +325 -7
- 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 +202 -33
- 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 +30 -14
- 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 +33 -13
- 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 +75 -19
- 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 +30 -15
- 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 +28 -13
- 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 +43 -20
- 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 +16 -28
- 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 +27 -10
- 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 +22 -84
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
- package/.bkit/templates/.husky/pre-push +52 -13
- package/.bkit/templates/.prettierignore +7 -0
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +194 -0
- package/.bkit/templates/scripts/ci/check-capstone.mjs +2 -4
- package/.bkit/templates/scripts/ci/check-capstone.test.mjs +4 -23
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +104 -23
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +103 -6
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +3 -1
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +49 -29
- package/CHANGELOG.md +142 -0
- package/README.md +58 -34
- package/dist/checks/after/ci-yml.js +39 -29
- package/dist/checks/after/github.js +99 -72
- package/dist/checks/after/index.js +11 -13
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +40 -83
- 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 +7 -5
- 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 +362 -99
- 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 -7
- 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 +221 -22
- package/dist/install/manifest.js +11 -9
- package/dist/install/modules/cloud.js +22 -13
- package/dist/install/modules/core.js +326 -7
- 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 +147 -26
- 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 +114 -23
- 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/.bkit/templates/scripts/ci/lanes/check-tree-cache.mjs +0 -138
- package/.bkit/templates/scripts/ci/lanes/check-tree-cache.test.mjs +0 -181
- package/dist/commands/harvest.js +0 -353
- package/dist/tools/wording.js +0 -680
|
@@ -8,27 +8,31 @@
|
|
|
8
8
|
// be 0 there, so 0 is refused (it means the row was dropped).
|
|
9
9
|
// count routing on a DIFFERENT step, prior or not yet run: the bare count, and
|
|
10
10
|
// 0 is a legal answer (that step simply has not run).
|
|
11
|
-
import
|
|
12
|
-
import {
|
|
13
|
-
import {
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
import { activeDoneSteps, allRunsDoneSteps, lastDoneStepAllRuns, nextStrategy, runNumber, } from "../../ledgers/status.js";
|
|
13
|
+
import { ASK_POINTS, readBkitConfig, } from "../../shared/settings.js";
|
|
14
|
+
import { headlessRun } from "./runtime.js";
|
|
15
|
+
import { CommandError, EXIT, git, runGit, } from "../lib.js";
|
|
16
|
+
import { EXIT_NO_STATUS, FILE_FLAG, GROUP_FLAG, STEP_FLAG, WORKFLOW_FLAG, positiveInt, readRuns, readStatusRows, statusFile, str, } from "./status.js";
|
|
17
|
+
/** An ask point by name (`build.verify`); an unknown name is a usage error. */
|
|
18
|
+
export function askPoint(name) {
|
|
19
|
+
if (!ASK_POINTS.includes(name))
|
|
20
|
+
throw new CommandError(EXIT.USAGE, `unknown point ${name}; known: ${ASK_POINTS.join(", ")}`);
|
|
21
|
+
return name;
|
|
22
|
+
}
|
|
23
|
+
/** The checkout `cwd` sits in. */
|
|
24
|
+
const checkoutRoot = (cwd) => git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
|
|
25
|
+
/** `bkit.workflows.<point>` for the checkout `cwd` sits in. */
|
|
26
|
+
export function askSetting(cwd, point) {
|
|
27
|
+
return readBkitConfig(checkoutRoot(cwd)).asks[point];
|
|
28
|
+
}
|
|
29
|
+
/** Paths a fix round's code change is judged on: everything but plan logs and ledgers. */
|
|
30
|
+
const SOURCE_PATHS = [
|
|
31
|
+
".",
|
|
32
|
+
":(exclude)docs/plans",
|
|
33
|
+
":(exclude)docs/*.jsonl",
|
|
34
|
+
":(exclude).bkit/*.jsonl",
|
|
35
|
+
];
|
|
32
36
|
/** Exit code: `--position=current` found no row — the step's own row is missing. */
|
|
33
37
|
export const EXIT_NO_OWN_ROW = 4;
|
|
34
38
|
const nonNegativeInt = (v, flag) => {
|
|
@@ -40,7 +44,8 @@ const nonNegativeInt = (v, flag) => {
|
|
|
40
44
|
};
|
|
41
45
|
/**
|
|
42
46
|
* `--of=<step>:<position>` over `--file` / `--workflow`: the counter at that position.
|
|
43
|
-
* `--of=<step>,<step>...:count` sums the DONE rows of every listed step.
|
|
47
|
+
* `--of=<step>,<step>...:count` sums the DONE rows of every listed step. `--all-runs`
|
|
48
|
+
* counts every run of the workflow in the file, not only the active one.
|
|
44
49
|
*/
|
|
45
50
|
function derivedOf(ctx) {
|
|
46
51
|
const [list, position] = String(ctx.flags.of).split(":");
|
|
@@ -52,24 +57,110 @@ function derivedOf(ctx) {
|
|
|
52
57
|
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
53
58
|
throw new CommandError(EXIT.USAGE, "--of needs --file and --workflow");
|
|
54
59
|
const runs = readRuns(statusFile(ctx));
|
|
55
|
-
const
|
|
56
|
-
const
|
|
57
|
-
|
|
58
|
-
.length, 0);
|
|
60
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
61
|
+
const doneSteps = ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps;
|
|
62
|
+
const count = steps.reduce((n, step) => n + doneSteps(runs, String(ctx.flags.workflow), { step, group }).length, 0);
|
|
59
63
|
if (position === "current" && count === 0)
|
|
60
64
|
throw new CommandError(EXIT_NO_OWN_ROW, `${steps[0]}: no DONE row in the active run — the step's own row is missing`);
|
|
61
65
|
return position === "next" ? count + 1 : count;
|
|
62
66
|
}
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
+
/** `--all-runs`: count every run of the workflow in `--file`, not only the active one. */
|
|
68
|
+
const ALL_RUNS_FLAG = {
|
|
69
|
+
name: "all-runs",
|
|
70
|
+
type: "boolean",
|
|
71
|
+
help: "count every run of the workflow in --file, not only the active one",
|
|
72
|
+
};
|
|
73
|
+
/** Rows of `type` in `workflow`'s active run (since its last workflow-started row). */
|
|
74
|
+
function typedRowCount(file, workflow, type) {
|
|
75
|
+
const rows = readStatusRows(file);
|
|
76
|
+
let start = -1;
|
|
77
|
+
rows.forEach((r, i) => {
|
|
78
|
+
if (r.type === "workflow-started" && r.workflow === workflow)
|
|
79
|
+
start = i;
|
|
80
|
+
});
|
|
81
|
+
return rows
|
|
82
|
+
.slice(start + 1)
|
|
83
|
+
.filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
|
|
84
|
+
}
|
|
85
|
+
/** `route --rows=<type>:count`: rows of that type in the active run. */
|
|
86
|
+
function derivedRows(ctx) {
|
|
87
|
+
const [type, position] = String(ctx.flags.rows).split(":");
|
|
88
|
+
if (!type || position !== "count")
|
|
89
|
+
throw new CommandError(EXIT.USAGE, "--rows must be <row type>:count");
|
|
90
|
+
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
91
|
+
throw new CommandError(EXIT.USAGE, "--rows needs --file and --workflow");
|
|
92
|
+
return typedRowCount(statusFile(ctx), String(ctx.flags.workflow), type);
|
|
93
|
+
}
|
|
94
|
+
/** The checkout a status.jsonl under `docs/plans/` belongs to; `cwd` when it is elsewhere. */
|
|
95
|
+
function checkoutOf(file, cwd) {
|
|
96
|
+
const abs = path.resolve(cwd, file);
|
|
97
|
+
const at = abs.lastIndexOf(`${path.sep}docs${path.sep}plans${path.sep}`);
|
|
98
|
+
return at < 0 ? cwd : abs.slice(0, at);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* The loop's direction from its check rounds: `worse` when the problem count rose,
|
|
102
|
+
* `closing` when it fell and the rounds changed code, `stuck` otherwise.
|
|
103
|
+
*/
|
|
104
|
+
export function loopTrend(rounds, codeChanged) {
|
|
105
|
+
if (rounds.length < 2)
|
|
106
|
+
return "first-round";
|
|
107
|
+
const first = rounds[0]?.failures;
|
|
108
|
+
const last = rounds.at(-1)?.failures;
|
|
109
|
+
if (first === undefined || last === undefined)
|
|
110
|
+
return "stuck";
|
|
111
|
+
if (last > first)
|
|
112
|
+
return "worse";
|
|
113
|
+
if (last < first && codeChanged !== false)
|
|
114
|
+
return "closing";
|
|
115
|
+
return "stuck";
|
|
116
|
+
}
|
|
117
|
+
/** A fix loop's progress in the active run: `check` counts problems, `fix` fixes them. */
|
|
118
|
+
export function loopProgress(file, cwd, workflow, check, fix, group) {
|
|
119
|
+
const runs = readRuns(file);
|
|
120
|
+
const rounds = activeDoneSteps(runs, workflow, { step: check, group });
|
|
121
|
+
const fixes = activeDoneSteps(runs, workflow, { step: fix, group });
|
|
122
|
+
const first = rounds[0];
|
|
123
|
+
const last = rounds.at(-1);
|
|
124
|
+
let codeChanged = null;
|
|
125
|
+
if (first && last && first !== last && first.parentSha && last.parentSha) {
|
|
126
|
+
const diff = runGit(checkoutOf(file, cwd), [
|
|
127
|
+
"diff",
|
|
128
|
+
"--quiet",
|
|
129
|
+
first.parentSha,
|
|
130
|
+
last.parentSha,
|
|
131
|
+
"--",
|
|
132
|
+
...SOURCE_PATHS,
|
|
133
|
+
]);
|
|
134
|
+
// --quiet: exit 0 = no change, 1 = changed; anything else (unknown sha) leaves null.
|
|
135
|
+
if (diff.ok)
|
|
136
|
+
codeChanged = false;
|
|
137
|
+
else if (diff.stderr === "")
|
|
138
|
+
codeChanged = true;
|
|
67
139
|
}
|
|
68
|
-
|
|
140
|
+
const ladder = lastDoneStepAllRuns(runs, workflow, { step: fix, group })?.strategy;
|
|
141
|
+
const trend = loopTrend(rounds, codeChanged);
|
|
142
|
+
const span = first && last && rounds.length > 1
|
|
143
|
+
? (Date.parse(last.at) - Date.parse(first.at)) / 60000 / (rounds.length - 1)
|
|
144
|
+
: null;
|
|
145
|
+
return {
|
|
146
|
+
rounds: rounds.map((r) => ({
|
|
147
|
+
attempt: r.attempt ?? null,
|
|
148
|
+
failures: r.failures ?? null,
|
|
149
|
+
at: r.at,
|
|
150
|
+
})),
|
|
151
|
+
counts: rounds.map((r) => (r.failures === undefined ? "?" : String(r.failures))).join(" → "),
|
|
152
|
+
codeChanged,
|
|
153
|
+
lastStrategy: fixes.at(-1)?.strategy ?? null,
|
|
154
|
+
nextStrategy: nextStrategy(ladder),
|
|
155
|
+
finalSpent: fixes.some((r) => r.strategy === "FINAL") || ladder === "FINAL",
|
|
156
|
+
minutesPerRound: span === null || Number.isNaN(span) ? null : Math.round(span),
|
|
157
|
+
trend,
|
|
158
|
+
recommend: trend === "first-round" ? null : trend === "closing" ? "try-again" : "stop",
|
|
159
|
+
};
|
|
69
160
|
}
|
|
70
161
|
export const countersCommand = {
|
|
71
162
|
noun: "counters",
|
|
72
|
-
summary: "Attempt counters derived from status.jsonl, and the
|
|
163
|
+
summary: "Attempt counters derived from status.jsonl, and the ask points' limits.",
|
|
73
164
|
verbs: {
|
|
74
165
|
derive: {
|
|
75
166
|
summary: "Count a step's DONE rows in the active run, at one of three positions.",
|
|
@@ -77,18 +168,14 @@ export const countersCommand = {
|
|
|
77
168
|
FILE_FLAG,
|
|
78
169
|
WORKFLOW_FLAG,
|
|
79
170
|
STEP_FLAG,
|
|
80
|
-
|
|
171
|
+
GROUP_FLAG,
|
|
81
172
|
{
|
|
82
173
|
name: "position",
|
|
83
174
|
type: "string",
|
|
84
175
|
required: true,
|
|
85
176
|
help: "next (step start: count+1) | current (after own row: count, 0 refused) | count (other step: 0 legal)",
|
|
86
177
|
},
|
|
87
|
-
|
|
88
|
-
name: "since",
|
|
89
|
-
type: "string",
|
|
90
|
-
help: "run field holding a timestamp; only rows after it count (soakEntryAt)",
|
|
91
|
-
},
|
|
178
|
+
ALL_RUNS_FLAG,
|
|
92
179
|
],
|
|
93
180
|
output: { value: "the counter at that position", count: "DONE rows counted" },
|
|
94
181
|
exitCodes: {
|
|
@@ -100,7 +187,7 @@ export const countersCommand = {
|
|
|
100
187
|
if (!["next", "current", "count"].includes(position)) {
|
|
101
188
|
throw new CommandError(EXIT.USAGE, "--position must be next, current, or count");
|
|
102
189
|
}
|
|
103
|
-
const count = activeDoneSteps(readRuns(statusFile(ctx)), String(ctx.flags.workflow), { step: String(ctx.flags.step),
|
|
190
|
+
const count = (ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps)(readRuns(statusFile(ctx)), String(ctx.flags.workflow), { step: String(ctx.flags.step), group: positiveInt(ctx.flags.group, "group") }).length;
|
|
104
191
|
if (position === "current" && count === 0) {
|
|
105
192
|
ctx.log(`${String(ctx.flags.step)}: no DONE row in the active run — the step's own row is missing`);
|
|
106
193
|
return EXIT_NO_OWN_ROW;
|
|
@@ -120,29 +207,34 @@ export const countersCommand = {
|
|
|
120
207
|
},
|
|
121
208
|
},
|
|
122
209
|
route: {
|
|
123
|
-
summary: "Compare a counter to its max: exit 0 continue, exit 1 exceeded.",
|
|
210
|
+
summary: "Compare a counter to its max: exit 0 continue, exit 1 exceeded; with --point, also whether to ask.",
|
|
124
211
|
flags: [
|
|
125
212
|
{ name: "name", type: "string", required: true, help: "counter name, for the log line" },
|
|
126
213
|
{
|
|
127
214
|
name: "value",
|
|
128
215
|
type: "string",
|
|
129
|
-
help: "counter value (non-negative integer), or derive it with --of",
|
|
216
|
+
help: "counter value (non-negative integer), or derive it with --of / --rows",
|
|
130
217
|
},
|
|
131
218
|
{
|
|
132
219
|
name: "of",
|
|
133
220
|
type: "string",
|
|
134
221
|
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
135
222
|
},
|
|
136
|
-
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of" },
|
|
137
|
-
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of" },
|
|
138
|
-
{ ...SUB_PLAN_FLAG, help: "with --of: only rows for this sub-plan" },
|
|
139
223
|
{
|
|
140
|
-
name: "
|
|
224
|
+
name: "rows",
|
|
225
|
+
type: "string",
|
|
226
|
+
help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
|
|
227
|
+
},
|
|
228
|
+
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
|
|
229
|
+
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
|
|
230
|
+
{ ...GROUP_FLAG, help: "with --of: only rows for this plan group" },
|
|
231
|
+
{ ...ALL_RUNS_FLAG, help: "with --of: count every run of the workflow in --file" },
|
|
232
|
+
{ name: "max", type: "string", help: "max as a number (or use --point)" },
|
|
233
|
+
{
|
|
234
|
+
name: "point",
|
|
141
235
|
type: "string",
|
|
142
|
-
help:
|
|
236
|
+
help: `ask point whose limit is the max: ${ASK_POINTS.join(" | ")}`,
|
|
143
237
|
},
|
|
144
|
-
{ name: "max", type: "string", help: "max as a number (or use --limit)" },
|
|
145
|
-
{ name: "limit", type: "string", help: "max as a threshold name, e.g. MAX_VERIFY_ATTEMPT" },
|
|
146
238
|
{ name: "continue", type: "string", help: "step to go to when value <= max" },
|
|
147
239
|
{ name: "exceeded", type: "string", help: "step to go to when value > max" },
|
|
148
240
|
],
|
|
@@ -151,46 +243,97 @@ export const countersCommand = {
|
|
|
151
243
|
exceeded: "true when value > max",
|
|
152
244
|
next: "--continue or --exceeded step, whichever applies (null when not given)",
|
|
153
245
|
max: "the max compared against",
|
|
246
|
+
ask: "with --point: the point's ask setting, false when headless (GITHUB_ACTION); else false",
|
|
154
247
|
},
|
|
155
248
|
exitCodes: {
|
|
156
|
-
[EXIT_NO_STATUS]: "--of: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
249
|
+
[EXIT_NO_STATUS]: "--of / --rows: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
157
250
|
[EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
|
|
158
251
|
},
|
|
159
252
|
run: (ctx) => {
|
|
160
253
|
const name = String(ctx.flags.name);
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
254
|
+
const derived = ctx.flags.of !== undefined || ctx.flags.rows !== undefined;
|
|
255
|
+
if (derived === (ctx.flags.value !== undefined))
|
|
256
|
+
throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
|
|
257
|
+
const value = derived
|
|
258
|
+
? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
|
|
259
|
+
(ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
|
|
260
|
+
: nonNegativeInt(ctx.flags.value, "value");
|
|
261
|
+
if ((ctx.flags.max === undefined) === (ctx.flags.point === undefined)) {
|
|
262
|
+
throw new CommandError(EXIT.USAGE, "give exactly one of --max or --point");
|
|
166
263
|
}
|
|
167
|
-
const
|
|
168
|
-
|
|
169
|
-
|
|
264
|
+
const point = ctx.flags.point === undefined ? undefined : askPoint(String(ctx.flags.point));
|
|
265
|
+
const setting = point === undefined ? undefined : askSetting(ctx.cwd, point);
|
|
266
|
+
const max = setting === undefined ? nonNegativeInt(ctx.flags.max, "max") : setting.max;
|
|
170
267
|
const exceeded = value > max;
|
|
171
268
|
if (exceeded)
|
|
172
269
|
ctx.log(`counter ${name} exceeded max=${max} (value=${value})`);
|
|
173
270
|
ctx.emit({
|
|
174
271
|
value,
|
|
175
272
|
exceeded,
|
|
176
|
-
next:
|
|
273
|
+
next: (exceeded ? str(ctx.flags.exceeded) : str(ctx.flags.continue)) ?? null,
|
|
177
274
|
max,
|
|
275
|
+
ask: setting !== undefined && setting.ask && !headlessRun(ctx.cwd),
|
|
178
276
|
});
|
|
179
277
|
return exceeded ? EXIT.NO : EXIT.OK;
|
|
180
278
|
},
|
|
181
279
|
},
|
|
182
280
|
max: {
|
|
183
|
-
summary: "The
|
|
281
|
+
summary: "The ask points' limits and ask settings: one by --point, or all.",
|
|
282
|
+
flags: [{ name: "point", type: "string", help: "ask point, e.g. debug.fix" }],
|
|
283
|
+
output: {
|
|
284
|
+
value: "the point's limit (with --point)",
|
|
285
|
+
ask: "the point's ask setting, false when headless (with --point)",
|
|
286
|
+
points: "every point's {ask, max} as set (without --point)",
|
|
287
|
+
},
|
|
288
|
+
run: (ctx) => {
|
|
289
|
+
const name = str(ctx.flags.point);
|
|
290
|
+
if (name === undefined) {
|
|
291
|
+
ctx.emit({ points: readBkitConfig(checkoutRoot(ctx.cwd)).asks });
|
|
292
|
+
return EXIT.OK;
|
|
293
|
+
}
|
|
294
|
+
const setting = askSetting(ctx.cwd, askPoint(name));
|
|
295
|
+
ctx.emit({
|
|
296
|
+
value: setting.max,
|
|
297
|
+
ask: setting.ask && !headlessRun(ctx.cwd),
|
|
298
|
+
});
|
|
299
|
+
return EXIT.OK;
|
|
300
|
+
},
|
|
301
|
+
},
|
|
302
|
+
progress: {
|
|
303
|
+
summary: "Progress report for a fix loop in the active run: counts per round, code change, strategy, trend.",
|
|
184
304
|
flags: [
|
|
185
|
-
|
|
305
|
+
FILE_FLAG,
|
|
306
|
+
WORKFLOW_FLAG,
|
|
307
|
+
{
|
|
308
|
+
name: "check",
|
|
309
|
+
type: "string",
|
|
310
|
+
required: true,
|
|
311
|
+
help: "the step that counts problems, e.g. build-plan-verify",
|
|
312
|
+
},
|
|
313
|
+
{
|
|
314
|
+
name: "fix",
|
|
315
|
+
type: "string",
|
|
316
|
+
required: true,
|
|
317
|
+
help: "the step that fixes them, e.g. build-plan-gaps-remediate",
|
|
318
|
+
},
|
|
319
|
+
GROUP_FLAG,
|
|
186
320
|
],
|
|
187
321
|
output: {
|
|
188
|
-
|
|
189
|
-
|
|
322
|
+
rounds: "the check rounds counted: attempt, failures, at",
|
|
323
|
+
counts: "problem count after each round, e.g. 5 → 2",
|
|
324
|
+
codeChanged: "source changed between the first and last check round (null when git cannot tell)",
|
|
325
|
+
lastStrategy: "strategy of the last fix round (null when none ran)",
|
|
326
|
+
nextStrategy: "strategy the next fix round would use",
|
|
327
|
+
finalSpent: "true when a fix round already ran FINAL",
|
|
328
|
+
minutesPerRound: "average minutes between check rounds (null under two rounds)",
|
|
329
|
+
trend: "first-round | closing | stuck | worse",
|
|
330
|
+
recommend: "try-again when closing, else stop (null on the first round)",
|
|
190
331
|
},
|
|
332
|
+
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
|
|
191
333
|
run: (ctx) => {
|
|
192
|
-
|
|
193
|
-
|
|
334
|
+
ctx.emit({
|
|
335
|
+
...loopProgress(statusFile(ctx), ctx.cwd, String(ctx.flags.workflow), String(ctx.flags.check), String(ctx.flags.fix), positiveInt(ctx.flags.group, "group")),
|
|
336
|
+
});
|
|
194
337
|
return EXIT.OK;
|
|
195
338
|
},
|
|
196
339
|
},
|
|
@@ -218,17 +361,7 @@ export const countersCommand = {
|
|
|
218
361
|
const position = String(ctx.flags.position);
|
|
219
362
|
if (!["next", "count"].includes(position))
|
|
220
363
|
throw new CommandError(EXIT.USAGE, "--position must be next or count");
|
|
221
|
-
const
|
|
222
|
-
const type = String(ctx.flags.type);
|
|
223
|
-
const rows = readStatusRows(statusFile(ctx));
|
|
224
|
-
let start = -1;
|
|
225
|
-
rows.forEach((r, i) => {
|
|
226
|
-
if (r.type === "workflow-started" && r.workflow === workflow)
|
|
227
|
-
start = i;
|
|
228
|
-
});
|
|
229
|
-
const count = rows
|
|
230
|
-
.slice(start + 1)
|
|
231
|
-
.filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
|
|
364
|
+
const count = typedRowCount(statusFile(ctx), String(ctx.flags.workflow), String(ctx.flags.type));
|
|
232
365
|
ctx.emit({ value: position === "next" ? count + 1 : count, count });
|
|
233
366
|
return EXIT.OK;
|
|
234
367
|
},
|