@plurnk/plurnk-service 0.7.0 → 0.9.0

package/bin/plurnk-service.ts

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+
+import { parseArgs } from "node:util";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import SqlRite from "@possumtech/sqlrite";
+import type { Db } from "../src/core/Db.ts";
+import Daemon from "../src/server/Daemon.ts";
+import EnvFlags from "../src/core/EnvFlags.ts";
+import ProviderInstantiate from "../src/core/ProviderInstantiate.ts";
+import { resolveActiveAlias } from "@plurnk/plurnk-providers";
+
+export default class Cli {
+    static #projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+    static #die(code: number, message: string): never {
+        process.stderr.write(`${message}\n`);
+        process.exit(code);
+    }
+
+    static #loadEnv(path: string, required: boolean): void {
+        if (existsSync(path)) {
+            try { process.loadEnvFile(path); }
+            catch (cause) { Cli.#die(64, `failed to load ${path}: ${cause instanceof Error ? cause.message : String(cause)}`); }
+        } else if (required) {
+            Cli.#die(64, `--config: ${path} does not exist`);
+        }
+    }
+
+    // The .env cascade always populates these from .env.example, so absence is
+    // a broken config, not a runtime branch — fail hard rather than `?? ""`.
+    static #requireEnv(name: string): string {
+        const value = process.env[name];
+        if (value === undefined || value.length === 0) Cli.#die(78, `missing required env ${name} (declare it in .env.example)`);
+        return value;
+    }
+
+    static async #openDb(dbPath: string): Promise<Db> {
+        const db = await SqlRite.open({
+            path: dbPath,
+            dir: [resolve(Cli.#projectRoot, "migrations"), resolve(Cli.#projectRoot, "src")],
+        });
+        return db as unknown as Db;
+    }
+
+    static async #migrate(): Promise<void> {
+        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
+        const db = await Cli.#openDb(dbPath);
+        try { process.stdout.write(`migrated: ${dbPath}\n`); }
+        finally { await db.close(); }
+    }
+
+    static async #start(): Promise<void> {
+        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
+        const host = Cli.#requireEnv("PLURNK_HOST");
+        const port = Number(Cli.#requireEnv("PLURNK_PORT"));
+
+        const db = await Cli.#openDb(dbPath);
+        const alias = resolveActiveAlias();
+        const provider = alias === null ? null : await ProviderInstantiate.loadActiveProvider();
+        const daemon = new Daemon({ db, provider });
+        const addr = await daemon.start({ host, port });
+        const aliasStr = alias === null ? "no model" : `${alias.alias}=${alias.provider}/${alias.model}`;
+        process.stdout.write(`plurnk-service ws://${addr.host}:${addr.port} db=${dbPath} ${aliasStr}\n`);
+
+        const shutdown = async (): Promise<void> => { await daemon.stop(); await db.close(); process.exit(0); };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+
+    static async main(): Promise<void> {
+        // Env cascade: .env.example (shipped defaults) < .env (project) <
+        // .env.<config> (--config) < shell. process.loadEnvFile is set-if-unset,
+        // so loading in low→high precedence order yields the right effective env
+        // (highest precedence loads FIRST — first write wins).
+        const configFlagIndex = process.argv.findIndex((a) => a === "--config" || a.startsWith("--config="));
+        const configFile = ((): string | null => {
+            if (configFlagIndex === -1) return null;
+            const arg = process.argv[configFlagIndex];
+            if (arg.includes("=")) return arg.slice(arg.indexOf("=") + 1);
+            return process.argv[configFlagIndex + 1] ?? null;
+        })();
+
+        if (configFile !== null) Cli.#loadEnv(configFile, true);
+        Cli.#loadEnv(".env", false);
+        Cli.#loadEnv(resolve(Cli.#projectRoot, ".env.example"), false);
+
+        const flagDescriptors = await EnvFlags.parseEnvExample(resolve(Cli.#projectRoot, ".env.example"));
+        const flagOptions: Record<string, { type: "string" }> = {};
+        for (const f of flagDescriptors) {
+            flagOptions[f.flagName.replace(/^--/, "")] = { type: "string" };
+        }
+
+        const usage = `usage: plurnk-service [options] [migrate]
+
+${EnvFlags.formatFlagsHelp(flagDescriptors)}
+
+  --config=<path>  layer additional env from <path>
+  -h, --help       show this help
+`;
+
+        const { positionals, values } = parseArgs({
+            allowPositionals: true,
+            strict: false,
+            options: { help: { type: "boolean", short: "h" }, config: { type: "string" }, ...flagOptions },
+        });
+
+        for (const f of flagDescriptors) {
+            const key = f.flagName.replace(/^--/, "");
+            const v = values[key];
+            if (typeof v === "string") process.env[f.envName] = v;
+        }
+
+        if (values.help) { process.stdout.write(usage); process.exit(0); }
+
+        const dispatch: Record<string, () => Promise<void>> = { migrate: Cli.#migrate, start: Cli.#start };
+        const subcommand = typeof positionals[0] === "string" ? positionals[0] : "start";
+        const handler = dispatch[subcommand];
+        if (handler === undefined) Cli.#die(64, `unknown subcommand: ${subcommand}\n\n${usage}`);
+        if (positionals.length > 1) Cli.#die(64, `unexpected arguments: ${positionals.slice(1).join(" ")}`);
+
+        try { await handler(); }
+        catch (cause) {
+            process.stderr.write(`${subcommand}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+            if (cause instanceof Error && cause.cause) process.stderr.write(`  cause: ${cause.cause instanceof Error ? cause.cause.message : String(cause.cause)}\n`);
+            process.exit(1);
+        }
+    }
+}
+
+await Cli.main();

package/dist/Paths.d.ts

@@ -0,0 +1,8 @@
+export default class Paths {
+    #private;
+    static migrations: string;
+    static instructionsSystem: string;
+    static defaultPersona: string;
+    static defaultRequirements: 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":"AAaA,MAAM,CAAC,OAAO,OAAO,KAAK;;IAItB,MAAM,CAAC,UAAU,SAA8C;IAC/D,MAAM,CAAC,kBAAkB,SAA6C;IAKtE,MAAM,CAAC,cAAc,SAAkC;IAIvD,MAAM,CAAC,mBAAmB,SAAuC;CAuBpE"}

package/dist/Paths.js

@@ -0,0 +1,47 @@
+// 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";
+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")));
+    static migrations = resolve(Paths.#PACKAGE_ROOT, "migrations");
+    static instructionsSystem = resolve(Paths.#GRAMMAR_ROOT, "plurnk.md");
+    // packet.system.persona DEFAULT. Cascade at packet-build time is
+    //   loops.persona > runs.persona > sessions.persona > this file
+    // RPC overrides on loop.run / session.attach / session.create populate
+    // the three persistence layers; this file is the final fallback.
+    static defaultPersona = Paths.#resolveDefaultPersona();
+    // 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 persona file path: PLURNK_PERSONA env (absolute or
+    // relative-to-package-root) → `persona.md` in package root as the
+    // hardcoded fallback. The env var lets operators point at a custom
+    // persona without forking the file in PACKAGE_ROOT.
+    static #resolveDefaultPersona() {
+        const env = process.env.PLURNK_PERSONA;
+        if (typeof env === "string" && env.length > 0) {
+            return resolve(Paths.#PACKAGE_ROOT, env);
+        }
+        return resolve(Paths.#PACKAGE_ROOT, "persona.md");
+    }
+    // Same shape as #resolveDefaultPersona: `PLURNK_REQUIREMENTS` env (absolute
+    // or relative-to-package-root) overrides the in-package `requirements.md`.
+    static #resolveDefaultRequirements() {
+        const env = process.env.PLURNK_REQUIREMENTS;
+        if (typeof env === "string" && env.length > 0) {
+            return resolve(Paths.#PACKAGE_ROOT, env);
+        }
+        return resolve(Paths.#PACKAGE_ROOT, "requirements.md");
+    }
+}
+//# sourceMappingURL=Paths.js.map

package/dist/Paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../src/Paths.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,gDAAgD;AAChD,+EAA+E;AAC/E,6EAA6E;AAC7E,oCAAoC;AACpC,EAAE;AACF,8EAA8E;AAC9E,mDAAmD;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;IAE1G,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACtE,iEAAiE;IACjE,gEAAgE;IAChE,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,sBAAsB,EAAE,CAAC;IACvD,uEAAuE;IACvE,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,CAAC,mBAAmB,GAAG,KAAK,CAAC,2BAA2B,EAAE,CAAC;IAEjE,yEAAyE;IACzE,kEAAkE;IAClE,mEAAmE;IACnE,oDAAoD;IACpD,MAAM,CAAC,sBAAsB;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,CAAC,2BAA2B;QAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC"}

package/dist/content/index.d.ts

@@ -0,0 +1,9 @@
+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";
+//# 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"}

package/dist/content/index.js

@@ -0,0 +1,10 @@
+// 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";
+//# 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"}

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

@@ -0,0 +1,26 @@
+import type { LineMarker } from "@plurnk/plurnk-grammar";
+export interface SliceResult {
+    status: number;
+    text?: string;
+    startLine?: number;
+    error?: string;
+}
+export interface JsonSliceResult {
+    status: number;
+    body?: string;
+    error?: string;
+}
+export interface EditResult {
+    status: number;
+    result?: string;
+    error?: string;
+}
+export default class LineMarkerOps {
+    #private;
+    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;
+}
+//# 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":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQzD,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAClG,MAAM,WAAW,eAAe;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAClF,MAAM,WAAW,UAAU;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,CAAC,OAAO,OAAO,aAAa;;IAoC9B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW;IA+BnE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,eAAe;IAgI3E,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAsBvF,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW;IAiBtE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;CAkB5F"}

package/dist/content/line-marker.js

@@ -0,0 +1,323 @@
+// `<L>` line-marker semantics (plurnk.md §`<L>`):
+//
+//   <N>      selects position N (1-indexed)
+//   <N,M>    selects positions N..M inclusive
+//   <0>      sentinel: before position 1 (EDIT prepend)
+//   <-1>     sentinel: after the last position (EDIT append)
+//   <1,-1>   every position (in range context, -1 normalizes to last line)
+//
+// "N and M are signed integers" — but plurnk.md only documents <0> and
+// <-1> as defined sentinels. Other negatives (<-2>, <-3>) are not
+// specified and rejected as 416. Within a range, -1 as the M endpoint
+// means "include through the last line" (so <1,-1> is whole content).
+export default class LineMarkerOps {
+    static #splitLines(content) {
+        const trailingNewline = content.endsWith("\n");
+        if (content === "")
+            return { lines: [], trailingNewline: false };
+        const lines = content.split("\n");
+        if (trailingNewline)
+            lines.pop();
+        return { lines, trailingNewline };
+    }
+    static #normalize(marker, totalLines) {
+        const { first, last } = marker;
+        if (last === null) {
+            if (first === 0)
+                return { kind: "before-first", start: 0, end: 0 };
+            if (first === -1)
+                return { kind: "after-last", start: 0, end: 0 };
+            if (first > 0 && first <= totalLines)
+                return { kind: "range", start: first, end: first };
+            return { error: `line ${first} out of range (1..${totalLines})` };
+        }
+        let n = first;
+        let m = last;
+        if (n === 0)
+            n = 1;
+        if (m === -1)
+            m = totalLines;
+        if (n < 1 || n > totalLines)
+            return { error: `range start ${first} out of range (1..${totalLines})` };
+        if (m < 1 || m > totalLines)
+            return { error: `range end ${last} out of range (1..${totalLines})` };
+        if (n > m)
+            return { error: `range start ${first} > end ${last}` };
+        return { kind: "range", start: n, end: m };
+    }
+    // READ a line range. Returns the raw selected lines (no `N:\t` prefix)
+    // plus the 1-indexed position of the first selected line. The render
+    // layer adds `N:\t` per plurnk.md ("READ output prefixes every line with
+    // line numbers, N:\t") starting from `startLine` — keeps numbering as a
+    // presentation concern, prevents double-prefixing when the same content
+    // passes through the log render.
+    //
+    // Sentinel positions <0> and <-1> select no content (they're insertion
+    // points, not lines) → status 200 with empty text.
+    static sliceLines(content, marker) {
+        const { lines } = LineMarkerOps.#splitLines(content);
+        const norm = LineMarkerOps.#normalize(marker, lines.length);
+        if ("error" in norm)
+            return { status: 416, error: norm.error };
+        if (norm.kind !== "range")
+            return { status: 200, text: "", startLine: undefined };
+        const selected = lines.slice(norm.start - 1, norm.end);
+        return { status: 200, text: selected.join("\n"), startLine: norm.start };
+    }
+    // Structural `<L>` slice for JSON sources (plurnk-grammar 0.13.0).
+    // "On structured entries, <L> addresses item index, not line number."
+    // Every JSON value becomes a list of top-level items:
+    //   array `[a, b, c]`     → items are the array elements
+    //   object `{k1: v1, ...}` → items are key-value pairs (as single-key objects)
+    //   scalar `"hello"` / 42  → item is the scalar itself (length-1 list)
+    // `<L>` indexes into that list (1-indexed). Result is always a JSON array.
+    // Sentinels `<0>` / `<-1>` are insertion points — empty `[]` for READ.
+    // Out-of-range positions return 416. Matches the uniform "always JSON
+    // array out" shape we settled for matcher results.
+    static #jsonValueToItems(parsed) {
+        if (Array.isArray(parsed))
+            return parsed;
+        if (parsed !== null && typeof parsed === "object") {
+            // Object items are single-key {key: value} wrappers, in insertion
+            // order. Object.entries preserves spec-guaranteed iteration order
+            // for string keys.
+            return Object.entries(parsed).map(([k, v]) => ({ [k]: v }));
+        }
+        // Scalar (string, number, boolean, null): a length-1 list of itself.
+        return [parsed];
+    }
+    static sliceJsonItems(content, marker) {
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch (err) {
+            return { status: 400, error: `malformed JSON: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        const items = LineMarkerOps.#jsonValueToItems(parsed);
+        const total = items.length;
+        const { first, last } = marker;
+        if (last === null) {
+            if (first === 0 || first === -1)
+                return { status: 200, body: "[]" };
+            if (first > 0 && first <= total)
+                return { status: 200, body: JSON.stringify([items[first - 1]], null, 2) };
+            return { status: 416, error: `item ${first} out of range (1..${total})` };
+        }
+        let n = first;
+        let m = last;
+        if (n === 0)
+            n = 1;
+        if (m === -1)
+            m = total;
+        if (n < 1 || n > total)
+            return { status: 416, error: `range start ${first} out of range (1..${total})` };
+        if (m < 1 || m > total)
+            return { status: 416, error: `range end ${last} out of range (1..${total})` };
+        if (n > m)
+            return { status: 416, error: `range start ${first} > end ${last}` };
+        return { status: 200, body: JSON.stringify(items.slice(n - 1, m), null, 2) };
+    }
+    // Structural `<L>` EDIT for JSON sources (plurnk-grammar 0.13.0/0.14.0).
+    // Source-shape rules (matches sliceJsonItems' item definition):
+    //   array  → items are elements
+    //   object → items are key-value pairs (single-key fragments)
+    //   scalar → length-1 list of itself; grow markers (<0>,<-1>) reject
+    //
+    // Body shape (Resolution B):
+    //   body parses as JSON array → those are the items to splice in
+    //   body parses as non-array JSON → single item to splice in
+    //   empty body → delete the selection
+    //   body fails JSON parse → 400 (path-extension declares intent; honor it)
+    //
+    // Marker semantics (parallel to line-EDIT):
+    //   <N>    replace item N with body item(s)
+    //   <N,M>  replace items N..M with body item(s)
+    //   <0>    prepend body item(s)
+    //   <-1>   append body item(s)
+    //   <1,-1> replace whole top-level with body item(s); empty body clears
+    //   Empty body on a sentinel insertion (<0> or <-1>) → no-op.
+    static #itemsFromBody(body) {
+        if (body === "")
+            return { items: [] }; // empty body = delete
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch (err) {
+            return { error: `malformed JSON body: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        if (Array.isArray(parsed))
+            return { items: parsed };
+        return { items: [parsed] };
+    }
+    static #applyJsonArrayEdit(source, marker, items) {
+        const total = source.length;
+        const { first, last } = marker;
+        let result;
+        if (last === null) {
+            if (first === 0)
+                result = [...items, ...source];
+            else if (first === -1)
+                result = [...source, ...items];
+            else if (first > 0 && first <= total)
+                result = [...source.slice(0, first - 1), ...items, ...source.slice(first)];
+            else
+                return { status: 416, error: `position ${first} out of range (1..${total})` };
+        }
+        else {
+            let n = first;
+            let m = last;
+            if (n === 0)
+                n = 1;
+            if (m === -1)
+                m = total;
+            if (total === 0 && (first !== 1 || last !== -1))
+                return { status: 416, error: `range on empty array` };
+            if (n < 1 || (total > 0 && n > total))
+                return { status: 416, error: `range start ${first} out of range (1..${total})` };
+            if (m < 1 || (total > 0 && m > total))
+                return { status: 416, error: `range end ${last} out of range (1..${total})` };
+            if (n > m)
+                return { status: 416, error: `range start ${first} > end ${last}` };
+            result = [...source.slice(0, n - 1), ...items, ...source.slice(m)];
+        }
+        return { status: 200, result: JSON.stringify(result, null, 2) };
+    }
+    static #applyJsonObjectEdit(source, marker, items) {
+        // Object items are key-value pairs. Body items must be objects;
+        // each object's entries become kv-pairs to splice in. Items that
+        // aren't single objects → 400 (model used wrong body shape for an
+        // object source).
+        const bodyEntries = [];
+        for (const item of items) {
+            if (item === null || typeof item !== "object" || Array.isArray(item)) {
+                return { status: 400, error: "object source requires body items to be JSON objects (key-value pairs)" };
+            }
+            bodyEntries.push(...Object.entries(item));
+        }
+        const entries = Object.entries(source);
+        const total = entries.length;
+        const { first, last } = marker;
+        let result;
+        if (last === null) {
+            if (first === 0)
+                result = [...bodyEntries, ...entries];
+            else if (first === -1)
+                result = [...entries, ...bodyEntries];
+            else if (first > 0 && first <= total)
+                result = [...entries.slice(0, first - 1), ...bodyEntries, ...entries.slice(first)];
+            else
+                return { status: 416, error: `position ${first} out of range (1..${total})` };
+        }
+        else {
+            let n = first;
+            let m = last;
+            if (n === 0)
+                n = 1;
+            if (m === -1)
+                m = total;
+            if (total === 0 && (first !== 1 || last !== -1))
+                return { status: 416, error: `range on empty object` };
+            if (n < 1 || (total > 0 && n > total))
+                return { status: 416, error: `range start ${first} out of range (1..${total})` };
+            if (m < 1 || (total > 0 && m > total))
+                return { status: 416, error: `range end ${last} out of range (1..${total})` };
+            if (n > m)
+                return { status: 416, error: `range start ${first} > end ${last}` };
+            result = [...entries.slice(0, n - 1), ...bodyEntries, ...entries.slice(m)];
+        }
+        return { status: 200, result: JSON.stringify(Object.fromEntries(result), null, 2) };
+    }
+    static #applyJsonScalarEdit(source, marker, items) {
+        // Scalar source is a length-1 list of itself. Only `<1>` replace
+        // works cleanly; grow markers (<0>,<-1>) and ranges that imply
+        // growth/delete would require type promotion (scalar → array),
+        // which is the kind of implicit magic that bites later. Reject.
+        const { first, last } = marker;
+        if (last === null && first === 1) {
+            if (items.length === 0)
+                return { status: 200, result: "null" }; // delete the scalar
+            if (items.length === 1)
+                return { status: 200, result: JSON.stringify(items[0], null, 2) };
+            return { status: 400, error: "scalar source: <1> body must produce 0 or 1 items (no implicit promotion to array)" };
+        }
+        if (last === -1 && first === 1) {
+            // <1,-1> = whole content. Same constraints as <1> for scalars.
+            if (items.length === 0)
+                return { status: 200, result: "null" };
+            if (items.length === 1)
+                return { status: 200, result: JSON.stringify(items[0], null, 2) };
+            return { status: 400, error: "scalar source: <1,-1> body must produce 0 or 1 items (no implicit promotion to array)" };
+        }
+        return { status: 400, error: "scalar JSON source: only <1> or <1,-1> markers supported (no implicit promotion to array via grow markers)" };
+    }
+    static applyJsonItemEdit(content, marker, body) {
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch (err) {
+            return { status: 400, error: `malformed JSON source: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        const bodyResult = LineMarkerOps.#itemsFromBody(body);
+        if ("error" in bodyResult)
+            return { status: 400, error: bodyResult.error };
+        const items = bodyResult.items;
+        // Empty-body sentinel insertion is a no-op (model accidentally
+        // emitted no items at an insertion point).
+        if (items.length === 0 && marker.last === null && (marker.first === 0 || marker.first === -1)) {
+            return { status: 200, result: content };
+        }
+        if (Array.isArray(parsed))
+            return LineMarkerOps.#applyJsonArrayEdit(parsed, marker, items);
+        if (parsed !== null && typeof parsed === "object")
+            return LineMarkerOps.#applyJsonObjectEdit(parsed, marker, items);
+        return LineMarkerOps.#applyJsonScalarEdit(parsed, marker, items);
+    }
+    // COPY-style raw line slice. Returns the selected lines verbatim (no line-
+    // number prefix), trailing newline appended if any lines were selected.
+    // Used for COPY/MOVE `<L>` per SPEC.md §16.9 (source range, symmetric
+    // with READ but without the READ-output prefix that's a render concern,
+    // not a data concern).
+    static sliceLinesRaw(content, marker) {
+        const { lines } = LineMarkerOps.#splitLines(content);
+        const norm = LineMarkerOps.#normalize(marker, lines.length);
+        if ("error" in norm)
+            return { status: 416, error: norm.error };
+        if (norm.kind !== "range")
+            return { status: 200, text: "" };
+        const selected = lines.slice(norm.start - 1, norm.end);
+        const result = selected.length > 0 ? `${selected.join("\n")}\n` : "";
+        return { status: 200, text: result };
+    }
+    // EDIT applies body at the marker position:
+    //   <0>     prepend body before line 1
+    //   <-1>    append body after the last line
+    //   <N>     replace line N with body
+    //   <N,M>   replace lines N..M with body
+    //   <1,-1>  whole content (replace everything); empty body clears.
+    // Empty body with <N>/<N,M> deletes those lines.
+    static applyLineMarkerEdit(content, marker, body) {
+        const { lines, trailingNewline } = LineMarkerOps.#splitLines(content);
+        const norm = LineMarkerOps.#normalize(marker, lines.length);
+        if ("error" in norm)
+            return { status: 416, error: norm.error };
+        const bodyLines = LineMarkerOps.#splitLines(body).lines;
+        let newLines;
+        if (norm.kind === "before-first") {
+            newLines = [...bodyLines, ...lines];
+        }
+        else if (norm.kind === "after-last") {
+            newLines = [...lines, ...bodyLines];
+        }
+        else {
+            newLines = [...lines.slice(0, norm.start - 1), ...bodyLines, ...lines.slice(norm.end)];
+        }
+        let result = newLines.join("\n");
+        if (newLines.length > 0 && trailingNewline)
+            result += "\n";
+        return { status: 200, result };
+    }
+}
+//# 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":"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"}

package/dist/content/matcher.d.ts

@@ -0,0 +1,15 @@
+import type { MatcherBody } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export interface MatchResult {
+    status: number;
+    body?: string;
+    matches?: 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>;
+}
+//# 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":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,0BAA0B,CAAC;AAMtE,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,OAAO;;WAsBX,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;CAsE1B"}