@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/domain/script/v3/patch/ops-meta.js

@@ -0,0 +1,82 @@
+import { WORLDVIEW_VALUES, } from "../../../../common.js";
+import { isList, opErr, strOf } from "../../shared.js";
+import { findEpisode, nextEpisodeId, } from "../lookups.js";
+function requiredSynopsis(op, kind) {
+    const raw = "synopsis" in op ? op["synopsis"] : op["value"];
+    const synopsis = strOf(raw).trim();
+    if (!synopsis) {
+        throw opErr("SCRIPT OP BLOCKED: Synopsis missing", "Synopsis missing.", {
+            required: ["synopsis: non-empty text"],
+            received: ["<empty>"],
+            nextSteps: ["Pass a non-empty synopsis field."],
+            op: kind,
+            errorCode: "SYNOPSIS_MISSING",
+        });
+    }
+    return synopsis;
+}
+export function op_episode_add(__ctx) {
+    const { script, op, sourceText, applied, kind } = __ctx;
+    // Append an empty episode. Scenes/actions are added afterwards with
+    // scene.insert / action.insert. episode_id auto-allocates as ep_NNN.
+    const epId = strOf(op["episode_id"] ?? op["id"]).trim() || nextEpisodeId(script);
+    if (!/^ep_\d+$/.test(epId)) {
+        throw opErr("SCRIPT OP BLOCKED: Episode id invalid", "Episode id must use ep_NNN format.", {
+            required: ["episode_id: ep_NNN"], received: [epId],
+            nextSteps: ["Pass --id ep_004 or omit to auto-allocate."],
+            op: kind, errorCode: "EPISODE_ID_INVALID",
+        });
+    }
+    if (!isList(script["episodes"]))
+        script["episodes"] = [];
+    const eps = script["episodes"];
+    if (eps.some((e) => strOf(e["episode_id"]) === epId)) {
+        throw opErr("SCRIPT OP BLOCKED: Episode id exists", "Episode id exists.", {
+            required: ["unused episode_id"], received: [epId],
+            nextSteps: ["Use another --id or omit it to auto-allocate."],
+            op: kind, errorCode: "EPISODE_ID_EXISTS",
+        });
+    }
+    eps.push({ episode_id: epId, title: strOf(op["title"]).trim(), scenes: [] });
+    applied.push(kind);
+}
+export function op_episode_synopsis_set(__ctx) {
+    const { script, op, sourceText, applied, kind } = __ctx;
+    const episodeId = strOf(op["episode_id"] ?? op["target"] ?? op["at"]).trim();
+    if (!episodeId) {
+        throw opErr("SCRIPT OP BLOCKED: Episode id missing", "Episode id missing.", {
+            required: ["episode_id: ep_NNN"],
+            received: ["<empty>"],
+            nextSteps: ["Pass the episode id whose synopsis should be updated."],
+            op: kind,
+            errorCode: "EPISODE_ID_MISSING",
+        });
+    }
+    const episode = findEpisode(script, episodeId);
+    episode["synopsis"] = requiredSynopsis(op, kind);
+    applied.push(kind);
+}
+export function op_meta_worldview_set(__ctx) {
+    const { script, op, sourceText, applied, kind } = __ctx;
+    // 0.6.0 dot-style equivalent of the legacy `set_worldview` op.
+    const worldview = strOf(op["worldview"] ?? op["value"]).trim();
+    if (!WORLDVIEW_VALUES.includes(worldview)) {
+        throw opErr("SCRIPT OP BLOCKED: Worldview invalid", "Worldview invalid.", {
+            required: [`worldview: one of ${WORLDVIEW_VALUES.join(", ")}`],
+            received: [worldview || "<empty>"],
+            nextSteps: ["Use a supported worldview enum."],
+            op: kind,
+            errorCode: "WORLDVIEW_INVALID",
+        });
+    }
+    script["worldview"] = worldview;
+    if ("worldview_raw" in op)
+        script["worldview_raw"] = strOf(op["worldview_raw"]).trim();
+    applied.push(kind);
+}
+export function op_meta_synopsis_set(__ctx) {
+    const { script, op, sourceText, applied, kind } = __ctx;
+    script["synopsis"] = requiredSynopsis(op, kind);
+    applied.push(kind);
+}
+//# sourceMappingURL=ops-meta.js.map

package/dist/domain/script/v3/patch/ops-meta.js.map

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

package/dist/domain/script/v3/patch/ops-scene.d.ts

@@ -0,0 +1,6 @@
+import type { OpCtx } from "./types.js";
+export declare function op_scene_insert(__ctx: OpCtx): void;
+export declare function op_scene_split(__ctx: OpCtx): void;
+export declare function op_scene_merge(__ctx: OpCtx): void;
+export declare function op_scene_delete(__ctx: OpCtx): void;
+export declare function op_scene_move(__ctx: OpCtx): void;

package/dist/domain/script/v3/patch/ops-scene.js

@@ -0,0 +1,351 @@
+import { asList, isDict, isList, opErr, strOf } from "../../shared.js";
+import { ensureRefId, findEpisode, nextSceneId, sceneIdExists } from "../lookups.js";
+import { parseSceneRef } from "../address.js";
+import { sceneRefs, setSceneRefs } from "../scene-refs.js";
+import { mergeExtendInto } from "./ops-extend.js";
+export function op_scene_insert(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    // Insert a new empty scene into an episode. Position resolved from
+    // --at <idx> | --before <ep/scn> | --after <ep/scn> | default-append.
+    // Requires --location to anchor the scene (v3 scene.location, single-valued).
+    const epId = strOf(op["at"] ?? op["episode_id"]);
+    const ep = findEpisode(script, epId);
+    const scenes = asList(ep["scenes"]);
+    const locationId = strOf(op["location"] ?? op["location_id"]).trim();
+    if (!locationId) {
+        throw opErr("SCRIPT OP BLOCKED: location required", "Scene insert requires --location.", {
+            required: ["location: existing location_id"],
+            received: ["<empty>"],
+            nextSteps: ["Pass --location <loc_id>."],
+            op: kind,
+            errorCode: "SCENE_LOCATION_MISSING",
+        });
+    }
+    ensureRefId(script, "location", locationId);
+    let insertIndex;
+    if (op["before"]) {
+        const [bEp, bScn] = parseSceneRef(op["before"]);
+        if (bEp !== epId) {
+            throw opErr("SCRIPT OP BLOCKED: before address mismatch", "--before must point at the same episode.", {
+                required: [`${epId}/<scn>`],
+                received: [strOf(op["before"])],
+                nextSteps: ["Use a sibling scene address."],
+                op: kind,
+                errorCode: "INSERT_REF_MISMATCH",
+            });
+        }
+        insertIndex = scenes.findIndex((s) => strOf(s["scene_id"]) === bScn);
+        if (insertIndex < 0) {
+            throw opErr("SCRIPT OP BLOCKED: before scene not found", "before scene not found.", {
+                required: ["existing scene_id"],
+                received: [bScn],
+                nextSteps: ["Inspect scenes."],
+                op: kind,
+                errorCode: "SCENE_NOT_FOUND",
+            });
+        }
+    }
+    else if (op["after"]) {
+        const [aEp, aScn] = parseSceneRef(op["after"]);
+        if (aEp !== epId) {
+            throw opErr("SCRIPT OP BLOCKED: after address mismatch", "--after must point at the same episode.", {
+                required: [`${epId}/<scn>`],
+                received: [strOf(op["after"])],
+                nextSteps: ["Use a sibling scene address."],
+                op: kind,
+                errorCode: "INSERT_REF_MISMATCH",
+            });
+        }
+        const found = scenes.findIndex((s) => strOf(s["scene_id"]) === aScn);
+        if (found < 0) {
+            throw opErr("SCRIPT OP BLOCKED: after scene not found", "after scene not found.", {
+                required: ["existing scene_id"],
+                received: [aScn],
+                nextSteps: ["Inspect scenes."],
+                op: kind,
+                errorCode: "SCENE_NOT_FOUND",
+            });
+        }
+        insertIndex = found + 1;
+    }
+    else if (op["at_index"] !== undefined && op["at_index"] !== null) {
+        const n = Number(op["at_index"]);
+        if (!Number.isInteger(n) || n < 0 || n > scenes.length) {
+            throw opErr("SCRIPT OP BLOCKED: at_index out of range", "at_index out of range.", {
+                required: [`0..${scenes.length}`],
+                received: [String(op["at_index"])],
+                nextSteps: ["Use a valid integer index."],
+                op: kind,
+                errorCode: "AT_INDEX_OUT_OF_RANGE",
+            });
+        }
+        insertIndex = n;
+    }
+    else {
+        insertIndex = scenes.length;
+    }
+    const newSceneId = strOf(op["scene_id"]).trim() || nextSceneId(script);
+    if (sceneIdExists(script, newSceneId)) {
+        throw opErr("SCRIPT OP BLOCKED: New scene id exists", "New scene id exists.", {
+            required: ["unused scene_id"],
+            received: [newSceneId],
+            nextSteps: ["Pass --scene-id <unused> or omit."],
+            op: kind,
+            errorCode: "NEW_SCENE_ID_EXISTS",
+        });
+    }
+    const time = strOf(op["time"]).trim() || "day";
+    const space = strOf(op["space"]).trim() || "interior";
+    const newScene = {
+        scene_id: newSceneId,
+        environment: { time, space },
+        location: { location_id: locationId },
+        actors: [],
+        props: [],
+        actions: [],
+    };
+    scenes.splice(insertIndex, 0, newScene);
+    ep["scenes"] = scenes;
+    applied.push(kind);
+}
+export function op_scene_split(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [epId, sceneId] = parseSceneRef(op["at"]);
+    const splitAt = op["at_index"] ?? op["action_index"];
+    if (typeof splitAt !== "number" || !Number.isInteger(splitAt)) {
+        throw opErr("SCRIPT OP BLOCKED: Split index invalid", "Split index invalid.", {
+            required: ["at_index: integer between existing actions"],
+            received: [JSON.stringify(op)],
+            nextSteps: ["Inspect actions and use a valid index."],
+            op: kind,
+            errorCode: "SPLIT_INDEX_INVALID",
+        });
+    }
+    const ep = findEpisode(script, epId);
+    const scenes = asList(ep["scenes"]);
+    const index = scenes.findIndex((s) => s["scene_id"] === sceneId);
+    if (index < 0) {
+        throw opErr("SCRIPT OP BLOCKED: Scene not found", "Scene not found.", {
+            required: ["existing scene_id"],
+            received: [sceneId],
+            nextSteps: ["Inspect scenes and fix the address."],
+            op: kind,
+            errorCode: "SCENE_NOT_FOUND",
+        });
+    }
+    const scene = scenes[index];
+    const actions = asList(scene["actions"]);
+    if (splitAt <= 0 || splitAt >= actions.length) {
+        throw opErr("SCRIPT OP BLOCKED: Split index invalid", "Split index out of bounds.", {
+            required: [`0 < at_index < ${actions.length}`],
+            received: [String(splitAt)],
+            nextSteps: ["Choose an action boundary inside the scene."],
+            op: kind,
+            errorCode: "SPLIT_INDEX_INVALID",
+        });
+    }
+    const newSceneId = strOf(op["new_scene_id"]) || nextSceneId(script);
+    if (sceneIdExists(script, newSceneId)) {
+        throw opErr("SCRIPT OP BLOCKED: New scene id exists", "New scene id exists.", {
+            required: ["unused new_scene_id"],
+            received: [newSceneId],
+            nextSteps: ["Choose an unused scene id or omit new_scene_id."],
+            op: kind,
+            errorCode: "NEW_SCENE_ID_EXISTS",
+        });
+    }
+    // The split-off scene inherits the same cast/props/location (v3 shape).
+    const bag = sceneRefs(scene);
+    const loc = asList(bag["locations"])[0];
+    const newScene = {
+        scene_id: newSceneId,
+        environment: { ...(isDict(scene["environment"]) ? scene["environment"] : {}) },
+        location: loc ? { ...loc } : null,
+        actors: asList(bag["actors"]).map((r) => ({ ...r })),
+        props: asList(bag["props"]).map((r) => ({ ...r })),
+        actions: actions.slice(splitAt),
+    };
+    scene["actions"] = actions.slice(0, splitAt);
+    scenes.splice(index + 1, 0, newScene);
+    applied.push(kind);
+}
+export function op_scene_merge(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    // {from, into}: source disappears, into keeps.
+    const fromRaw = op["from"] ?? op["remove_scene_id"];
+    const intoRaw = op["into"] ?? op["keep_scene_id"];
+    let fromEp, fromScn, intoEp, intoScn;
+    if (typeof fromRaw === "string" && fromRaw.includes("/")) {
+        [fromEp, fromScn] = parseSceneRef(fromRaw);
+    }
+    else {
+        fromEp = strOf(op["episode_id"]);
+        fromScn = strOf(fromRaw);
+    }
+    if (typeof intoRaw === "string" && intoRaw.includes("/")) {
+        [intoEp, intoScn] = parseSceneRef(intoRaw);
+    }
+    else {
+        intoEp = strOf(op["episode_id"]);
+        intoScn = strOf(intoRaw);
+    }
+    if (fromEp !== intoEp) {
+        throw opErr("SCRIPT OP BLOCKED: Merge cross-episode", "Scene merge must be within one episode.", {
+            required: ["same episode_id on both sides"],
+            received: [`${fromEp}/${fromScn} → ${intoEp}/${intoScn}`],
+            nextSteps: ["Move one scene first, or merge same-episode scenes."],
+            op: kind,
+            errorCode: "MERGE_CROSS_EPISODE",
+        });
+    }
+    if (fromScn === intoScn) {
+        throw opErr("SCRIPT OP BLOCKED: Merge self", "Cannot merge a scene into itself.", {
+            required: ["distinct from / into scenes"],
+            received: [`${fromScn} → ${intoScn}`],
+            nextSteps: ["Pick two different scenes to merge."],
+            op: kind,
+            errorCode: "MERGE_SELF",
+        });
+    }
+    const ep = findEpisode(script, fromEp);
+    const scenes = asList(ep["scenes"]);
+    const intoScene = scenes.find((s) => s["scene_id"] === intoScn);
+    const fromScene = scenes.find((s) => s["scene_id"] === fromScn);
+    if (!intoScene || !fromScene) {
+        throw opErr("SCRIPT OP BLOCKED: Scene not found", "Scene not found.", {
+            required: ["existing scene_id on both sides"],
+            received: [`from=${fromScn}, into=${intoScn}`],
+            nextSteps: ["Inspect scenes and fix the address."],
+            op: kind,
+            errorCode: "SCENE_NOT_FOUND",
+        });
+    }
+    intoScene["actions"].push(...asList(fromScene["actions"]));
+    const intoBag = sceneRefs(intoScene);
+    const fromBag = sceneRefs(fromScene);
+    // Actor refs are ordered instances and may repeat. Props/location retain
+    // their set semantics; into wins for the single-valued location.
+    for (const [field, idKey] of [["actors", "actor_id"], ["locations", "location_id"], ["props", "prop_id"]]) {
+        if (field === "actors") {
+            intoBag[field].push(...asList(fromBag[field]));
+            continue;
+        }
+        const existingIds = new Set();
+        for (const ref of asList(intoBag[field]))
+            existingIds.add(ref[idKey]);
+        for (const ref of asList(fromBag[field])) {
+            if (!existingIds.has(ref[idKey])) {
+                if (!isList(intoBag[field]))
+                    intoBag[field] = [];
+                intoBag[field].push(ref);
+            }
+        }
+    }
+    setSceneRefs(intoScene, intoBag);
+    mergeExtendInto(fromScene, intoScene);
+    ep["scenes"] = scenes.filter((s) => s !== fromScene);
+    applied.push(kind);
+}
+export function op_scene_delete(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [epId, sceneId] = parseSceneRef(op["at"]);
+    const ep = findEpisode(script, epId);
+    const scenes = asList(ep["scenes"]);
+    const scene = scenes.find((s) => s["scene_id"] === sceneId);
+    if (!scene) {
+        throw opErr("SCRIPT OP BLOCKED: Scene not found", "Scene not found.", {
+            required: ["existing scene_id"],
+            received: [`${epId}/${sceneId}`],
+            nextSteps: ["Inspect scenes."],
+            op: kind,
+            errorCode: "SCENE_NOT_FOUND",
+        });
+    }
+    const actions = asList(scene["actions"]);
+    const force = Boolean(op["force"]);
+    if (actions.length > 0 && !force) {
+        throw opErr("SCRIPT OP BLOCKED: Scene non-empty", `Scene has ${actions.length} action(s).`, {
+            required: ["empty scene, or force=true"],
+            received: [`actions=${actions.length}`],
+            nextSteps: ["Pass --force to delete with actions, or move/delete actions first."],
+            op: kind,
+            errorCode: "SCENE_NON_EMPTY",
+        });
+    }
+    ep["scenes"] = scenes.filter((s) => s !== scene);
+    applied.push(kind);
+}
+export function op_scene_move(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [fromEp, fromScn] = parseSceneRef(op["at"] ?? op["from"]);
+    const toEpRaw = strOf(op["to"]);
+    let toEp;
+    let toAnchorScn = null;
+    if (toEpRaw.includes("/")) {
+        const [a, b] = parseSceneRef(toEpRaw);
+        toEp = a;
+        toAnchorScn = b;
+    }
+    else {
+        toEp = toEpRaw;
+    }
+    if (!toEp) {
+        throw opErr("SCRIPT OP BLOCKED: to address invalid", "to address invalid.", {
+            required: ["to: ep_NNN or ep_NNN/scn_NNN"],
+            received: [toEpRaw],
+            nextSteps: ["Pass a target episode id."],
+            op: kind,
+            errorCode: "SCENE_MOVE_TO_INVALID",
+        });
+    }
+    const fromEpisode = findEpisode(script, fromEp);
+    const fromScenes = asList(fromEpisode["scenes"]);
+    const sourceIdx = fromScenes.findIndex((s) => s["scene_id"] === fromScn);
+    if (sourceIdx < 0) {
+        throw opErr("SCRIPT OP BLOCKED: Scene not found", "Source scene not found.", {
+            required: ["existing scene_id"],
+            received: [`${fromEp}/${fromScn}`],
+            nextSteps: ["Inspect scenes."],
+            op: kind,
+            errorCode: "SCENE_NOT_FOUND",
+        });
+    }
+    const [moved] = fromScenes.splice(sourceIdx, 1);
+    fromEpisode["scenes"] = fromScenes;
+    const toEpisode = findEpisode(script, toEp);
+    const toScenes = asList(toEpisode["scenes"]);
+    let destIdx;
+    if (op["at_index"] !== undefined && op["at_index"] !== null) {
+        const n = Number(op["at_index"]);
+        if (!Number.isInteger(n) || n < 0 || n > toScenes.length) {
+            throw opErr("SCRIPT OP BLOCKED: at_index out of range", "at_index out of range.", {
+                required: [`0..${toScenes.length}`],
+                received: [String(op["at_index"])],
+                nextSteps: ["Use a valid integer index."],
+                op: kind,
+                errorCode: "AT_INDEX_OUT_OF_RANGE",
+            });
+        }
+        destIdx = n;
+    }
+    else if (toAnchorScn) {
+        const found = toScenes.findIndex((s) => s["scene_id"] === toAnchorScn);
+        if (found < 0) {
+            throw opErr("SCRIPT OP BLOCKED: Target scene not found", "Target scene not found.", {
+                required: ["existing scene_id in target episode"],
+                received: [`${toEp}/${toAnchorScn}`],
+                nextSteps: ["Inspect the target episode."],
+                op: kind,
+                errorCode: "SCENE_NOT_FOUND",
+            });
+        }
+        destIdx = found;
+    }
+    else {
+        destIdx = toScenes.length;
+    }
+    toScenes.splice(destIdx, 0, moved);
+    toEpisode["scenes"] = toScenes;
+    applied.push(kind);
+}
+//# sourceMappingURL=ops-scene.js.map

package/dist/domain/script/v3/patch/ops-scene.js.map

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

package/dist/domain/script/v3/patch/ops-state.d.ts

@@ -0,0 +1,8 @@
+import type { OpCtx } from "./types.js";
+export declare function op_state_add(__ctx: OpCtx): void;
+export declare function op_state_rename(__ctx: OpCtx): void;
+export declare function op_state_describe(__ctx: OpCtx): void;
+export declare function op_state_delete(__ctx: OpCtx): void;
+export declare function op_scene_ref_set(__ctx: OpCtx): void;
+export declare function op_scene_ref_clear(__ctx: OpCtx): void;
+export declare function op_scene_ref_remove(__ctx: OpCtx): void;

package/dist/domain/script/v3/patch/ops-state.js

@@ -0,0 +1,165 @@
+import { stateRejectionReason } from "../../text-util.js";
+import { asList, isDict, isList, opErr, strOf } from "../../shared.js";
+import { findScene, idKeyForKind, nextStateId, pluralForKind } from "../lookups.js";
+import { parseAssetTarget, parseSceneRef, parseStateTarget } from "../address.js";
+import { sceneRefs, setSceneRefs } from "../scene-refs.js";
+import { contextRefIndex, contextRefsForKind, matchingContextRefIndexes, resolveAssetByTarget, resolveState, sceneRefOccurrence, setContextState, validateStateForTarget, } from "./helpers.js";
+export function op_state_add(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [targetKind, targetId] = parseAssetTarget(op["target"]);
+    const asset = resolveAssetByTarget(script, targetKind, targetId);
+    const name = strOf(op["name"] || op["state_name"]).trim();
+    const description = strOf(op["description"]).trim();
+    const stateId = strOf(op["state_id"]).trim() || nextStateId(script);
+    if (!name) {
+        throw opErr("SCRIPT OP BLOCKED: State name empty", "State name empty.", {
+            required: ["name"], received: [JSON.stringify(op)],
+            nextSteps: ["Provide a state name."], op: kind, errorCode: "STATE_NAME_EMPTY",
+        });
+    }
+    const reason = stateRejectionReason(targetKind, name);
+    if (reason) {
+        throw opErr("SCRIPT OP BLOCKED: State label invalid", "State label invalid.", {
+            required: ["one clear state label"], received: [name],
+            nextSteps: ["Do not combine multiple states into one label."], op: kind, errorCode: "STATE_LABEL_INVALID",
+        });
+    }
+    if (!isList(asset["states"]))
+        asset["states"] = [];
+    const existingStates = asset["states"];
+    if (existingStates.some((s) => strOf(s["state_id"]) === stateId)) {
+        throw opErr("SCRIPT OP BLOCKED: State id exists", "State id exists.", { required: ["unused state_id"], received: [stateId], nextSteps: ["Use another state_id or edit the existing state."], op: kind, errorCode: "STATE_ID_EXISTS" });
+    }
+    if (existingStates.some((s) => strOf(s["state_name"] || s["name"]) === name)) {
+        throw opErr("SCRIPT OP BLOCKED: State name exists", "State name exists.", { required: ["unused state name"], received: [name], nextSteps: ["Rename the existing state or choose another name."], op: kind, errorCode: "STATE_NAME_EXISTS" });
+    }
+    existingStates.push({ state_id: stateId, state_name: name, description });
+    op["state_id"] = stateId;
+    applied.push(kind);
+}
+export function op_state_rename(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [targetKind, targetId, stateId] = parseStateTarget(op["target"]);
+    const state = resolveState(script, targetKind, targetId, stateId);
+    const name = strOf(op["name"] || op["state_name"]).trim();
+    if (!name) {
+        throw opErr("SCRIPT OP BLOCKED: State name empty", "State name empty.", { required: ["name"], received: [JSON.stringify(op)], nextSteps: ["Provide a state name."], op: kind, errorCode: "STATE_NAME_EMPTY" });
+    }
+    const reason = stateRejectionReason(targetKind, name);
+    if (reason) {
+        throw opErr("SCRIPT OP BLOCKED: State label invalid", "State label invalid.", { required: ["one clear state label"], received: [name], nextSteps: ["Do not combine multiple states into one label."], op: kind, errorCode: "STATE_LABEL_INVALID" });
+    }
+    state["state_name"] = name;
+    applied.push(kind);
+}
+export function op_state_describe(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [targetKind, targetId, stateId] = parseStateTarget(op["target"]);
+    const state = resolveState(script, targetKind, targetId, stateId);
+    state["description"] = strOf(op["description"]).trim();
+    applied.push(kind);
+}
+export function op_state_delete(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [targetKind, targetId, stateId] = parseStateTarget(op["target"]);
+    const asset = resolveAssetByTarget(script, targetKind, targetId);
+    resolveState(script, targetKind, targetId, stateId);
+    // v3 invariant: every asset keeps exactly one 'default' state.
+    if (stateId === "default") {
+        throw opErr("SCRIPT OP BLOCKED: Cannot delete default state", "The 'default' state cannot be deleted.", {
+            required: ["a non-default state_id"], received: [stateId],
+            nextSteps: ["Delete a specific state; the default is the always-present baseline."], op: kind, errorCode: "STATE_DEFAULT_PROTECTED",
+        });
+    }
+    const strategy = strOf(op["strategy"]).trim();
+    const replacement = strOf(op["replacement"]).trim();
+    if (strategy !== "replace" && strategy !== "remove") {
+        throw opErr("SCRIPT OP BLOCKED: Delete strategy invalid", "Delete strategy invalid.", { required: ["strategy: replace or remove"], received: [strategy || "<empty>"], nextSteps: ["Choose replace with --replacement, or remove."], op: kind, errorCode: "DELETE_STRATEGY_INVALID" });
+    }
+    if (strategy === "replace") {
+        if (!replacement) {
+            throw opErr("SCRIPT OP BLOCKED: Replacement missing", "Replacement missing.", { required: ["replacement state_id"], received: ["<empty>"], nextSteps: ["Pass --replacement with an existing state_id."], op: kind, errorCode: "REPLACEMENT_MISSING" });
+        }
+        validateStateForTarget(script, targetKind, targetId, replacement);
+    }
+    const idKey = idKeyForKind(targetKind);
+    // Scrub scene refs that carried the deleted state: replace → replacement,
+    // remove → clear to null (state lives only on scene refs in v3).
+    for (const ep of asList(script["episodes"])) {
+        for (const scene of asList(ep["scenes"])) {
+            const bag = sceneRefs(scene);
+            let touched = false;
+            for (const ref of contextRefsForKind(bag, targetKind)) {
+                if (strOf(ref[idKey]) === targetId && strOf(ref["state_id"]) === stateId) {
+                    ref["state_id"] = strategy === "replace" ? replacement : null;
+                    touched = true;
+                }
+            }
+            if (touched)
+                setSceneRefs(scene, bag);
+        }
+    }
+    asset["states"] = asList(asset["states"]).filter((s) => strOf(s["state_id"]) !== stateId);
+    applied.push(kind);
+}
+export function op_scene_ref_set(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [epId, sceneId] = parseSceneRef(op["at"]);
+    const [targetKind, targetId] = parseAssetTarget(op["target"]);
+    const append = Boolean(op["append"]);
+    const occurrence = sceneRefOccurrence(op["occurrence"], kind);
+    if (append && occurrence !== undefined) {
+        throw opErr("SCRIPT OP BLOCKED: scene ref append is ambiguous", "append and occurrence cannot be combined.", {
+            required: ["append=true, or occurrence=<n>"],
+            received: ["append=true", `occurrence=${occurrence}`],
+            nextSteps: ["Append a new ref or update an existing occurrence."],
+            op: kind,
+            errorCode: "SCENE_REF_APPEND_FLAG_CONFLICT",
+        });
+    }
+    setContextState(script, epId, sceneId, targetKind, targetId, strOf(op["state"] || op["state_id"]).trim(), { append, occurrence, op: kind });
+    applied.push(kind);
+}
+export function op_scene_ref_clear(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [epId, sceneId] = parseSceneRef(op["at"]);
+    const [targetKind, targetId] = parseAssetTarget(op["target"]);
+    setContextState(script, epId, sceneId, targetKind, targetId, null, {
+        occurrence: sceneRefOccurrence(op["occurrence"], kind),
+        op: kind,
+    });
+    applied.push(kind);
+}
+export function op_scene_ref_remove(__ctx) {
+    const { script, op, applied, kind } = __ctx;
+    const [epId, sceneId] = parseSceneRef(op["at"]);
+    const [targetKind, targetId] = parseAssetTarget(op["target"]);
+    const scene = findScene(script, epId, sceneId);
+    const bag = sceneRefs(scene);
+    const idKey = idKeyForKind(targetKind);
+    const refs = contextRefsForKind(bag, targetKind);
+    const occurrence = sceneRefOccurrence(op["occurrence"], kind);
+    const removeIndex = contextRefIndex(refs, idKey, targetId, occurrence, kind);
+    const matchingIndexes = matchingContextRefIndexes(refs, idKey, targetId);
+    if (targetKind === "actor"
+        && removeIndex !== undefined
+        && matchingIndexes.length === 1
+        && asList(scene["actions"]).some((action) => {
+            const speaker = action["speaker"];
+            return isDict(speaker) && strOf(speaker["actor_id"]) === targetId;
+        })) {
+        throw opErr("SCRIPT OP BLOCKED: Actor is used in scene", "Cannot remove an actor reference while the actor speaks in this scene.", {
+            required: ["all dialogue/inner_thought speaker refs moved or removed before scene actor removal"],
+            received: [`${epId}/${sceneId} actor:${targetId}`],
+            nextSteps: ["Reassign or remove the actor's lines, then remove the scene ref."],
+            op: kind,
+            errorCode: "ACTOR_IN_USE_IN_SCENE",
+        });
+    }
+    if (removeIndex !== undefined)
+        refs.splice(removeIndex, 1);
+    bag[pluralForKind(targetKind)] = refs;
+    setSceneRefs(scene, bag);
+    applied.push(kind);
+}
+//# sourceMappingURL=ops-state.js.map