@lingjingai/scriptctl 0.34.0 → 0.36.0

package/dist/usecases/script/{add-speaker.d.ts → importance.d.ts}

@@ -1,3 +1,3 @@
 import { type Report } from "../../common.js";
 import { type Dict } from "../../domain/script/shared.js";
-export declare function commandAddSpeaker(opts: Dict): Promise<[Report, number]>;
+export declare function commandImportance(opts: Dict): Promise<[Report, number]>;

package/dist/usecases/script/importance.js

@@ -0,0 +1,17 @@
+import { CliError, EXIT_USAGE } from "../../common.js";
+import { asList } from "../../domain/script/shared.js";
+import { applySingleScriptOp } from "./lib.js";
+export async function commandImportance(opts) {
+    const args = asList(opts["_args"]);
+    if (args.length < 2) {
+        throw new CliError("VERB BLOCKED: Importance args missing", "Importance args missing.", {
+            exitCode: EXIT_USAGE,
+            required: ["<kind:id> <featured|background>"],
+            received: args,
+            nextSteps: ["Example: scriptctl importance actor:act_001 background"],
+            errorCode: "ARGS_MISSING",
+        });
+    }
+    return applySingleScriptOp(opts, { op: "importance.set", target: args[0], importance: args[1] });
+}
+//# sourceMappingURL=importance.js.map

package/dist/usecases/script/importance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importance.js","sourceRoot":"","sources":["../../../src/usecases/script/importance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAa,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU;IAChD,MAAM,IAAI,GAAG,MAAM,CAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,0BAA0B,EAAE;YACtF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,iCAAiC,CAAC;YAC7C,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,CAAC,wDAAwD,CAAC;YACrE,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/dist/usecases/script/insert.js.map

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

package/dist/usecases/script/issues.js.map

@@ -1 +1 @@
-{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/usecases/script/issues.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AAkCzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,EAAE,eAAe,GAEnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACwS,WAAW,GACzT,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,cAAc,IAAI,cAAc,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QAC5E,IAAI,UAAU,IAAI,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAE,SAAS;QAChE,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,+EAA+E"}
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/usecases/script/issues.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,GAWR,MAAM,iBAAiB,CAAC;AA6BzB,OAAO,EACL,MAAM,EAIN,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,iBAAiB,EAAE,eAAe,GAEnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAC6P,WAAW,GAC9Q,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,cAAc,IAAI,cAAc,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAE,SAAS;QAC5E,IAAI,UAAU,IAAI,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAE,SAAS;QAChE,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,+EAA+E"}

package/dist/usecases/script/lib.d.ts

@@ -1,6 +1,6 @@
 import { CliError, type Report } from "../../common.js";
 import { type InSelector } from "../../domain/script/selector.js";
-import { sortDeep } from "../../domain/direct-core.js";
+import { sortDeep } from "../../domain/script/text-util.js";
 import { type Dict } from "../../domain/script/shared.js";
 import { ScriptEditSession } from "./session.js";
 export interface DoToken {
@@ -37,11 +37,18 @@ export declare function contextTemplate(target: string, f: {
     clear?: boolean;
     remove?: boolean;
 }): Dict;
-export declare function dialogueTemplate(speakers: string[], f: {
-    delivery?: unknown;
+export declare function dialogueTemplate(f: {
+    actor?: unknown;
+    kind?: unknown;
+    label?: unknown;
 }): Dict;
 export declare function lineToOp(verb: string, args: string[], flags: Dict): Dict;
 export declare function actionAddress(epId: string, sceneId: string, idx: number): string;
+export declare function actionTimestamp(action: Dict): string;
+export declare function sceneTimeSpan(scene: Dict): {
+    t_start: string;
+    t_end: string;
+};
 export declare function actionDisplayFields(epId: string, sceneId: string, idx: number, action: Dict): Record<string, unknown>;
 export declare function formatInspectAction(epId: string, sceneId: string, idx: number, action: Dict): string;
 export declare const SKIPPABLE_EDIT_CODES: Set<string>;
@@ -50,9 +57,9 @@ export declare function summarizeScriptOp(_script: Dict, op: Dict): string;
 export declare function regexPattern(raw: string): string;
 export declare function applySelectorEdits(opts: Dict, template: Dict, verbLabel: string): Promise<[Report, number]>;
 export { sortDeep };
-export declare function speakerSourceActorMap(script: Dict): Map<string, string>;
-export declare function speakerIdsInAction(action: Dict): Set<string>;
-export declare function actorIdsInAction(action: Dict, speakerToActor: Map<string, string>): Set<string>;
+export declare function actionActorId(action: Dict): string;
+export declare function actionSpeakerLabel(action: Dict, actorNames?: Map<string, string>): string;
+export declare function actorIdsInAction(action: Dict): Set<string>;
 export declare function buildGrepMatcher(raw: string): ((hay: string) => boolean) | null;
 export declare function buildReport(op: string, title: string, lines: string[], artifactLabel: string): Report;
 export declare function synopsisPreview(text: string, limit: number): string;
@@ -72,10 +79,16 @@ export interface ActionTarget {
 export declare const HAS_FILTERS: Set<string>;
 export declare function resolveActionTargets(script: Dict, opts: Dict): ActionTarget[];
 export declare function selectionHasAnyFilter(opts: Dict): boolean;
+export declare function compactEpisodeRanges(ids: Iterable<string>): string;
+export declare function assetAppearanceCounts(script: Dict, kind: "actor" | "location" | "prop"): Map<string, {
+    episodes: Set<string>;
+    scenes: number;
+}>;
 export declare function listAssetsByKind(script: Dict, kind: "actor" | "location" | "prop", opts: {
     id: string;
     name: string;
     selector: InSelector;
+    counts?: boolean;
 }): string[];
 export declare function splitSpeakerList(raw: unknown): string[];
 export declare function blankCreateReport(session: ScriptEditSession, validation: Dict, idempotent: boolean | null): Report;

package/dist/usecases/script/lib.js

@@ -1,11 +1,12 @@
 import { CliError, EXIT_NEEDS_AGENT, EXIT_OK, EXIT_USAGE, } from "../../common.js";
 import { applyPatchOperations } from "../../domain/script/patch/apply.js";
 import { renumberSceneIds } from "../../domain/script/lookups.js";
+import { sceneRefs } from "../../domain/script/scene-refs.js";
 import { isDangerousRegex, MAX_GREP_PATTERN_LEN, parseInSelector, selectorSingleActionPoint, WHOLE_SCRIPT, } from "../../domain/script/selector.js";
 import { parseAnyAddress, } from "../../domain/script/address.js";
-import { summarizeIssues, } from "../direct.js";
-import { sortDeep } from "../../domain/direct-core.js";
-import { asList, isDict, strOf, } from "../../domain/script/shared.js";
+import { summarizeIssues } from "../../domain/script/text-util.js";
+import { sortDeep } from "../../domain/script/text-util.js";
+import { asList, idNum, isDict, strOf, } from "../../domain/script/shared.js";
 import { loadScriptForEdit, validateSession, saveScriptSession, syncValidationResult, scriptSourceText, } from "./session.js";
 export function tokenizeLine(line) {
     const out = [];
@@ -73,16 +74,14 @@ function isDoFlag(t) {
 // Per-verb flag arity. Everything else takes the next token as its value.
 export const DO_BOOL_FLAGS = {
     replace: new Set(["all", "regex"]),
-    "state-change": new Set(["clear"]),
     transition: new Set(["clear"]),
     emotion: new Set(["clear"]),
-    context: new Set(["clear", "remove"]),
+    "scene-ref": new Set(["clear", "remove"]),
     delete: new Set(["force"]),
     extend: new Set(["clear", "json-value"]),
 };
 export const DO_REPEAT_FLAGS = {
     alias: new Set(["add", "remove"]),
-    overlap: new Set(["line"]),
     "add-actor": new Set(["alias"]),
 };
 function pushFlag(flags, repeats, name, val) {
@@ -175,9 +174,11 @@ export function stateChangeTemplate(target, f) {
             nextSteps: ["Pick exactly one flag."], errorCode: "STATE_CHANGE_FLAG_MISSING",
         });
     }
-    return clearSet
-        ? { op: "action.state.remove", target }
-        : { op: "action.state.change", target, to: f.to, from: f.from, effective: f.effective || "after" };
+    // v3 has no per-action state_changes; state lives on scene.ref.* only.
+    throw new CliError("VERB BLOCKED: state-change removed", "state-change was removed in v3; set a scene ref's state instead.", {
+        exitCode: EXIT_USAGE, required: ["scene-ref state edit"], received: ["state-change"],
+        nextSteps: ["Use `scene-ref <ep/scn> <kind:id> --state <state_id>` (op scene.ref.set)."], errorCode: "STATE_CHANGE_REMOVED",
+    });
 }
 export function transitionTemplate(target, f) {
     const setBoth = f.process !== undefined || f.contrast !== undefined;
@@ -242,13 +243,24 @@ export function contextTemplate(target, f) {
         });
     }
     if (removeSet)
-        return { op: "context.ref.remove", target };
+        return { op: "scene.ref.remove", target };
     if (clearSet)
-        return { op: "context.clear", target };
-    return { op: "context.set", target, state: f.state === "none" ? "" : f.state };
-}
-export function dialogueTemplate(speakers, f) {
-    return { op: "dialogue.speakers", speakers, delivery: strOf(f.delivery).trim() || (speakers.length > 1 ? "simultaneous" : "single") };
+        return { op: "scene.ref.clear", target };
+    return { op: "scene.ref.set", target, state: f.state === "none" ? "" : f.state };
+}
+// v3 dialogue speaker: a single inline speaker — an actor, OR a non-actor kind
+// (system|broadcast|offscreen|group) with an optional label.
+export function dialogueTemplate(f) {
+    const actorId = strOf(f.actor).trim();
+    const speakerKind = strOf(f.kind).trim();
+    if (actorId)
+        return { op: "dialogue.speaker.set", actor_id: actorId };
+    if (speakerKind)
+        return { op: "dialogue.speaker.set", kind: speakerKind, label: strOf(f.label).trim() || undefined };
+    throw new CliError("VERB BLOCKED: dialogue speaker missing", "dialogue: pass --actor <id> or --kind <system|broadcast|offscreen|group>.", {
+        exitCode: EXIT_USAGE, required: ["--actor <actor_id> or --kind <non-actor kind>"], received: ["<missing>"],
+        nextSteps: ["Set --actor for an actor line, or --kind for a non-actor line."], errorCode: "DIALOGUE_SPEAKER_MISSING",
+    });
 }
 // Translate one parsed verb line into a patch op dict (the SAME ops `patch`
 // consumes). `do` = the human/agent-friendly notation for those ops: no JSON,
@@ -266,18 +278,14 @@ export function lineToOp(verb, args, flags) {
             return { op: "action.type.set", at: a0, type: a1 };
         case "actor":
             return { op: "action.actor.set", at: a0, actor_id: a1 };
-        case "state-change":
-            return { ...stateChangeTemplate(a1, { to: flags["to"], from: flags["from"], effective: flags["effective"], clear: Boolean(flags["clear"]) }), at: a0 };
         case "transition":
             return { ...transitionTemplate(a1, { process: flags["process"], contrast: flags["contrast"], clear: Boolean(flags["clear"]) }), at: a0 };
         case "emotion":
             return { ...emotionTemplate({ emotion: args[1], clear: Boolean(flags["clear"]) }), at: a0 };
-        case "context":
+        case "scene-ref":
             return { ...contextTemplate(a1, { state: flags["state"], clear: Boolean(flags["clear"]), remove: Boolean(flags["remove"]) }), at: a0 };
         case "dialogue":
-            return { ...dialogueTemplate(splitSpeakerList(flags["speakers"]), { delivery: flags["delivery"] }), at: a0 };
-        case "overlap":
-            return { op: "dialogue.overlap", at: a0, lines: flags["line"] ?? [] };
+            return { ...dialogueTemplate({ actor: flags["actor"], kind: flags["kind"], label: flags["label"] }), at: a0 };
         case "rename":
             return { op: "asset.rename", target: a0, name: a1 };
         case "role":
@@ -350,8 +358,8 @@ export function lineToOp(verb, args, flags) {
             return { op: "prop.add", name: a0, description: flags["description"] };
         case "add-episode":
             return { op: "episode.add", title: flags["title"], episode_id: flags["id"] };
-        case "add-speaker":
-            return { op: "speaker.add", kind: flags["kind"], name: flags["name"], source_id: flags["source-id"], voice_desc: flags["voice-desc"], speaker_id: flags["speaker-id"] };
+        case "importance":
+            return { op: "importance.set", target: a0, importance: a1 };
         case "split":
             return { op: "scene.split", at: a0, at_index: flags["at"], new_scene_id: flags["new-scene-id"] };
         case "delete": {
@@ -360,8 +368,6 @@ export function lineToOp(verb, args, flags) {
                 return { op: "action.delete", at: a0 };
             if (addr.kind === "scene")
                 return { op: "scene.delete", at: a0, force: Boolean(flags["force"]) };
-            if (addr.kind === "speaker")
-                return { op: "speaker.delete", target: a0, strategy: flags["strategy"], replacement: flags["replacement"] };
             if (addr.kind === "asset")
                 return { op: "asset.delete", target: a0, strategy: flags["strategy"], replacement: flags["replacement"] };
             throw doErr(`delete cannot operate on a ${addr.kind} address (${a0}); episodes/states have no delete op`);
@@ -399,23 +405,43 @@ export function lineToOp(verb, args, flags) {
 export function actionAddress(epId, sceneId, idx) {
     return `${epId}/${sceneId}#${idx}`;
 }
-export function actionDisplayFields(epId, sceneId, idx, action) {
-    const speakerId = [...speakerIdsInAction(action)].join(",");
-    const actorId = strOf(action["actor_id"]).trim();
-    let content = strOf(action["content"]);
-    if (!content) {
-        const lines = asList(action["lines"]);
-        if (lines.length > 0)
-            content = lines.map((l) => strOf(l["content"])).join(" / ");
+// The action's authored timeline position, carried in extend.timestamp as a
+// "M:SS" / "MM:SS" string (episode-local by convention). Empty string when the
+// action carries no timestamp. This is the anchor event-level alignment reads:
+// an event's span is the delta between its first and last action timestamp.
+export function actionTimestamp(action) {
+    const extend = isDict(action["extend"]) ? action["extend"] : {};
+    return strOf(extend["timestamp"]).trim();
+}
+// First and last non-empty action timestamps within a scene, in document order.
+// Timestamps are monotonic within an episode, so first = t_start, last = t_end.
+export function sceneTimeSpan(scene) {
+    let t_start = "";
+    let t_end = "";
+    for (const action of asList(scene["actions"])) {
+        const ts = actionTimestamp(action);
+        if (!ts)
+            continue;
+        if (!t_start)
+            t_start = ts;
+        t_end = ts;
     }
+    return { t_start, t_end };
+}
+export function actionDisplayFields(epId, sceneId, idx, action) {
+    const actorId = actionActorId(action);
+    const s = isDict(action["speaker"]) ? action["speaker"] : null;
+    // For a non-actor speaker ({kind,label}) surface it under `speaker`; an actor
+    // line surfaces under `actor` (its id). Narrative lines have neither.
+    const speaker = s && !actorId ? (strOf(s["label"]).trim() || strOf(s["kind"]).trim()) : "";
     return {
         addr: actionAddress(epId, sceneId, idx),
+        timestamp: actionTimestamp(action),
         type: strOf(action["type"]).trim() || "action",
-        delivery: strOf(action["delivery"]).trim(),
-        speaker: speakerId,
+        speaker,
         actor: actorId,
         emotion: strOf(action["emotion"]).trim(),
-        content,
+        content: strOf(action["content"]),
     };
 }
 export function formatInspectAction(epId, sceneId, idx, action) {
@@ -431,8 +457,9 @@ export function formatInspectAction(epId, sceneId, idx, action) {
     const actorId = strOf(fields["actor"]);
     const who = speakerId || actorId;
     const emotion = strOf(fields["emotion"]);
+    const timestamp = strOf(fields["timestamp"]);
     const content = strOf(fields["content"]);
-    const meta = [tag, emotion ? `emotion=${emotion}` : "", who].filter((v) => v).join(" ");
+    const meta = [tag, timestamp ? `t=${timestamp}` : "", emotion ? `emotion=${emotion}` : "", who].filter((v) => v).join(" ");
     const prefix = `${addr} [${meta}]`;
     return content ? `${prefix} ${content}` : prefix;
 }
@@ -490,8 +517,10 @@ export function summarizeScriptOp(_script, op) {
         return `已更新分集梗概 ${op["episode_id"] ?? op["target"] ?? op["at"]}`;
     if (kind === "state.add")
         return `已为 ${op["target"]} 新增状态 ${op["state_id"]}: ${op["name"] || op["state_name"]}`;
-    if (kind === "action.state.change")
-        return `已在 ${op["at"]} 为 ${op["target"]} 设置状态切换到 ${op["to"] || op["to_state_id"]}`;
+    if (kind === "importance.set")
+        return `已将 ${op["target"]} 重要度设为 ${op["importance"]}`;
+    if (kind === "scene.ref.set")
+        return `已在 ${op["at"]} 设置引用 ${op["target"]}${op["state"] ? `（状态 ${op["state"]}）` : ""}`;
     if (kind === "extend.set")
         return `已在 ${op["at"]} 设置 extend.${op["key"]}`;
     if (kind === "extend.clear")
@@ -608,46 +637,34 @@ export { sortDeep };
 // / --speaker / --severity / --code / --has-{actor,location,prop}).
 // Resolve the speaker_id → source actor mapping once per call. Used by
 // commandActions's --actor filter when the action speaks via a speaker.
-export function speakerSourceActorMap(script) {
-    const map = new Map();
-    for (const s of asList(script["speakers"])) {
-        const sourceKind = strOf(s["source_kind"]);
-        if (sourceKind === "actor") {
-            const sid = strOf(s["speaker_id"]);
-            const src = strOf(s["source_id"]);
-            if (sid && src)
-                map.set(sid, src);
-        }
-    }
-    return map;
-}
-export function speakerIdsInAction(action) {
-    const ids = new Set();
-    const direct = strOf(action["speaker_id"]).trim();
-    if (direct)
-        ids.add(direct);
-    for (const sp of asList(action["speakers"])) {
-        const id = strOf(sp["speaker_id"]).trim();
-        if (id)
-            ids.add(id);
-    }
-    for (const line of asList(action["lines"])) {
-        const id = strOf(line["speaker_id"]).trim();
-        if (id)
-            ids.add(id);
-    }
-    return ids;
-}
-export function actorIdsInAction(action, speakerToActor) {
+// v3: a dialogue line carries a single inline speaker — an actor ({actor_id})
+// or a non-actor source ({kind, label?}). These read that shape.
+// The actor id behind an action's speaker, or "" for a non-actor / narrative line.
+export function actionActorId(action) {
+    const s = action["speaker"];
+    if (isDict(s) && strOf(s["actor_id"]).trim())
+        return strOf(s["actor_id"]).trim();
+    return "";
+}
+// A human label for the speaker: the actor's name (resolved via `names`), or a
+// non-actor kind's label / kind, or "" when the line has no speaker.
+export function actionSpeakerLabel(action, actorNames) {
+    const s = action["speaker"];
+    if (!isDict(s))
+        return "";
+    const actorId = strOf(s["actor_id"]).trim();
+    if (actorId)
+        return actorNames?.get(actorId) || actorId;
+    const kind = strOf(s["kind"]).trim();
+    if (kind)
+        return strOf(s["label"]).trim() || kind;
+    return "";
+}
+export function actorIdsInAction(action) {
     const ids = new Set();
-    const direct = strOf(action["actor_id"]).trim();
-    if (direct)
-        ids.add(direct);
-    for (const spkId of speakerIdsInAction(action)) {
-        const actor = speakerToActor.get(spkId);
-        if (actor)
-            ids.add(actor);
-    }
+    const id = actionActorId(action);
+    if (id)
+        ids.add(id);
     return ids;
 }
 // Build a grep matcher. /pattern/flags → RegExp, otherwise literal substring.
@@ -718,7 +735,7 @@ export function nameMaps(script) {
     return out;
 }
 export function formatScene(epId, scene, names) {
-    const ctx = isDict(scene["context"]) ? scene["context"] : {};
+    const ctx = sceneRefs(scene);
     const env = isDict(scene["environment"]) ? scene["environment"] : {};
     const space = strOf(env["space"]) || "-";
     const time = strOf(env["time"]) || "-";
@@ -735,9 +752,11 @@ export function formatScene(epId, scene, names) {
         return `${id}(${names.prop.get(id) || "?"})`;
     });
     const actionCount = asList(scene["actions"]).length;
-    return `${epId}/${scene["scene_id"]} [${space} ${time}] location=${locations.join(",") || "-"} actors=${actors.join(",") || "-"} props=${props.join(",") || "-"} actions=${actionCount}`;
+    const { t_start, t_end } = sceneTimeSpan(scene);
+    const timePart = t_start || t_end ? ` t=${t_start || "?"}..${t_end || "?"}` : "";
+    return `${epId}/${scene["scene_id"]} [${space} ${time}] location=${locations.join(",") || "-"} actors=${actors.join(",") || "-"} props=${props.join(",") || "-"} actions=${actionCount}${timePart}`;
 }
-export const HAS_FILTERS = new Set(["state-changes", "transition", "lines"]);
+export const HAS_FILTERS = new Set(["transition", "speaker"]);
 // Resolve a selection (--in range/region selector + --type/--actor/--speaker/
 // --grep/--has predicates, AND-combined) to the matching actions, in document
 // order. The single matcher behind both `actions` queries and selector-driven
@@ -747,7 +766,6 @@ export function resolveActionTargets(script, opts) {
     const selector = parseInSelector(strOf(opts["in"]));
     const typeFilter = strOf(opts["type"]).trim();
     const actorFilter = strOf(opts["actor"]).trim();
-    const speakerFilter = strOf(opts["speaker"]).trim();
     const hasFilter = strOf(opts["has"]).trim();
     // Whitelist --has: silently accepting unknown values means a typo like
     // "state_changes" (underscore) passed the filter-missing guard but bypassed
@@ -762,7 +780,6 @@ export function resolveActionTargets(script, opts) {
         });
     }
     const grepMatcher = buildGrepMatcher(strOf(opts["grep"]));
-    const speakerToActor = (actorFilter || speakerFilter) ? speakerSourceActorMap(script) : new Map();
     const out = [];
     for (const ep of asList(script["episodes"])) {
         const epId = strOf(ep["episode_id"]);
@@ -777,23 +794,14 @@ export function resolveActionTargets(script, opts) {
                 const a = actions[i];
                 if (typeFilter && strOf(a["type"]).trim() !== typeFilter)
                     continue;
-                if (speakerFilter && !speakerIdsInAction(a).has(speakerFilter))
-                    continue;
-                if (actorFilter && !actorIdsInAction(a, speakerToActor).has(actorFilter))
-                    continue;
-                if (hasFilter === "state-changes" && asList(a["state_changes"]).length === 0)
+                if (actorFilter && !actorIdsInAction(a).has(actorFilter))
                     continue;
                 if (hasFilter === "transition" && !isDict(a["transition_prompt"]))
                     continue;
-                if (hasFilter === "lines" && asList(a["lines"]).length === 0)
+                if (hasFilter === "speaker" && !isDict(a["speaker"]))
+                    continue;
+                if (grepMatcher && !grepMatcher(strOf(a["content"])))
                     continue;
-                if (grepMatcher) {
-                    let hay = strOf(a["content"]);
-                    for (const line of asList(a["lines"]))
-                        hay += "\n" + strOf(line["content"]);
-                    if (!grepMatcher(hay))
-                        continue;
-                }
                 out.push({ epId, sceneId, idx: i, action: a });
             }
         }
@@ -804,7 +812,60 @@ export function resolveActionTargets(script, opts) {
 export function selectionHasAnyFilter(opts) {
     return Boolean(!parseInSelector(strOf(opts["in"])).isEmpty ||
         strOf(opts["grep"]) || strOf(opts["type"]).trim() || strOf(opts["actor"]).trim() ||
-        strOf(opts["speaker"]).trim() || strOf(opts["has"]).trim());
+        strOf(opts["has"]).trim());
+}
+// Collapse a set of episode ids into sorted, comma-joined ranges:
+// {ep_001, ep_002, ep_003, ep_007} → "ep_001..ep_003,ep_007". Keeps the state
+// arc / appearance lines readable even when an item spans dozens of episodes.
+export function compactEpisodeRanges(ids) {
+    const nums = [...new Set([...ids])]
+        .map((id) => ({ id, n: idNum(id, "ep") }))
+        .filter((x) => Number.isFinite(x.n))
+        .sort((a, b) => a.n - b.n);
+    if (nums.length === 0)
+        return "";
+    const parts = [];
+    let start = nums[0];
+    let prev = nums[0];
+    const flush = () => parts.push(start.id === prev.id ? start.id : `${start.id}..${prev.id}`);
+    for (let i = 1; i < nums.length; i++) {
+        const cur = nums[i];
+        if (cur.n === prev.n + 1) {
+            prev = cur;
+            continue;
+        }
+        flush();
+        start = cur;
+        prev = cur;
+    }
+    flush();
+    return parts.join(",");
+}
+// One pass over scene context: for each asset id of `kind`, the set of episodes
+// and count of scenes it is referenced in. "Appearance" = presence in a scene's
+// context (the canonical who/what-is-in-this-scene list direct-init populates).
+export function assetAppearanceCounts(script, kind) {
+    const idKey = kind === "actor" ? "actor_id" : kind === "location" ? "location_id" : "prop_id";
+    const pluralKey = kind === "actor" ? "actors" : kind === "location" ? "locations" : "props";
+    const out = new Map();
+    for (const ep of asList(script["episodes"])) {
+        const epId = strOf(ep["episode_id"]);
+        for (const scene of asList(ep["scenes"])) {
+            const ctx = sceneRefs(scene);
+            const seen = new Set();
+            for (const ref of asList(ctx[pluralKey])) {
+                const id = strOf(ref[idKey]);
+                if (!id || seen.has(id))
+                    continue;
+                seen.add(id);
+                const entry = out.get(id) ?? { episodes: new Set(), scenes: 0 };
+                entry.episodes.add(epId);
+                entry.scenes += 1;
+                out.set(id, entry);
+            }
+        }
+    }
+    return out;
 }
 export function listAssetsByKind(script, kind, opts) {
     const lines = [];
@@ -838,19 +899,22 @@ export function listAssetsByKind(script, kind, opts) {
                     // scene. Legacy narrowing is implemented for actor only.
                     if (kind === "actor") {
                         const a = asList(scene["actions"])[single.idx];
-                        const aid = a ? strOf(a["actor_id"]).trim() : "";
+                        const aid = a ? actionActorId(a) : "";
                         if (aid)
                             scopeIds.add(aid);
                     }
                     continue;
                 }
-                const ctx = isDict(scene["context"]) ? scene["context"] : {};
+                const ctx = sceneRefs(scene);
                 for (const ref of asList(ctx[pluralKey])) {
                     scopeIds.add(strOf(ref[idKey]));
                 }
             }
         }
     }
+    // Appearance counts (scenes / episodes) computed in one pass, only when asked
+    // — keeps the default listing lean.
+    const appearances = opts.counts ? assetAppearanceCounts(script, kind) : null;
     for (const asset of asList(script[key])) {
         const id = strOf(asset[idKey]);
         const name = strOf(asset[nameKey]);
@@ -862,14 +926,24 @@ export function listAssetsByKind(script, kind, opts) {
             continue;
         const aliases = asList(asset["aliases"]).map((s) => strOf(s));
         const role = strOf(asset["role_type"]);
+        const importance = strOf(asset["importance"]);
         const descPresent = strOf(asset["description"]).trim() ? "yes" : "missing";
         const states = asList(asset["states"]).length;
         const extra = [];
         if (aliases.length > 0)
             extra.push(`aliases=(${aliases.join(",")})`);
+        if (importance)
+            extra.push(`importance=${importance}`);
         if (role)
             extra.push(`role=${role}`);
         extra.push(`states=${states}`, `description=${descPresent}`);
+        if (appearances) {
+            const seen = appearances.get(id);
+            const eps = seen ? seen.episodes.size : 0;
+            const scns = seen ? seen.scenes : 0;
+            const arc = seen && eps > 0 ? ` episodes=${compactEpisodeRanges(seen.episodes)}` : "";
+            extra.push(`scenes=${scns}`, `episodes_count=${eps}${arc}`);
+        }
         lines.push(`${kind} ${id}: ${name || "-"} ${extra.join(" ")}`);
     }
     return lines;