@lingjingai/scriptctl 0.1.0 → 0.3.0

package/dist/domain/collision-detector.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Asset collision detector for cross-episode incremental drafting.
+ *
+ * When a freshly-parsed fragment declares a new asset (in `## 人物`/`## 场景`/`## 道具`/
+ * `## 发声源`) whose name already exists in the registry, the detector raises a
+ * structured report. The orchestrator (episode subcommand) is expected to surface this
+ * to the agent, which decides among three resolutions:
+ *   - accept_identity: same entity, drop the duplicate declaration (refs use existing id)
+ *   - distinguish_rename: different entity, rename the new one to disambiguate
+ *   - promote_to_state: same entity, different state — add a state to existing asset
+ *
+ * Only exact-name collisions are detected. The kind reflects whether the agent
+ * should treat it as blocking or a warning, based on description similarity:
+ *   - hard: exact name match (description similar enough that it's almost certainly
+ *           the same entity). Blocks commit; expects agent resolution.
+ *   - soft: exact name match but descriptions clearly diverge — could be intentional
+ *           reuse of a generic label (e.g. two unrelated "路人甲"). Warn but don't block.
+ *
+ * The detector is a pure function: it reads the fragment and the registry,
+ * never mutates either.
+ */
+import type { AssetRegistry, AssetType, FragmentLike } from "./asset-registry.js";
+export type CollisionKind = "hard" | "soft";
+export type CollisionResolution = "accept_identity" | "distinguish_rename" | "promote_to_state";
+export interface CollisionReport {
+    kind: CollisionKind;
+    assetType: AssetType;
+    fragmentDeclaration: {
+        name: string;
+        description: string | null;
+        firstSeenScene?: string;
+        firstSeenAction?: string;
+    };
+    registryEntry: {
+        id: string;
+        name: string;
+        description: string | null;
+        firstSeenEpisode: number;
+        firstSeenScene: string;
+        firstSeenAction: string;
+        lastSeenEpisode: number;
+        appearanceCount: number;
+        states: Array<{
+            id: string;
+            name: string;
+        }>;
+        sourceKind?: string;
+    };
+    descriptionSimilarity: number;
+    resolutions: CollisionResolution[];
+}
+export interface DetectCollisionsOptions {
+    /**
+     * Description Jaccard similarity (0..1) below which a `soft` collision is raised
+     * for matching names. Default 0.4 — chosen to flag clearly divergent descriptions
+     * while tolerating natural variance (e.g. "穿灰色西装" vs "灰西装中年男").
+     */
+    softSimilarityThreshold?: number;
+}
+/**
+ * Detect collisions between a freshly-parsed fragment and the existing registry.
+ *
+ * Returns a (possibly empty) list of reports. Caller (episode subcommand) treats:
+ *   - `kind: "hard"` as blocking — agent must resolve before commit
+ *   - `kind: "soft"` as warning — agent should consider but may proceed
+ *   - `kind: "hint"` as info — surfaced for awareness only
+ *
+ * The episode number is taken from `fragment.episode` if available, otherwise
+ * passed via `opts.episode` (caller responsibility).
+ */
+export declare function detectCollisions(fragment: FragmentLike, registry: AssetRegistry, opts?: DetectCollisionsOptions & {
+    episode?: number;
+}): CollisionReport[];
+/**
+ * Whether any report has `kind: "hard"` — convenience for episode.ts commit gating.
+ */
+export declare function hasHardCollision(reports: CollisionReport[]): boolean;
+/**
+ * Render a list of CollisionReports as a human-readable markdown summary suitable
+ * for stderr output. The machine-readable JSON is expected to be written to
+ * `workspace/episodes/ep<n>.collision.json` by the orchestrator.
+ */
+export declare function summarizeReports(reports: CollisionReport[]): string;

package/dist/domain/collision-detector.js

@@ -0,0 +1,248 @@
+/**
+ * Asset collision detector for cross-episode incremental drafting.
+ *
+ * When a freshly-parsed fragment declares a new asset (in `## 人物`/`## 场景`/`## 道具`/
+ * `## 发声源`) whose name already exists in the registry, the detector raises a
+ * structured report. The orchestrator (episode subcommand) is expected to surface this
+ * to the agent, which decides among three resolutions:
+ *   - accept_identity: same entity, drop the duplicate declaration (refs use existing id)
+ *   - distinguish_rename: different entity, rename the new one to disambiguate
+ *   - promote_to_state: same entity, different state — add a state to existing asset
+ *
+ * Only exact-name collisions are detected. The kind reflects whether the agent
+ * should treat it as blocking or a warning, based on description similarity:
+ *   - hard: exact name match (description similar enough that it's almost certainly
+ *           the same entity). Blocks commit; expects agent resolution.
+ *   - soft: exact name match but descriptions clearly diverge — could be intentional
+ *           reuse of a generic label (e.g. two unrelated "路人甲"). Warn but don't block.
+ *
+ * The detector is a pure function: it reads the fragment and the registry,
+ * never mutates either.
+ */
+import { lookupActor, lookupLocation, lookupProp, lookupSpeaker, } from "./asset-registry.js";
+const DEFAULT_SOFT_THRESHOLD = 0.4;
+// ---------------------------------------------------------------------------
+// Similarity scoring (lightweight, dependency-free)
+// ---------------------------------------------------------------------------
+/**
+ * Character-level Jaccard similarity. Trims and normalises punctuation/whitespace.
+ * Tuned for short Chinese/English descriptions (≤ 100 chars), which is the typical
+ * scriptctl asset description length.
+ *
+ * Returns 1.0 when both strings are empty (or one is empty — to avoid false soft
+ * collisions when an existing entry has no description yet).
+ */
+function descriptionSimilarity(a, b) {
+    const aa = (a ?? "").replace(/[\s\p{P}]+/gu, "");
+    const bb = (b ?? "").replace(/[\s\p{P}]+/gu, "");
+    if (aa === "" || bb === "")
+        return 1.0;
+    const setA = new Set([...aa]);
+    const setB = new Set([...bb]);
+    let intersect = 0;
+    for (const ch of setA)
+        if (setB.has(ch))
+            intersect += 1;
+    const union = setA.size + setB.size - intersect;
+    return union === 0 ? 1.0 : intersect / union;
+}
+function classifyMatch(fragmentDesc, registryDesc, softThreshold) {
+    const sim = descriptionSimilarity(fragmentDesc, registryDesc);
+    if (sim < softThreshold)
+        return { kind: "soft", similarity: sim };
+    return { kind: "hard", similarity: sim };
+}
+// ---------------------------------------------------------------------------
+// Entry → report builders
+// ---------------------------------------------------------------------------
+function toRegistryReport(entry) {
+    const base = {
+        id: entry.id,
+        name: entry.name,
+        description: entry.description,
+        firstSeenEpisode: entry.firstSeenEpisode,
+        firstSeenScene: entry.firstSeenScene,
+        firstSeenAction: entry.firstSeenAction,
+        lastSeenEpisode: entry.lastSeenEpisode,
+        appearanceCount: entry.appearanceCount,
+        states: entry.states.map((s) => ({ id: s.id, name: s.name })),
+    };
+    if ("sourceKind" in entry)
+        base.sourceKind = entry.sourceKind;
+    return base;
+}
+function findFragmentFirstSeen(fragment, episode, predicate, actionPicker) {
+    const scenes = fragment.scenes ?? [];
+    for (let i = 0; i < scenes.length; i++) {
+        if (!predicate(i))
+            continue;
+        const sceneNum = typeof scenes[i].scene_num === "number" ? scenes[i].scene_num : i + 1;
+        const sceneId = `ep_${String(episode).padStart(3, "0")}/scn_${String(sceneNum).padStart(3, "0")}`;
+        return { scene: sceneId, action: actionPicker(i) };
+    }
+    return { scene: "", action: "" };
+}
+function locateActorFirstSeen(fragment, episode, name) {
+    return findFragmentFirstSeen(fragment, episode, (i) => (fragment.scenes?.[i]?.actor_names ?? []).includes(name), (i) => {
+        const firstAction = (fragment.scenes?.[i]?.actions ?? []).find((a) => typeof a.content === "string" && a.content.includes(name));
+        return firstAction ? String(firstAction.content ?? "").trim() : "";
+    });
+}
+function locateLocationFirstSeen(fragment, episode, name) {
+    return findFragmentFirstSeen(fragment, episode, (i) => fragment.scenes?.[i]?.location_name === name, (i) => String(fragment.scenes?.[i]?.actions?.[0]?.content ?? "").trim());
+}
+function locatePropFirstSeen(fragment, episode, name) {
+    return findFragmentFirstSeen(fragment, episode, (i) => (fragment.scenes?.[i]?.prop_names ?? []).includes(name), (i) => {
+        const firstAction = (fragment.scenes?.[i]?.actions ?? []).find((a) => typeof a.content === "string" && a.content.includes(name));
+        return firstAction ? String(firstAction.content ?? "").trim() : "";
+    });
+}
+function locateSpeakerFirstSeen(fragment, episode, name) {
+    return findFragmentFirstSeen(fragment, episode, (i) => (fragment.scenes?.[i]?.actions ?? []).some((a) => typeof a.speaker === "string" && a.speaker === name), (i) => {
+        const firstAction = (fragment.scenes?.[i]?.actions ?? []).find((a) => typeof a.speaker === "string" && a.speaker === name);
+        return firstAction ? String(firstAction.content ?? "").trim() : "";
+    });
+}
+function buildReport(kind, assetType, decl, firstSeen, entry, similarity) {
+    const resolutions = assetType === "actor"
+        ? ["accept_identity", "distinguish_rename", "promote_to_state"]
+        : ["accept_identity", "distinguish_rename"];
+    return {
+        kind,
+        assetType,
+        fragmentDeclaration: {
+            name: decl.name,
+            description: decl.description ?? null,
+            firstSeenScene: firstSeen.scene || undefined,
+            firstSeenAction: firstSeen.action || undefined,
+        },
+        registryEntry: toRegistryReport(entry),
+        descriptionSimilarity: similarity,
+        resolutions,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect collisions between a freshly-parsed fragment and the existing registry.
+ *
+ * Returns a (possibly empty) list of reports. Caller (episode subcommand) treats:
+ *   - `kind: "hard"` as blocking — agent must resolve before commit
+ *   - `kind: "soft"` as warning — agent should consider but may proceed
+ *   - `kind: "hint"` as info — surfaced for awareness only
+ *
+ * The episode number is taken from `fragment.episode` if available, otherwise
+ * passed via `opts.episode` (caller responsibility).
+ */
+export function detectCollisions(fragment, registry, opts = {}) {
+    const softThreshold = opts.softSimilarityThreshold ?? DEFAULT_SOFT_THRESHOLD;
+    const episode = opts.episode ?? (typeof fragment.episode === "number" ? fragment.episode : 0);
+    const reports = [];
+    for (const decl of fragment.actors ?? []) {
+        const existing = lookupActor(registry, decl.name);
+        if (existing) {
+            const { kind, similarity } = classifyMatch(decl.description, existing.description, softThreshold);
+            const firstSeen = locateActorFirstSeen(fragment, episode, decl.name);
+            reports.push(buildReport(kind, "actor", decl, firstSeen, existing, similarity));
+        }
+    }
+    for (const decl of fragment.locations ?? []) {
+        const existing = lookupLocation(registry, decl.name);
+        if (existing) {
+            const { kind, similarity } = classifyMatch(decl.description, existing.description, softThreshold);
+            const firstSeen = locateLocationFirstSeen(fragment, episode, decl.name);
+            reports.push(buildReport(kind, "location", decl, firstSeen, existing, similarity));
+        }
+    }
+    for (const decl of fragment.props ?? []) {
+        const existing = lookupProp(registry, decl.name);
+        if (existing) {
+            const { kind, similarity } = classifyMatch(decl.description, existing.description, softThreshold);
+            const firstSeen = locatePropFirstSeen(fragment, episode, decl.name);
+            reports.push(buildReport(kind, "prop", decl, firstSeen, existing, similarity));
+        }
+    }
+    for (const decl of fragment.speakers ?? []) {
+        const existing = lookupSpeaker(registry, decl.name, decl.sourceKind);
+        if (existing) {
+            const { kind, similarity } = classifyMatch(decl.description, existing.description, softThreshold);
+            const firstSeen = locateSpeakerFirstSeen(fragment, episode, decl.name);
+            reports.push(buildReport(kind, "speaker", decl, firstSeen, existing, similarity));
+        }
+    }
+    return reports;
+}
+/**
+ * Whether any report has `kind: "hard"` — convenience for episode.ts commit gating.
+ */
+export function hasHardCollision(reports) {
+    return reports.some((r) => r.kind === "hard");
+}
+// ---------------------------------------------------------------------------
+// Human-readable summary (for CLI stderr output)
+// ---------------------------------------------------------------------------
+/**
+ * Render a list of CollisionReports as a human-readable markdown summary suitable
+ * for stderr output. The machine-readable JSON is expected to be written to
+ * `workspace/episodes/ep<n>.collision.json` by the orchestrator.
+ */
+export function summarizeReports(reports) {
+    if (reports.length === 0)
+        return "";
+    const lines = [`检测到 ${reports.length} 个资产冲突：`, ""];
+    for (let i = 0; i < reports.length; i++) {
+        const r = reports[i];
+        lines.push(`### [${i + 1}/${reports.length}] ${r.kind.toUpperCase()} · ${r.assetType} · "${r.fragmentDeclaration.name}"`);
+        lines.push("");
+        lines.push("新声明：");
+        lines.push(`  名字: ${r.fragmentDeclaration.name}`);
+        if (r.fragmentDeclaration.description) {
+            lines.push(`  描述: ${r.fragmentDeclaration.description}`);
+        }
+        if (r.fragmentDeclaration.firstSeenScene) {
+            lines.push(`  首次出现: ${r.fragmentDeclaration.firstSeenScene}`);
+        }
+        if (r.fragmentDeclaration.firstSeenAction) {
+            lines.push(`  首次动作: ${r.fragmentDeclaration.firstSeenAction}`);
+        }
+        lines.push("");
+        lines.push(`已存在 (${r.registryEntry.id}):`);
+        lines.push(`  名字: ${r.registryEntry.name}`);
+        if (r.registryEntry.description) {
+            lines.push(`  描述: ${r.registryEntry.description}`);
+        }
+        if (r.registryEntry.sourceKind) {
+            lines.push(`  来源类型: ${r.registryEntry.sourceKind}`);
+        }
+        lines.push(`  首次出现: ${r.registryEntry.firstSeenScene} (ep${r.registryEntry.firstSeenEpisode})`);
+        if (r.registryEntry.firstSeenAction) {
+            lines.push(`  首次动作: ${r.registryEntry.firstSeenAction}`);
+        }
+        lines.push(`  最近出现: ep${r.registryEntry.lastSeenEpisode}`);
+        lines.push(`  出现总集数: ${r.registryEntry.appearanceCount}`);
+        if (r.registryEntry.states.length > 0) {
+            lines.push(`  已注册状态: [${r.registryEntry.states.map((s) => s.name).join(", ")}]`);
+        }
+        lines.push(`  描述相似度: ${(r.descriptionSimilarity * 100).toFixed(0)}%`);
+        lines.push("");
+        lines.push("可能处置:");
+        if (r.resolutions.includes("accept_identity")) {
+            lines.push(`  [A] 同一${r.assetType === "actor" ? "人" : "项"}，沿用 ${r.registryEntry.id}`);
+            lines.push(`      → 编辑 ep<n>.md，删除资产段中重复声明，refs 不动`);
+        }
+        if (r.resolutions.includes("distinguish_rename")) {
+            lines.push(`  [B] 不同${r.assetType === "actor" ? "人" : "项"}，需区分`);
+            lines.push(`      → 把这集所有 "${r.fragmentDeclaration.name}" 改名为更具体的名字`);
+        }
+        if (r.resolutions.includes("promote_to_state")) {
+            lines.push(`  [C] 同一人不同形态/装扮`);
+            lines.push(`      → scriptctl script state add actor:${r.registryEntry.id} --state-id <id> --name <name> --description <desc>`);
+        }
+        lines.push("");
+    }
+    lines.push("完整碰撞详情见 workspace/episodes/ep<n>.collision.json");
+    lines.push("解决后重跑：scriptctl episode draft <n> --resume （跳过 Gemini，仅重跑 parser + collisionCheck）");
+    return lines.join("\n");
+}
+//# sourceMappingURL=collision-detector.js.map

package/dist/domain/collision-detector.js.map

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

package/dist/domain/direct-core.d.ts

@@ -86,7 +86,19 @@ export declare function parseOverlapMarkdownLines(content: string, scene: Dict):
     speaker_kind: string;
     content: string;
 }>;
-export declare function parseMarkdownBatch(text: string, batchPlan: Dict): Dict;
+export interface ParseMarkdownBatchOptions {
+    /**
+     * When true, the parser treats input as a single-episode fragment:
+     * - batchPlan fields beyond `episode` may be omitted (sensible defaults applied)
+     * - the `# 资产` section is optional (already accepted by the strict parser, but explicitly tolerated here)
+     * - scene numbers need not start from 1 or be consecutive
+     * - error messages use "fragment" terminology
+     *
+     * Default false preserves existing direct init behavior (zero regression).
+     */
+    fragmentMode?: boolean;
+}
+export declare function parseMarkdownBatch(text: string, batchPlan: Dict, opts?: ParseMarkdownBatchOptions): Dict;
 export declare function expandCompactEpisodeResult(result: Dict, episodePlan: Dict): Dict;
 export declare function compactEpisodeResult(result: Dict): Dict;
 export declare function compactBatchResult(result: Dict): Dict;

package/dist/domain/direct-core.js

@@ -1205,9 +1205,13 @@ export function parseSpeakerRef(raw) {
     if (!value)
         return ["actor", ""];
     if (value.includes(":") || value.includes("：")) {
+        // reSplit only emits the separator slot when the pattern has a capture group;
+        // /[:：]/ doesn't, so the result is ["<kind>", "<name>"] — name lives at [1].
+        // (Earlier code read parts[2], which is always undefined here and silently
+        // dropped the name, leaving e.g. `system:李老板` as ["system", ""].)
         const parts = reSplit(/[:：]/, value, 1);
         const left = parts[0] ?? "";
-        const right = parts[2] ?? "";
+        const right = parts[1] ?? "";
         const kind = _MD_SPEAKER_KIND_NORM[left.trim().toLowerCase()] ?? _MD_SPEAKER_KIND_NORM[left.trim()];
         if (kind)
             return [kind, right.trim()];
@@ -1326,15 +1330,18 @@ export function parseOverlapMarkdownLines(content, scene) {
                 lineContent = pieces.slice(2).join(":");
             }
             else {
+                // reSplit on /[:：]/ (no capture group) emits ["<left>", "<right>"];
+                // the name is at [1], NOT [2]. Same off-by-one pattern that bit
+                // parseSpeakerRef earlier — caught by tests/parser-overlap.test.ts now.
                 const parts = reSplit(/[:：]/, part, 1);
                 rawSpeaker = parts[0] ?? "";
-                lineContent = parts[2] ?? "";
+                lineContent = parts[1] ?? "";
             }
         }
         else {
             const parts = reSplit(/[:：]/, part, 1);
             rawSpeaker = parts[0] ?? "";
-            lineContent = parts[2] ?? "";
+            lineContent = parts[1] ?? "";
         }
         const entry = speakerRefEntry(scene, rawSpeaker);
         lineContent = lineContent.trim();
@@ -1388,8 +1395,11 @@ function applyMarkdownDialogueAnchor(action, scene, rawSpeakerArg, rawTag) {
     if (emotion)
         action["emotion"] = emotion;
 }
-export function parseMarkdownBatch(text, batchPlan) {
-    const label = `${batchPlan["batch_id"] || "batch"} episode ${batchPlan["episode"]} part ${batchPlan["part"]}`;
+export function parseMarkdownBatch(text, batchPlan, opts = {}) {
+    const fragmentMode = opts.fragmentMode === true;
+    const labelKind = fragmentMode ? "fragment" : "batch";
+    const labelPart = batchPlan["part"] === undefined && fragmentMode ? 1 : batchPlan["part"];
+    const label = `${batchPlan["batch_id"] || labelKind} episode ${batchPlan["episode"]} part ${labelPart}`;
     let section = null;
     let assetSubsection = null;
     const scenes = [];
@@ -1603,7 +1613,10 @@ export function parseMarkdownBatch(text, batchPlan) {
         }
     }
     if (scenes.length === 0) {
-        throw _mdInvalid(label, "no scenes parsed; expected '## 场景 N' headers under '# 剧本'");
+        const hint = fragmentMode
+            ? "no scenes parsed in fragment; expected at least one '## 场景 N' header under '# 剧本'"
+            : "no scenes parsed; expected '## 场景 N' headers under '# 剧本'";
+        throw _mdInvalid(label, hint);
     }
     return {
         episode: Number(batchPlan["episode"] ?? 0),