@lingjingai/scriptctl 0.62.3 → 0.62.5

package/dist/cli/register-authoring.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type RunState } from "./registry.js";
+/** Structured transactions for application compilers; prose editing uses read/write. */
+export declare function registerAuthoringCommands(program: Command, state: RunState): void;

package/dist/cli/register-authoring.js

@@ -0,0 +1,35 @@
+import { commandComposeCreativeDraft } from "../usecases/script/compose-creative-draft.js";
+import { commandExportAuthoring } from "../usecases/script/export-authoring.js";
+import { commandWriteAuthoring } from "../usecases/script/write-authoring.js";
+import { describeArguments, dispatch, withScriptOpts } from "./registry.js";
+/** Structured transactions for application compilers; prose editing uses read/write. */
+export function registerAuthoringCommands(program, state) {
+    const authoring = program.command("authoring")
+        .description("Structured screenplay compilation and atomic application transactions");
+    const write = withScriptOpts(authoring.command("write <file>"))
+        .description("Plan or apply a complete structured authoring document")
+        .option("--create", "Create the selected target")
+        .option("--replace", "Replace the selected target")
+        .option("--apply", "Apply the exact plan")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .action(dispatch(commandWriteAuthoring, state));
+    describeArguments(write, ["Structured .scriptctl file"]);
+    const compose = withScriptOpts(authoring.command("compose <file>"))
+        .description("Compile a readable scene JSON draft with generated identities and timing")
+        .option("--apply", "Apply the exact plan")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .action(dispatch(commandComposeCreativeDraft, state));
+    describeArguments(compose, ["Readable scene JSON file"]);
+    const exportCommand = authoring.command("export")
+        .description("Export complete structured content, including identities and extensions");
+    const kinds = ["script", "episodes", "episode-spans", "scenes", "scene-spans", "action-spans"];
+    for (const kind of kinds) {
+        const command = withScriptOpts(exportCommand.command(kind), "read")
+            .description(`Export structured ${kind}`)
+            .requiredOption("-o, --output <file>", "Destination .scriptctl file");
+        if (kind !== "script")
+            command.requiredOption("-i, --in <selector>", "Formal ID or @ep:N selector / inclusive range");
+        command.action(dispatch((opts) => commandExportAuthoring(kind, opts), state));
+    }
+}
+//# sourceMappingURL=register-authoring.js.map

package/dist/cli/register-authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-authoring.js","sourceRoot":"","sources":["../../src/cli/register-authoring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAA4B,MAAM,wCAAwC,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3F,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CAAC,OAAgB,EAAE,KAAe;IACzE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;SAC3C,WAAW,CAAC,uEAAuE,CAAC,CAAC;IACxF,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;SAC5D,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,UAAU,EAAE,4BAA4B,CAAC;SAChD,MAAM,CAAC,WAAW,EAAE,6BAA6B,CAAC;SAClD,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,iBAAiB,CAAC,KAAK,EAAE,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;SAChE,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,QAAQ,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC,CAAC;IACxD,iBAAiB,CAAC,OAAO,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;SAC9C,WAAW,CAAC,yEAAyE,CAAC,CAAC;IAC1F,MAAM,KAAK,GAA0B,CAAC,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IACtH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;aAChE,WAAW,CAAC,qBAAqB,IAAI,EAAE,CAAC;aACxC,cAAc,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;QACxE,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,+CAA+C,CAAC,CAAC;QACtH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/cli/register-batch.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import { type RunState } from "./registry.js";
+export declare function registerBatchCommands(program: Command, state: RunState): void;

package/dist/cli/register-batch.js

@@ -0,0 +1,28 @@
+import { commandDo } from "../usecases/script/do.js";
+import { commandScriptPatch } from "../usecases/script/script-patch.js";
+import { describeArguments, dispatch, withScriptOpts } from "./registry.js";
+export function registerBatchCommands(program, state) {
+    const doCommand = withScriptOpts(program.command("do [file]"))
+        .description("Run one CLI edit per line as one transaction")
+        .option("--apply", "Apply the planned transaction")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .option("-n, --dry-run", "Preview the transaction without writing")
+        .addHelpText("after", "\nExample:\n  scriptctl do edits.txt\n  scriptctl do edits.txt --apply --plan <digest>\n")
+        .action(dispatch(commandDo, state));
+    describeArguments(doCommand, ["Command file, or stdin when omitted"]);
+    const patch = withScriptOpts(program.command("patch [file]"))
+        .description("Apply structured JSON patch operations")
+        .option("--schema [op]", "Show every operation schema or one named operation")
+        .option("-n, --dry-run", "Preview patch operations without writing")
+        .option("--apply", "Apply the exact planned patch")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .addHelpText("after", "\nExample:\n  scriptctl patch --schema\n  scriptctl patch changes.json --dry-run\n")
+        .action(dispatch((opts) => {
+        const args = opts["_args"] || [];
+        if (args[0])
+            opts["patch"] = args[0];
+        return commandScriptPatch(opts);
+    }, state));
+    describeArguments(patch, ["Patch JSON file"]);
+}
+//# sourceMappingURL=register-batch.js.map

package/dist/cli/register-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-batch.js","sourceRoot":"","sources":["../../src/cli/register-batch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,KAAe;IACrE,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SAC3D,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,eAAe,EAAE,yCAAyC,CAAC;SAClE,WAAW,CAAC,OAAO,EAAE,0FAA0F,CAAC;SAChH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACtC,iBAAiB,CAAC,SAAS,EAAE,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;SAC1D,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,eAAe,EAAE,oDAAoD,CAAC;SAC7E,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,WAAW,CAAC,OAAO,EAAE,oFAAoF,CAAC;SAC1G,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,IAAI,GAAI,IAAI,CAAC,OAAO,CAAc,IAAI,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACb,iBAAiB,CAAC,KAAK,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/cli/register-edits.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type LlmComposition } from "../llm/composition.js";
+import { type RunState } from "./registry.js";
+export declare function registerEditCommands(program: Command, state: RunState, llm: LlmComposition): void;

package/dist/cli/register-edits.js

@@ -0,0 +1,234 @@
+import { commandAddActor } from "../usecases/script/add-actor.js";
+import { commandAddEpisode } from "../usecases/script/add-episode.js";
+import { commandAddLocation } from "../usecases/script/add-location.js";
+import { commandAddProp } from "../usecases/script/add-prop.js";
+import { commandActor } from "../usecases/script/actor.js";
+import { commandAlias } from "../usecases/script/alias.js";
+import { commandContext } from "../usecases/script/context.js";
+import { commandCreate } from "../usecases/script/create.js";
+import { commandDelete } from "../usecases/script/delete.js";
+import { commandDescribe } from "../usecases/script/describe.js";
+import { commandDialogue } from "../usecases/script/dialogue.js";
+import { commandEmotion } from "../usecases/script/emotion.js";
+import { commandExtend } from "../usecases/script/extend.js";
+import { commandImportance } from "../usecases/script/importance.js";
+import { commandInsert } from "../usecases/script/insert.js";
+import { commandMerge } from "../usecases/script/merge.js";
+import { commandMove } from "../usecases/script/move.js";
+import { commandParenthetical } from "../usecases/script/parenthetical.js";
+import { commandRename } from "../usecases/script/rename.js";
+import { commandReplace } from "../usecases/script/replace.js";
+import { commandRole } from "../usecases/script/role.js";
+import { commandSplit } from "../usecases/script/split.js";
+import { commandStateAdd } from "../usecases/script/state-add.js";
+import { commandStateDelete } from "../usecases/script/state-delete.js";
+import { commandStateRename } from "../usecases/script/state-rename.js";
+import { commandSynopsis } from "../usecases/script/synopsis.js";
+import { commandSynopsisGenerate } from "../usecases/script/synopsis-generate.js";
+import { commandTimestamp } from "../usecases/script/timestamp.js";
+import { commandTransition } from "../usecases/script/transition.js";
+import { commandType } from "../usecases/script/type.js";
+import { commandWorldview } from "../usecases/script/worldview.js";
+import { appendString, describeArguments, dispatch, withScriptOpts, withSelection, } from "./registry.js";
+export function registerEditCommands(program, state, llm) {
+    withScriptOpts(program.command("create"))
+        .description("Create an empty script")
+        .option("--title <title>", "Script title")
+        .option("--force", "Replace an existing script file")
+        .action(dispatch(commandCreate, state));
+    const addActor = withScriptOpts(program.command("add-actor <name>"))
+        .description("Add an actor")
+        .option("--id <id>", "Actor ID")
+        .option("--role <role>", "Actor role")
+        .option("--description <text>", "Actor description")
+        .option("--alias <alias>", "Actor alias; repeatable", appendString, [])
+        .action(dispatch(commandAddActor, state));
+    describeArguments(addActor, ["Actor name"]);
+    const addLocation = withScriptOpts(program.command("add-location <name>"))
+        .description("Add a location")
+        .option("--id <id>", "Location ID")
+        .option("--description <text>", "Location description")
+        .action(dispatch(commandAddLocation, state));
+    describeArguments(addLocation, ["Location name"]);
+    const addProp = withScriptOpts(program.command("add-prop <name>"))
+        .description("Add a prop")
+        .option("--id <id>", "Prop ID")
+        .option("--description <text>", "Prop description")
+        .action(dispatch(commandAddProp, state));
+    describeArguments(addProp, ["Prop name"]);
+    withScriptOpts(program.command("add-episode"))
+        .description("Append an episode")
+        .option("--id <id>", "Episode ID")
+        .option("--title <title>", "Episode title")
+        .action(dispatch(commandAddEpisode, state));
+    const replace = withSelection(withScriptOpts(program.command("replace [at]")))
+        .description("Replace action text at one address or across a selection")
+        .requiredOption("--from <text>", "Text or pattern to replace")
+        .option("--to <text>", "Replacement text", "")
+        .option("--all", "Replace every occurrence")
+        .option("--regex", "Treat --from as a regular expression")
+        .addHelpText("after", "\nExample:\n  scriptctl replace --in ep_001 -g \"old\" --from old --to new\n")
+        .action(dispatch(commandReplace, state));
+    describeArguments(replace, ["Single action address"]);
+    const type = withSelection(withScriptOpts(program.command("type [at] [type]")))
+        .description("Set action type at one address or across a selection")
+        .action(dispatch(commandType, state));
+    describeArguments(type, ["Single action address", "New action type"]);
+    const actor = withSelection(withScriptOpts(program.command("actor [at] [actor-id]")))
+        .description("Set an action actor at one address or across a selection")
+        .action(dispatch(commandActor, state));
+    describeArguments(actor, ["Single action address", "Actor ID"]);
+    const emotion = withSelection(withScriptOpts(program.command("emotion [at] [emotion]")))
+        .description("Set or clear action emotion")
+        .option("--clear", "Clear the emotion")
+        .action(dispatch(commandEmotion, state));
+    describeArguments(emotion, ["Single action address", "Emotion value"]);
+    const parenthetical = withSelection(withScriptOpts(program.command("parenthetical [at]")))
+        .description("Set or remove a dialogue parenthetical")
+        .option("--set <text>", "Parenthetical text")
+        .option("--remove", "Remove the parenthetical")
+        .action(dispatch(commandParenthetical, state));
+    describeArguments(parenthetical, ["Single action address"]);
+    const timestamp = withScriptOpts(program.command("timestamp <at>"))
+        .description("Set or remove an action timestamp")
+        .option("--set <time>", "Episode-local action start time")
+        .option("--remove", "Remove the timestamp")
+        .addHelpText("after", "\nExample:\n  scriptctl timestamp acR8cV4n --set 00:42.533\n")
+        .action(dispatch(commandTimestamp, state));
+    describeArguments(timestamp, ["V3 action address or V4 Action ID"]);
+    const insert = withScriptOpts(program.command("insert <addr>"))
+        .description("Insert an action into a scene or a scene into an episode")
+        .option("-t, --type <type>", "Action type")
+        .option("--content <text>", "Action content")
+        .option("--emotion <emotion>", "Dialogue emotion")
+        .option("--parenthetical <text>", "Dialogue parenthetical")
+        .option("--action-id <id>", "Action ID")
+        .option("--at <idx>", "Numeric insertion position")
+        .option("--before <addr>", "Insert before this sibling")
+        .option("--after <addr>", "Insert after this sibling")
+        .option("-a, --actor <id>", "Actor ID")
+        .option("--speaker-state <id>", "Actor state ID")
+        .option("-k, --kind <kind>", "Non-actor speaker kind")
+        .option("--label <text>", "Non-actor speaker label")
+        .option("--location <id>", "Scene location ID")
+        .option("--time <time>", "Scene time")
+        .option("--space <space>", "Scene space")
+        .option("--scene-id <id>", "Scene ID")
+        .option("--state <id>", "Asset state ID; repeatable", appendString, [])
+        .action(dispatch(commandInsert, state));
+    describeArguments(insert, ["Episode or scene address"]);
+    const deleteCommand = withScriptOpts(program.command("delete <addr>"))
+        .description("Delete an action, scene, asset, state, or speaker")
+        .option("--strategy <strategy>", "Reference handling strategy")
+        .option("--replacement <addr>", "Replacement address for references")
+        .option("--force", "Allow guarded destructive deletion")
+        .action(dispatch(commandDelete, state));
+    describeArguments(deleteCommand, ["Address to delete"]);
+    const move = withScriptOpts(program.command("move <addr> <to>"))
+        .description("Move an action across scenes or a scene across episodes")
+        .option("--at <idx>", "Numeric destination position")
+        .option("--before <id>", "Place before this sibling ID")
+        .option("--after <id>", "Place after this sibling ID")
+        .action(dispatch(commandMove, state));
+    describeArguments(move, ["Action or scene address", "Destination scene or episode address"]);
+    const split = withScriptOpts(program.command("split <ep/scn>"))
+        .description("Split a scene")
+        .requiredOption("--at <index-or-action-id>", "Split position")
+        .option("--new-scene-id <id>", "ID for the new scene")
+        .action(dispatch(commandSplit, state));
+    describeArguments(split, ["Scene address"]);
+    const merge = withScriptOpts(program.command("merge <src>"))
+        .description("Merge one asset or scene into another")
+        .requiredOption("--into <dst>", "Destination asset or scene address")
+        .action(dispatch(commandMerge, state));
+    describeArguments(merge, ["Source asset or scene address"]);
+    const transition = withSelection(withScriptOpts(program.command("transition [at] [target]")))
+        .description("Set or clear an action transition")
+        .option("--process <text>", "Transition process")
+        .option("--contrast <text>", "Transition contrast")
+        .option("--clear", "Clear the transition")
+        .action(dispatch(commandTransition, state));
+    describeArguments(transition, ["Single action address", "Transition target"]);
+    const sceneRef = withScriptOpts(program.command("scene-ref <at> <target>"))
+        .description("Set or remove an asset reference in a scene")
+        .option("--state <id>", "Target state ID; repeatable", appendString, [])
+        .option("--clear", "Clear the matching v3 reference state")
+        .option("--remove", "Remove the matching reference")
+        .option("--append", "Append instead of replacing")
+        .option("--occurrence <n>", "Target occurrence number")
+        .addHelpText("after", "\nExample:\n  scriptctl scene-ref ep_001/scn_001 actor:act_001 --state st_calm\n")
+        .action(dispatch(commandContext, state));
+    describeArguments(sceneRef, ["Scene address", "Referenced asset address"]);
+    const rename = withScriptOpts(program.command("rename <target> <name>"))
+        .description("Rename an asset or state")
+        .action(dispatch(commandRename, state));
+    describeArguments(rename, ["Asset or state address", "New name"]);
+    const describe = withScriptOpts(program.command("describe <target> <text>"))
+        .description("Set an asset or state description")
+        .action(dispatch(commandDescribe, state));
+    describeArguments(describe, ["Asset or state address", "Description"]);
+    const alias = withScriptOpts(program.command("alias <target>"))
+        .description("Add or remove asset aliases")
+        .option("--add <alias>", "Alias to add; repeatable", appendString, [])
+        .option("--remove <alias>", "Alias to remove; repeatable", appendString, [])
+        .action(dispatch(commandAlias, state));
+    describeArguments(alias, ["Asset address"]);
+    for (const [name, description, handler, second] of [
+        ["role", "Set an actor role", commandRole, "Role"],
+        ["importance", "Set asset importance", commandImportance, "Importance"],
+    ]) {
+        const command = withScriptOpts(program.command(`${name} <target> <value>`))
+            .description(description)
+            .action(dispatch(handler, state));
+        describeArguments(command, ["Asset address", second]);
+    }
+    const worldview = withScriptOpts(program.command("worldview <value>"))
+        .description("Set the script worldview")
+        .action(dispatch(commandWorldview, state));
+    describeArguments(worldview, ["Worldview value"]);
+    const synopsis = withScriptOpts(program.command("synopsis [target-or-text] [text]"))
+        .description("Set script or episode synopsis text")
+        .action(dispatch(commandSynopsis, state));
+    describeArguments(synopsis, ["Episode address or script synopsis", "Episode synopsis text"]);
+    withScriptOpts(synopsis.command("generate"))
+        .description("Generate synopsis fields with an LLM")
+        .option("--llm-config <path>", "LLM configuration file")
+        .option("--concurrency <n>", "Maximum concurrent model calls", "30")
+        .option("--checkpoint <dir>", "Checkpoint directory")
+        .option("--overwrite", "Regenerate existing synopsis fields")
+        .option("--apply", "Write generated fields")
+        .option("-n, --dry-run", "Generate a preview without writing")
+        .action(dispatch((options) => commandSynopsisGenerate(options, llm), state));
+    const extend = withScriptOpts(program.command("extend <addr> [key] [value]"))
+        .description("Read, set, or clear extension data")
+        .option("--json-value", "Parse the value as JSON")
+        .option("--clear", "Delete the key or extension container")
+        .action(dispatch(commandExtend, state));
+    describeArguments(extend, ["Target address", "Extension key", "Extension value"]);
+    const stateAdd = withScriptOpts(program.command("state-add <target> <name>"))
+        .description("Add an asset state")
+        .option("--description <text>", "State description", "")
+        .option("--state-id <id>", "State ID")
+        .action(dispatch(commandStateAdd, state));
+    describeArguments(stateAdd, ["Asset address", "State name"]);
+    const stateRename = withScriptOpts(program.command("state-rename <target> <name>"))
+        .description("Rename an asset state")
+        .action(dispatch(commandStateRename, state));
+    describeArguments(stateRename, ["State address", "New name"]);
+    const stateDelete = withScriptOpts(program.command("state-delete <target>"))
+        .description("Delete an asset state")
+        .requiredOption("--strategy <strategy>", "Reference handling strategy")
+        .option("--replacement <id>", "Replacement state ID")
+        .action(dispatch(commandStateDelete, state));
+    describeArguments(stateDelete, ["State address"]);
+    const dialogue = withScriptOpts(program.command("dialogue <at>"))
+        .description("Set the speaker for dialogue or inner thought")
+        .option("-a, --actor <id>", "Actor speaker ID")
+        .option("--state <id>", "Actor state ID")
+        .option("-k, --kind <kind>", "Non-actor speaker kind")
+        .option("--label <text>", "Non-actor speaker label")
+        .addHelpText("after", "\nExample:\n  scriptctl dialogue ep_001/scn_001#3 --actor act_001\n")
+        .action(dispatch(commandDialogue, state));
+    describeArguments(dialogue, ["Dialogue action address"]);
+}
+//# sourceMappingURL=register-edits.js.map

package/dist/cli/register-edits.js.map

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

package/dist/cli/register-query.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type LlmComposition } from "../llm/composition.js";
+import { type RunState } from "./registry.js";
+export declare function registerQueryCommands(program: Command, state: RunState, llm: LlmComposition): void;

package/dist/cli/register-query.js

@@ -0,0 +1,95 @@
+import { commandActions } from "../usecases/script/actions.js";
+import { commandActors } from "../usecases/script/actors.js";
+import { commandAssets } from "../usecases/script/assets.js";
+import { commandAuditAssets } from "../usecases/script/audit-assets.js";
+import { commandEpisodes } from "../usecases/script/episodes.js";
+import { commandIds } from "../usecases/script/ids.js";
+import { commandIssues } from "../usecases/script/issues.js";
+import { commandLocations } from "../usecases/script/locations.js";
+import { commandProps } from "../usecases/script/props.js";
+import { commandRefs } from "../usecases/script/refs.js";
+import { commandScenes } from "../usecases/script/scenes.js";
+import { commandScriptValidate } from "../usecases/script/script-validate.js";
+import { commandStates } from "../usecases/script/states.js";
+import { commandSummary } from "../usecases/script/summary.js";
+import { describeArguments, dispatch, withScriptOpts } from "./registry.js";
+export function registerQueryCommands(program, state, llm) {
+    withScriptOpts(program.command("summary"), "read")
+        .description("Show a compact script summary")
+        .action(dispatch(commandSummary, state));
+    withScriptOpts(program.command("episodes"), "read")
+        .description("List episodes")
+        .option("--id <id>", "Filter by episode ID")
+        .option("-i, --in <addr>", "Limit results to an address")
+        .option("--min-chars <n>", "Minimum episode character count")
+        .option("--max-chars <n>", "Maximum episode character count")
+        .action(dispatch(commandEpisodes, state));
+    withScriptOpts(program.command("scenes"), "read")
+        .description("List scenes")
+        .option("-i, --in <addr>", "Limit results to an address")
+        .option("--has-actor <id>", "Require an actor reference")
+        .option("--has-location <id>", "Require a location reference")
+        .option("--has-prop <id>", "Require a prop reference")
+        .action(dispatch(commandScenes, state));
+    withScriptOpts(program.command("actions"), "read")
+        .description("List actions")
+        .option("-i, --in <addr>", "Limit results to an address or range")
+        .option("-g, --grep <text>", "Match action text")
+        .option("-t, --type <type>", "Filter by action type")
+        .option("-a, --actor <id>", "Filter by actor ID")
+        .option("--has <kind>", "Require a populated action facet")
+        .option("--time <time-or-range>", "Match an episode-local timestamp or closed range")
+        .option("--context <n>", "Include surrounding actions")
+        .option("--span", "Collapse selected Actions to one episode-local timestamp span")
+        .addHelpText("after", "\nExamples:\n  scriptctl actions --in ep_001/scn_001 --grep \"door\"\n  scriptctl actions --in @ep:1 --time 00:30..00:45\n  scriptctl actions --in 'acStart..acEnd' --span\n")
+        .action(dispatch(commandActions, state));
+    for (const [name, description, handler] of [
+        ["actors", "List actors", commandActors],
+        ["locations", "List locations", commandLocations],
+        ["props", "List props", commandProps],
+    ]) {
+        withScriptOpts(program.command(name), "read")
+            .description(description)
+            .option("--id <id>", `Filter ${name} by ID`)
+            .option("--name <text>", `Filter ${name} by name`)
+            .option("-i, --in <addr>", "Limit results to an address")
+            .option("--counts", "Include reference counts")
+            .action(dispatch(handler, state));
+    }
+    withScriptOpts(program.command("assets"), "read")
+        .description("List actors, locations, and props")
+        .option("-k, --kind <kind>", "Filter by asset kind")
+        .option("--id <id>", "Filter by asset ID")
+        .option("--name <text>", "Filter by asset name")
+        .option("-i, --in <addr>", "Limit results to an address")
+        .option("--counts", "Include reference counts")
+        .action(dispatch(commandAssets, state));
+    const states = withScriptOpts(program.command("states <asset-addr>"), "read")
+        .description("List states for an asset")
+        .action(dispatch(commandStates, state));
+    describeArguments(states, ["Actor, location, or prop address"]);
+    withScriptOpts(program.command("issues"), "read")
+        .description("List validation issues")
+        .option("--severity <severity>", "Filter by severity")
+        .option("--code <code>", "Filter by issue code")
+        .action(dispatch(commandIssues, state));
+    const refs = withScriptOpts(program.command("refs <addr>"), "read")
+        .description("List references to an address")
+        .option("--level <level>", "Reference detail level")
+        .action(dispatch(commandRefs, state));
+    describeArguments(refs, ["Address to inspect"]);
+    withScriptOpts(program.command("validate"), "read")
+        .description("Validate the script")
+        .action(dispatch(commandScriptValidate, state));
+    withScriptOpts(program.command("audit-assets"), "read")
+        .description("Audit asset consistency with an LLM")
+        .option("--llm-config <path>", "LLM configuration file")
+        .option("-o, --output <path>", "Audit JSON output file")
+        .action(dispatch((options) => commandAuditAssets(options, llm), state));
+    withScriptOpts(program.command("ids"), "read")
+        .description("Generate unreserved candidate IDs")
+        .requiredOption("-k, --kind <kind>", "ID kind")
+        .requiredOption("--count <n>", "Number of IDs")
+        .action(dispatch(commandIds, state));
+}
+//# sourceMappingURL=register-query.js.map

package/dist/cli/register-query.js.map

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

package/dist/cli/register-review.js

@@ -10,6 +10,7 @@ export function registerReviewCommand(program, state) {
         .option("--episode-timeout-ms <ms>", "单集超时；到点收尾并保留已记录的结论", Number)
         .option("--max-steps <n>", "单集最多几步工具调用", Number)
         .option("--media-budget <n>", "单集最多几次视频核对", Number)
+        .option("--converge-only", "只执行全剧收敛，不重新审核各集")
         .option("--no-converge", "跳过全剧收敛阶段")
         .option("--model <profile>", "覆盖 LLM profile（默认 review-agent）")
         .option("--llm-config <path>", "LLM configuration file")

package/dist/cli/register-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-review.js","sourceRoot":"","sources":["../../src/cli/register-review.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,KAAe;IACrE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;SAC/C,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;SACrD,MAAM,CACL,gBAAgB,EAChB,8BAA8B,EAC9B,CAAC,KAAa,EAAE,QAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,EAC3D,EAAc,CACf;SACA,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;SAC/C,MAAM,CAAC,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC;SAC9C,MAAM,CAAC,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,YAAY,EAAE,MAAM,CAAC;SAC/C,MAAM,CAAC,oBAAoB,EAAE,YAAY,EAAE,MAAM,CAAC;SAClD,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC;SACnC,MAAM,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;SAC9D,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,uBAAuB,CAAC;SAC1C,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"register-review.js","sourceRoot":"","sources":["../../src/cli/register-review.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,KAAe;IACrE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;SAC/C,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;SACrD,MAAM,CACL,gBAAgB,EAChB,8BAA8B,EAC9B,CAAC,KAAa,EAAE,QAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,EAC3D,EAAc,CACf;SACA,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;SAC/C,MAAM,CAAC,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC;SAC9C,MAAM,CAAC,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,YAAY,EAAE,MAAM,CAAC;SAC/C,MAAM,CAAC,oBAAoB,EAAE,YAAY,EAAE,MAAM,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;SAC5C,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC;SACnC,MAAM,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;SAC9D,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,uBAAuB,CAAC;SAC1C,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cli/register-script.js

@@ -9,7 +9,7 @@
 // TSV parsing for every read.
 import * as fs from "node:fs";
 import * as sp from "@lingjingai/screenplay";
-import { CliError, EXIT_INPUT, EXIT_OK } from "../common.js";
+import { CliError, EXIT_INPUT, EXIT_NEEDS_AGENT, EXIT_OK } from "../common.js";
 import { scriptJsonPath } from "../common.js";
 import { dispatch, describeArguments, withScriptOpts } from "./registry.js";
 const ADDR = "地址：集 `3`、场 `3-2`、单条 `3-2-5`、正式 ID、资产名、或 `<资产>/<状态>`";
@@ -56,9 +56,10 @@ function list(value) {
     return [];
 }
 /** SDK errors carry a plain message; map them onto scriptctl's error model. */
-function text(run, op) {
+function text(run, op, data = () => ({})) {
     try {
-        return [{ text: run(), data: { op, changed: false } }, EXIT_OK];
+        const content = run();
+        return [{ text: content, data: { op, changed: false, text: content, ...data() } }, EXIT_OK];
     }
     catch (error) {
         if (error instanceof CliError)
@@ -76,11 +77,14 @@ export function registerScriptCommands(program, state) {
         .option("--outline", "只要场结构，不要正文")
         .option("--context <n>", "单条 action 前后各带几条（默认 3）")
         .option("--plain", "去掉锚点与时间戳（只读，不可回写）")
-        .action(dispatch((opts) => text(() => sp.read(doc(opts), arg(opts), {
-        ...(opts["outline"] ? { depth: "outline" } : {}),
-        ...(opts["plain"] ? { plain: true } : {}),
-        ...(num(opts, "context") !== undefined ? { context: num(opts, "context") } : {}),
-    }), "read"), state));
+        .action(dispatch((opts) => {
+        const document = doc(opts);
+        return text(() => sp.read(document, arg(opts), {
+            ...(opts["outline"] ? { depth: "outline" } : {}),
+            ...(opts["plain"] ? { plain: true } : {}),
+            ...(num(opts, "context") !== undefined ? { context: num(opts, "context") } : {}),
+        }), "read", () => arg(opts) ? {} : { document: document.raw });
+    }, state));
     describeArguments(read, [ADDR]);
     const scan = withScriptOpts(program.command("scan <episode>"), "read")
         .description("一次返回某集的完整上下文：场结构 + 全部正文 + 当前校验问题")
@@ -109,25 +113,38 @@ export function registerScriptCommands(program, state) {
         ...(opts["full"] ? { full: true } : {}),
     }), "find"), state));
     describeArguments(find, ["正则；只按 speaker/type 过滤时可省略"]);
-    const refs = withScriptOpts(program.command("refs <addr>"), "read")
-        .description("只读定位资产/造型的场景绑定、说话引用和正文提及，返回可 read 的地址及上下文")
-        .option("--offset <n>", "从第几条引用继续（从 0 开始）")
-        .option("--limit <n>", "本批引用数（默认 20）")
-        .option("--context <n>", "正文命中前后各几条 action（默认 3）")
-        .action(dispatch((opts) => {
-        const result = sp.references(doc(opts), arg(opts), {
-            offset: num(opts, "offset"), limit: num(opts, "limit"), context: num(opts, "context"),
-        });
-        return [{ text: sp.formatReferences(result), data: { op: "refs", changed: false, ...result } }, EXIT_OK];
-    }, state));
-    describeArguments(refs, ["人物/场景/道具 ID 或名称，或 <资产>/<造型>；正文提及不等于实际出场"]);
     const span = withScriptOpts(program.command("span <range>"), "read")
         .description("把一段 action 换算成集内视频时间窗口（半开区间）")
-        .action(dispatch((opts) => text(() => sp.span(doc(opts), arg(opts)), "span"), state));
+        .action(dispatch((opts) => {
+        const document = doc(opts);
+        return text(() => sp.span(document, arg(opts)), "span", () => ({ rows: [sp.spanResult(document, arg(opts))] }));
+    }, state));
     describeArguments(span, [`${ADDR}，或 \`起ID..止ID\``]);
     withScriptOpts(program.command("validate"), "read")
         .description("跑整本校验")
-        .action(dispatch((opts) => text(() => sp.validate(doc(opts)), "validate"), state));
+        .action(dispatch((opts) => {
+        const document = doc(opts);
+        const report = sp.validateDoc(document);
+        return [{
+                text: sp.validate(document),
+                data: {
+                    op: "script.validate", changed: false, passed: report.ok,
+                    script_path: document.path,
+                    stats: {
+                        actors: document.assets.filter((asset) => asset.kind === "actor").length,
+                        locations: document.assets.filter((asset) => asset.kind === "location").length,
+                        props: document.assets.filter((asset) => asset.kind === "prop").length,
+                        episodes: document.episodes.length,
+                        scenes: document.episodes.reduce((count, episode) => count + episode.scenes.length, 0),
+                        actions: sp.allActions(document).length,
+                    },
+                    issues: [
+                        ...report.errors.map((issue) => ({ ...issue, severity: "error" })),
+                        ...report.warnings.map((issue) => ({ ...issue, severity: "warning" })),
+                    ],
+                },
+            }, report.ok ? EXIT_OK : EXIT_NEEDS_AGENT];
+    }, state));
     withScriptOpts(program.command("issues"), "read")
         .description("列当前校验问题")
         .option("--severity <severity>", "error | warning")