spec-controller 0.1.0-alpha.4 → 0.1.0-alpha.40

package/dist/mutation-ratchet/report.js

@@ -1,156 +0,0 @@
-/**
- * THE MEASUREMENT — a gate's run, counted out of its mutation report's own mutants
- * (@SCN-MUT-007, 3F-2799, 3F-3337).
- *
- * THE RATCHET THAT RECONCILED THIS IS GONE; THE READER IS NOT (3F-3337). Its one remaining caller
- * is `tests/checks/mutationScoreCli.ts` — `pnpm mutation:score`, the producer that posts
- * SCN-FIT-002's number — which takes the two counts out of this and divides them. @SCN-MUT-007 and
- * @SCN-MUT-008 are what specify it now, and they state the same two things this file states: the
- * valid population is the killed and the timed-out over those plus the survived and the
- * never-covered, and a run with no readable report posts nothing rather than a count of zero.
- *
- * STATED, NEVER INFERRED, AND THAT IS THE WHOLE MODULE. A mutation report groups its mutants by
- * the file they were made in and gives each one a status. The metric scores two of those statuses
- * over four: the kills are the killed and the timed-out, and the population is those plus the
- * survived and the never-covered. Both sets are written down below, member by member, and the four
- * statuses left over — a mutant that would not compile, one that faulted at run time, one the run
- * was told to ignore, and one that never got as far as being tried — are in neither.
- *
- * THE LENIENT READING IS ONE SENTENCE LONG, AND IT IS WRONG. "Everything not detected is
- * undetected" reaches a population without anybody having to write a second set down, and it folds
- * all four of those statuses into the denominator. A mutant that would not compile is not a
- * survivor: nobody's assertion failed to catch it, because there was never anything there to catch.
- * So that reading answers with a score which disagrees with the one the run itself printed —
- * quietly, and in the direction of looking worse — and a reconciler holding a second opinion about
- * the very number it is reconciling has stopped being one. Naming the two sets is what makes that
- * disagreement impossible rather than merely unlikely.
- *
- * AND THE REPORT'S OWN THRESHOLDS ARE NOT READ, WHICH IS THE SAME RULING ONE ARTEFACT FURTHER OUT.
- * A report carries the thresholds its own run was configured against, and reading them would be
- * taking the runner's verdict on its own homework as the measurement. The bar lives in the record
- * (SCN-FIT-002's own row, which `stryker.config.mjs` reads back), and the report is only ever
- * asked what happened. Every figure produced here is
- * counted from the mutants; every other number in the document is left where it lies, however
- * conveniently it is shaped.
- *
- * THE COUNTS ARE TAKEN ACROSS THE WHOLE REPORT RATHER THAN A FILE OF IT. The grouping is
- * presentation and nothing more — a gate's population is every mutant under it, wherever the report
- * chose to file it. A counter that stopped at the first file would be green against every report
- * holding exactly one, which is the shape a small fixture takes by default.
- *
- * AND A REPORT THAT CANNOT BE READ, OR THAT HOLDS NO SCORED MUTANT AT ALL, IS REFUSED RATHER THAN
- * SCORED ZERO (@SCN-MUT-008). Zero is a measurement — a run that mutated the scope and killed none
- * of it — and the two must not be spelled the same, because reconciling a zero reaches a regression
- * whose message sends its reader hunting kills that in this case never happened. The refusal comes
- * back as a value rather than a throw, so a caller cannot drop it by forgetting to catch.
- *
- * NOTHING HERE NAMES A PROJECT, A CHECK, A RUNNER, A WORKFLOW OR A REPOSITORY. The shape read below
- * is the report FORMAT's, which is nobody's installation, and the gate's name arrives from the
- * caller rather than out of the document.
- */
-import { existsSync, readFileSync } from "node:fs";
-/**
- * The statuses that are a kill.
- *
- * A TIMEOUT IS A KILL AND NOT A NEAR-MISS. The mutant changed the code enough that the suite never
- * finished, which is the suite noticing — the same event as an assertion firing, reached by a
- * slower road.
- */
-const DETECTED = ["Killed", "Timeout"];
-/**
- * The statuses that are in the population and are not a kill.
- *
- * NEVER-COVERED IS COUNTED, AND THAT IS THE HALF A LENIENT READER LOSES BY LEAVING IT OUT. A mutant
- * no test reached is one this suite would not have noticed, which is precisely what the metric
- * measures; dropping it from the denominator would score untested code as though it were not there.
- */
-const UNDETECTED = ["Survived", "NoCoverage"];
-/** A refusal, as the value it is. */
-function refused(reason) {
-    return { ok: false, reason };
-}
-/** Whatever an error carries by way of a sentence, whatever kind of thing was thrown. */
-function raisedBy(cause) {
-    return cause instanceof Error ? cause.message : String(cause);
-}
-/** A JSON object — not a list, and not the null a bare `typeof` reads as one. */
-function isMapping(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Every mutant in the report, flattened out of the per-file grouping it arrived in — or `null`
- * where the document holds no grouping to flatten.
- *
- * THE TWO EMPTINESSES ARE NOT THE SAME AND ARE NOT ANSWERED THE SAME. `null` is a document that
- * never had a files section; an empty list is a section that holds no mutant. Told apart, one
- * reader is sent to the shape of the artefact and the other to the sweep that filled it; folded
- * together, whichever sentence was chosen sends half of them somewhere useless.
- */
-function mutantsIn(document) {
-    const files = document["files"];
-    if (!isMapping(files))
-        return null;
-    return Object.values(files).flatMap((file) => {
-        const mutants = isMapping(file) ? file["mutants"] : undefined;
-        return Array.isArray(mutants) ? mutants : [];
-    });
-}
-/** How many of these mutants carry a status the given set names. */
-function countOf(mutants, statuses) {
-    return mutants.filter((mutant) => statuses.includes(mutant.status)).length;
-}
-/**
- * Count a gate's measurement out of its report's text, or say why there is not one.
- *
- * THE GATE IS THE CALLER'S WORD FOR IT. A report says which files were mutated and nothing about
- * which gate was being run, so a name taken from the document would be a name this module invented.
- *
- * AND SO IS THE PATH, WHICH IS CARRIED PURELY SO A REFUSAL CAN NAME IT — the same reason
- * `parseGateRecords` carries the record file's name. Text has no path of its own, and "no
- * measurement" over a path nothing writes to and "no measurement" over a sweep that never ran are
- * the same sentence with entirely different fixes.
- */
-export function measurementFromReport(gate, text, reportPath) {
-    let document;
-    try {
-        document = JSON.parse(text);
-    }
-    catch (cause) {
-        return refused(`the report at ${reportPath} is not readable JSON: ${raisedBy(cause)}`);
-    }
-    if (!isMapping(document)) {
-        return refused(`the report at ${reportPath} is not a mutation-report document.`);
-    }
-    const mutants = mutantsIn(document);
-    if (mutants === null) {
-        return refused(`the report at ${reportPath} holds no files section.`);
-    }
-    const detected = countOf(mutants, DETECTED);
-    const undetected = countOf(mutants, UNDETECTED);
-    if (detected + undetected === 0) {
-        return refused(`the report at ${reportPath} holds no scored mutant — the gate measured nothing.`);
-    }
-    return { ok: true, measurement: { gate, detected, total: detected + undetected } };
-}
-/**
- * Read a gate's measurement off the tree, refusing an absent report by the path it was sought at.
- *
- * THE PATH ARRIVES RESOLVED, AND THAT IS THE WHOLE OF THIS MODULE'S OPINION ABOUT WHERE A TREE IS.
- * A reader that joined a root of its own — its own installed location, or wherever the process
- * happened to start — is correct only while those coincide with the caller's, which they stop
- * doing the moment this ships as something another repository installs.
- */
-export function readMutationReport(gate, reportPath) {
-    if (!existsSync(reportPath)) {
-        return refused(`no report at ${reportPath} — the gate produced no score, or never ran.`);
-    }
-    let text;
-    try {
-        text = readFileSync(reportPath, "utf8");
-    }
-    catch (cause) {
-        return refused(`the report at ${reportPath} could not be read: ${raisedBy(cause)}`);
-    }
-    return measurementFromReport(gate, text, reportPath);
-}
-//# sourceMappingURL=report.js.map

package/dist/mutation-ratchet/report.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/mutation-ratchet/report.ts"],"names":[],"mappings":"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"}