@lingjingai/scriptctl 0.19.2 → 0.21.0

package/dist/domain/script/patch/registry.d.ts

@@ -0,0 +1,2 @@
+import type { OpHandler } from "./types.js";
+export declare const OP_REGISTRY: Record<string, OpHandler>;

package/dist/domain/script/patch/registry.js

@@ -0,0 +1,50 @@
+import { op_action_state_change, op_action_state_remove, op_action_transition_set, op_action_transition_clear, op_action_content_replace, op_action_content_regex_replace, op_action_type_set, op_action_actor_set, op_action_delete, op_action_insert, op_action_move } from "./ops-action.js";
+import { op_actor_add, op_location_add, op_prop_add, op_asset_role_set, op_asset_rename, op_asset_describe, op_asset_alias_set, op_asset_alias_add, op_asset_alias_remove, op_asset_states_set, op_asset_merge, op_asset_delete } from "./ops-asset.js";
+import { op_speaker_add, op_dialogue_speakers, op_dialogue_overlap, op_speaker_delete } from "./ops-dialogue.js";
+import { op_episode_add, op_meta_worldview_set } from "./ops-meta.js";
+import { op_scene_insert, op_scene_split, op_scene_merge, op_scene_delete, op_scene_move } from "./ops-scene.js";
+import { op_state_add, op_state_rename, op_state_describe, op_state_delete, op_context_set, op_context_clear, op_context_ref_remove } from "./ops-state.js";
+export const OP_REGISTRY = {
+    "state.add": op_state_add,
+    "state.rename": op_state_rename,
+    "state.describe": op_state_describe,
+    "state.delete": op_state_delete,
+    "context.set": op_context_set,
+    "context.clear": op_context_clear,
+    "action.state.change": op_action_state_change,
+    "action.state.remove": op_action_state_remove,
+    "action.transition.set": op_action_transition_set,
+    "action.transition.clear": op_action_transition_clear,
+    "action.content.replace": op_action_content_replace,
+    "action.content.regex-replace": op_action_content_regex_replace,
+    "speaker.add": op_speaker_add,
+    "dialogue.speakers": op_dialogue_speakers,
+    "dialogue.overlap": op_dialogue_overlap,
+    "actor.add": op_actor_add,
+    "location.add": op_location_add,
+    "prop.add": op_prop_add,
+    "episode.add": op_episode_add,
+    "meta.worldview.set": op_meta_worldview_set,
+    "asset.role.set": op_asset_role_set,
+    "asset.rename": op_asset_rename,
+    "asset.describe": op_asset_describe,
+    "asset.alias.set": op_asset_alias_set,
+    "asset.alias.add": op_asset_alias_add,
+    "asset.alias.remove": op_asset_alias_remove,
+    "asset.states.set": op_asset_states_set,
+    "asset.merge": op_asset_merge,
+    "asset.delete": op_asset_delete,
+    "action.type.set": op_action_type_set,
+    "action.actor.set": op_action_actor_set,
+    "action.delete": op_action_delete,
+    "action.insert": op_action_insert,
+    "action.move": op_action_move,
+    "scene.insert": op_scene_insert,
+    "scene.split": op_scene_split,
+    "scene.merge": op_scene_merge,
+    "scene.delete": op_scene_delete,
+    "scene.move": op_scene_move,
+    "speaker.delete": op_speaker_delete,
+    "context.ref.remove": op_context_ref_remove,
+};
+//# sourceMappingURL=registry.js.map

package/dist/domain/script/patch/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/domain/script/patch/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAC,sBAAsB,EAAC,wBAAwB,EAAC,0BAA0B,EAAC,yBAAyB,EAAC,+BAA+B,EAAC,kBAAkB,EAAC,mBAAmB,EAAC,gBAAgB,EAAC,gBAAgB,EAAC,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtR,OAAO,EAAE,YAAY,EAAC,eAAe,EAAC,WAAW,EAAC,iBAAiB,EAAC,eAAe,EAAC,iBAAiB,EAAC,kBAAkB,EAAC,kBAAkB,EAAC,qBAAqB,EAAC,mBAAmB,EAAC,cAAc,EAAC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7O,OAAO,EAAE,cAAc,EAAC,oBAAoB,EAAC,mBAAmB,EAAC,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAC,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,eAAe,EAAC,cAAc,EAAC,cAAc,EAAC,eAAe,EAAC,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAC,eAAe,EAAC,iBAAiB,EAAC,eAAe,EAAC,cAAc,EAAC,gBAAgB,EAAC,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEtJ,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,eAAe,EAAE,gBAAgB;IACjC,qBAAqB,EAAE,sBAAsB;IAC7C,qBAAqB,EAAE,sBAAsB;IAC7C,uBAAuB,EAAE,wBAAwB;IACjD,yBAAyB,EAAE,0BAA0B;IACrD,wBAAwB,EAAE,yBAAyB;IACnD,8BAA8B,EAAE,+BAA+B;IAC/D,aAAa,EAAE,cAAc;IAC7B,mBAAmB,EAAE,oBAAoB;IACzC,kBAAkB,EAAE,mBAAmB;IACvC,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,cAAc;IAC7B,oBAAoB,EAAE,qBAAqB;IAC3C,gBAAgB,EAAE,iBAAiB;IACnC,cAAc,EAAE,eAAe;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,iBAAiB,EAAE,kBAAkB;IACrC,iBAAiB,EAAE,kBAAkB;IACrC,oBAAoB,EAAE,qBAAqB;IAC3C,kBAAkB,EAAE,mBAAmB;IACvC,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,iBAAiB,EAAE,kBAAkB;IACrC,kBAAkB,EAAE,mBAAmB;IACvC,eAAe,EAAE,gBAAgB;IACjC,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,eAAe;IAC/B,YAAY,EAAE,aAAa;IAC3B,gBAAgB,EAAE,iBAAiB;IACnC,oBAAoB,EAAE,qBAAqB;CAC5C,CAAC"}

package/dist/domain/script/patch/types.d.ts

@@ -0,0 +1,10 @@
+import type { Dict } from "../shared.js";
+export interface OpCtx {
+    script: Dict;
+    op: Dict;
+    sourceText: string;
+    applied: string[];
+    kind: string;
+    runOps: (operations: Dict[]) => string[];
+}
+export type OpHandler = (ctx: OpCtx) => void;

package/dist/domain/script/patch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/script/patch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/domain/script/patch/types.ts"],"names":[],"mappings":""}

package/dist/domain/script/refs.d.ts

@@ -0,0 +1,4 @@
+import { type Dict } from "./shared.js";
+export declare function stateRefSummary(kind: string, targetId: string, stateId: string, location: string, role: string): Dict;
+export declare function collectStateRefs(script: Dict, kind: string, targetId: string, stateId: string): Dict[];
+export declare function collectAssetRefs(script: Dict, kind: string, targetId: string): Dict[];

package/dist/domain/script/refs.js

@@ -0,0 +1,152 @@
+import { asList, isDict, strOf } from "./shared.js";
+import { sceneContext } from "../direct-core.js";
+import { idKeyForKind, pluralForKind } from "./lookups.js";
+import { contextRefsForKind } from "./patch/helpers.js";
+export function stateRefSummary(kind, targetId, stateId, location, role) {
+    return { target: `${kind}:${targetId}/${stateId}`, location, role };
+}
+export function collectStateRefs(script, kind, targetId, stateId) {
+    const refs = [];
+    const idKey = idKeyForKind(kind);
+    for (const ep of asList(script["episodes"])) {
+        const epId = strOf(ep["episode_id"]);
+        for (const scene of asList(ep["scenes"])) {
+            const sceneId = strOf(scene["scene_id"]);
+            const ctx = sceneContext(scene);
+            const refsList = contextRefsForKind(ctx, kind);
+            for (let idx = 0; idx < refsList.length; idx++) {
+                const ref = refsList[idx];
+                if (strOf(ref[idKey]) === targetId && strOf(ref["state_id"]) === stateId) {
+                    refs.push(stateRefSummary(kind, targetId, stateId, `${epId}/${sceneId}.context.${pluralForKind(kind)}[${idx}]`, "scene_initial_state"));
+                }
+            }
+            const actions = asList(scene["actions"]);
+            for (let actionIdx = 0; actionIdx < actions.length; actionIdx++) {
+                const changes = asList(actions[actionIdx]["state_changes"]);
+                for (let changeIdx = 0; changeIdx < changes.length; changeIdx++) {
+                    const change = changes[changeIdx];
+                    if (strOf(change["target_kind"]) !== kind || strOf(change["target_id"]) !== targetId)
+                        continue;
+                    if (strOf(change["from_state_id"]) === stateId) {
+                        refs.push(stateRefSummary(kind, targetId, stateId, `${epId}/${sceneId}#${actionIdx}.state_changes[${changeIdx}].from_state_id`, "state_change_from"));
+                    }
+                    if (strOf(change["to_state_id"]) === stateId) {
+                        refs.push(stateRefSummary(kind, targetId, stateId, `${epId}/${sceneId}#${actionIdx}.state_changes[${changeIdx}].to_state_id`, "state_change_to"));
+                    }
+                }
+            }
+        }
+    }
+    return refs;
+}
+// ---------------------------------------------------------------------------
+// Universal address parsing + asset reverse lookup (0.6.0 namespace flatten)
+// ---------------------------------------------------------------------------
+// A union over every address format the flat top-level commands accept. The
+// dispatcher (CLI / usecase) picks behavior based on `kind`. Speaker addresses
+// use a bare `spk_XXX` form (no prefix) for terseness, mirroring how the rest
+export function collectAssetRefs(script, kind, targetId) {
+    const refs = [];
+    const isSpeaker = kind === "speaker";
+    const target = isSpeaker ? `speaker:${targetId}` : `${kind}:${targetId}`;
+    const idKey = isSpeaker ? null : idKeyForKind(kind);
+    for (const ep of asList(script["episodes"])) {
+        const epId = strOf(ep["episode_id"]);
+        for (const scene of asList(ep["scenes"])) {
+            const sceneId = strOf(scene["scene_id"]);
+            if (!isSpeaker) {
+                const ctx = sceneContext(scene);
+                const refsList = contextRefsForKind(ctx, kind);
+                for (let i = 0; i < refsList.length; i++) {
+                    if (strOf(refsList[i][idKey]) === targetId) {
+                        refs.push({
+                            target,
+                            location: `${epId}/${sceneId}.context.${pluralForKind(kind)}[${i}]`,
+                            role: `scene_${pluralForKind(kind)}`,
+                        });
+                    }
+                }
+            }
+            const actions = asList(scene["actions"]);
+            for (let actionIdx = 0; actionIdx < actions.length; actionIdx++) {
+                const action = actions[actionIdx];
+                if (kind === "actor" && strOf(action["actor_id"]) === targetId) {
+                    refs.push({
+                        target,
+                        location: `${epId}/${sceneId}#${actionIdx}.actor_id`,
+                        role: "action_actor",
+                    });
+                }
+                if (isSpeaker) {
+                    if (strOf(action["speaker_id"]) === targetId) {
+                        refs.push({
+                            target,
+                            location: `${epId}/${sceneId}#${actionIdx}.speaker_id`,
+                            role: "action_speaker",
+                        });
+                    }
+                    const speakers = asList(action["speakers"]);
+                    for (let i = 0; i < speakers.length; i++) {
+                        if (strOf(speakers[i]["speaker_id"]) === targetId) {
+                            refs.push({
+                                target,
+                                location: `${epId}/${sceneId}#${actionIdx}.speakers[${i}]`,
+                                role: "dialogue_speaker",
+                            });
+                        }
+                    }
+                    const lines = asList(action["lines"]);
+                    for (let i = 0; i < lines.length; i++) {
+                        if (strOf(lines[i]["speaker_id"]) === targetId) {
+                            refs.push({
+                                target,
+                                location: `${epId}/${sceneId}#${actionIdx}.lines[${i}].speaker_id`,
+                                role: "overlap_line_speaker",
+                            });
+                        }
+                    }
+                }
+                if (!isSpeaker) {
+                    const changes = asList(action["state_changes"]);
+                    for (let i = 0; i < changes.length; i++) {
+                        const change = changes[i];
+                        if (strOf(change["target_kind"]) === kind && strOf(change["target_id"]) === targetId) {
+                            refs.push({
+                                target,
+                                location: `${epId}/${sceneId}#${actionIdx}.state_changes[${i}]`,
+                                role: "state_change_target",
+                            });
+                        }
+                    }
+                    const transition = action["transition_prompt"];
+                    if (isDict(transition) && strOf(transition["target_kind"]) === kind && strOf(transition["target_id"]) === targetId) {
+                        refs.push({
+                            target,
+                            location: `${epId}/${sceneId}#${actionIdx}.transition_prompt`,
+                            role: "transition_target",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Speaker registrations pointing at this asset (actor/location/prop only).
+    // A speaker.source_id ties an actor/location/prop to a speaker entity; the
+    // speaker entry itself counts as a reference, so deleting / merging the
+    // asset must surface it.
+    if (!isSpeaker) {
+        const speakers = asList(script["speakers"]);
+        for (let i = 0; i < speakers.length; i++) {
+            const s = speakers[i];
+            if (strOf(s["source_kind"]) === kind && strOf(s["source_id"]) === targetId) {
+                refs.push({
+                    target,
+                    location: `speakers[${i}]`,
+                    role: "speaker_source",
+                });
+            }
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=refs.js.map

package/dist/domain/script/refs.js.map

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

package/dist/domain/script/schema.d.ts

@@ -0,0 +1,6 @@
+export interface PatchOpFieldSchema {
+    required: string[];
+    optional: string[];
+    description: string;
+}
+export declare const PATCH_OP_SCHEMA: Record<string, PatchOpFieldSchema>;

package/dist/domain/script/schema.js

@@ -0,0 +1,53 @@
+// Schema for every supported patch op. Used by `scriptctl patch --schema` to
+// dump field definitions agents can introspect without reading source.
+export const PATCH_OP_SCHEMA = {
+    // meta
+    "meta.worldview.set": { required: ["worldview"], optional: ["worldview_raw"], description: "Set the script.worldview enum." },
+    // state
+    "state.add": { required: ["target", "name"], optional: ["description", "state_id"], description: "Add a state to an asset's states[]." },
+    "state.rename": { required: ["target", "name"], optional: [], description: "Rename an asset state." },
+    "state.describe": { required: ["target", "description"], optional: [], description: "Set a state's description." },
+    "state.delete": { required: ["target", "strategy"], optional: ["replacement"], description: "Delete a state. strategy: replace|remove." },
+    // asset
+    "actor.add": { required: ["name"], optional: ["actor_id", "role_type", "description", "aliases"], description: "Register a new actor (human/character). role_type: 主角|配角." },
+    "location.add": { required: ["name"], optional: ["location_id", "description"], description: "Register a new location." },
+    "prop.add": { required: ["name"], optional: ["prop_id", "description"], description: "Register a new prop." },
+    "episode.add": { required: [], optional: ["episode_id", "title"], description: "Append a new empty episode (no scenes)." },
+    "asset.rename": { required: ["target", "name"], optional: [], description: "Rename an asset (actor / location / prop)." },
+    "asset.describe": { required: ["target", "description"], optional: [], description: "Set asset description." },
+    "asset.alias.set": { required: ["target", "aliases"], optional: [], description: "Bulk replace aliases[]." },
+    "asset.alias.add": { required: ["target", "alias"], optional: [], description: "Append alias(es)." },
+    "asset.alias.remove": { required: ["target", "alias"], optional: [], description: "Remove alias(es)." },
+    "asset.states.set": { required: ["target", "states"], optional: ["asset_type"], description: "Bulk replace states[]." },
+    "asset.role.set": { required: ["target", "role_type"], optional: [], description: "Set actor role_type (主角|配角)." },
+    "asset.merge": { required: ["from", "into"], optional: [], description: "Merge from asset into another; from disappears." },
+    "asset.delete": { required: ["target"], optional: ["strategy", "replacement"], description: "Delete an asset. strategy: replace|remove (required if refs exist)." },
+    // action
+    "action.type.set": { required: ["at", "type"], optional: [], description: "Set action.type (dialogue|action|inner_thought)." },
+    "action.actor.set": { required: ["at"], optional: ["actor_id"], description: "Set/clear action.actor_id." },
+    "action.content.replace": { required: ["at", "from"], optional: ["to", "all"], description: "Literal substring replace in action.content." },
+    "action.content.regex-replace": { required: ["at", "pattern"], optional: ["to", "all"], description: "Regex (/re/flags) replace in action.content. ReDoS-guarded; refuses overlap dialogue." },
+    "action.state.change": { required: ["at", "target", "to"], optional: ["from", "effective"], description: "Add/update a state_change on an action." },
+    "action.state.remove": { required: ["at", "target"], optional: [], description: "Remove a state_change from an action." },
+    "action.transition.set": { required: ["at", "target", "process", "contrast"], optional: [], description: "Set transition_prompt." },
+    "action.transition.clear": { required: ["at", "target"], optional: [], description: "Clear transition_prompt." },
+    "action.delete": { required: ["at"], optional: [], description: "Remove an action; later indices shift." },
+    "action.insert": { required: ["at", "type"], optional: ["content", "at_index", "before", "after", "actor_id", "speaker_id"], description: "Insert an action into a scene." },
+    "action.move": { required: ["at", "to"], optional: [], description: "Move an action (within or across scenes)." },
+    // scene
+    "scene.split": { required: ["at", "at_index"], optional: ["new_scene_id"], description: "Split a scene at an action boundary." },
+    "scene.merge": { required: ["from", "into"], optional: [], description: "Merge two scenes within the same episode." },
+    "scene.delete": { required: ["at"], optional: ["force"], description: "Delete a scene; empty by default, force=true for non-empty." },
+    "scene.move": { required: ["at", "to"], optional: ["at_index"], description: "Move a scene to another episode." },
+    "scene.insert": { required: ["at", "location"], optional: ["time", "space", "at_index", "before", "after", "scene_id"], description: "Insert a new empty scene." },
+    // context
+    "context.set": { required: ["at", "target"], optional: ["state", "state_id"], description: "Upsert (actor/prop) or replace (location) scene context ref + state." },
+    "context.clear": { required: ["at", "target"], optional: [], description: "Keep ref, clear state_id." },
+    "context.ref.remove": { required: ["at", "target"], optional: [], description: "Remove the ref entirely from scene context." },
+    // dialogue / speaker
+    "dialogue.speakers": { required: ["at", "speakers"], optional: ["delivery"], description: "Set dialogue speakers; delivery: single|simultaneous|group." },
+    "dialogue.overlap": { required: ["at", "lines"], optional: [], description: "Set overlap dialogue lines[]." },
+    "speaker.add": { required: ["kind", "name"], optional: ["source_id", "voice_desc", "speaker_id"], description: "Register a new speaker." },
+    "speaker.delete": { required: ["target"], optional: ["strategy", "replacement"], description: "Delete a speaker. strategy: replace|remove (required if refs exist)." },
+};
+//# sourceMappingURL=schema.js.map

package/dist/domain/script/schema.js.map

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

package/dist/domain/script/selector.d.ts

@@ -0,0 +1,45 @@
+import { CliError } from "../../common.js";
+import { type Dict } from "./shared.js";
+export declare const MAX_GREP_PATTERN_LEN = 256;
+export declare function isDangerousRegex(pattern: string): boolean;
+export type ActionCoord = {
+    scn: number;
+    idx: number;
+};
+export type SelectorRegion = {
+    level: "episode";
+    lo: number;
+    hi: number;
+} | {
+    level: "scene";
+    lo: number;
+    hi: number;
+} | {
+    level: "action";
+    lo: ActionCoord;
+    hi: ActionCoord;
+};
+export interface InSelector {
+    readonly isEmpty: boolean;
+    matchesScene(epId: string, sceneId: string): boolean;
+    matchesAction(epId: string, sceneId: string, idx: number): boolean;
+}
+export declare function cmpAction(a: ActionCoord, b: ActionCoord): number;
+export declare function regionMatchesScene(r: SelectorRegion, ep: number, scn: number): boolean;
+export declare function regionMatchesAction(r: SelectorRegion, ep: number, scn: number, idx: number): boolean;
+export declare class RegionSelector implements InSelector {
+    readonly regions: SelectorRegion[];
+    constructor(regions: SelectorRegion[]);
+    get isEmpty(): boolean;
+    matchesScene(epId: string, sceneId: string): boolean;
+    matchesAction(epId: string, sceneId: string, idx: number): boolean;
+}
+export declare function inSelectorError(detail: string, received: string): CliError;
+export declare function parseRegion(region: string, full: string): SelectorRegion;
+export declare const WHOLE_SCRIPT: InSelector;
+export declare function parseInSelector(raw: unknown): InSelector;
+export declare function selectorSingleActionPoint(sel: InSelector): {
+    scn: number;
+    idx: number;
+} | null;
+export declare function expandSelectorToActionRefs(script: Dict, selector: InSelector): string[];

package/dist/domain/script/selector.js

@@ -0,0 +1,187 @@
+import { CliError, EXIT_USAGE, } from "../../common.js";
+import { asList, idNum, strOf } from "./shared.js";
+import { parseAnyAddress } from "./address.js";
+export const MAX_GREP_PATTERN_LEN = 256;
+export function isDangerousRegex(pattern) {
+    if (pattern.length > MAX_GREP_PATTERN_LEN)
+        return true;
+    return /\([^)]*[*+?{][^)]*\)[*+?{]/.test(pattern);
+}
+export function cmpAction(a, b) {
+    return a.scn - b.scn || a.idx - b.idx;
+}
+export function regionMatchesScene(r, ep, scn) {
+    switch (r.level) {
+        case "episode": return ep >= r.lo && ep <= r.hi;
+        case "scene": return scn >= r.lo && scn <= r.hi;
+        case "action": return scn >= r.lo.scn && scn <= r.hi.scn;
+    }
+}
+export function regionMatchesAction(r, ep, scn, idx) {
+    switch (r.level) {
+        case "episode": return ep >= r.lo && ep <= r.hi;
+        case "scene": return scn >= r.lo && scn <= r.hi;
+        case "action": {
+            const p = { scn, idx };
+            // Lexicographic (scn, idx) containment covers same-scene, cross-scene
+            // start/internal/end in one comparison.
+            return cmpAction(r.lo, p) <= 0 && cmpAction(p, r.hi) <= 0;
+        }
+    }
+}
+export class RegionSelector {
+    regions;
+    constructor(regions) {
+        this.regions = regions;
+    }
+    get isEmpty() {
+        return this.regions.length === 0;
+    }
+    matchesScene(epId, sceneId) {
+        if (this.regions.length === 0)
+            return true;
+        const ep = idNum(epId, "ep");
+        const scn = idNum(sceneId, "scn");
+        return this.regions.some((r) => regionMatchesScene(r, ep, scn));
+    }
+    matchesAction(epId, sceneId, idx) {
+        if (this.regions.length === 0)
+            return true;
+        const ep = idNum(epId, "ep");
+        const scn = idNum(sceneId, "scn");
+        return this.regions.some((r) => regionMatchesAction(r, ep, scn, idx));
+    }
+}
+export function inSelectorError(detail, received) {
+    return new CliError("QUERY BLOCKED: --in address invalid", "--in address invalid.", {
+        exitCode: EXIT_USAGE,
+        required: ["--in: ep_NNN | ep_NNN/scn_NNN | ep_NNN/scn_NNN#idx; ranges via '..'; multiple regions comma-separated"],
+        received: [`${received} (${detail})`],
+        nextSteps: ["Example: ep_003..ep_007,ep_010/scn_001..ep_010/scn_004"],
+        errorCode: "IN_ADDRESS_INVALID",
+    });
+}
+export function parseRegion(region, full) {
+    const parts = region.split("..");
+    if (parts.length > 2)
+        throw inSelectorError(`too many '..' in "${region}"`, full);
+    const loRaw = parts[0].trim();
+    const hiRaw = (parts.length === 2 ? parts[1] : parts[0]).trim();
+    if (!loRaw || !hiRaw)
+        throw inSelectorError(`empty range endpoint in "${region}"`, full);
+    let loAddr;
+    let hiAddr;
+    try {
+        loAddr = parseAnyAddress(loRaw);
+        hiAddr = parseAnyAddress(hiRaw);
+    }
+    catch {
+        throw inSelectorError(`endpoint not a valid address in "${region}"`, full);
+    }
+    if (loAddr.kind !== hiAddr.kind) {
+        throw new CliError("QUERY BLOCKED: --in range endpoints mismatch", "Range endpoints must be the same address kind.", {
+            exitCode: EXIT_USAGE,
+            required: ["both endpoints episode | scene | action"],
+            received: [`${loRaw}(${loAddr.kind})..${hiRaw}(${hiAddr.kind})`],
+            nextSteps: ["Make both endpoints the same kind, e.g. ep_003..ep_007 or ep_001/scn_002..ep_003/scn_009."],
+            errorCode: "IN_RANGE_KIND_MISMATCH",
+        });
+    }
+    if (loAddr.kind === "episode" && hiAddr.kind === "episode") {
+        const a = idNum(loAddr.episodeId, "ep");
+        const b = idNum(hiAddr.episodeId, "ep");
+        if (Number.isNaN(a) || Number.isNaN(b))
+            throw inSelectorError(`malformed episode id in "${region}"`, full);
+        return a <= b ? { level: "episode", lo: a, hi: b } : { level: "episode", lo: b, hi: a };
+    }
+    if (loAddr.kind === "scene" && hiAddr.kind === "scene") {
+        const a = idNum(loAddr.sceneId, "scn");
+        const b = idNum(hiAddr.sceneId, "scn");
+        if (Number.isNaN(a) || Number.isNaN(b))
+            throw inSelectorError(`malformed scene id in "${region}"`, full);
+        return a <= b ? { level: "scene", lo: a, hi: b } : { level: "scene", lo: b, hi: a };
+    }
+    if (loAddr.kind === "action" && hiAddr.kind === "action") {
+        const a = { scn: idNum(loAddr.sceneId, "scn"), idx: loAddr.actionIndex };
+        const b = { scn: idNum(hiAddr.sceneId, "scn"), idx: hiAddr.actionIndex };
+        if (Number.isNaN(a.scn) || Number.isNaN(b.scn))
+            throw inSelectorError(`malformed scene id in "${region}"`, full);
+        return cmpAction(a, b) <= 0 ? { level: "action", lo: a, hi: b } : { level: "action", lo: b, hi: a };
+    }
+    // asset / state / speaker addresses are not valid scope anchors for --in.
+    throw inSelectorError(`address kind '${loAddr.kind}' not valid in --in`, full);
+}
+// Whole-script selector: `--in '*'`. Distinct from an empty selector — it
+// matches everything but `isEmpty` is false, so writes can tell "scope is
+// intentionally the whole script" apart from "no scope given" (a bare,
+// dangerous dump that callers refuse).
+export const WHOLE_SCRIPT = {
+    isEmpty: false,
+    matchesScene: () => true,
+    matchesAction: () => true,
+};
+export function parseInSelector(raw) {
+    const value = strOf(raw).trim();
+    if (!value)
+        return new RegionSelector([]);
+    if (value === "*")
+        return WHOLE_SCRIPT;
+    const regions = [];
+    for (const seg of value.split(",")) {
+        const region = seg.trim();
+        if (!region)
+            throw inSelectorError("empty region (stray comma?)", value);
+        regions.push(parseRegion(region, value));
+    }
+    return new RegionSelector(regions);
+}
+// When the entire selector is a single action point (e.g. `ep_001/scn_003#2`),
+// asset queries preserve their legacy "narrow to that one action's refs"
+// behavior. Any range or multi-region selector falls back to the union over
+// matched scenes. Returns the global scn number + action index, or null.
+export function selectorSingleActionPoint(sel) {
+    if (!(sel instanceof RegionSelector))
+        return null;
+    if (sel.regions.length !== 1)
+        return null;
+    const r = sel.regions[0];
+    if (r.level !== "action")
+        return null;
+    if (r.lo.scn !== r.hi.scn || r.lo.idx !== r.hi.idx)
+        return null;
+    return { scn: r.lo.scn, idx: r.lo.idx };
+}
+// Expand a selector into the concrete action refs (`ep/scn#idx`, 0-based) it
+// matches, in document order. The batch-edit framework feeds these straight
+// into parseActionRef-based ops. Safe to expand once and run as a single
+// applyPatchOperations batch for NON-structural ops (renumberSceneIds only
+// runs once at the very end, so scn ids stay stable for the whole batch).
+export function expandSelectorToActionRefs(script, selector) {
+    const refs = [];
+    for (const ep of asList(script["episodes"])) {
+        const epId = strOf(ep["episode_id"]);
+        for (const scene of asList(ep["scenes"])) {
+            const sceneId = strOf(scene["scene_id"]);
+            if (!selector.matchesScene(epId, sceneId))
+                continue;
+            const actions = asList(scene["actions"]);
+            for (let i = 0; i < actions.length; i++) {
+                if (!selector.matchesAction(epId, sceneId, i))
+                    continue;
+                refs.push(`${epId}/${sceneId}#${i}`);
+            }
+        }
+    }
+    return refs;
+}
+// Reverse lookup for asset / speaker references. Parallel to collectStateRefs
+// but tracks where an actor/location/prop/speaker is mentioned rather than
+// where a specific state is mentioned. Returns one `{target, location, role}`
+// entry per reference site. Walks the same edges the validator does
+// (script-core.ts validateScript) so coverage is complete:
+//   - scene.context.{actors|locations|props}[]
+//   - action.actor_id (actor only)
+//   - action.speaker_id + action.speakers[] + action.lines[].speaker_id (speaker only)
+//   - action.state_changes[].target_{kind,id}
+//   - action.transition_prompt.target_{kind,id}
+//# sourceMappingURL=selector.js.map

package/dist/domain/script/selector.js.map

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

package/dist/domain/script/shared.d.ts

@@ -0,0 +1,15 @@
+import { CliError } from "../../common.js";
+export type Dict = Record<string, unknown>;
+export declare function strOf(v: unknown): string;
+export declare function isDict(v: unknown): v is Record<string, unknown>;
+export declare function isList(v: unknown): v is unknown[];
+export declare function asList<T = unknown>(v: unknown): T[];
+export declare function idNum(id: string, prefix: string): number;
+export declare function opErr(title: string, message: string, opts?: {
+    exitCode?: number;
+    required?: string[];
+    received?: string[];
+    nextSteps?: string[];
+    op?: string;
+    errorCode?: string;
+}): CliError;

package/dist/domain/script/shared.js

@@ -0,0 +1,37 @@
+// Shared micro-utilities for the script domain modules.
+// Promoted here so script-core's split modules (selector / validate / patch /
+// ids / …) and the usecase layer share one copy instead of each redefining
+// these generic JSON guards.
+import { CliError, EXIT_USAGE } from "../../common.js";
+export function strOf(v) {
+    if (v === null || v === undefined)
+        return "";
+    return String(v);
+}
+export function isDict(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function isList(v) {
+    return Array.isArray(v);
+}
+export function asList(v) {
+    return Array.isArray(v) ? v : [];
+}
+// Parse the numeric tail of an id like `ep_007` / `scn_012` (→ 7 / 12).
+// Returns NaN when the id does not match `${prefix}_<digits>`.
+export function idNum(id, prefix) {
+    const m = new RegExp(`^${prefix}_(\\d+)$`).exec(strOf(id).trim());
+    return m ? parseInt(m[1], 10) : NaN;
+}
+// Error factory used throughout the patch op engine. Defaults to EXIT_USAGE.
+export function opErr(title, message, opts = {}) {
+    return new CliError(title, message, {
+        exitCode: opts.exitCode ?? EXIT_USAGE,
+        required: opts.required,
+        received: opts.received,
+        nextSteps: opts.nextSteps,
+        op: opts.op,
+        errorCode: opts.errorCode,
+    });
+}
+//# sourceMappingURL=shared.js.map