@lingjingai/scriptctl 0.63.14 → 0.63.16

package/dist/usecases/script/do.js

@@ -1,186 +0,0 @@
-import * as fs from "node:fs";
-import { CliError, EXIT_INPUT, EXIT_OK, EXIT_USAGE, exists, readText, } from "../../common.js";
-import { summarizeIssues } from "../../domain/script/text-util.js";
-import { asList, strOf, } from "../../domain/script/shared.js";
-import { loadScriptForEdit, validateSession, saveScriptSession, syncValidationResult, scriptSourceText, mutationValidationWarnings, } from "./session.js";
-import { tokenizeLine, parseDoLine, doErr, lineToOp, applyPatchOperationsForSession, assertV4PlanHasExplicitNewIds, buildV4MutationPlan, } from "./lib.js";
-export async function commandDo(opts) {
-    const file = strOf(asList(opts["_args"])[0]);
-    let text;
-    if (!file || file === "-") {
-        // No pipe on an interactive terminal: reading fd 0 would block forever
-        // waiting for keyboard input. Fail fast instead.
-        if (process.stdin.isTTY) {
-            throw new CliError("no verb script piped to stdin.", {
-                exitCode: EXIT_USAGE,
-                errorCode: "DO_NO_INPUT",
-                hint: "Pass a file (scriptctl do edits.txt) or pipe one (… | scriptctl do -).",
-                data: { expected: ["a file path or piped stdin"], actual: ["<tty, no pipe>"] },
-            });
-        }
-        try {
-            text = fs.readFileSync(0, "utf-8");
-        }
-        catch {
-            throw new CliError("no verb script on stdin.", {
-                exitCode: EXIT_USAGE,
-                errorCode: "DO_NO_INPUT",
-                hint: "Pass a file (scriptctl do edits.txt) or pipe one (… | scriptctl do -).",
-                data: { expected: ["a file path or piped stdin"], actual: ["<no stdin>"] },
-            });
-        }
-    }
-    else {
-        if (!exists(file)) {
-            throw new CliError("verb-script file not found.", {
-                exitCode: EXIT_INPUT,
-                errorCode: "DO_FILE_NOT_FOUND",
-                hint: "Check the path, or pipe via stdin with `-`.",
-                data: { expected: ["an existing file"], actual: [file] },
-            });
-        }
-        text = readText(file);
-    }
-    const session = await loadScriptForEdit(opts);
-    // Parse: one CLI verb per line; blank lines and `#` comments ignored. Line
-    // numbers are reported on parse errors so the agent can locate the bad line.
-    const ops = [];
-    const rawLines = text.split("\n");
-    for (let ln = 0; ln < rawLines.length; ln++) {
-        const trimmed = rawLines[ln].trim();
-        if (!trimmed || trimmed.startsWith("#"))
-            continue;
-        const tokens = tokenizeLine(rawLines[ln]);
-        if (tokens.length === 0)
-            continue;
-        try {
-            const { verb, args, flags } = parseDoLine(tokens);
-            ops.push(lineToOp(verb, args, flags, session.version));
-        }
-        catch (err) {
-            const detail = err instanceof CliError ? err.message : String(err);
-            throw new CliError(`line ${ln + 1}: ${detail}`, {
-                exitCode: EXIT_USAGE,
-                errorCode: "DO_LINE_INVALID",
-                hint: "Fix this line; the whole script is one transaction (nothing is written until every line is valid).",
-                data: { expected: ["a valid verb line"], actual: [rawLines[ln].trim()] },
-            });
-        }
-    }
-    if (ops.length === 0) {
-        throw new CliError("no verb lines found.", {
-            exitCode: EXIT_USAGE,
-            errorCode: "DO_EMPTY",
-            hint: "Provide one CLI verb per line (without the leading `scriptctl`).",
-            data: { expected: ["at least one verb line"], actual: ["<empty>"] },
-        });
-    }
-    const apply = Boolean(opts["apply"]);
-    if (session.version === 4)
-        assertV4PlanHasExplicitNewIds(ops);
-    const workspace = strOf(opts["workspace_path"] || "workspace");
-    const planned = session.version === 4 ? buildV4MutationPlan(session, ops) : null;
-    const planDigest = planned?.digest ?? null;
-    const suppliedPlan = strOf(opts["plan"]).trim();
-    if (session.version === 3 && suppliedPlan) {
-        throw new CliError("Script v3 do transactions do not use plan digests.", {
-            exitCode: EXIT_USAGE,
-            errorCode: "MULTI_PLAN_USAGE_INVALID",
-            hint: "Remove --plan; omit --apply to preview a Script v3 do transaction.",
-            data: { actual: [suppliedPlan] },
-        });
-    }
-    if (session.version === 4 && apply && !suppliedPlan) {
-        throw new CliError("A Script v4 do transaction requires its dry-run plan digest.", {
-            exitCode: EXIT_USAGE,
-            errorCode: "MULTI_PLAN_REQUIRED",
-            data: { expected: [planDigest ?? ""], actual: ["<missing>"] },
-        });
-    }
-    if (session.version === 4 && apply && suppliedPlan !== planDigest) {
-        throw new CliError("The supplied digest does not match the current operations.", {
-            exitCode: EXIT_INPUT,
-            errorCode: "MULTI_PLAN_MISMATCH",
-            data: { expected: [planDigest ?? ""], actual: [suppliedPlan] },
-        });
-    }
-    if (session.version === 4 && !apply && suppliedPlan) {
-        throw doErr("--plan is only valid with --apply");
-    }
-    // One transaction: all ops are applied before the single write. Any op
-    // throwing aborts before persistence — all-or-nothing.
-    const applied = planned?.applied
-        ?? applyPatchOperationsForSession(session, scriptSourceText(workspace), ops);
-    if (planned && apply) {
-        applyPatchOperationsForSession(session, scriptSourceText(workspace), ops);
-    }
-    const head = [`lines: ${ops.length} op(s)`, `${apply ? "applied" : "would-apply"}: ${applied.length}`];
-    if (!apply) {
-        const legacyValidation = planned ? null : validateSession(session);
-        const passed = planned
-            ? planned.plan.validation.ok
-            : Boolean(legacyValidation?.["passed"]);
-        const plannedIssueLines = planned
-            ? [...planned.plan.validation.errors, ...planned.plan.validation.warnings]
-                .map((issue) => `${issue.path}: ${issue.code} - ${issue.message}`)
-            : null;
-        const legacyIssueLines = legacyValidation === null
-            ? []
-            : summarizeIssues(asList(legacyValidation["issues"]));
-        const issues = plannedIssueLines ?? legacyIssueLines;
-        const hint = planDigest
-            ? `Run \`scriptctl do --apply --plan ${planDigest}\` with the same input to commit${passed ? "." : "; validation issues will remain available as follow-up diagnostics."}`
-            : `Run \`scriptctl do --apply\` with the same input to commit${passed ? "." : "; validation issues will remain available as follow-up diagnostics."}`;
-        const lines = [...head, `validation: ${passed ? "would pass" : "would need repair"}; no write`, ...issues, hint];
-        const report = {
-            text: lines.join("\n"),
-            data: {
-                op: "script.do.dry-run",
-                changed: false,
-                matched: ops.length,
-                applied: applied.length,
-                issues,
-                script_path: session.artifactLabel,
-                ...(planDigest ? {
-                    baseline: session.baselineHash,
-                    plan_digest: planDigest,
-                    operations: ops,
-                    targets: planned?.plan.targets,
-                    plan: planned?.plan,
-                } : {}),
-            },
-        };
-        return [report, EXIT_OK];
-    }
-    const [newRevision, idempotent] = await saveScriptSession(session, opts, "do");
-    const validation = validateSession(session);
-    await syncValidationResult(session, validation, newRevision);
-    const passed = Boolean(validation["passed"]);
-    const warnings = mutationValidationWarnings(session, validation);
-    const rev = session.remote ? `; rev ${newRevision}` : "";
-    const issues = summarizeIssues(asList(validation["issues"]));
-    const warningLines = summarizeIssues(warnings);
-    const lines = [...head, `validation: ${passed ? "passed" : "needs repair"}${rev}`, ...warningLines];
-    const report = {
-        text: lines.join("\n"),
-        data: {
-            op: "script.do",
-            changed: applied.length > 0,
-            revision: session.remote ? newRevision : undefined,
-            idempotent: session.remote ? idempotent : undefined,
-            validation,
-            issues,
-            warnings,
-            script_path: session.artifactLabel,
-            ...(planDigest ? {
-                baseline: session.baselineHash,
-                plan_digest: planDigest,
-                operations: ops,
-                targets: planned?.plan.targets,
-                plan: planned?.plan,
-            } : {}),
-        },
-    };
-    return [report, EXIT_OK];
-}
-//# sourceMappingURL=do.js.map

package/dist/usecases/script/do.js.map

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

package/dist/usecases/script/emotion.d.ts

@@ -1,3 +0,0 @@
-import { type CommandOutput } from "../../common.js";
-import { type Dict } from "../../domain/script/shared.js";
-export declare function commandEmotion(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/emotion.js

@@ -1,24 +0,0 @@
-import { CliError, EXIT_USAGE } from "../../common.js";
-import { asList } from "../../domain/script/shared.js";
-import { applySelectorEditsToSession, applySingleScriptOpToSession, emotionTemplate, selectionHasAnyFilter, } from "./lib.js";
-import { loadScriptForEdit } from "./session.js";
-export async function commandEmotion(opts) {
-    const args = asList(opts["_args"]);
-    const selectorMode = selectionHasAnyFilter(opts);
-    const session = await loadScriptForEdit(opts);
-    if (session.version !== 3) {
-        throw new CliError("emotion is a Script v3 field.", {
-            exitCode: EXIT_USAGE,
-            errorCode: "EMOTION_VERSION_UNSUPPORTED",
-            hint: "Use `scriptctl parenthetical <action-id> --set <text>` or `--remove`.",
-            data: { actual: ["script version 4"] },
-        });
-    }
-    // Single-point: `emotion <at> <emotion>`; selector: `emotion <emotion>`.
-    const emotion = selectorMode ? args[0] : args[1];
-    const template = emotionTemplate({ emotion, clear: Boolean(opts["clear"]) });
-    if (selectorMode)
-        return applySelectorEditsToSession(session, opts, template, "emotion");
-    return applySingleScriptOpToSession(session, opts, { ...template, at: args[0] });
-}
-//# sourceMappingURL=emotion.js.map

package/dist/usecases/script/emotion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"emotion.js","sourceRoot":"","sources":["../../../src/usecases/script/emotion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAsB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAa,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,+BAA+B,EAAE;YAC5C,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,6BAA6B;YACxC,IAAI,EAAE,uEAAuE;YAC7E,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE;SACvC,CAAC,CAAC;IACX,CAAC;IACD,yEAAyE;IACzE,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,IAAI,YAAY;QAAE,OAAO,2BAA2B,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzF,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/usecases/script/episodes.d.ts

@@ -1,3 +0,0 @@
-import { type CommandOutput } from "../../common.js";
-import { type Dict } from "../../domain/script/shared.js";
-export declare function commandEpisodes(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/episodes.js

@@ -1,62 +0,0 @@
-import { EXIT_OK, } from "../../common.js";
-import { parseInSelector, } from "../../domain/script/selector.js";
-import { asList, strOf, } from "../../domain/script/shared.js";
-import { loadScriptForEdit, parseBound, episodeCharCounts, } from "./session.js";
-import { buildTableReport, synopsisPreview, episodeInSelector, } from "./lib.js";
-import { normalizeV3QuerySelector } from "../../domain/script/v3/ordinal.js";
-import { requireStructurallyReadableScriptV4 } from "../../domain/script/v4/parse.js";
-import { parseV4Selector } from "../../domain/script/v4/selector.js";
-export async function commandEpisodes(opts) {
-    const session = await loadScriptForEdit(opts);
-    const script = session.script;
-    const itemId = strOf(opts["id"]).trim();
-    const selector = session.version === 3
-        ? parseInSelector(normalizeV3QuerySelector(script, opts["in"]))
-        : null;
-    const selectorV4 = session.version === 4
-        ? parseV4Selector(requireStructurallyReadableScriptV4(script), opts["in"], { allowOrdinals: true })
-        : null;
-    const minChars = parseBound(opts["min_chars"]);
-    const maxChars = parseBound(opts["max_chars"]);
-    const lines = [];
-    const rows = [];
-    for (const [episodeIndex, ep] of asList(script["episodes"]).entries()) {
-        const epId = strOf(ep["episode_id"]);
-        if (itemId && itemId !== epId)
-            continue;
-        const scenes = asList(ep["scenes"]);
-        if (selector !== null && !episodeInSelector(selector, epId, scenes))
-            continue;
-        if (selectorV4 !== null && !selectorV4.matchesEpisode(epId))
-            continue;
-        let actionCount = 0;
-        const chars = episodeCharCounts(scenes);
-        for (const scene of scenes)
-            actionCount += asList(scene["actions"]).length;
-        if (minChars !== null && chars.total < minChars)
-            continue;
-        if (maxChars !== null && chars.total > maxChars)
-            continue;
-        const epSynopsis = strOf(ep["synopsis"]).trim();
-        const synopsisField = epSynopsis ? `, synopsis=${synopsisPreview(epSynopsis, 60)}` : "";
-        lines.push(`${ep["episode_id"]}: scenes=${scenes.length}, actions=${actionCount}, chars=${chars.total} (dialogue=${chars.dialogue}, action=${chars.action}), title=${ep["title"] || "-"}${synopsisField}`);
-        rows.push({
-            addr: epId,
-            ep_no: episodeIndex + 1,
-            episode_id: epId,
-            title: strOf(ep["title"]),
-            scenes: scenes.length,
-            actions: actionCount,
-            chars_total: chars.total,
-            chars_dialogue: chars.dialogue,
-            chars_action: chars.action,
-            synopsis: epSynopsis,
-        });
-    }
-    return [
-        buildTableReport("query.episodes", lines, ["addr", "ep_no", "episode_id", "title", "scenes", "actions", "chars_total", "chars_dialogue", "chars_action", "synopsis"], rows),
-        EXIT_OK,
-    ];
-}
-// ----- scenes ---------------------------------------------------------------
-//# sourceMappingURL=episodes.js.map

package/dist/usecases/script/episodes.js.map

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

package/dist/usecases/script/export-authoring.d.ts

@@ -1,4 +0,0 @@
-import { type CommandOutput } from "../../common.js";
-import { type Dict } from "../../domain/script/shared.js";
-export type AuthoringExportKind = "script" | "episodes" | "episode-spans" | "scenes" | "scene-spans" | "action-spans";
-export declare function commandExportAuthoring(kind: AuthoringExportKind, opts: Dict): [CommandOutput, number];

package/dist/usecases/script/export-authoring.js

@@ -1,326 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { CliError, EXIT_INPUT, EXIT_OK, EXIT_USAGE, scriptJsonPath, } from "../../common.js";
-import { GENERATED_SOURCE, scriptExportDocument, targetExportDocument, } from "../../domain/authoring/v3/export.js";
-import { serializeAuthoring } from "../../domain/authoring/v3/serializer.js";
-import { requireScriptV3 } from "../../domain/script/v3/parse.js";
-import { requireStructurallyReadableScriptDocument, } from "../../domain/script/dispatch.js";
-import { requireStructurallyReadableScriptV4 } from "../../domain/script/v4/parse.js";
-import { serializeAuthoringV4 } from "../../domain/authoring/v4/serializer.js";
-import { strOf } from "../../domain/script/shared.js";
-import { atomicWriteText } from "../../infra/script-working-copy.js";
-function blocked(code, message, received, next, exitCode = EXIT_INPUT) {
-    throw new CliError(message, {
-        exitCode,
-        errorCode: code,
-        hint: next,
-        data: { actual: received },
-    });
-}
-function readScript(opts) {
-    const scriptPath = scriptJsonPath(opts);
-    let value;
-    try {
-        value = JSON.parse(fs.readFileSync(scriptPath, "utf-8"));
-    }
-    catch (error) {
-        blocked("SCRIPT_JSON_UNAVAILABLE", "The local script cannot be read as JSON.", [
-            scriptPath,
-            error instanceof Error ? error.message : String(error),
-        ], "Provide a readable local Script v3 file.");
-    }
-    return requireStructurallyReadableScriptDocument(value);
-}
-function regions(raw) {
-    if (!raw)
-        blocked("AUTHORING_SELECTOR_REQUIRED", "This export kind requires --in.", ["<missing>"], "Pass one or more comma-separated point or from..through regions.", EXIT_USAGE);
-    return raw.split(",").map((part) => {
-        const value = part.trim();
-        if (!value)
-            blocked("AUTHORING_SELECTOR_INVALID", "Selector contains an empty region.", [raw], "Remove empty comma-separated regions.", EXIT_USAGE);
-        const delimiter = value.indexOf("..");
-        if (delimiter < 0)
-            return { from: value, through: value };
-        if (value.indexOf("..", delimiter + 2) >= 0)
-            blocked("AUTHORING_SELECTOR_INVALID", "Selector region has more than one range delimiter.", [value], "Use point or from..through.", EXIT_USAGE);
-        const from = value.slice(0, delimiter);
-        const through = value.slice(delimiter + 2);
-        if (!from || !through)
-            blocked("AUTHORING_SELECTOR_INVALID", "Selector range endpoint is empty.", [value], "Provide both endpoints.", EXIT_USAGE);
-        return { from, through };
-    });
-}
-function rangeIndices(ids, region, label) {
-    if (region.from === "*" && region.through === "*") {
-        if (ids.length === 0)
-            blocked("AUTHORING_SELECTOR_EMPTY", `The script contains no ${label}.`, ["*"], "Choose a non-empty target kind.");
-        return [0, ids.length - 1];
-    }
-    if (ids.filter((id) => id === region.from).length > 1
-        || ids.filter((id) => id === region.through).length > 1) {
-        blocked("AUTHORING_SELECTOR_AMBIGUOUS", `${label} selector endpoint is not unique.`, [region.from, region.through], "Repair duplicate stable IDs before exporting this target.");
-    }
-    const from = ids.indexOf(region.from);
-    const through = ids.indexOf(region.through);
-    if (from < 0 || through < 0)
-        blocked("AUTHORING_SELECTOR_NOT_FOUND", `${label} selector endpoint was not found.`, [region.from, region.through], "Use IDs from the current local script.");
-    if (from > through)
-        blocked("AUTHORING_SELECTOR_REVERSED", `${label} selector is reversed in current document order.`, [region.from, region.through], "Put the earlier document endpoint first.");
-    return [from, through];
-}
-function uniqueTargets(values, key) {
-    const seen = new Set();
-    for (const value of values) {
-        const id = key(value);
-        if (seen.has(id))
-            blocked("AUTHORING_SELECTOR_OVERLAP", "Selector regions overlap or repeat a target.", [id], "Use non-overlapping regions.");
-        seen.add(id);
-    }
-    return values;
-}
-function assertIncreasing(coordinates, label) {
-    for (let index = 1; index < coordinates.length; index += 1) {
-        const previous = coordinates[index - 1];
-        const current = coordinates[index];
-        const length = Math.max(previous.length, current.length);
-        let comparison = 0;
-        for (let part = 0; part < length; part += 1) {
-            comparison = (current[part] ?? 0) - (previous[part] ?? 0);
-            if (comparison !== 0)
-                break;
-        }
-        if (comparison <= 0) {
-            blocked("AUTHORING_SELECTOR_ORDER", `${label} selector regions are not in current document order.`, [
-                `region=${index + 1}`,
-            ], "List disjoint selector regions from earlier to later document positions.");
-        }
-    }
-}
-function episodeDocument(script, raw) {
-    const selected = [];
-    const ids = script.episodes.map((episode) => episode.episode_id);
-    for (const region of regions(raw)) {
-        const [from, through] = rangeIndices(ids, region, "episode");
-        selected.push(...script.episodes.slice(from, through + 1));
-    }
-    uniqueTargets(selected, (episode) => episode.episode_id);
-    assertIncreasing(selected.map((episode) => [ids.indexOf(episode.episode_id)]), "Episode");
-    const targets = selected.map((episode) => ({
-        kind: "episode",
-        value: structuredClone(episode),
-        source: GENERATED_SOURCE,
-    }));
-    return targetExportDocument("episode", targets);
-}
-function episodeSpanDocument(script, raw) {
-    const ids = script.episodes.map((episode) => episode.episode_id);
-    const targets = [];
-    const occupied = new Set();
-    const coordinates = [];
-    for (const region of regions(raw)) {
-        const [from, through] = rangeIndices(ids, region, "episode");
-        for (let index = from; index <= through; index += 1) {
-            if (occupied.has(index))
-                blocked("AUTHORING_SELECTOR_OVERLAP", "Episode span regions overlap.", [`${region.from}..${region.through}`], "Use non-overlapping regions.");
-            occupied.add(index);
-        }
-        targets.push({
-            kind: "episode-span",
-            from: ids[from],
-            through: ids[through],
-            episodes: structuredClone(script.episodes.slice(from, through + 1)),
-            source: GENERATED_SOURCE,
-        });
-        coordinates.push([from]);
-    }
-    assertIncreasing(coordinates, "Episode span");
-    return targetExportDocument("episode-span", targets);
-}
-function sceneEntries(script) {
-    return script.episodes.flatMap((episode) => episode.scenes.map((scene) => ({
-        episodeId: episode.episode_id,
-        scene,
-    })));
-}
-function sceneAddress(entry) {
-    return `${entry.episodeId}/${entry.scene.scene_id}`;
-}
-function sceneDocument(script, raw) {
-    const entries = sceneEntries(script);
-    const ids = entries.map(sceneAddress);
-    const selected = [];
-    for (const region of regions(raw)) {
-        const [from, through] = rangeIndices(ids, region, "scene");
-        selected.push(...entries.slice(from, through + 1));
-    }
-    uniqueTargets(selected, sceneAddress);
-    assertIncreasing(selected.map((entry) => [ids.indexOf(sceneAddress(entry))]), "Scene");
-    const targets = selected.map((entry) => ({
-        kind: "scene",
-        parent: entry.episodeId,
-        value: structuredClone(entry.scene),
-        source: GENERATED_SOURCE,
-    }));
-    return targetExportDocument("scene", targets);
-}
-function parseSceneAddress(raw) {
-    const match = /^([^/#]+)\/([^/#]+)$/.exec(raw);
-    if (!match)
-        blocked("AUTHORING_SELECTOR_INVALID", "Scene selector endpoint must be ep/scn.", [raw], "Use ep_ID/scn_ID.");
-    return { episodeId: match[1], sceneId: match[2] };
-}
-function sceneSpanDocument(script, raw) {
-    const targets = [];
-    const occupied = new Set();
-    const coordinates = [];
-    for (const region of regions(raw)) {
-        if (region.from === "*" || region.through === "*")
-            blocked("AUTHORING_SELECTOR_INVALID", "A scene span wildcard has no single parent.", ["*"], "Use one explicit region per episode.");
-        const fromAddress = parseSceneAddress(region.from);
-        const throughAddress = parseSceneAddress(region.through);
-        if (fromAddress.episodeId !== throughAddress.episodeId)
-            blocked("AUTHORING_SELECTOR_CROSS_PARENT", "A scene span must remain inside one episode.", [region.from, region.through], "Split it into one region per episode.");
-        const matchingEpisodes = script.episodes.filter((candidate) => candidate.episode_id === fromAddress.episodeId);
-        if (matchingEpisodes.length === 0)
-            blocked("AUTHORING_SELECTOR_NOT_FOUND", "Scene span parent episode was not found.", [fromAddress.episodeId], "Use an existing episode ID.");
-        if (matchingEpisodes.length > 1)
-            blocked("AUTHORING_SELECTOR_AMBIGUOUS", "Scene span parent episode is not unique.", [fromAddress.episodeId], "Repair duplicate stable IDs before exporting.");
-        const episode = matchingEpisodes[0];
-        const ids = episode.scenes.map((scene) => scene.scene_id);
-        const [from, through] = rangeIndices(ids, { from: fromAddress.sceneId, through: throughAddress.sceneId }, "scene");
-        for (let index = from; index <= through; index += 1) {
-            const address = `${episode.episode_id}/${ids[index]}`;
-            if (occupied.has(address))
-                blocked("AUTHORING_SELECTOR_OVERLAP", "Scene span regions overlap.", [address], "Use non-overlapping regions.");
-            occupied.add(address);
-        }
-        targets.push({
-            kind: "scene-span",
-            parent: episode.episode_id,
-            from: ids[from],
-            through: ids[through],
-            scenes: structuredClone(episode.scenes.slice(from, through + 1)),
-            source: GENERATED_SOURCE,
-        });
-        coordinates.push([script.episodes.indexOf(episode), from]);
-    }
-    assertIncreasing(coordinates, "Scene span");
-    return targetExportDocument("scene-span", targets);
-}
-function parseActionAddress(raw) {
-    const match = /^([^/#]+\/[^/#]+)#(\d+)$/.exec(raw);
-    if (!match)
-        blocked("AUTHORING_SELECTOR_INVALID", "Action selector endpoint must be ep/scn#index.", [raw], "Use a zero-based ep_ID/scn_ID#index address.");
-    const index = Number(match[2]);
-    if (!Number.isSafeInteger(index))
-        blocked("AUTHORING_SELECTOR_INVALID", "Action index is outside the safe integer range.", [raw], "Use a zero-based safe integer index.");
-    return { parent: match[1], index };
-}
-function actionSpanDocument(script, raw) {
-    const targets = [];
-    const occupied = new Set();
-    const coordinates = [];
-    for (const region of regions(raw)) {
-        if (region.from === "*" || region.through === "*")
-            blocked("AUTHORING_SELECTOR_INVALID", "An action span wildcard has no single parent.", ["*"], "Use one explicit region per scene.");
-        const fromAddress = parseActionAddress(region.from);
-        const throughAddress = parseActionAddress(region.through);
-        if (fromAddress.parent !== throughAddress.parent)
-            blocked("AUTHORING_SELECTOR_CROSS_PARENT", "An action span must remain inside one scene.", [region.from, region.through], "Split it into one region per scene.");
-        const sceneAddressValue = parseSceneAddress(fromAddress.parent);
-        const matchingEpisodes = script.episodes.filter((candidate) => candidate.episode_id === sceneAddressValue.episodeId);
-        if (matchingEpisodes.length === 0)
-            blocked("AUTHORING_SELECTOR_NOT_FOUND", "Action span parent episode was not found.", [sceneAddressValue.episodeId], "Use an existing episode ID.");
-        if (matchingEpisodes.length > 1)
-            blocked("AUTHORING_SELECTOR_AMBIGUOUS", "Action span parent episode is not unique.", [sceneAddressValue.episodeId], "Repair duplicate stable IDs before exporting.");
-        const episode = matchingEpisodes[0];
-        const matchingScenes = episode.scenes.filter((candidate) => candidate.scene_id === sceneAddressValue.sceneId);
-        if (matchingScenes.length === 0)
-            blocked("AUTHORING_SELECTOR_NOT_FOUND", "Action span parent scene was not found.", [fromAddress.parent], "Use an existing scene address.");
-        if (matchingScenes.length > 1)
-            blocked("AUTHORING_SELECTOR_AMBIGUOUS", "Action span parent scene is not unique.", [fromAddress.parent], "Repair duplicate stable IDs before exporting.");
-        const scene = matchingScenes[0];
-        if (fromAddress.index > throughAddress.index)
-            blocked("AUTHORING_SELECTOR_REVERSED", "Action span is reversed.", [region.from, region.through], "Put the lower current action index first.");
-        if (throughAddress.index >= scene.actions.length)
-            blocked("AUTHORING_SELECTOR_NOT_FOUND", "Action span endpoint is outside the current body.", [region.through, `actions=${scene.actions.length}`], "Use current zero-based action indices.");
-        for (let index = fromAddress.index; index <= throughAddress.index; index += 1) {
-            const address = `${fromAddress.parent}#${index}`;
-            if (occupied.has(address))
-                blocked("AUTHORING_SELECTOR_OVERLAP", "Action span regions overlap.", [address], "Use non-overlapping regions.");
-            occupied.add(address);
-        }
-        targets.push({
-            kind: "action-span",
-            parent: fromAddress.parent,
-            from: fromAddress.index,
-            through: throughAddress.index,
-            actions: structuredClone(scene.actions.slice(fromAddress.index, throughAddress.index + 1)),
-            source: GENERATED_SOURCE,
-        });
-        coordinates.push([
-            script.episodes.indexOf(episode),
-            episode.scenes.indexOf(scene),
-            fromAddress.index,
-        ]);
-    }
-    assertIncreasing(coordinates, "Action span");
-    return targetExportDocument("action-span", targets);
-}
-export function commandExportAuthoring(kind, opts) {
-    const outputRaw = strOf(opts["output"]).trim();
-    if (!outputRaw)
-        blocked("AUTHORING_OUTPUT_REQUIRED", "Export requires --output.", ["<missing>"], "Pass a destination .scriptctl file.", EXIT_USAGE);
-    const script = readScript(opts);
-    const selector = strOf(opts["in"]).trim();
-    const outputPath = path.resolve(outputRaw);
-    if (script.version === 4) {
-        const exported = serializeAuthoringV4(requireStructurallyReadableScriptV4(script), kind, selector);
-        atomicWriteText(outputPath, exported.content);
-        return [{
-                text: `Exported ${exported.targetCount} ${kind} target(s) to ${outputPath}`,
-                data: {
-                    op: `export.${kind}`,
-                    output: outputPath,
-                    target_kind: kind === "episodes" ? "episode"
-                        : kind === "episode-spans" ? "episode-span"
-                            : kind === "scenes" ? "scene"
-                                : kind === "scene-spans" ? "scene-span"
-                                    : kind === "action-spans" ? "action-span"
-                                        : "script",
-                    target_count: exported.targetCount,
-                    bytes: Buffer.byteLength(exported.content),
-                    script_version: 4,
-                },
-            }, EXIT_OK];
-    }
-    const scriptV3 = requireScriptV3(script);
-    let document;
-    if (kind === "script")
-        document = scriptExportDocument(scriptV3);
-    else if (kind === "episodes")
-        document = episodeDocument(scriptV3, selector);
-    else if (kind === "episode-spans")
-        document = episodeSpanDocument(scriptV3, selector);
-    else if (kind === "scenes")
-        document = sceneDocument(scriptV3, selector);
-    else if (kind === "scene-spans")
-        document = sceneSpanDocument(scriptV3, selector);
-    else
-        document = actionSpanDocument(scriptV3, selector);
-    const content = serializeAuthoring(document);
-    atomicWriteText(outputPath, content);
-    const report = {
-        text: `Exported ${document.targets.length} ${kind} target(s) to ${outputPath}`,
-        data: {
-            op: `export.${kind}`,
-            output: outputPath,
-            target_kind: document.targetKind,
-            target_count: document.targets.length,
-            bytes: Buffer.byteLength(content),
-            script_version: 3,
-        },
-    };
-    return [report, EXIT_OK];
-}
-//# sourceMappingURL=export-authoring.js.map