@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/usecases/script/extend.js

@@ -1,9 +1,12 @@
 import { CliError, EXIT_OK, EXIT_USAGE, } from "../../common.js";
 import { parseAnyAddress } from "../../domain/script/address.js";
 import { readExtend } from "../../domain/script/patch/ops-extend.js";
+import { parseV4Address } from "../../domain/script/v4/address.js";
+import { readExtendV4 } from "../../domain/script/v4/patch/ops-extend.js";
+import { requireScriptV4 } from "../../domain/script/v4/parse.js";
 import { asList } from "../../domain/script/shared.js";
 import { loadScriptForEdit } from "./session.js";
-import { applySingleScriptOp, buildReport } from "./lib.js";
+import { applySingleScriptOpToSession } from "./lib.js";
 // `extend <addr> [key] [value]` — the free-form namespace verb, dual-mode:
 //   • no key            → read: list the node's extend{} container
 //   • key + value       → write: set extend[key] = value (string, or JSON via --json-value)
@@ -13,43 +16,63 @@ import { applySingleScriptOp, buildReport } from "./lib.js";
 export async function commandExtend(opts) {
     const args = asList(opts["_args"]);
     if (args.length < 1) {
-        throw new CliError("VERB BLOCKED: extend address missing", "extend address missing.", {
+        throw new CliError("extend address missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<addr> [key] [value]"],
-            received: ["<empty>"],
-            nextSteps: ["Example: scriptctl extend global art_style cyberpunk  |  scriptctl extend ep_001/scn_001 (read)"],
             errorCode: "ARGS_MISSING",
+            hint: "Example: scriptctl extend global art_style cyberpunk  |  scriptctl extend ep_001/scn_001 (read)",
+            data: { expected: ["<addr> [key] [value]"], actual: ["<empty>"] },
         });
     }
-    parseAnyAddress(args[0]); // early-validate address shape before any IO
+    const session = await loadScriptForEdit(opts);
+    if (session.version === 4) {
+        if (args[0] !== "global")
+            parseV4Address(args[0]);
+    }
+    else {
+        parseAnyAddress(args[0]);
+    }
     const clear = Boolean(opts["clear"]);
     // Read mode: address only, no key, not a wipe.
     if (args.length < 2 && !clear) {
-        return listExtend(opts, args[0]);
+        const ext = session.version === 4
+            ? readExtendV4(requireScriptV4(session.script), args[0])
+            : readExtend(session.script, parseAnyAddress(args[0]));
+        const lines = [];
+        for (const k of Object.keys(ext))
+            lines.push(`${k} = ${JSON.stringify(ext[k])}`);
+        if (lines.length === 0)
+            lines.push("(no extend keys)");
+        return [{
+                text: lines.join("\n"),
+                data: {
+                    op: "query.extend",
+                    changed: false,
+                    target: args[0],
+                    content: ext,
+                },
+            }, EXIT_OK];
     }
     const key = args[1];
     if (clear) {
         // --clear is a delete; a value makes the intent contradictory. Refuse rather
         // than silently dropping the value and deleting (a set→delete footgun).
         if (args.length >= 3) {
-            throw new CliError("VERB BLOCKED: extend --clear takes no value", "extend --clear takes no value.", {
+            throw new CliError("extend --clear takes no value.", {
                 exitCode: EXIT_USAGE,
-                required: ["<addr> <key> --clear  (delete a key) or <addr> --clear (wipe)"],
-                received: args,
-                nextSteps: ["Drop --clear to set the value, or drop the value to delete the key."],
                 errorCode: "EXTEND_CLEAR_WITH_VALUE",
+                hint: "Drop --clear to set the value, or drop the value to delete the key.",
+                data: { expected: ["<addr> <key> --clear  (delete a key) or <addr> --clear (wipe)"], actual: args },
             });
         }
         // key omitted → wipe container; key present → delete that key.
-        return applySingleScriptOp(opts, { op: "extend.clear", at: args[0], key });
+        return applySingleScriptOpToSession(session, opts, { op: "extend.clear", at: args[0], key });
     }
     if (args.length < 3) {
-        throw new CliError("VERB BLOCKED: extend value missing", "extend value missing.", {
+        throw new CliError("extend value missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<addr> <key> <value>  (or --clear to delete)"],
-            received: args,
-            nextSteps: ["Pass a value, or use --clear to delete the key."],
             errorCode: "EXTEND_VALUE_MISSING",
+            hint: "Pass a value, or use --clear to delete the key.",
+            data: { expected: ["<addr> <key> <value>  (or --clear to delete)"], actual: args },
         });
     }
     let value = args[2];
@@ -58,25 +81,14 @@ export async function commandExtend(opts) {
             value = JSON.parse(args[2]);
         }
         catch {
-            throw new CliError("VERB BLOCKED: extend --json-value invalid", "extend --json-value is not valid JSON.", {
+            throw new CliError("extend --json-value is not valid JSON.", {
                 exitCode: EXIT_USAGE,
-                required: ["valid JSON after --json-value"],
-                received: [args[2]],
-                nextSteps: ["Fix the JSON, or drop --json-value to store a literal string."],
                 errorCode: "EXTEND_JSON_INVALID",
+                hint: "Fix the JSON, or drop --json-value to store a literal string.",
+                data: { expected: ["valid JSON after --json-value"], actual: [args[2]] },
             });
         }
     }
-    return applySingleScriptOp(opts, { op: "extend.set", at: args[0], key, value });
-}
-async function listExtend(opts, addrRaw) {
-    const session = await loadScriptForEdit(opts);
-    const ext = readExtend(session.script, parseAnyAddress(addrRaw));
-    const lines = [];
-    for (const k of Object.keys(ext))
-        lines.push(`${k} = ${JSON.stringify(ext[k])}`);
-    if (lines.length === 0)
-        lines.push("(no extend keys)");
-    return [buildReport("query.extend", `EXTEND ${addrRaw}`, lines, session.artifactLabel), EXIT_OK];
+    return applySingleScriptOpToSession(session, opts, { op: "extend.set", at: args[0], key, value });
 }
 //# sourceMappingURL=extend.js.map

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

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

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

package/dist/usecases/script/ids.js

@@ -1,6 +1,7 @@
 import * as fs from "node:fs";
-import { CliError, EXIT_INPUT, EXIT_OK, EXIT_USAGE, scriptJsonPath, } from "../../common.js";
-import { requireScriptV3 } from "../../domain/script/parse.js";
+import { CliError, EXIT_INPUT, EXIT_OK, EXIT_USAGE, exists, scriptJsonPath, } from "../../common.js";
+import { requireScriptDocument } from "../../domain/script/dispatch.js";
+import { generateV4Ids } from "../../domain/script/v4/ids.js";
 import { strOf } from "../../domain/script/shared.js";
 const PREFIX = {
     actor: "act",
@@ -9,6 +10,7 @@ const PREFIX = {
     state: "st",
     episode: "ep",
     scene: "scn",
+    action: "ac",
 };
 function isIdKind(value) {
     return value === "actor"
@@ -16,34 +18,39 @@ function isIdKind(value) {
         || value === "prop"
         || value === "state"
         || value === "episode"
-        || value === "scene";
+        || value === "scene"
+        || value === "action";
 }
 function usage(message, received) {
-    throw new CliError("IDS BLOCKED: invalid invocation", message, {
+    throw new CliError(message, {
         exitCode: EXIT_USAGE,
         errorCode: "IDS_USAGE_INVALID",
-        required: ["--kind actor|location|prop|state|episode|scene", "--count <positive integer>"],
-        received,
-        nextSteps: ["Pass one canonical ID kind and the number of candidate IDs needed."],
+        hint: "Pass one canonical ID kind and the number of candidate IDs needed.",
+        data: {
+            expected: ["--kind actor|location|prop|state|episode|scene|action", "--count <positive integer>"],
+            actual: received,
+        },
     });
 }
 function readScript(opts) {
     const scriptPath = scriptJsonPath(opts);
+    if (!exists(scriptPath))
+        return null;
     let parsed;
     try {
         parsed = JSON.parse(fs.readFileSync(scriptPath, "utf-8"));
     }
     catch (error) {
-        throw new CliError("IDS BLOCKED: local script unavailable", "The local Script v3 file cannot be read.", {
+        throw new CliError("The local script file cannot be read.", {
             exitCode: EXIT_INPUT,
             errorCode: "SCRIPT_JSON_UNAVAILABLE",
-            received: [scriptPath, error instanceof Error ? error.message : String(error)],
-            nextSteps: ["Use an existing local script; for a brand-new script, assign canonical IDs directly."],
+            hint: "Fix the local JSON file, or pass a path that does not exist to generate unbound v4 candidates.",
+            data: { actual: [scriptPath, error instanceof Error ? error.message : String(error)] },
         });
     }
-    return requireScriptV3(parsed);
+    return requireScriptDocument(parsed);
 }
-function existingIds(script, kind) {
+function existingIdsV3(script, kind) {
     if (kind === "actor")
         return script.actors.map((asset) => asset.actor_id);
     if (kind === "location")
@@ -60,7 +67,7 @@ function existingIds(script, kind) {
         ...script.props.flatMap((asset) => asset.states.map((state) => state.state_id)),
     ].filter((id) => id !== "default");
 }
-function allocate(ids, prefix, count) {
+function allocateV3(ids, prefix, count) {
     const pattern = new RegExp(`^${prefix}_(\\d+)$`);
     let maximum = 0;
     for (const id of ids) {
@@ -73,6 +80,26 @@ function allocate(ids, prefix, count) {
         return `${prefix}_${String(value).padStart(3, "0")}`;
     });
 }
+function existingIdsV4(script, kind) {
+    if (kind === "actor")
+        return script.actors.map((asset) => asset.actor_id);
+    if (kind === "location")
+        return script.locations.map((asset) => asset.location_id);
+    if (kind === "prop")
+        return script.props.map((asset) => asset.prop_id);
+    if (kind === "episode")
+        return script.episodes.map((episode) => episode.episode_id);
+    if (kind === "scene")
+        return script.episodes.flatMap((episode) => episode.scenes.map((scene) => scene.scene_id));
+    if (kind === "action") {
+        return script.episodes.flatMap((episode) => episode.scenes.flatMap((scene) => scene.actions.map((action) => action.action_id)));
+    }
+    return [
+        ...script.actors.flatMap((asset) => asset.states.map((state) => state.state_id)),
+        ...script.locations.flatMap((asset) => asset.states.map((state) => state.state_id)),
+        ...script.props.flatMap((asset) => asset.states.map((state) => state.state_id)),
+    ].filter((id) => id !== "default");
+}
 export function commandIds(opts) {
     const rawKind = strOf(opts["kind"]).trim();
     if (!isIdKind(rawKind))
@@ -85,16 +112,36 @@ export function commandIds(opts) {
     if (!Number.isSafeInteger(count))
         usage("ID count is outside the safe integer range.", [rawCount]);
     const script = readScript(opts);
-    const candidates = allocate(existingIds(script, kind), PREFIX[kind], count);
+    let candidates;
+    let scriptVersion;
+    if (script?.version === 3) {
+        scriptVersion = 3;
+        if (kind === "action") {
+            throw new CliError("Action IDs belong to Script v4.", {
+                exitCode: EXIT_USAGE,
+                errorCode: "V3_ACTION_ID_UNSUPPORTED",
+                hint: "Generate unbound v4 candidates without an existing v3 --script-path.",
+            });
+        }
+        candidates = allocateV3(existingIdsV3(script, kind), PREFIX[kind], count);
+    }
+    else {
+        scriptVersion = script?.version ?? null;
+        const existing = script === null ? new Set() : new Set(existingIdsV4(script, kind));
+        candidates = generateV4Ids(kind, count, existing);
+    }
     const rows = candidates.map((id) => ({ addr: id, kind, id }));
     const report = {
-        title: "IDS",
-        op: "ids",
-        row_columns: ["addr", "kind", "id"],
-        rows,
-        kind,
-        count,
-        reserved: false,
+        text: rows.map((row) => `${row.addr}\t${row.kind}\t${row.id}`).join("\n"),
+        data: {
+            op: "ids",
+            row_columns: ["addr", "kind", "id"],
+            rows,
+            kind,
+            count,
+            reserved: false,
+            script_version: scriptVersion,
+        },
     };
     return [report, EXIT_OK];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/usecases/script/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,OAAO,EACP,UAAU,EACV,cAAc,GAEf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAa,MAAM,+BAA+B,CAAC;AAEjE,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,KAAK;CACJ,CAAC;AAIX,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,KAAK,OAAO;WACnB,KAAK,KAAK,UAAU;WACpB,KAAK,KAAK,MAAM;WAChB,KAAK,KAAK,OAAO;WACjB,KAAK,KAAK,SAAS;WACnB,KAAK,KAAK,OAAO,CAAC;AACzB,CAAC;AAED,SAAS,KAAK,CAAC,OAAe,EAAE,QAAkB;IAChD,MAAM,IAAI,QAAQ,CAAC,iCAAiC,EAAE,OAAO,EAAE;QAC7D,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,CAAC,gDAAgD,EAAE,4BAA4B,CAAC;QAC1F,QAAQ;QACR,SAAS,EAAE,CAAC,oEAAoE,CAAC;KAClF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,0CAA0C,EAAE;YACtG,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,yBAAyB;YACpC,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9E,SAAS,EAAE,CAAC,sFAAsF,CAAC;SACpG,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,MAAgB,EAAE,IAAY;IACjD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1E,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnF,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpF,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjH,OAAO;QACL,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChF,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnF,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KAChF,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,QAAQ,CAAC,GAAa,EAAE,MAAc,EAAE,KAAa;IAC5D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC;IACjD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC;QACnC,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,OAAO,CAAC;IACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,sCAAsC,EAAE,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC;IAC3G,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,6CAA6C,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnG,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAW;QACrB,KAAK,EAAE,KAAK;QACZ,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACnC,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,KAAK;KAChB,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/usecases/script/ids.ts"],"names":[],"mappings":"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"}

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

package/dist/usecases/script/importance.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"importance.js","sourceRoot":"","sources":["../../../src/usecases/script/importance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAa,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,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,uCAAuC,EAAE,0BAA0B,EAAE;YACtF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,iCAAiC,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,wDAAwD,CAAC;YACrE,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,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC"}
+{"version":3,"file":"importance.js","sourceRoot":"","sources":["../../../src/usecases/script/importance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAsB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAa,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,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,0BAA0B,EAAE;YACvC,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,wDAAwD;YAC9D,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,iCAAiC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;SACtE,CAAC,CAAC;IACX,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC"}

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

package/dist/usecases/script/insert.js

@@ -1,57 +1,92 @@
 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";
+import { parseV4Address } from "../../domain/script/v4/address.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { loadScriptForEdit, } from "./session.js";
+import { applySingleScriptOpToSession, } from "./lib.js";
+import { assertInsertCommandFlags } from "./command-constraints.js";
+function repeatedStrings(raw) {
+    if (raw === undefined)
+        return [];
+    return Array.isArray(raw) ? raw.map(strOf) : [strOf(raw)];
+}
+function insertFlags(opts) {
+    return {
+        type: opts["type"],
+        content: opts["content"],
+        emotion: opts["emotion"],
+        parenthetical: opts["parenthetical"],
+        actionId: opts["action_id"],
+        at: opts["at_index"] ?? opts["at"],
+        before: opts["before"],
+        after: opts["after"],
+        actor: opts["actor_id"] ?? opts["actor"],
+        speaker: opts["speaker_id"] ?? opts["speaker"],
+        speakerState: opts["speaker_state"],
+        kind: opts["kind"],
+        label: opts["label"],
+        location: opts["location"],
+        time: opts["time"],
+        space: opts["space"],
+        sceneId: opts["scene_id"],
+        states: repeatedStrings(opts["state"]),
+    };
+}
 export async function commandInsert(opts) {
     const args = asList(opts["_args"]);
     if (args.length < 1) {
-        throw new CliError("VERB BLOCKED: Insert address missing", "Insert address missing.", {
+        throw new CliError("Insert address missing.", {
             exitCode: EXIT_USAGE,
-            required: ["<addr>: ep_NNN/scn_NNN (action insert) or ep_NNN (scene insert)"],
-            received: ["<empty>"],
-            nextSteps: ["Example: scriptctl insert ep_001/scn_001 --type action --content \"...\""],
             errorCode: "ADDRESS_MISSING",
+            hint: "Example: scriptctl insert ep_001/scn_001 --type action --content \"...\"",
+            data: { expected: ["<addr>: ep_NNN/scn_NNN (action insert) or ep_NNN (scene insert)"], actual: ["<empty>"] },
         });
     }
-    const addr = parseAnyAddress(args[0]);
-    // Per-kind flag whitelist. Silently dropping mismatched flags hid two
-    // real bugs:
-    //   - scene insert was ignoring --scene-id (the user lost custom IDs).
-    //   - mixing action + scene insert flags (`--type` with episode addr, or
-    //     `--location` with scene addr) ran the wrong dispatch silently.
-    const flagsUsed = {
-        type: opts["type"] !== undefined,
-        content: opts["content"] !== undefined,
-        emotion: opts["emotion"] !== undefined,
-        actor: (opts["actor_id"] ?? opts["actor"]) !== undefined,
-        speaker: (opts["speaker_id"] ?? opts["speaker"]) !== undefined,
-        kind: opts["kind"] !== undefined,
-        label: opts["label"] !== undefined,
-        location: opts["location"] !== undefined,
-        time: opts["time"] !== undefined,
-        space: opts["space"] !== undefined,
-        "scene-id": opts["scene_id"] !== undefined,
-    };
-    function rejectFlags(kind, allowed) {
-        const allow = new Set(allowed);
-        const bad = [];
-        for (const f of Object.keys(flagsUsed)) {
-            if (flagsUsed[f] && !allow.has(f))
-                bad.push(`--${f}`);
+    const session = await loadScriptForEdit(opts);
+    const flags = insertFlags(opts);
+    if (session.version === 4) {
+        const addr = parseV4Address(args[0]);
+        if (addr.kind === "scene") {
+            assertInsertCommandFlags(session.version, "action", flags);
+            return applySingleScriptOpToSession(session, opts, {
+                op: "action.insert",
+                at: addr.id,
+                action_id: opts["action_id"],
+                type: opts["type"],
+                content: opts["content"],
+                parenthetical: opts["parenthetical"],
+                before: opts["before"],
+                after: opts["after"],
+                actor_id: opts["actor_id"] ?? opts["actor"],
+                state_id: opts["speaker_state"],
+                kind: opts["kind"],
+                label: opts["label"],
+            });
         }
-        if (bad.length > 0) {
-            throw new CliError("VERB BLOCKED: flag not applicable", `${bad.join(", ")} cannot be used with ${kind} insert.`, {
-                exitCode: EXIT_USAGE,
-                required: [`for ${kind} insert: ${allowed.map((f) => `--${f}`).join(" / ")}`],
-                received: bad,
-                nextSteps: ["Drop the unsupported flag(s) and retry."],
-                errorCode: "INSERT_FLAG_INVALID",
+        if (addr.kind === "episode") {
+            assertInsertCommandFlags(session.version, "scene", flags);
+            return applySingleScriptOpToSession(session, opts, {
+                op: "scene.insert",
+                at: addr.id,
+                location: opts["location"],
+                location_state_ids: flags.states,
+                time: opts["time"],
+                space: opts["space"],
+                scene_id: opts["scene_id"],
+                before: opts["before"],
+                after: opts["after"],
             });
         }
+        throw new CliError("Insert targets a v4 episode or scene ID.", {
+            exitCode: EXIT_USAGE,
+            errorCode: "ADDRESS_UNSUPPORTED",
+            data: { actual: [args[0]] },
+        });
     }
+    const addr = parseAnyAddress(args[0]);
     if (addr.kind === "scene") {
-        rejectFlags("action", ["type", "content", "emotion", "actor", "speaker", "kind", "label"]);
-        return applySingleScriptOp(opts, {
+        assertInsertCommandFlags(session.version, "action", flags);
+        return applySingleScriptOpToSession(session, opts, {
             op: "action.insert",
             at: args[0],
             type: opts["type"],
@@ -67,8 +102,8 @@ export async function commandInsert(opts) {
         });
     }
     if (addr.kind === "episode") {
-        rejectFlags("scene", ["location", "time", "space", "scene-id"]);
-        return applySingleScriptOp(opts, {
+        assertInsertCommandFlags(session.version, "scene", flags);
+        return applySingleScriptOpToSession(session, opts, {
             op: "scene.insert",
             at: addr.episodeId,
             location: opts["location"],
@@ -82,12 +117,11 @@ export async function commandInsert(opts) {
             after: opts["after"],
         });
     }
-    throw new CliError("VERB BLOCKED: insert cannot operate on this address", "insert cannot operate on this address.", {
+    throw new CliError("insert cannot operate on this address.", {
         exitCode: EXIT_USAGE,
-        required: ["ep_NNN (scene insert) or ep_NNN/scn_NNN (action insert)"],
-        received: [args[0]],
-        nextSteps: ["Use an episode or scene address."],
         errorCode: "ADDRESS_UNSUPPORTED",
+        hint: "Use an episode or scene address.",
+        data: { expected: ["ep_NNN (scene insert) or ep_NNN/scn_NNN (action insert)"], actual: [args[0]] },
     });
 }
 //# sourceMappingURL=insert.js.map

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

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

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

@@ -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 commandIssues(opts: Dict): Promise<[Report, number]>;
+export declare function commandIssues(opts: Dict): Promise<[CommandOutput, number]>;

package/dist/usecases/script/issues.js

@@ -1,18 +1,19 @@
 import { EXIT_OK, } from "../../common.js";
 import { asList, strOf, } from "../../domain/script/shared.js";
 import { loadScriptForEdit, validateSession, } from "./session.js";
-import { buildReport, } from "./lib.js";
 export async function commandIssues(opts) {
     const session = await loadScriptForEdit(opts);
     const severityFilter = strOf(opts["severity"]).trim();
     const codeFilter = strOf(opts["code"]).trim();
     const validation = validateSession(session);
     const lines = [];
+    const issues = [];
     for (const issue of asList(validation["issues"])) {
         if (severityFilter && severityFilter !== strOf(issue["severity"]))
             continue;
         if (codeFilter && codeFilter !== strOf(issue["code"]))
             continue;
+        issues.push(issue);
         const whereParts = [];
         for (const k of ["episode", "scene", "action_index"]) {
             if (issue[k] !== null && issue[k] !== undefined)
@@ -21,7 +22,14 @@ export async function commandIssues(opts) {
         const where = whereParts.join(" ");
         lines.push(`${issue["severity"]} ${issue["code"]}: ${issue["summary"]}${where ? ` [${where}]` : ""}`);
     }
-    return [buildReport("query.issues", "ISSUES", lines, session.artifactLabel), EXIT_OK];
+    return [{
+            text: lines.length > 0 ? lines.join("\n") : "No issues.",
+            data: {
+                op: "query.issues",
+                changed: false,
+                issues,
+            },
+        }, EXIT_OK];
 }
 // ----- refs (unified reverse lookup) ----------------------------------------
 //# sourceMappingURL=issues.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/usecases/script/issues.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AA6BzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,EAAE,eAAe,GAEnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAC6P,WAAW,GAC9Q,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,cAAc,IAAI,cAAc,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QAC5E,IAAI,UAAU,IAAI,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAE,SAAS;QAChE,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxG,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"}
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/usecases/script/issues.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AA6BzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,EAAE,eAAe,GAEnC,MAAM,cAAc,CAAC;AAKtB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,cAAc,IAAI,cAAc,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QAC5E,IAAI,UAAU,IAAI,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAE,SAAS;QAChE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,CAAC;YACN,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;YACxD,IAAI,EAAE;gBACJ,EAAE,EAAE,cAAc;gBAClB,OAAO,EAAE,KAAK;gBACd,MAAM;aACP;SACF,EAAE,OAAO,CAAC,CAAC;AACd,CAAC;AAED,+EAA+E"}