@lingjingai/scriptctl 0.20.0 → 0.21.0

package/dist/usecases/script/delete.js

@@ -0,0 +1,79 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { parseAnyAddress, } from "../../domain/script/address.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandDelete(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: Address missing", "Address missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["address"],
+            received: ["<empty>"],
+            nextSteps: ["Pass an address (action / scene / asset / speaker)."],
+            errorCode: "ADDRESS_MISSING",
+        });
+    }
+    const addr = parseAnyAddress(args[0]);
+    // Per-kind flag whitelist — silently ignoring wrong-kind flags hid real
+    // misuse (e.g. `delete actor:X --force` did NOT bypass ref protection, but
+    // the user assumed it did). Surface the mismatch with an explicit error.
+    const flagsUsed = {
+        strategy: opts["strategy"] !== undefined,
+        replacement: opts["replacement"] !== undefined,
+        force: Boolean(opts["force"]),
+    };
+    function rejectFlags(kind, allowed) {
+        const allow = new Set(allowed);
+        const bad = [];
+        for (const f of ["strategy", "replacement", "force"]) {
+            if (flagsUsed[f] && !allow.has(f))
+                bad.push(`--${f}`);
+        }
+        if (bad.length > 0) {
+            throw new CliError("VERB BLOCKED: flag not applicable", `${bad.join(", ")} cannot be used with ${kind} delete.`, {
+                exitCode: EXIT_USAGE,
+                required: [`for ${kind} delete: ${allowed.length === 0 ? "no extra flags" : allowed.map((f) => `--${f}`).join(" / ")}`],
+                received: bad,
+                nextSteps: ["Drop the unsupported flag(s) and retry."],
+                errorCode: "DELETE_FLAG_INVALID",
+            });
+        }
+    }
+    const op = (() => {
+        if (addr.kind === "action") {
+            rejectFlags("action", []);
+            return { op: "action.delete", at: args[0] };
+        }
+        if (addr.kind === "scene") {
+            rejectFlags("scene", ["force"]);
+            return { op: "scene.delete", at: args[0], force: Boolean(opts["force"]) };
+        }
+        if (addr.kind === "asset") {
+            rejectFlags("asset", ["strategy", "replacement"]);
+            return {
+                op: "asset.delete",
+                target: args[0],
+                strategy: opts["strategy"],
+                replacement: opts["replacement"],
+            };
+        }
+        if (addr.kind === "speaker") {
+            rejectFlags("speaker", ["strategy", "replacement"]);
+            return {
+                op: "speaker.delete",
+                target: addr.speakerId,
+                strategy: opts["strategy"],
+                replacement: opts["replacement"],
+            };
+        }
+        throw new CliError("VERB BLOCKED: delete cannot operate on this address", "delete cannot operate on this address.", {
+            exitCode: EXIT_USAGE,
+            required: ["action / scene / asset / speaker address"],
+            received: [args[0]],
+            nextSteps: ["Use a supported address."],
+            errorCode: "ADDRESS_UNSUPPORTED",
+        });
+    })();
+    return applySingleScriptOp(opts, op);
+}
+//# sourceMappingURL=delete.js.map

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

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

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

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

package/dist/usecases/script/describe.js

@@ -0,0 +1,31 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { parseAnyAddress, } from "../../domain/script/address.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandDescribe(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 2) {
+        throw new CliError("VERB BLOCKED: Describe args missing", "Describe args missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<addr> <text>"],
+            received: args,
+            nextSteps: ["Example: scriptctl describe actor:act_001 \"男主\" or scriptctl describe actor:act_001/st_calm \"...\""],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const addr = parseAnyAddress(args[0]);
+    if (addr.kind === "state") {
+        return applySingleScriptOp(opts, { op: "state.describe", target: args[0], description: args[1] });
+    }
+    if (addr.kind === "asset") {
+        return applySingleScriptOp(opts, { op: "asset.describe", target: args[0], description: args[1] });
+    }
+    throw new CliError("VERB BLOCKED: describe address invalid", "describe address invalid.", {
+        exitCode: EXIT_USAGE,
+        required: ["asset address (e.g. actor:act_001) or state address (e.g. actor:act_001/st_calm)"],
+        received: [args[0]],
+        nextSteps: ["Use a supported address."],
+        errorCode: "ADDRESS_UNSUPPORTED",
+    });
+}
+//# sourceMappingURL=describe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/usecases/script/describe.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACL,eAAe,GAKhB,MAAM,gCAAgC,CAAC;AAiBxC,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,qCAAqC,EAAE,wBAAwB,EAAE;YAClF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,eAAe,CAAC;YAC3B,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,sGAAsG,CAAC;YACnH,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,wCAAwC,EAAE,2BAA2B,EAAE;QACxF,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,CAAC,kFAAkF,CAAC;QAC9F,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;QACpB,SAAS,EAAE,CAAC,0BAA0B,CAAC;QACvC,SAAS,EAAE,qBAAqB;KACjC,CAAC,CAAC;AACL,CAAC"}

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

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

package/dist/usecases/script/dialogue.js

@@ -0,0 +1,28 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, splitSpeakerList, } from "./lib.js";
+import { dialogueTemplate } from "./lib.js";
+export async function commandDialogue(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: dialogue action ref missing", "dialogue action ref missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<action-addr>"],
+            received: ["<empty>"],
+            nextSteps: ["Example: scriptctl dialogue ep_001/scn_001#3 --speakers spk_001"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const speakers = splitSpeakerList(opts["speakers"]);
+    if (speakers.length === 0) {
+        throw new CliError("VERB BLOCKED: --speakers required", "--speakers required.", {
+            exitCode: EXIT_USAGE,
+            required: ["--speakers id1[,id2,...]"],
+            received: ["<empty>"],
+            nextSteps: ["Pass one or more speaker ids."],
+            errorCode: "SPEAKERS_EMPTY",
+        });
+    }
+    return applySingleScriptOp(opts, { ...dialogueTemplate(speakers, { delivery: opts["delivery"] }), at: args[0] });
+}
+//# sourceMappingURL=dialogue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue.js","sourceRoot":"","sources":["../../../src/usecases/script/dialogue.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,EAAwS,gBAAgB,GAChe,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,2CAA2C,EAAE,8BAA8B,EAAE;YAC9F,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,eAAe,CAAC;YAC3B,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,iEAAiE,CAAC;YAC9E,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE,sBAAsB,EAAE;YAC9E,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,0BAA0B,CAAC;YACtC,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,+BAA+B,CAAC;YAC5C,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnH,CAAC"}

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

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

package/dist/usecases/script/do.js

@@ -0,0 +1,130 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK, EXIT_USAGE, directDir, exists, readText, } from "../../common.js";
+import { applyPatchOperations } from "../../domain/script/patch/apply.js";
+import { summarizeIssues, } from "../direct.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { loadScriptForEdit, validateSession, saveScriptSession, syncValidationResult, scriptSourceText, } from "./session.js";
+import { tokenizeLine, parseDoLine, lineToOp, } 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("DO BLOCKED: no input", "no verb script piped to stdin.", {
+                exitCode: EXIT_USAGE,
+                required: ["a file path or piped stdin"],
+                received: ["<tty, no pipe>"],
+                nextSteps: ["Pass a file (scriptctl do edits.txt) or pipe one (… | scriptctl do -)."],
+                errorCode: "DO_NO_INPUT",
+            });
+        }
+        try {
+            text = fs.readFileSync(0, "utf-8");
+        }
+        catch {
+            throw new CliError("DO BLOCKED: no input", "no verb script on stdin.", {
+                exitCode: EXIT_USAGE,
+                required: ["a file path or piped stdin"],
+                received: ["<no stdin>"],
+                nextSteps: ["Pass a file (scriptctl do edits.txt) or pipe one (… | scriptctl do -)."],
+                errorCode: "DO_NO_INPUT",
+            });
+        }
+    }
+    else {
+        if (!exists(file)) {
+            throw new CliError("DO BLOCKED: file not found", "verb-script file not found.", {
+                exitCode: EXIT_INPUT,
+                required: ["an existing file"],
+                received: [file],
+                nextSteps: ["Check the path, or pipe via stdin with `-`."],
+                errorCode: "DO_FILE_NOT_FOUND",
+            });
+        }
+        text = readText(file);
+    }
+    // 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));
+        }
+        catch (err) {
+            const detail = err instanceof CliError ? err.message : String(err);
+            throw new CliError(`DO BLOCKED: line ${ln + 1}`, `line ${ln + 1}: ${detail}`, {
+                exitCode: EXIT_USAGE,
+                required: ["a valid verb line"],
+                received: [rawLines[ln].trim()],
+                nextSteps: ["Fix this line; the whole script is one transaction (nothing is written until every line is valid)."],
+                errorCode: "DO_LINE_INVALID",
+            });
+        }
+    }
+    if (ops.length === 0) {
+        throw new CliError("DO BLOCKED: empty script", "no verb lines found.", {
+            exitCode: EXIT_USAGE,
+            required: ["at least one verb line"],
+            received: ["<empty>"],
+            nextSteps: ["Provide one CLI verb per line (without the leading `scriptctl`)."],
+            errorCode: "DO_EMPTY",
+        });
+    }
+    const apply = Boolean(opts["apply"]);
+    const workspace = strOf(opts["workspace_path"] || "workspace");
+    const session = await loadScriptForEdit(opts);
+    const script = session.script;
+    // One transaction: all ops applied in a single pass (renumber once at the
+    // end). Any op throwing aborts before any write — all-or-nothing.
+    const applied = applyPatchOperations(script, scriptSourceText(workspace), ops);
+    const head = [`lines: ${ops.length} op(s)`, `${apply ? "applied" : "would-apply"}: ${applied.length}`];
+    if (!apply) {
+        const validation = validateSession(session);
+        const passed = Boolean(validation["passed"]);
+        const report = {
+            title: "DO DRY-RUN (no write)",
+            op: "script.do.dry-run",
+            changed: false,
+            summary: `${ops.length} op(s) parsed; all apply cleanly — pass --apply to commit`,
+            result: [...head, `validation: ${passed ? "would pass" : "would need repair"}`, "dry-run: no write performed"],
+            warnings: passed ? [] : summarizeIssues(asList(validation["issues"])),
+            issues: summarizeIssues(asList(validation["issues"])),
+            artifacts: [session.artifactLabel],
+            next: [passed ? "Re-run with --apply to commit." : "Resolve validation issues before committing."],
+        };
+        return [report, passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+    }
+    const [newRevision, idempotent] = await saveScriptSession(session, opts, "do");
+    const validation = validateSession(session);
+    await syncValidationResult(session, validation, newRevision);
+    const passed = Boolean(validation["passed"]);
+    const resultLines = [...head, `validation: ${passed ? "passed" : "needs repair"}`];
+    if (session.remote) {
+        resultLines.push(`revision: ${newRevision}`);
+        resultLines.push(`idempotent: ${String(idempotent).toLowerCase()}`);
+    }
+    const report = {
+        title: passed ? "DO APPLIED" : "DO APPLIED: Validation needs repair",
+        op: "script.do",
+        changed: applied.length > 0,
+        summary: `applied ${applied.length} op(s) as one transaction`,
+        result: resultLines,
+        warnings: passed ? [] : summarizeIssues(asList(validation["issues"])),
+        issues: summarizeIssues(asList(validation["issues"])),
+        artifacts: [session.artifactLabel, path.join(directDir(workspace), "validation.json")],
+        next: [passed ? "Continue editing the final script." : "Inspect issues and fix."],
+    };
+    return [report, passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+}
+//# sourceMappingURL=do.js.map

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

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

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

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

package/dist/usecases/script/episodes.js

@@ -0,0 +1,36 @@
+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 { buildReport, synopsisPreview, episodeInSelector, } from "./lib.js";
+export async function commandEpisodes(opts) {
+    const session = await loadScriptForEdit(opts);
+    const script = session.script;
+    const itemId = strOf(opts["id"]).trim();
+    const selector = parseInSelector(strOf(opts["in"]));
+    const minChars = parseBound(opts["min_chars"]);
+    const maxChars = parseBound(opts["max_chars"]);
+    const lines = [];
+    for (const ep of asList(script["episodes"])) {
+        const epId = strOf(ep["episode_id"]);
+        if (itemId && itemId !== epId)
+            continue;
+        const scenes = asList(ep["scenes"]);
+        if (!episodeInSelector(selector, epId, scenes))
+            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}`);
+    }
+    return [buildReport("query.episodes", "EPISODES", lines, session.artifactLabel, ["Use `scriptctl scenes --in <ep>` to drill in, or edit verbs to mutate."]), EXIT_OK];
+}
+// ----- scenes ---------------------------------------------------------------
+//# sourceMappingURL=episodes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"episodes.js","sourceRoot":"","sources":["../../../src/usecases/script/episodes.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAIL,eAAe,GAGhB,MAAM,iCAAiC,CAAC;AAwBzC,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,EAC6B,UAAU,EAAE,iBAAiB,GAC5E,MAAM,cAAc,CAAC;AACtB,OAAO,EACwS,WAAW,EAAE,eAAe,EAAE,iBAAiB,GAC7V,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAO,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QACxC,MAAM,MAAM,GAAG,MAAM,CAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC;YAAE,SAAS;QACzD,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3E,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,GAAG,QAAQ;YAAE,SAAS;QAC1D,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,GAAG,QAAQ;YAAE,SAAS;QAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,KAAK,CAAC,IAAI,CACR,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,MAAM,CAAC,MAAM,aAAa,WAAW,WAAW,KAAK,CAAC,KAAK,cAAc,KAAK,CAAC,QAAQ,YAAY,KAAK,CAAC,MAAM,YAAY,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,aAAa,EAAE,CAC/L,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAC5E,CAAC,wEAAwE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED,+EAA+E"}

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

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

package/dist/usecases/script/export.js

@@ -0,0 +1,117 @@
+import * as path from "node:path";
+import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK, EXIT_USAGE, directDir, exists, readJson, sha256Text, } from "../../common.js";
+import { validateScript } from "../../domain/script/validate.js";
+import { ScriptOutputApiError, } from "../../infra/script-output-store.js";
+import { readRunState, summarizeIssues, updateRunState, } from "../direct.js";
+import { sortDeep } from "../../domain/direct-core.js";
+import { asList, isDict, strOf, } from "../../domain/script/shared.js";
+import { ScriptEditSession, scriptOutputClient, apiErrorToCli, currentRevisionOrZero, syncValidationResult, } from "./session.js";
+export async function commandExport(opts) {
+    const workspace = strOf(opts["workspace_path"] || "workspace");
+    const force = Boolean(opts["force"]);
+    const scriptPath = path.join(directDir(workspace), "script.initial.json");
+    if (!exists(scriptPath)) {
+        throw new CliError("EXPORT BLOCKED: script.initial.json not found", "script.initial.json not found.", {
+            exitCode: EXIT_INPUT,
+            required: ["workspace/draft/scriptctl/direct/script.initial.json"],
+            received: [scriptPath],
+            nextSteps: ["Run scriptctl direct init first."],
+        });
+    }
+    const state = readRunState(workspace);
+    const provider = strOf(state["provider"]);
+    if (provider === "mock" && process.env.SCRIPTCTL_ALLOW_MOCK_EXPORT !== "1") {
+        const report = {
+            title: "EXPORT BLOCKED: Mock provider result",
+            result: ["script.initial.json was produced by --provider mock and was not exported."],
+            artifacts: [path.join(directDir(workspace), "run_state.json")],
+            next: ["Rerun init with --provider anthropic for deliverable conversion."],
+        };
+        return [report, EXIT_NEEDS_AGENT];
+    }
+    const validation = validateScript(workspace, scriptPath);
+    const blockingOrError = Boolean(validation["has_blocking"]) ||
+        asList(validation["issues"]).some((it) => isDict(it) && (it["severity"] === "blocking" || it["severity"] === "error"));
+    if (!validation["passed"] && (!force || blockingOrError)) {
+        const title = force
+            ? "EXPORT BLOCKED: Validation errors require repair"
+            : "EXPORT BLOCKED: Validation needs agent repair";
+        const report = {
+            title,
+            result: ["script.initial.json was not exported."],
+            artifacts: [path.join(directDir(workspace), "validation.json")],
+            issues: summarizeIssues(asList(validation["issues"])),
+            next: ["Inspect issues and apply structured patches, then validate/export."],
+        };
+        return [report, EXIT_NEEDS_AGENT];
+    }
+    let script;
+    try {
+        script = readJson(scriptPath);
+    }
+    catch (exc) {
+        throw new CliError("EXPORT BLOCKED: script.initial.json invalid", "script.initial.json invalid.", {
+            exitCode: EXIT_INPUT,
+            required: ["valid script.initial.json"],
+            received: [`${scriptPath}: ${exc.message}`],
+            nextSteps: ["Fix script.initial.json or rerun direct init."],
+            errorCode: "SCRIPT_JSON_INVALID",
+        });
+    }
+    if (!isDict(script)) {
+        throw new CliError("EXPORT BLOCKED: script root invalid", "script root invalid.", {
+            exitCode: EXIT_USAGE,
+            required: ["script root object"],
+            received: [Array.isArray(script) ? "array" : typeof script],
+            nextSteps: ["Use a valid script document object."],
+            errorCode: "SCRIPT_ROOT_INVALID",
+        });
+    }
+    const client = scriptOutputClient(opts);
+    const baseRevision = await currentRevisionOrZero(client);
+    // Sorted-keys serialization mirrors Python json.dumps(sort_keys=True, separators=(",",":"))
+    const sortedScript = sortDeep(script);
+    const scriptHash = sha256Text(JSON.stringify(sortedScript));
+    const requestId = strOf(opts["request_id"]).trim() || `scriptctl-direct-export:${scriptHash}`;
+    let replaceRes;
+    try {
+        replaceRes = await client.replaceScript({
+            requestId,
+            baseRevision,
+            script,
+            source: "ctl",
+        });
+    }
+    catch (exc) {
+        if (exc instanceof ScriptOutputApiError) {
+            throw apiErrorToCli("SCRIPT API BLOCKED: Export write failed", exc);
+        }
+        throw exc;
+    }
+    const revision = Number(replaceRes["revision"] ?? 0);
+    const remoteSession = new ScriptEditSession({
+        workspace,
+        script,
+        client,
+        projectGroupNo: client.projectGroupNo,
+        revision,
+    });
+    await syncValidationResult(remoteSession, validation, revision);
+    const outputLabel = remoteSession.artifactLabel;
+    updateRunState(workspace, { status: "exported", output_path: outputLabel });
+    const report = {
+        title: "EXPORT COMPLETE: Final script stored in DB",
+        result: [
+            `validation: ${validation["passed"] ? "passed" : "forced"}`,
+            `base_revision: ${baseRevision}`,
+            `revision: ${revision}`,
+            `idempotent: ${String(Boolean(replaceRes["idempotent"])).toLowerCase()}`,
+        ],
+        artifacts: [outputLabel, path.join(directDir(workspace), "validation.json")],
+        next: ["Proceed to downstream asset or footage stages."],
+    };
+    return [report, EXIT_OK];
+}
+// sortDeep is the canonical helper in domain/direct-core; re-exported here for
+// back-compat with existing importers of `usecases/script`.
+//# sourceMappingURL=export.js.map

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

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

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

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

package/dist/usecases/script/insert.js

@@ -0,0 +1,87 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { parseAnyAddress, } from "../../domain/script/address.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandInsert(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: Insert address missing", "Insert address missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<addr>: ep_NNN/scn_NNN (action insert) or ep_NNN (scene insert)"],
+            received: ["<empty>"],
+            nextSteps: ["Example: scriptctl insert ep_001/scn_001 --type action --content \"...\""],
+            errorCode: "ADDRESS_MISSING",
+        });
+    }
+    const addr = parseAnyAddress(args[0]);
+    // Per-kind flag whitelist. Silently dropping mismatched flags hid two
+    // real bugs:
+    //   - scene insert was ignoring --scene-id (the user lost custom IDs).
+    //   - mixing action + scene insert flags (`--type` with episode addr, or
+    //     `--location` with scene addr) ran the wrong dispatch silently.
+    const flagsUsed = {
+        type: opts["type"] !== undefined,
+        content: opts["content"] !== undefined,
+        actor: (opts["actor_id"] ?? opts["actor"]) !== undefined,
+        speaker: (opts["speaker_id"] ?? opts["speaker"]) !== undefined,
+        location: opts["location"] !== undefined,
+        time: opts["time"] !== undefined,
+        space: opts["space"] !== undefined,
+        "scene-id": opts["scene_id"] !== undefined,
+    };
+    function rejectFlags(kind, allowed) {
+        const allow = new Set(allowed);
+        const bad = [];
+        for (const f of Object.keys(flagsUsed)) {
+            if (flagsUsed[f] && !allow.has(f))
+                bad.push(`--${f}`);
+        }
+        if (bad.length > 0) {
+            throw new CliError("VERB BLOCKED: flag not applicable", `${bad.join(", ")} cannot be used with ${kind} insert.`, {
+                exitCode: EXIT_USAGE,
+                required: [`for ${kind} insert: ${allowed.map((f) => `--${f}`).join(" / ")}`],
+                received: bad,
+                nextSteps: ["Drop the unsupported flag(s) and retry."],
+                errorCode: "INSERT_FLAG_INVALID",
+            });
+        }
+    }
+    if (addr.kind === "scene") {
+        rejectFlags("action", ["type", "content", "actor", "speaker"]);
+        return applySingleScriptOp(opts, {
+            op: "action.insert",
+            at: args[0],
+            type: opts["type"],
+            content: opts["content"],
+            at_index: opts["at_index"] ?? opts["at"],
+            before: opts["before"],
+            after: opts["after"],
+            actor_id: opts["actor_id"] ?? opts["actor"],
+            speaker_id: opts["speaker_id"] ?? opts["speaker"],
+        });
+    }
+    if (addr.kind === "episode") {
+        rejectFlags("scene", ["location", "time", "space", "scene-id"]);
+        return applySingleScriptOp(opts, {
+            op: "scene.insert",
+            at: addr.episodeId,
+            location: opts["location"],
+            time: opts["time"],
+            space: opts["space"],
+            // Forward --scene-id (was previously silently dropped — scene.insert op
+            // reads `scene_id` to honor user-supplied ids for round-trip stability).
+            scene_id: opts["scene_id"],
+            at_index: opts["at_index"] ?? opts["at"],
+            before: opts["before"],
+            after: opts["after"],
+        });
+    }
+    throw new CliError("VERB BLOCKED: insert cannot operate on this address", "insert cannot operate on this address.", {
+        exitCode: EXIT_USAGE,
+        required: ["ep_NNN (scene insert) or ep_NNN/scn_NNN (action insert)"],
+        received: [args[0]],
+        nextSteps: ["Use an episode or scene address."],
+        errorCode: "ADDRESS_UNSUPPORTED",
+    });
+}
+//# sourceMappingURL=insert.js.map

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

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

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

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

package/dist/usecases/script/issues.js

@@ -0,0 +1,27 @@
+import { EXIT_OK, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { loadScriptForEdit, validateSession, } from "./session.js";
+import { buildReport, } from "./lib.js";
+export async function commandIssues(opts) {
+    const session = await loadScriptForEdit(opts);
+    const severityFilter = strOf(opts["severity"]).trim();
+    const codeFilter = strOf(opts["code"]).trim();
+    const validation = validateSession(session);
+    const lines = [];
+    for (const issue of asList(validation["issues"])) {
+        if (severityFilter && severityFilter !== strOf(issue["severity"]))
+            continue;
+        if (codeFilter && codeFilter !== strOf(issue["code"]))
+            continue;
+        const whereParts = [];
+        for (const k of ["episode", "scene", "action_index"]) {
+            if (issue[k] !== null && issue[k] !== undefined)
+                whereParts.push(strOf(issue[k]));
+        }
+        const where = whereParts.join(" ");
+        lines.push(`${issue["severity"]} ${issue["code"]}: ${issue["summary"]}${where ? ` [${where}]` : ""}`);
+    }
+    return [buildReport("query.issues", "ISSUES", lines, session.artifactLabel, ["Use the relevant edit verb to repair each issue."]), EXIT_OK];
+}
+// ----- refs (unified reverse lookup) ----------------------------------------
+//# sourceMappingURL=issues.js.map