@lingjingai/scriptctl 0.13.1 → 0.15.0

package/dist/domain/collision-detector.js

@@ -1,248 +0,0 @@
-/**
- * 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

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

package/dist/infra/default-writing-prompt.d.ts

@@ -1,31 +0,0 @@
-/**
- * Default writing prompt bundled with scriptctl.
- *
- * Used by `scriptctl episode draft` when the caller does not pass
- * `--prompt-template <path>`.
- *
- * The actual prompt lives in the sibling `default-writing-prompt.md` so the
- * content stays markdown — readable in editors, diffable, and editable by
- * non-engineers (编剧 / 业务). This TS file only:
- *
- *   1. Loads the .md at module-init time.
- *   2. Substitutes the `<!-- MARKDOWN_BATCH_PROMPT_SPEC -->` placeholder with the
- *      authoritative spec from `common.ts` (single source of truth for the
- *      parser-acceptable grammar — same spec consumed by `direct init`).
- *
- * The .md is copied to `dist/infra/` by the package's build script so the
- * shipped npm package contains it; vitest reads the source .md directly.
- */
-export declare const SPEC_PLACEHOLDER = "<!-- MARKDOWN_BATCH_PROMPT_SPEC -->";
-/**
- * Substitute the `<!-- MARKDOWN_BATCH_PROMPT_SPEC -->` placeholder (if present) in
- * any prompt template body with the authoritative parser spec. Returns the body
- * unchanged when the placeholder is absent — that's fine for templates that
- * hard-code the spec themselves.
- *
- * Used both by the bundled default prompt loader and by --prompt-template, so
- * skill-supplied templates can use the same placeholder mechanism and stay in
- * sync with the parser as the spec evolves.
- */
-export declare function injectSpec(promptBody: string): string;
-export declare const DEFAULT_WRITING_PROMPT: string;

package/dist/infra/default-writing-prompt.js

@@ -1,50 +0,0 @@
-/**
- * Default writing prompt bundled with scriptctl.
- *
- * Used by `scriptctl episode draft` when the caller does not pass
- * `--prompt-template <path>`.
- *
- * The actual prompt lives in the sibling `default-writing-prompt.md` so the
- * content stays markdown — readable in editors, diffable, and editable by
- * non-engineers (编剧 / 业务). This TS file only:
- *
- *   1. Loads the .md at module-init time.
- *   2. Substitutes the `<!-- MARKDOWN_BATCH_PROMPT_SPEC -->` placeholder with the
- *      authoritative spec from `common.ts` (single source of truth for the
- *      parser-acceptable grammar — same spec consumed by `direct init`).
- *
- * The .md is copied to `dist/infra/` by the package's build script so the
- * shipped npm package contains it; vitest reads the source .md directly.
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { MARKDOWN_BATCH_PROMPT_SPEC } from "../common.js";
-export const SPEC_PLACEHOLDER = "<!-- MARKDOWN_BATCH_PROMPT_SPEC -->";
-/**
- * Substitute the `<!-- MARKDOWN_BATCH_PROMPT_SPEC -->` placeholder (if present) in
- * any prompt template body with the authoritative parser spec. Returns the body
- * unchanged when the placeholder is absent — that's fine for templates that
- * hard-code the spec themselves.
- *
- * Used both by the bundled default prompt loader and by --prompt-template, so
- * skill-supplied templates can use the same placeholder mechanism and stay in
- * sync with the parser as the spec evolves.
- */
-export function injectSpec(promptBody) {
-    if (!promptBody.includes(SPEC_PLACEHOLDER))
-        return promptBody;
-    return promptBody.replace(SPEC_PLACEHOLDER, MARKDOWN_BATCH_PROMPT_SPEC);
-}
-function loadBundledPrompt() {
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const mdPath = path.join(here, "default-writing-prompt.md");
-    const raw = fs.readFileSync(mdPath, "utf-8").trim();
-    if (!raw.includes(SPEC_PLACEHOLDER)) {
-        throw new Error(`default-writing-prompt.md is missing the "${SPEC_PLACEHOLDER}" placeholder; ` +
-            `the bundled prompt cannot embed the format spec.`);
-    }
-    return injectSpec(raw);
-}
-export const DEFAULT_WRITING_PROMPT = loadBundledPrompt();
-//# sourceMappingURL=default-writing-prompt.js.map

package/dist/infra/default-writing-prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"default-writing-prompt.js","sourceRoot":"","sources":["../../src/infra/default-writing-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qCAAqC,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9D,OAAO,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,6CAA6C,gBAAgB,iBAAiB;YAC5E,kDAAkD,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/infra/default-writing-prompt.md

@@ -1,115 +0,0 @@
-# Role: 微短剧编剧（scriptctl spec-md 输出版）
-
-## Profile
-国内竖屏 90 秒微短剧资深编剧。按集纲逐集写出可被下游 parser 直接消费的结构化 markdown 剧本。强调：**大纲定动作骨架，原文（如有）抓灵魂血肉**；**角色 + 结构双核心驱动**；**冲突层层升级**；**台词去水、动作化、视听可拍**；杜绝模板腔、说明文、心理活动描写。
-
-## Goals
-接收【当前集集纲】+【项目上下文（设定 / 改编方案 / 原文 / 上一集尾部）】+【已存在角色清单】，输出该集的 spec-md 剧本片段，让下游 parser 零容忍解析通过。
-
-## 输出格式（硬约束，偏离即 parse 失败）
-
-整个输出**只包含一份 markdown 文档**，**两个**顶层段：先 `# 剧本`、后 `# 资产`。
-**不要**用 ``` 围栏包裹文档，**不要**在 `# 剧本` 之前或 `# 资产` 之后写说明文字。
-**不要**输出 `第X集：副标题` 这类首行标题（集号 / 标题由上层 batch_plan 注入）。
-
-<!-- MARKDOWN_BATCH_PROMPT_SPEC -->
-
-## 单集篇幅与节奏（必须暗含，正文不写区块名）
-
-- 常规集：800-1000 字（约 90 秒）；黄金三章（第 1-3 集）可放宽到 1200 字
-- 三段式 + 五大模块（**正文不写区块名 / 不写"黄金开场""矛盾拉扯""极限卡点"等提示语**）：
-  - **前 15% 黄金开场**：
-    - ① 黄金钩子（前 5-10 秒）：开场即高潮，强视觉冲击或反常悬念，**不铺垫背景**
-    - ② 明确目标（10-30 秒）：主角用一句台词或动作让观众知道"这集要干什么"
-  - **中间 70% 矛盾拉扯**：
-    - ③ 密集冲突：每 10-15 秒至少一次小对抗或转折；信息差驱动反派打压与主角见招拆招交替
-    - **层层对抗升级**：单集至少 2-3 次"对抗升级点"（筹码加大 / 场域更公开 / 代价更真实 / 规则更硬 / 底牌被迫亮出）。升级形态随剧情选择，**不固定**为"嘴炮→羞辱→肢体"等单一路径
-  - **后 15% 极限卡点**：
-    - ④ 反转节点（倒数 15 秒）：引爆本集爽点或痛点，用前文伏笔或硬筹码打破预期
-    - ⑤ 极限悬念（最后 3-5 秒）：卡在威胁升级 / 身份揭秘 / 巴掌将落未落的一瞬间戛然而止
-- 分场默认 1-4 场（正戏场次）；闪回不计入正戏场次，必须极短、只服务信息差 / 名场面，**不得用闪回注水**
-- 切场判定基线：**只由时空变化决定**。同一时空内连续动作、连续对峙、连续情绪推进默认保持同一场
-
-## 条件性硬约束（按本集标签 / 输入材料启用）
-
-### 若属黄金三章（第 1-3 集）
-
-- 第 1 集：3 秒内完成"代入 + 冲突 + 钩子"闭环；四锚点（我是谁 / 我有什么 / 我要干什么 / 搞砸了会怎样）用 ≤2 句大白话传递；前 10 秒至少 2 条信息通道同步
-- 第 2 集：展示 + 认同。缺陷接地气，不要完美应对；通过行动暴露规则，**禁止 OS 大段解释**
-- 第 3 集：爽点 + 伏笔。爽点来自主角自身能力，不是纯系统开挂；爽点后必须有三层反馈（环境 + 他人 + 自我）
-- 每集开场必须强力呼应上一集结尾钉子
-
-### 若属付费卡点集（集纲标了【付费卡点】）
-
-- 付费集卖点必须是全剧前期最强爽点之一（逆袭 / 身份揭露 / 情感反转 / 决裂 / 终极打脸）
-- 结尾钉子必须是全剧前期最强悬念，让观众"不付费睡不着"
-- 写作质量与黄金三章同等，不可降低标准
-
-### 若提供原著 / 分析报告（骨肉融合法则）
-
-- 严格按集纲的**微观事件链**推进，不能跑题、不能加支线、不能拖延卡点
-- 原著只用于"血肉"：提取角色的毒舌金句 / 标志动作 / 特殊道具 / 说话习惯
-- 把原著的文学描写改成摄影机可拍的动作与细节
-- 原著**不能反向推翻集纲**；如发现矛盾，**先按集纲写**，矛盾点不在正文里解释
-
-## 角色 + 结构双核（写作时必须暗含，不加额外表格）
-
-- **标签化出场**：角色出场前 5 秒，用标志动作 / 字幕 / 核心台词立住人设标签
-  - 首次出场建议带 1 个核心人设标签（5 秒识人），例如：`> [act] 字幕：韩阳，画传集团总裁/狠厉果决`
-- **主角法则**：主角必须有缺陷与成长趋势（前期隐忍 / 后期狠辣等），所有行为由"目标导向"驱动
-- **对手法则**：对手能力匹配主角；行动步骤严密；阴谋必须咬住主角核心利益（名声、岗位、孩子、证据、生命线）
-- **伙伴法则**：只提供功能性帮助（情报 / 门槛 / 武力 / 程序），不抢主角高光
-- **爱情伙伴**（如有）：暗含"相识→互补→互助→共谋→误会→决裂→患难→真情"的推进（不写成标题）
-
-## 台词极简与动作化（强制硬指标）
-
-- 🔴 **单人单次对白 ≤ 40 字**（最重要的硬约束，超过即视为不合格）
-- 🔴 单句台词超过 20 字时**必须**配动作（紧跟一行 `> [act]` 或在 `> [dlg]` 锚点前后插动作锚点）；避免一口气站桩输出
-- 🔴 每句核心台词前后必须有可拍动作或道具交互；能砸文件 / 按住 / 夺走 / 推开 / 撕毁 / 锁门 / 当众逼签，**就不要"讲道理"**
-- 拒绝说教、寒暄、水词；每句要带身份、习惯、目的（称呼、口头禅、句式）
-- 角色互换台词检测：把这句话换给别的角色说，是否违和？违和才说明人设立住
-- 情绪 / 神态用 `> [dlg|名字|情绪]` 的第三段标签（如 `冷笑` / `喘息` / `愤怒`），**不要**写括号内动作
-- 不要堆"金句大全"，每句落到当下事件链
-- 单集对白行 : 动作行 ≈ 6:4 至 5:5；每集至少 15-20 句有实质内容的人物台词；**不允许连续 3 个以上 `> [act]` 画面行**，必须用 `> [dlg]` 打断
-
-## 冲突层层升级（硬指标）
-
-- 🔴 单集内**至少 2-3 次"对抗升级点"**：筹码加大 / 场域更公开 / 代价更真实 / 规则更硬 / 底牌被迫亮出
-- 优先把冲突落到"行动阻拦"（抢 / 拦 / 按 / 撕 / 摔 / 锁门 / 举报 / 扣证据 / 当众逼签）
-- 优先把对抗落到"规则与程序"（单位流程 / 计生 / 处分 / 证据链 / 公开通报）
-- 优先把胜负落到"硬筹码"（证据、名额、文件、录音、印章、诊断单、检举信）
-- 优先"当众发生"：能公开就公开（围观 = 压迫感 = 爽点放大）
-- 升级形态随剧情选择，**不固定**单一路径；但必须让观众感觉对抗在加码、风险在变大
-- 缓冲集允许更软，但也要有明确对抗动作与信息增量；**禁止整集只聊天无推进**
-
-## 绝对视听转化（反小说化清单）
-
-- 只写镜头能拍到、麦克风能录到的内容
-- 🔴 禁止"觉得 / 认为 / 心里 / 忽然明白"等不可拍心理句
-- ❌ "她内心翻江倒海" / "他陷入沉思" / "脑海中闪过往事"
-- ❌ "她不知道的是…" / "命运的齿轮开始转动…" / "暴风雨即将来临…"
-- ❌ "眼中闪过一丝复杂的情绪" / "空气仿佛凝固" / "时间静止"
-- ❌ 抒情式过渡句、起承转合解说、"本集讲了什么"摘要句
-- ❌ 心理总结、长定语堆叠
-- ❌ 站桩对话（一口气说一大段不带动作）
-- 允许 `> [think|名字]` 内心独白，但仅用于揭示**关键信息差**，且**要短**
-- 闪回必须用 `> [act] 闪回开始` … `> [act] 闪回结束` 明确标注，且仅服务信息差 / 名场面
-
-## 资产登记规则
-
-- `## 人物 / 场景 / 道具 / 发声源` 只列**本集首次出现且需要跨场景复用**的项；单场临时角色 / 背景家具 / 一次性消耗品**不进**资产段
-- 已存在角色清单里的项，**仅在 ref 处用名字**（如 `> [dlg|苏景行] 台词`），**不重复登记到 `## 人物` 段** — 重复登记会被 collision detector 拦截，导致 draft 失败
-- 名字必须是规范实体名（不夹括号状态 / 身份 / 情绪 / 动作注解）
-- 群体词（众人 / 群众 / 围观者 / 路人们 / 大家）**不进** `## 人物`，用 `group:名字` 发声源或留在 `> [act]` 文本里
-- 非人发声（系统提示音 / 广播 / 道具说话）用 `> [dlg|system:名字]` / `> [dlg|broadcast:名字]` / `> [dlg|prop:名字]`，**不要**当成 actor 登记
-
-## 输出纪律
-
-- 直接以 `# 剧本` 开头输出，不要写解释 / 计划 / 自检报告 / 节奏标签 / 起承转合解说
-- 不要用 ``` 围栏包整份文档（`# 剧本` / `# 资产` 是固定章节标题，不是代码块）
-- 不要在正文里写"黄金开场 / 矛盾拉扯 / 极限卡点"这类区块名
-- 不要输出 `第X集：副标题` 等首行标题
-- 严格按集纲的事件骨架与结尾钩子推进，不加支线、不拖延卡点
-- 每集必须完整落地"开场段钩子 → 过程推进 → 过程段核心兑现 → 结尾挂点"，**不得**用简化版 / 摘要版 / 梗概化正文冒充完成稿
-- 每集结尾必须有强钩子（结局集除外，结局集需要回收伏笔和余韵）
-- 已存在角色清单中的角色，**只在 ref 处用名字，不重复登记到 `## 人物`**

package/dist/infra/gemini-writer.d.ts

@@ -1,107 +0,0 @@
-/**
- * Episode drafting via configured provider.
- *
- * `gemini-writer` is the bridge between scriptctl's `episode draft` orchestrator and
- * the underlying provider. It does two things:
- *
- *   1. **Context assembly** — takes an agent-supplied list of reference files
- *      (`refs: [{title, path}, ...]`) plus the per-episode outline, reads them off
- *      disk, and composes a single prompt string conforming to the writing-prompt
- *      template. scriptctl itself knows nothing about anchor.md / analysis-workspace /
- *      adaptation-workspace etc. — those names belong to whichever SKILL is calling.
- *   2. **Provider invocation** — calls `provider.complete(prompt)` and returns raw
- *      markdown for downstream parsing.
- *
- * The only files scriptctl looks up *automatically* are inside its own writing
- * directory (`<workspace>/episodes/`): the per-episode outline (when default
- * template is used) and the previous episode's body (for style continuity).
- * Everything else must be passed in via `refs`.
- */
-import type { AssetRegistry } from "../domain/asset-registry.js";
-export interface RefDeclaration {
-    title: string;
-    path: string;
-    /** When true, missing file is silently skipped; when false, missing file throws. Default true. */
-    optional?: boolean;
-}
-export interface ContextBlock {
-    title: string;
-    body: string;
-}
-export interface WriterContext {
-    outlineText: string;
-    refBlocks: ContextBlock[];
-    previousEpisodeBody?: string;
-}
-export interface WriterRequest {
-    episode: number;
-    context: WriterContext;
-    registry: AssetRegistry;
-    /** Content of the writing-prompt template (e.g. `gemini-writing-prompt-perf.md`). */
-    promptTemplate: string;
-    /** When retrying after parser failure, inject the parser's error report. */
-    parserErrorFeedback?: string;
-    /** Optional override for the max tokens budget. */
-    maxTokens?: number;
-}
-export interface WriterResponse {
-    raw: string;
-    prompt: string;
-}
-export interface CompletionProvider {
-    complete(prompt: string, maxTokens?: number): Promise<string>;
-}
-/**
- * Substitute `{NN}` placeholder in a path template with the given 2-digit-padded
- * episode number. `{NN}` is the only form scriptctl uses anywhere.
- */
-export declare function resolveTemplate(template: string, episode: number): string;
-/**
- * Parse one `--ref "<title>=<path>"` CLI argument into a RefDeclaration. The agent
- * passes labels in the same language they want them to appear in the prompt; the
- * label becomes the `## <label>` heading in the assembled prompt.
- */
-export declare function parseRefArg(raw: string): RefDeclaration;
-/** Dedupe a list of refs by title; later entries win. */
-export declare function dedupeRefs(refs: RefDeclaration[]): RefDeclaration[];
-/**
- * Assemble the full prompt for one `episode draft` call.
- *
- * Sections (in order):
- *   1. The writing-prompt template (output format + creative rules)
- *   2. 已存在资产清单 (collision prevention — auto from scriptctl-owned registry)
- *   3. Agent-supplied reference blocks (anchor / setup / adaptation plan / ...)
- *   4. **当前集集纲** (the episode-specific outline, REQUIRED)
- *   5. Optional parser feedback (when retrying after a failed parse)
- *   6. Footer reminder
- */
-export declare function composePrompt(req: WriterRequest): string;
-export interface LoadContextOptions {
-    /** Workspace root (scriptctl's own output dir; default `workspace`). */
-    workspace: string;
-    /** Episode number being drafted. */
-    episode: number;
-    /**
-     * Outline path (may contain `{NN}` placeholder). Resolved relative to CWD unless
-     * absolute. If omitted, defaults to `<workspace>/episodes/ep<NN>.outline.md`.
-     */
-    outlineTemplate?: string;
-    /** Reference blocks to inject (agent-supplied via --ref). */
-    refs: RefDeclaration[];
-}
-/**
- * Read the outline + all declared refs + the previous-episode tail (when present).
- *
- * Throws Error (caller wraps in CliError) if the per-episode outline can't be
- * located: the writer must have something to write _from_.
- *
- * Missing optional refs are silently skipped. Missing required refs (optional:false)
- * throw.
- */
-export declare function loadWriterContext(opts: LoadContextOptions): WriterContext;
-/**
- * Compose the prompt + invoke the provider. Single-shot — retry on parser failure
- * is the orchestrator's responsibility (it constructs a new `WriterRequest` with
- * `parserErrorFeedback` set and calls `draftEpisode` again).
- */
-export declare function draftEpisode(provider: CompletionProvider, req: WriterRequest): Promise<WriterResponse>;