spec-controller 0.1.197 → 0.1.199

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 +16 -15
  2. package/package.json +2 -2
package/dist/cli.js CHANGED
@@ -28362,7 +28362,7 @@ var init_model = __esm({
28362
28362
  });
28363
28363
 
28364
28364
  // ../core/dist/render/messages.js
28365
- var QUALITY_CHECK_FAULT_MESSAGES, CoreMessage, SATISFIED, MISSING, DUPLICATE_SCN_CODE, CITED_WITH_NO_SCENARIO, CITING_NO_SCENARIO, IN_ITS_FILE, foreignOpening, aKind, recode, CORE_MESSAGES;
28365
+ var QUALITY_CHECK_FAULT_MESSAGES, CoreMessage, SATISFIED, MISSING, DUPLICATE_SCN_CODE, CITED_WITH_NO_SCENARIO, CITING_NO_SCENARIO, RUNNERS_PLACE, IN_ITS_FILE, foreignOpening, aKind, recode, CORE_MESSAGES;
28366
28366
  var init_messages4 = __esm({
28367
28367
  "../core/dist/render/messages.js"() {
28368
28368
  "use strict";
@@ -28540,6 +28540,7 @@ var init_messages4 = __esm({
28540
28540
  DUPLICATE_SCN_CODE = "Evidence Obligation's @SCN code is carried by another Scenario";
28541
28541
  CITED_WITH_NO_SCENARIO = "cited scenario ids with no real scenario";
28542
28542
  CITING_NO_SCENARIO = "evidence observations citing no scenario";
28543
+ RUNNERS_PLACE = "`specController.runners` in its `package.json`";
28543
28544
  IN_ITS_FILE = "every coded scenario sits in the file its code names";
28544
28545
  foreignOpening = (file, featureCode, scnId, named) => `${file} carries the feature code @${featureCode}, but holds the scenario @${scnId}, whose feature part names ${named}. A reconciliation's by-feature cut groups on the id, so `;
28545
28546
  aKind = (type) => `a ${type}`;
@@ -28614,10 +28615,10 @@ var init_messages4 = __esm({
28614
28615
  [CoreMessage.NothingToReconcileGloss]: (corpusDir) => `there were no accounts to agree. The ledger carries no Claim Reconciliation at all, so this run has NO BASIS FOR A VERDICT \u2014 the corpus \`${corpusDir}\` carried no scenario and nothing was produced. Not balanced: a run that examined nothing must not certify.`,
28615
28616
  [CoreMessage.PendingItemsOutstanding]: "Pending Items are outstanding \u2014 deferred, not out-of-balance, so the verdict stands. A run that treats a deferral as a failure gives exit 3 under `--strict`.",
28616
28617
  [CoreMessage.EvidenceReconciliationHeading]: "### Evidence reconciliation",
28617
- [CoreMessage.EvidenceReconciliationClaimReconciliationTerm]: "A Claim Reconciliation is one row of the ledger: the evidence for one claim, reconciled kind by kind of quality check in its Quality Check Reconciliations. A claim is a scenario, a phantom claim (a code that evidence cites and no scenario carries, which the table below calls an unknown Scenario) or the unnamed claim (the one row for evidence that names no one scenario).",
28618
+ [CoreMessage.EvidenceReconciliationClaimReconciliationTerm]: "A Claim Reconciliation is one row of the ledger: one claim, reconciled in its Quality Check Reconciliations. A claim is a scenario, a phantom claim (a code that evidence cites and no scenario carries, which the table below calls an unknown Scenario) or the unnamed claim (the one row for the evidence that no scenario or phantom claim takes).",
28618
28619
  [CoreMessage.EvidenceReconciliationReconciliationLineTerm]: "A Reconciliation line is one line of a Quality Check Reconciliation, with its own outcome: each Evidence Observation it holds is one line, its Evidence Obligation is one more when no Evidence Observation that ran answers it, and one holding neither is a single line. No line stands in for another: a scenario whose one Evidence Obligation two passing tests answer adds one to the Claim Reconciliation total and two to the Reconciliation line total.",
28619
- [CoreMessage.EvidenceReconciliationEvidenceObligationTerm]: "An Evidence Obligation is a proof a scenario asks for, by the tags it carries, to be met by Evidence Observations. A Pending Item is a proof a scenario defers, by a pending tag such as `@unitpending` or a deferral tag such as `@wip`: it raises no Evidence Obligation, is tallied apart, and never puts its claim out of balance.",
28620
- [CoreMessage.EvidenceReconciliationEvidenceObservationTerm]: "An Evidence Observation is one reported result of a test or a fitness function, attributed by the code it cites: to the one scenario that carries the code, to a phantom claim when no scenario carries it, and to the unnamed claim when it cites no code or a code more than one scenario carries, because no one scenario can take it. One that never reached its assertions is broken: it was reported, but did not run to a result.",
28620
+ [CoreMessage.EvidenceReconciliationEvidenceObligationTerm]: "An Evidence Obligation is a proof a scenario asks for, by the tags it carries, to be met by Evidence Observations. A Pending Item is a proof a scenario defers, by a pending tag such as `@unitpending` or a deferral tag such as `@wip`, tallied apart from balanced and out-of-balance.",
28621
+ [CoreMessage.EvidenceReconciliationEvidenceObservationTerm]: "An Evidence Observation is one reported result of a test or a fitness function, attributed by the codes it cites: to the one scenario that carries its one code, to a phantom claim when no scenario carries its one code, and otherwise to the unnamed claim, because no one scenario can take it. One that never reached its assertions is broken: it was reported, but did not run to a result.",
28621
28622
  [CoreMessage.SubjectColumn]: "Subject",
28622
28623
  [CoreMessage.TotalColumn]: "Total",
28623
28624
  [CoreMessage.BalancedColumn]: "Balanced",
@@ -28631,8 +28632,8 @@ var init_messages4 = __esm({
28631
28632
  [CoreMessage.EvidenceObservationsTableHeader]: "| Kind of quality check | Evidence observations | Runner | CI step |",
28632
28633
  [CoreMessage.FitnessRunner]: "each fitness function's check step",
28633
28634
  [CoreMessage.FitnessCiStep]: (steps) => `${steps} step(s), each named on its fitness function's row of Claim Reconciliations.`,
28634
- [CoreMessage.RunnerLayerNamesNone]: "no runner: the target names none.",
28635
- [CoreMessage.RunnerLayerUnnamed]: "unnamed: the target has not said.",
28635
+ [CoreMessage.RunnerLayerNamesNone]: `no runner: the target declares this layer has none, by setting it to \`null\` under ${RUNNERS_PLACE}.`,
28636
+ [CoreMessage.RunnerLayerUnnamed]: `unnamed: the target leaves this layer's runner undeclared: ${RUNNERS_PLACE} is missing or not a block, leaves the layer out, or gives it a value that is neither a string nor \`null\`. A string there names the layer's runner.`,
28636
28637
  [CoreMessage.NoStepCountedAsItsRunnerRunsIt]: "no step counted as its runner runs it.",
28637
28638
  [CoreMessage.RunnerKeyNotALayer]: (key) => `${key} \u2014 not a layer: the runner block is keyed by the four layers, and this key excludes nothing.`,
28638
28639
  [CoreMessage.ReconcilerStep]: (step, whatItIs) => `${step} \u2014 the reconciler: ${whatItIs}.`,
@@ -28650,10 +28651,10 @@ var init_messages4 = __esm({
28650
28651
  [CoreMessage.StepAccountingNotAppliedLabel]: (key, workflowsRead) => `Not applied, because each ${key} entry below names a workflow this run did not read (this run read ${workflowsRead}):`,
28651
28652
  [CoreMessage.StepAccountingNoWorkflowRead]: "no workflow",
28652
28653
  [CoreMessage.StepAccountingPlumbingLabel]: "GitHub plumbing:",
28653
- [CoreMessage.StepAccountingCandidatesTerm]: "A Candidate is a step read that is not a Runner, Reconciler, Excluded or GitHub plumbing step. It is read as a fitness function: its result is an Evidence Observation named, with its step, on the row of Claim Reconciliations it posts to, so no list below names it.",
28654
+ [CoreMessage.StepAccountingCandidatesTerm]: "A Candidate is a step read that is not a Runner, Reconciler, Excluded or GitHub plumbing step. It is read as a fitness function, and no list below names it.",
28654
28655
  [CoreMessage.StepAccountingReconcilerTerm]: "A Reconciler step runs this reconciliation or writes the step record it reads.",
28655
- [CoreMessage.StepAccountingExcludedTerm]: "An Excluded step is one the target names a non-check under `specController.notChecks`, a GitHub plumbing step included.",
28656
- [CoreMessage.StepAccountingPlumbingTerm]: "A GitHub plumbing step only sets up the job: it uses one of GitHub's own actions that check out the source, cache, set up a toolchain or move artefacts between jobs. A step that runs a command, an install included, is never plumbing.",
28656
+ [CoreMessage.StepAccountingExcludedTerm]: "An Excluded step is one the target names a non-check under `specController.notChecks` and that is not a Reconciler step, a GitHub plumbing step included.",
28657
+ [CoreMessage.StepAccountingPlumbingTerm]: "A GitHub plumbing step is one that is neither a Reconciler nor an Excluded step and uses one of GitHub's own actions `actions/checkout`, `actions/cache`, `actions/upload-artifact`, `actions/download-artifact` or `actions/setup-*`. A step that runs a command, an install included, is never plumbing.",
28657
28658
  [CoreMessage.StepAccountingAccountedForTerm]: "Accounted for is the sum of the five columns from Candidates to GitHub plumbing, in which each step read is counted once.",
28658
28659
  [CoreMessage.OutOfBalanceByFeatureHeading]: "### Out-of-balance by feature",
28659
28660
  [CoreMessage.ScenarioClaimReconciliationsOutOfBalance]: (outOfBalance, claimReconciliations) => `${outOfBalance} of ${claimReconciliations} Claim Reconciliation(s) of scenarios out of balance`,
@@ -28678,14 +28679,14 @@ var init_messages4 = __esm({
28678
28679
  [CoreMessage.CiStepsColumn]: "CI steps",
28679
28680
  [CoreMessage.EvidenceCellKey]: [
28680
28681
  "Key: each evidence cell reads *obligation*/*observations*.",
28681
- "- The letter says the scenario's tags raise an Evidence Obligation of that kind: (F)itness, (U)nit, (I)ntegration, (E)2e, (P)erformance. The table has a column only for a kind some row obligates or observes. `-` means none is raised, or the obligation is pending.",
28682
- "- The number counts the Evidence Observations posted to the scenario for that kind. `-` means none.",
28682
+ "- The letter says the scenario's tags raise an Evidence Obligation of that kind: (F)itness, (U)nit, (I)ntegration, (E)2e, (P)erformance. `-` means none is raised, or the obligation is pending.",
28683
+ "- The number counts the scenario's Evidence Observations of that kind that ran. `-` means none.",
28683
28684
  "- For example, `U/2` is a unit obligation answered by two unit tests; `U/-` is a unit obligation that no unit test answered; `-/1` is one unit test citing a scenario that asks for no unit evidence, or whose unit evidence is pending.",
28684
- "- A blank cell means neither; `\u2014` marks a row that is not a scenario of the corpus: a cited code no feature declares, or evidence that cites no scenario.",
28685
+ "- A blank cell means no obligation and no Evidence Observation that ran; `\u2014` marks the row of a phantom claim or of the unnamed claim.",
28685
28686
  "- A row named `feature file : scenario title` is a scenario that carries no @SCN code. The run reads none of its tags, so its evidence cells are blank, and its reconciling item says that no Evidence Observation can link to it.",
28686
- "- In Reconciling items, `\u2014` means the row has no reconciling item, and *untagged* means the scenario carries no tag that raises an Evidence Obligation, though it may carry an @SCN code.",
28687
- "- On the unnamed claim's row, the counts after an item, such as `1 ran, 1 passed, 0 failed`, are of that item's own tests; a broken item stands alone and is counted in none.",
28688
- "- CI steps names the CI steps behind each kind of quality check the row obligates or observes, whether or not any Evidence Observation of that kind ran for the row: `U/-` beside a step names the step that runs unit tests, none of which answered this row."
28687
+ "- In Reconciling items, `\u2014` means the row has no reconciling item, and *untagged* means a scenario that carries an @SCN code and no tag that raises an Evidence Obligation.",
28688
+ "- On the unnamed claim's row, the counts after an item, such as `1 ran, 1 passed, 0 failed`, are of that item's own tests, and a fitness item counts its CI steps; a broken item stands alone and is counted in none.",
28689
+ "- CI steps names the steps the Evidence observations table gives for each kind of quality check other than fitness that the row obligates or observes, whether or not an Evidence Observation of that kind ran for the row, and the step each of the row's fitness Evidence Observations names: `U/-` beside a step names the step that runs unit tests, none of which answered this row. A blank CI steps cell means no such step is known."
28689
28690
  ].join("\n"),
28690
28691
  [CoreMessage.PendingItem]: "pending",
28691
28692
  [CoreMessage.PendingItemFor]: (qualityCheckKind) => `pending: ${qualityCheckKind}`,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-controller",
3
- "version": "0.1.197",
3
+ "version": "0.1.199",
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.197"
29
+ "@3f-consulting/spec-controller-core": "0.1.199"
30
30
  },
31
31
  "publishConfig": {
32
32
  "access": "public"