@lingjingai/scriptctl 0.13.1 → 0.19.0

package/dist/usecases/script.js

@@ -3,11 +3,12 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { randomUUID } from "node:crypto";
 import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK, EXIT_RUNTIME, EXIT_USAGE, directDir, exists, readJson, readText, scriptJsonPath, sha256Text, writeJson, } from "../common.js";
-import { applyPatchOperations, collectAssetRefs, collectStateRefs, parseAnyAddress, parseStateTarget, validateScript, PATCH_OP_SCHEMA, } from "../domain/script-core.js";
+import { applyPatchOperations, blankScript, collectAssetRefs, collectStateRefs, parseAnyAddress, parseStateTarget, validateScript, PATCH_OP_SCHEMA, } from "../domain/script-core.js";
 import { RemoteScriptOutputStore } from "../infra/script-output-api.js";
 import { LocalScriptOutputStore } from "../infra/local-script-output-store.js";
 import { ScriptOutputApiError, resolveOutputMode, } from "../infra/script-output-store.js";
 import { readRunState, summarizeIssues, updateRunState, } from "./direct.js";
+import { sortDeep } from "../domain/direct-core.js";
 function strOf(v) {
     if (v === null || v === undefined)
         return "";
@@ -747,6 +748,14 @@ async function applySingleScriptOp(opts, op) {
 }
 function summarizeScriptOp(_script, op) {
     const kind = strOf(op["op"]);
+    if (kind === "actor.add")
+        return `已新增人物 ${op["name"] || op["actor_name"]}${op["role_type"] ? `（${op["role_type"]}）` : ""}`;
+    if (kind === "location.add")
+        return `已新增场景地点 ${op["name"] || op["location_name"]}`;
+    if (kind === "prop.add")
+        return `已新增道具 ${op["name"] || op["prop_name"]}`;
+    if (kind === "episode.add")
+        return `已新增分集${op["episode_id"] ? ` ${op["episode_id"]}` : "（自动编号）"}${op["title"] ? `：${op["title"]}` : ""}`;
     if (kind === "state.add")
         return `已为 ${op["target"]} 新增状态 ${op["state_id"]}: ${op["name"] || op["state_name"]}`;
     if (kind === "action.state.change")
@@ -905,17 +914,9 @@ export async function commandExport(opts) {
     };
     return [report, EXIT_OK];
 }
-export function sortDeep(value) {
-    if (Array.isArray(value))
-        return value.map((v) => sortDeep(v));
-    if (isDict(value)) {
-        const sorted = {};
-        for (const k of Object.keys(value).sort())
-            sorted[k] = sortDeep(value[k]);
-        return sorted;
-    }
-    return value;
-}
+// sortDeep is the canonical helper in domain/direct-core; re-exported here for
+// back-compat with existing importers of `usecases/script`.
+export { sortDeep };
 // ===========================================================================
 // 0.6.0 plural-noun query commands (replace `commandScriptInspect --target X`)
 // ===========================================================================
@@ -1071,9 +1072,20 @@ export async function commandSummary(opts) {
         `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 -------------------------------------------------------------
@@ -2177,4 +2189,160 @@ export async function commandAddSpeaker(opts) {
         speaker_id: opts["speaker_id"],
     });
 }
+// ----- create (blank scaffold) ----------------------------------------------
+// Create an empty schema-v2 script as the starting point for building a script
+// bottom-up with the atomic add/insert verbs (instead of direct/parse/write
+// assembly). Targets the same three destinations as the edit verbs:
+//   --script-path <file>  local JSON file
+//   --draft               the direct intermediate (script.initial.json)
+//   --project-group-no    DB-backed script-output (first write at revision 0)
+// Refuses to clobber an existing target (local: pass --force to overwrite; DB:
+// edit the existing script instead). Validates in incomplete-tolerant mode, so
+// the blank scaffold reports passed.
+export async function commandCreate(opts) {
+    const workspace = strOf(opts["workspace_path"] || "workspace");
+    const force = Boolean(opts["force"]);
+    const title = strOf(opts["title"]).trim();
+    const script = blankScript(title);
+    const draft = Boolean(opts["draft"]);
+    const scriptPathOpt = strOf(opts["script_path"]).trim();
+    if (draft && scriptPathOpt) {
+        throw new CliError("CREATE BLOCKED: --draft conflicts with --script-path", "--draft conflicts with --script-path.", {
+            exitCode: EXIT_USAGE,
+            required: ["either --draft or --script-path, not both"],
+            received: ["--draft and --script-path"],
+            nextSteps: ["Drop one of the two flags and retry."],
+            errorCode: "DRAFT_FLAG_CONFLICT",
+        });
+    }
+    if (draft && strOf(opts["project_group_no"]).trim()) {
+        throw new CliError("CREATE BLOCKED: --draft conflicts with --project-group-no", "--draft conflicts with --project-group-no.", {
+            exitCode: EXIT_USAGE,
+            required: ["either --draft (local draft) or --project-group-no (DB), not both"],
+            received: ["--draft and --project-group-no"],
+            nextSteps: ["Drop one of the two flags and retry."],
+            errorCode: "DRAFT_FLAG_CONFLICT",
+        });
+    }
+    const localPath = draft ? path.join(directDir(workspace), "script.initial.json") : (scriptPathOpt || null);
+    if (localPath) {
+        if (exists(localPath) && !force) {
+            throw new CliError("CREATE BLOCKED: target already exists", "A script already exists at the target.", {
+                exitCode: EXIT_INPUT,
+                required: ["a non-existent target, or --force to overwrite"],
+                received: [localPath],
+                nextSteps: ["Edit the existing script with the atomic verbs, or pass --force to overwrite with a blank scaffold."],
+                errorCode: "SCRIPT_EXISTS",
+            });
+        }
+        writeJson(localPath, script);
+        const session = new ScriptEditSession({ workspace, scriptPath: localPath, script });
+        const validation = validateSession(session);
+        const passed = Boolean(validation["passed"]);
+        return [blankCreateReport(session, validation, null), passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+    }
+    // DB mode: first write must be at revision 0. We never silently overwrite a
+    // populated DB script with a blank one — that would destroy work.
+    const client = scriptOutputClient(opts);
+    const baseRevision = await currentRevisionOrZero(client);
+    if (baseRevision > 0) {
+        throw new CliError("CREATE BLOCKED: DB script already exists", "A script already exists for this project.", {
+            exitCode: EXIT_INPUT,
+            required: ["an empty project (no published script)"],
+            received: [`revision=${baseRevision}`],
+            nextSteps: ["Edit the existing script with the atomic verbs instead of creating a blank one."],
+            errorCode: "SCRIPT_EXISTS",
+        });
+    }
+    const requestId = requestIdForScriptWrite(opts, "script.create", { script });
+    let res;
+    try {
+        res = await client.replaceScript({ requestId, baseRevision, script, source: "ctl" });
+    }
+    catch (exc) {
+        if (exc instanceof ScriptOutputApiError) {
+            throw apiErrorToCli("SCRIPT API BLOCKED: Create write failed", exc);
+        }
+        throw exc;
+    }
+    const revision = Number(res["revision"] ?? 0);
+    const session = new ScriptEditSession({ workspace, script, client, projectGroupNo: client.projectGroupNo, revision });
+    const validation = validateSession(session);
+    await syncValidationResult(session, validation, revision);
+    const passed = Boolean(validation["passed"]);
+    return [blankCreateReport(session, validation, Boolean(res["idempotent"])), passed ? EXIT_OK : EXIT_NEEDS_AGENT];
+}
+function blankCreateReport(session, validation, idempotent) {
+    const passed = Boolean(validation["passed"]);
+    const resultLines = ["created: blank script (schema v2)", `validation: ${passed ? "passed" : "needs repair"}`];
+    if (session.remote) {
+        resultLines.push(`revision: ${session.revision}`);
+        if (idempotent !== null)
+            resultLines.push(`idempotent: ${String(idempotent).toLowerCase()}`);
+    }
+    return {
+        title: passed ? "SCRIPT CREATED: Blank scaffold" : "SCRIPT CREATED: Validation needs repair",
+        op: "script.create",
+        changed: true,
+        summary: "已创建空白剧本（schema v2，待填充人物/地点/道具/分集）",
+        result: resultLines,
+        warnings: summarizeIssues(asList(validation["issues"])),
+        artifacts: [session.artifactLabel],
+        next: [
+            "用 worldview 设定世界观，用 add-actor / add-location / add-prop 注册资产，用 add-episode + insert 搭出分集与场景。",
+        ],
+    };
+}
+// ----- add-* (register new entities) ----------------------------------------
+// Read the single positional <name> arg shared by add-actor/location/prop, or
+// throw the common ARGS_MISSING usage error with a verb-specific example.
+function requireNameArg(opts, verb, example) {
+    const args = asList(opts["_args"]);
+    if (args.length < 1) {
+        throw new CliError(`VERB BLOCKED: ${verb} name missing`, "Name missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<name>"],
+            received: ["<empty>"],
+            nextSteps: [example],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return args[0];
+}
+export async function commandAddActor(opts) {
+    const name = requireNameArg(opts, "add-actor", "Example: scriptctl add-actor \"林夏\" --role 主角");
+    return applySingleScriptOp(opts, {
+        op: "actor.add",
+        name,
+        actor_id: opts["id"],
+        role_type: opts["role"],
+        description: opts["description"],
+        aliases: opts["alias"],
+    });
+}
+export async function commandAddLocation(opts) {
+    const name = requireNameArg(opts, "add-location", "Example: scriptctl add-location \"教室\"");
+    return applySingleScriptOp(opts, {
+        op: "location.add",
+        name,
+        location_id: opts["id"],
+        description: opts["description"],
+    });
+}
+export async function commandAddProp(opts) {
+    const name = requireNameArg(opts, "add-prop", "Example: scriptctl add-prop \"怀表\"");
+    return applySingleScriptOp(opts, {
+        op: "prop.add",
+        name,
+        prop_id: opts["id"],
+        description: opts["description"],
+    });
+}
+export async function commandAddEpisode(opts) {
+    return applySingleScriptOp(opts, {
+        op: "episode.add",
+        episode_id: opts["id"],
+        title: opts["title"],
+    });
+}
 //# sourceMappingURL=script.js.map