spec-controller 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/run-management/resolveRunInputs.js

@@ -6,11 +6,11 @@
  * CLI (cli-balance/cli.ts) calls these once to build the RunContext.
  *
  * Scenarios: @SCN-RPT-001 (the run-provenance slice); the --source-sha override;
- * @SCN-RPT-016 (target-root derivation).
+ * @SCN-RPT-016 (target-root derivation); @SCN-RPT-026 / @SCN-RPT-029 (the tool's own identity).
  */
 import { execFileSync } from "node:child_process";
 import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { dirname, join, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 /**
  * Resolve the target's source SHA (project design §4). An explicit non-empty
@@ -44,17 +44,30 @@ export function resolveSourceSha(opts) {
  * distinct from the TARGET's `sourceSha`. Two facts, one call, threaded to both the
  * report provenance (RunContext) and the run.yaml manifest.
  *
- * **The correctness trap this exists to avoid:** at run time the process cwd is the
- * TARGET repo (reconcile runs there), so a bare `git rev-parse HEAD` would re-record the
- * TARGET's SHA — the exact bug this ticket fixes. So the SHA is read `git -C <the tool's
- * OWN dir>`, derived from `import.meta.url`, never cwd.
+ * **TWO TRAPS, AND THIS DOCBLOCK ONLY NAMED THE FIRST FOR ELEVEN WEEKS** (@SCN-RPT-029,
+ * 3F-3418). Nothing typechecks a comment, and the sentence below — true, and the whole of
+ * what was written here — is what made the second trap read as already-handled.
  *
- * `toolSha` is `git -C <toolDir> rev-parse HEAD` (trimmed), or `null` on any throw — the
- * tool installed as a package with no `.git`, git absent, or an empty answer — mirroring
- * `resolveSourceSha`'s fail-soft. `toolVersion` is read from the tool's own
- * `package.json` (walked up from `toolDir`), or `"unknown"` when none is found — so a run
- * stays attributable by version even when no SHA can be read. `toolDir` /
- * `packageJsonPath` are injectable for the `@unit` teeth (@SCN-RPT-026).
+ * **Trap one, cwd:** at run time the process cwd is the TARGET repo (reconcile runs
+ * there), so a bare `git rev-parse HEAD` would re-record the TARGET's SHA. So the SHA is
+ * read `git -C <the tool's OWN dir>`, derived from `import.meta.url`, never cwd (3F-1916).
+ *
+ * **Trap two, which the `-C` guard could not see:** the tool's own dir is ITSELF inside the
+ * target. For an installed package that dir is `<consumer>/node_modules/…`, which is inside
+ * the consumer's worktree, so `git -C` walks up to the consumer's `.git` and answers with
+ * the consumer's HEAD — being `.gitignore`d makes no difference, git does not stop at
+ * ignored directories. That is not an absent tool SHA, it is a WRONG one, and nothing on
+ * the rendered report distinguishes it from a genuine one. It is also the only case a
+ * consumer ever sees: every adopter installs into a git repository. `resolveToolSha`
+ * therefore answers a `node_modules` SEGMENT before it asks git at all.
+ *
+ * `toolSha` is `null` for a tool resolved out of `node_modules`, and otherwise
+ * `git -C <toolDir> rev-parse HEAD` (trimmed) or `null` on any throw — no `.git` above the
+ * tool, git absent, or an empty answer — mirroring `resolveSourceSha`'s fail-soft.
+ * `toolVersion` is read from the tool's own `package.json` (walked up from `toolDir`), or
+ * `"unknown"` when none is found — so a run stays attributable by version even when no SHA
+ * can be read. `toolDir` / `packageJsonPath` are injectable for the `@unit` teeth
+ * (@SCN-RPT-026, @SCN-RPT-029).
  */
 export function resolveToolIdentity(opts = {}) {
     const toolDir = opts.toolDir !== undefined && opts.toolDir.trim() !== ""
@@ -65,8 +78,31 @@ export function resolveToolIdentity(opts = {}) {
         toolVersion: resolveToolVersion(opts.packageJsonPath ?? findPackageJson(toolDir)),
     };
 }
-/** The tool's own git HEAD, read `-C <toolDir>` (never cwd), null on any throw. */
+/**
+ * The tool's own git HEAD, read `-C <toolDir>` (never cwd), null on any throw — and null
+ * without asking at all for a tool resolved out of `node_modules` (@SCN-RPT-029).
+ *
+ * A SEGMENT, NEVER A SUBSTRING. A directory honestly named `my_node_modules_backup` is not an
+ * install, and a checkout living under a directory literally named `node_modules` reporting null is
+ * the pathological trade every tool making this distinction takes.
+ *
+ * `sep`, NOT A REGEX OVER BOTH SEPARATORS. `[/\\]` would carry a branch no arm on this platform can
+ * reach, so a mutant deleting its second half would survive the mutation gate while nothing was
+ * worse. `sep` is what `fileURLToPath` produces on each platform, which is the only thing `toolDir`
+ * is ever built from.
+ *
+ * IT ANSWERS BEFORE THE `try`, NOT INSIDE IT. Returning null from a thrown git read and returning
+ * null because the tool is an install are the same recorded answer and not the same fact, and only
+ * the first of them is allowed to depend on git being present.
+ *
+ * WHAT IT DOES NOT CLAIM. Under `--preserve-symlinks` Node reports the symlink path rather than the
+ * realpath, so a linked development checkout would carry a `node_modules` segment and report null.
+ * That is a strictly safer wrong answer than today's, nothing in this repository passes the flag,
+ * and no arm covers it — named rather than guarded.
+ */
 function resolveToolSha(toolDir) {
+    if (toolDir.split(sep).includes("node_modules"))
+        return null;
     try {
         const out = execFileSync("git", ["-C", toolDir, "rev-parse", "HEAD"], {
             encoding: "utf8",

package/dist/run-management/resolveRunInputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveRunInputs.js","sourceRoot":"","sources":["../../src/run-management/resolveRunInputs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolveRunInputs.js","sourceRoot":"","sources":["../../src/run-management/resolveRunInputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgD;IAC/E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;YACtE,CAAC,CAAC,IAAI,CAAC,SAAS;YAChB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;YAChE,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuD,EAAE;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QACtE,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAChC,WAAW,EAAE,kBAAkB,CAAC,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;YACpE,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,6GAA6G;AAC7G,SAAS,kBAAkB,CAAC,eAA8B;IACxD,IAAI,eAAe,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAA0B,CAAC;QACvF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAChC,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE;YACjF,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-controller",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Reconcile the behaviour your scenarios name against the evidence that actually ran — the deterministic `balance` CLI.",
   "keywords": [
     "reconciliation",
@@ -10,6 +10,11 @@
     "double-entry",
     "cli"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/3f-consulting/spec-controller.git",
+    "directory": "packages/spec-controller"
+  },
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -25,7 +30,7 @@
     "@cucumber/gherkin": "^41.0.0",
     "@cucumber/messages": "^34.0.1",
     "yaml": "^2.9.0",
-    "@3f-consulting/spec-controller-core": "0.1.0-alpha.1"
+    "@3f-consulting/spec-controller-core": "0.1.0-alpha.3"
   },
   "publishConfig": {
     "access": "public"

package/dist/mutation-ratchet/ratchet.d.ts

@@ -1,129 +0,0 @@
-/**
- * THE RECORDER — a measurement written into the record as a surgical text edit (@SCN-RAT-011,
- * 3F-2801), refused outright when it is not a raise (@SCN-RAT-012, 3F-2802), and kept inside the
- * block it names when a sibling gate banks the very same counts (@SCN-RAT-013, 3F-2803).
- *
- * A SURGICAL TEXT EDIT, NEVER A RE-DUMP, AND THAT IS THE WHOLE OF THIS MODULE'S DIFFICULTY.
- * Emitting the parsed document back out is the obvious way to write two figures into a record, and
- * it throws away every comment on the way through — comments are not part of the document a parser
- * hands back. A record file is MOSTLY comment: every allowance's justification lives there, and so
- * does the argument for the bar sitting where it sits. So a recorder that re-serialised would
- * delete the reasoning for the very bar it was raising, quietly, in the same commit that claims to
- * be strengthening it, and with the two figures perfectly correct.
- *
- * SO THE TEXT ARRIVES AS TEXT AND LEAVES AS TEXT. Nothing below reaches for a document model. The
- * record is split on its own line breaks, two lines are rewritten where they lie, and the pieces
- * are joined back up — which is why what comes back is the bytes it was handed with two numerals
- * different, down to the blank lines, the indent style, the quoting and the trailing newline.
- *
- * AND THE EDIT IS BOUNDED BY THE NAMED GATE'S OWN BLOCK. A record is a wall of near-identical
- * blocks holding identically-named lines, so a rewriter that took the first `detected` line it met
- * would raise whichever gate happens to be written first and report success on the one it was
- * asked about. The block runs from the gate's key line to the first line after it indented no
- * further than that key — the next gate, or the comment introducing it. The search for that key
- * starts at the gates section rather than the top of the file, because a record is a project's own
- * policy document and may hold anything else it likes above the bars.
- *
- * THE LINES ARE THEN FOUND BY POSITION INSIDE THAT BLOCK, NEVER BY THE FIGURES THEY CARRY, and the
- * difference is invisible over almost every record. A rewriter that struck the OLD numerals out
- * wherever they first appeared would be byte-preserving, would move exactly two lines, would keep
- * every comment, and would write precisely the right two lines over any record whose gates hold
- * distinct figures. It writes the WRONG gate only when two gates bank the same counts — and then
- * silently, leaving the two gates stating figures neither of the trees they describe ever measured.
- * @SCN-RAT-013's record plants that collision on purpose, and authors it with the named gate above
- * its twin and below it, because either rewriter is right by luck when the gate it wants is first.
- *
- * A LINE THE BLOCK DOES NOT HOLD IS AN ERROR NAMING THE LINE, NEVER A NO-OP. Both of the other
- * answers are worse than a refusal: skipping quietly banks half a measurement and reports a raise
- * that did not happen, and searching on past the block's end rewrites some other gate's figure with
- * this gate's count.
- *
- * EVERY FAULT IN THE RECORD IS `record.ts`'s ONE REFUSAL TYPE, and its section name and gate
- * placeholder are imported rather than respelled. A caller is told to catch `MalformedRecordError`
- * for a record it cannot read, so a record fault raised here under a second type is one that caller
- * sails past — and a second copy of the section's name is the agreeing-until-somebody-edits-one
- * shape this library exists to remove.
- *
- * AND THE UP-ONLY REFUSAL IS THE ONE THING HERE THAT IS NOT A RECORD FAULT, WHICH IS WHY IT CARRIES
- * ITS OWN TYPE. Every fault that other refusal names is a record somebody wrote badly, sitting in
- * the file its reader is being sent to open. A run that is not a raise arrives over a record that
- * reads perfectly, so borrowing that type would send its reader hunting through a file with nothing
- * wrong in it — the exact harm `record.ts` refuses to do to the caller who mistyped a gate name.
- *
- * THE RATCHET ONLY EVER RAISES, AND AN EQUAL MEASUREMENT IS REFUSED TOO. Writing the same two
- * figures back changes nothing, and a no-op that reports success reads, in a shell history or a
- * run's own log, as a ratchet that happened; the refusal is what keeps "I banked it" meaning
- * something. It is the SCORE that is compared rather than the pair, because a run can move both of
- * its counts and hold its ratio exactly — over a record already stating that score, writing it
- * raises nothing.
- *
- * AND THE REFUSAL HAS NO OVERRIDE, DELIBERATELY. A fall that is honest — code deleted, a scope
- * narrowed — is a conscious bump: a human edits the two figures and puts the reason in the commit,
- * which is the route the refusal names and the same route the shrunk-population red already sends
- * its reader down. An escape hatch a tool offers is one nobody has to justify, and it would be
- * reached for on the first red night rather than the first honest one. So there is no input here
- * that writes a fall — not a flag, not a defaulted parameter, not a setting — and @SCN-RAT-012's
- * arm asserts that over this module's own bytes rather than trusting it.
- *
- * NOTHING HERE NAMES A PROJECT, A CHECK, A RUNNER, A WORKFLOW OR A REPOSITORY. The gate, the
- * record's own name and the tree it sits in all arrive from the caller.
- */
-import { type MutationMeasurement } from "./verdict.js";
-/**
- * Raised when a run is not a raise — the up-only refusal (@SCN-RAT-012, 3F-2802).
- *
- * A SECOND TYPE, AND DELIBERATELY NOT `MalformedRecordError`. Every fault that refusal names is a
- * record somebody wrote badly, sitting in the file its reader is being sent to open. This one is a
- * record that reads perfectly and an ASK that is not a raise, so borrowing the other type would
- * send a reader off to hunt for a fault in a file that has none.
- */
-export declare class FallRefusedError extends Error {
-    /** The name the record was filed under, as the caller handed it over. */
-    readonly recordFile: string;
-    /** The gate that was to have been raised, as the caller names it. */
-    readonly gate: string;
-    constructor(
-    /** The name the record was filed under, as the caller handed it over. */
-    recordFile: string, 
-    /** The gate that was to have been raised, as the caller names it. */
-    gate: string, banked: GateFigures, measurement: MutationMeasurement);
-}
-/** One gate's two figures, as the record currently writes them. */
-interface GateFigures {
-    readonly detected: number;
-    readonly total: number;
-}
-/**
- * Raise a gate's two recorded figures to a measurement, leaving every other byte alone.
- *
- * @param text the record file's own bytes, as authored
- * @param gate the gate to raise, as the caller names it
- * @param measurement the run whose counts are being banked
- * @param recordFile the name the record is filed under, so a refusal can say which file it read
- * @returns the same bytes with two numerals different
- * @throws MalformedRecordError when the record writes no block for the gate, or that block holds no
- *   line to rewrite — named by the line, never passed over and never sought outside the block.
- * @throws FallRefusedError when the measurement does not score above what the gate already banks.
- *   There is no input that writes it anyway.
- */
-export declare function raisedRecordText(text: string, gate: string, measurement: MutationMeasurement, recordFile: string): string;
-/**
- * Write a raised record back over the file it was read from, resolved against the caller's tree.
- *
- * THE ROOT ARRIVES, AND IS NEVER THIS MODULE'S OWN LOCATION. A recorder that joined the directory it
- * was installed into is correct only while it sits inside the tree it is writing to, and stops
- * being so the moment it is installed as a dependency of one.
- *
- * READ AND WRITTEN IN THE SAME ENCODING, so the round trip through the filesystem is a round trip
- * rather than a transcoding — the whole promise of this module being that what comes back out is
- * what went in.
- *
- * @param root the CONSUMER'S workspace
- * @param recordFile where the record sits, relative to that root
- * @param gate the gate to raise, as the caller names it
- * @param measurement the run whose counts are being banked
- * @returns the path that was written, so a caller can say where the record now stands
- */
-export declare function bankRaisedRecord(root: string, recordFile: string, gate: string, measurement: MutationMeasurement): string;
-export {};
-//# sourceMappingURL=ratchet.d.ts.map

package/dist/mutation-ratchet/ratchet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ratchet.d.ts","sourceRoot":"","sources":["../../src/mutation-ratchet/ratchet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAYH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM;;IAHrB,yEAAyE;IAChE,UAAU,EAAE,MAAM;IAC3B,qEAAqE;IAC5D,IAAI,EAAE,MAAM,EACrB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,mBAAmB;CAcnC;AA6GD,mEAAmE;AACnE,UAAU,WAAW;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAwBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,CAYR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,mBAAmB,GAC/B,MAAM,CAMR"}

package/dist/mutation-ratchet/ratchet.js

@@ -1,222 +0,0 @@
-/**
- * THE RECORDER — a measurement written into the record as a surgical text edit (@SCN-RAT-011,
- * 3F-2801), refused outright when it is not a raise (@SCN-RAT-012, 3F-2802), and kept inside the
- * block it names when a sibling gate banks the very same counts (@SCN-RAT-013, 3F-2803).
- *
- * A SURGICAL TEXT EDIT, NEVER A RE-DUMP, AND THAT IS THE WHOLE OF THIS MODULE'S DIFFICULTY.
- * Emitting the parsed document back out is the obvious way to write two figures into a record, and
- * it throws away every comment on the way through — comments are not part of the document a parser
- * hands back. A record file is MOSTLY comment: every allowance's justification lives there, and so
- * does the argument for the bar sitting where it sits. So a recorder that re-serialised would
- * delete the reasoning for the very bar it was raising, quietly, in the same commit that claims to
- * be strengthening it, and with the two figures perfectly correct.
- *
- * SO THE TEXT ARRIVES AS TEXT AND LEAVES AS TEXT. Nothing below reaches for a document model. The
- * record is split on its own line breaks, two lines are rewritten where they lie, and the pieces
- * are joined back up — which is why what comes back is the bytes it was handed with two numerals
- * different, down to the blank lines, the indent style, the quoting and the trailing newline.
- *
- * AND THE EDIT IS BOUNDED BY THE NAMED GATE'S OWN BLOCK. A record is a wall of near-identical
- * blocks holding identically-named lines, so a rewriter that took the first `detected` line it met
- * would raise whichever gate happens to be written first and report success on the one it was
- * asked about. The block runs from the gate's key line to the first line after it indented no
- * further than that key — the next gate, or the comment introducing it. The search for that key
- * starts at the gates section rather than the top of the file, because a record is a project's own
- * policy document and may hold anything else it likes above the bars.
- *
- * THE LINES ARE THEN FOUND BY POSITION INSIDE THAT BLOCK, NEVER BY THE FIGURES THEY CARRY, and the
- * difference is invisible over almost every record. A rewriter that struck the OLD numerals out
- * wherever they first appeared would be byte-preserving, would move exactly two lines, would keep
- * every comment, and would write precisely the right two lines over any record whose gates hold
- * distinct figures. It writes the WRONG gate only when two gates bank the same counts — and then
- * silently, leaving the two gates stating figures neither of the trees they describe ever measured.
- * @SCN-RAT-013's record plants that collision on purpose, and authors it with the named gate above
- * its twin and below it, because either rewriter is right by luck when the gate it wants is first.
- *
- * A LINE THE BLOCK DOES NOT HOLD IS AN ERROR NAMING THE LINE, NEVER A NO-OP. Both of the other
- * answers are worse than a refusal: skipping quietly banks half a measurement and reports a raise
- * that did not happen, and searching on past the block's end rewrites some other gate's figure with
- * this gate's count.
- *
- * EVERY FAULT IN THE RECORD IS `record.ts`'s ONE REFUSAL TYPE, and its section name and gate
- * placeholder are imported rather than respelled. A caller is told to catch `MalformedRecordError`
- * for a record it cannot read, so a record fault raised here under a second type is one that caller
- * sails past — and a second copy of the section's name is the agreeing-until-somebody-edits-one
- * shape this library exists to remove.
- *
- * AND THE UP-ONLY REFUSAL IS THE ONE THING HERE THAT IS NOT A RECORD FAULT, WHICH IS WHY IT CARRIES
- * ITS OWN TYPE. Every fault that other refusal names is a record somebody wrote badly, sitting in
- * the file its reader is being sent to open. A run that is not a raise arrives over a record that
- * reads perfectly, so borrowing that type would send its reader hunting through a file with nothing
- * wrong in it — the exact harm `record.ts` refuses to do to the caller who mistyped a gate name.
- *
- * THE RATCHET ONLY EVER RAISES, AND AN EQUAL MEASUREMENT IS REFUSED TOO. Writing the same two
- * figures back changes nothing, and a no-op that reports success reads, in a shell history or a
- * run's own log, as a ratchet that happened; the refusal is what keeps "I banked it" meaning
- * something. It is the SCORE that is compared rather than the pair, because a run can move both of
- * its counts and hold its ratio exactly — over a record already stating that score, writing it
- * raises nothing.
- *
- * AND THE REFUSAL HAS NO OVERRIDE, DELIBERATELY. A fall that is honest — code deleted, a scope
- * narrowed — is a conscious bump: a human edits the two figures and puts the reason in the commit,
- * which is the route the refusal names and the same route the shrunk-population red already sends
- * its reader down. An escape hatch a tool offers is one nobody has to justify, and it would be
- * reached for on the first red night rather than the first honest one. So there is no input here
- * that writes a fall — not a flag, not a defaulted parameter, not a setting — and @SCN-RAT-012's
- * arm asserts that over this module's own bytes rather than trusting it.
- *
- * NOTHING HERE NAMES A PROJECT, A CHECK, A RUNNER, A WORKFLOW OR A REPOSITORY. The gate, the
- * record's own name and the tree it sits in all arrive from the caller.
- */
-import { readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { counts, MalformedRecordError, MUTATION_GATES, scoreRoseOver, WHOLE_GATE, } from "./record.js";
-/**
- * Raised when a run is not a raise — the up-only refusal (@SCN-RAT-012, 3F-2802).
- *
- * A SECOND TYPE, AND DELIBERATELY NOT `MalformedRecordError`. Every fault that refusal names is a
- * record somebody wrote badly, sitting in the file its reader is being sent to open. This one is a
- * record that reads perfectly and an ASK that is not a raise, so borrowing the other type would
- * send a reader off to hunt for a fault in a file that has none.
- */
-export class FallRefusedError extends Error {
-    recordFile;
-    gate;
-    constructor(
-    /** The name the record was filed under, as the caller handed it over. */
-    recordFile, 
-    /** The gate that was to have been raised, as the caller names it. */
-    gate, banked, measurement) {
-        super(`${gate}: NOT A RAISE — measured ${counts(measurement.detected, measurement.total)} against ` +
-            `a recorded ${counts(banked.detected, banked.total)}. The ratchet only ever raises, and ` +
-            "this run does not: a measurement below the record would give the bar away, and one " +
-            "scoring exactly what the record already states would write it back unchanged — a no-op " +
-            "that reads, in a shell history or a run's own log, as a ratchet that happened. Nothing " +
-            "here lowers a record for you. If the fall is honest — code deleted, a scope narrowed — " +
-            `edit ${recordFile} by hand and put the reason in the commit, because an escape hatch a ` +
-            "tool holds open is one nobody ever has to justify.");
-        this.recordFile = recordFile;
-        this.gate = gate;
-        this.name = "FallRefusedError";
-    }
-}
-/** How far a line is indented, in characters. */
-function indentOf(line) {
-    return line.length - line.trimStart().length;
-}
-/**
- * The line one field is written on: its key at any indent, its whole-number value, and whatever
- * spacing the author put around both.
- *
- * THE SPACING IS CAPTURED SO IT CAN BE PUT BACK. `detected:   202` and `detected: 202` are the same
- * record and different bytes, and a rewriter that normalised one into the other would be re-dumping
- * one line at a time.
- */
-function fieldLine(field) {
-    return new RegExp(`^(\\s*${field}\\s*:\\s*)(\\d+)(\\s*)$`);
-}
-/** Where the gates section's own key line sits, refused when the record is not written as one. */
-function gatesSectionAt(lines, gate, recordFile) {
-    const at = lines.findIndex((line) => line.trim() === `${MUTATION_GATES}:`);
-    if (at === -1) {
-        throw new MalformedRecordError(recordFile, MUTATION_GATES, gate, MUTATION_GATES, "the section is not written as a block of gates, so it holds no block to rewrite.");
-    }
-    return at;
-}
-/**
- * The lines holding one gate's block, refused when the record writes no block for that gate.
- *
- * ENDING AT THE FIRST LINE INDENTED NO FURTHER THAN THE KEY — the next gate, or the comment
- * introducing it. That boundary is what keeps a rewrite inside the gate it was asked about when the
- * line it is looking for is not there to be found.
- */
-function gateBlockOf(lines, gate, recordFile) {
-    const section = gatesSectionAt(lines, gate, recordFile);
-    const sectionIndent = indentOf(lines[section] ?? "");
-    const key = lines.findIndex((line, at) => at > section && line.trim() === `${gate}:` && indentOf(line) > sectionIndent);
-    if (key === -1) {
-        throw new MalformedRecordError(recordFile, MUTATION_GATES, gate, WHOLE_GATE, "the record writes no block for this gate, so there is nothing to raise.");
-    }
-    const indent = indentOf(lines[key] ?? "");
-    const ends = lines.findIndex((line, at) => at > key && line.trim() !== "" && indentOf(line) <= indent);
-    return { from: key + 1, to: ends === -1 ? lines.length : ends };
-}
-/**
- * One field's line inside a block, refused by the field's name when the block holds no such line.
- *
- * BOTH FIGURES ARE FOUND BEFORE EITHER IS COMPARED OR WRITTEN, which is what keeps this refusal
- * ahead of the up-only one: a block missing a line is a record fault, and a reader sent to argue
- * about scores over a half-written block has been sent to the wrong question.
- */
-function figureIn(lines, block, field, gate, recordFile) {
-    const pattern = fieldLine(field);
-    for (let at = block.from; at < block.to; at += 1) {
-        const written = pattern.exec(lines[at] ?? "");
-        if (written !== null)
-            return { at, value: Number(written[2]) };
-    }
-    throw new MalformedRecordError(recordFile, MUTATION_GATES, gate, field, "the gate's block holds no such line, so there is nothing to rewrite it into.");
-}
-/**
- * Refuse a measurement that is not a raise, naming both scores and the one route down.
- *
- * ASKED OF THE SCORE, NEVER OF THE PAIR. A run that moved both of its counts and held its ratio
- * exactly is a run that raises nothing, and a recorder written as "the very same two figures" writes
- * it — a record rewritten to say what it already said.
- */
-function refuseUnlessRaised(gate, banked, measurement, recordFile) {
-    if (scoreRoseOver(measurement.detected, measurement.total, banked.detected, banked.total))
-        return;
-    throw new FallRefusedError(recordFile, gate, banked, measurement);
-}
-/** One located line with its figure rewritten, and every byte of its spacing kept. */
-function rewritten(line, field, value) {
-    return line.replace(fieldLine(field), `$1${value}$3`);
-}
-/**
- * Raise a gate's two recorded figures to a measurement, leaving every other byte alone.
- *
- * @param text the record file's own bytes, as authored
- * @param gate the gate to raise, as the caller names it
- * @param measurement the run whose counts are being banked
- * @param recordFile the name the record is filed under, so a refusal can say which file it read
- * @returns the same bytes with two numerals different
- * @throws MalformedRecordError when the record writes no block for the gate, or that block holds no
- *   line to rewrite — named by the line, never passed over and never sought outside the block.
- * @throws FallRefusedError when the measurement does not score above what the gate already banks.
- *   There is no input that writes it anyway.
- */
-export function raisedRecordText(text, gate, measurement, recordFile) {
-    const lines = text.split("\n");
-    const block = gateBlockOf(lines, gate, recordFile);
-    const detected = figureIn(lines, block, "detected", gate, recordFile);
-    const total = figureIn(lines, block, "total", gate, recordFile);
-    refuseUnlessRaised(gate, { detected: detected.value, total: total.value }, measurement, recordFile);
-    lines[detected.at] = rewritten(lines[detected.at] ?? "", "detected", measurement.detected);
-    lines[total.at] = rewritten(lines[total.at] ?? "", "total", measurement.total);
-    return lines.join("\n");
-}
-/**
- * Write a raised record back over the file it was read from, resolved against the caller's tree.
- *
- * THE ROOT ARRIVES, AND IS NEVER THIS MODULE'S OWN LOCATION. A recorder that joined the directory it
- * was installed into is correct only while it sits inside the tree it is writing to, and stops
- * being so the moment it is installed as a dependency of one.
- *
- * READ AND WRITTEN IN THE SAME ENCODING, so the round trip through the filesystem is a round trip
- * rather than a transcoding — the whole promise of this module being that what comes back out is
- * what went in.
- *
- * @param root the CONSUMER'S workspace
- * @param recordFile where the record sits, relative to that root
- * @param gate the gate to raise, as the caller names it
- * @param measurement the run whose counts are being banked
- * @returns the path that was written, so a caller can say where the record now stands
- */
-export function bankRaisedRecord(root, recordFile, gate, measurement) {
-    const at = join(root, recordFile);
-    const raised = raisedRecordText(readFileSync(at, "utf8"), gate, measurement, recordFile);
-    writeFileSync(at, raised, "utf8");
-    return at;
-}
-//# sourceMappingURL=ratchet.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ratchet.js","sourceRoot":"","sources":["../../src/mutation-ratchet/ratchet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAG9B;IAEA;IAJX;IACE,yEAAyE;IAChE,UAAkB;IAC3B,qEAAqE;IAC5D,IAAY,EACrB,MAAmB,EACnB,WAAgC;QAEhC,KAAK,CACH,GAAG,IAAI,4BAA4B,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW;YAC3F,cAAc,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,sCAAsC;YACzF,qFAAqF;YACrF,yFAAyF;YACzF,yFAAyF;YACzF,yFAAyF;YACzF,QAAQ,UAAU,uEAAuE;YACzF,oDAAoD,CACvD,CAAC;QAfO,eAAU,GAAV,UAAU,CAAQ;QAElB,SAAI,GAAJ,IAAI,CAAQ;QAcrB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAQD,iDAAiD;AACjD,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,IAAI,MAAM,CAAC,SAAS,KAAK,yBAAyB,CAAC,CAAC;AAC7D,CAAC;AAED,kGAAkG;AAClG,SAAS,cAAc,CAAC,KAAwB,EAAE,IAAY,EAAE,UAAkB;IAChF,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,CAAC,CAAC;IAC3E,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,oBAAoB,CAC5B,UAAU,EACV,cAAc,EACd,IAAI,EACJ,cAAc,EACd,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAwB,EAAE,IAAY,EAAE,UAAkB;IAC7E,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CACzB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAC3F,CAAC;IACF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,oBAAoB,CAC5B,UAAU,EACV,cAAc,EACd,IAAI,EACJ,UAAU,EACV,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAC1B,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CACzE,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAcD;;;;;;GAMG;AACH,SAAS,QAAQ,CACf,KAAwB,EACxB,KAAgB,EAChB,KAAa,EACb,IAAY,EACZ,UAAkB;IAElB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B,UAAU,EACV,cAAc,EACd,IAAI,EACJ,KAAK,EACL,8EAA8E,CAC/E,CAAC;AACJ,CAAC;AAQD;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,IAAY,EACZ,MAAmB,EACnB,WAAgC,EAChC,UAAkB;IAElB,IAAI,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO;IAClG,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACpE,CAAC;AAED,sFAAsF;AACtF,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa;IAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAY,EACZ,WAAgC,EAChC,UAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAEhE,kBAAkB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAEpG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3F,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IAE/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,UAAkB,EAClB,IAAY,EACZ,WAAgC;IAEhC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAEzF,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/mutation-ratchet/ratchetCli.d.ts

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-/**
- * THE COMMAND — one gate's run reconciled against its record, and the run that asked ending on the
- * answer (@SCN-RAT-015, 3F-2805).
- *
- *     --gate <name> --report <path> [--root <dir>] [--record-file <path>]
- *                   [--bank-command <text>] [--record]
- *
- * WHY THERE IS A COMMAND AT ALL. Every module beneath this one settles what the verdict IS, and a
- * verdict handed back as a value is a verdict nobody's pipeline can read. A pipeline observes one
- * thing about a step — how it ended — so the last piece of this library is the piece that ends.
- *
- * THREE ENDINGS, AND THE THIRD IS THE ONE WORTH BUILDING FOR. A gate that stands ends cleanly and a
- * gate that does not ends in failure; between them they are what a pipeline is watching for, and
- * telling them apart is arithmetic that is already done by the time this file runs. The third is a
- * run that was CALLED wrong, and it must wear neither of the other two. A name left off, reported as
- * a gate that does not stand, sends somebody hunting through their code for a regression that never
- * happened; reported as a gate that stands, it is a bar that quietly stopped being read at all. So
- * it takes the ending this repository already reserves for "this run is broken" as against "the code
- * is wrong", which every other step here that can be misused already uses.
- *
- * A FLAG NEVER SWALLOWS THE NEXT FLAG AS ITS VALUE. `--report --record` read leniently is a report
- * sought at a path called `--record`, found missing, and answered with a sweep that never ran — a
- * reading that sends its reader to look at their runner when what happened was a typo one character
- * long. Anything beginning with two dashes is a flag, never a value.
- *
- * THE REPORT'S PATH IS REQUIRED AND THE RECORD'S NAME IS NOT, and the asymmetry is a ruling rather
- * than an oversight, carried up from the composition beneath. Where a sweep drops its output is a
- * RUNNER'S convention, so a default there would be this file naming a runner. The record's name
- * belongs to whoever owns the record, so the conventional one stands in and a caller who files their
- * bars elsewhere writes it over.
- *
- * AND THE TREE DEFAULTS TO A RELATIVE ONE RATHER THAN TO ANYWHERE THIS FILE CAN FIND. `.` is the
- * caller's own working directory, resolved by the platform at the moment of the read; a root taken
- * from where this file is INSTALLED agrees with its caller for exactly as long as it sits beside
- * that caller's code, and stops the day it ships as a dependency — resolving quietly into a package
- * folder, reading nothing, and reporting a gate that measured perfectly as a gate that never ran.
- *
- * A REFUSAL TO BANK IS AN EXPECTED ENDING RATHER THAN A CRASH. Asking whether there is anything to
- * bank is what an operator types, and most of the time the answer is no. Handed out as an unhandled
- * fall it arrives as a stack trace — a reading that says the tool broke where what happened was the
- * tool working, and one that buries the refusal's own sentence, which is the only part of it anybody
- * needed. So the refusal is caught by its own type, its reason is what the reader gets, and the run
- * ends in failure because there was nothing to bank.
- *
- * AND THERE IS NO WAY PAST THAT REFUSAL HERE EITHER. The recorder beneath takes four inputs and
- * offers no fifth; this file adds no flag that would ask it to write a fall, and @SCN-RAT-012 reads
- * these bytes to say so rather than trusting them. A record that must come down comes down by hand,
- * with the reason in the commit, because an escape hatch a tool holds open is one nobody ever has to
- * justify.
- *
- * NOTHING HERE NAMES A PROJECT, A CHECK, A RUNNER, A WORKFLOW OR A REPOSITORY — the usage line
- * included, which is where such a name most easily hides, being read by people rather than by tests.
- * @SCN-RAT-014 reads these bytes for that too.
- */
-export {};
-//# sourceMappingURL=ratchetCli.d.ts.map

package/dist/mutation-ratchet/ratchetCli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ratchetCli.d.ts","sourceRoot":"","sources":["../../src/mutation-ratchet/ratchetCli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG"}