@plurnk/plurnk-service 1.0.0

package/dist/Paths.d.ts

@@ -0,0 +1,13 @@
+export default class Paths {
+    #private;
+    static migrations: string;
+    static instructionsSystem: string;
+    static personality: string;
+    static schemeDocs: string;
+    static defaultRequirements: string;
+    static docs(): Array<{
+        entryName: string;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=Paths.d.ts.map

package/dist/Paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../src/Paths.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,OAAO,OAAO,KAAK;;IAQtB,MAAM,CAAC,UAAU,SAA8C;IAC/D,MAAM,CAAC,kBAAkB,SAA6C;IAEtE,MAAM,CAAC,WAAW,SAAsD;IACxE,MAAM,CAAC,UAAU,SAAqC;IAMtD,MAAM,CAAC,mBAAmB,SAAuC;IAkBjE,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAUxD;CACJ"}

package/dist/Paths.js

@@ -0,0 +1,60 @@
+// Package-relative paths to non-code artifacts.
+//
+// `migrations` ships in this package's tarball.
+// `instructionsSystem` resolves to `plurnk.md` IN THE GRAMMAR PACKAGE — single
+// source of truth lives upstream. Plurnk-service doesn't carry its own copy;
+// the grammar agent owns the prose.
+//
+// Lives at src/ (one level above the package root, like the index barrel that
+// re-exports it) so `..` resolves to PACKAGE_ROOT.
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+export default class Paths {
+    static #PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+    static #GRAMMAR_ROOT = dirname(fileURLToPath(import.meta.resolve("@plurnk/plurnk-grammar/package.json")));
+    // The teaching corpus (scheme docs, personality, requirements) lives in @plurnk/plurnk-meta —
+    // the metaproject layer OWNS the family prose (owner ruling, monorepo cut); the daemon
+    // consumes it via the same single-source pull shape as GRAMMAR_ROOT.
+    static #DOCS_ROOT = dirname(fileURLToPath(import.meta.resolve("@plurnk/plurnk-meta/package.json")));
+    static migrations = resolve(Paths.#PACKAGE_ROOT, "migrations");
+    static instructionsSystem = resolve(Paths.#GRAMMAR_ROOT, "plurnk.md");
+    // The default operating policy (seeded to ~/.plurnk/AGENTS.md) + the per-scheme teaching docs.
+    static personality = resolve(Paths.#DOCS_ROOT, "PLURNK_PERSONALITY.md");
+    static schemeDocs = resolve(Paths.#DOCS_ROOT, "docs");
+    // (GBNF artifact resolution moved to Engine.#grammarConstraint — the env value
+    // SELECTS the variant from @plurnk/plurnk-grammar; no hardcoded default here, #225.)
+    // packet.user.system_requirements DEFAULT. Static contract appended at
+    // the end of the user packet — names rules the model has to honor that
+    // the grammar block doesn't cover (e.g. "loop concludes with SEND[200]").
+    static defaultRequirements = Paths.#resolveDefaultRequirements();
+    // Resolve the default requirements file: `PLURNK_SERVICE_REQUIREMENTS` env (absolute
+    // or relative-to-package-root) overrides the docs package's `requirements.md`.
+    static #resolveDefaultRequirements() {
+        const env = process.env.PLURNK_SERVICE_REQUIREMENTS;
+        if (typeof env === "string" && env.length > 0) {
+            return resolve(Paths.#PACKAGE_ROOT, env);
+        }
+        return resolve(Paths.#DOCS_ROOT, "requirements.md");
+    }
+    // Operator reference docs auto-READ into every model run at turn 0.
+    // `PLURNK_SERVICE_MD_<ALIAS>=<path>` materializes <path>'s markdown as a
+    // `plurnk:///<ALIAS>.md` entry the model READs — an idiomatic, userland way
+    // to inject standing context (an ordinary entry + READ op, not a bespoke
+    // packet section). `~` expands to home; relative paths resolve
+    // against the package root. Resolved fresh each call so it tracks the env.
+    static docs() {
+        const out = [];
+        for (const [key, value] of Object.entries(process.env)) {
+            if (!key.startsWith("PLURNK_SERVICE_MD_") || typeof value !== "string" || value.length === 0)
+                continue;
+            const alias = key.slice("PLURNK_SERVICE_MD_".length);
+            if (alias.length === 0)
+                continue;
+            const expanded = value.startsWith("~/") ? resolve(homedir(), value.slice(2)) : value === "~" ? homedir() : value;
+            out.push({ entryName: `${alias}.md`, path: resolve(Paths.#PACKAGE_ROOT, expanded) });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=Paths.js.map

package/dist/Paths.js.map

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

package/dist/content/edited-span.d.ts

@@ -0,0 +1,2 @@
+export declare const editedSpan: (original: string, updated: string, context?: number) => string;
+//# sourceMappingURL=edited-span.d.ts.map

package/dist/content/edited-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edited-span.d.ts","sourceRoot":"","sources":["../../src/content/edited-span.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,UAAU,aAAc,MAAM,WAAW,MAAM,uBAAgB,MAc3E,CAAC"}

package/dist/content/edited-span.js

@@ -0,0 +1,33 @@
+import { diffLines } from "diff";
+// §edit-result-render — the resulting span: the changed region of `updated` (relative to
+// `original`), line-numbered (1-indexed), with `context` lines of padding above
+// and below. Diff to find the changed lines, render their post-edit state.
+// Shared by EDIT result rendering (`_entry-ops`) and the environment-delta
+// materialization (`Engine`, §env-delta) — both show "the edited area as it is now."
+export const editedSpan = (original, updated, context = 2) => {
+    const rows = [];
+    for (const part of diffLines(original, updated)) {
+        if (part.removed)
+            continue; // removed lines aren't in the new content
+        const ls = part.value.split("\n");
+        if (ls.length > 1 && ls[ls.length - 1] === "")
+            ls.pop(); // drop trailing-newline artifact
+        for (const t of ls)
+            rows.push({ text: t, changed: part.added === true });
+    }
+    let lo = -1, hi = -1;
+    for (let i = 0; i < rows.length; i++)
+        if (rows[i].changed) {
+            if (lo < 0)
+                lo = i;
+            hi = i;
+        }
+    if (lo < 0) {
+        lo = 0;
+        hi = rows.length - 1;
+    } // no added hunk (defensive) → whole
+    const start = Math.max(0, lo - context);
+    const end = Math.min(rows.length - 1, hi + context);
+    return rows.slice(start, end + 1).map((r, i) => `${start + i + 1}:\t${r.text}`).join("\n");
+};
+//# sourceMappingURL=edited-span.js.map

package/dist/content/edited-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edited-span.js","sourceRoot":"","sources":["../../src/content/edited-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,yFAAyF;AACzF,gFAAgF;AAChF,2EAA2E;AAC3E,2EAA2E;AAC3E,qFAAqF;AACrF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAO,GAAG,CAAC,EAAU,EAAE;IACjF,MAAM,IAAI,GAAyC,EAAE,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,OAAO;YAAE,SAAS,CAAE,0CAA0C;QACvE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;YAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAE,iCAAiC;QAC3F,KAAK,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAC,IAAI,EAAE,GAAG,CAAC;gBAAE,EAAE,GAAG,CAAC,CAAC;YAAC,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;IAC1F,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QAAC,EAAE,GAAG,CAAC,CAAC;QAAC,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAAC,CAAC,CAAE,oCAAoC;IACnF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC,CAAC"}

package/dist/content/index.d.ts

@@ -0,0 +1,10 @@
+export { default as MimetypeBinary } from "./mimetype-binary.ts";
+export { default as LineMarkerOps } from "./line-marker.ts";
+export type { EditResult as LineEditResult, JsonSliceResult, SliceResult } from "./line-marker.ts";
+export { default as PathMimetype } from "./path-mimetype.ts";
+export { default as Matcher } from "./matcher.ts";
+export type { MatchResult } from "./matcher.ts";
+export { default as ReadResolve } from "./read-resolve.ts";
+export type { ReadSliceResult } from "./read-resolve.ts";
+export { editedSpan } from "./edited-span.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,UAAU,IAAI,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnG,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/content/index.js

@@ -0,0 +1,11 @@
+// Transport-agnostic content primitives — matching, <L> slicing, mimetype
+// classification, path→mimetype. Uniform across every scheme and mimetype;
+// folded in from the former @plurnk/plurnk-schemes daughter, which was
+// misnamed: this is service-level content logic, not protocol-specific.
+export { default as MimetypeBinary } from "./mimetype-binary.js";
+export { default as LineMarkerOps } from "./line-marker.js";
+export { default as PathMimetype } from "./path-mimetype.js";
+export { default as Matcher } from "./matcher.js";
+export { default as ReadResolve } from "./read-resolve.js";
+export { editedSpan } from "./edited-span.js";
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,uEAAuE;AACvE,wEAAwE;AAExE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/content/line-marker.d.ts

@@ -0,0 +1,15 @@
+import type { SliceResult, JsonSliceResult, LineEditResult as EditResult } from "@plurnk/plurnk-schemes";
+import type { LineMarker } from "@plurnk/plurnk-grammar";
+export type { SliceResult, JsonSliceResult, EditResult };
+export default class LineMarkerOps {
+    static sliceLines(content: string, marker: LineMarker): SliceResult;
+    static sliceJsonItems(content: string, marker: LineMarker): JsonSliceResult;
+    static applyJsonItemEdit(content: string, marker: LineMarker, body: string): EditResult;
+    static sliceLinesRaw(content: string, marker: LineMarker): SliceResult;
+    static applyLineMarkerEdit(content: string, marker: LineMarker, body: string): EditResult;
+    static firstLast(marker: LineMarker): {
+        first: number;
+        last: number | null;
+    };
+}
+//# sourceMappingURL=line-marker.d.ts.map

package/dist/content/line-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-marker.d.ts","sourceRoot":"","sources":["../../src/content/line-marker.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAEzD,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAA0C;IAC7G,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,eAAe,CAA8C;IACzH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAuD;IAC9I,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAA6C;IACnH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAyD;IAKlJ,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAE3E;CACJ"}

package/dist/content/line-marker.js

@@ -0,0 +1,21 @@
+// `<L>` line-marker slicing + structural edits — single source of truth is
+// @plurnk/plurnk-schemes (keystone PR-1). Local OO facade over the daughter's
+// functions; call sites stay `LineMarkerOps.sliceLines(...)`. Types re-exported.
+//
+// `<L>` semantics (plurnk.md §`<L>`): <N> position, <N,M> range, <0> prepend
+// sentinel, <-1> append sentinel, <1,-1> whole content.
+import { Slicer } from "@plurnk/plurnk-schemes";
+export default class LineMarkerOps {
+    static sliceLines(content, marker) { return Slicer.lines(content, marker); }
+    static sliceJsonItems(content, marker) { return Slicer.jsonItems(content, marker); }
+    static applyJsonItemEdit(content, marker, body) { return Slicer.jsonItemEdit(content, marker, body); } // structural JSON item edit; malformed JSON → 400 — §json-edit-structural-json-edit §json-edit-json-parse-fail-400
+    static sliceLinesRaw(content, marker) { return Slicer.linesRaw(content, marker); }
+    static applyLineMarkerEdit(content, marker, body) { return Slicer.lineMarkerEdit(content, marker, body); }
+    // grammar 0.49+: the <L> parser carries raw numbers in `marks`; role-assignment is the
+    // consumer's. We read the first mark as start and the second as end (<N,M> range), null for
+    // a lone <N>. Used by the service's own range/threshold consumers (paginate, ~query top-K).
+    static firstLast(marker) {
+        return { first: marker.marks[0], last: marker.marks.length > 1 ? marker.marks[1] : null };
+    }
+}
+//# sourceMappingURL=line-marker.js.map

package/dist/content/line-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-marker.js","sourceRoot":"","sources":["../../src/content/line-marker.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,wDAAwD;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMhD,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,MAAM,CAAC,UAAU,CAAC,OAAe,EAAE,MAAkB,IAAiB,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,MAAkB,IAAqB,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACzH,MAAM,CAAC,iBAAiB,CAAC,OAAe,EAAE,MAAkB,EAAE,IAAY,IAAgB,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,mHAAmH;IAClQ,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,MAAkB,IAAiB,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnH,MAAM,CAAC,mBAAmB,CAAC,OAAe,EAAE,MAAkB,EAAE,IAAY,IAAgB,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAElJ,uFAAuF;IACvF,4FAA4F;IAC5F,4FAA4F;IAC5F,MAAM,CAAC,SAAS,CAAC,MAAkB;QAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9F,CAAC;CACJ"}

package/dist/content/matcher.d.ts

@@ -0,0 +1,44 @@
+import type { MatcherBody } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export interface MatchResult {
+    status: number;
+    body?: string;
+    matches?: number;
+    paths?: string[];
+    hits?: Array<{
+        span: {
+            lineStart: number;
+            lineEnd: number;
+        } | null;
+        path?: string;
+    }>;
+    lines?: number[];
+    spans?: {
+        lineStart: number;
+        lineEnd: number;
+    }[];
+    error?: string;
+    mimetype?: string;
+    reason?: string;
+}
+export default class Matcher {
+    #private;
+    static matchAgainstContent(body: MatcherBody, content: string, mimetype: string, mimetypes: Mimetypes, baseLine?: number): Promise<MatchResult>;
+    static matchCandidates(body: MatcherBody, candidates: ReadonlyArray<{
+        key: string;
+        content: string;
+        mimetype: string;
+    }>, mimetypes: Mimetypes): Promise<{
+        status: number;
+        matches: CandidateMatch[];
+    }>;
+}
+export interface CandidateMatch {
+    key: string;
+    span: {
+        lineStart: number;
+        lineEnd: number;
+    } | null;
+    path?: string;
+}
+//# sourceMappingURL=matcher.d.ts.map

package/dist/content/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/content/matcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,0BAA0B,CAAC;AAIzF,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IAOjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAIjB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,OAAO;;IAuCxB,OAAa,mBAAmB,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,MAAU,GACrB,OAAO,CAAC,WAAW,CAAC,CAsCtB;IAQD,OAAa,eAAe,CACxB,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7E,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAYxD;CACJ;AAGD,MAAM,WAAW,cAAc;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAAE"}

package/dist/content/matcher.js

@@ -0,0 +1,126 @@
+// Body-matcher filtering. The mimetypes daughter owns dialect dispatch, projection, AND
+// source-line provenance: we hand it the matcher the GRAMMAR already parsed (as a
+// ParsedBodyMatcher — no second parser, mimetypes#42) plus the content, and it returns
+// QueryMatch[] with each hit's source span(s). READ returns the LINE at each match
+// (plurnk.md:31) — a matcher SELECTS, it never extracts a value. We never reach into the
+// internal deepJson/deepXml projections; that's the daughter's layer.
+//
+// Status: 200 = matches; 204 = matcher applied, zero results; 400 = malformed matcher
+// expression; 203 = source unparseable for its mimetype → raw bytes as text so the model
+// can fall back to regex/visual parsing (SPEC §matcher-dispatch).
+import { InvalidExpressionError, QueryParseFailureError, UnsupportedDialectError, GrammarNotInstalledError } from "@plurnk/plurnk-mimetypes";
+import MimetypeBinary from "./mimetype-binary.js";
+export default class Matcher {
+    static #renderValue(v) {
+        return typeof v === "string" && !v.includes("\n") ? v : JSON.stringify(v);
+    }
+    // READ returns LINES of content (plurnk.md:31): a matcher SELECTS, READ delivers the
+    // source line(s) at each match — not the extracted value. `m.lines` is each hit's source
+    // span(s), uniform across dialects (the daughter self-provides them). One source-line
+    // prefix `N:\t` (plurnk.md:32), deduped by source line; baseLine shifts slice-relative
+    // spans back to source coordinates. A hit with no span (e.g. an xpath computed scalar —
+    // count()/sum(), which has no source node) falls back to the matched value.
+    static #renderRows(matches, content, baseLine) {
+        const lines = content.split("\n");
+        const offset = baseLine - 1;
+        const seen = new Set();
+        const seenSpan = new Set();
+        const rows = [];
+        const sourceLines = [];
+        const spans = []; // one (deduped) range per match — the (file, span) unit (#286)
+        for (const m of matches) {
+            const ranges = m.lines ?? [];
+            if (ranges.length === 0) {
+                rows.push(Matcher.#renderValue(m.matched));
+                continue;
+            }
+            for (const range of ranges) {
+                const lineStart = range.line + offset;
+                const lineEnd = range.endLine + offset;
+                const spanKey = `${lineStart}\0${lineEnd}`;
+                if (!seenSpan.has(spanKey)) {
+                    seenSpan.add(spanKey);
+                    spans.push({ lineStart, lineEnd });
+                }
+                for (let ln = range.line; ln <= range.endLine; ln++) {
+                    const src = ln + offset;
+                    sourceLines.push(src);
+                    if (seen.has(src))
+                        continue;
+                    seen.add(src);
+                    rows.push(`${src}:\t${lines[ln - 1] ?? Matcher.#renderValue(m.matched)}`);
+                }
+            }
+        }
+        return { body: rows.join("\n"), lines: sourceLines, spans };
+    }
+    static async matchAgainstContent(body, content, mimetype, mimetypes, baseLine = 1) {
+        // Invariant (#286): ~semantic and @graph resolve to (file, span) items via FIND
+        // (rankSemantic / EntryGraph) — never the content matcher. A matcher READ fans out through
+        // FIND, and the per-match read carries the span with no body. So matchAgainstContent only
+        // ever sees content dialects; reaching here with a relation dialect is a routing bug, not a
+        // user error — fail hard rather than silently mis-handle.
+        if (body.dialect === "semantic" || body.dialect === "graph")
+            throw new Error(`matchAgainstContent is content-only; ${body.dialect} must resolve through FIND`);
+        // Hand the daughter the matcher the GRAMMAR parsed — no second parser (mimetypes#42).
+        const parsedMatcher = body.dialect === "regex"
+            ? { dialect: "regex", pattern: body.pattern, flags: body.flags }
+            : { dialect: body.dialect, pattern: body.raw };
+        let matches;
+        try {
+            matches = await mimetypes.query({ content, hint: mimetype }, parsedMatcher);
+        }
+        catch (err) {
+            // A malformed matcher EXPRESSION is the model's fault → 400. Source/projection
+            // failures (unparseable for the mimetype, unsupported dialect for this type, grammar
+            // not installed, no handler) → 203 soft fallback: raw bytes as text so the model
+            // can regex/visual-parse (§matcher-dispatch-203-soft-fallback).
+            if (err instanceof InvalidExpressionError)
+                return { status: 400, error: err.message };
+            if (err instanceof QueryParseFailureError || err instanceof UnsupportedDialectError || err instanceof GrammarNotInstalledError || err instanceof ReferenceError) {
+                return { status: 203, body: content, mimetype: MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE, reason: err instanceof Error ? err.message : String(err) };
+            }
+            throw err;
+        }
+        if (matches.length === 0)
+            return { status: 204, matches: 0 };
+        const rendered = Matcher.#renderRows(matches, content, baseLine);
+        const paths = matches.map((m) => m.matching).filter((x) => typeof x === "string" && x.length > 0);
+        const offset = baseLine - 1;
+        const hits = matches.map((m) => {
+            const first = (m.lines ?? [])[0];
+            const matching = m.matching;
+            return {
+                span: first === undefined ? null : { lineStart: first.line + offset, lineEnd: first.endLine + offset },
+                ...(typeof matching === "string" && matching.length > 0 ? { path: matching } : {}),
+            };
+        });
+        return { status: 200, body: rendered.body, matches: matches.length, lines: rendered.lines, spans: rendered.spans, hits, ...(paths.length > 0 ? { paths } : {}) };
+    }
+    // §find-source-agnostic — apply a content matcher to a list of candidates from ANY source
+    // (entries, log rows, …), returning one (key, span) per HIT keyed by the caller's own identity
+    // (a pathname, a log coordinate). The matcher never cares what table content came from; this is
+    // the shared primitive both EntryFind and Log.find run, so every dialect works uniformly by
+    // construction rather than being re-implemented per scheme. 400 (malformed matcher) fails the
+    // whole op; a non-200 candidate (204 no-match / 415 / 203) simply drops out.
+    static async matchCandidates(body, candidates, mimetypes) {
+        const matches = [];
+        for (const cand of candidates) {
+            const match = await Matcher.matchAgainstContent(body, cand.content, cand.mimetype, mimetypes);
+            if (match.status === 400)
+                return { status: 400, matches: [] };
+            if (match.status !== 200)
+                continue;
+            const spans = match.spans ?? [];
+            const hits = match.hits ?? spans.map((span) => ({ span }));
+            if (hits.length === 0 || hits.every((h) => h.span === null)) {
+                matches.push({ key: cand.key, span: null });
+                continue;
+            }
+            for (const h of hits)
+                matches.push({ key: cand.key, span: h.span, path: h.path });
+        }
+        return { status: 200, matches };
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/content/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../src/content/matcher.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,kFAAkF;AAClF,uFAAuF;AACvF,mFAAmF;AACnF,yFAAyF;AACzF,sEAAsE;AACtE,EAAE;AACF,sFAAsF;AACtF,yFAAyF;AACzF,kEAAkE;AAIlE,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC7I,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAwBlD,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,MAAM,CAAC,YAAY,CAAC,CAAU;QAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,qFAAqF;IACrF,yFAAyF;IACzF,sFAAsF;IACtF,uFAAuF;IACvF,wFAAwF;IACxF,4EAA4E;IAC5E,MAAM,CAAC,WAAW,CAAC,OAA8B,EAAE,OAAe,EAAE,QAAgB;QAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAA6C,EAAE,CAAC,CAAE,+DAA+D;QAC5H,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YAClF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC;gBACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;gBACvC,MAAM,OAAO,GAAG,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC3C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;gBAAC,CAAC;gBAC1F,KAAK,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;oBAClD,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;oBACxB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACtB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,SAAS;oBAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAC5B,IAAiB,EACjB,OAAe,EACf,QAAgB,EAChB,SAAoB,EACpB,QAAQ,GAAW,CAAC;QAEpB,gFAAgF;QAChF,2FAA2F;QAC3F,0FAA0F;QAC1F,4FAA4F;QAC5F,0DAA0D;QAC1D,IAAI,IAAI,CAAC,OAAO,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,OAAO,4BAA4B,CAAC,CAAC;QAC/J,sFAAsF;QACtF,MAAM,aAAa,GAAsB,IAAI,CAAC,OAAO,KAAK,OAAO;YAC7D,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;YAChE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACnD,IAAI,OAAqB,CAAC;QAC1B,IAAI,CAAC;YACD,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,+EAA+E;YAC/E,qFAAqF;YACrF,iFAAiF;YACjF,gEAAgE;YAChE,IAAI,GAAG,YAAY,sBAAsB;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;YACtF,IAAI,GAAG,YAAY,sBAAsB,IAAI,GAAG,YAAY,uBAAuB,IAAI,GAAG,YAAY,wBAAwB,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;gBAC9J,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,uBAAuB,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACtJ,CAAC;YACD,MAAM,GAAG,CAAC;QACd,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA4B,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3I,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAI,CAA4B,CAAC,QAAQ,CAAC;YACxD,OAAO;gBACH,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,EAAE;gBACtG,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrF,CAAC;QACN,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACrK,CAAC;IAED,0FAA0F;IAC1F,+FAA+F;IAC/F,gGAAgG;IAChG,4FAA4F;IAC5F,8FAA8F;IAC9F,6EAA6E;IAC7E,MAAM,CAAC,KAAK,CAAC,eAAe,CACxB,IAAiB,EACjB,UAA6E,EAC7E,SAAoB;QAEpB,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;gBAAE,SAAS;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YACvH,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAG,CAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7G,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;CACJ"}

package/dist/content/mimetype-binary.d.ts

@@ -0,0 +1,8 @@
+export default class MimetypeBinary {
+    static TEXT_PRIMITIVE_MIMETYPE: string;
+    static isBinaryMimetype(mimetype: string): boolean;
+    static isJsonMimetype(mimetype: string): boolean;
+    static isLineNavigableMimetype(mimetype: string): boolean;
+    static normalizeAutoTextMimetype(mimetype: string | null | undefined): string;
+}
+//# sourceMappingURL=mimetype-binary.d.ts.map

package/dist/content/mimetype-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.d.ts","sourceRoot":"","sources":["../../src/content/mimetype-binary.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,MAAM,CAAC,uBAAuB,SAA4B;IAC1D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAkD;IACpG,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAgD;IAChG,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAyD;IAClH,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAA2D;CAC3I"}

package/dist/content/mimetype-binary.js

@@ -0,0 +1,17 @@
+// Mimetype classifiers used at op-handler boundaries — single source of truth
+// is @plurnk/plurnk-schemes (keystone PR-1). Local OO facade over the
+// daughter's functions (mandate: static-method class); call sites stay
+// `MimetypeBinary.isBinaryMimetype(...)`.
+//
+//   isBinaryMimetype       — enforces 415 on binary entries (SPEC §op-invariants)
+//   isLineNavigableMimetype — decides the render layer's `N:\t` line prefixes
+//   TEXT_PRIMITIVE_MIMETYPE — text/markdown, the auto-derived text default
+import { MimetypeClassifier, TEXT_PRIMITIVE_MIMETYPE as _TEXT_PRIMITIVE_MIMETYPE } from "@plurnk/plurnk-schemes";
+export default class MimetypeBinary {
+    static TEXT_PRIMITIVE_MIMETYPE = _TEXT_PRIMITIVE_MIMETYPE;
+    static isBinaryMimetype(mimetype) { return MimetypeClassifier.isBinary(mimetype); }
+    static isJsonMimetype(mimetype) { return MimetypeClassifier.isJson(mimetype); }
+    static isLineNavigableMimetype(mimetype) { return MimetypeClassifier.isLineNavigable(mimetype); }
+    static normalizeAutoTextMimetype(mimetype) { return MimetypeClassifier.normalizeAutoText(mimetype); } // auto-text → the text/markdown primitive — §markdown-primitive-text-markdown-normalize
+}
+//# sourceMappingURL=mimetype-binary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.js","sourceRoot":"","sources":["../../src/content/mimetype-binary.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,uEAAuE;AACvE,0CAA0C;AAC1C,EAAE;AACF,kFAAkF;AAClF,8EAA8E;AAC9E,2EAA2E;AAC3E,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,IAAI,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEjH,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,MAAM,CAAC,uBAAuB,GAAG,wBAAwB,CAAC;IAC1D,MAAM,CAAC,gBAAgB,CAAC,QAAgB,IAAa,OAAO,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpG,MAAM,CAAC,cAAc,CAAC,QAAgB,IAAa,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,CAAC,uBAAuB,CAAC,QAAgB,IAAa,OAAO,kBAAkB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClH,MAAM,CAAC,yBAAyB,CAAC,QAAmC,IAAY,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,wFAAwF;CACpO"}

package/dist/content/path-mimetype.d.ts

@@ -0,0 +1,5 @@
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export default class PathMimetype {
+    static resolveEntryMimetype(pathname: string, schemeDefault: string, mimetypes: Mimetypes | undefined): Promise<string>;
+}
+//# sourceMappingURL=path-mimetype.d.ts.map

package/dist/content/path-mimetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.d.ts","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtH;CACJ"}

package/dist/content/path-mimetype.js

@@ -0,0 +1,15 @@
+// Path-extension mimetype resolver for entry schemes — single source of truth
+// is @plurnk/plurnk-schemes (keystone PR-1). Local OO facade over the
+// daughter's function; call sites stay `PathMimetype.resolveEntryMimetype(...)`.
+//
+// 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.
+import { PathMimetype as _PathMimetype } from "@plurnk/plurnk-schemes";
+export default class PathMimetype {
+    static resolveEntryMimetype(pathname, schemeDefault, mimetypes) {
+        return _PathMimetype.resolve(pathname, schemeDefault, mimetypes);
+    }
+}
+//# sourceMappingURL=path-mimetype.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.js","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,iFAAiF;AACjF,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"}

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

@@ -0,0 +1,20 @@
+import type { LineMarker, MatcherBody } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export interface ReadSliceResult {
+    status: number;
+    content: string | null;
+    mimetype: string;
+    startLine?: number | null;
+    matches?: number;
+    reason?: string;
+}
+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

@@ -0,0 +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"}

package/dist/content/read-resolve.js

@@ -0,0 +1,68 @@
+// 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`).
+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;
+            }
+        }
+        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 (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 };
+    }
+}
+//# sourceMappingURL=read-resolve.js.map

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

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