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.
Files changed (2) hide show
  1. package/dist/cli.js +108 -94
  2. 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: 11 /* FeaturesFlag */ },
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: 12 /* VitestFlag */,
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: 13 /* PytestFlag */,
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: 14 /* JestFlag */,
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: 15 /* JunitFlag */,
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: 16 /* RspecFlag */,
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: 17 /* CucumberFlag */,
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: 18 /* CiFlag */ },
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: 19 /* PackageJsonFlag */,
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: 20 /* CiStepsFlag */,
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
- APP_MESSAGES[4 /* HelpOptions */](),
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
- `${APP_MESSAGES[1 /* HelpUsage */]()} spec-controller ${command} ${positionals.map((positional) => positional.name).join(" ")} [options]`,
38312
+ `${message("help-usage" /* HelpUsage */)} spec-controller ${command} ${positionals.map((positional) => positional.name).join(" ")} [options]`,
38312
38313
  "",
38313
- APP_MESSAGES[5 /* HelpArguments */](),
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
- APP_MESSAGES[0 /* HelpTitle */](),
38331
+ message("help-title" /* HelpTitle */),
38331
38332
  "",
38332
- APP_MESSAGES[1 /* HelpUsage */](),
38333
- ` ${APP_MESSAGES[45 /* HelpUsageLine */](modifierUsage)}`,
38333
+ message("help-usage" /* HelpUsage */),
38334
+ ` ${message("help-usage-line" /* HelpUsageLine */, { modifierUsage })}`,
38334
38335
  "",
38335
- APP_MESSAGES[2 /* HelpCommands */](),
38336
+ message("help-commands" /* HelpCommands */),
38336
38337
  ...commandLines,
38337
38338
  "",
38338
- APP_MESSAGES[3 /* HelpHostModifiers */](),
38339
+ message("help-host-modifiers" /* HelpHostModifiers */),
38339
38340
  ...modifierLines,
38340
38341
  "",
38341
- APP_MESSAGES[6 /* HelpPointer */]()
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: APP_MESSAGES[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: APP_MESSAGES[21 /* TargetFlag */]()
38358
+ description: message("target-flag" /* TargetFlag */)
38357
38359
  },
38358
38360
  {
38359
38361
  name: "--source-sha",
38360
38362
  arg: "<sha>",
38361
- description: APP_MESSAGES[22 /* SourceShaFlag */]()
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: APP_MESSAGES[23 /* FormatFlag */]()
38369
+ description: message("format-flag" /* FormatFlag */)
38368
38370
  },
38369
38371
  {
38370
38372
  name: "--render-from-json",
38371
38373
  arg: "<path>",
38372
- description: APP_MESSAGES[24 /* RenderFromJsonFlag */]()
38374
+ description: message("render-from-json-flag" /* RenderFromJsonFlag */)
38373
38375
  },
38374
38376
  {
38375
38377
  name: "--strict",
38376
- description: APP_MESSAGES[25 /* StrictFlag */]()
38378
+ description: message("strict-flag" /* StrictFlag */)
38377
38379
  },
38378
38380
  {
38379
38381
  name: "--exit-zero",
38380
- description: APP_MESSAGES[26 /* ExitZeroFlag */]()
38382
+ description: message("exit-zero-flag" /* ExitZeroFlag */)
38381
38383
  },
38382
38384
  {
38383
38385
  name: "--help",
38384
38386
  aliases: ["-h"],
38385
- description: APP_MESSAGES[7 /* HelpFlag */]()
38387
+ description: message("help-flag" /* HelpFlag */)
38386
38388
  }
38387
38389
  ];
38388
38390
  balanceConfigHelp = [
38389
- APP_MESSAGES[27 /* ConfigurationHeading */](),
38390
- ` ${APP_MESSAGES[28 /* DeferralTagsKey */]()}`,
38391
- ` ${APP_MESSAGES[29 /* DeferralTagsExtend */]()}`,
38392
- ` ${APP_MESSAGES[30 /* DeferralTagsNeverReplace */]()}`,
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: APP_MESSAGES[32 /* MeasurementsReplacement */]()
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: APP_MESSAGES[8 /* StoreModifier */]()
38407
+ description: message("store-modifier" /* StoreModifier */)
38407
38408
  },
38408
38409
  {
38409
38410
  name: "--run-id",
38410
38411
  arg: "<id>",
38411
- description: APP_MESSAGES[9 /* RunIdModifier */]()
38412
+ description: message("run-id-modifier" /* RunIdModifier */)
38412
38413
  }
38413
38414
  ];
38414
38415
  balanceCommand = {
38415
38416
  name: "balance",
38416
- summary: APP_MESSAGES[10 /* BalanceSummary */](),
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: APP_MESSAGES[33 /* AllocateSummary */](),
38424
+ summary: message("allocate-summary" /* AllocateSummary */),
38424
38425
  acceptsHostModifiers: false,
38425
38426
  positionals: [
38426
- { name: "<FFF>", description: APP_MESSAGES[34 /* FeaturePartArgument */]() }
38427
+ { name: "<FFF>", description: message("feature-part-argument" /* FeaturePartArgument */) }
38427
38428
  ],
38428
38429
  flags: [
38429
38430
  {
38430
38431
  name: "--new",
38431
- description: APP_MESSAGES[35 /* NewFlag */]()
38432
+ description: message("new-flag" /* NewFlag */)
38432
38433
  },
38433
- { name: "--help", aliases: ["-h"], description: APP_MESSAGES[7 /* HelpFlag */]() }
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
- if (boundary.kind === "complete") return null;
39110
- const unread = boundary.kind === "shallow" ? APP_MESSAGES[37 /* ShallowHistoryUnread */](boundary.before) : APP_MESSAGES[38 /* NoRepositoryHistoryRead */]();
39111
- const risk = allocation.highest === null ? APP_MESSAGES[39 /* RiskOfPartCode */](featureCodeOf(allocation.code) ?? "") : APP_MESSAGES[40 /* RiskAboveCode */](allocation.highest.code);
39112
- return APP_MESSAGES[36 /* HistoryBoundary */](unread, risk);
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 APP_MESSAGES[41 /* HighestSeenNone */]();
39130
+ if (highest === null) return message("highest-seen-none" /* HighestSeenNone */);
39117
39131
  const { path, line, commit } = highest.occurrence;
39118
- return commit === void 0 ? APP_MESSAGES[42 /* HighestSeenInTree */](highest.code, path, line) : APP_MESSAGES[43 /* HighestSeenInCommit */](highest.code, path, line, commit);
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 APP_MESSAGES[44 /* PartAlreadyHeaded */](featureCodeOf(allocation.code) ?? "");
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.230",
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.230"
29
+ "@3f-consulting/spec-controller-core": "0.1.231"
30
30
  },
31
31
  "publishConfig": {
32
32
  "access": "public"