@plurnk/plurnk-service 1.3.12 → 1.4.0

package/dist/schemes/_search-index.js

@@ -0,0 +1,326 @@
+// Search-index materialization for every readable workspace body. Entries
+// and logs attach to the same immutable, content-addressed derivation artifacts;
+// FTS, vectors, and graph relationships consume those artifacts uniformly.
+import { isMimetypeInputError } from "@plurnk/plurnk-mimetypes";
+import { createHash } from "node:crypto";
+import { availableParallelism } from "node:os";
+import EntryGraph from "./_entry-graph.js";
+import EntrySemantic from "./_entry-semantic.js";
+import LogBody from "../core/LogBody.js";
+import matchSearchExclusion from "./_search-exclusion.js";
+const NO_PROJECTION_IDENTITY = "projection:none";
+export default class SearchIndex {
+    // The index materializes one immutable artifact per exact READ body and
+    // configuration identity, then atomically attaches resource addresses to it.
+    // Cancellation leaves a building artifact unattached for retry; a typed
+    // invalid-source failure is terminal and observable so
+    // one malformed specimen cannot hold workspace readiness hostage.
+    // Hash-keyed chains serialize concurrent workspace warm requests for the same
+    // artifact while distinct artifacts remain parallel.
+    static #deriveChains = new Map();
+    static async #deriveOne(ctx, r, hash, semanticPlan, searchExcluded, binary, callbacks = {}) {
+        const prior = SearchIndex.#deriveChains.get(hash) ?? Promise.resolve();
+        const run = prior.then(() => SearchIndex.#deriveOneUnlocked(ctx, r, hash, semanticPlan, searchExcluded, binary, callbacks));
+        const tail = run.catch(() => { }); // the chain survives a failed link; deriveOne's caller sees the rejection
+        SearchIndex.#deriveChains.set(hash, tail);
+        void tail.finally(() => {
+            if (SearchIndex.#deriveChains.get(hash) === tail)
+                SearchIndex.#deriveChains.delete(hash);
+        });
+        return run;
+    }
+    static async #deriveOneUnlocked(ctx, r, hash, semanticPlan, searchExcluded, binary, callbacks) {
+        const { db, mimetypes } = ctx;
+        if (mimetypes === undefined)
+            throw new Error("deriveOne: ctx.mimetypes is required");
+        const attach = async () => {
+            if (r.attachment === "entry") {
+                await db.graph_set_deep_hash.run({ entry_id: r.id, deep_hash: hash });
+            }
+            else {
+                await db.log_set_deep_hash.run({ log_entry_id: r.id, deep_hash: hash });
+            }
+        };
+        let artifact = await db.derivation_get.get({ deep_hash: hash });
+        if (artifact?.state === "complete") {
+            await attach();
+            return;
+        }
+        if (artifact === undefined) {
+            artifact = await db.derivation_create.get({ deep_hash: hash });
+        }
+        if (artifact === undefined)
+            throw new Error(`failed to create derivation artifact ${hash}`);
+        const derivationId = artifact.id;
+        const attachComplete = async (disposition, reason = null) => {
+            await db.derivation_complete.run({ derivation_id: derivationId, disposition, reason });
+            await attach();
+        };
+        const wantGraph = r.content.length > 0 && !binary;
+        if (searchExcluded !== undefined) {
+            await EntryGraph.populateFrom(db, derivationId, [], []);
+            await EntrySemantic.indexFts(db, derivationId, "");
+            await EntrySemantic.indexEmbedding(db, derivationId, [], undefined);
+            await attachComplete("excluded", searchExcluded);
+            return;
+        }
+        if (!wantGraph) {
+            await EntryGraph.populateFrom(db, derivationId, [], []);
+            await EntrySemantic.indexFts(db, derivationId, "");
+            await EntrySemantic.indexEmbedding(db, derivationId, [], undefined);
+            await attachComplete("nonsemantic", r.content.length === 0 ? "empty" : "binary");
+            return;
+        }
+        let result;
+        try {
+            result = await mimetypes.process({ content: r.content, hint: r.mimetype, path: r.pathname }, { channels: ["symbols", "references"] });
+        }
+        catch (error) {
+            if (ctx.signal?.aborted === true || !isMimetypeInputError(error))
+                throw error;
+            await EntryGraph.populateFrom(db, derivationId, [], []);
+            await EntrySemantic.indexFts(db, derivationId, "");
+            await EntrySemantic.indexEmbedding(db, derivationId, [], undefined);
+            await attachComplete("failed", error instanceof Error ? error.message : String(error));
+            return;
+        }
+        for (const notice of result.notices ?? [])
+            callbacks.onNotice?.(notice);
+        // Persistence and embedding operations are outside typed input-failure
+        // containment. An internal/operational failure leaves the artifact
+        // building and propagates so a later warm can retry; it is never
+        // mislabeled as one malformed resource.
+        await EntryGraph.populateFrom(db, derivationId, result.symbols ?? [], result.references ?? []);
+        // The stored default body is the exact text READ exposes and therefore the
+        // only honest coordinate space for FTS and vectors. Acquisition schemes
+        // project noisy source material before writing that body (HTTP retains raw
+        // HTML in an auxiliary channel); authored files remain verbatim data.
+        const semanticSource = r.content;
+        await EntrySemantic.indexFts(db, derivationId, semanticSource);
+        // Size rejection is vector-only: membership, READ, graph, and FTS remain exhaustive.
+        if (EntrySemantic.embedSizeRejection(semanticSource) !== null) {
+            await EntrySemantic.indexEmbedding(db, derivationId, [], undefined);
+            await attachComplete("lexical", "max_embed_size");
+            return;
+        }
+        if (semanticPlan.info === null) {
+            await EntrySemantic.indexEmbedding(db, derivationId, [], undefined);
+            await attachComplete("lexical", "embedder_unavailable");
+            return;
+        }
+        const { chunks, model } = await EntrySemantic.deriveEmbeddings(semanticPlan, semanticSource, result.symbols ?? [], undefined, undefined, ctx.signal, callbacks.onProgress);
+        await EntrySemantic.indexEmbedding(db, derivationId, chunks, model);
+        await attachComplete(chunks.length > 0 ? "vector" : "nonsemantic", chunks.length > 0 ? null : "no_embedding_content");
+    }
+    static async maintain(ctx) {
+        const { db, workspaceId, mimetypes } = ctx;
+        if (mimetypes === undefined)
+            throw new Error("SearchIndex.maintain: ctx.mimetypes is required");
+        const progressSteps = Number(process.env.PLURNK_SERVICE_DERIVE_PROGRESS_STEPS);
+        if (!Number.isInteger(progressSteps) || progressSteps <= 0) {
+            throw new RangeError(`PLURNK_SERVICE_DERIVE_PROGRESS_STEPS must be a positive integer; got ${JSON.stringify(process.env.PLURNK_SERVICE_DERIVE_PROGRESS_STEPS)}`);
+        }
+        const progressHeartbeatMs = Number(process.env.PLURNK_SERVICE_DERIVE_PROGRESS_HEARTBEAT_MS);
+        if (!Number.isInteger(progressHeartbeatMs) || progressHeartbeatMs <= 0) {
+            throw new RangeError(`PLURNK_SERVICE_DERIVE_PROGRESS_HEARTBEAT_MS must be a positive integer; got ${JSON.stringify(process.env.PLURNK_SERVICE_DERIVE_PROGRESS_HEARTBEAT_MS)}`);
+        }
+        // Validate global graph persistence tuning before resource-local
+        // derivation containment can classify a handler failure.
+        EntryGraph.storeBatch();
+        const entryRows = await db.engine_list_workspace_entries.all({ workspace_id: workspaceId });
+        const logRows = await db.log_derivation_rows.all({ workspace_id: workspaceId });
+        // One resolved plan supplies both chunking and the configuration identity
+        // for every entry in this pass ({§semantic-embed-dedup}).
+        const semanticPlan = await EntrySemantic.prepareEmbeddings(mimetypes);
+        const deepCfgSig = semanticPlan.signature;
+        const projectionIdentities = new Map();
+        const projectionIdentityFor = (mimetype, content, binary, searchExcluded) => {
+            if (searchExcluded !== undefined || content.length === 0 || binary) {
+                return Promise.resolve(NO_PROJECTION_IDENTITY);
+            }
+            const cached = projectionIdentities.get(mimetype);
+            if (cached !== undefined)
+                return cached;
+            const identity = mimetypes.projectionIdentity(mimetype);
+            projectionIdentities.set(mimetype, identity);
+            return identity;
+        };
+        // No embedder (absent OR PLURNK_SERVICE_EMBED_DISABLE) is represented by
+        // the same plan and `embed:none` signature; derivation keeps only graph/FTS.
+        // Compute the changed-resource worklist before scheduling so aggregate
+        // progress has a stable total. {§derivation-dedup-parallel}
+        const pending = [];
+        for (const r of entryRows) {
+            if (r.channel !== "body")
+                continue; // derivation fires on the body channel only
+            const searchExcluded = matchSearchExclusion(r);
+            const dispositionIdentity = searchExcluded === undefined ? "included" : `excluded:${searchExcluded}`;
+            const binary = (await mimetypes.classify(r.mimetype)).binary;
+            const projectionIdentity = await projectionIdentityFor(r.mimetype, r.content, binary, searchExcluded);
+            const hash = derivationHash({
+                content: r.content,
+                mimetype: r.mimetype,
+                binary,
+                projectionIdentity,
+                semanticIdentity: deepCfgSig,
+                dispositionIdentity,
+            });
+            if (hash !== r.deep_hash)
+                pending.push({
+                    r: {
+                        id: r.entry_id,
+                        attachment: "entry",
+                        pathname: r.pathname,
+                        content: r.content,
+                        mimetype: r.mimetype,
+                    },
+                    hash,
+                    searchExcluded,
+                    binary,
+                }); // unchanged since last derivation → deep rows persist
+        }
+        for (const row of logRows) {
+            const projection = LogBody.resolve({
+                op: row.op,
+                tx: row.tx,
+                rx: row.rx,
+                mimetypeTx: row.mimetype_tx,
+                mimetypeRx: row.mimetype_rx,
+            });
+            const binary = (await mimetypes.classify(projection.mimetype)).binary;
+            const projectionIdentity = await projectionIdentityFor(projection.mimetype, projection.content, binary, undefined);
+            const hash = derivationHash({
+                content: projection.content,
+                mimetype: projection.mimetype,
+                binary,
+                projectionIdentity,
+                semanticIdentity: deepCfgSig,
+                dispositionIdentity: "included",
+            });
+            if (hash !== row.deep_hash)
+                pending.push({
+                    r: {
+                        id: row.id,
+                        attachment: "log",
+                        pathname: row.coordinate,
+                        content: projection.content,
+                        mimetype: projection.mimetype,
+                    },
+                    hash,
+                    searchExcluded: undefined,
+                    binary,
+                });
+        }
+        const hasVectorCandidate = semanticPlan.info !== null && pending.some(({ r, searchExcluded, binary }) => searchExcluded === undefined
+            && r.content.length > 0
+            && !binary
+            && EntrySemantic.embedSizeRejection(r.content) === null);
+        if (hasVectorCandidate)
+            EntrySemantic.assertExactChunking(semanticPlan, ctx.pushNotice);
+        // {§derivation-dedup-parallel} — warm smaller projections before an
+        // expensive outlier; ordering never changes exhaustive derivation.
+        pending.sort((a, b) => a.r.content.length - b.r.content.length);
+        const total = pending.length;
+        const step = total > 1 ? Math.max(1, Math.floor(total / progressSteps)) : 0;
+        let completed = 0;
+        const projectionNotices = new Set();
+        const forwardProjectionNotice = (notice) => {
+            const key = JSON.stringify(notice);
+            if (projectionNotices.has(key))
+                return;
+            projectionNotices.add(key);
+            ctx.pushNotice?.(notice);
+        };
+        const tick = () => {
+            completed++;
+            if (step > 0 && (completed === total || completed % step === 0)) {
+                const percent = Math.floor((completed / total) * 100);
+                ctx.pushNotice?.({ source: "engine:derivation", kind: "embed_progress", message: `Indexing repository semantics: ${percent}% (${completed}/${total})`, completed, total, percent, level: "info" });
+            }
+        };
+        // Each derivation identity builds one shared artifact while distinct
+        // artifacts run with bounded concurrency. {§derivation-dedup-parallel}
+        const groups = new Map();
+        for (const p of pending) {
+            const g = groups.get(p.hash);
+            if (g === undefined)
+                groups.set(p.hash, [p]);
+            else
+                g.push(p);
+        }
+        const rawConcurrency = process.env.PLURNK_SERVICE_DERIVE_CONCURRENCY;
+        const cores = availableParallelism();
+        const configuredConcurrency = rawConcurrency === undefined || rawConcurrency.trim() === ""
+            // Entry derivation is a producer tier above the all-core embedding pool.
+            // A square-root fan-out keeps that pool fed without simultaneously
+            // materializing one enormous symbol/chunk graph per host core.
+            ? Math.max(1, Math.floor(Math.sqrt(cores)))
+            : Number(rawConcurrency);
+        if (!Number.isInteger(configuredConcurrency) || configuredConcurrency === 0 || configuredConcurrency < -1) {
+            throw new RangeError(`PLURNK_SERVICE_DERIVE_CONCURRENCY must be -1 (match cores) or a positive integer; got ${JSON.stringify(rawConcurrency)}`);
+        }
+        const concurrency = configuredConcurrency === -1 ? availableParallelism() : configuredConcurrency;
+        let lastHeartbeatAt = 0;
+        const workerPool = async (work) => {
+            let next = 0;
+            const worker = async () => {
+                while (next < work.length) {
+                    if (ctx.signal?.aborted === true)
+                        return;
+                    const group = work[next++];
+                    for (const { r, hash, searchExcluded, binary } of group) {
+                        if (Boolean(ctx.signal?.aborted))
+                            return;
+                        await SearchIndex.#deriveOne(ctx, r, hash, semanticPlan, searchExcluded, binary, {
+                            onNotice: forwardProjectionNotice,
+                            onProgress: (progress) => {
+                                if (step === 0 || progress.total <= 1)
+                                    return;
+                                const milestone = progress.completed === progress.total
+                                    || progress.completed % Math.max(1, Math.floor(progress.total / progressSteps)) === 0;
+                                if (!milestone)
+                                    return;
+                                const now = Date.now();
+                                if (now - lastHeartbeatAt < progressHeartbeatMs)
+                                    return;
+                                lastHeartbeatAt = now;
+                                const percent = Math.floor((completed / total) * 100);
+                                ctx.pushNotice?.({
+                                    source: "engine:derivation",
+                                    kind: "embed_progress",
+                                    message: `Indexing repository semantics: ${percent}% (${completed}/${total})`,
+                                    completed,
+                                    total,
+                                    percent,
+                                    phase: progress.phase,
+                                    level: "info",
+                                });
+                            },
+                        });
+                        tick();
+                    }
+                }
+            };
+            await Promise.all(Array.from({ length: Math.min(concurrency, work.length || 1) }, () => worker()));
+        };
+        // Each group stays on one worker: its representative completes the artifact, then every
+        // sibling attaches that same immutable result.
+        await workerPool([...groups.values()]);
+    }
+}
+function derivationHash(input) {
+    return createHash("sha256")
+        .update(input.content)
+        .update("\0")
+        .update(input.mimetype)
+        .update("\0")
+        .update(input.binary ? "binary" : "text")
+        .update("\0")
+        .update(input.projectionIdentity)
+        .update("\0")
+        .update(input.semanticIdentity)
+        .update("\0")
+        .update(input.dispositionIdentity)
+        .digest("hex");
+}
+//# sourceMappingURL=_search-index.js.map

package/dist/schemes/_search-index.js.map

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

package/dist/schemes/cosine.js

@@ -1,4 +1,4 @@
-// SqlRite function module (#186, ~semantic). The sqlrite contract requires a
+// SqlRite function module for ~semantic ({§relation-indexed-dialects}). The sqlrite contract requires a
 // default-export handler and turns the filename into the SQL function name — so
 // this is a thin registration adapter; the logic lives in EntrySemantic.cosine
 // (OO). `deterministic` marks it a pure function so SQLite may optimize it. One

package/dist/schemes/cosine.js.map

@@ -1 +1 @@
-{"version":3,"file":"cosine.js","sourceRoot":"","sources":["../../src/schemes/cosine.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,eAAe,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cosine.js","sourceRoot":"","sources":["../../src/schemes/cosine.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,eAAe,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/schemes/exec-abort.js

@@ -1,16 +1,16 @@
 // The abort-reason protocol @plurnk/plurnk-execs' SubprocessExecutor reads off `signal.reason`:
 //   { signal }                       → deliver exactly that Unix signal, once, no escalation.
-//   { housekeeping: true, graceMs }  → loop/run teardown: the polite signal, then SIGKILL after graceMs.
+//   { housekeeping: true, graceMs }  → loop/worker teardown: the polite signal, then SIGKILL after graceMs.
 // A { signal: null } reason (a bare KILL) carries no override, so the executor applies its own
 // polite default, SIGHUP — the gentlest rung; the model escalates with explicit codes.
 export default class ExecAbort {
     // The grace a teardown straggler gets before the hard SIGKILL. The executor refuses to bake a
     // number (it'd be a magic literal there); the consumer owns it — env-tunable, 2s default. A
-    // getter, not a static field, so a test can set the env at runtime. §worker-lifecycle-total-reap
+    // getter, not a static field, so a test can set the env at runtime. {§worker-lifecycle-total-reap}
     static get graceMs() {
         return Number(process.env.PLURNK_SERVICE_EXEC_KILL_GRACE_MS ?? "2000");
     }
-    // Loop/run teardown — a BOUNDED reap, so Exec.idle() can't wedge on a signal-ignoring spawn.
+    // Loop/worker teardown — a bounded reap, so Exec.idle() can't wedge on a signal-ignoring spawn.
     static teardownReason() {
         return { housekeeping: true, graceMs: ExecAbort.graceMs };
     }

package/dist/schemes/exec-abort.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec-abort.js","sourceRoot":"","sources":["../../src/schemes/exec-abort.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,8FAA8F;AAC9F,yGAAyG;AACzG,+FAA+F;AAC/F,uFAAuF;AACvF,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,8FAA8F;IAC9F,4FAA4F;IAC5F,iGAAiG;IACjG,MAAM,KAAK,OAAO;QACd,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,cAAc;QACjB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,mGAAmG;IACnG,mGAAmG;IACnG,MAAM,CAAC,UAAU,CAAC,MAAqB;QACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,8FAA8F;IAC9F,6FAA6F;IAC7F,mGAAmG;IACnG,MAAM,CAAC,aAAa;QAChB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;CACJ"}
+{"version":3,"file":"exec-abort.js","sourceRoot":"","sources":["../../src/schemes/exec-abort.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,8FAA8F;AAC9F,4GAA4G;AAC5G,+FAA+F;AAC/F,uFAAuF;AACvF,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,8FAA8F;IAC9F,4FAA4F;IAC5F,mGAAmG;IACnG,MAAM,KAAK,OAAO;QACd,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,gGAAgG;IAChG,MAAM,CAAC,cAAc;QACjB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,mGAAmG;IACnG,mGAAmG;IACnG,MAAM,CAAC,UAAU,CAAC,MAAqB;QACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,8FAA8F;IAC9F,6FAA6F;IAC7F,mGAAmG;IACnG,MAAM,CAAC,aAAa;QAChB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;CACJ"}

package/dist/schemes/exec-env.js

@@ -1,4 +1,4 @@
-// SPEC §exec {§exec-env-scoped} — the environment an EXEC subprocess receives.
+// SPEC {§exec} {§exec-env-scoped} — the environment an EXEC subprocess receives.
 //
 // It gets the *project's* environment (its `.env`, the standard shell vars like PATH
 // and HOME) so the model's commands run as the project expects — but never plurnk's
@@ -9,8 +9,8 @@
 //
 // A denylist, not an allowlist: a subprocess needs the long tail of inherited vars
 // (PATH, HOME, LANG, the project's own keys); only plurnk's two owned families are
-// stripped. The service owns this policy; the executor (plurnk-execs SubprocessExecutor,
-// plurnk-execs#8) spawns with the env it is handed.
+// stripped. The service owns this policy; the subprocess executor spawns with
+// the environment it is handed.
 import { providerCredentialEnvNames } from "@plurnk/plurnk-models";
 export default class ExecEnv {
     // Read at call time (not memoized) so a secret set into process.env after boot is

package/dist/schemes/exec-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec-env.js","sourceRoot":"","sources":["../../src/schemes/exec-env.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,qFAAqF;AACrF,oFAAoF;AACpF,8EAA8E;AAC9E,yFAAyF;AACzF,2GAA2G;AAC3G,kEAAkE;AAClE,EAAE;AACF,mFAAmF;AACnF,mFAAmF;AACnF,yFAAyF;AACzF,oDAAoD;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,kFAAkF;IAClF,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;QAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CACxB,0BAA0B,EAAE,CAC/B,CAAC;QACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS;YAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;oBAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC;QACL,CAAC;QACD,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAE,uCAAuC;YAC1G,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}
+{"version":3,"file":"exec-env.js","sourceRoot":"","sources":["../../src/schemes/exec-env.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,qFAAqF;AACrF,oFAAoF;AACpF,8EAA8E;AAC9E,yFAAyF;AACzF,2GAA2G;AAC3G,kEAAkE;AAClE,EAAE;AACF,mFAAmF;AACnF,mFAAmF;AACnF,8EAA8E;AAC9E,gCAAgC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,kFAAkF;IAClF,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;QAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CACxB,0BAA0B,EAAE,CAC/B,CAAC;QACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS;YAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;oBAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC;QACL,CAAC;QACD,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAE,uCAAuC;YAC1G,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}

package/dist/server/BranchBatches.d.ts

@@ -0,0 +1,48 @@
+import type { Db } from "../core/Db.ts";
+import { type SchemeResult } from "../core/results.ts";
+import type { LoopFlags, WriterTier } from "../core/types.ts";
+import type WorkspaceGate from "../core/WorkspaceGate.ts";
+export interface EnqueueBranchWorker {
+    workspaceId: number;
+    parentWorkerId: number;
+    op: "WORK" | "FORK";
+    name: string;
+    prompt: string;
+    flags: LoopFlags;
+    origin: WriterTier;
+}
+export interface BranchBatchDependencies {
+    settleWorkspace(workspaceId: number): Promise<void>;
+    createChild(args: EnqueueBranchWorker): Promise<{
+        workerId: number;
+        loopId: number;
+    }>;
+    startChild(workspaceId: number, workerId: number, loopId: number): Promise<SchemeResult>;
+    wakeParent(workspaceId: number, workerId: number): Promise<void>;
+    notify(workspaceId: number, payload: Readonly<Record<string, unknown>>): void;
+}
+export default class BranchBatches {
+    #private;
+    constructor(db: Db, gate: WorkspaceGate, dependencies: BranchBatchDependencies);
+    enqueue(args: {
+        workspaceId: number;
+        parentWorkerId: number;
+        parentLoopId: number;
+        parentTurnId: number;
+        op: "WORK" | "FORK";
+        name: string;
+        branch: string;
+        prompt: string;
+        flags: LoopFlags;
+        origin: WriterTier;
+    }): Promise<{
+        workerId: number;
+        loopId: number;
+    }>;
+    sealTurn(parentTurnId: number): Promise<void>;
+    completionGate(workerId: number): Promise<SchemeResult | null>;
+    recover(): Promise<void>;
+    idle(): Promise<void>;
+    beginStop(): void;
+}
+//# sourceMappingURL=BranchBatches.d.ts.map

package/dist/server/BranchBatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchBatches.d.ts","sourceRoot":"","sources":["../../src/server/BranchBatches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAKxC,OAAgB,EAAyB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AA8B1D,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzF,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CACjF;AAID,MAAM,CAAC,OAAO,OAAO,aAAa;;IAQ9B,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAK7E;IAEK,OAAO,CAAC,IAAI,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,UAAU,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CA6HhD;IAKK,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBlD;IAEK,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA8CnE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B7B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED,SAAS,IAAI,IAAI,CAEhB;CAqeJ"}