@eir-labs/coltrane 0.10.0 → 0.12.0

package/dist/src/gig_conformance.js

@@ -0,0 +1,153 @@
+import { outputSatisfiesType } from "./runtime.js";
+/**
+ * Classify a sealed gig run against its construction. PURE — same inputs, same result; no store,
+ * no invoker, no network.
+ *
+ * @param standard  the composed standard (the chart) this run performed
+ * @param produced  the settled sealed output set (produced[] as runGig finalizes it — derived,
+ *                  reused-and-re-sealed, resume-restored and every amend round included)
+ * @param skipped   the SkippedChair rows (resume + reuse), so a contract satisfied only by a prior
+ *                  gig's reused output is not read as missing
+ * @param status    the run's terminal status. `"complete"` runs FIT+TIMING; `"awaiting_approval"`
+ *                  short-circuits to INCOMPLETE; anything else is FAILED
+ * @param gigId     this gig's id — the boundary that tells an in-gig derived record from a seeded or
+ *                  reused-by-reference cross-gig record (whose source gig owns its own timing)
+ */
+export function checkGigConformance(standard, produced, skipped, status, gigId) {
+    // ── Status routing FIRST — before any FIT/TIMING analysis ──────────────────────────────────
+    // A parked gig legitimately lacks its human chair's output; a failed gig lacks outputs by
+    // definition. Neither is a nonconformance, and running FIT over either would manufacture one.
+    if (status === "awaiting_approval") {
+        return { verdict: "INCOMPLETE", awaiting_status: status };
+    }
+    if (status !== "complete") {
+        return { verdict: "FAILED", description: `gig ended in status "${status}" — a run that did not complete lacks outputs by definition; conformance describes that, it does not condemn it` };
+    }
+    const chairs = standard.phases.flatMap((p) => [...p.chairs]);
+    const chairByRole = new Map(chairs.map((c) => [c.role, c]));
+    // Records THIS chair actually sealed, keyed by producing role. Reuse re-seals into this gig and
+    // resume restores into it, so both already appear here under their chair's role.
+    const recordsByRole = new Map();
+    for (const r of produced) {
+        if (r.from_role === undefined)
+            continue; // legacy hand-rolled write with no chair attribution
+        const list = recordsByRole.get(r.from_role);
+        if (list)
+            list.push(r);
+        else
+            recordsByRole.set(r.from_role, [r]);
+    }
+    // Reuse SkippedChairs, keyed by role: a declared type satisfied ONLY by a prior gig's reused
+    // output (the "referenced, not re-sealed" shape) is conformant, not missing. Resume rows also
+    // appear in produced[] under their role, so this is the reuse-by-reference safety net.
+    const reuseTypesByRole = new Map();
+    for (const sk of skipped) {
+        if (sk.reason !== "reuse")
+            continue;
+        const set = reuseTypesByRole.get(sk.role) ?? new Set();
+        for (const t of sk.output_types)
+            set.add(t);
+        reuseTypesByRole.set(sk.role, set);
+    }
+    // ── FIT ────────────────────────────────────────────────────────────────────────────────────
+    const fit_violations = [];
+    const fit_surplus = [];
+    for (const c of chairs) {
+        const optional = new Set(c.optional_outputs ?? []);
+        const sealed = recordsByRole.get(c.role) ?? [];
+        const reused = reuseTypesByRole.get(c.role);
+        for (const declared of c.output_contract) {
+            // Cardinality is not the question — "at least one" record of the declared type, subtype-aware.
+            const satisfiedByRecord = sealed.some((r) => outputSatisfiesType(r, declared));
+            // A reuse SkippedChair names its covered types as plain strings (no record to run the
+            // polymorphic predicate over), so an exact-name match is the honest check there.
+            const satisfiedByReuse = reused?.has(declared) === true;
+            if (satisfiedByRecord || satisfiedByReuse)
+                continue;
+            // A genome-declared optional (#243) that sealed nothing is a conditional output, not a gap —
+            // that shortfall is `GigResult.unfulfilled_outputs`' concern, a different question from FIT.
+            if (optional.has(declared))
+                continue;
+            fit_violations.push({ chair_slug: c.role, declared_type: declared });
+        }
+    }
+    // Surplus: a record sealed under a type its chair never declared. Scanned over records the chair
+    // actually sealed (attributable via from_role) — a foreign record with no matching chair is not
+    // this standard's to grade.
+    for (const c of chairs) {
+        const contract = c.output_contract;
+        for (const r of recordsByRole.get(c.role) ?? []) {
+            const matchesSomeDeclared = contract.some((declared) => outputSatisfiesType(r, declared));
+            if (!matchesSomeDeclared) {
+                fit_surplus.push({ chair_slug: c.role, sealed_type: r.domain_type });
+            }
+        }
+    }
+    // ── TIMING ───────────────────────────────────────────────────────────────────────────────────
+    // Reverse-dependency index: for each chair, the chairs that declared depends_on IT. The
+    // examine-amend loop feeds a verify chair's verdict back into the maker it judged, and the verify
+    // chair `depends_on` the maker — so a maker consuming that verdict is respecting a DECLARED edge,
+    // read in reverse for feedback. Authorizing both directions of a declared edge is what keeps the
+    // check from crying wolf on every amend round.
+    const reverseDeps = new Map();
+    for (const c of chairs) {
+        for (const dep of c.depends_on) {
+            const set = reverseDeps.get(dep) ?? new Set();
+            set.add(c.role);
+            reverseDeps.set(dep, set);
+        }
+    }
+    // sha → the in-gig chair that sealed a record with that content_sha. Attribution for a flagged
+    // sha, and the resolvability test: a sha NOT in this map belongs to a seed / reused-by-reference
+    // / store-miss record and is unresolvable here — the check stays silent rather than guess.
+    const shaToRole = new Map();
+    for (const r of produced) {
+        if (r.gig_id !== gigId)
+            continue; // only in-gig sealed records attribute a chair here
+        if (r.from_role === undefined)
+            continue;
+        if (!shaToRole.has(r.content_sha))
+            shaToRole.set(r.content_sha, r.from_role);
+    }
+    const timing_violations = [];
+    for (const r of produced) {
+        // A reused/seeded record's provenance was validated by its SOURCE gig at that gig's close —
+        // its shas resolve into that gig, not this one. Skip on either signal: a foreign gig_id, or the
+        // reused_from annotation the reuse re-seal stamps.
+        if (r.gig_id !== gigId)
+            continue;
+        if (r.reused_from)
+            continue;
+        if (r.from_role === undefined)
+            continue;
+        const producer = chairByRole.get(r.from_role);
+        if (!producer)
+            continue; // record from a role not in this standard — not ours to time
+        // Authorized producers of this record's inputs: the declared upstream (depends_on), the reverse
+        // feedback edge (chairs that depend_on this producer — the examine-amend case), and the producer
+        // itself (iterative self-consumption).
+        const authorized = new Set([producer.role, ...producer.depends_on]);
+        for (const rev of reverseDeps.get(producer.role) ?? [])
+            authorized.add(rev);
+        for (const sha of r.input_shas) {
+            if (sha === "")
+                continue; // engine stamped "" for an input it could not resolve — a store-miss, not a breach
+            const source = shaToRole.get(sha);
+            if (source === undefined)
+                continue; // resolves to no in-gig record — a seed / cross-gig input, unresolvable here
+            if (authorized.has(source))
+                continue; // respects a declared edge (forward, reverse, or self)
+            timing_violations.push({
+                record_id: r.id,
+                sealing_chair_slug: r.from_role,
+                unauthorized_sha: sha,
+                unauthorized_source_chair_slug: source,
+            });
+        }
+    }
+    if (fit_violations.length === 0 && fit_surplus.length === 0 && timing_violations.length === 0) {
+        return { verdict: "CLEAN" };
+    }
+    return { verdict: "VIOLATED", fit_violations, fit_surplus, timing_violations };
+}
+//# sourceMappingURL=gig_conformance.js.map

package/dist/src/gig_conformance.js.map

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

package/dist/src/gig_tracker.js

@@ -117,6 +117,14 @@ export function gigEventLogLine(gig_id, ev) {
         case "phase_start": return JSON.stringify({ ...base, ev: "phase_start", phase: ev.phase, chairs: ev.roles });
         case "chair_start": return JSON.stringify({ ...base, ev: "chair_start", phase: ev.phase, role: ev.role, producer: ev.producer });
         case "chair_complete": return JSON.stringify({ ...base, ev: "chair_complete", role: ev.role, sealed: ev.output_types, ms: ev.duration_ms });
+        // Logged whichever way it went. An adoption is a governance act and a refusal is the
+        // reason one did not happen; a line that only appeared on success would make silence
+        // ambiguous, which is the defect this channel exists to close.
+        case "lineage_adoption": return JSON.stringify({ ...base, ev: "lineage_adoption", role: ev.role,
+            adopt: ev.adopt, ...(ev.record_ref ? { record_ref: ev.record_ref } : {}),
+            ...(ev.institution_slug ? { institution: ev.institution_slug } : {}),
+            ...(ev.approved_by ? { approved_by: ev.approved_by } : {}),
+            ...(ev.refusals ? { refusals: ev.refusals } : {}) });
         case "chair_failed": return JSON.stringify({ ...base, ev: "chair_failed", role: ev.role, error: ev.error });
         // #241 — a dangling (non-required) skill binding. Surfaced live because an unskilled run
         // is otherwise indistinguishable from a skilled one: same genome_hash, run_fingerprint,

package/dist/src/gig_tracker.js.map

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

package/dist/src/grounding.d.ts

@@ -0,0 +1,44 @@
+import type { RepositoryIndex } from "./repo_index.js";
+/** The judgment half a reader supplies — the noticing the compiler deliberately does not do. */
+export type Judgment = {
+    claims: unknown[];
+    unknowns: string[];
+    frame: string;
+    confidence?: number;
+};
+/** A guard/acceptance result. `reason` is present only on refusal (exactOptionalPropertyTypes). */
+export type GroundingResult = {
+    ok: boolean;
+    reason?: string;
+};
+/**
+ * Assemble a change-context from a compiled index (mechanical fields) plus a reader's judgment
+ * (the claims/unknowns/frame the compiler cannot produce). The result satisfies the shared
+ * change-context type: every required field is populated and no undeclared field is added.
+ */
+export declare function assembleChangeContext(index: RepositoryIndex, judgment: Judgment): Record<string, unknown>;
+/**
+ * Admit a change-context only when it carries a READING — at least one load-bearing claim (a
+ * locator with a line, asserting something the index cannot hold). Empty claims, or claims that
+ * merely restate the mechanical index (file-only locators), are refused: a judgment-free grounding
+ * does not pass, and a load-bearing claim is not laundered by derivable ones alongside it.
+ */
+export declare function admitChangeContext(rec: Record<string, unknown>, index: RepositoryIndex): GroundingResult;
+/**
+ * Refuse a change-context whose index revision has drifted from current source. Fail closed: a
+ * missing or mismatched revision does not pass — a stale index seeding a change is worse than a
+ * slow reader.
+ */
+export declare function freshnessGate(rec: Record<string, unknown>, currentRevision: string): GroundingResult;
+/**
+ * The golden-master surface: the MECHANICAL fields only. Judgment has no fixed oracle, so a
+ * snapshot must never pin `claims` / `unknowns` / `frame` to a "correct" value. Stripping them
+ * leaves exactly the fields a deterministic diff may hold to.
+ */
+export declare function snapshotMechanical(rec: Record<string, unknown>): Record<string, unknown>;
+/**
+ * The producer-agnostic acceptance. The consumer keys on the change-context TYPE — the presence of
+ * a reading (claims) and its mechanical companions — and NEVER on who produced it. `produced_by`
+ * is not read here, so the same record labelled by any producer is accepted identically.
+ */
+export declare function consumerAcceptsGrounding(rec: Record<string, unknown>): GroundingResult;

package/dist/src/grounding.js

@@ -0,0 +1,127 @@
+// Grounding arrives as an INPUT — and judgment cannot be replaced by lookup.
+//
+// Two decoupled obligations, held apart on purpose (#424):
+//   (1) GROUNDING-AS-INPUT — a change-context is a first-class record any of four interchangeable
+//       producers (reader / compiler / prior standard / human) may seal, and the consuming
+//       standard keys on the TYPE, never on who produced it. `assembleChangeContext` is the
+//       compiler-plus-enricher producer: mechanical fields lifted from a compiled index, judgment
+//       supplied by a reader. `consumerAcceptsGrounding` is the producer-agnostic acceptance —
+//       it does not read `produced_by`. `freshnessGate` refuses a change-context whose index
+//       revision has drifted from current source (a stale index seeding a change is worse than a
+//       slow reader — fail closed).
+//   (2) DO-NOT-COMPILE-AWAY-THE-CLAIMS — the mechanical fields may be compiled, but a change-context
+//       is UNSATISFIABLE by a record whose claims are empty or merely restate the index. A reading
+//       is a claim that points at a specific line and asserts something the index cannot hold;
+//       `admitChangeContext` admits only a record that carries at least one. `snapshotMechanical`
+//       is the golden-master surface: it strips the judgment fields, because judgment has no fixed
+//       oracle — only the mechanical fields can be pinned.
+//
+// Everything here is pure: no I/O, no clock, no registry. The functions operate on plain records
+// so the seam can be verified in isolation (consumer against a seeded change-context; each
+// producer/guard against the shared type) without running a live agent.
+/**
+ * A locator is LOAD-BEARING when it names a specific line (file:line) — evidence the mechanical
+ * index cannot itself hold. A file-only locator merely points at a file the index already lists,
+ * so it is derivable and does not, on its own, make a claim a reading. This is exactly the
+ * distinction the two spec fixtures exercise (`src/runtime.ts` vs `src/runtime.ts:2072`).
+ */
+function isLoadBearing(claim) {
+    const locator = claim?.locator;
+    return typeof locator === "string" && /:\d+/.test(locator);
+}
+/**
+ * Assemble a change-context from a compiled index (mechanical fields) plus a reader's judgment
+ * (the claims/unknowns/frame the compiler cannot produce). The result satisfies the shared
+ * change-context type: every required field is populated and no undeclared field is added.
+ */
+export function assembleChangeContext(index, judgment) {
+    const relevant_files = index.boundary.map((path) => ({
+        path,
+        why: "within the compiled boundary of the reading",
+        locator: path,
+    }));
+    const existing_tests = [...new Set(index.module_tests.map((m) => m.test))].sort();
+    const entry_points = index.entry_points.map((e) => `${e.module}#${e.symbol}`);
+    return {
+        id: `change-context@${index.source_revision}`,
+        input_refs: [`repo-index/${index.source_revision}`],
+        // Judgment half — supplied by the reader, opaque to the compiler.
+        frame: judgment.frame,
+        claims: judgment.claims,
+        unknowns: judgment.unknowns,
+        ...(judgment.confidence !== undefined ? { confidence: judgment.confidence } : {}),
+        // Mechanical half — lifted verbatim from the compiled index.
+        boundary: index.boundary,
+        entry_points,
+        relevant_files,
+        existing_tests,
+        conventions_observed: index.conventions_observed,
+        index_revision: index.source_revision,
+    };
+}
+/**
+ * Admit a change-context only when it carries a READING — at least one load-bearing claim (a
+ * locator with a line, asserting something the index cannot hold). Empty claims, or claims that
+ * merely restate the mechanical index (file-only locators), are refused: a judgment-free grounding
+ * does not pass, and a load-bearing claim is not laundered by derivable ones alongside it.
+ */
+export function admitChangeContext(rec, index) {
+    void index; // the predicate keys on locator format alone (#424 tradeoff), not on index contents
+    const claims = rec["claims"];
+    if (!Array.isArray(claims) || claims.length === 0) {
+        return { ok: false, reason: "a change-context with no claims is a judgment-free grounding" };
+    }
+    if (!claims.some(isLoadBearing)) {
+        return {
+            ok: false,
+            reason: "every claim is derivable from the mechanical index — a lookup masquerading as a reading",
+        };
+    }
+    return { ok: true };
+}
+/**
+ * Refuse a change-context whose index revision has drifted from current source. Fail closed: a
+ * missing or mismatched revision does not pass — a stale index seeding a change is worse than a
+ * slow reader.
+ */
+export function freshnessGate(rec, currentRevision) {
+    const rev = rec["index_revision"];
+    if (typeof rev !== "string" || rev.length === 0) {
+        return { ok: false, reason: "change-context carries no index_revision — cannot prove freshness" };
+    }
+    if (rev !== currentRevision) {
+        return { ok: false, reason: `stale index: change-context built at ${rev}, current source is ${currentRevision}` };
+    }
+    return { ok: true };
+}
+/**
+ * The golden-master surface: the MECHANICAL fields only. Judgment has no fixed oracle, so a
+ * snapshot must never pin `claims` / `unknowns` / `frame` to a "correct" value. Stripping them
+ * leaves exactly the fields a deterministic diff may hold to.
+ */
+export function snapshotMechanical(rec) {
+    const { claims, unknowns, frame, ...mechanical } = rec;
+    void claims;
+    void unknowns;
+    void frame;
+    return mechanical;
+}
+/**
+ * The producer-agnostic acceptance. The consumer keys on the change-context TYPE — the presence of
+ * a reading (claims) and its mechanical companions — and NEVER on who produced it. `produced_by`
+ * is not read here, so the same record labelled by any producer is accepted identically.
+ */
+export function consumerAcceptsGrounding(rec) {
+    const claims = rec["claims"];
+    if (!Array.isArray(claims) || claims.length === 0) {
+        return { ok: false, reason: "not a change-context: no claims" };
+    }
+    if (!Array.isArray(rec["relevant_files"])) {
+        return { ok: false, reason: "not a change-context: no relevant_files" };
+    }
+    if (!Array.isArray(rec["unknowns"])) {
+        return { ok: false, reason: "not a change-context: unknowns must be named, even if empty" };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=grounding.js.map

package/dist/src/grounding.js.map

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

package/dist/src/index.d.ts

@@ -25,6 +25,7 @@ export * from "./reuse.js";
 export * from "./charter.js";
 export * from "./server.js";
 export * from "./runtime.js";
+export * from "./gig_conformance.js";
 export * from "./chart.js";
 export * from "./claude_invoker.js";
 export * from "./bifrost_invoker.js";
@@ -39,3 +40,5 @@ export * from "./polyphony.js";
 export * from "./harmonic_validation.js";
 export * from "./acoustics.js";
 export * from "./document_factory.js";
+export * from "./local_queue.js";
+export * from "./residency.js";

package/dist/src/index.js

@@ -25,6 +25,7 @@ export * from "./reuse.js";
 export * from "./charter.js";
 export * from "./server.js";
 export * from "./runtime.js";
+export * from "./gig_conformance.js";
 export * from "./chart.js";
 export * from "./claude_invoker.js";
 export * from "./bifrost_invoker.js";
@@ -39,4 +40,12 @@ export * from "./polyphony.js";
 export * from "./harmonic_validation.js";
 export * from "./acoustics.js";
 export * from "./document_factory.js";
+// The two engine-half modules a downstream consumer imports directly. Neither is wired into a
+// surface yet — enqueueing locally and claiming locally are each their own contract — but both are
+// PUBLIC surfaces, not internals: local_queue is the third queue backing (the file sibling of
+// fileGenomeStore), and residency is the enforcement half of `coltrane reside`. Exporting them here
+// is what tests/exported_symbols_are_reachable.test.ts asks for when a mechanism has no in-src
+// caller: "wire it or export it." Wiring is a separate act; reachability is not.
+export * from "./local_queue.js";
+export * from "./residency.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AAEtC,8FAA8F;AAC9F,mGAAmG;AACnG,8FAA8F;AAC9F,oGAAoG;AACpG,+FAA+F;AAC/F,iFAAiF;AACjF,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/src/institution_loader.d.ts

@@ -1,5 +1,6 @@
 import type { LoadError } from "./loader.js";
 import type { InstitutionOutput, OrganizationOutput, AgentRecordOutput, InstitutionalChairOutput, ChairAssignmentOutput, ForebearOutput, LineageEdgeOutput, NorthstarOutput, TourOutput, ResourceOutput } from "./genome_schema.js";
+import { type LineageRecordRefOutput } from "./genome_schema.js";
 /** The multi-section institution document as it lives on disk (shape per institutions/quartet.json).
  *  Each present section is validated LOSS-FREE against its already-authored per-section schema in
  *  src/genome_schema.ts; an absent optional section is treated as empty, not as an error. This IS
@@ -27,15 +28,16 @@ export interface LoadedInstitution {
     document: InstitutionDocumentSections;
 }
 /**
- * SEAM (RED — body throws). Read every institutions/*.json under `root`, validate each present
+ * Read every institutions/*.json under `root`, validate each present
  * section against its per-section schema, invoke checkInstitutionAdmissibility on the schema-valid
  * document, and return the admitted institutions keyed by slug PLUS one load_error of kind
  * "institution" per file that is malformed, schema-invalid, inadmissible, or a duplicate slug.
  *
- * TOTAL by contract: the GREEN body must never throw for an institution reason — a bad document is
- * a per-file load_error and drops out; the rest of the genome loads. Deliberately NOT wired into
- * loadGenome yet: wiring it (after the agent/standard/org maps exist) is the GREEN change these red
- * tests demand. Until then this throws, so the tree compiles and red is honest.
+ * TOTAL by contract: never throws for an institution reason — a bad document becomes a per-file
+ * load_error and drops out; the rest of the genome loads. WIRED: loadGenome calls this at
+ * src/loader.ts:577 and returns the map at :589, after the agent/standard/venue/chart maps exist.
+ * The laws are tests/institution_loader.test.ts — INV5 pins that the map is populated after a real
+ * load, INV6 pins the ordering, INV1/INV7/INV14 pin the totality.
  */
 export declare function loadInstitutions(root: string): {
     institutions: Map<string, LoadedInstitution>;
@@ -61,3 +63,25 @@ export declare function loadTours(root: string, institutions: ReadonlyMap<string
     tours: Map<string, LoadedTour>;
     load_errors: LoadError[];
 };
+/** The seat inherits the institution's lineage — the call site `institutionLineageGrounding`
+ *  was written for and has been waiting on.
+ *
+ *  Walk is `assignment.agent_slug -> chair_id -> chair.institution_slug -> institution.lineage[]`.
+ *  The chair's own `institution_slug` is authoritative, not the document the assignment happens to
+ *  be filed in: an assignment may seat a player from one institution into another's office, and
+ *  the lineage a seat carries is the lineage of the office, never of the paperwork.
+ *
+ *  ONLY APPROVED LINEAGE IS INHERITED. `LineageRecordRefSchema.approved_by` is nullable and
+ *  defaulted to null precisely so this filter can exist — the schema states the rule outright:
+ *  "an institution never grounds itself on an unapproved lineage." A record that reached the
+ *  approve chair and was not sealed is therefore invisible here, which is what makes a parked
+ *  lineage pass genuinely inert rather than quietly load-bearing.
+ *
+ *  Deduplicated by `record_ref`: one agent seated in two offices of the same institution inherits
+ *  the grounding once. Order is stable — institution slug, then declaration order — so a rendered
+ *  grounding does not churn between loads.
+ *
+ *  Returns refs, not dereferenced records. The store-backed dereference through
+ *  `coltrane_institution_lineage` is the follow-up named on `LineageRecordRefSchema`; this closes
+ *  the resolution half, which is the half that had no home at all. */
+export declare function agentLineageGrounding(institutions: ReadonlyMap<string, LoadedInstitution>, agent_slug: string): readonly LineageRecordRefOutput[];

package/dist/src/institution_loader.js

@@ -19,19 +19,20 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { extname, join } from "node:path";
 import { z } from "zod";
-import { InstitutionSchema, OrganizationSchema, AgentRecordSchema, OrgMemberSchema, InstitutionalChairSchema, ChairAssignmentSchema, ForebearSchema, LineageEdgeSchema, NorthstarSchema, TourSchema, ResourceSchema, } from "./genome_schema.js";
+import { InstitutionSchema, OrganizationSchema, AgentRecordSchema, OrgMemberSchema, InstitutionalChairSchema, ChairAssignmentSchema, ForebearSchema, LineageEdgeSchema, NorthstarSchema, TourSchema, ResourceSchema, institutionLineageGrounding, } from "./genome_schema.js";
 import { checkInstitutionAdmissibility } from "./institution_enforcement.js";
 import { checkTourAdmissibility } from "./committed_work.js";
 /**
- * SEAM (RED — body throws). Read every institutions/*.json under `root`, validate each present
+ * Read every institutions/*.json under `root`, validate each present
  * section against its per-section schema, invoke checkInstitutionAdmissibility on the schema-valid
  * document, and return the admitted institutions keyed by slug PLUS one load_error of kind
  * "institution" per file that is malformed, schema-invalid, inadmissible, or a duplicate slug.
  *
- * TOTAL by contract: the GREEN body must never throw for an institution reason — a bad document is
- * a per-file load_error and drops out; the rest of the genome loads. Deliberately NOT wired into
- * loadGenome yet: wiring it (after the agent/standard/org maps exist) is the GREEN change these red
- * tests demand. Until then this throws, so the tree compiles and red is honest.
+ * TOTAL by contract: never throws for an institution reason — a bad document becomes a per-file
+ * load_error and drops out; the rest of the genome loads. WIRED: loadGenome calls this at
+ * src/loader.ts:577 and returns the map at :589, after the agent/standard/venue/chart maps exist.
+ * The laws are tests/institution_loader.test.ts — INV5 pins that the map is populated after a real
+ * load, INV6 pins the ordering, INV1/INV7/INV14 pin the totality.
  */
 export function loadInstitutions(root) {
     const institutions = new Map();
@@ -236,4 +237,64 @@ export function loadTours(root, institutions) {
     }
     return { tours, load_errors };
 }
+/** The seat inherits the institution's lineage — the call site `institutionLineageGrounding`
+ *  was written for and has been waiting on.
+ *
+ *  Walk is `assignment.agent_slug -> chair_id -> chair.institution_slug -> institution.lineage[]`.
+ *  The chair's own `institution_slug` is authoritative, not the document the assignment happens to
+ *  be filed in: an assignment may seat a player from one institution into another's office, and
+ *  the lineage a seat carries is the lineage of the office, never of the paperwork.
+ *
+ *  ONLY APPROVED LINEAGE IS INHERITED. `LineageRecordRefSchema.approved_by` is nullable and
+ *  defaulted to null precisely so this filter can exist — the schema states the rule outright:
+ *  "an institution never grounds itself on an unapproved lineage." A record that reached the
+ *  approve chair and was not sealed is therefore invisible here, which is what makes a parked
+ *  lineage pass genuinely inert rather than quietly load-bearing.
+ *
+ *  Deduplicated by `record_ref`: one agent seated in two offices of the same institution inherits
+ *  the grounding once. Order is stable — institution slug, then declaration order — so a rendered
+ *  grounding does not churn between loads.
+ *
+ *  Returns refs, not dereferenced records. The store-backed dereference through
+ *  `coltrane_institution_lineage` is the follow-up named on `LineageRecordRefSchema`; this closes
+ *  the resolution half, which is the half that had no home at all. */
+export function agentLineageGrounding(institutions, agent_slug) {
+    const seen = new Set();
+    const out = [];
+    // Chair id -> the institution that holds the office. Built once across every loaded document,
+    // because the chair an assignment names need not live in the same document as the assignment.
+    const chair_home = new Map();
+    for (const inst of institutions.values()) {
+        for (const chair of inst.document.chairs ?? []) {
+            // InstitutionalChairSchema.id is optional. A chair with no id cannot be named by an
+            // assignment's chair_id, so it seats nobody and grounds nothing — skip rather than coerce.
+            if (chair.id)
+                chair_home.set(chair.id, chair.institution_slug);
+        }
+    }
+    const held = new Set();
+    for (const inst of institutions.values()) {
+        for (const a of inst.document.assignments ?? []) {
+            if (a.agent_slug !== agent_slug)
+                continue;
+            const home = chair_home.get(a.chair_id);
+            if (home)
+                held.add(home); // an assignment naming an unknown chair grounds nothing; it is not an error here
+        }
+    }
+    for (const slug of [...held].sort()) {
+        const inst = institutions.get(slug);
+        if (!inst)
+            continue;
+        for (const ref of institutionLineageGrounding(inst.document.institution)) {
+            if (ref.approved_by == null)
+                continue; // unapproved lineage is not inherited
+            if (seen.has(ref.record_ref))
+                continue;
+            seen.add(ref.record_ref);
+            out.push(ref);
+        }
+    }
+    return out;
+}
 //# sourceMappingURL=institution_loader.js.map