spec-controller 0.1.198 → 0.1.200
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 +48 -46
- package/package.json +2 -2
package/dist/cli.js
CHANGED
|
@@ -28504,36 +28504,37 @@ var init_messages4 = __esm({
|
|
|
28504
28504
|
CoreMessage2[CoreMessage2["ReconcilingItemsColumn"] = 129] = "ReconcilingItemsColumn";
|
|
28505
28505
|
CoreMessage2[CoreMessage2["CiStepsColumn"] = 130] = "CiStepsColumn";
|
|
28506
28506
|
CoreMessage2[CoreMessage2["EvidenceCellKey"] = 131] = "EvidenceCellKey";
|
|
28507
|
-
CoreMessage2[CoreMessage2["
|
|
28508
|
-
CoreMessage2[CoreMessage2["
|
|
28509
|
-
CoreMessage2[CoreMessage2["
|
|
28510
|
-
CoreMessage2[CoreMessage2["
|
|
28511
|
-
CoreMessage2[CoreMessage2["
|
|
28512
|
-
CoreMessage2[CoreMessage2["
|
|
28513
|
-
CoreMessage2[CoreMessage2["
|
|
28514
|
-
CoreMessage2[CoreMessage2["
|
|
28515
|
-
CoreMessage2[CoreMessage2["
|
|
28516
|
-
CoreMessage2[CoreMessage2["
|
|
28517
|
-
CoreMessage2[CoreMessage2["
|
|
28518
|
-
CoreMessage2[CoreMessage2["
|
|
28519
|
-
CoreMessage2[CoreMessage2["
|
|
28520
|
-
CoreMessage2[CoreMessage2["
|
|
28521
|
-
CoreMessage2[CoreMessage2["
|
|
28522
|
-
CoreMessage2[CoreMessage2["
|
|
28523
|
-
CoreMessage2[CoreMessage2["
|
|
28524
|
-
CoreMessage2[CoreMessage2["
|
|
28525
|
-
CoreMessage2[CoreMessage2["
|
|
28526
|
-
CoreMessage2[CoreMessage2["
|
|
28527
|
-
CoreMessage2[CoreMessage2["
|
|
28528
|
-
CoreMessage2[CoreMessage2["
|
|
28529
|
-
CoreMessage2[CoreMessage2["
|
|
28530
|
-
CoreMessage2[CoreMessage2["
|
|
28531
|
-
CoreMessage2[CoreMessage2["
|
|
28532
|
-
CoreMessage2[CoreMessage2["
|
|
28533
|
-
CoreMessage2[CoreMessage2["
|
|
28534
|
-
CoreMessage2[CoreMessage2["
|
|
28535
|
-
CoreMessage2[CoreMessage2["
|
|
28536
|
-
CoreMessage2[CoreMessage2["
|
|
28507
|
+
CoreMessage2[CoreMessage2["WatermelonItemKey"] = 132] = "WatermelonItemKey";
|
|
28508
|
+
CoreMessage2[CoreMessage2["PendingItem"] = 133] = "PendingItem";
|
|
28509
|
+
CoreMessage2[CoreMessage2["PendingItemFor"] = 134] = "PendingItemFor";
|
|
28510
|
+
CoreMessage2[CoreMessage2["CheckStepNoOutcome"] = 135] = "CheckStepNoOutcome";
|
|
28511
|
+
CoreMessage2[CoreMessage2["CheckStepSkipped"] = 136] = "CheckStepSkipped";
|
|
28512
|
+
CoreMessage2[CoreMessage2["CheckStepEnded"] = 137] = "CheckStepEnded";
|
|
28513
|
+
CoreMessage2[CoreMessage2["AmbiguousNamedStep"] = 138] = "AmbiguousNamedStep";
|
|
28514
|
+
CoreMessage2[CoreMessage2["AmbiguousUnnamedStep"] = 139] = "AmbiguousUnnamedStep";
|
|
28515
|
+
CoreMessage2[CoreMessage2["ManifestKindList"] = 140] = "ManifestKindList";
|
|
28516
|
+
CoreMessage2[CoreMessage2["ManifestKindObject"] = 141] = "ManifestKindObject";
|
|
28517
|
+
CoreMessage2[CoreMessage2["ManifestKindString"] = 142] = "ManifestKindString";
|
|
28518
|
+
CoreMessage2[CoreMessage2["ManifestKindStringOrNull"] = 143] = "ManifestKindStringOrNull";
|
|
28519
|
+
CoreMessage2[CoreMessage2["ManifestKindOfType"] = 144] = "ManifestKindOfType";
|
|
28520
|
+
CoreMessage2[CoreMessage2["OutcomeSatisfied"] = 145] = "OutcomeSatisfied";
|
|
28521
|
+
CoreMessage2[CoreMessage2["OutcomeMissing"] = 146] = "OutcomeMissing";
|
|
28522
|
+
CoreMessage2[CoreMessage2["OutcomeFailing"] = 147] = "OutcomeFailing";
|
|
28523
|
+
CoreMessage2[CoreMessage2["OutcomeWatermelon"] = 148] = "OutcomeWatermelon";
|
|
28524
|
+
CoreMessage2[CoreMessage2["OutcomeNoScnCode"] = 149] = "OutcomeNoScnCode";
|
|
28525
|
+
CoreMessage2[CoreMessage2["OutcomeDuplicateScnCode"] = 150] = "OutcomeDuplicateScnCode";
|
|
28526
|
+
CoreMessage2[CoreMessage2["OutcomeCitesUnknownScenario"] = 151] = "OutcomeCitesUnknownScenario";
|
|
28527
|
+
CoreMessage2[CoreMessage2["OutcomeCitesNoScenario"] = 152] = "OutcomeCitesNoScenario";
|
|
28528
|
+
CoreMessage2[CoreMessage2["OutcomeNoEvidenceObligation"] = 153] = "OutcomeNoEvidenceObligation";
|
|
28529
|
+
CoreMessage2[CoreMessage2["OutcomeBroken"] = 154] = "OutcomeBroken";
|
|
28530
|
+
CoreMessage2[CoreMessage2["OutcomeBothMissing"] = 155] = "OutcomeBothMissing";
|
|
28531
|
+
CoreMessage2[CoreMessage2["ObservationPassed"] = 156] = "ObservationPassed";
|
|
28532
|
+
CoreMessage2[CoreMessage2["ObservationFailed"] = 157] = "ObservationFailed";
|
|
28533
|
+
CoreMessage2[CoreMessage2["UnnamedClaimGroupCounts"] = 158] = "UnnamedClaimGroupCounts";
|
|
28534
|
+
CoreMessage2[CoreMessage2["UnnamedClaimCiSteps"] = 159] = "UnnamedClaimCiSteps";
|
|
28535
|
+
CoreMessage2[CoreMessage2["UnnamedClaimFailedNames"] = 160] = "UnnamedClaimFailedNames";
|
|
28536
|
+
CoreMessage2[CoreMessage2["SeveralScnCodes"] = 161] = "SeveralScnCodes";
|
|
28537
|
+
CoreMessage2[CoreMessage2["SharedScnCode"] = 162] = "SharedScnCode";
|
|
28537
28538
|
})(CoreMessage || (CoreMessage = {}));
|
|
28538
28539
|
SATISFIED = "Evidence Observation satisfies its Evidence Obligation";
|
|
28539
28540
|
MISSING = "Evidence Observation is missing";
|
|
@@ -28567,7 +28568,7 @@ var init_messages4 = __esm({
|
|
|
28567
28568
|
[CoreMessage.RunIntegrityHeading]: "## Run integrity: unsound",
|
|
28568
28569
|
[CoreMessage.OneProofNeverRan]: "1 proof never ran, so the behaviour it proves was never exercised.",
|
|
28569
28570
|
[CoreMessage.ProofsNeverRan]: (count) => `${count} proofs never ran, so the behaviours they prove were never exercised.`,
|
|
28570
|
-
[CoreMessage.RunUnsound]: (proofs) => `**This run is unsound.** ${proofs} A row
|
|
28571
|
+
[CoreMessage.RunUnsound]: (proofs) => `**This run is unsound.** ${proofs} A broken proof sits on the row of the claim it names, as every Evidence Observation does. On a scenario's row, an Evidence Obligation of its kind of quality check that no other proof answers reads "${MISSING}", though its test may already be written. A broken proof on the row of a phantom claim or of the unnamed claim may be the proof behind any item of its kind of quality check that reads "${MISSING}", on any row. Fix what stopped each proof listed below from running, such as its test, the code it loads, its step definitions, its runner or the CI job that runs it. Then run them again and regenerate this report.`,
|
|
28571
28572
|
[CoreMessage.BrokenEvidenceNotNamed]: "(evidence not named by the runner)",
|
|
28572
28573
|
[CoreMessage.BrokenEvidenceWhatBroke]: (locator) => `${locator} \u2014 what broke:`,
|
|
28573
28574
|
[CoreMessage.BrokenEvidenceNoMessage]: "(no message reported by the runner)",
|
|
@@ -28615,10 +28616,10 @@ var init_messages4 = __esm({
|
|
|
28615
28616
|
[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.`,
|
|
28616
28617
|
[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`.",
|
|
28617
28618
|
[CoreMessage.EvidenceReconciliationHeading]: "### Evidence reconciliation",
|
|
28618
|
-
[CoreMessage.EvidenceReconciliationClaimReconciliationTerm]: "A Claim Reconciliation is one row of the ledger:
|
|
28619
|
+
[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).",
|
|
28619
28620
|
[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.",
|
|
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
|
|
28621
|
-
[CoreMessage.EvidenceReconciliationEvidenceObservationTerm]: "An Evidence Observation is one reported result of a test or a fitness function, attributed by the
|
|
28621
|
+
[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.",
|
|
28622
|
+
[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.",
|
|
28622
28623
|
[CoreMessage.SubjectColumn]: "Subject",
|
|
28623
28624
|
[CoreMessage.TotalColumn]: "Total",
|
|
28624
28625
|
[CoreMessage.BalancedColumn]: "Balanced",
|
|
@@ -28651,10 +28652,10 @@ var init_messages4 = __esm({
|
|
|
28651
28652
|
[CoreMessage.StepAccountingNotAppliedLabel]: (key, workflowsRead) => `Not applied, because each ${key} entry below names a workflow this run did not read (this run read ${workflowsRead}):`,
|
|
28652
28653
|
[CoreMessage.StepAccountingNoWorkflowRead]: "no workflow",
|
|
28653
28654
|
[CoreMessage.StepAccountingPlumbingLabel]: "GitHub plumbing:",
|
|
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
|
|
28655
|
+
[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.",
|
|
28655
28656
|
[CoreMessage.StepAccountingReconcilerTerm]: "A Reconciler step runs this reconciliation or writes the step record it reads.",
|
|
28656
|
-
[CoreMessage.StepAccountingExcludedTerm]: "An Excluded step is one the target names a non-check under `specController.notChecks
|
|
28657
|
-
[CoreMessage.StepAccountingPlumbingTerm]: "A GitHub plumbing step
|
|
28657
|
+
[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.",
|
|
28658
|
+
[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.",
|
|
28658
28659
|
[CoreMessage.StepAccountingAccountedForTerm]: "Accounted for is the sum of the five columns from Candidates to GitHub plumbing, in which each step read is counted once.",
|
|
28659
28660
|
[CoreMessage.OutOfBalanceByFeatureHeading]: "### Out-of-balance by feature",
|
|
28660
28661
|
[CoreMessage.ScenarioClaimReconciliationsOutOfBalance]: (outOfBalance, claimReconciliations) => `${outOfBalance} of ${claimReconciliations} Claim Reconciliation(s) of scenarios out of balance`,
|
|
@@ -28679,15 +28680,16 @@ var init_messages4 = __esm({
|
|
|
28679
28680
|
[CoreMessage.CiStepsColumn]: "CI steps",
|
|
28680
28681
|
[CoreMessage.EvidenceCellKey]: [
|
|
28681
28682
|
"Key: each evidence cell reads *obligation*/*observations*.",
|
|
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.
|
|
28683
|
-
"- The number counts the Evidence Observations
|
|
28683
|
+
"- 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.",
|
|
28684
|
+
"- The number counts the scenario's Evidence Observations of that kind that ran. `-` means none.",
|
|
28684
28685
|
"- 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.",
|
|
28685
|
-
"- A blank cell means
|
|
28686
|
+
"- 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.",
|
|
28686
28687
|
"- 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.",
|
|
28687
|
-
"- In Reconciling items, `\u2014` means the row has no reconciling item, and *untagged* means
|
|
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; a broken item stands alone and is counted in none.",
|
|
28689
|
-
"- CI steps names the
|
|
28688
|
+
"- 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.",
|
|
28689
|
+
"- 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.",
|
|
28690
|
+
"- 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."
|
|
28690
28691
|
].join("\n"),
|
|
28692
|
+
[CoreMessage.WatermelonItemKey]: "- Where a row carries a watermelon item, the name in parentheses after it is its fitness function. Remove `continue-on-error` from its CI step and from its job, or set it to false, and the check's red fails the CI run.",
|
|
28691
28693
|
[CoreMessage.PendingItem]: "pending",
|
|
28692
28694
|
[CoreMessage.PendingItemFor]: (qualityCheckKind) => `pending: ${qualityCheckKind}`,
|
|
28693
28695
|
[CoreMessage.CheckStepNoOutcome]: (scnId) => `${scnId}: the CI run's record carries no outcome for this check's step \u2014 so the check did not run.`,
|
|
@@ -28703,13 +28705,13 @@ var init_messages4 = __esm({
|
|
|
28703
28705
|
[CoreMessage.OutcomeSatisfied]: SATISFIED,
|
|
28704
28706
|
[CoreMessage.OutcomeMissing]: MISSING,
|
|
28705
28707
|
[CoreMessage.OutcomeFailing]: "Evidence Observation is failing",
|
|
28706
|
-
[CoreMessage.OutcomeWatermelon]: "Evidence Observation is passing but its
|
|
28708
|
+
[CoreMessage.OutcomeWatermelon]: "Evidence Observation is passing but its CI step or its job sets `continue-on-error` so its red might not fail the CI run",
|
|
28707
28709
|
[CoreMessage.OutcomeNoScnCode]: "Evidence Obligation has no @SCN code for an Evidence Observation to link to",
|
|
28708
28710
|
[CoreMessage.OutcomeDuplicateScnCode]: DUPLICATE_SCN_CODE,
|
|
28709
28711
|
[CoreMessage.OutcomeCitesUnknownScenario]: "Evidence Observation cites an unknown Scenario",
|
|
28710
28712
|
[CoreMessage.OutcomeCitesNoScenario]: "Evidence Observation cites no Scenario",
|
|
28711
28713
|
[CoreMessage.OutcomeNoEvidenceObligation]: "Evidence Observation cites a Scenario with no matching Evidence Obligation",
|
|
28712
|
-
[CoreMessage.OutcomeBroken]: "Evidence Observation
|
|
28714
|
+
[CoreMessage.OutcomeBroken]: "Evidence Observation is broken because its proof never ran to a result",
|
|
28713
28715
|
[CoreMessage.OutcomeBothMissing]: "Evidence Obligation and Evidence Observation are both missing \u2014 the Scenario is untagged and uncited",
|
|
28714
28716
|
[CoreMessage.ObservationPassed]: "passed",
|
|
28715
28717
|
[CoreMessage.ObservationFailed]: "failed",
|
|
@@ -29467,7 +29469,7 @@ function ungroupedTail(ungrouped) {
|
|
|
29467
29469
|
function evidenceKeyLines(columns) {
|
|
29468
29470
|
if (columns.length === 0)
|
|
29469
29471
|
return [];
|
|
29470
|
-
return [...CORE_MESSAGES[CoreMessage.EvidenceCellKey].split("\n"), ""];
|
|
29472
|
+
return [...CORE_MESSAGES[CoreMessage.EvidenceCellKey].split("\n"), CORE_MESSAGES[CoreMessage.WatermelonItemKey], ""];
|
|
29471
29473
|
}
|
|
29472
29474
|
function ledgerTallyLines(totals) {
|
|
29473
29475
|
const lines = [
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "spec-controller",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.200",
|
|
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.200"
|
|
30
30
|
},
|
|
31
31
|
"publishConfig": {
|
|
32
32
|
"access": "public"
|