spec-controller 0.1.269 → 0.1.270

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 (3) hide show
  1. package/README.md +1 -1
  2. package/dist/cli.js +24 -24
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -89,7 +89,7 @@ The refusal names the input, the path, and what was wrong with it. A well-formed
89
89
 
90
90
  ### `allocate`
91
91
 
92
- `spec-controller allocate` prints the next claim code for a feature part. It reaches no verdict: it exits `0` when it answers, and `2` for a usage error or an unknown part. A file or directory it cannot read, directly or through git, is a usage error: it is refused, naming the path and the reason, and no code is given.
92
+ `spec-controller allocate` prints the next claim code for a feature code. It reaches no verdict: it exits `0` when it answers, and `2` for a usage error or an unknown feature code. A file or directory it cannot read, directly or through git, is a usage error: it is refused, naming the path and the reason, and no code is given.
93
93
 
94
94
  ## On CI
95
95
 
package/dist/cli.js CHANGED
@@ -102,10 +102,10 @@ var init_messages_en = __esm({
102
102
  "more-than-one-to-stdout": "More than one output routes to stdout ({formats}); at most one may. Give one of them a :<path> to write it to a file instead (e.g. --format json:report.json).",
103
103
  "outputs-share-file": "Two outputs name the same file: {first} and {second}. Give each output a file of its own.",
104
104
  "output-overwrites-input": "An output would overwrite a file this run reads: {output} is {subject}, {path}. Give the report a file of its own.",
105
- "unknown-part-refused": "unknown part \u2014 no feature file's header carries {part}.\nThe parts this corpus's feature files carry: {parts}.",
106
- "no-parts-carried": "none",
107
- "no-feature-part-given": "no feature part was given: 'spec-controller allocate <FFF>' takes one, a feature file's header code.",
108
- "not-a-feature-part": "''{part}'' is not a feature part: two to five characters, each A-Z or 0-9.",
105
+ "unknown-feature-code-refused": "unknown feature code \u2014 no feature file's header carries {featureCode}.\nThe feature codes this corpus's feature files carry: {featureCodes}.",
106
+ "no-feature-codes-carried": "none",
107
+ "feature-code-not-given": "no feature code was given: 'spec-controller allocate <FFF>' takes one, a feature file's header code.",
108
+ "not-a-feature-code": "''{featureCode}'' is not a feature code: two to five characters, each A-Z or 0-9.",
109
109
  "ci-workflow": "a CI workflow",
110
110
  "read-report": "a report",
111
111
  "format-on-standard-output": "{fmt} on standard output",
@@ -174,17 +174,17 @@ var init_messages_en = __esm({
174
174
  "format-flag": "Where to send output (md or json, optionally :<path> to write to a file). Repeatable.",
175
175
  "strict-flag": "Read every scenario as if nothing were put off: a deferral tag is ignored, and a pending tag such as @integrationpending raises the Evidence Obligation it names.",
176
176
  "exit-zero-flag": "Print the same report but exit 0 on an out-of-balance (1) verdict \u2014 the on-ramp before gating. Usage (2), not reconciled (3) and an unexpected error (4) still fail.",
177
- "allocate-summary": "Print the next claim code for a feature part: one past the highest the repository has ever carried, the code alone on stdout.",
178
- "feature-part-argument": "The feature part: a feature file's header code, two to five of A-Z and 0-9.",
179
- "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.",
180
- "shallow-history-risks-part-code": "history: shallow clone \u2014 history before {before} unread; a code of {part} may have been used before",
177
+ "allocate-summary": "Print the next claim code for a feature code: one past the highest the repository has ever carried, the code alone on stdout.",
178
+ "feature-code-argument": "The feature code: a feature file's header code, two to five of A-Z and 0-9.",
179
+ "new-flag": "Start a feature code no feature file's header carries yet: its first code, or one past any number the repository already carries for it.",
180
+ "shallow-history-risks-feature-code": "history: shallow clone \u2014 history before {before} unread; a code of {featureCode} may have been used before",
181
181
  "shallow-history-risks-code-above": "history: shallow clone \u2014 history before {before} unread; a code above {code} may have been used before",
182
- "no-repository-risks-part-code": "history: not a git repository \u2014 none read; a code of {part} may have been used before",
182
+ "no-repository-risks-feature-code": "history: not a git repository \u2014 none read; a code of {featureCode} may have been used before",
183
183
  "no-repository-risks-code-above": "history: not a git repository \u2014 none read; a code above {code} may have been used before",
184
184
  "highest-seen-none": "highest seen: none",
185
185
  "highest-seen-in-tree": "highest seen: {code}, {path}:{line}",
186
186
  "highest-seen-in-commit": "highest seen: {code}, {path}:{line} in {commit}",
187
- "part-already-headed": "note: a feature file's header already carries {part}, so --new was not needed"
187
+ "feature-code-already-headed": "note: a feature file's header already carries {featureCode}, so --new was not needed"
188
188
  };
189
189
  }
190
190
  });
@@ -35636,7 +35636,7 @@ var init_cliRegistry = __esm({
35636
35636
  allocateCommand = {
35637
35637
  name: "allocate",
35638
35638
  summary: message("allocate-summary" /* AllocateSummary */),
35639
- positional: { name: "<FFF>", description: message("feature-part-argument" /* FeaturePartArgument */) },
35639
+ positional: { name: "<FFF>", description: message("feature-code-argument" /* FeatureCodeArgument */) },
35640
35640
  flags: [
35641
35641
  {
35642
35642
  name: "--new",
@@ -35955,7 +35955,7 @@ var init_unreadable = __esm({
35955
35955
  }
35956
35956
  });
35957
35957
 
35958
- // src/repository/readParts.ts
35958
+ // src/repository/readFeatureCodes.ts
35959
35959
  import { readFileSync as readFileSync4 } from "node:fs";
35960
35960
  function readFeatureCodes(featureFiles) {
35961
35961
  const sources = featureFiles.map(({ path }) => ({
@@ -35966,8 +35966,8 @@ function readFeatureCodes(featureFiles) {
35966
35966
  if (parse4.kind === "unparseable") throw new UnparseableFeatureFiles(parse4.faults);
35967
35967
  return parse4.parsed.flatMap((feature) => featureCodeOfFile(feature) ?? []);
35968
35968
  }
35969
- var init_readParts = __esm({
35970
- "src/repository/readParts.ts"() {
35969
+ var init_readFeatureCodes = __esm({
35970
+ "src/repository/readFeatureCodes.ts"() {
35971
35971
  "use strict";
35972
35972
  init_dist3();
35973
35973
  init_messages();
@@ -35979,10 +35979,10 @@ var init_readParts = __esm({
35979
35979
  function readRequest(argv, registry) {
35980
35980
  const why = argvRefusal(argv, registry);
35981
35981
  if (why !== null) return { usageError: why };
35982
- const [part] = positionalArguments(argv);
35983
- if (part === void 0) return { usageError: refusal("no-feature-part-given" /* NoFeaturePartGiven */, {}) };
35984
- if (!isFeatureCode(part)) return { usageError: refusal("not-a-feature-part" /* NotAFeaturePart */, { part }) };
35985
- return { featureCode: part, isNew: argv.includes("--new") };
35982
+ const [featureCode] = positionalArguments(argv);
35983
+ if (featureCode === void 0) return { usageError: refusal("feature-code-not-given" /* FeatureCodeNotGiven */, {}) };
35984
+ if (!isFeatureCode(featureCode)) return { usageError: refusal("not-a-feature-code" /* NotAFeatureCode */, { featureCode }) };
35985
+ return { featureCode, isNew: argv.includes("--new") };
35986
35986
  }
35987
35987
  function argvRefusal(argv, registry) {
35988
35988
  const args = parseArgs(argv);
@@ -36171,10 +36171,10 @@ function historyBoundaryLine(boundary, allocation) {
36171
36171
  }
36172
36172
  }
36173
36173
  function shallowHistoryLine(before, allocation) {
36174
- return allocation.highest === void 0 ? message("shallow-history-risks-part-code" /* ShallowHistoryRisksPartCode */, { before, part: allocation.featureCode }) : message("shallow-history-risks-code-above" /* ShallowHistoryRisksCodeAbove */, { before, code: allocation.highest.code });
36174
+ return allocation.highest === void 0 ? message("shallow-history-risks-feature-code" /* ShallowHistoryRisksFeatureCode */, { before, featureCode: allocation.featureCode }) : message("shallow-history-risks-code-above" /* ShallowHistoryRisksCodeAbove */, { before, code: allocation.highest.code });
36175
36175
  }
36176
36176
  function noRepositoryLine(allocation) {
36177
- return allocation.highest === void 0 ? message("no-repository-risks-part-code" /* NoRepositoryRisksPartCode */, { part: allocation.featureCode }) : message("no-repository-risks-code-above" /* NoRepositoryRisksCodeAbove */, { code: allocation.highest.code });
36177
+ return allocation.highest === void 0 ? message("no-repository-risks-feature-code" /* NoRepositoryRisksFeatureCode */, { featureCode: allocation.featureCode }) : message("no-repository-risks-code-above" /* NoRepositoryRisksCodeAbove */, { code: allocation.highest.code });
36178
36178
  }
36179
36179
  function highestSeenLine(allocation) {
36180
36180
  const highest = allocation.highest;
@@ -36183,14 +36183,14 @@ function highestSeenLine(allocation) {
36183
36183
  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 });
36184
36184
  }
36185
36185
  function featureCodesListed({ featureCodes }) {
36186
- return featureCodes.length === 0 ? message("no-parts-carried" /* NoPartsCarried */) : featureCodes.join(", ");
36186
+ return featureCodes.length === 0 ? message("no-feature-codes-carried" /* NoFeatureCodesCarried */) : featureCodes.join(", ");
36187
36187
  }
36188
36188
  function unknownFeatureCodeRefusal(unknown) {
36189
- return refusal("unknown-part-refused" /* UnknownPartRefused */, { part: unknown.featureCode, parts: featureCodesListed(unknown) });
36189
+ return refusal("unknown-feature-code-refused" /* UnknownFeatureCodeRefused */, { featureCode: unknown.featureCode, featureCodes: featureCodesListed(unknown) });
36190
36190
  }
36191
36191
  function alreadyHeadedNote(allocation) {
36192
36192
  if (allocation.alreadyHeaded !== true) return null;
36193
- return message("part-already-headed" /* PartAlreadyHeaded */, { part: allocation.featureCode });
36193
+ return message("feature-code-already-headed" /* FeatureCodeAlreadyHeaded */, { featureCode: allocation.featureCode });
36194
36194
  }
36195
36195
  var init_allocateNotes = __esm({
36196
36196
  "src/output/allocateNotes.ts"() {
@@ -36258,7 +36258,7 @@ var init_allocate = __esm({
36258
36258
  init_dist3();
36259
36259
  init_cliArgs();
36260
36260
  init_cliRegistry();
36261
- init_readParts();
36261
+ init_readFeatureCodes();
36262
36262
  init_request();
36263
36263
  init_defaults();
36264
36264
  init_unreadable();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-controller",
3
- "version": "0.1.269",
3
+ "version": "0.1.270",
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.269"
29
+ "@3f-consulting/spec-controller-core": "0.1.270"
30
30
  },
31
31
  "publishConfig": {
32
32
  "access": "public"