@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/usecases/script/command-constraints.js

@@ -0,0 +1,114 @@
+import { CliError, EXIT_USAGE } from "../../common.js";
+export function assertSceneRefCommandFlags(version, flags) {
+    if (version === 4) {
+        const unsupported = [
+            flags.clear ? "--clear" : "",
+            flags.append ? "--append" : "",
+            flags.occurrence !== undefined ? "--occurrence" : "",
+        ].filter(Boolean);
+        if (unsupported.length > 0) {
+            throw new CliError("Script v4 replaces an asset's complete state set.", {
+                exitCode: EXIT_USAGE,
+                errorCode: "SCENE_REF_V4_FLAGS_INVALID",
+                hint: "Use one or more `--state <state-id>` values, or use `--remove` for the whole asset reference.",
+                data: { actual: unsupported },
+            });
+        }
+        if ((flags.remove && flags.states.length > 0) || (!flags.remove && flags.states.length === 0)) {
+            throw new CliError("Choose a complete state set or remove the asset reference.", {
+                exitCode: EXIT_USAGE,
+                errorCode: "SCENE_REF_V4_MODE_INVALID",
+                data: { expected: ["one or more --state values, or --remove"], actual: flags.remove ? ["--remove", "--state"] : ["<missing>"] },
+            });
+        }
+        return;
+    }
+    if (flags.states.length > 1) {
+        throw new CliError("Script v3 scene references have one state_id.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "SCENE_REF_V3_MULTIPLE_STATES",
+            hint: "Pass one `--state <state-id>` value for this v3 script.",
+            data: { actual: flags.states },
+        });
+    }
+}
+export function assertMoveCommandFlags(version, flags) {
+    if (version === 3 && (flags.before !== undefined || flags.after !== undefined)) {
+        const received = [
+            ...(flags.before !== undefined ? ["--before"] : []),
+            ...(flags.after !== undefined ? ["--after"] : []),
+        ];
+        throw new CliError("Sibling ID placement is only supported by Script v4.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "MOVE_V4_PLACEMENT_UNSUPPORTED",
+            hint: "Use the V3 destination address and --at position syntax.",
+            data: { actual: received },
+        });
+    }
+    if (version === 4 && flags.at !== undefined) {
+        throw new CliError("Numeric move positions are not supported by Script v4.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "V4_NUMERIC_POSITION_UNSUPPORTED",
+            hint: "Use --before <sibling-id>, --after <sibling-id>, or omit both to append.",
+        });
+    }
+}
+const INSERT_FLAG_KEYS = {
+    type: "type",
+    content: "content",
+    emotion: "emotion",
+    parenthetical: "parenthetical",
+    "action-id": "actionId",
+    at: "at",
+    before: "before",
+    after: "after",
+    actor: "actor",
+    speaker: "speaker",
+    "speaker-state": "speakerState",
+    kind: "kind",
+    label: "label",
+    location: "location",
+    time: "time",
+    space: "space",
+    "scene-id": "sceneId",
+    state: "states",
+};
+const V3_ACTION_INSERT_FLAGS = new Set([
+    "type", "content", "emotion", "at", "before", "after", "actor", "speaker", "kind", "label",
+]);
+const V3_SCENE_INSERT_FLAGS = new Set([
+    "at", "before", "after", "location", "time", "space", "scene-id",
+]);
+const V4_ACTION_INSERT_FLAGS = new Set([
+    "type", "content", "parenthetical", "action-id", "before", "after", "actor", "speaker-state", "kind", "label",
+]);
+const V4_SCENE_INSERT_FLAGS = new Set([
+    "before", "after", "location", "time", "space", "scene-id", "state",
+]);
+function insertFlagIsPresent(flags, name) {
+    const value = flags[INSERT_FLAG_KEYS[name]];
+    return Array.isArray(value) ? value.length > 0 : value !== undefined;
+}
+export function assertInsertCommandFlags(version, insertedKind, flags) {
+    if (version === 4 && flags.at !== undefined) {
+        throw new CliError("Numeric insertion positions are not supported by Script v4.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "V4_NUMERIC_POSITION_UNSUPPORTED",
+            hint: "Use --before <sibling-id>, --after <sibling-id>, or omit both to append.",
+        });
+    }
+    const allowed = version === 3
+        ? insertedKind === "action" ? V3_ACTION_INSERT_FLAGS : V3_SCENE_INSERT_FLAGS
+        : insertedKind === "action" ? V4_ACTION_INSERT_FLAGS : V4_SCENE_INSERT_FLAGS;
+    const invalid = Object.keys(INSERT_FLAG_KEYS)
+        .filter((name) => insertFlagIsPresent(flags, name) && !allowed.has(name))
+        .map((name) => `--${name}`);
+    if (invalid.length === 0)
+        return;
+    throw new CliError("Action and scene insertion flags cannot be mixed or used with the wrong Script version.", {
+        exitCode: EXIT_USAGE,
+        errorCode: "INSERT_FLAG_INVALID",
+        data: { actual: invalid },
+    });
+}
+//# sourceMappingURL=command-constraints.js.map

package/dist/usecases/script/command-constraints.js.map

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

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

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

package/dist/usecases/script/context.js

@@ -1,26 +1,52 @@
 import { CliError, EXIT_USAGE, } from "../../common.js";
 import { asList, strOf, } from "../../domain/script/shared.js";
-import { applySingleScriptOp, } from "./lib.js";
+import { loadScriptForEdit, } from "./session.js";
+import { applySingleScriptOpToSession, } from "./lib.js";
 import { contextTemplate } from "./lib.js";
+import { assertSceneRefCommandFlags } from "./command-constraints.js";
+function stateValues(raw) {
+    if (raw === undefined)
+        return [];
+    if (Array.isArray(raw))
+        return raw.map((value) => strOf(value));
+    return [strOf(raw)];
+}
 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.", {
+        throw new CliError("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",
+            hint: "Example: scriptctl context ep_001/scn_001 actor:act_001 --state st_calm",
+            data: { expected: ["<scene-addr> <asset-addr>"], actual: args },
         });
     }
-    const template = contextTemplate(strOf(args[1]), {
-        state: opts["state"],
+    const session = await loadScriptForEdit(opts);
+    const states = stateValues(opts["state"]);
+    const flags = {
+        states,
         clear: Boolean(opts["clear"]),
         remove: Boolean(opts["remove"]),
         append: Boolean(opts["append"]),
         occurrence: opts["occurrence"],
+    };
+    assertSceneRefCommandFlags(session.version, flags);
+    if (session.version === 4) {
+        return applySingleScriptOpToSession(session, opts, {
+            op: flags.remove ? "scene.ref.remove" : "scene.ref.set",
+            at: args[0],
+            target: args[1],
+            ...(flags.remove ? {} : { state_ids: states }),
+        });
+    }
+    const template = contextTemplate(strOf(args[1]), {
+        state: states[0],
+        clear: flags.clear,
+        remove: flags.remove,
+        append: flags.append,
+        occurrence: flags.occurrence,
     });
-    return applySingleScriptOp(opts, { ...template, at: args[0] });
+    return applySingleScriptOpToSession(session, opts, { ...template, at: args[0] });
 }
 // ----- state change / transition --------------------------------------------
 //# sourceMappingURL=context.js.map

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

@@ -1 +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;AA6BzB,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;QAC/C,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;KAC/B,CAAC,CAAC;IACH,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/usecases/script/context.ts"],"names":[],"mappings":"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"}

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

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

package/dist/usecases/script/create.js

@@ -1,6 +1,6 @@
 import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK, exists, scriptJsonPath, } from "../../common.js";
 import { atomicWriteJson } from "../../infra/script-working-copy.js";
-import { blankScript } from "../../domain/script/lookups.js";
+import { blankScriptV4 } from "../../domain/script/v4/factory.js";
 import { strOf, } from "../../domain/script/shared.js";
 import { ScriptEditSession, validateSession, } from "./session.js";
 import { blankCreateReport, } from "./lib.js";
@@ -8,15 +8,14 @@ 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 script = blankScriptV4(title);
     const localPath = scriptJsonPath(opts);
     if (exists(localPath) && !force) {
-        throw new CliError("CREATE BLOCKED: target already exists", "A script already exists at the target.", {
+        throw new CliError("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",
+            hint: "Edit the existing script with the atomic verbs, or pass --force to overwrite with a blank scaffold.",
+            data: { expected: ["a non-existent target, or --force to overwrite"], actual: [localPath] },
         });
     }
     atomicWriteJson(localPath, script);

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

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/usecases/script/create.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EAIP,MAAM,EAGN,cAAc,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA2B7D,OAAO,EAKL,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACE,eAAe,GAEnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACib,iBAAiB,GACxc,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,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,wCAAwC,EAAE;YACpG,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,gDAAgD,CAAC;YAC5D,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,qGAAqG,CAAC;YAClH,SAAS,EAAE,eAAe;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAC7F,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/usecases/script/create.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EAIP,MAAM,EAGN,cAAc,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AA2BlE,OAAO,EAKL,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACE,eAAe,GAEnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACib,iBAAiB,GACxc,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,aAAa,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,wCAAwC,EAAE;YACrD,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,eAAe;YAC1B,IAAI,EAAE,qGAAqG;YAC3G,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,gDAAgD,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;SAC5F,CAAC,CAAC;IACX,CAAC;IACD,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAC7F,CAAC"}

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

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

package/dist/usecases/script/delete.js

@@ -1,19 +1,21 @@
 import { CliError, EXIT_USAGE, } from "../../common.js";
 import { parseAnyAddress, } from "../../domain/script/address.js";
+import { parseV4Address } from "../../domain/script/v4/address.js";
 import { asList, } from "../../domain/script/shared.js";
-import { applySingleScriptOp, } from "./lib.js";
+import { loadScriptForEdit, } from "./session.js";
+import { applySingleScriptOpToSession, } 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.", {
+        throw new CliError("Address missing.", {
             exitCode: EXIT_USAGE,
-            required: ["address"],
-            received: ["<empty>"],
-            nextSteps: ["Pass an address (action / scene / asset / speaker)."],
             errorCode: "ADDRESS_MISSING",
+            hint: "Pass an address (action / scene / asset / speaker).",
+            data: { expected: ["address"], actual: ["<empty>"] },
         });
     }
-    const addr = parseAnyAddress(args[0]);
+    const session = await loadScriptForEdit(opts);
+    const addr = session.version === 4 ? parseV4Address(args[0]) : 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.
@@ -30,12 +32,11 @@ export async function commandDelete(opts) {
                 bad.push(`--${f}`);
         }
         if (bad.length > 0) {
-            throw new CliError("VERB BLOCKED: flag not applicable", `${bad.join(", ")} cannot be used with ${kind} delete.`, {
+            throw new CliError(`${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",
+                hint: "Drop the unsupported flag(s) and retry.",
+                data: { expected: [`for ${kind} delete: ${allowed.length === 0 ? "no extra flags" : allowed.map((f) => `--${f}`).join(" / ")}`], actual: bad },
             });
         }
     }
@@ -75,14 +76,13 @@ export async function commandDelete(opts) {
                 replacement: opts["replacement"],
             };
         }
-        throw new CliError("VERB BLOCKED: delete cannot operate on this address", "delete cannot operate on this address.", {
+        throw new CliError("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",
+            hint: "Use a supported address.",
+            data: { expected: ["action / scene / asset / speaker address"], actual: [args[0]] },
         });
     })();
-    return applySingleScriptOp(opts, op);
+    return applySingleScriptOpToSession(session, opts, op);
 }
 //# sourceMappingURL=delete.js.map

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

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

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

package/dist/usecases/script/describe.js

@@ -1,31 +1,32 @@
 import { CliError, EXIT_USAGE, } from "../../common.js";
 import { parseAnyAddress, } from "../../domain/script/address.js";
+import { parseV4Address } from "../../domain/script/v4/address.js";
 import { asList, } from "../../domain/script/shared.js";
-import { applySingleScriptOp, } from "./lib.js";
+import { loadScriptForEdit, } from "./session.js";
+import { applySingleScriptOpToSession, } 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.", {
+        throw new CliError("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",
+            hint: "Example: scriptctl describe actor:act_001 \"男主\" or scriptctl describe actor:act_001/st_calm \"...\"",
+            data: { expected: ["<addr> <text>"], actual: args },
         });
     }
-    const addr = parseAnyAddress(args[0]);
+    const session = await loadScriptForEdit(opts);
+    const addr = session.version === 4 ? parseV4Address(args[0]) : parseAnyAddress(args[0]);
     if (addr.kind === "state") {
-        return applySingleScriptOp(opts, { op: "state.describe", target: args[0], description: args[1] });
+        return applySingleScriptOpToSession(session, 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] });
+        return applySingleScriptOpToSession(session, opts, { op: "asset.describe", target: args[0], description: args[1] });
     }
-    throw new CliError("VERB BLOCKED: describe address invalid", "describe address invalid.", {
+    throw new CliError("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",
+        hint: "Use a supported address.",
+        data: { expected: ["asset address (e.g. actor:act_001) or state address (e.g. actor:act_001/st_calm)"], actual: [args[0]] },
     });
 }
 //# sourceMappingURL=describe.js.map

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

@@ -1 +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;AAWxC,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"}
+{"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;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAWnE,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,GAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EACoK,4BAA4B,GACtM,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,wBAAwB,EAAE;YACrC,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,sGAAsG;YAC5G,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;SACpD,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,2BAA2B,EAAE;QACxC,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,qBAAqB;QAChC,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,kFAAkF,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE;KAC7H,CAAC,CAAC;AACX,CAAC"}

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

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

package/dist/usecases/script/dialogue.js

@@ -1,21 +1,30 @@
 import { CliError, EXIT_USAGE, } from "../../common.js";
 import { asList, } from "../../domain/script/shared.js";
-import { applySingleScriptOp, } from "./lib.js";
+import { loadScriptForEdit, } from "./session.js";
+import { applySingleScriptOpToSession, } 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.", {
+        throw new CliError("dialogue action ref missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<action-addr>"],
-            received: ["<empty>"],
-            nextSteps: ["Example: scriptctl dialogue ep_001/scn_001#3 --actor act_001"],
             errorCode: "ARGS_MISSING",
+            hint: "Example: scriptctl dialogue ep_001/scn_001#3 --actor act_001",
+            data: { expected: ["<action-addr>"], actual: ["<empty>"] },
         });
     }
-    // v3: a single inline speaker — an actor (--actor) or a non-actor kind (--kind
-    // system|broadcast|offscreen|group, optional --label). dialogueTemplate throws
-    // a usage error if neither is given.
-    return applySingleScriptOp(opts, { ...dialogueTemplate({ actor: opts["actor"], kind: opts["kind"], label: opts["label"] }), at: args[0] });
+    const session = await loadScriptForEdit(opts);
+    if (session.version === 3 && opts["state"] !== undefined) {
+        throw new CliError("Script v3 dialogue speakers do not use this flag.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "DIALOGUE_STATE_VERSION_UNSUPPORTED",
+            data: { actual: ["--state"] },
+        });
+    }
+    return applySingleScriptOpToSession(session, opts, {
+        ...dialogueTemplate({ actor: opts["actor"], kind: opts["kind"], label: opts["label"] }),
+        ...(session.version === 4 && opts["state"] !== undefined ? { state_id: opts["state"] } : {}),
+        at: args[0],
+    });
 }
 //# sourceMappingURL=dialogue.js.map

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

@@ -1 +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;AA6BzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,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,8DAA8D,CAAC;YAC3E,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,+EAA+E;IAC/E,+EAA+E;IAC/E,qCAAqC;IACrC,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7I,CAAC"}
+{"version":3,"file":"dialogue.js","sourceRoot":"","sources":["../../../src/usecases/script/dialogue.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AA6BzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,GAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EACoK,4BAA4B,GACtM,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,8BAA8B,EAAE;YAC3C,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,8DAA8D;YACpE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;SAC3D,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,QAAQ,CAAC,mDAAmD,EAAE;YAChE,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,oCAAoC;YAC/C,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;SAC9B,CAAC,CAAC;IACX,CAAC;IACD,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE;QACjD,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;KACZ,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ScriptVersion } from "../../domain/script/dispatch.js";
+import type { Dict } from "../../domain/script/shared.js";
+export declare function applyVersionedMutations(version: ScriptVersion, script: Dict, sourceText: string, operations: Dict[]): string[];

package/dist/usecases/script/dispatch.js

@@ -0,0 +1,10 @@
+import { applyV3Mutations } from "./v3/mutations.js";
+import { applyV4Mutations } from "./v4/mutations.js";
+const MUTATION_RUNNERS = {
+    3: applyV3Mutations,
+    4: (script, _sourceText, operations) => applyV4Mutations(script, operations),
+};
+export function applyVersionedMutations(version, script, sourceText, operations) {
+    return MUTATION_RUNNERS[version](script, sourceText, operations);
+}
+//# sourceMappingURL=dispatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../src/usecases/script/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQrD,MAAM,gBAAgB,GAAoD;IACxE,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7E,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,OAAsB,EACtB,MAAY,EACZ,UAAkB,EAClB,UAAkB;IAElB,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC"}

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

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