spec-controller 0.1.230 → 0.1.231
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/dist/cli.js +108 -94
- package/package.json +2 -2
package/dist/cli.js
CHANGED
|
@@ -88,52 +88,6 @@ var init_messages = __esm({
|
|
|
88
88
|
"src/messages.ts"() {
|
|
89
89
|
"use strict";
|
|
90
90
|
APP_MESSAGES = {
|
|
91
|
-
[0 /* HelpTitle */]: () => "spec-controller \u2014 reconcile scenarios against observed evidence",
|
|
92
|
-
[1 /* HelpUsage */]: () => "Usage:",
|
|
93
|
-
[2 /* HelpCommands */]: () => "Commands:",
|
|
94
|
-
[3 /* HelpHostModifiers */]: () => "Host modifiers (before the command):",
|
|
95
|
-
[4 /* HelpOptions */]: () => "Options:",
|
|
96
|
-
[5 /* HelpArguments */]: () => "Arguments:",
|
|
97
|
-
[6 /* HelpPointer */]: () => "Full flags, examples, and CI wiring: docs/user-guide.md.",
|
|
98
|
-
[7 /* HelpFlag */]: () => "Show this help and exit.",
|
|
99
|
-
[8 /* StoreModifier */]: () => "Store the run: write <root>/<target>/<run-id>/ with the reconciliation outputs + a run.yaml manifest. Required to store; there is no default (a default would write inside the repo).",
|
|
100
|
-
[9 /* RunIdModifier */]: () => "Name the stored run (default: an ISO-8601 UTC timestamp). Read only with --store: given without it, the run is refused, since no run would be kept under the name.",
|
|
101
|
-
[10 /* BalanceSummary */]: () => "Reconcile Gherkin scenarios against test/CI evidence and emit the Evidence Reconciliation (Markdown to stdout by default).",
|
|
102
|
-
[11 /* FeaturesFlag */]: () => "Directory of Gherkin .feature files \u2014 the scenarios, and the `@`-tags naming what each must prove (@unit, @integration, @fitness, \u2026).",
|
|
103
|
-
[12 /* VitestFlag */]: () => "A Vitest JSON report \u2014 runtime test evidence.",
|
|
104
|
-
[13 /* PytestFlag */]: () => "A pytest JUnit XML report (pytest --junitxml) \u2014 runtime unit test evidence.",
|
|
105
|
-
[14 /* JestFlag */]: () => "A Jest JSON report (jest --json --outputFile) \u2014 runtime unit test evidence.",
|
|
106
|
-
[15 /* JunitFlag */]: () => "A JUnit XML report from any test runner that writes one, such as gotestsum --junitfile, or a directory of them, such as Maven Surefire's \u2014 runtime unit test evidence.",
|
|
107
|
-
[16 /* RspecFlag */]: () => "An RSpec JSON report (rspec --format json --out) \u2014 runtime unit test evidence.",
|
|
108
|
-
[17 /* CucumberFlag */]: () => "A Cucumber JSON report \u2014 runtime test evidence.",
|
|
109
|
-
[18 /* CiFlag */]: () => "Your CI workflows \u2014 a file, or a directory of them (default .github/workflows). Where a fitness function you have not converted is found running over the real source, and where a check step's `id:` supplies the @SCN its result cites.",
|
|
110
|
-
[19 /* PackageJsonFlag */]: () => "The target's package.json \u2014 its `scripts`, and its specController.runners, specController.notChecks and specController.deferralTags. A fitness function is named by its @fitness scenario and the CI step whose id: is that scenario's @SCN; no manifest key names one.",
|
|
111
|
-
[20 /* CiStepsFlag */]: () => "The CI run's own record of what each of its steps did \u2014 your pipeline's `toJSON(steps)` dump, evidence for the converted fitness functions. Omit it if you have converted none.",
|
|
112
|
-
[21 /* TargetFlag */]: () => "A name recorded verbatim in the report's provenance (which project this run reconciled).",
|
|
113
|
-
[22 /* SourceShaFlag */]: () => "Override the git commit SHA recorded in provenance (defaults to the resolved HEAD).",
|
|
114
|
-
[23 /* FormatFlag */]: () => "Where to send output (md or json, optionally :<path> to write to a file). Repeatable.",
|
|
115
|
-
[24 /* RenderFromJsonFlag */]: () => "Re-render Markdown from a previously saved Evidence Reconciliation JSON \u2014 no reconcile, no live inputs.",
|
|
116
|
-
[25 /* StrictFlag */]: () => "Fail the run (exit 3) when it carries Pending Items \u2014 the opt-in that escalates otherwise-run-neutral deferred obligations.",
|
|
117
|
-
[26 /* ExitZeroFlag */]: () => "Print the same report but exit 0 on an out-of-balance or scenario-code-error (1) or --strict pending (3) verdict \u2014 the on-ramp before gating. Usage (2), unsound (4) and nothing-to-reconcile (5) still fail.",
|
|
118
|
-
[27 /* ConfigurationHeading */]: () => "Configuration (in the target repo's package.json):",
|
|
119
|
-
[28 /* DeferralTagsKey */]: () => "specController.deferralTags: string[]",
|
|
120
|
-
[29 /* DeferralTagsExtend */]: () => "Extra recognised deferral tags. A scenario carrying one defers every obligation it",
|
|
121
|
-
[30 /* DeferralTagsNeverReplace */]: () => "names to a Pending Item, extending (never replacing) the built-in set.",
|
|
122
|
-
[31 /* BuiltInDeferralTags */]: (tags) => `Built-in deferral tags: ${tags}`,
|
|
123
|
-
[32 /* MeasurementsReplacement */]: () => "A fitness function's evidence observation is the outcome of its own CI step: put the check's @SCN on that step's `id:` and hand balance the run's step record with --ci-steps.",
|
|
124
|
-
[33 /* AllocateSummary */]: () => "Print the next @SCN code for a feature part: one past the highest the repository has ever carried, the code alone on stdout.",
|
|
125
|
-
[34 /* FeaturePartArgument */]: () => "The feature part: a feature file's header code, two to five of A-Z and 0-9.",
|
|
126
|
-
[35 /* NewFlag */]: () => "Start a part no feature file's header carries yet: its first code, or one past any number the repository already carries for it.",
|
|
127
|
-
[36 /* HistoryBoundary */]: (unread, risk) => `history: ${unread}; ${risk} may have been used before`,
|
|
128
|
-
[37 /* ShallowHistoryUnread */]: (before) => `shallow clone \u2014 history before ${before} unread`,
|
|
129
|
-
[38 /* NoRepositoryHistoryRead */]: () => "not a git repository \u2014 none read",
|
|
130
|
-
[39 /* RiskOfPartCode */]: (part) => `a code of ${part}`,
|
|
131
|
-
[40 /* RiskAboveCode */]: (code) => `a code above ${code}`,
|
|
132
|
-
[41 /* HighestSeenNone */]: () => "highest seen: none",
|
|
133
|
-
[42 /* HighestSeenInTree */]: (code, path, line) => `highest seen: ${code}, ${path}:${line}`,
|
|
134
|
-
[43 /* HighestSeenInCommit */]: (code, path, line, commit) => `highest seen: ${code}, ${path}:${line} in ${commit}`,
|
|
135
|
-
[44 /* PartAlreadyHeaded */]: (part) => `note: a feature file's header already carries ${part}, so --new was not needed`,
|
|
136
|
-
[45 /* HelpUsageLine */]: (modifierUsage) => `spec-controller ${modifierUsage} <command> [command-args]`,
|
|
137
91
|
["unexpected-error" /* UnexpectedError */]: (name, firstLine2) => `spec-controller stopped on an unexpected error [${"unexpected-error" /* UnexpectedError */}], and gives no verdict: ${name}: ${firstLine2}`,
|
|
138
92
|
["unexpected-error-after-verdict" /* UnexpectedErrorAfterVerdict */]: (name, firstLine2) => `spec-controller hit an unexpected error [${"unexpected-error-after-verdict" /* UnexpectedErrorAfterVerdict */}] after its verdict: ${name}: ${firstLine2}`
|
|
139
93
|
};
|
|
@@ -32602,7 +32556,51 @@ var init_messages_en2 = __esm({
|
|
|
32602
32556
|
"shape-kind-of-type": "a {type}",
|
|
32603
32557
|
"shape-top-level": "the top level",
|
|
32604
32558
|
"shape-wrong-kind": "{where} is {found}, not {expected}",
|
|
32605
|
-
"shape-field-missing": "{path} is missing"
|
|
32559
|
+
"shape-field-missing": "{path} is missing",
|
|
32560
|
+
"help-title": "spec-controller \u2014 reconcile scenarios against observed evidence",
|
|
32561
|
+
"help-usage": "Usage:",
|
|
32562
|
+
"help-commands": "Commands:",
|
|
32563
|
+
"help-host-modifiers": "Host modifiers (before the command):",
|
|
32564
|
+
"help-options": "Options:",
|
|
32565
|
+
"help-arguments": "Arguments:",
|
|
32566
|
+
"help-pointer": "Full flags, examples, and CI wiring: docs/user-guide.md.",
|
|
32567
|
+
"help-flag": "Show this help and exit.",
|
|
32568
|
+
"store-modifier": "Store the run: write <root>/<target>/<run-id>/ with the reconciliation outputs + a run.yaml manifest. Required to store; there is no default (a default would write inside the repo).",
|
|
32569
|
+
"run-id-modifier": "Name the stored run (default: an ISO-8601 UTC timestamp). Read only with --store: given without it, the run is refused, since no run would be kept under the name.",
|
|
32570
|
+
"balance-summary": "Reconcile Gherkin scenarios against test/CI evidence and emit the Evidence Reconciliation (Markdown to stdout by default).",
|
|
32571
|
+
"features-flag": "Directory of Gherkin .feature files \u2014 the scenarios, and the `@`-tags naming what each must prove (@unit, @integration, @fitness, \u2026).",
|
|
32572
|
+
"vitest-flag": "A Vitest JSON report \u2014 runtime test evidence.",
|
|
32573
|
+
"pytest-flag": "A pytest JUnit XML report (pytest --junitxml) \u2014 runtime unit test evidence.",
|
|
32574
|
+
"jest-flag": "A Jest JSON report (jest --json --outputFile) \u2014 runtime unit test evidence.",
|
|
32575
|
+
"junit-flag": "A JUnit XML report from any test runner that writes one, such as gotestsum --junitfile, or a directory of them, such as Maven Surefire's \u2014 runtime unit test evidence.",
|
|
32576
|
+
"rspec-flag": "An RSpec JSON report (rspec --format json --out) \u2014 runtime unit test evidence.",
|
|
32577
|
+
"cucumber-flag": "A Cucumber JSON report \u2014 runtime test evidence.",
|
|
32578
|
+
"ci-flag": "Your CI workflows \u2014 a file, or a directory of them (default .github/workflows). Where a fitness function you have not converted is found running over the real source, and where a check step's `id:` supplies the @SCN its result cites.",
|
|
32579
|
+
"package-json-flag": "The target's package.json \u2014 its `scripts`, and its specController.runners, specController.notChecks and specController.deferralTags. A fitness function is named by its @fitness scenario and the CI step whose id: is that scenario's @SCN; no manifest key names one.",
|
|
32580
|
+
"ci-steps-flag": "The CI run's own record of what each of its steps did \u2014 your pipeline's `toJSON(steps)` dump, evidence for the converted fitness functions. Omit it if you have converted none.",
|
|
32581
|
+
"target-flag": "A name recorded verbatim in the report's provenance (which project this run reconciled).",
|
|
32582
|
+
"source-sha-flag": "Override the git commit SHA recorded in provenance (defaults to the resolved HEAD).",
|
|
32583
|
+
"format-flag": "Where to send output (md or json, optionally :<path> to write to a file). Repeatable.",
|
|
32584
|
+
"render-from-json-flag": "Re-render Markdown from a previously saved Evidence Reconciliation JSON \u2014 no reconcile, no live inputs.",
|
|
32585
|
+
"strict-flag": "Fail the run (exit 3) when it carries Pending Items \u2014 the opt-in that escalates otherwise-run-neutral deferred obligations.",
|
|
32586
|
+
"exit-zero-flag": "Print the same report but exit 0 on an out-of-balance or scenario-code-error (1) or --strict pending (3) verdict \u2014 the on-ramp before gating. Usage (2), unsound (4) and nothing-to-reconcile (5) still fail.",
|
|
32587
|
+
"configuration-heading": "Configuration (in the target repo's package.json):",
|
|
32588
|
+
"deferral-tags-key": "specController.deferralTags: string[]",
|
|
32589
|
+
"deferral-tags-explanation": "Extra recognised deferral tags. A scenario carrying one defers every obligation it\nnames to a Pending Item, extending (never replacing) the built-in set.",
|
|
32590
|
+
"built-in-deferral-tags": "Built-in deferral tags: {tags}",
|
|
32591
|
+
"measurements-replacement": "A fitness function's evidence observation is the outcome of its own CI step: put the check's @SCN on that step's `id:` and hand balance the run's step record with --ci-steps.",
|
|
32592
|
+
"allocate-summary": "Print the next @SCN code for a feature part: one past the highest the repository has ever carried, the code alone on stdout.",
|
|
32593
|
+
"feature-part-argument": "The feature part: a feature file's header code, two to five of A-Z and 0-9.",
|
|
32594
|
+
"new-flag": "Start a part no feature file's header carries yet: its first code, or one past any number the repository already carries for it.",
|
|
32595
|
+
"shallow-history-risks-part-code": "history: shallow clone \u2014 history before {before} unread; a code of {part} may have been used before",
|
|
32596
|
+
"shallow-history-risks-code-above": "history: shallow clone \u2014 history before {before} unread; a code above {code} may have been used before",
|
|
32597
|
+
"no-repository-risks-part-code": "history: not a git repository \u2014 none read; a code of {part} may have been used before",
|
|
32598
|
+
"no-repository-risks-code-above": "history: not a git repository \u2014 none read; a code above {code} may have been used before",
|
|
32599
|
+
"highest-seen-none": "highest seen: none",
|
|
32600
|
+
"highest-seen-in-tree": "highest seen: {code}, {path}:{line}",
|
|
32601
|
+
"highest-seen-in-commit": "highest seen: {code}, {path}:{line} in {commit}",
|
|
32602
|
+
"part-already-headed": "note: a feature file's header already carries {part}, so --new was not needed",
|
|
32603
|
+
"help-usage-line": "spec-controller {modifierUsage} <command> [command-args]"
|
|
32606
32604
|
};
|
|
32607
32605
|
}
|
|
32608
32606
|
});
|
|
@@ -32990,12 +32988,12 @@ var init_evidenceInputs = __esm({
|
|
|
32990
32988
|
init_messages();
|
|
32991
32989
|
init_inputShapes();
|
|
32992
32990
|
DECLARED = [
|
|
32993
|
-
{ flag: "features", key: "features", arg: "<dir>", description:
|
|
32991
|
+
{ flag: "features", key: "features", arg: "<dir>", description: "features-flag" /* FeaturesFlag */ },
|
|
32994
32992
|
{
|
|
32995
32993
|
flag: "vitest",
|
|
32996
32994
|
key: "vitest",
|
|
32997
32995
|
arg: "<report.json>",
|
|
32998
|
-
description:
|
|
32996
|
+
description: "vitest-flag" /* VitestFlag */,
|
|
32999
32997
|
report: {
|
|
33000
32998
|
reader: "vitest",
|
|
33001
32999
|
format: "json",
|
|
@@ -33008,7 +33006,7 @@ var init_evidenceInputs = __esm({
|
|
|
33008
33006
|
flag: "pytest",
|
|
33009
33007
|
key: "pytest",
|
|
33010
33008
|
arg: "<report.xml>",
|
|
33011
|
-
description:
|
|
33009
|
+
description: "pytest-flag" /* PytestFlag */,
|
|
33012
33010
|
report: {
|
|
33013
33011
|
reader: "pytest",
|
|
33014
33012
|
format: "junit-xml",
|
|
@@ -33021,7 +33019,7 @@ var init_evidenceInputs = __esm({
|
|
|
33021
33019
|
flag: "jest",
|
|
33022
33020
|
key: "jest",
|
|
33023
33021
|
arg: "<report.json>",
|
|
33024
|
-
description:
|
|
33022
|
+
description: "jest-flag" /* JestFlag */,
|
|
33025
33023
|
report: {
|
|
33026
33024
|
reader: "jest",
|
|
33027
33025
|
format: "json-naming-its-shape",
|
|
@@ -33034,7 +33032,7 @@ var init_evidenceInputs = __esm({
|
|
|
33034
33032
|
flag: "junit",
|
|
33035
33033
|
key: "junit",
|
|
33036
33034
|
arg: "<report.xml>",
|
|
33037
|
-
description:
|
|
33035
|
+
description: "junit-flag" /* JunitFlag */,
|
|
33038
33036
|
report: {
|
|
33039
33037
|
reader: "junit",
|
|
33040
33038
|
format: "junit-xml-or-one-suite",
|
|
@@ -33048,7 +33046,7 @@ var init_evidenceInputs = __esm({
|
|
|
33048
33046
|
flag: "rspec",
|
|
33049
33047
|
key: "rspec",
|
|
33050
33048
|
arg: "<report.json>",
|
|
33051
|
-
description:
|
|
33049
|
+
description: "rspec-flag" /* RspecFlag */,
|
|
33052
33050
|
report: {
|
|
33053
33051
|
reader: "rspec",
|
|
33054
33052
|
format: "json-naming-its-shape",
|
|
@@ -33061,7 +33059,7 @@ var init_evidenceInputs = __esm({
|
|
|
33061
33059
|
flag: "cucumber",
|
|
33062
33060
|
key: "cucumber",
|
|
33063
33061
|
arg: "<report.json>",
|
|
33064
|
-
description:
|
|
33062
|
+
description: "cucumber-flag" /* CucumberFlag */,
|
|
33065
33063
|
report: {
|
|
33066
33064
|
reader: "cucumber",
|
|
33067
33065
|
format: "json",
|
|
@@ -33070,12 +33068,12 @@ var init_evidenceInputs = __esm({
|
|
|
33070
33068
|
writer: "cucumber-report-shape" /* CucumberReportShape */
|
|
33071
33069
|
}
|
|
33072
33070
|
},
|
|
33073
|
-
{ flag: "ci", key: "ci", arg: "<ci.yml>", description:
|
|
33071
|
+
{ flag: "ci", key: "ci", arg: "<ci.yml>", description: "ci-flag" /* CiFlag */ },
|
|
33074
33072
|
{
|
|
33075
33073
|
flag: "package-json",
|
|
33076
33074
|
key: "packageJson",
|
|
33077
33075
|
arg: "<path>",
|
|
33078
|
-
description:
|
|
33076
|
+
description: "package-json-flag" /* PackageJsonFlag */,
|
|
33079
33077
|
report: {
|
|
33080
33078
|
reader: "package-manifest",
|
|
33081
33079
|
format: "json",
|
|
@@ -33088,7 +33086,7 @@ var init_evidenceInputs = __esm({
|
|
|
33088
33086
|
flag: "ci-steps",
|
|
33089
33087
|
key: "ciSteps",
|
|
33090
33088
|
arg: "<record.json>",
|
|
33091
|
-
description:
|
|
33089
|
+
description: "ci-steps-flag" /* CiStepsFlag */,
|
|
33092
33090
|
report: {
|
|
33093
33091
|
reader: "ci-step-record",
|
|
33094
33092
|
format: "json",
|
|
@@ -38282,6 +38280,9 @@ var init_keptRun = __esm({
|
|
|
38282
38280
|
});
|
|
38283
38281
|
|
|
38284
38282
|
// src/cliRegistry.ts
|
|
38283
|
+
function explainingLines(entry) {
|
|
38284
|
+
return entry.split("\n").map((line) => ` ${line}`);
|
|
38285
|
+
}
|
|
38285
38286
|
function flagLabel(flag) {
|
|
38286
38287
|
const names = [flag.name, ...flag.aliases ?? []].join(", ");
|
|
38287
38288
|
return flag.arg !== void 0 ? `${names} ${flag.arg}` : names;
|
|
@@ -38298,7 +38299,7 @@ function renderCommandHelp(command) {
|
|
|
38298
38299
|
`spec-controller ${command.name} \u2014 ${command.summary}`,
|
|
38299
38300
|
...positionalHelp(command.name, command.positionals ?? []),
|
|
38300
38301
|
"",
|
|
38301
|
-
|
|
38302
|
+
message("help-options" /* HelpOptions */),
|
|
38302
38303
|
...lines,
|
|
38303
38304
|
...configHelp.length > 0 ? ["", ...configHelp] : []
|
|
38304
38305
|
].join("\n");
|
|
@@ -38308,9 +38309,9 @@ function positionalHelp(command, positionals) {
|
|
|
38308
38309
|
const width = Math.max(...positionals.map((positional) => positional.name.length));
|
|
38309
38310
|
return [
|
|
38310
38311
|
"",
|
|
38311
|
-
`${
|
|
38312
|
+
`${message("help-usage" /* HelpUsage */)} spec-controller ${command} ${positionals.map((positional) => positional.name).join(" ")} [options]`,
|
|
38312
38313
|
"",
|
|
38313
|
-
|
|
38314
|
+
message("help-arguments" /* HelpArguments */),
|
|
38314
38315
|
...positionals.map((positional) => ` ${positional.name.padEnd(width + 2)}${positional.description}`)
|
|
38315
38316
|
];
|
|
38316
38317
|
}
|
|
@@ -38327,18 +38328,18 @@ function renderTopLevelHelp(registry) {
|
|
|
38327
38328
|
);
|
|
38328
38329
|
const modifierUsage = registry.global.map((flag) => `[${flagLabel(flag)}]`).join(" ");
|
|
38329
38330
|
return [
|
|
38330
|
-
|
|
38331
|
+
message("help-title" /* HelpTitle */),
|
|
38331
38332
|
"",
|
|
38332
|
-
|
|
38333
|
-
` ${
|
|
38333
|
+
message("help-usage" /* HelpUsage */),
|
|
38334
|
+
` ${message("help-usage-line" /* HelpUsageLine */, { modifierUsage })}`,
|
|
38334
38335
|
"",
|
|
38335
|
-
|
|
38336
|
+
message("help-commands" /* HelpCommands */),
|
|
38336
38337
|
...commandLines,
|
|
38337
38338
|
"",
|
|
38338
|
-
|
|
38339
|
+
message("help-host-modifiers" /* HelpHostModifiers */),
|
|
38339
38340
|
...modifierLines,
|
|
38340
38341
|
"",
|
|
38341
|
-
|
|
38342
|
+
message("help-pointer" /* HelpPointer */)
|
|
38342
38343
|
].join("\n");
|
|
38343
38344
|
}
|
|
38344
38345
|
var balanceFlags, balanceConfigHelp, balanceRetiredFlags, globalFlags, balanceCommand, allocateCommand, cliRegistry;
|
|
@@ -38347,90 +38348,90 @@ var init_cliRegistry = __esm({
|
|
|
38347
38348
|
"use strict";
|
|
38348
38349
|
init_dist3();
|
|
38349
38350
|
init_messages();
|
|
38351
|
+
init_appText();
|
|
38350
38352
|
init_evidenceInputs();
|
|
38351
38353
|
balanceFlags = [
|
|
38352
|
-
...EVIDENCE_INPUTS.map(({ flag, arg, description }) => ({ name: `--${flag}`, arg, description:
|
|
38354
|
+
...EVIDENCE_INPUTS.map(({ flag, arg, description }) => ({ name: `--${flag}`, arg, description: message(description) })),
|
|
38353
38355
|
{
|
|
38354
38356
|
name: "--target",
|
|
38355
38357
|
arg: "<name>",
|
|
38356
|
-
description:
|
|
38358
|
+
description: message("target-flag" /* TargetFlag */)
|
|
38357
38359
|
},
|
|
38358
38360
|
{
|
|
38359
38361
|
name: "--source-sha",
|
|
38360
38362
|
arg: "<sha>",
|
|
38361
|
-
description:
|
|
38363
|
+
description: message("source-sha-flag" /* SourceShaFlag */)
|
|
38362
38364
|
},
|
|
38363
38365
|
{
|
|
38364
38366
|
name: "--format",
|
|
38365
38367
|
arg: "<fmt>[:<path>]",
|
|
38366
38368
|
repeatable: true,
|
|
38367
|
-
description:
|
|
38369
|
+
description: message("format-flag" /* FormatFlag */)
|
|
38368
38370
|
},
|
|
38369
38371
|
{
|
|
38370
38372
|
name: "--render-from-json",
|
|
38371
38373
|
arg: "<path>",
|
|
38372
|
-
description:
|
|
38374
|
+
description: message("render-from-json-flag" /* RenderFromJsonFlag */)
|
|
38373
38375
|
},
|
|
38374
38376
|
{
|
|
38375
38377
|
name: "--strict",
|
|
38376
|
-
description:
|
|
38378
|
+
description: message("strict-flag" /* StrictFlag */)
|
|
38377
38379
|
},
|
|
38378
38380
|
{
|
|
38379
38381
|
name: "--exit-zero",
|
|
38380
|
-
description:
|
|
38382
|
+
description: message("exit-zero-flag" /* ExitZeroFlag */)
|
|
38381
38383
|
},
|
|
38382
38384
|
{
|
|
38383
38385
|
name: "--help",
|
|
38384
38386
|
aliases: ["-h"],
|
|
38385
|
-
description:
|
|
38387
|
+
description: message("help-flag" /* HelpFlag */)
|
|
38386
38388
|
}
|
|
38387
38389
|
];
|
|
38388
38390
|
balanceConfigHelp = [
|
|
38389
|
-
|
|
38390
|
-
` ${
|
|
38391
|
-
|
|
38392
|
-
|
|
38393
|
-
` ${APP_MESSAGES[31 /* BuiltInDeferralTags */](BUILT_IN_DEFERRAL_TAGS.map((tag) => `@${tag}`).join(", "))}`
|
|
38391
|
+
message("configuration-heading" /* ConfigurationHeading */),
|
|
38392
|
+
` ${message("deferral-tags-key" /* DeferralTagsKey */)}`,
|
|
38393
|
+
...explainingLines(message("deferral-tags-explanation" /* DeferralTagsExplanation */)),
|
|
38394
|
+
...explainingLines(message("built-in-deferral-tags" /* BuiltInDeferralTags */, { tags: BUILT_IN_DEFERRAL_TAGS.map((tag) => `@${tag}`).join(", ") }))
|
|
38394
38395
|
];
|
|
38395
38396
|
balanceRetiredFlags = [
|
|
38396
38397
|
{
|
|
38397
38398
|
name: "--measurements",
|
|
38398
38399
|
retiredIn: "0.1.0-alpha.5",
|
|
38399
|
-
replacement:
|
|
38400
|
+
replacement: message("measurements-replacement" /* MeasurementsReplacement */)
|
|
38400
38401
|
}
|
|
38401
38402
|
];
|
|
38402
38403
|
globalFlags = [
|
|
38403
38404
|
{
|
|
38404
38405
|
name: "--store",
|
|
38405
38406
|
arg: "<root>",
|
|
38406
|
-
description:
|
|
38407
|
+
description: message("store-modifier" /* StoreModifier */)
|
|
38407
38408
|
},
|
|
38408
38409
|
{
|
|
38409
38410
|
name: "--run-id",
|
|
38410
38411
|
arg: "<id>",
|
|
38411
|
-
description:
|
|
38412
|
+
description: message("run-id-modifier" /* RunIdModifier */)
|
|
38412
38413
|
}
|
|
38413
38414
|
];
|
|
38414
38415
|
balanceCommand = {
|
|
38415
38416
|
name: "balance",
|
|
38416
|
-
summary:
|
|
38417
|
+
summary: message("balance-summary" /* BalanceSummary */),
|
|
38417
38418
|
flags: balanceFlags,
|
|
38418
38419
|
configHelp: balanceConfigHelp,
|
|
38419
38420
|
retiredFlags: balanceRetiredFlags
|
|
38420
38421
|
};
|
|
38421
38422
|
allocateCommand = {
|
|
38422
38423
|
name: "allocate",
|
|
38423
|
-
summary:
|
|
38424
|
+
summary: message("allocate-summary" /* AllocateSummary */),
|
|
38424
38425
|
acceptsHostModifiers: false,
|
|
38425
38426
|
positionals: [
|
|
38426
|
-
{ name: "<FFF>", description:
|
|
38427
|
+
{ name: "<FFF>", description: message("feature-part-argument" /* FeaturePartArgument */) }
|
|
38427
38428
|
],
|
|
38428
38429
|
flags: [
|
|
38429
38430
|
{
|
|
38430
38431
|
name: "--new",
|
|
38431
|
-
description:
|
|
38432
|
+
description: message("new-flag" /* NewFlag */)
|
|
38432
38433
|
},
|
|
38433
|
-
{ name: "--help", aliases: ["-h"], description:
|
|
38434
|
+
{ name: "--help", aliases: ["-h"], description: message("help-flag" /* HelpFlag */) }
|
|
38434
38435
|
]
|
|
38435
38436
|
};
|
|
38436
38437
|
cliRegistry = {
|
|
@@ -39106,16 +39107,29 @@ var init_readTree = __esm({
|
|
|
39106
39107
|
|
|
39107
39108
|
// src/cli-allocate/stderr.ts
|
|
39108
39109
|
function historyBoundaryLine(boundary, allocation) {
|
|
39109
|
-
|
|
39110
|
-
|
|
39111
|
-
|
|
39112
|
-
|
|
39110
|
+
switch (boundary.kind) {
|
|
39111
|
+
case "complete":
|
|
39112
|
+
return null;
|
|
39113
|
+
case "shallow":
|
|
39114
|
+
return shallowHistoryLine(boundary.before, allocation);
|
|
39115
|
+
case "not-a-repository":
|
|
39116
|
+
return noRepositoryLine(allocation);
|
|
39117
|
+
}
|
|
39118
|
+
}
|
|
39119
|
+
function shallowHistoryLine(before, allocation) {
|
|
39120
|
+
return allocation.highest === null ? message("shallow-history-risks-part-code" /* ShallowHistoryRisksPartCode */, { before, part: partOf(allocation) }) : message("shallow-history-risks-code-above" /* ShallowHistoryRisksCodeAbove */, { before, code: allocation.highest.code });
|
|
39121
|
+
}
|
|
39122
|
+
function noRepositoryLine(allocation) {
|
|
39123
|
+
return allocation.highest === null ? message("no-repository-risks-part-code" /* NoRepositoryRisksPartCode */, { part: partOf(allocation) }) : message("no-repository-risks-code-above" /* NoRepositoryRisksCodeAbove */, { code: allocation.highest.code });
|
|
39124
|
+
}
|
|
39125
|
+
function partOf(allocation) {
|
|
39126
|
+
return featureCodeOf(allocation.code) ?? "";
|
|
39113
39127
|
}
|
|
39114
39128
|
function highestSeenLine(allocation) {
|
|
39115
39129
|
const highest = allocation.highest;
|
|
39116
|
-
if (highest === null) return
|
|
39130
|
+
if (highest === null) return message("highest-seen-none" /* HighestSeenNone */);
|
|
39117
39131
|
const { path, line, commit } = highest.occurrence;
|
|
39118
|
-
return commit === void 0 ?
|
|
39132
|
+
return commit === void 0 ? message("highest-seen-in-tree" /* HighestSeenInTree */, { code: highest.code, path, line }) : message("highest-seen-in-commit" /* HighestSeenInCommit */, { code: highest.code, path, line, commit });
|
|
39119
39133
|
}
|
|
39120
39134
|
function carriedParts(carried) {
|
|
39121
39135
|
return CARRIED_PARTS[carried.kind](carried);
|
|
@@ -39125,7 +39139,7 @@ function unknownPartRefusal(unknown) {
|
|
|
39125
39139
|
}
|
|
39126
39140
|
function alreadyHeadedNote(allocation) {
|
|
39127
39141
|
if (allocation.alreadyHeaded !== true) return null;
|
|
39128
|
-
return
|
|
39142
|
+
return message("part-already-headed" /* PartAlreadyHeaded */, { part: partOf(allocation) });
|
|
39129
39143
|
}
|
|
39130
39144
|
var CARRIED_PARTS;
|
|
39131
39145
|
var init_stderr = __esm({
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "spec-controller",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.231",
|
|
4
4
|
"description": "Reconcile the behaviour your scenarios name against the evidence that actually ran — the deterministic `balance` CLI.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"reconciliation",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"fast-xml-parser": "^5.11.2",
|
|
27
27
|
"ts-json-schema-generator": "^2.9.0",
|
|
28
28
|
"yaml": "^2.9.0",
|
|
29
|
-
"@3f-consulting/spec-controller-core": "0.1.
|
|
29
|
+
"@3f-consulting/spec-controller-core": "0.1.231"
|
|
30
30
|
},
|
|
31
31
|
"publishConfig": {
|
|
32
32
|
"access": "public"
|