@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/usecases/script/refs.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 commandRefs(opts: Dict): Promise<[Report, number]>;
+export declare function commandRefs(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/refs.js

@@ -3,22 +3,70 @@ import { collectAssetRefs, collectStateRefs } from "../../domain/script/refs.js"
 import { parseAnyAddress, } from "../../domain/script/address.js";
 import { asList, strOf, } from "../../domain/script/shared.js";
 import { loadScriptForEdit, } from "./session.js";
-import { buildReport, } from "./lib.js";
+import { buildTableReport, } from "./lib.js";
+import { parseV4Address } from "../../domain/script/v4/address.js";
+import { requireScriptV4 } from "../../domain/script/v4/parse.js";
 export async function commandRefs(opts) {
     const session = await loadScriptForEdit(opts);
     const script = session.script;
     const args = asList(opts["_args"]);
     const target = strOf(args[0]).trim();
     if (!target) {
-        throw new CliError("QUERY BLOCKED: refs target missing", "refs target missing.", {
+        throw new CliError("refs target missing.", {
             exitCode: EXIT_USAGE,
-            required: ["address: actor|location|prop:<id>[/<state_id>] or spk_<id>"],
-            received: ["<empty>"],
-            nextSteps: ["Pass a recognized address."],
             errorCode: "REFS_TARGET_MISSING",
+            hint: "Pass a recognized address.",
+            data: { expected: ["address: actor|location|prop:<id>[/<state_id>] or spk_<id>"], actual: ["<empty>"] },
         });
     }
     const level = strOf(opts["level"]).trim(); // scene|action|""
+    if (session.version === 4) {
+        const address = parseV4Address(target);
+        if (address.kind !== "asset" && address.kind !== "state") {
+            throw new CliError("Script v4 refs expects an asset or asset/state address.", {
+                exitCode: EXIT_USAGE,
+                errorCode: "REFS_TARGET_INVALID",
+                data: { actual: [target] },
+            });
+        }
+        const scriptV4 = requireScriptV4(script);
+        const assetId = address.kind === "asset" ? address.id : address.assetId;
+        const stateId = address.kind === "state" ? address.stateId : null;
+        const lines = [];
+        const rows = [];
+        const addRef = (addr, role) => {
+            lines.push(`${addr} [${role}]`);
+            rows.push({ addr, role });
+        };
+        for (const episode of scriptV4.episodes) {
+            for (const scene of episode.scenes) {
+                const sceneRef = address.assetKind === "actor"
+                    ? scene.actors.find((ref) => ref.actor_id === assetId)
+                    : address.assetKind === "location"
+                        ? scene.location?.location_id === assetId ? scene.location : undefined
+                        : scene.props.find((ref) => ref.prop_id === assetId);
+                if (level !== "action" && sceneRef && (stateId === null || sceneRef.state_ids.includes(stateId))) {
+                    addRef(scene.scene_id, `scene_${address.assetKind}`);
+                }
+                if (level !== "scene" && address.assetKind === "actor") {
+                    for (const action of scene.actions) {
+                        if (!("speaker" in action) || !("actor_id" in action.speaker) || action.speaker.actor_id !== assetId)
+                            continue;
+                        if (stateId !== null && action.speaker.state_id !== stateId)
+                            continue;
+                        addRef(action.action_id, "speaker");
+                    }
+                }
+                if (level !== "scene" && stateId === null) {
+                    for (const action of scene.actions) {
+                        if (action.transition_prompt?.target === assetId)
+                            addRef(action.action_id, "transition_target");
+                    }
+                }
+            }
+        }
+        return [buildTableReport("query.refs", lines, ["addr", "role"], rows), EXIT_OK];
+    }
     const addr = parseAnyAddress(target);
     let refs = [];
     if (addr.kind === "state") {
@@ -31,24 +79,26 @@ export async function commandRefs(opts) {
         refs = collectAssetRefs(script, "speaker", addr.speakerId);
     }
     else {
-        throw new CliError("QUERY BLOCKED: refs target invalid", "refs target invalid.", {
+        throw new CliError("refs target invalid.", {
             exitCode: EXIT_USAGE,
-            required: ["asset / state / speaker address"],
-            received: [target],
-            nextSteps: ["Use a kind:id, kind:id/state_id, or spk_id form."],
             errorCode: "REFS_TARGET_INVALID",
+            hint: "Use a kind:id, kind:id/state_id, or spk_id form.",
+            data: { expected: ["asset / state / speaker address"], actual: [target] },
         });
     }
     const lines = [];
+    const rows = [];
     for (const ref of refs) {
         const role = strOf(ref["role"]);
         if (level === "scene" && !role.startsWith("scene_") && role !== "speaker_source")
             continue;
         if (level === "action" && (role.startsWith("scene_") || role === "speaker_source"))
             continue;
-        lines.push(`${ref["location"]} [${ref["role"]}]`);
+        const location = strOf(ref["location"]);
+        lines.push(`${location} [${role}]`);
+        rows.push({ addr: location, role });
     }
-    return [buildReport("query.refs", `REFS ${target}`, lines, session.artifactLabel), EXIT_OK];
+    return [buildTableReport("query.refs", lines, ["addr", "role"], rows), EXIT_OK];
 }
 // ===========================================================================
 // 0.6.0 edit verbs (flat top-level — replace `script <group> <leaf>` chains)

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

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

package/dist/usecases/script/rename.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 commandRename(opts: Dict): Promise<[Report, number]>;
+export declare function commandRename(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/rename.js

@@ -1,34 +1,35 @@
 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 commandRename(opts) {
     const args = asList(opts["_args"]);
     if (args.length < 2) {
-        throw new CliError("VERB BLOCKED: Rename args missing", "Rename args missing.", {
+        throw new CliError("Rename args missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<addr> <new-name>"],
-            received: args,
-            nextSteps: ["Example: scriptctl rename actor:act_001 \"陈墨\"  |  scriptctl rename actor:act_001/st_010 \"平静（新）\""],
             errorCode: "ARGS_MISSING",
+            hint: "Example: scriptctl rename actor:act_001 \"陈墨\"  |  scriptctl rename actor:act_001/st_010 \"平静（新）\"",
+            data: { expected: ["<addr> <new-name>"], actual: args },
         });
     }
     // Dispatch by address kind, mirroring `describe`: a state address
     // (actor:act_001/st_010) renames the state, a bare asset address renames the
     // asset. Keeps one intuitive verb instead of forcing `state-rename`.
-    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.rename", target: args[0], name: args[1] });
+        return applySingleScriptOpToSession(session, opts, { op: "state.rename", target: args[0], name: args[1] });
     }
     if (addr.kind === "asset") {
-        return applySingleScriptOp(opts, { op: "asset.rename", target: args[0], name: args[1] });
+        return applySingleScriptOpToSession(session, opts, { op: "asset.rename", target: args[0], name: args[1] });
     }
-    throw new CliError("VERB BLOCKED: rename address invalid", "rename address invalid.", {
+    throw new CliError("rename address invalid.", {
         exitCode: EXIT_USAGE,
-        required: ["asset address (actor:act_001) or state address (actor:act_001/st_010)"],
-        received: [args[0]],
-        nextSteps: ["Use a supported address."],
         errorCode: "ADDRESS_UNSUPPORTED",
+        hint: "Use a supported address.",
+        data: { expected: ["asset address (actor:act_001) or state address (actor:act_001/st_010)"], actual: [args[0]] },
     });
 }
 //# sourceMappingURL=rename.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/usecases/script/rename.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,aAAa,CAAC,IAAU;IAC5C,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,mCAAmC,EAAE,sBAAsB,EAAE;YAC9E,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,mBAAmB,CAAC;YAC/B,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,oGAAoG,CAAC;YACjH,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,kEAAkE;IAClE,6EAA6E;IAC7E,qEAAqE;IACrE,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,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE,yBAAyB,EAAE;QACpF,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,CAAC,uEAAuE,CAAC;QACnF,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":"rename.js","sourceRoot":"","sources":["../../../src/usecases/script/rename.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,aAAa,CAAC,IAAU;IAC5C,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,sBAAsB,EAAE;YACnC,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,oGAAoG;YAC1G,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;SACxD,CAAC,CAAC;IACX,CAAC;IACD,kEAAkE;IAClE,6EAA6E;IAC7E,qEAAqE;IACrE,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,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE;QACtC,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,qBAAqB;QAChC,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,uEAAuE,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE;KAClH,CAAC,CAAC;AACX,CAAC"}

package/dist/usecases/script/replace.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 commandReplace(opts: Dict): Promise<[Report, number]>;
+export declare function commandReplace(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/replace.js

@@ -5,12 +5,11 @@ export async function commandReplace(opts) {
     const args = asList(opts["_args"]);
     const selectorMode = selectionHasAnyFilter(opts);
     if (opts["from"] === undefined) {
-        throw new CliError("VERB BLOCKED: --from missing", "--from missing.", {
+        throw new CliError("--from missing.", {
             exitCode: EXIT_USAGE,
-            required: ["--from <text>"],
-            received: ["<missing>"],
-            nextSteps: ["Pass --from with the substring to replace (or a regex with --regex)."],
             errorCode: "FROM_TEXT_EMPTY",
+            hint: "Pass --from with the substring to replace (or a regex with --regex).",
+            data: { expected: ["--from <text>"], actual: ["<missing>"] },
         });
     }
     // --regex routes to the ReDoS-guarded regex op; --from carries the pattern
@@ -22,12 +21,11 @@ export async function commandReplace(opts) {
     if (selectorMode)
         return applySelectorEdits(opts, template, "replace");
     if (args.length < 1) {
-        throw new CliError("VERB BLOCKED: Action ref missing", "Action ref missing.", {
+        throw new CliError("Action ref missing.", {
             exitCode: EXIT_USAGE,
-            required: ["action ref: ep_001/scn_001#3 (or a selection: --in / --grep / --type / --actor / --speaker / --has)"],
-            received: ["<empty>"],
-            nextSteps: ["Run `scriptctl --help` for the full command surface."],
             errorCode: "ACTION_REF_MISSING",
+            hint: "Run `scriptctl --help` for the full command surface.",
+            data: { expected: ["action ref: ep_001/scn_001#3 (or a selection: --in / --grep / --type / --actor / --speaker / --has)"], actual: ["<empty>"] },
         });
     }
     return applySingleScriptOp(opts, { ...template, at: args[0] });

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

@@ -1 +1 @@
-{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../src/usecases/script/replace.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,EAAqB,YAAY,EAAE,kBAAkB,EAA+J,qBAAqB,GACjZ,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC,8BAA8B,EAAE,iBAAiB,EAAE;YACpE,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,eAAe,CAAC;YAC3B,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,SAAS,EAAE,CAAC,sEAAsE,CAAC;YACnF,SAAS,EAAE,iBAAiB;SAC7B,CAAC,CAAC;IACL,CAAC;IACD,2EAA2E;IAC3E,gEAAgE;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAS,KAAK;QAC1B,CAAC,CAAC,EAAE,EAAE,EAAE,8BAA8B,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE;QACrI,CAAC,CAAC,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC1G,IAAI,YAAY;QAAE,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,kCAAkC,EAAE,qBAAqB,EAAE;YAC5E,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,qGAAqG,CAAC;YACjH,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,sDAAsD,CAAC;YACnE,SAAS,EAAE,oBAAoB;SAChC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../src/usecases/script/replace.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,EAAqB,YAAY,EAAE,kBAAkB,EAA+J,qBAAqB,GACjZ,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE;YAC9B,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,iBAAiB;YAC5B,IAAI,EAAE,sEAAsE;YAC5E,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;SAC7D,CAAC,CAAC;IACX,CAAC;IACD,2EAA2E;IAC3E,gEAAgE;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAS,KAAK;QAC1B,CAAC,CAAC,EAAE,EAAE,EAAE,8BAA8B,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE;QACrI,CAAC,CAAC,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC1G,IAAI,YAAY;QAAE,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE;YAClC,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,oBAAoB;YAC/B,IAAI,EAAE,sDAAsD;YAC5D,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,qGAAqG,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;SACjJ,CAAC,CAAC;IACX,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/usecases/script/role.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 commandRole(opts: Dict): Promise<[Report, number]>;
+export declare function commandRole(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/role.js

@@ -4,12 +4,11 @@ import { applySingleScriptOp, } from "./lib.js";
 export async function commandRole(opts) {
     const args = asList(opts["_args"]);
     if (args.length < 2) {
-        throw new CliError("VERB BLOCKED: Role args missing", "Role args missing.", {
+        throw new CliError("Role args missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<actor:id> <主角|配角>"],
-            received: args,
-            nextSteps: ["Example: scriptctl role actor:act_001 主角"],
             errorCode: "ARGS_MISSING",
+            hint: "Example: scriptctl role actor:act_001 主角",
+            data: { expected: ["<actor:id> <主角|配角>"], actual: args },
         });
     }
     return applySingleScriptOp(opts, { op: "asset.role.set", target: args[0], role_type: args[1] });

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

@@ -1 +1 @@
-{"version":3,"file":"role.js","sourceRoot":"","sources":["../../../src/usecases/script/role.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;AAElB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU;IAC1C,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,iCAAiC,EAAE,oBAAoB,EAAE;YAC1E,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,oBAAoB,CAAC;YAChC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"role.js","sourceRoot":"","sources":["../../../src/usecases/script/role.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;AAElB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU;IAC1C,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,oBAAoB,EAAE;YACjC,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,0CAA0C;YAChD,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;SACzD,CAAC,CAAC;IACX,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/usecases/script/scenes.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 commandScenes(opts: Dict): Promise<[Report, number]>;
+export declare function commandScenes(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/scenes.js

@@ -3,21 +3,34 @@ import { sceneRefs } from "../../domain/script/scene-refs.js";
 import { parseInSelector, } from "../../domain/script/selector.js";
 import { asList, strOf, } from "../../domain/script/shared.js";
 import { loadScriptForEdit, } from "./session.js";
-import { buildReport, nameMaps, formatScene, } from "./lib.js";
+import { buildTableReport, nameMaps, formatScene, sceneTimeSpan, } from "./lib.js";
+import { normalizeV3QuerySelector } from "../../domain/script/v3/ordinal.js";
+import { requireScriptV4 } from "../../domain/script/v4/parse.js";
+import { parseV4Selector } from "../../domain/script/v4/selector.js";
 export async function commandScenes(opts) {
     const session = await loadScriptForEdit(opts);
     const script = session.script;
-    const selector = parseInSelector(strOf(opts["in"]));
+    const selector = session.version === 3
+        ? parseInSelector(normalizeV3QuerySelector(script, opts["in"]))
+        : null;
+    const selectorV4 = session.version === 4
+        ? parseV4Selector(requireScriptV4(script), opts["in"], { allowOrdinals: true })
+        : null;
     const hasActor = strOf(opts["has_actor"]).trim();
     const hasLocation = strOf(opts["has_location"]).trim();
     const hasProp = strOf(opts["has_prop"]).trim();
     const names = nameMaps(script);
     const lines = [];
-    for (const ep of asList(script["episodes"])) {
+    const rows = [];
+    let globalSceneNo = 0;
+    for (const [episodeIndex, ep] of asList(script["episodes"]).entries()) {
         const epId = strOf(ep["episode_id"]);
-        for (const scene of asList(ep["scenes"])) {
+        for (const [sceneIndex, scene] of asList(ep["scenes"]).entries()) {
+            globalSceneNo++;
             const sceneId = strOf(scene["scene_id"]);
-            if (!selector.matchesScene(epId, sceneId))
+            if (selector !== null && !selector.matchesScene(epId, sceneId))
+                continue;
+            if (selectorV4 !== null && !selectorV4.matchesScene(sceneId))
                 continue;
             const refs = sceneRefs(scene);
             if (hasActor && !asList(refs["actors"]).some((r) => strOf(r["actor_id"]) === hasActor))
@@ -26,10 +39,25 @@ export async function commandScenes(opts) {
                 continue;
             if (hasProp && !asList(refs["props"]).some((r) => strOf(r["prop_id"]) === hasProp))
                 continue;
-            lines.push(formatScene(epId, scene, names));
+            const formatted = formatScene(epId, scene, names);
+            const timeSpan = sceneTimeSpan(scene);
+            lines.push(session.version === 4 ? formatted.replace(`${epId}/${sceneId}`, sceneId) : formatted);
+            rows.push({
+                addr: session.version === 4 ? sceneId : `${epId}/${sceneId}`,
+                ep_no: episodeIndex + 1,
+                scene_no: sceneIndex + 1,
+                global_scene_no: globalSceneNo,
+                episode_id: epId,
+                scene_id: sceneId,
+                actions: asList(scene["actions"]).length,
+                ...timeSpan,
+            });
         }
     }
-    return [buildReport("query.scenes", "SCENES", lines, session.artifactLabel), EXIT_OK];
+    return [
+        buildTableReport("query.scenes", lines, ["addr", "ep_no", "scene_no", "global_scene_no", "episode_id", "scene_id", "actions", "t_start", "t_end"], rows),
+        EXIT_OK,
+    ];
 }
 // ----- actions --------------------------------------------------------------
 // A matched action with its address coordinates. The shared currency between

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

@@ -1 +1 @@
-{"version":3,"file":"scenes.js","sourceRoot":"","sources":["../../../src/usecases/script/scenes.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAIL,eAAe,GAGhB,MAAM,iCAAiC,CAAC;AAkBzC,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,GAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EAC6P,WAAW,EAAsC,QAAQ,EAAE,WAAW,GACzU,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,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,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;gBAAE,SAAS;YACpD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,QAAQ,CAAC;gBAAE,SAAS;YACvG,IAAI,WAAW,IAAI,CAAC,MAAM,CAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAAK,WAAW,CAAC;gBAAE,SAAS;YACnH,IAAI,OAAO,IAAI,CAAC,MAAM,CAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,OAAO,CAAC;gBAAE,SAAS;YACnG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,+EAA+E;AAE/E,6EAA6E;AAC7E,kFAAkF;AAClF,iDAAiD"}
+{"version":3,"file":"scenes.js","sourceRoot":"","sources":["../../../src/usecases/script/scenes.ts"],"names":[],"mappings":"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"}

package/dist/usecases/script/script-patch.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 commandScriptPatch(opts: Dict): Promise<[Report, number]>;
+export declare function commandScriptPatch(opts: Dict): Promise<[CommandOutput, number]>;