@plurnk/plurnk-service 1.14.2 → 1.16.0

package/dist/core/LoopDriver.js

@@ -0,0 +1,263 @@
+import { setTimeout as delay } from "node:timers/promises";
+import Results from "./results.js";
+import { LOOP_TIMEOUT_REASON } from "./TurnRunner.js";
+import { observed } from "../observe/spans.js";
+const readMaxStrikes = () => {
+    const raw = process.env.PLURNK_SERVICE_MAX_STRIKES;
+    if (raw === undefined || raw.length === 0)
+        return DEFAULT_MAX_STRIKES;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0)
+        return DEFAULT_MAX_STRIKES;
+    return n;
+};
+const DEFAULT_MIN_CYCLES = 3;
+const DEFAULT_MAX_CYCLE_PERIOD = 4;
+const readPositiveInt = (envVar, fallback) => {
+    const raw = process.env[envVar];
+    if (raw === undefined || raw.length === 0)
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return fallback;
+    return n;
+};
+const readLoopTimeoutMs = () => readPositiveInt("PLURNK_SERVICE_LOOP_TIMEOUT", DEFAULT_LOOP_TIMEOUT_MS);
+const DEFAULT_MAX_STRIKES = 3;
+// {§operator-config-loop-timeout} — the loop's wall-clock budget (PLURNK_SERVICE_LOOP_TIMEOUT).
+const DEFAULT_LOOP_TIMEOUT_MS = 86400000;
+export default class LoopDriver {
+    #loopAborts;
+    #db;
+    #lifecycle;
+    #schemes;
+    #notices;
+    #strikes;
+    #acquireWorkspaceTurn;
+    #workspaceTurnStarting;
+    #runTurn;
+    constructor({ loopAborts, db, lifecycle, schemes, notices, strikes, acquireWorkspaceTurn, workspaceTurnStarting, runTurn }) {
+        this.#loopAborts = loopAborts;
+        this.#db = db;
+        this.#lifecycle = lifecycle;
+        this.#schemes = schemes;
+        this.#notices = notices;
+        this.#strikes = strikes;
+        this.#acquireWorkspaceTurn = acquireWorkspaceTurn;
+        this.#workspaceTurnStarting = workspaceTurnStarting;
+        this.#runTurn = runTurn;
+    }
+    async runLoop({ provider, childProvider = provider, messages, recap = "", workspaceId, workerId, loopId, maxTurns = 50, maxStrikes = readMaxStrikes(), minCycles = readPositiveInt("PLURNK_SERVICE_MIN_CYCLES", DEFAULT_MIN_CYCLES), maxCyclePeriod = readPositiveInt("PLURNK_SERVICE_MAX_CYCLE_PERIOD", DEFAULT_MAX_CYCLE_PERIOD), signal, onDispatch, onSettled }) {
+        // A 202 park suspends this durable loop and a later wake re-enters runLoop.
+        // Its ceiling therefore counts every prior turn, not merely this process-local
+        // execution segment.
+        const turnIds = await this.#lifecycle.turnIds(loopId);
+        let modelTurnCount = await this.#lifecycle.modelTurnCount(loopId);
+        let invalidEmissionRecoveryEntryId = null;
+        // Per-loop AbortController for scheme-side cancellation propagation.
+        // Chained from the caller's `signal` so an external abort cascades.
+        const loopAbort = new AbortController();
+        if (signal !== undefined) {
+            if (signal.aborted)
+                loopAbort.abort(signal.reason);
+            else
+                signal.addEventListener("abort", () => loopAbort.abort(signal.reason), { once: true });
+        }
+        this.#loopAborts.set(loopId, loopAbort);
+        // {§operator-config-loop-timeout} — the wall-clock budget. Expiry aborts the loop signal, so a
+        // mid-flight provider call (generate rides this signal) and in-flight spawns tear down; the
+        // loop terminates 504 (kin to the exec <T> reap's 504, {§exec-timeout}) — a legible engine
+        // terminal, never an outside kill. unref'd: the wall never holds the process open.
+        const wall = setTimeout(() => loopAbort.abort(LOOP_TIMEOUT_REASON), readLoopTimeoutMs());
+        wall.unref();
+        const timedOut = () => loopAbort.signal.aborted && loopAbort.signal.reason === LOOP_TIMEOUT_REASON;
+        const ruleTimeout = async () => {
+            const failure = Results.failure("engine:rails", "loop-timeout", 504, `The loop exceeded its wall-clock deadline after ${modelTurnCount} model turns.`, {}, {
+                turns: modelTurnCount,
+                stage: "loop",
+                retryable: false
+            });
+            const result = await this.#lifecycle.finish(loopId, failure);
+            if (result === null)
+                throw new Error(`loop ${loopId} became terminal before timeout settlement`);
+            cleanup("forceful", "loop_timeout");
+            return { turnIds, result, hitMaxTurns: false, reason: "loop_timeout" };
+        };
+        // Cleanup splits by termination kind:
+        // - "graceful" (SEND signal 202 Accepted): in-flight streaming-scheme spawns
+        //   are ALLOWED to outlive the loop — they complete naturally, write final
+        //   channel state, and wake-on-completion (E.4) opens a fresh loop. 202 is
+        //   the only terminal that means "keep my async work."
+        // - "forceful" (SEND signal 200 done, max_turns, strike, cancel, context-envelope rejection, 4xx/5xx):
+        //   fire the loop-level abort so leftover spawns tear down. "Done" reaps.
+        const cleanup = (kind, reason) => {
+            clearTimeout(wall);
+            if (kind === "forceful" && !loopAbort.signal.aborted) {
+                loopAbort.abort(reason ?? "loop_forceful_termination");
+            }
+            this.#loopAborts.delete(loopId);
+            this.#strikes.delete(loopId);
+            this.#notices.delete(loopId);
+        };
+        while (true) {
+            const row = await this.#db.engine_loop_status.get({ loop_id: loopId });
+            if (row === undefined)
+                throw new Error(`Engine.runLoop: loop ${loopId} not found`);
+            if (row.status === 100) {
+                // NOT a terminal — a wake re-queued this loop while its own live drain was
+                // between turns (a child concluded in the gap between our 202 write and this
+                // check, {§worker-lifecycle-wake-requeue-not-terminal}). The wake's intent is KEEP
+                // RUNNING: re-claim atomically and continue — the injected prompt is already
+                // this loop's next turn. Returning it as "external" broadcast a QUEUED loop
+                // as a terminal result with status 100 — the delegation-policy race.
+                await this.#db.engine_reclaim_queued_loop.run({ loop_id: loopId });
+                continue; // claimed (or a racer flipped it first — the re-read decides)
+            }
+            if (row.status !== 102) {
+                // Only 202 (Accepted) lets spawns outlive — it IS the async wake
+                // contract (E.4). Every other terminal, 200 included, reaps: "done"
+                // must not leak running execs. Trust the code's declared intent.
+                cleanup(row.status === 202 ? "graceful" : "forceful", `loop_terminal_${row.status}`);
+                if (row.status === 202) {
+                    return { turnIds, result: { status: 202 }, hitMaxTurns: false, reason: "external" };
+                }
+                const result = await this.#lifecycle.result(loopId);
+                if (result === null) {
+                    throw new Error(`terminal loop ${loopId} status ${row.status} has no operation result`);
+                }
+                return { turnIds, result, hitMaxTurns: false, reason: "external" };
+            }
+            // Durable disposition outranks a later process-local cancellation observation.
+            // SEND may commit 202 immediately before daemon shutdown aborts this drain; reading
+            // the abort first launders that lawful park into 499 under load. Only a still-running
+            // 102 loop can be cancelled or time out at this boundary.
+            if (timedOut())
+                return await ruleTimeout();
+            signal?.throwIfAborted();
+            if (maxTurns >= 0 && modelTurnCount >= maxTurns) {
+                const failure = Results.failure("engine:rails", "max-turns", 429, `The configured turn ceiling (${maxTurns}) is exhausted.`, {}, {
+                    maximumTurns: maxTurns,
+                    stage: "loop",
+                    retryable: false
+                });
+                const result = await this.#lifecycle.finish(loopId, failure);
+                if (result === null)
+                    throw new Error(`loop ${loopId} became terminal before max-turn settlement`);
+                cleanup("forceful", "max_turns");
+                return { turnIds, result, hitMaxTurns: true, reason: "max_turns" };
+            }
+            const execHandler = this.#schemes.get("exec");
+            // {§exec-hold-until-concluded} — hold matching runtime/effect
+            // streams until conclusion or the fail-open cap, then resume the
+            // ordinary cycle without altering stream state.
+            const holdSet = new Set((process.env.PLURNK_SERVICE_EXEC_HOLD ?? "").split(",").map((x) => x.trim()).filter((x) => x.length > 0));
+            const holdCapMs = Number(process.env.PLURNK_SERVICE_EXEC_HOLD_MS ?? "300000");
+            if (holdSet.size > 0 && holdCapMs > 0 && execHandler?.hasActiveHoldSpawns !== undefined) {
+                const holdStart = Date.now();
+                while (execHandler.hasActiveHoldSpawns(workerId, holdSet) && Date.now() - holdStart < holdCapMs) {
+                    await delay(150, undefined, { signal });
+                }
+            }
+            let turn;
+            const releaseWorkspace = await this.#acquireWorkspaceTurn(workspaceId, workerId);
+            try {
+                await this.#workspaceTurnStarting?.({ workspaceId, workerId, loopId });
+                turn = await observed(// {§observability-boundary}
+                "loop.turn", { workerId, "loop.id": loopId }, async (span) => {
+                    const t = await this.#runTurn({
+                        provider, childProvider, messages, recap, workspaceId, workerId, loopId, signal, onDispatch, onSettled,
+                        turnNumber: modelTurnCount + 1, maxTurns,
+                        invalidEmissionRecoveryEntryId
+                    });
+                    span.setAttribute("turn.id", t.turnId);
+                    span.setAttribute("turn.producer", t.producer);
+                    span.setAttribute("turn.kind", t.kind);
+                    return t;
+                });
+            }
+            catch (err) {
+                // The wall fired mid-turn — the abort tore the turn down (generate rides the loop
+                // signal); rule the legible 504, never a generic drain error.
+                if (timedOut())
+                    return await ruleTimeout();
+                throw err;
+            }
+            finally {
+                releaseWorkspace();
+            }
+            turnIds.push(...turn.createdTurnIds);
+            // {§overflow-turn-only} — packetless kernel chronology is not a
+            // model attempt and never enters emission or strike accounting.
+            if (turn.kind === "overflow") {
+                if (turn.curationFailure !== undefined) {
+                    const result = await this.#lifecycle.finish(loopId, turn.curationFailure);
+                    if (result === null)
+                        throw new Error(`loop ${loopId} became terminal before token-overflow settlement`);
+                    cleanup("forceful", "token_budget_overflow");
+                    return { turnIds, result, hitMaxTurns: false, reason: "token_budget" };
+                }
+                continue;
+            }
+            modelTurnCount++;
+            // {§engine-rails} Contract Strikes: every emission exhaustion is one
+            // frame-contract violation. The next turn is always informed (it carries
+            // the rejected emission), and the strike rail — not a bespoke terminal —
+            // decides how many consecutive violations the loop survives.
+            if (turn.emissionExhausted) {
+                if (turn.rejectedModelEntryId === undefined) {
+                    throw new Error("an invalid-emission recovery requires its rejected emissionAttempt identity");
+                }
+                invalidEmissionRecoveryEntryId = turn.rejectedModelEntryId;
+            }
+            else {
+                invalidEmissionRecoveryEntryId = null;
+            }
+            // {§provider-surface-capacity}: the provider rejected the changed request for capacity.
+            if (turn.capacityHardStop) {
+                if (turn.capacityFailure === undefined) {
+                    throw new Error("a provider-capacity stop requires its exact failure");
+                }
+                const result = await this.#lifecycle.finish(loopId, turn.capacityFailure);
+                if (result === null)
+                    throw new Error(`loop ${loopId} became terminal before provider-capacity settlement`);
+                cleanup("forceful", "provider_capacity");
+                return { turnIds, result, hitMaxTurns: false, reason: "provider_capacity" };
+            }
+            if (turn.providerParked) {
+                // {§provider-recovery} — the provider stayed unavailable past the recovery budget:
+                // the loop parks like a [202] wait, spawns outlive it, and the ordinary wake resumes it.
+                if (!await this.#lifecycle.park(loopId))
+                    throw new Error(`loop ${loopId} could not park after provider recovery`);
+                cleanup("graceful", "provider_unavailable");
+                return { turnIds, result: { status: 202 }, hitMaxTurns: false, reason: "provider_unavailable" };
+            }
+            // {§engine-rails} — per-turn strike accounting (cycle detection,
+            // steer coupling, hard operation outcomes). StrikeRail owns the
+            // bookkeeping; runLoop owns abandonment.
+            const verdict = this.#strikes.assess(loopId, {
+                fingerprint: turn.fingerprint,
+                outcomes: turn.outcomes,
+                steerStruck: turn.steerStruck,
+                minCycles, maxCyclePeriod, maxStrikes
+            });
+            if (verdict.thresholdCrossed) {
+                // {§engine-rails} — the source on the crossing turn classifies
+                // the engine verdict: cycle-driven is 508; every other strike is 500.
+                const status = verdict.cycleDetected ? 508 : 500;
+                const failure = Results.failure("engine:rails", "strike-threshold", status, verdict.cycleDetected
+                    ? `The loop reached its strike threshold after ${modelTurnCount} model turns because its operation pattern repeated.`
+                    : `The loop reached its strike threshold after ${modelTurnCount} model turns because consecutive turns failed.`, {}, {
+                    turns: modelTurnCount,
+                    stage: "loop",
+                    retryable: false
+                });
+                const result = await this.#lifecycle.finish(loopId, failure);
+                if (result === null)
+                    throw new Error(`loop ${loopId} became terminal before strike settlement`);
+                cleanup("forceful", "strike_threshold");
+                return { turnIds, result, hitMaxTurns: false, reason: "strike_threshold" };
+            }
+        }
+    }
+}
+//# sourceMappingURL=LoopDriver.js.map

package/dist/core/LoopDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoopDriver.js","sourceRoot":"","sources":["../../src/core/LoopDriver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,OAA8B,MAAM,cAAc,CAAC;AAI1D,OAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAI/C,MAAM,cAAc,GAAG,GAAW,EAAE;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACtE,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC7D,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAU,EAAE;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,eAAe,CAAC,6BAA6B,EAAE,uBAAuB,CAAC,CAAC;AAEhH,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,gGAAgG;AAChG,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAEzC,MAAM,CAAC,OAAO,OAAO,UAAU;IAClB,WAAW,CAA+B;IAC1C,GAAG,CAAK;IACR,UAAU,CAAgB;IAC1B,QAAQ,CAAiB;IACzB,QAAQ,CAAgB;IACxB,QAAQ,CAAa;IACrB,qBAAqB,CAAuB;IAC5C,sBAAsB,CAAoC;IAC1D,QAAQ,CAAoF;IAErG,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,OAAO,EAUvH;QACG,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;QAClD,IAAI,CAAC,sBAAsB,GAAG,qBAAqB,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EACV,QAAQ,EAAE,aAAa,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EACvF,QAAQ,GAAG,EAAE,EAAE,UAAU,GAAG,cAAc,EAAE,EAC5C,SAAS,GAAG,eAAe,CAAC,2BAA2B,EAAE,kBAAkB,CAAC,EAC5E,cAAc,GAAG,eAAe,CAAC,iCAAiC,EAAE,wBAAwB,CAAC,EAC7F,MAAM,EAAE,UAAU,EAAE,SAAS,EAchC;QACG,4EAA4E;QAC5E,+EAA+E;QAC/E,qBAAqB;QACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,cAAc,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClE,IAAI,8BAA8B,GAAkB,IAAI,CAAC;QACzD,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,OAAO;gBAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;gBAC9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAExC,+FAA+F;QAC/F,4FAA4F;QAC5F,2FAA2F;QAC3F,mFAAmF;QACnF,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,GAAY,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,mBAAmB,CAAC;QAC5G,MAAM,WAAW,GAAG,KAAK,IAAwG,EAAE;YAC/H,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC3B,cAAc,EACd,cAAc,EACd,GAAG,EACH,mDAAmD,cAAc,eAAe,EAChF,EAAE,EACF;gBACI,KAAK,EAAE,cAAc;gBACrB,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,KAAK;aAAE,CACzB,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7D,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,4CAA4C,CAAC,CAAC;YACjG,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAC3E,CAAC,CAAC;QAEF,sCAAsC;QACtC,6EAA6E;QAC7E,2EAA2E;QAC3E,2EAA2E;QAC3E,uDAAuD;QACvD,uGAAuG;QACvG,0EAA0E;QAC1E,MAAM,OAAO,GAAG,CAAC,IAA6B,EAAE,MAAe,EAAQ,EAAE;YACrE,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnD,SAAS,CAAC,KAAK,CAAC,MAAM,IAAI,2BAA2B,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC;QAEF,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3F,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,YAAY,CAAC,CAAC;YACnF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrB,2EAA2E;gBAC3E,6EAA6E;gBAC7E,mFAAmF;gBACnF,6EAA6E;gBAC7E,4EAA4E;gBAC5E,qEAAqE;gBACrE,MAAM,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnE,SAAS,CAAC,8DAA8D;YAC5E,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrB,iEAAiE;gBACjE,oEAAoE;gBACpE,iEAAiE;gBACjE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,iBAAiB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACrB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;gBACxF,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,WAAW,GAAG,CAAC,MAAM,0BAA0B,CAAC,CAAC;gBAC5F,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YACvE,CAAC;YAED,+EAA+E;YAC/E,oFAAoF;YACpF,sFAAsF;YACtF,0DAA0D;YAC1D,IAAI,QAAQ,EAAE;gBAAE,OAAO,MAAM,WAAW,EAAE,CAAC;YAC3C,MAAM,EAAE,cAAc,EAAE,CAAC;YAEzB,IAAI,QAAQ,IAAI,CAAC,IAAI,cAAc,IAAI,QAAQ,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC3B,cAAc,EACd,WAAW,EACX,GAAG,EACH,gCAAgC,QAAQ,iBAAiB,EACzD,EAAE,EACF;oBACI,YAAY,EAAE,QAAQ;oBACtB,KAAK,EAAE,MAAM;oBACb,SAAS,EAAE,KAAK;iBAAE,CACzB,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC7D,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,6CAA6C,CAAC,CAAC;gBAClG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACvE,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAsG,CAAC;YACnJ,8DAA8D;YAC9D,iEAAiE;YACjE,gDAAgD;YAChD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAClI,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,QAAQ,CAAC,CAAC;YAC9E,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,WAAW,EAAE,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACtF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;oBAC9F,MAAM,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC5C,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC;YACT,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACjF,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvE,IAAI,GAAG,MAAM,QAAQ,CAAE,4BAA4B;gBAC/C,WAAW,EACX,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAC/B,KAAK,EAAE,IAAI,EAAE,EAAE;oBACX,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;wBAC1B,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS;wBACtG,UAAU,EAAE,cAAc,GAAG,CAAC,EAAE,QAAQ;wBACxC,8BAA8B;qBAAE,CAAC,CAAC;oBACtC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;oBACvC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC/C,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;oBACvC,OAAO,CAAC,CAAC;gBACb,CAAC,CACJ,CAAC;YACN,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,kFAAkF;gBAClF,8DAA8D;gBAC9D,IAAI,QAAQ,EAAE;oBAAE,OAAO,MAAM,WAAW,EAAE,CAAC;gBAC3C,MAAM,GAAG,CAAC;YACd,CAAC;oBAAS,CAAC;gBACP,gBAAgB,EAAE,CAAC;YACvB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAErC,gEAAgE;YAChE,gEAAgE;YAChE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;oBAC1E,IAAI,MAAM,KAAK,IAAI;wBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,mDAAmD,CAAC,CAAC;oBACxG,OAAO,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;oBAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;gBAC3E,CAAC;gBACD,SAAS;YACb,CAAC;YACD,cAAc,EAAE,CAAC;YAEjB,qEAAqE;YACrE,yEAAyE;YACzE,yEAAyE;YACzE,6DAA6D;YAC7D,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;oBAC1C,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;gBACnG,CAAC;gBACD,8BAA8B,GAAG,IAAI,CAAC,oBAAoB,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACJ,8BAA8B,GAAG,IAAI,CAAC;YAC1C,CAAC;YAED,wFAAwF;YACxF,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBAC3E,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC1E,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,sDAAsD,CAAC,CAAC;gBAC3G,OAAO,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;gBACzC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;YAChF,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,mFAAmF;gBACnF,yFAAyF;gBACzF,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,yCAAyC,CAAC,CAAC;gBAClH,OAAO,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;YACpG,CAAC;YAED,iEAAiE;YACjE,gEAAgE;YAChE,yCAAyC;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;gBACzC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,cAAc,EAAE,UAAU;aAAE,CAAC,CAAC;YAC7C,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAC3B,+DAA+D;gBAC/D,sEAAsE;gBACtE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAC3B,cAAc,EACd,kBAAkB,EAClB,MAAM,EACN,OAAO,CAAC,aAAa;oBACjB,CAAC,CAAC,+CAA+C,cAAc,sDAAsD;oBACrH,CAAC,CAAC,+CAA+C,cAAc,gDAAgD,EACnH,EAAE,EACF;oBACI,KAAK,EAAE,cAAc;oBACrB,KAAK,EAAE,MAAM;oBACb,SAAS,EAAE,KAAK;iBAAE,CACzB,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC7D,IAAI,MAAM,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,2CAA2C,CAAC,CAAC;gBAChG,OAAO,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;gBACxC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;YAC/E,CAAC;QACL,CAAC;IACL,CAAC;CAEJ"}

package/dist/core/LoopLifecycle.d.ts

@@ -1,6 +1,6 @@
 import type { Db } from "./Db.ts";
 import { type SchemeResult } from "./results.ts";
-export interface CancelledLoop {
+interface CancelledLoop {
     loopId: number;
     workerId: number;
     result: SchemeResult;
@@ -24,4 +24,5 @@ export default class LoopLifecycle {
     modelTurnCount(loopId: number): Promise<number>;
     cancelTree(workerId: number, reason: string, includeRoot: boolean): Promise<CancelledTree>;
 }
+export {};
 //# sourceMappingURL=LoopLifecycle.d.ts.map

package/dist/core/LoopLifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoopLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/LoopLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1D,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;;IAG9B,YAAY,EAAE,EAAE,EAAE,EAEjB;IAMD,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3C;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3C;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3C;IAEK,MAAM,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAO,GACjD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa9B;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5C;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAQzD;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK/C;IAEK,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpD;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmC/F;CACJ"}
+{"version":3,"file":"LoopLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/LoopLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1D,UAAU,aAAa;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;;IAG9B,YAAY,EAAE,EAAE,EAAE,EAEjB;IAMD,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3C;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3C;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3C;IAEK,MAAM,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAO,GACjD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa9B;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5C;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAQzD;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK/C;IAEK,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpD;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmC/F;CACJ"}

package/dist/core/MembershipMaterialization.d.ts

@@ -0,0 +1,7 @@
+import type { PlurnkSchemeContext } from "./scheme-types.ts";
+import type { FsDivergence } from "./git-membership.ts";
+export default class MembershipMaterialization {
+    #private;
+    static materializeMember(pathname: string, root: string, ctx: PlurnkSchemeContext, identities: Map<string, Promise<string>>): Promise<FsDivergence | null>;
+}
+//# sourceMappingURL=MembershipMaterialization.d.ts.map

package/dist/core/MembershipMaterialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MembershipMaterialization.d.ts","sourceRoot":"","sources":["../../src/core/MembershipMaterialization.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,OAAO,KAAK,EAAE,YAAY,EAA4C,MAAM,qBAAqB,CAAC;AAqClG,MAAM,CAAC,OAAO,OAAO,yBAAyB;;IAU1C,OAAa,iBAAiB,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GACzC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqI9B;CAoKJ"}

package/dist/core/MembershipMaterialization.js

@@ -0,0 +1,283 @@
+// Materializing one tracked member from disk into its body channel, text or binary. Split out of GitMembership.
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { MimetypeInputLimitError } from "@plurnk/plurnk-mimetypes";
+import { MimetypeBinary } from "../content/index.js";
+import Owner from "./Owner.js";
+import EntryCrud from "../schemes/_entry-crud.js";
+import FileMaterialization from "./file-materialization.js";
+const ABSENT_SIG = "absent";
+const sourceProjectionFrom = (encoded) => {
+    const attributes = JSON.parse(encoded);
+    if (attributes === null || typeof attributes !== "object" || Array.isArray(attributes)) {
+        throw new TypeError("GitMembership: entry attributes must be a JSON object");
+    }
+    const candidate = attributes.sourceProjection;
+    if (candidate === undefined)
+        return null;
+    if (candidate === null || typeof candidate !== "object" || Array.isArray(candidate)) {
+        throw new TypeError("GitMembership: sourceProjection must be a JSON object");
+    }
+    const projection = candidate;
+    if (typeof projection.mimetype !== "string"
+        || projection.mimetype.length === 0
+        || typeof projection.identity !== "string"
+        || projection.identity.length === 0
+        || !["projected", "unavailable", "input-limit"].includes(projection.disposition ?? "")) {
+        throw new TypeError("GitMembership: sourceProjection metadata is malformed");
+    }
+    if (projection.facts !== undefined && (projection.facts === null || typeof projection.facts !== "object" || Array.isArray(projection.facts))) {
+        throw new TypeError("GitMembership: sourceProjection facts must be a JSON object");
+    }
+    const hasLimit = Number.isSafeInteger(projection.maximumBytes)
+        && (projection.maximumBytes ?? 0) > 0
+        && Number.isSafeInteger(projection.observedBytes)
+        && (projection.observedBytes ?? 0) > (projection.maximumBytes ?? 0);
+    if ((projection.disposition === "input-limit") !== hasLimit) {
+        throw new TypeError("GitMembership: sourceProjection input-limit evidence is malformed");
+    }
+    return projection;
+};
+export default class MembershipMaterialization {
+    // Materialize a member's model-readable snapshot into a body channel via writeEntry (the
+    // entry-write paradigm) — so it appears in the manifest catalog and is READ-able
+    // (D4/D5). Change-gated: text changes with mtime:size; binary projections also
+    // change when their opaque reader identity changes. A binary source persists
+    // only derived Unicode when its installed handler provides it, otherwise an
+    // empty typed marker ({§membership-source-projection}).
+    // A tracked path missing on disk retains membership but loses its stale
+    // readable channels; its explicit absent signature makes a later
+    // reappearance another observable divergence.
+    static async materializeMember(pathname, root, ctx, identities) {
+        const canonical = join(root, pathname); // pathname is namespace-absolute (`/src/foo.ts`); join roots it at the workspace
+        const commonsId = await Owner.commonsId(ctx.db, ctx.workspaceId);
+        const known = await ctx.db.crud_get_member_sig.get({
+            workspace_id: ctx.workspaceId, owner_id: commonsId, scheme: "file", authority: "", pathname,
+        });
+        // SPEC {§membership-change-gated-sync} — the cheap detect is a stat (mtime:size),
+        // never a content read: a member whose signature matches its last sync is a
+        // no-op (not re-read, re-tokenized, or rewritten). Coverage stays exhaustive
+        // (every member is stat'd); work is proportional to change.
+        let sig;
+        let sourceBytes;
+        try {
+            const st = await stat(canonical);
+            // A directory-shaped member — an embedded-repo boundary the untracked scan lists as
+            // `dir/` (native + iso alike) — is a membership marker: disk truth is a directory,
+            // nothing to materialize. Mirrors missing-on-disk: membership stands, no channel.
+            if (st.isDirectory())
+                return null;
+            sig = `${st.mtimeMs}:${st.size}`;
+            sourceBytes = st.size;
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                if (known === undefined || known.synced_sig === ABSENT_SIG)
+                    return null;
+                const prior = await ctx.db.ops_read_channel.get({
+                    workspace_id: ctx.workspaceId,
+                    owner_id: commonsId,
+                    scheme: "file",
+                    authority: "",
+                    pathname,
+                    channel: "body",
+                });
+                await ctx.db.crud_delete_channels.run({ entry_id: known.id });
+                await ctx.db.crud_mark_member_absent.run({ entry_id: known.id });
+                return prior === undefined ? null : {
+                    pathname,
+                    entryId: known.id,
+                    channel: "body",
+                    before: prior.content,
+                    after: "",
+                };
+            }
+            throw err;
+        }
+        if (known !== undefined && known.synced_sig === sig) {
+            const sourceMaterialization = FileMaterialization.fromAttributes(known.attributes);
+            if (sourceMaterialization !== null) {
+                if (FileMaterialization.matchesCurrent(sourceMaterialization, sourceBytes))
+                    return null;
+            }
+            else {
+                const sourceProjection = sourceProjectionFrom(known.attributes);
+                if (sourceProjection !== null) {
+                    const currentIdentity = await MembershipMaterialization.#projectionIdentity(sourceProjection.mimetype, ctx.mimetypes, identities);
+                    if (currentIdentity === sourceProjection.identity)
+                        return null;
+                }
+            }
+        }
+        const mimetype = await MembershipMaterialization.#detectMimetype(canonical, ctx.mimetypes);
+        const sourceMaterialization = FileMaterialization.classify(sourceBytes);
+        if (sourceMaterialization.disposition === "input-limit") {
+            return MembershipMaterialization.#materializeLimited(pathname, mimetype, sig, known?.synced_sig !== sig, known?.synced_sig === ABSENT_SIG, sourceMaterialization, ctx);
+        }
+        if (await MimetypeBinary.isBinaryMimetype(mimetype, ctx.mimetypes)) {
+            return MembershipMaterialization.#materializeBinary(pathname, { path: canonical }, mimetype, sig, known?.synced_sig !== sig, known?.synced_sig === ABSENT_SIG, ctx, identities);
+        }
+        let buf;
+        try {
+            buf = await readFile(canonical);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return null;
+            throw err;
+        }
+        // {§membership-binary-sniff} — the extension map can lie (.wasm fell through to
+        // the markdown DEFAULT and a 3.3MB blob entered the corpus as prose, three copies,
+        // ~10M tokens). NUL bytes in the head are binary truth regardless of the label:
+        // re-stamp octet-stream and take the same bounded projection-or-marker arm.
+        if (buf.subarray(0, 8192).includes(0)) {
+            return MembershipMaterialization.#materializeBinary(pathname, { content: buf, hint: "application/octet-stream" }, "application/octet-stream", sig, known?.synced_sig !== sig, known?.synced_sig === ABSENT_SIG, ctx, identities);
+        }
+        const content = buf.toString("utf8");
+        // {§env-delta-filesystem-narration} — capture the prior snapshot before
+        // materialization replaces it, then journal the resulting net span.
+        const diskChanged = known?.synced_sig !== sig;
+        const prior = diskChanged
+            ? await ctx.db.ops_read_channel.get({
+                workspace_id: ctx.workspaceId, owner_id: commonsId, scheme: "file", authority: "", pathname, channel: "body",
+            })
+            : undefined;
+        const result = await EntryCrud.writeEntry({ authority: "", pathname }, {
+            channels: { body: { content, mimetype } },
+            attributes: FileMaterialization.attributes(sourceMaterialization),
+        }, ctx, "file", commonsId);
+        if (result.entryId !== null)
+            await ctx.db.crud_set_synced_sig.run({ entry_id: result.entryId, synced_sig: sig });
+        const changed = prior !== undefined && prior.content !== content;
+        if ((changed || known?.synced_sig === ABSENT_SIG) && result.entryId !== null) {
+            return { pathname, entryId: result.entryId, channel: "body", before: prior?.content ?? "", after: content };
+        }
+        return null;
+    }
+    static async #materializeBinary(pathname, input, mimetype, sig, diskChanged, previouslyAbsent, ctx, identities) {
+        const mimetypes = ctx.mimetypes;
+        if (mimetypes === undefined)
+            throw new Error("GitMembership: configured mimetype registry is required");
+        let content = "";
+        let outputMimetype = mimetype;
+        let metadata;
+        try {
+            const projected = await mimetypes.projectReadable(input);
+            if (projected === null) {
+                metadata = {
+                    mimetype,
+                    identity: await MembershipMaterialization.#projectionIdentity(mimetype, mimetypes, identities),
+                    disposition: "unavailable",
+                };
+            }
+            else {
+                content = projected.content;
+                outputMimetype = "text/markdown";
+                metadata = {
+                    mimetype: projected.sourceMimetype,
+                    identity: projected.projectionIdentity,
+                    disposition: "projected",
+                    ...(projected.facts !== null && typeof projected.facts === "object" && !Array.isArray(projected.facts)
+                        ? { facts: projected.facts }
+                        : {}),
+                };
+            }
+        }
+        catch (cause) {
+            if (!(cause instanceof MimetypeInputLimitError))
+                throw cause;
+            metadata = {
+                mimetype,
+                identity: await MembershipMaterialization.#projectionIdentity(mimetype, mimetypes, identities),
+                disposition: "input-limit",
+                maximumBytes: cause.maximumBytes,
+                observedBytes: cause.observedBytes,
+            };
+        }
+        const prior = diskChanged && metadata.disposition === "projected"
+            ? await ctx.db.ops_read_channel.get({
+                workspace_id: ctx.workspaceId,
+                owner_id: await Owner.commonsId(ctx.db, ctx.workspaceId),
+                scheme: "file",
+                authority: "",
+                pathname,
+                channel: "body",
+            })
+            : undefined;
+        const result = await EntryCrud.writeEntry({ authority: "", pathname }, {
+            channels: { body: { content, mimetype: outputMimetype } },
+            attributes: { sourceProjection: metadata },
+        }, ctx, "file", await Owner.commonsId(ctx.db, ctx.workspaceId));
+        if (result.entryId !== null) {
+            await ctx.db.crud_set_synced_sig.run({ entry_id: result.entryId, synced_sig: sig });
+        }
+        const changed = prior !== undefined && prior.content !== content;
+        if ((changed || previouslyAbsent) && result.entryId !== null) {
+            return {
+                pathname,
+                entryId: result.entryId,
+                channel: "body",
+                before: prior?.content ?? "",
+                after: content,
+            };
+        }
+        return null;
+    }
+    static #projectionIdentity(mimetype, mimetypes, identities) {
+        if (mimetypes === undefined)
+            throw new Error("GitMembership: configured mimetype registry is required");
+        let identity = identities.get(mimetype);
+        if (identity === undefined) {
+            identity = mimetypes.projectionIdentity(mimetype);
+            identities.set(mimetype, identity);
+        }
+        return identity;
+    }
+    // Detect a tracked file's mimetype (mirrors File.detectFileMimetype) through
+    // the configured registry, normalizing auto-derived text/plain to the text
+    // primitive.
+    static async #detectMimetype(canonical, mimetypes) {
+        if (mimetypes === undefined)
+            throw new Error("GitMembership: configured mimetype registry is required");
+        const detected = await mimetypes.detect({ path: canonical });
+        return MimetypeBinary.normalizeAutoTextMimetype(detected);
+    }
+    static async #materializeLimited(pathname, mimetype, sig, diskChanged, previouslyAbsent, metadata, ctx) {
+        const commonsId = await Owner.commonsId(ctx.db, ctx.workspaceId);
+        const prior = diskChanged
+            ? await ctx.db.ops_read_channel.get({
+                workspace_id: ctx.workspaceId,
+                owner_id: commonsId,
+                scheme: "file",
+                authority: "",
+                pathname,
+                channel: "body",
+            })
+            : undefined;
+        const result = await EntryCrud.writeEntry({ authority: "", pathname }, {
+            channels: {
+                body: {
+                    content: "",
+                    mimetype,
+                    producerResult: FileMaterialization.failure(pathname, metadata),
+                },
+            },
+            attributes: FileMaterialization.attributes(metadata),
+        }, ctx, "file", commonsId);
+        if (result.entryId !== null) {
+            await ctx.db.crud_set_synced_sig.run({ entry_id: result.entryId, synced_sig: sig });
+        }
+        const changed = prior !== undefined && prior.content !== "";
+        if ((changed || previouslyAbsent) && result.entryId !== null) {
+            return {
+                pathname,
+                entryId: result.entryId,
+                channel: "body",
+                before: prior?.content ?? "",
+                after: "",
+            };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=MembershipMaterialization.js.map

package/dist/core/MembershipMaterialization.js.map

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