@lingjingai/scriptctl 0.19.2 → 0.21.0

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

@@ -0,0 +1,23 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandStateAdd(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 2) {
+        throw new CliError("VERB BLOCKED: state-add args missing", "state-add args missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<asset-addr> <state-name>"],
+            received: args,
+            nextSteps: ["Example: scriptctl state-add actor:act_001 \"震惊\""],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return applySingleScriptOp(opts, {
+        op: "state.add",
+        target: args[0],
+        name: args[1],
+        description: opts["description"],
+        state_id: opts["state_id"],
+    });
+}
+//# sourceMappingURL=state-add.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-add.js","sourceRoot":"","sources":["../../../src/usecases/script/state-add.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,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,sCAAsC,EAAE,yBAAyB,EAAE;YACpF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,2BAA2B,CAAC;YACvC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,mDAAmD,CAAC;YAChE,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE;QAC/B,EAAE,EAAE,WAAW;QACf,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACb,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/usecases/script/state-change.d.ts

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

package/dist/usecases/script/state-change.js

@@ -0,0 +1,24 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, applySelectorEdits, selectionHasAnyFilter, } from "./lib.js";
+import { stateChangeTemplate } from "./lib.js";
+export async function commandStateChange(opts) {
+    const args = asList(opts["_args"]);
+    const selectorMode = selectionHasAnyFilter(opts);
+    // Single-point: `state-change <at> <target>`; selector: `state-change <target>`.
+    const target = strOf(selectorMode ? args[0] : args[1]);
+    if (!target) {
+        throw new CliError("VERB BLOCKED: state-change args missing", "state-change args missing.", {
+            exitCode: EXIT_USAGE,
+            required: [selectorMode ? "<asset-addr> (with a selection)" : "<action-addr> <asset-addr>"],
+            received: args,
+            nextSteps: ["Example: scriptctl state-change ep_001/scn_001#3 actor:act_001 --to st_shock  |  scriptctl state-change --in ep_005/scn_002#0..#9 actor:act_001 --to st_shock --apply"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const template = stateChangeTemplate(target, { to: opts["to"], from: opts["from"], effective: opts["effective"], clear: Boolean(opts["clear"]) });
+    if (selectorMode)
+        return applySelectorEdits(opts, template, "state-change");
+    return applySingleScriptOp(opts, { ...template, at: args[0] });
+}
+//# sourceMappingURL=state-change.js.map

package/dist/usecases/script/state-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-change.js","sourceRoot":"","sources":["../../../src/usecases/script/state-change.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,EAAmC,kBAAkB,EAA0M,qBAAqB,GAC5b,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,iFAAiF;IACjF,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,yCAAyC,EAAE,4BAA4B,EAAE;YAC1F,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,4BAA4B,CAAC;YAC3F,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,uKAAuK,CAAC;YACpL,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClJ,IAAI,YAAY;QAAE,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5E,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

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

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

package/dist/usecases/script/state-delete.js

@@ -0,0 +1,23 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandStateDelete(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: state-delete address missing", "state-delete address missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<state-addr>"],
+            received: ["<empty>"],
+            nextSteps: ["Example: scriptctl state-delete actor:act_001/st_calm --strategy remove"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return applySingleScriptOp(opts, {
+        op: "state.delete",
+        target: args[0],
+        strategy: opts["strategy"],
+        replacement: opts["replacement"],
+    });
+}
+// ----- scene context ref ----------------------------------------------------
+//# sourceMappingURL=state-delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-delete.js","sourceRoot":"","sources":["../../../src/usecases/script/state-delete.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,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,4CAA4C,EAAE,+BAA+B,EAAE;YAChG,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,cAAc,CAAC;YAC1B,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,yEAAyE,CAAC;YACtF,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE;QAC/B,EAAE,EAAE,cAAc;QAClB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QACf,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;KACjC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E"}

package/dist/usecases/script/state-rename.d.ts

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

package/dist/usecases/script/state-rename.js

@@ -0,0 +1,17 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandStateRename(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 2) {
+        throw new CliError("VERB BLOCKED: state-rename args missing", "state-rename args missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<state-addr> <new-name>"],
+            received: args,
+            nextSteps: ["Example: scriptctl state-rename actor:act_001/st_calm \"平静（新）\""],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return applySingleScriptOp(opts, { op: "state.rename", target: args[0], name: args[1] });
+}
+//# sourceMappingURL=state-rename.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-rename.js","sourceRoot":"","sources":["../../../src/usecases/script/state-rename.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,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,yCAAyC,EAAE,4BAA4B,EAAE;YAC1F,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,yBAAyB,CAAC;YACrC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,iEAAiE,CAAC;YAC9E,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,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;AAC3F,CAAC"}

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

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

package/dist/usecases/script/summary.js

@@ -0,0 +1,45 @@
+import { EXIT_OK, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { loadScriptForEdit, } from "./session.js";
+import { buildReport, synopsisPreview, } from "./lib.js";
+export async function commandSummary(opts) {
+    const session = await loadScriptForEdit(opts);
+    const script = session.script;
+    const episodes = asList(script["episodes"]);
+    const scenes = [];
+    for (const ep of episodes)
+        scenes.push(...asList(ep["scenes"]));
+    const actions = [];
+    for (const scene of scenes)
+        actions.push(...asList(scene["actions"]));
+    const lines = [
+        `title: ${script["title"] || "-"}`,
+        `episodes: ${episodes.length}`,
+        `scenes: ${scenes.length}`,
+        `actions: ${actions.length}`,
+        `actors: ${asList(script["actors"]).length}`,
+        `locations: ${asList(script["locations"]).length}`,
+        `props: ${asList(script["props"]).length}`,
+        `speakers: ${asList(script["speakers"]).length}`,
+    ];
+    const logline = strOf(script["logline"]).trim();
+    if (logline)
+        lines.push(`logline: ${logline}`);
+    const theme = strOf(script["theme"]).trim();
+    if (theme)
+        lines.push(`theme: ${theme}`);
+    const synopsis = strOf(script["synopsis"]).trim();
+    if (synopsis)
+        lines.push(`synopsis: ${synopsisPreview(synopsis, 120)}`);
+    const mainCharacters = asList(script["main_characters"])
+        .map((c) => strOf(c["name"]).trim())
+        .filter((n) => n);
+    if (mainCharacters.length > 0)
+        lines.push(`main characters: ${mainCharacters.slice(0, 6).join(", ")}`);
+    return [buildReport("query.summary", "SCRIPT SUMMARY", lines, session.artifactLabel, ["Use plural-noun queries (episodes / scenes / actions / actors / ...) or edit verbs to act on the script."]), EXIT_OK];
+}
+// ----- episodes -------------------------------------------------------------
+// An episode is in scope when the selector is empty, when an episode-level
+// region covers it (probe with a scn=0 id, which only matches episode regions
+// and so also covers scene-less episodes), or when any of its scenes matches.
+//# sourceMappingURL=summary.js.map

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

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

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

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

package/dist/usecases/script/transition.js

@@ -0,0 +1,24 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, applySelectorEdits, selectionHasAnyFilter, } from "./lib.js";
+import { transitionTemplate } from "./lib.js";
+export async function commandTransition(opts) {
+    const args = asList(opts["_args"]);
+    const selectorMode = selectionHasAnyFilter(opts);
+    const target = strOf(selectorMode ? args[0] : args[1]);
+    if (!target) {
+        throw new CliError("VERB BLOCKED: transition args missing", "transition args missing.", {
+            exitCode: EXIT_USAGE,
+            required: [selectorMode ? "<asset-addr> (with a selection)" : "<action-addr> <asset-addr>"],
+            received: args,
+            nextSteps: ["Example: scriptctl transition ep_001/scn_001#3 actor:act_001 --process \"...\" --contrast \"...\"  |  scriptctl transition --in ep_005..ep_006 --has transition actor:act_001 --clear --apply"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const template = transitionTemplate(target, { process: opts["process"], contrast: opts["contrast"], clear: Boolean(opts["clear"]) });
+    if (selectorMode)
+        return applySelectorEdits(opts, template, "transition");
+    return applySingleScriptOp(opts, { ...template, at: args[0] });
+}
+// ----- dialogue / speaker ---------------------------------------------------
+//# sourceMappingURL=transition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transition.js","sourceRoot":"","sources":["../../../src/usecases/script/transition.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,EAAmC,kBAAkB,EAA0M,qBAAqB,GAC5b,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,0BAA0B,EAAE;YACtF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,4BAA4B,CAAC;YAC3F,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,+LAA+L,CAAC;YAC5M,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACrI,IAAI,YAAY;QAAE,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1E,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E"}

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

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

package/dist/usecases/script/type.js

@@ -0,0 +1,24 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, strOf, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, applySelectorEdits, selectionHasAnyFilter, } from "./lib.js";
+export async function commandType(opts) {
+    const args = asList(opts["_args"]);
+    const selectorMode = selectionHasAnyFilter(opts);
+    // Single-point: `type <at> <type>` (value = args[1]). Selector: `type <type>`
+    // (value = args[0]); --type stays a filter predicate, not the new value.
+    const typeVal = strOf(selectorMode ? args[0] : args[1]).trim();
+    if (!typeVal) {
+        throw new CliError("VERB BLOCKED: Type args missing", "Type args missing.", {
+            exitCode: EXIT_USAGE,
+            required: [selectorMode ? "<type> (with a selection)" : "<action ref> <type>"],
+            received: args,
+            nextSteps: ["Example: scriptctl type ep_001/scn_001#3 dialogue  |  scriptctl type --in ep_001 dialogue --apply"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    const template = { op: "action.type.set", type: typeVal };
+    if (selectorMode)
+        return applySelectorEdits(opts, template, "type");
+    return applySingleScriptOp(opts, { ...template, at: args[0] });
+}
+//# sourceMappingURL=type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/usecases/script/type.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,EAAmC,kBAAkB,EAA0M,qBAAqB,GAC5b,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,iCAAiC,EAAE,oBAAoB,EAAE;YAC1E,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,qBAAqB,CAAC;YAC9E,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,mGAAmG,CAAC;YAChH,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAS,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAChE,IAAI,YAAY;QAAE,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

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

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

package/dist/usecases/script/worldview.js

@@ -0,0 +1,18 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, } from "../../domain/script/shared.js";
+import { applySingleScriptOp, } from "./lib.js";
+export async function commandWorldview(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError("VERB BLOCKED: Worldview value missing", "Worldview value missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<value>"],
+            received: ["<empty>"],
+            nextSteps: ["Example: scriptctl worldview 现代"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return applySingleScriptOp(opts, { op: "meta.worldview.set", worldview: args[0] });
+}
+// ----- state management -----------------------------------------------------
+//# sourceMappingURL=worldview.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worldview.js","sourceRoot":"","sources":["../../../src/usecases/script/worldview.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EAKR,UAAU,GASX,MAAM,iBAAiB,CAAC;AAmCzB,OAAO,EACL,MAAM,GAKP,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAC+I,mBAAmB,GACxK,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU;IAC/C,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,SAAS,CAAC;YACrB,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,SAAS,EAAE,CAAC,iCAAiC,CAAC;YAC9C,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,+EAA+E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/scriptctl",
-  "version": "0.19.2",
+  "version": "0.21.0",
   "description": "剧本阶段统一 CLI：直转外部素材到 script.json，以及当前最终剧本的读取、校验、原子编辑与批量 patch 精修。",
   "type": "module",
   "bin": {

package/dist/domain/script-core.d.ts

@@ -1,78 +0,0 @@
-type Dict = Record<string, unknown>;
-export declare function findAction(script: Dict, epId: string, sceneId: string, actionIndex: number): Dict;
-export declare function findEpisode(script: Dict, epId: string): Dict;
-export declare function findScene(script: Dict, epId: string, sceneId: string): Dict;
-/**
- * Minimal schema-v2 script skeleton: every required top-level field present,
- * all collections empty. It is the starting point for building a script
- * bottom-up with the atomic add/insert verbs instead of assembling it from
- * source material (direct) or md (parse). `worldview`/`style`/`title` are
- * present-but-empty so the field-presence checks pass; they get filled in
- * later via `worldview` / `patch`. A blank script validates clean: NO_EPISODES
- * is a completeness warning (`incomplete_ok`), not a blocker.
- */
-export declare function blankScript(title?: string): Dict;
-/**
- * Validate a script's schema and asset wiring.
- *
- * Pass either:
- *   - `scriptPath: string` (or null → default to direct's script.initial.json), or
- *   - `opts.scriptData: Dict` to validate an in-memory object without writing to disk.
- *
- * Callers that already have the script as a parsed object (episode draft / publish
- * after assembly) should prefer `scriptData` to avoid the write-validate-rm dance.
- *
- * Completeness issues (no episodes, empty episode/scene, scene without location,
- * missing asset description) are emitted as warnings (`incomplete_ok`), not
- * errors — an unfinished but structurally-sound script passes. Only integrity
- * violations (dangling refs, dup ids, invalid enums, missing ids/names) fail it.
- */
-export declare function validateScript(workspace: string, scriptPath?: string | null, opts?: {
-    requireSource?: boolean;
-    scriptData?: Dict;
-    persist?: boolean;
-}): Dict;
-export declare function assetKeys(assetType: string): [string, string, string];
-export declare function ensureRefId(script: Dict, assetType: string, rawId: unknown, opts?: {
-    allowNone?: boolean;
-}): string | null;
-export declare function parseAssetTarget(raw: unknown): [string, string];
-export declare function parseStateTarget(raw: unknown): [string, string, string];
-export declare function parseSceneRef(raw: unknown): [string, string];
-export declare function parseActionRef(raw: unknown): [string, string, number];
-export declare function collectStateRefs(script: Dict, kind: string, targetId: string, stateId: string): Dict[];
-export type AnyAddress = {
-    kind: "action";
-    episodeId: string;
-    sceneId: string;
-    actionIndex: number;
-} | {
-    kind: "scene";
-    episodeId: string;
-    sceneId: string;
-} | {
-    kind: "asset";
-    assetKind: string;
-    assetId: string;
-} | {
-    kind: "state";
-    assetKind: string;
-    assetId: string;
-    stateId: string;
-} | {
-    kind: "episode";
-    episodeId: string;
-} | {
-    kind: "speaker";
-    speakerId: string;
-};
-export declare function parseAnyAddress(raw: unknown): AnyAddress;
-export declare function collectAssetRefs(script: Dict, kind: string, targetId: string): Dict[];
-export interface PatchOpFieldSchema {
-    required: string[];
-    optional: string[];
-    description: string;
-}
-export declare const PATCH_OP_SCHEMA: Record<string, PatchOpFieldSchema>;
-export declare function applyPatchOperations(script: Dict, sourceText: string, operations: Dict[]): string[];
-export {};