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

package/dist/ingest/ingestScenarios.js.map

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

package/dist/run-management/resolveRunInputs.d.ts

@@ -6,7 +6,7 @@
  * 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).
  */
 /**
  * Resolve the target's source SHA (project design §4). An explicit non-empty
@@ -32,17 +32,30 @@ export interface ToolIdentity {
  * 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 declare function resolveToolIdentity(opts?: {
     toolDir?: string;

package/dist/run-management/resolveRunInputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveRunInputs.d.ts","sourceRoot":"","sources":["../../src/run-management/resolveRunInputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAiBhG;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,mGAAmG;IACnG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAQ3G;AA2CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAerE"}
+{"version":3,"file":"resolveRunInputs.d.ts","sourceRoot":"","sources":["../../src/run-management/resolveRunInputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAiBhG;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,mGAAmG;IACnG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAQ3G;AAiED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAerE"}

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-controller",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.11",
   "description": "Reconcile the behaviour your scenarios name against the evidence that actually ran — the deterministic `balance` CLI.",
   "keywords": [
     "reconciliation",
@@ -25,7 +25,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.11"
   },
   "publishConfig": {
     "access": "public"

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

@@ -1,48 +0,0 @@
-/**
- * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
- * (@SCN-RAT-014, 3F-2804).
- *
- * A BARREL THAT RE-EXPORTED EVERY MODULE WOULD BE A CONTRACT NOBODY WROTE. Each module below
- * exports what its own siblings need from it, and sibling-visibility is a much wider set than
- * consumer-visibility: the gate-block span finder, the field rewriter, the per-verdict message
- * builders, the status sets and the loader's per-field readers are all exported so their
- * neighbours can reach them without a second copy. Passing that set on wholesale would freeze
- * every one of them as something a consumer may depend on, and the first refactor that moved one
- * would be a breaking change nobody meant to make. So this file names what a caller may hold and
- * the omissions are decisions.
- *
- * WHAT IS HERE IS THIS LIBRARY'S OWN ENTRY, AND WHAT ITS FIRST CONSUMER NEEDS. The entry is
- * `reconcileGate` — hand it the five terms a project owns and it answers with a verdict. Around it
- * sit the pieces a consumer that wants to compose its own way needs: the verdict over counts
- * already in hand, the two readers that turn a report into counts, the recorder, the loader, the
- * three score functions a consumer rendering its own view needs, the kill floor those same figures
- * imply in mutants, the default record name, and both error types the functions above raise — the
- * record fault and the up-only refusal — because a refusal a caller cannot name in a `catch` is a
- * refusal that caller cannot handle.
- *
- * THE KILL FLOOR CROSSES FOR A SECOND KIND OF CONSUMER, AND THAT IS WHY IT IS NOT A SCORE (3F-2788).
- * Everything above answers a reader that wants this library's verdict. `killFloorOf` answers one
- * that wants only the BAR — a ledger holding its own measured row to the same figure this library
- * reconciles against, so the two cannot disagree by construction. A consumer that derived it
- * instead would be the second place knowing how an allowance is spent.
- *
- * THE TYPES ARE SPELLED FOR A CONSUMER'S NAMESPACE RATHER THAN FOR THIS MODULE'S. `GateRecord` and
- * `GateAllowance` are unambiguous inside a directory about nothing else; imported into a repository
- * that has gates of several kinds they are not, so they cross this line under the fuller names.
- * The aliasing is deliberate and one-directional: the internal spellings stay internal.
- *
- * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION NOW RATHER THAN AN OPEN QUESTION. The
- * sibling core package's barrel is reflected and compared against a frozen list in both directions,
- * so a symbol quietly added or dropped reds. That guard is what a PUBLISHED surface is owed, and
- * 3F-2859 stopped publishing this one: no manifest key resolves here, and no caller outside this
- * repository can spell the specifier at all. Freezing the list would make every refactor behind
- * this barrel a change to a contract nobody holds. What the curation above is still for is the
- * reader of this repository's own gate, and @SCN-RAT-014 reads the list back beside it — so a
- * symbol added here is a symbol somebody wrote down twice, which is the guard this surface earns.
- */
-export { RECORD_FILE, reconcileGate, type RatchetRequest } from "./reconcile.js";
-export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, recordedScoreOf, scoreOf, type GateAllowance as MutationGateAllowance, type GateRecord as MutationGateRecord, } from "./record.js";
-export { FallRefusedError, raisedRecordText } from "./ratchet.js";
-export { measurementFromReport, readMutationReport, type MutationReportRead, } from "./report.js";
-export { verdictFor, type MutationMeasurement, type MutationVerdict, type MutationVerdictKind, } from "./verdict.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutation-ratchet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,KAAK,aAAa,IAAI,qBAAqB,EAC3C,KAAK,UAAU,IAAI,kBAAkB,GACtC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC"}

package/dist/mutation-ratchet/index.js

@@ -1,48 +0,0 @@
-/**
- * THE MODULE'S OWN SURFACE — curated symbol by symbol, never a re-export of the tree behind it
- * (@SCN-RAT-014, 3F-2804).
- *
- * A BARREL THAT RE-EXPORTED EVERY MODULE WOULD BE A CONTRACT NOBODY WROTE. Each module below
- * exports what its own siblings need from it, and sibling-visibility is a much wider set than
- * consumer-visibility: the gate-block span finder, the field rewriter, the per-verdict message
- * builders, the status sets and the loader's per-field readers are all exported so their
- * neighbours can reach them without a second copy. Passing that set on wholesale would freeze
- * every one of them as something a consumer may depend on, and the first refactor that moved one
- * would be a breaking change nobody meant to make. So this file names what a caller may hold and
- * the omissions are decisions.
- *
- * WHAT IS HERE IS THIS LIBRARY'S OWN ENTRY, AND WHAT ITS FIRST CONSUMER NEEDS. The entry is
- * `reconcileGate` — hand it the five terms a project owns and it answers with a verdict. Around it
- * sit the pieces a consumer that wants to compose its own way needs: the verdict over counts
- * already in hand, the two readers that turn a report into counts, the recorder, the loader, the
- * three score functions a consumer rendering its own view needs, the kill floor those same figures
- * imply in mutants, the default record name, and both error types the functions above raise — the
- * record fault and the up-only refusal — because a refusal a caller cannot name in a `catch` is a
- * refusal that caller cannot handle.
- *
- * THE KILL FLOOR CROSSES FOR A SECOND KIND OF CONSUMER, AND THAT IS WHY IT IS NOT A SCORE (3F-2788).
- * Everything above answers a reader that wants this library's verdict. `killFloorOf` answers one
- * that wants only the BAR — a ledger holding its own measured row to the same figure this library
- * reconciles against, so the two cannot disagree by construction. A consumer that derived it
- * instead would be the second place knowing how an allowance is spent.
- *
- * THE TYPES ARE SPELLED FOR A CONSUMER'S NAMESPACE RATHER THAN FOR THIS MODULE'S. `GateRecord` and
- * `GateAllowance` are unambiguous inside a directory about nothing else; imported into a repository
- * that has gates of several kinds they are not, so they cross this line under the fuller names.
- * The aliasing is deliberate and one-directional: the internal spellings stay internal.
- *
- * AND NO DRIFT GUARD STANDS OVER IT, WHICH IS A DECISION NOW RATHER THAN AN OPEN QUESTION. The
- * sibling core package's barrel is reflected and compared against a frozen list in both directions,
- * so a symbol quietly added or dropped reds. That guard is what a PUBLISHED surface is owed, and
- * 3F-2859 stopped publishing this one: no manifest key resolves here, and no caller outside this
- * repository can spell the specifier at all. Freezing the list would make every refactor behind
- * this barrel a change to a contract nobody holds. What the curation above is still for is the
- * reader of this repository's own gate, and @SCN-RAT-014 reads the list back beside it — so a
- * symbol added here is a symbol somebody wrote down twice, which is the guard this surface earns.
- */
-export { RECORD_FILE, reconcileGate } from "./reconcile.js";
-export { floorOf, gateRecordFor, killFloorOf, MalformedRecordError, parseGateRecords, recordedScoreOf, scoreOf, } from "./record.js";
-export { FallRefusedError, raisedRecordText } from "./ratchet.js";
-export { measurementFromReport, readMutationReport, } from "./report.js";
-export { verdictFor, } from "./verdict.js";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mutation-ratchet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,OAAO,GAGR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GAIX,MAAM,cAAc,CAAC"}

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"}