@lingjingai/scriptctl 0.50.0 → 0.51.1

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/changes/0.51.1.md

@@ -0,0 +1,15 @@
+# 0.51.1
+
+## Added
+- None.
+
+## Changed
+- Video `scriptctl ingest` sends standard screenplay `parenthetical` hints for dialogue and inner thought directly to Script v4, covering observable delivery, emotion, reaction, and brief accompanying actions.
+- Video `scriptctl ingest` stores each actor once per scene with the complete set of visible durable states, producing one Script v4 actor reference with its full `state_ids` set. Existing video checkpoints must be rebuilt with `--force`.
+- The bundled `scriptctl` skill uses short options in commands and examples whenever the CLI provides one.
+
+## Fixed
+- None.
+
+## Breaking
+- None.

package/changes/unreleased.md

@@ -1,8 +1,7 @@
 # Unreleased
 
 ## 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.
+- None.
 
 ## Changed
 - None.

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;

package/dist/cli/register-workflows.js

@@ -0,0 +1,71 @@
+import { commandIngest } from "../usecases/ingest/command.js";
+import { commandIngestStatus } from "../usecases/ingest/status.js";
+import { commandView } from "../usecases/ingest/view-command.js";
+import { commandExportAuthoring } from "../usecases/script/export-authoring.js";
+import { commandCheckout, commandWorkingCopyPublish, commandWorkingCopyStatus, } from "../usecases/script/working-copy.js";
+import { commandWriteAuthoring } from "../usecases/script/write-authoring.js";
+import { describeArguments, dispatch, withScriptOpts, withWorkingCopyOpts, } from "./registry.js";
+export function registerWorkflowCommands(program, state, llm) {
+    const ingest = program.command("ingest")
+        .description("Convert source files into a Script v4 workspace")
+        .option("-s, --source-path <path>", "Source file or directory")
+        .option("-w, --workspace-path <path>", "Workspace directory", "workspace")
+        .option("--llm-config <path>", "LLM configuration file")
+        .option("--concurrency <n>", "Maximum concurrent model calls")
+        .option("--fps <n>", "Video sampling rate")
+        .option("--force", "Rebuild completed stages")
+        .addHelpText("after", "\nExample:\n  scriptctl ingest --source-path ./draft.md --workspace-path ./workspace\n")
+        .action(dispatch((options) => commandIngest(options, llm), state));
+    ingest.command("status")
+        .description("Show ingest workspace progress")
+        .option("-w, --workspace-path <path>", "Workspace directory")
+        .action(dispatch(commandIngestStatus, state));
+    program.command("view")
+        .description("Render or serve the workspace review page")
+        .option("-w, --workspace-path <path>", "Workspace directory", "workspace")
+        .option("--watch", "Serve and refresh the review page")
+        .option("--port <n>", "HTTP server port")
+        .action(dispatch(commandView, state));
+    withWorkingCopyOpts(program.command("checkout"))
+        .description("Download a remote script into a managed local copy")
+        .option("--discard-local", "Replace an existing dirty local copy")
+        .action(dispatch(commandCheckout, state));
+    withScriptOpts(program.command("status"), "read")
+        .description("Show local working-copy state")
+        .action(dispatch(commandWorkingCopyStatus, state));
+    withWorkingCopyOpts(program.command("publish"))
+        .description("Validate and publish the local working copy")
+        .action(dispatch(commandWorkingCopyPublish, state));
+    const write = withScriptOpts(program.command("write <file>"))
+        .description("Plan or apply an 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")
+        .addHelpText("after", "\nExample:\n  scriptctl write scene.scriptctl --replace\n  scriptctl write scene.scriptctl --replace --apply --plan <digest>\n")
+        .action(dispatch(commandWriteAuthoring, state));
+    describeArguments(write, ["Authoring source file"]);
+    const exportCommand = program.command("export")
+        .description("Export script content as an authoring document")
+        .action(() => exportCommand.outputHelp());
+    withScriptOpts(exportCommand.command("script"), "read")
+        .description("Export the complete script")
+        .requiredOption("-o, --output <file>", "Destination authoring file")
+        .action(dispatch((opts) => commandExportAuthoring("script", opts), state));
+    const descriptions = {
+        episodes: "Export selected episodes",
+        "episode-spans": "Export an inclusive episode span",
+        scenes: "Export selected scenes",
+        "scene-spans": "Export an inclusive scene span",
+        "action-spans": "Export an inclusive action span",
+    };
+    for (const kind of Object.keys(descriptions)) {
+        withScriptOpts(exportCommand.command(kind), "read")
+            .description(descriptions[kind])
+            .requiredOption("-i, --in <selector>", "Address or inclusive range to export")
+            .requiredOption("-o, --output <file>", "Destination authoring file")
+            .addHelpText("after", `\nExample:\n  scriptctl export ${kind} --in <selector> --output export.scriptctl\n`)
+            .action(dispatch((opts) => commandExportAuthoring(kind, opts), state));
+    }
+}
+//# sourceMappingURL=register-workflows.js.map

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

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import { type CommandOutput } from "../common.js";
+export type Handler = (opts: Record<string, unknown>) => Promise<[CommandOutput, number]> | [CommandOutput, number];
+export interface RunState {
+    jsonMode: boolean;
+    exitCode: number;
+    format?: string;
+}
+export declare function dispatch(handler: Handler, state: RunState): (...args: unknown[]) => Promise<void>;
+export declare function describeArguments(command: Command, descriptions: readonly string[]): Command;
+export declare function withScriptOpts(command: Command, access?: "read" | "write"): Command;
+export declare function withWorkingCopyOpts(command: Command): Command;
+export declare function withSelection(command: Command): Command;
+export declare const appendString: (value: string, previous: string[]) => string[];