@gate-forge/core 0.7.1 → 0.9.0

package/dist/schemas/verdict.js

@@ -33,10 +33,10 @@ export const UnresolvedReasonSchema = z
 /**
  * Stable cause codes for the shared report model (plan §5.4, ADR 0005).
  * Blocking-obligation causes name WHY an obligation is not satisfied and
- * select its next action; the three `DIAGNOSTIC_*` codes are advisory
- * result causes for the separate diagnostic run (plan §3.5) — never
- * obligation verdicts. The seven verdict VALUES are unchanged; causes
- * enrich them without weakening any contract.
+ * select its next action. `DIAGNOSTIC_*` codes advise on the separate
+ * diagnostic run; `TEST_MAP_OUT_OF_SYNC` advises on generated mappings.
+ * These report advisories are never obligation verdicts. The seven verdict
+ * VALUES are unchanged; causes enrich reports without weakening contracts.
  */
 export const CauseCodeSchema = z.enum([
     'TEST_INVENTORY_INCOMPLETE',
@@ -44,6 +44,7 @@ export const CauseCodeSchema = z.enum([
     'TEST_MAPPING_MISSING',
     'TEST_MAPPING_AMBIGUOUS',
     'TEST_MAPPING_STALE',
+    'TEST_MAP_OUT_OF_SYNC',
     'EVIDENCE_NOT_COLLECTED',
     'VERIFIER_UNSUPPORTED',
     'TEST_NOT_EXECUTED',
@@ -70,6 +71,20 @@ export const CauseCodeSchema = z.enum([
     'ENFORCEMENT_BOUNDARY_UNVERIFIED',
     'RUNTIME_PREPARATION_FAILED',
     'RUNTIME_READINESS_FAILED',
+    'QUARANTINE_EXPIRED',
+    'MIGRATION_MISSING',
+    'MIGRATION_LINEAGE_BROKEN',
+    'MIGRATION_DOWNGRADE_NOOP',
+    'MIGRATION_DRIFT',
+    'MIGRATION_ROUNDTRIP_FAILED',
+    'MIGRATION_DATA_LOST',
+    'MIGRATION_CONFLICT',
+    'MIGRATION_SCRATCH_UNSAFE',
+    'ADAPTER_CANNOT_WITNESS',
+    'ADAPTER_VOLATILE_FIELD_SKIPPED',
+    'RESOURCE_SINGLETON_PER_TENANT',
+    'RESPONSE_FIELD_MISSING_FROM_MODEL',
+    'TWIN_PATH_DIVERGENT',
 ]);
 /**
  * The plan §5.4 next action per cause code. Text, JSON, and SARIF
@@ -83,6 +98,7 @@ export const CAUSE_NEXT_ACTIONS = Object.freeze({
         '— that cannot satisfy the obligation.',
     TEST_MAPPING_AMBIGUOUS: 'Correct the exact mapping',
     TEST_MAPPING_STALE: 'Correct the exact mapping',
+    TEST_MAP_OUT_OF_SYNC: 'gateforge tests sync',
     EVIDENCE_NOT_COLLECTED: 'Write an overlay test in `tests/e2e/gateforge/` using the Gateforge Playwright fixture ' +
         '(`evidence.ui.*` + `persistence.verify`). Do not rewrite existing journeys. Mappings ' +
         '(`tests mark`) are intent, not proof.',
@@ -91,7 +107,10 @@ export const CAUSE_NEXT_ACTIONS = Object.freeze({
     TEST_FAILED: 'Run or repair the selected suite',
     RUN_INCOMPLETE: 'Run or repair the selected suite',
     EVIDENCE_STALE: 'Rerun for the exact candidate',
-    CHANGE_UNMAPPED: 'Map detection or add an overlay test for the changed resource. Do not weaken policy.',
+    CHANGE_UNMAPPED: 'Attribute the change with `gateforge explain <file>` (it prints what the file is and what ' +
+        'governs it): map the detected resource, declare documentation folders with ' +
+        '`gateforge init --docs-exclude <folders>`, or add the detection that owns the file. ' +
+        'Do not weaken policy.',
     EVIDENCE_SCOPE_INCOMPLETE: 'Map a test to the uncovered obligation (`gateforge tests mark`) or run full scope ' +
         '(`test-gates --changed` without `--scope changed`)',
     ENFORCEMENT_UNTRUSTED: 'Repair enforcement setup',
@@ -113,7 +132,25 @@ export const CAUSE_NEXT_ACTIONS = Object.freeze({
     ENFORCEMENT_BOUNDARY_UNVERIFIED: 'Owner provisions/verifies runtime',
     RUNTIME_PREPARATION_FAILED: 'Repair the tracked `runtime.prepare` command (its failure log is under run state `runtime/`) — ' +
         'the candidate runtime must build or install before the gate can execute',
+    QUARANTINE_EXPIRED: 'Owner: renew or delete the expired quarantine (`gateforge quarantine <testKey> --owner --approver --reason --expires`); an expired quarantine blocks',
     RUNTIME_READINESS_FAILED: 'Repair the tracked `runtime.services` command or readiness probe — the candidate ' +
         'runtime must become ready before evidence is trusted',
+    MIGRATION_MISSING: 'Write an Alembic revision for the changed model, then run `gateforge check`',
+    MIGRATION_LINEAGE_BROKEN: 'Repair the migration chain so it has one head, unique revision ids, and existing parents, then run `gateforge check`',
+    MIGRATION_DOWNGRADE_NOOP: 'Implement downgrade() so the chain round-trips, or pin the revision in `alembic.irreversible`, then run `gateforge check`',
+    MIGRATION_DRIFT: 'Make `alembic check` clean against the models, then run `gateforge check`',
+    MIGRATION_ROUNDTRIP_FAILED: 'Fix the migration so upgrade, downgrade base, and upgrade head succeed on a disposable database, then run `gateforge check`',
+    MIGRATION_DATA_LOST: 'Preserve declared table rows across the upgrade, then run `gateforge check`',
+    MIGRATION_CONFLICT: 'Rebase onto the target head and merge the named revisions, then run `gateforge check`',
+    MIGRATION_SCRATCH_UNSAFE: 'Set `alembic.scratch.adminUrl` to a trusted disposable Postgres admin URL. The engine only creates and drops `gf_tmp_` databases',
+    ADAPTER_CANNOT_WITNESS: 'Give the adapter a complete paged collection read (or a natural key) so a create can be proven; until then the engine cannot witness that obligation',
+    ADAPTER_VOLATILE_FIELD_SKIPPED: 'Review the adapter: it declares this field server-computed, so the entered value was not echo-checked. Drop the declaration if the app should store what was entered',
+    RESOURCE_SINGLETON_PER_TENANT: 'Witness this create on a fresh tenant: the unique constraint admits one row per tenant, so ' +
+        "register the new tenant's login with the witness for THIS session only " +
+        '(POST /sessions/identity) and prove the create there',
+    RESPONSE_FIELD_MISSING_FROM_MODEL: 'The frontend reads a field the response model does not declare: restore the field on the ' +
+        'response model (or read the one it declares). A test that mocks the response proves nothing ' +
+        'about this read',
+    TWIN_PATH_DIVERGENT: 'Make the raw test and its witnessed twin send the same request: align the shared helper defaults, or map the pair with `twinOf`',
 });
 //# sourceMappingURL=verdict.js.map

package/dist/schemas/verdict.js.map

@@ -1 +1 @@
-{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/schemas/verdict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAClC,WAAW;IACX,SAAS;IACT,SAAS;IACT,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,OAAO;CACR,CAAC,CAAC;AAKH,iEAAiE;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,kEAAkE;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,uDAAuD;IACvD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,EAAE,cAAc;CACzB,CAAC;KACD,MAAM,EAAE,CAAC;AAKZ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,2BAA2B;IAC3B,mBAAmB;IACnB,sBAAsB;IACtB,wBAAwB;IACxB,oBAAoB;IACpB,wBAAwB;IACxB,sBAAsB;IACtB,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,2BAA2B;IAC3B,uBAAuB;IACvB,yBAAyB;IACzB,0BAA0B;IAC1B,uBAAuB;IACvB,yBAAyB;IACzB,2BAA2B;IAC3B,yBAAyB;IACzB,2BAA2B;IAC3B,0BAA0B;IAC1B,wBAAwB;IACxB,uBAAuB;IACvB,2BAA2B;IAC3B,0BAA0B;IAC1B,8BAA8B;IAC9B,4BAA4B;IAC5B,iCAAiC;IACjC,4BAA4B;IAC5B,0BAA0B;CAC3B,CAAC,CAAC;AAKH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACnF,yBAAyB,EAAE,kDAAkD;IAC7E,iBAAiB,EAAE,8BAA8B;IACjD,oBAAoB,EAClB,6FAA6F;QAC7F,uCAAuC;IACzC,sBAAsB,EAAE,2BAA2B;IACnD,kBAAkB,EAAE,2BAA2B;IAC/C,sBAAsB,EACpB,yFAAyF;QACzF,uFAAuF;QACvF,uCAAuC;IACzC,oBAAoB,EAClB,yFAAyF;IAC3F,iBAAiB,EAAE,kCAAkC;IACrD,WAAW,EAAE,kCAAkC;IAC/C,cAAc,EAAE,kCAAkC;IAClD,cAAc,EAAE,+BAA+B;IAC/C,eAAe,EACb,sFAAsF;IACxF,yBAAyB,EACvB,oFAAoF;QACpF,oDAAoD;IACtD,qBAAqB,EAAE,0BAA0B;IACjD,uBAAuB,EAAE,8CAA8C;IACvE,wBAAwB,EACtB,0GAA0G;IAC5G,qBAAqB,EACnB,kFAAkF;QAClF,wCAAwC;IAC1C,uBAAuB,EAAE,kEAAkE;IAC3F,yBAAyB,EACvB,wEAAwE;IAC1E,uBAAuB,EAAE,oDAAoD;IAC7E,yBAAyB,EAAE,0DAA0D;IACrF,wBAAwB,EAAE,sCAAsC;IAChE,sBAAsB,EAAE,sDAAsD;IAC9E,qBAAqB,EAAE,+CAA+C;IACtE,yBAAyB,EAAE,6DAA6D;IACxF,wBAAwB,EAAE,mDAAmD;IAC7E,4BAA4B,EAAE,qDAAqD;IACnF,0BAA0B,EAAE,6BAA6B;IACzD,+BAA+B,EAAE,mCAAmC;IACpE,0BAA0B,EACxB,iGAAiG;QACjG,yEAAyE;IAC3E,wBAAwB,EACtB,mFAAmF;QACnF,sDAAsD;CACzD,CAAC,CAAC"}
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/schemas/verdict.ts"],"names":[],"mappings":"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"}

package/dist/strictness.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Owner-chosen gate strictness and the
+ * flaky-test quarantine model (Phase 2).
+ *
+ * `mode` is an OPTIONAL owner-owned config key. Its default is
+ * `strict`, which is exactly the behavior a repository without the key
+ * has today — the frozen contract. The owner may soften the GATE, never
+ * the evidence: `warn` still evaluates, counts and reports everything
+ * and only the exit code changes; `changed` blocks on debt this change
+ * touches while the full debt stays in the report.
+ *
+ * Pure and deterministic: every function here is total, side-effect
+ * free and free of wall-clock reads, so the decision is unit-testable
+ * and identical on every surface that asks for it.
+ */
+import { z } from 'zod';
+/**
+ * The three owner-selectable gate strictness levels.
+ *
+ * - `strict` — today's gate (also the default when the key is absent).
+ * - `changed` — block only for debt the evaluated change touches; the
+ *   full debt is still reported.
+ * - `warn` — evaluate fully, report everything, exit 0.
+ */
+export declare const StrictnessModeSchema: z.ZodEnum<{
+    strict: "strict";
+    changed: "changed";
+    warn: "warn";
+}>;
+/** Inferred strictness-mode union. */
+export type StrictnessMode = z.infer<typeof StrictnessModeSchema>;
+/** The mode a repository without a `mode` key runs in (today's behavior). */
+export declare const DEFAULT_STRICTNESS_MODE: StrictnessMode;
+/**
+ * Resolves the effective strictness mode of a config document.
+ *
+ * Args:
+ *   config: the loaded config (the `mode` key is optional).
+ *
+ * Returns:
+ *   StrictnessMode: the declared mode, or `strict` when absent.
+ */
+export declare function resolveStrictnessMode(config: {
+    mode?: StrictnessMode | undefined;
+}): StrictnessMode;
+/**
+ * The debt a changed-scope decision can see: whether a diff was actually
+ * resolved, and how many blocking items it touches.
+ */
+export interface ChangedBlockingScope {
+    /** True when a diff provider produced the changed-file set. */
+    active: boolean;
+    /** Blocking verdicts + blocking entries attributable to the diff. */
+    blockingInScope: number;
+}
+/** One gate decision under the owner's chosen strictness. */
+export interface StrictnessDecision {
+    /** The mode this decision was made under. */
+    mode: StrictnessMode;
+    /** What strict mode would have returned (the frozen exit-code meaning). */
+    strictExitCode: 0 | 1 | 2;
+    /** The exit code this process actually returns. */
+    exitCode: 0 | 1 | 2;
+    /** True when strict mode would have blocked (1) — honest under warn. */
+    wouldBlock: boolean;
+    /** Blocking items that still block under this mode. */
+    blockingInScope: number;
+    /** Total blocking items the strict decision saw. */
+    blockingTotal: number;
+}
+/**
+ * Maps a strict gate decision onto the owner's chosen strictness. Exit
+ * codes keep their meaning: 2 (config/usage) is NEVER softened, because
+ * a gate that cannot evaluate honestly has nothing to report; only the
+ * debt exit 1 is affected. `changed` fails closed when no diff could be
+ * resolved — you cannot narrow a gate to an unknown change.
+ *
+ * Args:
+ *   input: mode, the strict decision, the total blocking count, and
+ *     (for `changed`) the resolved diff scope.
+ *
+ * Returns:
+ *   StrictnessDecision: the effective exit code plus what it hides.
+ */
+export declare function decideStrictness(input: {
+    mode: StrictnessMode;
+    strictExitCode: 0 | 1 | 2;
+    blockingTotal: number;
+    changed?: ChangedBlockingScope;
+}): StrictnessDecision;
+/**
+ * Renders the one-line strictness summary every text report shows, so a
+ * softened gate always announces itself: `mode: warn (would block: 3)`.
+ *
+ * Args:
+ *   decision: the decision to render.
+ *
+ * Returns:
+ *   string: the single-line summary.
+ */
+export declare function strictnessSummaryLine(decision: StrictnessDecision): string;
+//# sourceMappingURL=strictness.d.ts.map

package/dist/strictness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strictness.d.ts","sourceRoot":"","sources":["../src/strictness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;EAAwC,CAAC;AAE1E,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,cAAyB,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAAE,GAAG,cAAc,CAEnG;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,IAAI,EAAE,cAAc,CAAC;IACrB,2EAA2E;IAC3E,cAAc,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,cAAc,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,GAAG,kBAAkB,CAoBrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAG1E"}

package/dist/strictness.js

@@ -0,0 +1,92 @@
+/**
+ * Owner-chosen gate strictness and the
+ * flaky-test quarantine model (Phase 2).
+ *
+ * `mode` is an OPTIONAL owner-owned config key. Its default is
+ * `strict`, which is exactly the behavior a repository without the key
+ * has today — the frozen contract. The owner may soften the GATE, never
+ * the evidence: `warn` still evaluates, counts and reports everything
+ * and only the exit code changes; `changed` blocks on debt this change
+ * touches while the full debt stays in the report.
+ *
+ * Pure and deterministic: every function here is total, side-effect
+ * free and free of wall-clock reads, so the decision is unit-testable
+ * and identical on every surface that asks for it.
+ */
+import { z } from 'zod';
+/**
+ * The three owner-selectable gate strictness levels.
+ *
+ * - `strict` — today's gate (also the default when the key is absent).
+ * - `changed` — block only for debt the evaluated change touches; the
+ *   full debt is still reported.
+ * - `warn` — evaluate fully, report everything, exit 0.
+ */
+export const StrictnessModeSchema = z.enum(['strict', 'changed', 'warn']);
+/** The mode a repository without a `mode` key runs in (today's behavior). */
+export const DEFAULT_STRICTNESS_MODE = 'strict';
+/**
+ * Resolves the effective strictness mode of a config document.
+ *
+ * Args:
+ *   config: the loaded config (the `mode` key is optional).
+ *
+ * Returns:
+ *   StrictnessMode: the declared mode, or `strict` when absent.
+ */
+export function resolveStrictnessMode(config) {
+    return config.mode ?? DEFAULT_STRICTNESS_MODE;
+}
+/**
+ * Maps a strict gate decision onto the owner's chosen strictness. Exit
+ * codes keep their meaning: 2 (config/usage) is NEVER softened, because
+ * a gate that cannot evaluate honestly has nothing to report; only the
+ * debt exit 1 is affected. `changed` fails closed when no diff could be
+ * resolved — you cannot narrow a gate to an unknown change.
+ *
+ * Args:
+ *   input: mode, the strict decision, the total blocking count, and
+ *     (for `changed`) the resolved diff scope.
+ *
+ * Returns:
+ *   StrictnessDecision: the effective exit code plus what it hides.
+ */
+export function decideStrictness(input) {
+    const total = Math.max(0, input.blockingTotal);
+    const base = {
+        mode: input.mode,
+        strictExitCode: input.strictExitCode,
+        wouldBlock: input.strictExitCode === 1,
+        blockingTotal: total,
+    };
+    if (input.strictExitCode !== 1) {
+        return { ...base, exitCode: input.strictExitCode, blockingInScope: total };
+    }
+    if (input.mode === 'warn') {
+        return { ...base, exitCode: 0, blockingInScope: 0 };
+    }
+    if (input.mode === 'changed') {
+        const inScope = input.changed?.active === true ? Math.max(0, input.changed.blockingInScope) : total;
+        if (inScope > 0)
+            return { ...base, exitCode: 1, blockingInScope: inScope };
+        if (input.changed?.active === true)
+            return { ...base, exitCode: 0, blockingInScope: 0 };
+    }
+    return { ...base, exitCode: 1, blockingInScope: total };
+}
+/**
+ * Renders the one-line strictness summary every text report shows, so a
+ * softened gate always announces itself: `mode: warn (would block: 3)`.
+ *
+ * Args:
+ *   decision: the decision to render.
+ *
+ * Returns:
+ *   string: the single-line summary.
+ */
+export function strictnessSummaryLine(decision) {
+    if (decision.strictExitCode !== 1)
+        return `mode: ${decision.mode}`;
+    return `mode: ${decision.mode} (would block: ${String(decision.blockingTotal)})`;
+}
+//# sourceMappingURL=strictness.js.map

package/dist/strictness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strictness.js","sourceRoot":"","sources":["../src/strictness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAK1E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAmB,QAAQ,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6C;IACjF,OAAO,MAAM,CAAC,IAAI,IAAI,uBAAuB,CAAC;AAChD,CAAC;AA6BD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAKhC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,cAAc,KAAK,CAAC;QACtC,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC7E,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACpG,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;QAC3E,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,IAAI,QAAQ,CAAC,cAAc,KAAK,CAAC;QAAE,OAAO,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO,SAAS,QAAQ,CAAC,IAAI,kBAAkB,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC;AACnF,CAAC"}

package/dist/supervision/index.js

@@ -89,7 +89,7 @@ export function superviseExecution(planned, envelope) {
         findings.push({
             cause: 'RUN_INCOMPLETE',
             detail: `retry-assisted execution detected${envelope.retriesDetail !== undefined ? ` (${envelope.retriesDetail})` : ''} — ` +
-                'required retries are zero; only first-attempt outcomes prove behavior (plan §3.3 rule 3)',
+                'required retries are zero; only first-attempt outcomes prove behavior',
             logicalKey: null,
         });
     }
@@ -116,7 +116,7 @@ export function superviseExecution(planned, envelope) {
         if (!executedKeys.has(key)) {
             findings.push({
                 cause: 'RUN_INCOMPLETE',
-                detail: `planned instance '${instance.logicalKey}' never executed — a missing selected case blocks the run (plan §3.3 rule 5)`,
+                detail: `planned instance '${instance.logicalKey}' never executed — a selected case is missing, so the run blocks`,
                 logicalKey: instance.logicalKey,
             });
         }
@@ -141,14 +141,14 @@ export function superviseExecution(planned, envelope) {
             findings.push({
                 cause: 'RUN_INCOMPLETE',
                 detail: `instance '${outcome.logicalKey}' executed on attempt ${String(outcome.attempt)} — ` +
-                    'retry-assisted execution is prohibited (required retries are zero; plan §3.3 rule 3)',
+                    'retry-assisted execution is prohibited (required retries are zero)',
                 logicalKey: outcome.logicalKey,
             });
         }
         if (outcome.status === 'failed' && !outcome.expectedFailure) {
             findings.push({
                 cause: 'TEST_FAILED',
-                detail: `instance '${outcome.logicalKey}' failed on attempt ${String(outcome.attempt)} — the whole run fails (plan §3.3 rule 5)`,
+                detail: `instance '${outcome.logicalKey}' failed on attempt ${String(outcome.attempt)} — the whole run fails`,
                 logicalKey: outcome.logicalKey,
             });
             continue;
@@ -156,7 +156,7 @@ export function superviseExecution(planned, envelope) {
         if (outcome.expectedFailure) {
             findings.push({
                 cause: 'TEST_NOT_EXECUTED',
-                detail: `instance '${outcome.logicalKey}' is an expected failure — an expected-failure exemption never proves behavior (plan §3.3 rule 3)`,
+                detail: `instance '${outcome.logicalKey}' is an expected failure — an expected-failure exemption never proves behavior`,
                 logicalKey: outcome.logicalKey,
             });
             continue;
@@ -174,7 +174,7 @@ export function superviseExecution(planned, envelope) {
         findings.push({
             cause: 'RUN_INCOMPLETE',
             detail: envelope.fixtureOutcome === 'failed'
-                ? 'the run did not end successfully: a setup, teardown, or runner-level error was observed — fixtures and teardown must pass too (plan §3.3 rule 5)'
+                ? 'the run did not end successfully: a setup, teardown, or runner-level error was observed — fixtures and teardown must pass too'
                 : 'the run did not report a final fixture/teardown outcome (crash or lost reporter contact) — fail closed',
             logicalKey: null,
         });

package/dist/supervision/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/supervision/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAmIvD,8EAA8E;AAC9E,SAAS,WAAW,CAAC,OAAsB,EAAE,IAAY,EAAE,SAA4B;IACrF,OAAO,GAAG,OAAO,IAAI,GAAG,SAAS,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwC,EACxC,QAAkC;IAElC,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,qEAAqE;IACrE,8DAA8D;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EACJ,oHAAoH;YACtH,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,oEAAoE;IACpE,8CAA8C;IAC9C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EACJ,iCAAiC,UAAU,oBAAoB,QAAQ,CAAC,UAAU,IAAI;oBACtF,uGAAuG;gBACzG,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,+CAA+C,QAAQ,CAAC,UAAU,IAAI;oBACtE,IAAI,QAAQ,CAAC,kBAAkB,iEAAiE;gBAClG,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,mEAAmE;IACnE,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB;YACvB,MAAM,EACJ,oCAAoC,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK;gBACnH,0FAA0F;YAC5F,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,qEAAqE;IACrE,sEAAsE;IACtE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC7D,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7E,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAkC,CAAC;IACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,qBAAqB,QAAQ,CAAC,UAAU,8EAA8E;gBACxH,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,sBAAsB,OAAO,CAAC,UAAU,0CAA0C;oBAClF,mGAAmG;gBACrG,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,kEAAkE;IAClE,uEAAuE;IACvE,8DAA8D;IAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,aAAa,OAAO,CAAC,UAAU,yBAAyB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK;oBACpF,sFAAsF;gBACxF,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,aAAa,OAAO,CAAC,UAAU,uBAAuB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,2CAA2C;gBAChI,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EACJ,aAAa,OAAO,CAAC,UAAU,mGAAmG;gBACpI,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/F,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EAAE,aAAa,OAAO,CAAC,UAAU,8BAA8B,OAAO,CAAC,MAAM,+BAA+B;gBAClH,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,QAAQ,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB;YACvB,MAAM,EACJ,QAAQ,CAAC,cAAc,KAAK,QAAQ;gBAClC,CAAC,CAAC,kJAAkJ;gBACpJ,CAAC,CAAC,wGAAwG;YAC9G,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,iDAAiD;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,sBAAsB,QAAQ,CAAC,MAAM,CAAC,MAAM,wDAAwD;YAC5G,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,kBAAkB;IAClB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB;YACvB,MAAM,EACJ,QAAQ,CAAC,gBAAgB,KAAK,SAAS,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;gBAC7E,CAAC,CAAC,QAAQ,CAAC,gBAAgB;gBAC3B,CAAC,CAAC,wEAAwE;YAC9E,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,qCAAqC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,+CAA+C;YACxH,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,iEAAiE;IACjE,qEAAqE;IACrE,iCAAiC;IACjC,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;QAChC,cAAc,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACtD,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CACrC,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED,iEAAiE;AACjE,SAAS,QAAQ,CAAC,OAAsB,EAAE,IAAY,EAAE,SAA4B;IAClF,OAAO,GAAG,OAAO,IAAI,GAAG,SAAS,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAS,iBAAiB,CACxB,OAAwC,EACxC,KAAmC;IAEnC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL;gBACE,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,wFAAwF;oBACxF,uEAAuE;gBACzE,UAAU,EAAE,IAAI;aACjB;SACF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1E,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,kBAAkB,QAAQ,CAAC,UAAU,iDAAiD;oBACtF,wFAAwF;oBACxF,oEAAoE;gBACtE,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,kBAAkB,QAAQ,CAAC,UAAU,iDAAiD;oBACtF,sEAAsE;gBACxE,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EACJ,kBAAkB,QAAQ,CAAC,UAAU,8BAA8B,OAAO,CAAC,SAAS,MAAM;wBAC1F,qEAAqE;oBACvE,UAAU,EAAE,QAAQ,CAAC,UAAU;iBAChC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EACJ,kBAAkB,QAAQ,CAAC,UAAU,qBAAqB,OAAO,CAAC,SAAS,SAAS;wBACpF,YAAY,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC,iDAAiD;oBACnG,UAAU,EAAE,QAAQ,CAAC,UAAU;iBAChC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,4DAA4D;YAC5D,4DAA4D;YAC5D,+DAA+D;YAC/D,+DAA+D;YAC/D,4DAA4D;YAC5D,0DAA0D;QAC5D,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EACJ,sEAAsE;oBACtE,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,uCAAuC;oBACpF,uEAAuE;gBACzE,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,cAAc,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACtD,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CACrC,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAc7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAmC;IACrE,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC;SAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;KAC/B,CAAC,CAAC;SACF,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,cAAc,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAChD,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAC9B,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC/D,CAAC;IACJ,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/supervision/index.ts"],"names":[],"mappings":"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"}

package/dist/twin-paths.d.ts

@@ -0,0 +1,125 @@
+/** One observed request, as the observation-only proxy saw it. */
+export interface ObservedRequest {
+    /** Uppercase method (GET, POST, ...). */
+    method: string;
+    /** The request target: path plus query, exactly as it arrived. */
+    url: string;
+}
+/** The route inventory a shape resolves against (compiled endpoints). */
+export interface RouteInventory {
+    /** Route templates in the engine's `{}` grammar, e.g. `/accounts/{}`. */
+    templates: readonly string[];
+}
+/** Owner-declared query keys whose VALUES a shape may carry. */
+export interface TwinShapeOptions {
+    /** The compiled http.endpoint templates, when the run has them. */
+    inventory?: RouteInventory;
+    /**
+     * Query keys whose values may be recorded (`enforcement.twinQueryKeys`).
+     * Absent or empty = keys only: the shape says `tab` was sent and
+     * nothing about what it said.
+     */
+    queryKeys?: readonly string[];
+}
+/** One request shape: comparable, and free of anything identifying. */
+export interface TwinShape {
+    /** Uppercase method. */
+    method: string;
+    /** The route template the request resolved to (never a concrete id). */
+    route: string;
+    /** Allowlisted query values, sorted by key. Absent = keys only. */
+    query?: Record<string, string>;
+}
+/** One twin's observed request shapes, with the test that produced them. */
+export interface TwinObservation {
+    /** The logical key of the test that made these requests. */
+    logicalKey: string;
+    /** The shapes it exercised, in observation order. */
+    shapes: readonly TwinShape[];
+}
+/** One direction of a divergence between two twins. */
+export interface TwinDivergence {
+    /** The twin that DID exercise the shape. */
+    presentIn: string;
+    /** The twin that never did. */
+    missingFrom: string;
+    /** The shape itself (method, route template, allowlisted values). */
+    shape: TwinShape;
+}
+/**
+ * Turns one observed request into its comparable shape.
+ *
+ * Args:
+ *   request: the method and target the proxy observed.
+ *   options: the run's route inventory and owner-declared query keys.
+ *
+ * Returns:
+ *   TwinShape: method + route template + allowlisted query values.
+ */
+export declare function twinShapeOf(request: ObservedRequest, options?: TwinShapeOptions): TwinShape;
+/**
+ * Compares two twins' shapes and returns both directions of the
+ * divergence: what the witnessed twin did that the raw twin never did,
+ * and what the raw twin did that the witnessed twin never did. A shape
+ * both exercised is not reported — twins that agree are the healthy
+ * case and must stay silent.
+ *
+ * Args:
+ *   witnessed: the witnessed twin's shapes.
+ *   raw: the raw twin's shapes.
+ *
+ * Returns:
+ *   TwinDivergence[]: every one-sided shape, witnessed-side first,
+ *   deterministic in shape identity.
+ */
+export declare function twinPathDivergence(witnessed: TwinObservation, raw: TwinObservation): TwinDivergence[];
+/** The finding text a divergence produces, naming BOTH tests and the shape. */
+export declare function twinDivergenceDetail(divergence: TwinDivergence): string;
+/**
+ * The tag a title carries to declare itself the WITNESSED twin. It is
+ * part of the title convention, not a gate: the link is a naming
+ * convention an owner follows, and the engine only reads it when the
+ * owner switched twin coverage on.
+ */
+export declare const WITNESSED_TITLE_TAG = "[witnessed]";
+/** The one catalog fact a twin link needs: which test, and its title. */
+export interface TwinCandidate {
+    /** Stable logical key (the catalog's `logicalKey`). */
+    logicalKey: string;
+    /** The test's own title (the last segment of its title path). */
+    title: string;
+}
+/** One linked raw/witnessed pair, with the reason the link exists. */
+export interface TwinLink {
+    /** The witnessed test: the one the run grades. */
+    witnessed: string;
+    /** The raw test it is the twin of. */
+    raw: string;
+    /** Which rule produced the link (for the run's own explanation). */
+    source: 'test-map' | 'title';
+}
+/**
+ * Resolves the raw/witnessed pairs a run should compare.
+ *
+ * Two rules, in that order, and never a guess:
+ * - `twinOf`: the explicit test-map declaration — the only link that
+ *   survives a rename of either test, because it names logical keys.
+ * - the title convention: a witnessed title that carries
+ *   {@link WITNESSED_TITLE_TAG} links to the untagged title with the
+ *   same stem: `X raw`, else the one `X raw: <description>`, else a
+ *   bare `X`.
+ *
+ * A link is only returned when BOTH tests exist in the catalog: a
+ * dangling `twinOf` or a title with no partner names nothing, because
+ * a pair with one missing side has no shapes to compare and a finding
+ * about it would be a ghost.
+ *
+ * Args:
+ *   candidates: every test the catalog knows (logical key + title).
+ *   twinOf: explicit `witnessed -> raw` logical-key declarations.
+ *
+ * Returns:
+ *   TwinLink[]: every resolvable pair, deterministic in witnessed key.
+ */
+export declare function twinLinksFor(candidates: readonly TwinCandidate[], twinOf?: Readonly<Record<string, string>>): TwinLink[];
+//# sourceMappingURL=twin-paths.d.ts.map

package/dist/twin-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twin-paths.d.ts","sourceRoot":"","sources":["../src/twin-paths.ts"],"names":[],"mappings":"AA0BA,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,SAAS,CAAC;CAClB;AAsDD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAe/F;AAqBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,GAAG,EAAE,eAAe,GACnB,cAAc,EAAE,CAWlB;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAKvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC5C,QAAQ,EAAE,CAwDZ"}