@lingjingai/scriptctl 0.19.2 → 0.21.0

package/dist/usecases/script/add-location.js

@@ -0,0 +1,11 @@
+import { applySingleScriptOp, requireNameArg, } from "./lib.js";
+export async function commandAddLocation(opts) {
+    const name = requireNameArg(opts, "add-location", "Example: scriptctl add-location \"教室\"");
+    return applySingleScriptOp(opts, {
+        op: "location.add",
+        name,
+        location_id: opts["id"],
+        description: opts["description"],
+    });
+}
+//# sourceMappingURL=add-location.js.map

package/dist/usecases/script/add-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-location.js","sourceRoot":"","sources":["../../../src/usecases/script/add-location.ts"],"names":[],"mappings":"AAmEA,OAAO,EAC+I,mBAAmB,EAA6U,cAAc,GACngB,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,wCAAwC,CAAC,CAAC;IAC5F,OAAO,mBAAmB,CAAC,IAAI,EAAE;QAC/B,EAAE,EAAE,cAAc;QAClB,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;QACvB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/usecases/script/add-prop.d.ts

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

package/dist/usecases/script/add-prop.js

@@ -0,0 +1,11 @@
+import { applySingleScriptOp, requireNameArg, } from "./lib.js";
+export async function commandAddProp(opts) {
+    const name = requireNameArg(opts, "add-prop", "Example: scriptctl add-prop \"怀表\"");
+    return applySingleScriptOp(opts, {
+        op: "prop.add",
+        name,
+        prop_id: opts["id"],
+        description: opts["description"],
+    });
+}
+//# sourceMappingURL=add-prop.js.map

package/dist/usecases/script/add-prop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-prop.js","sourceRoot":"","sources":["../../../src/usecases/script/add-prop.ts"],"names":[],"mappings":"AAmEA,OAAO,EAC+I,mBAAmB,EAA6U,cAAc,GACngB,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,oCAAoC,CAAC,CAAC;IACpF,OAAO,mBAAmB,CAAC,IAAI,EAAE;QAC/B,EAAE,EAAE,UAAU;QACd,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;QACnB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/usecases/script/add-speaker.d.ts

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

package/dist/usecases/script/add-speaker.js

@@ -0,0 +1,22 @@
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandAddSpeaker(opts) {
+    return applySingleScriptOp(opts, {
+        op: "speaker.add",
+        kind: opts["kind"],
+        name: opts["name"],
+        source_id: opts["source_id"],
+        voice_desc: opts["voice_desc"],
+        speaker_id: opts["speaker_id"],
+    });
+}
+// ----- create (blank scaffold) ----------------------------------------------
+// Create an empty schema-v2 script as the starting point for building a script
+// bottom-up with the atomic add/insert verbs (instead of direct/parse/write
+// assembly). Targets the same three destinations as the edit verbs:
+//   --script-path <file>  local JSON file
+//   --draft               the direct intermediate (script.initial.json)
+//   --project-group-no    DB-backed script-output (first write at revision 0)
+// Refuses to clobber an existing target (local: pass --force to overwrite; DB:
+// edit the existing script instead). Validates in incomplete-tolerant mode, so
+// the blank scaffold reports passed.
+//# sourceMappingURL=add-speaker.js.map

package/dist/usecases/script/add-speaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-speaker.js","sourceRoot":"","sources":["../../../src/usecases/script/add-speaker.ts"],"names":[],"mappings":"AAmEA,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,OAAO,mBAAmB,CAAC,IAAI,EAAE;QAC/B,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,+EAA+E;AAC/E,4EAA4E;AAC5E,oEAAoE;AACpE,0CAA0C;AAC1C,wEAAwE;AACxE,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,qCAAqC"}

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

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

package/dist/usecases/script/alias.js

@@ -0,0 +1,40 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandAlias(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: Asset address missing", "Asset address missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<asset-addr>"],
+            received: ["<empty>"],
+            nextSteps: ["Example: scriptctl alias actor:act_001 --add \"陈总\""],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    // appendStr collectors default to []; empty arrays are truthy, so we MUST
+    // check `.length === 0` rather than `!add` (which is always false here).
+    // Without this, passing only --add still runs the remove op with alias=[]
+    // and crashes mid-write at op layer after the add already succeeded.
+    const add = asList(opts["add"]);
+    const remove = asList(opts["remove"]);
+    if (add.length === 0 && remove.length === 0) {
+        throw new CliError("VERB BLOCKED: --add or --remove required", "--add or --remove required.", {
+            exitCode: EXIT_USAGE,
+            required: ["--add <alias> and/or --remove <alias>"],
+            received: ["<empty>"],
+            nextSteps: ["Pass --add and/or --remove at least once."],
+            errorCode: "ALIAS_EMPTY",
+        });
+    }
+    // Run only the ops that have content; either one of them solo, or both.
+    let lastReport = null;
+    if (add.length > 0) {
+        lastReport = await applySingleScriptOp(opts, { op: "asset.alias.add", target: args[0], alias: add });
+    }
+    if (remove.length > 0) {
+        lastReport = await applySingleScriptOp(opts, { op: "asset.alias.remove", target: args[0], alias: remove });
+    }
+    return lastReport;
+}
+//# sourceMappingURL=alias.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alias.js","sourceRoot":"","sources":["../../../src/usecases/script/alias.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,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAU;IAC3C,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,cAAc,CAAC;YAC1B,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,qDAAqD,CAAC;YAClE,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,0EAA0E;IAC1E,yEAAyE;IACzE,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,GAAG,GAAG,MAAM,CAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAS,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,QAAQ,CAAC,0CAA0C,EAAE,6BAA6B,EAAE;YAC5F,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,uCAAuC,CAAC;YACnD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,2CAA2C,CAAC;YACxD,SAAS,EAAE,aAAa;SACzB,CAAC,CAAC;IACL,CAAC;IACD,wEAAwE;IACxE,IAAI,UAAU,GAA4B,IAAI,CAAC;IAC/C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,UAAU,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,UAAU,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,UAAW,CAAC;AACrB,CAAC"}

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

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

package/dist/usecases/script/assets.js

@@ -0,0 +1,21 @@
+import { EXIT_OK, } from "../../common.js";
+import { parseInSelector, } from "../../domain/script/selector.js";
+import { strOf, } from "../../domain/script/shared.js";
+import { loadScriptForEdit, } from "./session.js";
+import { buildReport, listAssetsByKind, } from "./lib.js";
+export async function commandAssets(opts) {
+    const session = await loadScriptForEdit(opts);
+    const kindFilter = strOf(opts["kind"]).trim();
+    const nameOpt = strOf(opts["name"]).trim();
+    const idOpt = strOf(opts["id"]).trim();
+    const selector = parseInSelector(strOf(opts["in"]));
+    const lines = [];
+    for (const kind of ["actor", "location", "prop"]) {
+        if (kindFilter && kindFilter !== kind)
+            continue;
+        lines.push(...listAssetsByKind(session.script, kind, { id: idOpt, name: nameOpt, selector }));
+    }
+    return [buildReport("query.assets", "ASSETS", lines, session.artifactLabel, ["Use `scriptctl actors` / `locations` / `props` for kind-scoped views."]), EXIT_OK];
+}
+// ----- speakers -------------------------------------------------------------
+//# sourceMappingURL=assets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/usecases/script/assets.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAIL,eAAe,GAGhB,MAAM,iCAAiC,CAAC;AAwBzC,OAAO,EAKL,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,GAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EACwS,WAAW,EAAqI,gBAAgB,GAC9c,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAU,EAAE,CAAC;QAC1D,IAAI,UAAU,IAAI,UAAU,KAAK,IAAI;YAAE,SAAS;QAChD,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EACxE,CAAC,uEAAuE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACzF,CAAC;AAED,+EAA+E"}

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

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

package/dist/usecases/script/context.js

@@ -0,0 +1,20 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+import { contextTemplate } from "./lib.js";
+export async function commandContext(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 2) {
+        throw new CliError("VERB BLOCKED: context args missing", "context args missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<scene-addr> <asset-addr>"],
+            received: args,
+            nextSteps: ["Example: scriptctl context ep_001/scn_001 actor:act_001 --state st_calm"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const template = contextTemplate(strOf(args[1]), { state: opts["state"], clear: Boolean(opts["clear"]), remove: Boolean(opts["remove"]) });
+    return applySingleScriptOp(opts, { ...template, at: args[0] });
+}
+// ----- state change / transition --------------------------------------------
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/usecases/script/context.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,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,oCAAoC,EAAE,uBAAuB,EAAE;YAChF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,2BAA2B,CAAC;YACvC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,yEAAyE,CAAC;YACtF,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3I,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E"}

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

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

package/dist/usecases/script/create.js

@@ -0,0 +1,81 @@
+import * as path from "node:path";
+import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK, EXIT_USAGE, directDir, exists, writeJson, } from "../../common.js";
+import { blankScript } from "../../domain/script/lookups.js";
+import { ScriptOutputApiError, } from "../../infra/script-output-store.js";
+import { strOf, } from "../../domain/script/shared.js";
+import { ScriptEditSession, scriptOutputClient, apiErrorToCli, currentRevisionOrZero, validateSession, syncValidationResult, requestIdForScriptWrite, } from "./session.js";
+import { blankCreateReport, } from "./lib.js";
+export async function commandCreate(opts) {
+    const workspace = strOf(opts["workspace_path"] || "workspace");
+    const force = Boolean(opts["force"]);
+    const title = strOf(opts["title"]).trim();
+    const script = blankScript(title);
+    const draft = Boolean(opts["draft"]);
+    const scriptPathOpt = strOf(opts["script_path"]).trim();
+    if (draft && scriptPathOpt) {
+        throw new CliError("CREATE BLOCKED: --draft conflicts with --script-path", "--draft conflicts with --script-path.", {
+            exitCode: EXIT_USAGE,
+            required: ["either --draft or --script-path, not both"],
+            received: ["--draft and --script-path"],
+            nextSteps: ["Drop one of the two flags and retry."],
+            errorCode: "DRAFT_FLAG_CONFLICT",
+        });
+    }
+    if (draft && strOf(opts["project_group_no"]).trim()) {
+        throw new CliError("CREATE BLOCKED: --draft conflicts with --project-group-no", "--draft conflicts with --project-group-no.", {
+            exitCode: EXIT_USAGE,
+            required: ["either --draft (local draft) or --project-group-no (DB), not both"],
+            received: ["--draft and --project-group-no"],
+            nextSteps: ["Drop one of the two flags and retry."],
+            errorCode: "DRAFT_FLAG_CONFLICT",
+        });
+    }
+    const localPath = draft ? path.join(directDir(workspace), "script.initial.json") : (scriptPathOpt || null);
+    if (localPath) {
+        if (exists(localPath) && !force) {
+            throw new CliError("CREATE BLOCKED: target already exists", "A script already exists at the target.", {
+                exitCode: EXIT_INPUT,
+                required: ["a non-existent target, or --force to overwrite"],
+                received: [localPath],
+                nextSteps: ["Edit the existing script with the atomic verbs, or pass --force to overwrite with a blank scaffold."],
+                errorCode: "SCRIPT_EXISTS",
+            });
+        }
+        writeJson(localPath, script);
+        const session = new ScriptEditSession({ workspace, scriptPath: localPath, script });
+        const validation = validateSession(session);
+        const passed = Boolean(validation["passed"]);
+        return [blankCreateReport(session, validation, null), passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+    }
+    // DB mode: first write must be at revision 0. We never silently overwrite a
+    // populated DB script with a blank one — that would destroy work.
+    const client = scriptOutputClient(opts);
+    const baseRevision = await currentRevisionOrZero(client);
+    if (baseRevision > 0) {
+        throw new CliError("CREATE BLOCKED: DB script already exists", "A script already exists for this project.", {
+            exitCode: EXIT_INPUT,
+            required: ["an empty project (no published script)"],
+            received: [`revision=${baseRevision}`],
+            nextSteps: ["Edit the existing script with the atomic verbs instead of creating a blank one."],
+            errorCode: "SCRIPT_EXISTS",
+        });
+    }
+    const requestId = requestIdForScriptWrite(opts, "script.create", { script });
+    let res;
+    try {
+        res = await client.replaceScript({ requestId, baseRevision, script, source: "ctl" });
+    }
+    catch (exc) {
+        if (exc instanceof ScriptOutputApiError) {
+            throw apiErrorToCli("SCRIPT API BLOCKED: Create write failed", exc);
+        }
+        throw exc;
+    }
+    const revision = Number(res["revision"] ?? 0);
+    const session = new ScriptEditSession({ workspace, script, client, projectGroupNo: client.projectGroupNo, revision });
+    const validation = validateSession(session);
+    await syncValidationResult(session, validation, revision);
+    const passed = Boolean(validation["passed"]);
+    return [blankCreateReport(session, validation, Boolean(res["idempotent"])), passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/usecases/script/create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EAEP,UAAU,EAEV,SAAS,EACT,MAAM,EAKN,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAqB7D,OAAO,EACL,oBAAoB,GAIrB,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAKL,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EACxD,eAAe,EAAqB,oBAAoB,EACE,uBAAuB,GACrG,MAAM,cAAc,CAAC;AACtB,OAAO,EAC4d,iBAAiB,GACnf,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,WAAW,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAElC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,KAAK,IAAI,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAAC,sDAAsD,EAAE,uCAAuC,EAAE;YAClH,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,2CAA2C,CAAC;YACvD,QAAQ,EAAE,CAAC,2BAA2B,CAAC;YACvC,SAAS,EAAE,CAAC,sCAAsC,CAAC;YACnD,SAAS,EAAE,qBAAqB;SACjC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,QAAQ,CAAC,2DAA2D,EAAE,4CAA4C,EAAE;YAC5H,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,mEAAmE,CAAC;YAC/E,QAAQ,EAAE,CAAC,gCAAgC,CAAC;YAC5C,SAAS,EAAE,CAAC,sCAAsC,CAAC;YACnD,SAAS,EAAE,qBAAqB;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAC3G,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,wCAAwC,EAAE;gBACpG,QAAQ,EAAE,UAAU;gBACpB,QAAQ,EAAE,CAAC,gDAAgD,CAAC;gBAC5D,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,qGAAqG,CAAC;gBAClH,SAAS,EAAE,eAAe;aAC3B,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7F,CAAC;IAED,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,0CAA0C,EAAE,2CAA2C,EAAE;YAC1G,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,wCAAwC,CAAC;YACpD,QAAQ,EAAE,CAAC,YAAY,YAAY,EAAE,CAAC;YACtC,SAAS,EAAE,CAAC,iFAAiF,CAAC;YAC9F,SAAS,EAAE,eAAe;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,GAAS,CAAC;IACd,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;YACxC,MAAM,aAAa,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtH,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACnH,CAAC"}

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

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

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]>;