@lingjingai/scriptctl 0.49.16 → 0.51.0

package/README.md

@@ -1,6 +1,6 @@
 # @lingjingai/scriptctl
 
-剧本阶段统一 CLI：把 txt/md/docx 或视频素材转为结构化 Script v3，在本地工作副本上查询、校验、完整块批量写作或原子精修，并通过 revision CAS 发布。
+剧本阶段统一 CLI：把 txt/md/docx 或视频素材转为结构化 Script v4，同时继续原样读写和发布线上 Script v3；在本地工作副本上查询、校验、完整块批量写作或原子精修，并通过 revision CAS 发布。
 
 ## 安装
 
@@ -28,9 +28,11 @@ scriptctl update                    # 更新全局安装的 scriptctl
 scriptctl changelog                 # 查看当前版本功能变更
 scriptctl ingest --source-path <file|dir>
 scriptctl checkout --script-path workspace/script.json
-scriptctl export episodes --in ep_002..ep_004 --output rewrite.scriptctl
+scriptctl actions --in '@ep:2/scn:1' --script-path workspace/script.json
+scriptctl export episodes --in epA3kP9x..epQ7mN2v --output rewrite.scriptctl
 scriptctl write rewrite.scriptctl --replace
 scriptctl write rewrite.scriptctl --replace --apply --plan sha256:...
+scriptctl audit-assets --script-path workspace/script.json  # 全剧资产一致性审计（不自动修改）
 scriptctl validate
 scriptctl publish
 ```
@@ -38,6 +40,10 @@ scriptctl publish
 详细子命令、参数与退出码以 `scriptctl <cmd> --help` 为准，agent 行为约定见
 [`agent-sandbox-runtime` 中的 SKILL.md](https://gitcode.lingjingai.cn/algorithm/anime-agent/agent-sandbox-runtime/-/blob/main/templates/1_script/.claude/skills/scriptctl/SKILL.md)。
 
+Script v4 的新节点使用类型前缀加 6 位 Bitcoin Base58 的 NanoID。查询可用
+1-based `@` 序号定位，修改使用查询返回的正式 ID。已有 Script v3 按显式
+`version: 3` 继续走原有查询、写入、authoring 和 publish 实现，不改写旧 ID。
+
 ## 退出码
 
 | 码 | 含义 |

package/changes/0.50.0.md

@@ -0,0 +1,63 @@
+# 0.50.0
+
+## Added
+- Script v4 adds typed NanoID identities (including `ac` for Actions), query-only 1-based ordinal anchors, ID/range selectors, version-dispatched validation, atomic edits, and canonical authoring round-trips.
+- `scriptctl parenthetical` sets, preserves an explicit empty value, or removes speaking-action performance hints in Script v4.
+
+## Changed
+- `scriptctl create` and text/video `ingest` now create Script v4; existing Script v3 files remain on the frozen v3 query, edit, validation, and publish path.
+- Script v4 scene references store one reference per asset with a complete, sorted `state_ids` set; repeated `--state` flags replace that set.
+- Script v4 selector edits, `do`, and JSON `patch` require the exact digest from their complete dry-run plan before applying.
+- `scriptctl ids` generates Nano ID-based typed candidates and supports Action IDs without requiring an existing script.
+- V4 authoring supports homogeneous multi-target create/replace batches, undirected inclusive spans, explicit Action IDs, complete scene state sets, and ordered non-overlapping replace plans.
+- V4 `do` and JSON `patch` creation ops require explicit candidate IDs so dry-run and apply bind the same new nodes.
+- V4 multi-target edit and authoring plans now report every step/target, exact typed targets, before/after counts, complete created/removed/retained identities, untouched identities or siblings, declarations, retained orphan assets, and validation; the digest binds the complete plan.
+- V3 domain, patch, validation, and authoring implementations now live in dedicated version directories behind explicit top-level dispatch, while existing import paths remain thin compatibility facades.
+- Ingest persists and prunes a source-to-v4 identity checkpoint so resumed runs retain live IDs without keeping deleted-ID tombstones.
+
+## Fixed
+- `publish` validates the script's declared v3 or v4 dialect instead of assuming v3.
+- Version-sensitive command entrypoints now parse V4 bare IDs only after reading the target script version, while V3 keeps its existing compound addresses and behavior.
+- Text and video ingest now report production warnings against the final Script v4 document, using `parenthetical` paths instead of intermediate V3 `emotion` paths.
+- V4 authoring span export rejects out-of-order or overlapping regions instead of producing a file that cannot be replaced unchanged.
+- V4 mutation plans derive typed targets from each operation's identity fields without treating content as IDs or omitting referenced scene assets and states.
+- Ingest production validation accepts omitted, empty, and non-empty V4 `parenthetical` values.
+- V4 `refs --level action` excludes scene-level asset references.
+- V3 asset queries accept query-only ordinal anchors in `--in`.
+- V4 authoring export rejects selections with no matching targets instead of writing an unreadable file.
+- V4 asset queries with `--in '*'` include registered assets that are not yet referenced by a scene.
+- V4 state deletion rejects the state being deleted as its own replacement, preventing dangling state references.
+- V4 Action and scene insertion reject incompatible speaking or location-state fields instead of silently discarding them.
+- V4 authoring treats property-order-only differences as no-op retries and reports retry declarations as existing.
+- V4 authoring span batches resolve every range against the pre-edit document, so moving an ID between covered targets cannot redirect a later replacement.
+- V4 authoring plans report each target's root and descendant identities, recursive before/after counts, and correct untouched siblings for creates.
+- V3-to-V4 ingest conversion preserves typed V3 transition targets.
+- V4 authoring span exports accept query-only ordinal anchors in every endpoint.
+- Script v4 validation rejects legacy singular scene-reference states and duplicate state names within one asset.
+- V4 `move --at` rejects numeric placement instead of silently appending; use `--before` or `--after`.
+- V3 episode and Action query rows expose their current ordinal columns in default output.
+- V4 scene merge preserves Action document order and rejects non-adjacent scenes that would reorder intervening narrative.
+- V4 asset merge rejects referenced owner-local state IDs whose definitions differ between source and survivor.
+- V3 `insert` rejects V4-only identity, state-set, and `parenthetical` flags instead of silently discarding them.
+- Video ingest streaming publishes only validated V4 snapshots and checkpoints their identity map before exposing new IDs.
+- Selector and single-point edits reject `--plan` outside V4 multi-target apply instead of silently ignoring it.
+- Script v3 `do` and JSON `patch` reject `--plan` instead of applying while silently ignoring the supplied digest.
+- Script v3 `move` rejects V4-only `--before` and `--after` placement flags instead of silently discarding them.
+- `scriptctl do` rejects version- or target-incompatible `scene-ref`, `move`, and `insert` flags instead of silently discarding them.
+- V4 `do` asset creation accepts the same `--id` flag as the corresponding atomic commands.
+- V4 JSON `patch` rejects unknown, missing, or incorrectly typed operation fields and conflicting `--apply --dry-run` modes instead of silently coercing input or writing during an explicit dry-run.
+- V4 JSON `patch` accepts one or multiple aliases consistently with atomic `alias` and `do` operations.
+- V4 state and asset deletion rejects `--replacement` unless `--strategy replace` is selected.
+- V4 asset merge preserves the removed asset's canonical name as an alias and ignores aliases equal to the survivor's canonical name.
+- Script v4 validation rejects blank asset and state names.
+- Resumed ingest keeps surviving Script v4 episode, scene, Action, and asset identities when earlier V3 nodes are merged or removed.
+- V4 regex replacement requires `--all` for multiple matches and reports invalid patterns consistently.
+- V4 speaking operations reject actor state IDs on non-actor speakers.
+- V3 episode, scene, and Action queries remain usable on structurally inspectable documents with unrelated validation errors.
+- V4 `actions --context` avoids quadratic scans on wide selections while preserving same-scene document-order expansion.
+- V4 state deletion leaves the script unchanged when any affected scene would lose its complete state set.
+- `actions --grep` applies global and sticky regular expressions independently to every Action.
+
+## Breaking
+- New scripts use short random typed IDs instead of numeric sequence IDs, and Script v4 writes accept stable IDs rather than ordinal or array-index addresses.
+- Script v4 replaces speaking-action `emotion` with `parenthetical`; non-speaking ingest emotions are discarded.

package/changes/0.51.0.md

@@ -0,0 +1,24 @@
+# 0.51.0
+
+## Added
+- `scriptctl audit-assets` performs a model-backed whole-script audit for duplicate actors, locations, props, equivalent visual states, and suspicious unused or singleton states without modifying the script.
+- Text and video `scriptctl ingest` write `asset-audit.json` and include confirmed audit findings as non-blocking validation warnings.
+
+## Changed
+- CLI help is generated from Commander command, argument, and option declarations. Commands now use standard `Usage`, `Commands`, `Arguments`, and `Options` sections.
+- Added short options for frequent safe flags: `-h`, `-v`, `-j`, `-p`, `-w`, `-s`, `-o`, `-i`, `-g`, `-t`, `-a`, `-k`, and `-n`.
+
+## Fixed
+- Asset, state, and reference queries expose structured address rows, so `--format addr` returns their matched addresses.
+- `-j` selects JSON error output when combined with another short option, without misreading option values, invalid clusters, or tokens after `--`.
+- Text errors include the relevant received inputs and expected shape when diagnostic data is available.
+- `scriptctl view --watch --json` emits its startup JSON while the server is running and keeps stdout as a single parseable document.
+- `scriptctl update` includes package-manager exit and stderr diagnostics in default error output.
+- `scriptctl ingest status --help` documents its workspace option, and ingest help identifies the generated Script version correctly.
+- Edit command help identifies the supported address kinds and provides a valid `scene-ref` example.
+- `scriptctl issues --json` preserves filtered validation issues as structured `issues`.
+
+## Breaking
+- Default text output is command-specific and concise; the shared `Required`, `Received`, `Result`, `Artifacts`, `Issues`, and `Next` report sections are removed.
+- Text errors are written to stderr. JSON errors remain on stdout with `ok`, `exit_code`, `error_code`, `message`, optional `hint`, and typed diagnostic fields.
+- JSON output no longer includes the presentation fields `title`, `result`, `artifacts`, `required`, `received`, or `next`. Commands expose structured business data directly; table queries use `rows` and `row_columns`, and dump commands use `content`.

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,226 @@
+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 { 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 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,93 @@
+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("--context <n>", "Include surrounding actions")
+        .addHelpText("after", "\nExample:\n  scriptctl actions --in ep_001/scn_001 --grep \"door\"\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-tools.d.ts

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

package/dist/cli/register-tools.js

@@ -0,0 +1,23 @@
+import { commandChangelog } from "../usecases/changelog.js";
+import { commandDoctor } from "../usecases/doctor.js";
+import { commandUpdate } from "../usecases/update.js";
+import { describeArguments, dispatch } from "./registry.js";
+export function registerToolCommands(program, state) {
+    program.command("doctor")
+        .description("Check configuration and runtime dependencies")
+        .option("--llm-config <path>", "LLM configuration file")
+        .action(dispatch(commandDoctor, state));
+    program.command("update")
+        .description("Update scriptctl to the latest release")
+        .option("-n, --dry-run", "Show the update without installing")
+        .option("--patch", "Allow a patch-level update")
+        .action(dispatch(commandUpdate, state));
+    const changelog = program.command("changelog [version]")
+        .description("Show release notes")
+        .option("--from <version>", "Start version")
+        .option("--to <version>", "End version")
+        .option("--unreleased", "Show unreleased changes")
+        .action(dispatch(commandChangelog, state));
+    describeArguments(changelog, ["Release version"]);
+}
+//# sourceMappingURL=register-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.js","sourceRoot":"","sources":["../../src/cli/register-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAE3E,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,KAAe;IACpE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;SACtB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;SACvD,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;SACtB,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,eAAe,EAAE,oCAAoC,CAAC;SAC7D,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC;SAC/C,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;SACrD,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC;SAC3C,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC;SACvC,MAAM,CAAC,cAAc,EAAE,yBAAyB,CAAC;SACjD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,iBAAiB,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/cli/register-workflows.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 registerWorkflowCommands(program: Command, state: RunState, llm: LlmComposition): void;