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 +28 -28
- package/dist/spec-reconciliation.schema.json +2 -2
- package/package.json +2 -2
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
|
-
|
|
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["
|
|
28302
|
-
CoreMessage2[CoreMessage2["
|
|
28303
|
-
CoreMessage2[CoreMessage2["
|
|
28304
|
-
CoreMessage2[CoreMessage2["
|
|
28305
|
-
CoreMessage2[CoreMessage2["
|
|
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.
|
|
28484
|
-
[CoreMessage.
|
|
28485
|
-
[CoreMessage.
|
|
28486
|
-
[CoreMessage.
|
|
28487
|
-
[CoreMessage.
|
|
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,
|
|
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
|
-
|
|
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
|
-
|
|
32293
|
-
CoreMessage.
|
|
32294
|
-
CoreMessage.
|
|
32295
|
-
CoreMessage.
|
|
32296
|
-
CoreMessage.
|
|
32292
|
+
RECONCILIATION_TOTALS_TERMS = [
|
|
32293
|
+
CoreMessage.ReconciliationTotalsClaimReconciliationTerm,
|
|
32294
|
+
CoreMessage.ReconciliationTotalsReconciliationLineTerm,
|
|
32295
|
+
CoreMessage.ReconciliationTotalsEvidenceObligationTerm,
|
|
32296
|
+
CoreMessage.ReconciliationTotalsEvidenceObservationTerm
|
|
32297
32297
|
];
|
|
32298
|
-
|
|
32299
|
-
const { claimReconciliations, reconciliationLines, pending } = report.summary.
|
|
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.
|
|
32303
|
+
CORE_MESSAGES[CoreMessage.ReconciliationTotalsHeading],
|
|
32304
32304
|
"",
|
|
32305
|
-
...
|
|
32305
|
+
...RECONCILIATION_TOTALS_TERMS.map((term) => `- ${CORE_MESSAGES[term]}`),
|
|
32306
32306
|
"",
|
|
32307
|
-
row(
|
|
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.
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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: ["
|
|
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
|
-
"
|
|
30
|
+
"reconciliationTotals": {
|
|
31
31
|
"type": "object",
|
|
32
32
|
"properties": {
|
|
33
33
|
"claimReconciliations": {
|
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
}
|
|
56
56
|
},
|
|
57
57
|
"required": [
|
|
58
|
-
"
|
|
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.
|
|
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.
|
|
29
|
+
"@3f-consulting/spec-controller-core": "0.1.224"
|
|
30
30
|
},
|
|
31
31
|
"publishConfig": {
|
|
32
32
|
"access": "public"
|