@plurnk/plurnk-service 1.3.12 → 1.5.0

package/dist/content/path-mimetype.js

@@ -2,10 +2,10 @@
 // is @plurnk/plurnk-schemes (keystone PR-1). Local OO facade over the
 // plugin's function; call sites stay `PathMimetype.resolveEntryMimetype(...)`.
 //
-// A pathname's extension drives the effective mimetype (§ext-mimetype-extension-mimetype; via the sibling
+// A pathname's extension drives the effective mimetype ({§ext-mimetype-extension-mimetype}; via the sibling
 // Mimetypes detect service); the scheme manifest's channel default is the
-// fallback when no extension is present. `known:///users.json` →
-// application/json; `known:///notes` → scheme default.
+// fallback when no extension is present. `worker:///users.json` →
+// application/json; `worker:///notes` → scheme default.
 import { PathMimetype as _PathMimetype } from "@plurnk/plurnk-schemes";
 export default class PathMimetype {
     static resolveEntryMimetype(pathname, schemeDefault, mimetypes) {

package/dist/content/path-mimetype.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-mimetype.js","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,+EAA+E;AAC/E,EAAE;AACF,0GAA0G;AAC1G,0EAA0E;AAC1E,iEAAiE;AACjE,uDAAuD;AACvD,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvE,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,oBAAoB,CAAC,QAAgB,EAAE,aAAqB,EAAE,SAAgC;QACjG,OAAO,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC;CACJ"}
+{"version":3,"file":"path-mimetype.js","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,+EAA+E;AAC/E,EAAE;AACF,4GAA4G;AAC5G,0EAA0E;AAC1E,kEAAkE;AAClE,wDAAwD;AACxD,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvE,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,oBAAoB,CAAC,QAAgB,EAAE,aAAqB,EAAE,SAAgC;QACjG,OAAO,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC;CACJ"}

package/dist/content/read-projector.d.ts

@@ -0,0 +1,14 @@
+import type { ReadStatement } from "@plurnk/plurnk-contracts";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+import type { EntryReadResult, StoredEntryData } from "@plurnk/plurnk-schemes";
+import type { SchemeManifest } from "../core/scheme-types.ts";
+export default class ReadProjector {
+    static project(opts: {
+        readonly statement: ReadStatement;
+        readonly manifest: SchemeManifest;
+        readonly target: string;
+        readonly representation: StoredEntryData;
+        readonly mimetypes: Mimetypes | undefined;
+    }): Promise<EntryReadResult>;
+}
+//# sourceMappingURL=read-projector.d.ts.map

package/dist/content/read-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-projector.d.ts","sourceRoot":"","sources":["../../src/content/read-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAS9D,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,OAAa,OAAO,CAAC,IAAI,EAAE;QACvB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;QACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;KAC7C,GAAG,OAAO,CAAC,eAAe,CAAC,CAwH3B;CACJ"}

package/dist/content/read-projector.js

@@ -0,0 +1,86 @@
+import Results from "../core/results.js";
+import MimetypeBinary from "./mimetype-binary.js";
+import ReadResolve from "./read-resolve.js";
+// {§universal-read-composition} Core's one exact-resource projection over a complete canonical
+// representation. Storage adapters supply channels and tags; this layer owns
+// channel selection, tag filtering, binary admission, text coordinates, and
+// composition of the selected producer's durable result.
+export default class ReadProjector {
+    static async project(opts) {
+        const { statement, manifest, target, representation, mimetypes } = opts;
+        const fragment = statement.target?.kind === "url"
+            ? statement.target.fragment
+            : null;
+        const selected = fragment ?? manifest.defaultChannel;
+        const channel = selected === "" ? null : selected;
+        const availableChannels = [...new Set([
+                manifest.defaultChannel,
+                ...Object.keys(manifest.channels),
+            ])].filter((candidate) => candidate.length > 0);
+        const failure = (code, status, detail, fields = {}, extensions = {}) => Results.failure(`scheme:${manifest.name}`, code, status, detail, { content: null, mimetype: null, channel, ...fields }, extensions);
+        if (selected !== manifest.defaultChannel && !(selected in manifest.channels)) {
+            return failure("channel-not-found", 400, `Channel #${selected} does not exist at ${target}.`, { channel: null }, {
+                requestedChannel: selected,
+                availableChannels,
+                ...(availableChannels.length === 0
+                    ? {}
+                    : {
+                        recovery: `Use one of the available channels: ${availableChannels
+                            .map((candidate) => `#${candidate}`)
+                            .join(", ")}.`,
+                    }),
+                retryable: false,
+            });
+        }
+        const selectedRepresentation = representation.channels[selected];
+        if (selectedRepresentation === undefined) {
+            return failure("entry-not-found", 404, `No entry exists at ${target}.`);
+        }
+        if (await MimetypeBinary.isBinaryMimetype(selectedRepresentation.mimetype, mimetypes)) {
+            return failure("binary-read-unsupported", 415, channel === null
+                ? `The representation at ${target} is binary and cannot be rendered.`
+                : `The #${channel} channel is binary and cannot be rendered.`, { mimetype: selectedRepresentation.mimetype });
+        }
+        if (Array.isArray(statement.signal) && statement.signal.length > 0) {
+            const tags = new Set(representation.tags);
+            const missing = statement.signal.find((tag) => !tags.has(tag));
+            if (missing !== undefined) {
+                return failure("tag-not-found", 404, `The resource does not carry the required '${missing}' tag.`);
+            }
+        }
+        const resolved = await ReadResolve.resolve({
+            content: selectedRepresentation.content,
+            mimetype: selectedRepresentation.mimetype,
+            lineMarker: statement.lineMarker,
+        });
+        if (resolved.status >= 400) {
+            if (resolved.problem !== undefined) {
+                return Results.assertReadResult({
+                    ...resolved,
+                    content: null,
+                    channel,
+                });
+            }
+            if (resolved.reason === undefined) {
+                throw new Error(`ReadProjector: text projection returned status ${resolved.status} without Problem Details or a diagnostic`);
+            }
+            return failure(resolved.status === 416
+                ? "range-not-satisfiable"
+                : "read-resolution-failed", resolved.status, resolved.reason, { mimetype: resolved.mimetype }, {
+                ...(resolved.range === undefined
+                    ? {}
+                    : { range: resolved.range, stage: "projection" }),
+            });
+        }
+        const projected = { ...resolved, channel };
+        const producerResult = selectedRepresentation.producerResult;
+        return producerResult === undefined
+            ? projected
+            : Results.assertReadResult({
+                ...producerResult,
+                ...projected,
+                status: producerResult.status,
+            });
+    }
+}
+//# sourceMappingURL=read-projector.js.map

package/dist/content/read-projector.js.map

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

package/dist/content/read-resolve.d.ts

@@ -1,20 +1,19 @@
-import type { LineMarker, MatcherBody } from "@plurnk/plurnk-grammar";
-import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
-export interface ReadSliceResult {
-    status: number;
+import { type LineMarker, type RangeExtent, type TextRegion } from "@plurnk/plurnk-contracts";
+import type { SchemeResultBase, ScopeNormalization } from "@plurnk/plurnk-schemes";
+export interface ReadSliceResult extends SchemeResultBase {
     content: string | null;
     mimetype: string;
     startLine?: number | null;
-    matches?: number;
+    region?: TextRegion;
     reason?: string;
+    range?: RangeExtent;
+    scopeNormalizations?: ReadonlyArray<ScopeNormalization>;
 }
 export default class ReadResolve {
     static resolve(opts: {
         content: string;
         mimetype: string;
         lineMarker: LineMarker | null;
-        body: MatcherBody | null;
-        mimetypes: Mimetypes | undefined;
     }): Promise<ReadSliceResult>;
 }
 //# sourceMappingURL=read-resolve.d.ts.map

package/dist/content/read-resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-resolve.d.ts","sourceRoot":"","sources":["../../src/content/read-resolve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAK1D,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,OAAa,OAAO,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;QAC9B,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;KACpC,GAAG,OAAO,CAAC,eAAe,CAAC,CAiD3B;CACJ"}
+{"version":3,"file":"read-resolve.d.ts","sourceRoot":"","sources":["../../src/content/read-resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAInF,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC3D;AAED,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,OAAa,OAAO,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,CAAC,CAoC3B;CACJ"}

package/dist/content/read-resolve.js

@@ -1,68 +1,45 @@
-// Shared READ slice→match resolution for entry-bearing schemes (Known/Skill/
-// Unknown/Exec/Plurnk via `_entry-ops`), plus `Log` and `File`. `<L>` scopes,
-// the body matches within the scope: slice-then-match (plurnk.md slot order
-// `<L>?:body?`). `<L>` dispatches on source mimetype — JSON → item index
-// (sliceJsonItems), line-navigable → line index (sliceLines). Callers bind their
-// own (content, mimetype) and wrap the result (e.g. `_entry-ops` adds `channel`).
+// Shared exact-target READ projection for entry-bearing schemes, File, and Log.
+// READ owns text coordinates only; FIND owns every aggregate or matcher selection.
+import { DEFAULT_RETRIEVAL_LIMIT } from "@plurnk/plurnk-contracts";
 import LineMarkerOps from "./line-marker.js";
-import Matcher from "./matcher.js";
 import MimetypeBinary from "./mimetype-binary.js";
 export default class ReadResolve {
     static async resolve(opts) {
-        const { content, mimetype, lineMarker, body, mimetypes } = opts;
-        let workingContent = content;
-        let workingStart = 1;
-        let workingMimetypeForSlice = MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE;
-        if (lineMarker !== null) {
-            if (MimetypeBinary.isJsonMimetype(mimetype)) {
-                const sliced = LineMarkerOps.sliceJsonItems(content, lineMarker);
-                // A range miss states the EXTENT (run24: 24 blind 416s — the model re-guessed
-                // ranges against a file whose size it was never told). A fact, not advice.
-                if (sliced.status === 416)
-                    return { status: 416, content: "[ range not satisfiable — the JSON has fewer items than requested ]", mimetype: "text/markdown" };
-                if (sliced.status !== 200)
-                    return { status: sliced.status, content: null, mimetype };
-                workingContent = sliced.body ?? "[]";
-                workingStart = null;
-                workingMimetypeForSlice = "application/json";
-            }
-            else {
-                const sliced = LineMarkerOps.sliceLines(content, lineMarker);
-                if (sliced.status === 416) {
-                    const totalLines = content.length === 0 ? 0 : content.split("\n").length;
-                    return { status: 416, content: `[ range not satisfiable — entry has ${totalLines} lines ]`, mimetype: "text/markdown" };
-                }
-                if (sliced.status !== 200)
-                    return { status: sliced.status, content: null, mimetype };
-                workingContent = sliced.text ?? "";
-                workingStart = sliced.startLine ?? null;
-            }
+        const { content, mimetype, lineMarker } = opts;
+        const marker = lineMarker ?? { marks: [1, DEFAULT_RETRIEVAL_LIMIT] };
+        const sliced = LineMarkerOps.sliceLines(content, marker);
+        if (sliced.status === 416) {
+            return {
+                status: 416,
+                problem: sliced.problem,
+                content: null,
+                mimetype,
+                reason: sliced.problem?.detail,
+                range: sliced.range,
+            };
         }
-        if (body !== null) {
-            if (mimetypes === undefined)
-                return { status: 500, content: null, mimetype };
-            const matched = await Matcher.matchAgainstContent(body, workingContent, mimetype, mimetypes, workingStart ?? 1);
-            if (matched.status === 204)
-                return { status: 204, content: "", mimetype: "text/markdown", startLine: null, matches: 0 };
-            if (matched.status === 203) {
-                // Dialect-parse-failure fallback: raw source as text/markdown; reason surfaces why.
-                return { status: 203, content: matched.body ?? "", mimetype: matched.mimetype ?? "text/markdown", startLine: 1, reason: matched.reason };
-            }
-            if (matched.status !== 200)
-                return { status: matched.status, content: null, mimetype };
-            return { status: 200, content: matched.body ?? "", mimetype: "text/markdown", startLine: null, matches: matched.matches };
+        if (sliced.status !== 200) {
+            throw new Error(`ReadResolve: text slicing returned unexpected status ${sliced.status}`);
         }
-        if (lineMarker !== null) {
-            // `<L>` slice mimetype follows the source family: line-navigable → text/markdown,
-            // JSON → application/json (structure preserved for compose, §slice-semantics-compose-pattern). Empty / `[]` → 204.
-            const isEmptyJsonArray = workingMimetypeForSlice === "application/json" && workingContent === "[]";
-            if (workingContent === "" || isEmptyJsonArray)
-                return { status: 204, content: "", mimetype: workingMimetypeForSlice, startLine: null };
-            return { status: 200, content: workingContent, mimetype: workingMimetypeForSlice, startLine: workingStart };
-        }
-        if (content === "")
-            return { status: 204, content: "", mimetype, startLine: null };
-        return { status: 200, content, mimetype, startLine: 1 };
+        const selectedMimetype = lineMarker === null
+            ? mimetype
+            : MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE;
+        const selectedContent = lineMarker === null
+            && sliced.range !== undefined
+            && LineMarkerOps.coversAvailable(sliced.range)
+            ? content
+            : sliced.text ?? "";
+        return {
+            status: selectedContent === "" ? 204 : 200,
+            content: selectedContent,
+            mimetype: selectedMimetype,
+            startLine: selectedContent === "" ? null : sliced.startLine ?? null,
+            ...(sliced.region === undefined ? {} : { region: sliced.region }),
+            ...(sliced.range === undefined ? {} : { range: sliced.range }),
+            ...(sliced.scopeNormalizations === undefined
+                ? {}
+                : { scopeNormalizations: sliced.scopeNormalizations }),
+        };
     }
 }
 //# sourceMappingURL=read-resolve.js.map

package/dist/content/read-resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-resolve.js","sourceRoot":"","sources":["../../src/content/read-resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"read-resolve.js","sourceRoot":"","sources":["../../src/content/read-resolve.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AAEnF,OAAO,EAAE,uBAAuB,EAAsD,MAAM,0BAA0B,CAAC;AAEvH,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAYlD,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAIpB;QACG,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,OAAO;gBACH,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,IAAI;gBACb,QAAQ;gBACR,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM;gBAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;aACtB,CAAC;QACN,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,gBAAgB,GAAG,UAAU,KAAK,IAAI;YACxC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,cAAc,CAAC,uBAAuB,CAAC;QAC7C,MAAM,eAAe,GAAG,UAAU,KAAK,IAAI;eACpC,MAAM,CAAC,KAAK,KAAK,SAAS;eAC1B,aAAa,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;YAC9C,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO;YACH,MAAM,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YAC1C,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI;YACnE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9D,GAAG,CAAC,MAAM,CAAC,mBAAmB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE,CAAC;SAC7D,CAAC;IACN,CAAC;CACJ"}

package/dist/core/BranchReceipt.d.ts

@@ -0,0 +1,6 @@
+import type { Db } from "./Db.ts";
+export default class BranchReceipt {
+    #private;
+    static render(db: Db, workerId: number): Promise<string | null>;
+}
+//# sourceMappingURL=BranchReceipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BranchReceipt.d.ts","sourceRoot":"","sources":["../../src/core/BranchReceipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAYlC,MAAM,CAAC,OAAO,OAAO,aAAa;;IAU9B,OAAa,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWpE;CACJ"}

package/dist/core/BranchReceipt.js

@@ -0,0 +1,24 @@
+export default class BranchReceipt {
+    static #revisionChars() {
+        const raw = process.env.PLURNK_SERVICE_BRANCH_RECEIPT_REVISION_CHARS;
+        const value = Number(raw);
+        if (!Number.isSafeInteger(value) || value < 1 || value > 64) {
+            throw new Error(`PLURNK_SERVICE_BRANCH_RECEIPT_REVISION_CHARS must be a safe integer from 1 through 64, got ${JSON.stringify(raw)}`);
+        }
+        return value;
+    }
+    static async render(db, workerId) {
+        const rows = await db.branch_batch_receipt_for_worker.all({
+            worker_id: workerId,
+        });
+        if (rows.length === 0)
+            return null;
+        const first = rows[0];
+        const revisionChars = BranchReceipt.#revisionChars();
+        const tip = first.result_commit === null
+            ? ""
+            : ` at \`${first.result_commit.slice(0, revisionChars)}\` (${first.changed === 1 ? "changed" : "unchanged"})`;
+        return `Branch receipt: \`${first.branch}\` ${first.item_state}${tip} (batch ${first.batch_id} ${first.batch_state}).`;
+    }
+}
+//# sourceMappingURL=BranchReceipt.js.map

package/dist/core/BranchReceipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchReceipt.js","sourceRoot":"","sources":["../../src/core/BranchReceipt.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,MAAM,CAAC,cAAc;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;QACrE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,8FAA8F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzI,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAM,EAAE,QAAgB;QACxC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,+BAA+B,CAAC,GAAG,CAAa;YAClE,SAAS,EAAE,QAAQ;SACtB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,aAAa,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,KAAK,IAAI;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC;QAClH,OAAO,qBAAqB,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,UAAU,GAAG,GAAG,WAAW,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC;IAC3H,CAAC;CACJ"}

package/dist/core/BudgetOverflow.d.ts

@@ -0,0 +1,20 @@
+import { type OperationResult } from "@plurnk/plurnk-contracts";
+export interface BudgetOverflowMeasurement {
+    readonly usage: number;
+    readonly ceiling: number;
+    readonly deficit: number;
+}
+export interface BudgetOverflowPhysicalFailure {
+    readonly reason: string;
+    readonly detail: string;
+    readonly capacity: number | null;
+    readonly tokens?: number;
+    readonly tokenKind?: string;
+    readonly tokenSource?: string;
+}
+export default class BudgetOverflow {
+    static measure(usage: number, ceiling: number): BudgetOverflowMeasurement;
+    static result(usage: number, ceiling: number, recovery: boolean, physical?: BudgetOverflowPhysicalFailure): OperationResult;
+    static foldedResult(usage: number, ceiling: number): OperationResult;
+}
+//# sourceMappingURL=BudgetOverflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetOverflow.d.ts","sourceRoot":"","sources":["../../src/core/BudgetOverflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACjC;AAID,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAMxE;IAED,MAAM,CAAC,MAAM,CACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,6BAA6B,GACzC,eAAe,CA8BjB;IAED,MAAM,CAAC,YAAY,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAChB,eAAe,CAmBjB;CACJ"}

package/dist/core/BudgetOverflow.js

@@ -0,0 +1,49 @@
+import { Problems, Validator, } from "@plurnk/plurnk-contracts";
+const formatTokens = (tokens) => tokens.toLocaleString("en-US");
+export default class BudgetOverflow {
+    static measure(usage, ceiling) {
+        return {
+            usage,
+            ceiling,
+            deficit: Math.max(0, usage - ceiling),
+        };
+    }
+    static result(usage, ceiling, recovery, physical) {
+        const measurement = BudgetOverflow.measure(usage, ceiling);
+        const physicalDetail = physical === undefined
+            ? ""
+            : ` Physical recovery was not admitted: ${physical.detail}.`;
+        return Validator.assertOperationResult({
+            status: 413,
+            problem: Problems.create("engine:grinder", "budget-overflow", 413, `At overflow detection, Token Usage ${formatTokens(measurement.usage)} exceeds Token Ceiling ${formatTokens(measurement.ceiling)} by ${formatTokens(measurement.deficit)}. No working room remains.${physicalDetail}`, {
+                ...measurement,
+                stage: "overflow-detection",
+                retryable: false,
+                ...(physical === undefined ? {} : {
+                    physicalAdmission: physical.reason,
+                    physicalCapacity: physical.capacity,
+                    ...(physical.tokens === undefined ? {} : { physicalTokens: physical.tokens }),
+                    ...(physical.tokenKind === undefined ? {} : { physicalTokenKind: physical.tokenKind }),
+                    ...(physical.tokenSource === undefined ? {} : { physicalTokenSource: physical.tokenSource }),
+                }),
+                ...(recovery ? {
+                    recovery: "Restore working room before the next turn: FOLD or KILL irrelevant log items, or use smaller retrieval ranges.",
+                } : {}),
+            }, { title: "Prompt budget exceeded" }),
+        });
+    }
+    static foldedResult(usage, ceiling) {
+        const measurement = BudgetOverflow.measure(usage, ceiling);
+        return Validator.assertOperationResult({
+            status: 413,
+            problem: Problems.create("engine:grinder", "budget-overflow", 413, `At overflow detection, Token Usage ${formatTokens(measurement.usage)} exceeded Token Ceiling ${formatTokens(measurement.ceiling)} by ${formatTokens(measurement.deficit)}. The newest open log items were FOLDed, and the rebuilt packet now fits.`, {
+                ...measurement,
+                stage: "overflow-detection",
+                resolution: "newest-log-items-folded",
+                recovery: "Keep irrelevant log items FOLDed or KILL them, and use smaller retrieval ranges.",
+                retryable: false,
+            }, { title: "Prompt budget exceeded" }),
+        });
+    }
+}
+//# sourceMappingURL=BudgetOverflow.js.map

package/dist/core/BudgetOverflow.js.map

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

package/dist/core/BudgetReadout.d.ts

@@ -0,0 +1,8 @@
+type MeasurePacket = (content: string) => number;
+export default class BudgetReadout {
+    #private;
+    static draft(ceiling: number | null): string;
+    static resolve(template: string, ceiling: number, measurePacket: MeasurePacket): string;
+}
+export {};
+//# sourceMappingURL=BudgetReadout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetReadout.d.ts","sourceRoot":"","sources":["../../src/core/BudgetReadout.ts"],"names":[],"mappings":"AAWA,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,aAAa;;IAC9B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3C;IAID,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,CAwCtF;CAsCJ"}

package/dist/core/BudgetReadout.js

@@ -0,0 +1,79 @@
+const TOKENS_FREE_PLACEHOLDER = "{{tokensFree}}";
+const TOKEN_USAGE_PLACEHOLDER = "{{tokenUsage}}";
+const TOKEN_PERCENT_PLACEHOLDER = "{{tokenPercent}}";
+const MAX_WIDTH_PASSES = 64;
+export default class BudgetReadout {
+    static draft(ceiling) {
+        if (ceiling === null)
+            return "";
+        BudgetReadout.#assertCeiling(ceiling);
+        return `Token Ceiling ${ceiling} · Token Usage ${TOKEN_USAGE_PLACEHOLDER} (${TOKEN_PERCENT_PLACEHOLDER}%) · Tokens Free ${TOKENS_FREE_PLACEHOLDER}`;
+    }
+    // {§tokenomics-render-weight-budget} — widths only expand, so final numeric
+    // substitution cannot change the measured packet length or oscillate.
+    static resolve(template, ceiling, measurePacket) {
+        BudgetReadout.#assertCeiling(ceiling);
+        BudgetReadout.#assertTemplate(template);
+        let widths = { usage: 1, percent: 1, free: 1 };
+        for (let pass = 0; pass < MAX_WIDTH_PASSES; pass += 1) {
+            const probe = BudgetReadout.#render(template, widths, {
+                usage: "0".repeat(widths.usage),
+                percent: "0".repeat(widths.percent),
+                free: "0".repeat(widths.free),
+            });
+            const usage = BudgetReadout.#assertWeight(measurePacket(probe));
+            const values = {
+                usage: String(usage),
+                percent: BudgetReadout.#percent(usage, ceiling),
+                free: String(Math.max(0, ceiling - usage)),
+            };
+            const expanded = {
+                usage: Math.max(widths.usage, values.usage.length),
+                percent: Math.max(widths.percent, values.percent.length),
+                free: Math.max(widths.free, values.free.length),
+            };
+            if (expanded.usage !== widths.usage
+                || expanded.percent !== widths.percent
+                || expanded.free !== widths.free) {
+                widths = expanded;
+                continue;
+            }
+            const content = BudgetReadout.#render(template, widths, values);
+            const finalWeight = BudgetReadout.#assertWeight(measurePacket(content));
+            if (finalWeight !== usage) {
+                throw new Error(`Budget readout measurement changed after fixed-width substitution: ${usage} -> ${finalWeight}`);
+            }
+            return content;
+        }
+        throw new Error(`Budget readout field widths did not converge after ${MAX_WIDTH_PASSES} passes`);
+    }
+    static #render(template, widths, values) {
+        return template
+            .replace(TOKEN_USAGE_PLACEHOLDER, values.usage.padStart(widths.usage))
+            .replace(TOKEN_PERCENT_PLACEHOLDER, values.percent.padStart(widths.percent))
+            .replace(TOKENS_FREE_PLACEHOLDER, values.free.padStart(widths.free));
+    }
+    static #percent(usage, ceiling) {
+        const percent = (usage / ceiling) * 100;
+        return usage > 0 && percent < 1 ? "<1" : String(Math.round(percent));
+    }
+    static #assertCeiling(ceiling) {
+        if (!Number.isSafeInteger(ceiling) || ceiling <= 0) {
+            throw new TypeError("Budget readout ceiling must be a positive safe integer");
+        }
+    }
+    static #assertWeight(weight) {
+        if (!Number.isSafeInteger(weight) || weight < 0) {
+            throw new TypeError("Budget readout packet weight must be a non-negative safe integer");
+        }
+        return weight;
+    }
+    static #assertTemplate(template) {
+        for (const placeholder of [TOKEN_USAGE_PLACEHOLDER, TOKEN_PERCENT_PLACEHOLDER, TOKENS_FREE_PLACEHOLDER]) {
+            if (template.split(placeholder).length !== 2) {
+                throw new TypeError(`Budget readout template must contain ${placeholder} exactly once`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=BudgetReadout.js.map

package/dist/core/BudgetReadout.js.map

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

package/dist/core/ChannelWrite.d.ts

@@ -1,6 +1,8 @@
 import type { Db } from "./Db.ts";
-import type { LoopFlags } from "./types.ts";
-export type ChannelState = "static" | "active" | "closed" | "errored";
+import type { LoopFlags, WriterTier } from "./types.ts";
+import { type ChannelState, type SchemeResult } from "@plurnk/plurnk-schemes";
+import type { Notice } from "@plurnk/plurnk-contracts";
+export type { ChannelState } from "@plurnk/plurnk-schemes";
 export interface StreamCoordinate {
     loop_seq: number;
     turn_seq: number;
@@ -8,6 +10,7 @@ export interface StreamCoordinate {
 }
 export interface StreamEventPayload {
     entryId: number;
+    workerId: number;
     target: string;
     channel: string;
     state: ChannelState;
@@ -21,10 +24,11 @@ export type StreamEventNotify = (workspaceId: number, event: StreamEventPayload)
 export interface WakeWorkerPayload {
     workspaceId: number;
     workerId: number;
+    entryOwnerId: number;
     entryId: number;
     target: string;
     subscriptionId: number;
-    closeStatus: number;
+    result: SchemeResult;
     scheme: string;
     summary: string;
     loop_seq?: number;
@@ -36,18 +40,35 @@ export type InjectWorkerNotify = (args: {
     workspaceId: number;
     workerId: number;
     prompt: string;
+    parentLoopId?: number;
     flags?: LoopFlags;
 }) => Promise<{
     action: "injected_next_turn" | "enqueued_new_loop";
     loopId: number;
 }>;
+export type BranchWorkerNotify = (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;
+}>;
+export type BranchCompletionGate = (workerId: number) => Promise<SchemeResult | null>;
 export type CancelWorkerNotify = (workerId: number, reason: string) => Promise<void>;
 export type CancelDescendantsNotify = (workerId: number, reason: string) => Promise<void>;
-export interface TelemetryEventPayload {
+export interface NoticePayload {
     loopId: number;
-    event: object;
+    notice: Notice;
 }
-export type TelemetryEventNotify = (workspaceId: number, payload: TelemetryEventPayload) => void;
+export type NoticeNotify = (workspaceId: number, payload: NoticePayload) => void;
 export default class ChannelWrite {
     #private;
     static appendToChannel(db: Db, { entryId, channel, chunk, notify, coordinate, mimetype }: {
@@ -74,13 +95,14 @@ export default class ChannelWrite {
         turnScoped?: boolean;
         publishedChannel?: string | null;
     }): Promise<number>;
-    static closeSubscription(db: Db, { subscriptionId, status }: {
+    static closeSubscription(db: Db, { subscriptionId, result }: {
         subscriptionId: number;
-        status: number;
+        result: SchemeResult;
     }): Promise<void>;
-    static execTerminalStatus(db: Db, { workspaceId, workerId, pathname }: {
+    static execTerminalStatus(db: Db, { workspaceId, workerId, scheme, pathname }: {
         workspaceId: number;
         workerId: number;
+        scheme: string;
         pathname: string;
     }): Promise<number | null>;
     static findActiveSubscription(db: Db, { workerId, entryId }: {