spec-controller 0.1.223 → 0.1.224

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 CHANGED
@@ -12327,7 +12327,7 @@ function ciStepsJoined(observations, ledger, runners, layers, stepsInOrder) {
12327
12327
  function summaryOf(ledger, withEvidenceObservations) {
12328
12328
  const tally = ledgerTally(ledger);
12329
12329
  return {
12330
- evidenceReconciliation: {
12330
+ reconciliationTotals: {
12331
12331
  claimReconciliations: tally.claimReconciliations,
12332
12332
  reconciliationLines: tally.reconciliationLines,
12333
12333
  pending: tally.pending
@@ -28298,11 +28298,11 @@ var init_messages4 = __esm({
28298
28298
  CoreMessage2[CoreMessage2["NothingToReconcileHeadline"] = 50] = "NothingToReconcileHeadline";
28299
28299
  CoreMessage2[CoreMessage2["NothingToReconcileGloss"] = 51] = "NothingToReconcileGloss";
28300
28300
  CoreMessage2[CoreMessage2["PendingItemsOutstanding"] = 52] = "PendingItemsOutstanding";
28301
- CoreMessage2[CoreMessage2["EvidenceReconciliationHeading"] = 53] = "EvidenceReconciliationHeading";
28302
- CoreMessage2[CoreMessage2["EvidenceReconciliationClaimReconciliationTerm"] = 54] = "EvidenceReconciliationClaimReconciliationTerm";
28303
- CoreMessage2[CoreMessage2["EvidenceReconciliationReconciliationLineTerm"] = 55] = "EvidenceReconciliationReconciliationLineTerm";
28304
- CoreMessage2[CoreMessage2["EvidenceReconciliationEvidenceObligationTerm"] = 56] = "EvidenceReconciliationEvidenceObligationTerm";
28305
- CoreMessage2[CoreMessage2["EvidenceReconciliationEvidenceObservationTerm"] = 57] = "EvidenceReconciliationEvidenceObservationTerm";
28301
+ CoreMessage2[CoreMessage2["ReconciliationTotalsHeading"] = 53] = "ReconciliationTotalsHeading";
28302
+ CoreMessage2[CoreMessage2["ReconciliationTotalsClaimReconciliationTerm"] = 54] = "ReconciliationTotalsClaimReconciliationTerm";
28303
+ CoreMessage2[CoreMessage2["ReconciliationTotalsReconciliationLineTerm"] = 55] = "ReconciliationTotalsReconciliationLineTerm";
28304
+ CoreMessage2[CoreMessage2["ReconciliationTotalsEvidenceObligationTerm"] = 56] = "ReconciliationTotalsEvidenceObligationTerm";
28305
+ CoreMessage2[CoreMessage2["ReconciliationTotalsEvidenceObservationTerm"] = 57] = "ReconciliationTotalsEvidenceObservationTerm";
28306
28306
  CoreMessage2[CoreMessage2["SubjectColumn"] = 58] = "SubjectColumn";
28307
28307
  CoreMessage2[CoreMessage2["TotalColumn"] = 59] = "TotalColumn";
28308
28308
  CoreMessage2[CoreMessage2["BalancedColumn"] = 60] = "BalancedColumn";
@@ -28480,11 +28480,11 @@ var init_messages4 = __esm({
28480
28480
  [CoreMessage.NothingToReconcileHeadline]: "**NOTHING TO RECONCILE**",
28481
28481
  [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.`,
28482
28482
  [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`.",
28483
- [CoreMessage.EvidenceReconciliationHeading]: "### Evidence reconciliation",
28484
- [CoreMessage.EvidenceReconciliationClaimReconciliationTerm]: "A Claim Reconciliation is one row of the ledger: one claim, reconciled in its Quality Check Reconciliations. A Quality Check Reconciliation reconciles the evidence of one kind of quality check within the claim: the claim's Evidence Obligation of that kind, when it has one, against its Evidence Observations of that kind. 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).",
28485
- [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, and its Evidence Obligation is one more when no Evidence Observation that ran answers it. A scenario with no Evidence Obligation, no Pending Item and no Evidence Observation still has one Quality Check Reconciliation, holding neither, and it 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.",
28486
- [CoreMessage.EvidenceReconciliationEvidenceObligationTerm]: `An Evidence Obligation is the evidence a scenario asks for, by the tags it carries, to be met by Evidence Observations. A pending tag such as \`@unitpending\` defers the evidence of its kind of quality check, and a deferral tag such as \`@wip\` defers all of the scenario's: what a tag defers raises no Evidence Obligation and is a Pending Item instead, tallied after the table, apart from balanced and out-of-balance, when there is one. On a scenario that shares its \`@SCN\` code with another, no tag defers anything: it reads "${DUPLICATE_SCN_CODE}" at each kind of quality check it raises, or once when it raises none.`,
28487
- [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.",
28483
+ [CoreMessage.ReconciliationTotalsHeading]: "### Reconciliation totals",
28484
+ [CoreMessage.ReconciliationTotalsClaimReconciliationTerm]: "A Claim Reconciliation is one row of the ledger: one claim, reconciled in its Quality Check Reconciliations. A Quality Check Reconciliation reconciles the evidence of one kind of quality check within the claim: the claim's Evidence Obligation of that kind, when it has one, against its Evidence Observations of that kind. 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).",
28485
+ [CoreMessage.ReconciliationTotalsReconciliationLineTerm]: "A Reconciliation line is one line of a Quality Check Reconciliation, with its own outcome: each Evidence Observation it holds is one line, and its Evidence Obligation is one more when no Evidence Observation that ran answers it. A scenario with no Evidence Obligation, no Pending Item and no Evidence Observation still has one Quality Check Reconciliation, holding neither, and it 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.",
28486
+ [CoreMessage.ReconciliationTotalsEvidenceObligationTerm]: `An Evidence Obligation is the evidence a scenario asks for, by the tags it carries, to be met by Evidence Observations. A pending tag such as \`@unitpending\` defers the evidence of its kind of quality check, and a deferral tag such as \`@wip\` defers all of the scenario's: what a tag defers raises no Evidence Obligation and is a Pending Item instead, tallied after the table, apart from balanced and out-of-balance, when there is one. On a scenario that shares its \`@SCN\` code with another, no tag defers anything: it reads "${DUPLICATE_SCN_CODE}" at each kind of quality check it raises, or once when it raises none.`,
28487
+ [CoreMessage.ReconciliationTotalsEvidenceObservationTerm]: "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.",
28488
28488
  [CoreMessage.SubjectColumn]: "Subject",
28489
28489
  [CoreMessage.TotalColumn]: "Total",
28490
28490
  [CoreMessage.BalancedColumn]: "Balanced",
@@ -32230,7 +32230,7 @@ function ledgerTableLines(claims, columns, stepsByQualityCheckKind) {
32230
32230
  function renderReport(report, inputNames, exitCodeOf2) {
32231
32231
  return SECTIONS.flatMap((section) => section(report, inputNames, exitCodeOf2)).join("\n");
32232
32232
  }
32233
- var reported, RESULT_MESSAGE, titleSection, runIntegritySection, summarySection, EVIDENCE_RECONCILIATION_COLUMNS, EVIDENCE_RECONCILIATION_TERMS, evidenceReconciliationSection, byFeatureSection, ledgerSection, scenarioCodeFactsSection, SECTIONS;
32233
+ var reported, RESULT_MESSAGE, titleSection, runIntegritySection, summarySection, RECONCILIATION_TOTALS_COLUMNS, RECONCILIATION_TOTALS_TERMS, reconciliationTotalsSection, byFeatureSection, ledgerSection, scenarioCodeFactsSection, SECTIONS;
32234
32234
  var init_markdown = __esm({
32235
32235
  "../core/dist/render/markdown.js"() {
32236
32236
  "use strict";
@@ -32282,29 +32282,29 @@ var init_markdown = __esm({
32282
32282
  return lines;
32283
32283
  };
32284
32284
  summarySection = () => [CORE_MESSAGES[CoreMessage.SummaryHeading], ""];
32285
- EVIDENCE_RECONCILIATION_COLUMNS = [
32285
+ RECONCILIATION_TOTALS_COLUMNS = [
32286
32286
  CORE_MESSAGES[CoreMessage.SubjectColumn],
32287
32287
  CORE_MESSAGES[CoreMessage.TotalColumn],
32288
32288
  CORE_MESSAGES[CoreMessage.BalancedColumn],
32289
32289
  CORE_MESSAGES[CoreMessage.OutOfBalanceColumn],
32290
32290
  CORE_MESSAGES[CoreMessage.DetailColumn]
32291
32291
  ];
32292
- EVIDENCE_RECONCILIATION_TERMS = [
32293
- CoreMessage.EvidenceReconciliationClaimReconciliationTerm,
32294
- CoreMessage.EvidenceReconciliationReconciliationLineTerm,
32295
- CoreMessage.EvidenceReconciliationEvidenceObligationTerm,
32296
- CoreMessage.EvidenceReconciliationEvidenceObservationTerm
32292
+ RECONCILIATION_TOTALS_TERMS = [
32293
+ CoreMessage.ReconciliationTotalsClaimReconciliationTerm,
32294
+ CoreMessage.ReconciliationTotalsReconciliationLineTerm,
32295
+ CoreMessage.ReconciliationTotalsEvidenceObligationTerm,
32296
+ CoreMessage.ReconciliationTotalsEvidenceObservationTerm
32297
32297
  ];
32298
- evidenceReconciliationSection = (report) => {
32299
- const { claimReconciliations, reconciliationLines, pending } = report.summary.evidenceReconciliation;
32298
+ reconciliationTotalsSection = (report) => {
32299
+ const { claimReconciliations, reconciliationLines, pending } = report.summary.reconciliationTotals;
32300
32300
  const row = (cells) => `| ${cells.join(" | ")} |`;
32301
32301
  const missingSplit = reconciliationLines.missingByQualityCheckKind.map(({ qualityCheckKind, count }) => `${count} ${qualityCheckKind}`).join(" + ");
32302
32302
  const lines = [
32303
- CORE_MESSAGES[CoreMessage.EvidenceReconciliationHeading],
32303
+ CORE_MESSAGES[CoreMessage.ReconciliationTotalsHeading],
32304
32304
  "",
32305
- ...EVIDENCE_RECONCILIATION_TERMS.map((term) => `- ${CORE_MESSAGES[term]}`),
32305
+ ...RECONCILIATION_TOTALS_TERMS.map((term) => `- ${CORE_MESSAGES[term]}`),
32306
32306
  "",
32307
- row(EVIDENCE_RECONCILIATION_COLUMNS),
32307
+ row(RECONCILIATION_TOTALS_COLUMNS),
32308
32308
  row(["---", "---", "---", "---", "---"]),
32309
32309
  row([
32310
32310
  CORE_MESSAGES[CoreMessage.ClaimReconciliationSubject],
@@ -32333,7 +32333,7 @@ var init_markdown = __esm({
32333
32333
  const rows = report.claimReconciliations;
32334
32334
  const scenarios = rows.filter(isScenario);
32335
32335
  const groups = report.summary.outOfBalanceByFeature ?? [];
32336
- const ungrouped = ungroupedOutOfBalance(report.summary.evidenceReconciliation.claimReconciliations);
32336
+ const ungrouped = ungroupedOutOfBalance(report.summary.reconciliationTotals.claimReconciliations);
32337
32337
  if (groups.length === 0 && ungrouped.length === 0)
32338
32338
  return [];
32339
32339
  const head = CORE_MESSAGES[CoreMessage.ScenarioClaimReconciliationsOutOfBalance](outOfBalanceCountOf(scenarios), scenarios.length);
@@ -32354,7 +32354,7 @@ var init_markdown = __esm({
32354
32354
  return [
32355
32355
  CORE_MESSAGES[CoreMessage.ClaimReconciliationsHeading],
32356
32356
  "",
32357
- ...ledgerTallyLines(report.summary.evidenceReconciliation.claimReconciliations),
32357
+ ...ledgerTallyLines(report.summary.reconciliationTotals.claimReconciliations),
32358
32358
  "",
32359
32359
  ...evidenceKeyLines(columns),
32360
32360
  ...ledgerTableLines(claims, columns, report.summary.evidenceObservations?.byQualityCheckKind ?? []),
@@ -32381,7 +32381,7 @@ var init_markdown = __esm({
32381
32381
  (report, _inputNames, exitCodeOf2) => runVerdictSection(report, exitCodeOf2),
32382
32382
  scenarioCodesCleanStatement,
32383
32383
  scenarioCodeFactsSection,
32384
- evidenceReconciliationSection,
32384
+ reconciliationTotalsSection,
32385
32385
  evidenceObservationsSection,
32386
32386
  stepAccountingSection,
32387
32387
  byFeatureSection,
@@ -32862,7 +32862,7 @@ var init_inputShapes = __esm({
32862
32862
  runProvenance: { fields: { corpus: "string" }, required: ["corpus"] },
32863
32863
  summary: {
32864
32864
  fields: {
32865
- evidenceReconciliation: {
32865
+ reconciliationTotals: {
32866
32866
  fields: {
32867
32867
  reconciliationLines: {
32868
32868
  fields: {
@@ -32879,7 +32879,7 @@ var init_inputShapes = __esm({
32879
32879
  }
32880
32880
  }
32881
32881
  },
32882
- required: ["evidenceReconciliation", "evidenceObservations", "scenarioCodes"]
32882
+ required: ["reconciliationTotals", "evidenceObservations", "scenarioCodes"]
32883
32883
  },
32884
32884
  claimReconciliations: {
32885
32885
  list: {
@@ -27,7 +27,7 @@
27
27
  "$ref": "#/definitions/FeatureOutOfBalance"
28
28
  }
29
29
  },
30
- "evidenceReconciliation": {
30
+ "reconciliationTotals": {
31
31
  "type": "object",
32
32
  "properties": {
33
33
  "claimReconciliations": {
@@ -55,7 +55,7 @@
55
55
  }
56
56
  },
57
57
  "required": [
58
- "evidenceReconciliation",
58
+ "reconciliationTotals",
59
59
  "runVerdict"
60
60
  ]
61
61
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-controller",
3
- "version": "0.1.223",
3
+ "version": "0.1.224",
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.223"
29
+ "@3f-consulting/spec-controller-core": "0.1.224"
30
30
  },
31
31
  "publishConfig": {
32
32
  "access": "public"