@lingjingai/scriptctl 0.1.0

package/dist/common.js

@@ -0,0 +1,337 @@
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { DEFAULT_STORE, WorkspaceLayout, } from "./infra/storage.js";
+export const EXIT_OK = 0;
+export const EXIT_USAGE = 64;
+export const EXIT_INPUT = 66;
+export const EXIT_RUNTIME = 70;
+export const EXIT_NEEDS_AGENT = 78;
+export const DEFAULT_PROVIDER = "anthropic";
+export const DEFAULT_CONCURRENCY = 30;
+export const DEFAULT_MODEL = "claude-opus-4-6";
+export const DEFAULT_MAX_TOKENS = 32000;
+export const DEFAULT_BATCH_MAX_TOKENS = 16000;
+export const DEFAULT_PROVIDER_ATTEMPTS = 3;
+export const NONSTREAMING_MAX_TOKENS = 20000;
+export const DEFAULT_THINKING_BUDGET_TOKENS = 1024;
+export const DEFAULT_BATCH_TARGET_LINES = 36;
+export const DEFAULT_BATCH_MAX_CHARS = 1800;
+export const DEFAULT_BATCH_MIN_LINES = 12;
+export const DEFAULT_BATCH_MODE = "episode";
+export const DIRECT_REL = path.join("draft", "scriptctl", "direct");
+export const SCRIPT_REL = path.join("output", "script.json");
+export const SUPPORTED_EXTS = ".txt/.md/.docx/.xlsx/.pdf/.json";
+export const REVIEW_TARGETS = ["episode", "asset", "issue"];
+export const DIRECT_CONTRACT_VERSION = 3;
+export const SCRIPT_SCHEMA_VERSION = 2;
+export const WORLDVIEW_VALUES = [
+    "上古时代",
+    "古代历史",
+    "古风架空",
+    "近代民国",
+    "现代",
+    "欧洲中世纪",
+    "赛博朋克",
+    "星际时代",
+    "西幻架空",
+];
+export const ROLE_TYPE_VALUES = ["主角", "配角"];
+export const ACTION_TYPE_VALUES = new Set(["dialogue", "inner_thought", "action"]);
+export const SCRIPT_TARGET_KINDS = new Set(["actor", "location", "prop"]);
+export const SPEAKER_SOURCE_KINDS = new Set([
+    "actor",
+    "location",
+    "prop",
+    "system",
+    "broadcast",
+    "group",
+    "other",
+]);
+export const DELIVERY_VALUES = new Set(["single", "simultaneous", "overlap", "group"]);
+export const EFFECTIVE_FROM_VALUES = new Set(["before_action", "after_action"]);
+export const ACTOR_REUSE_SCENE_LIMIT = 1;
+export const PROP_REUSE_SCENE_LIMIT = 1;
+export const MARKDOWN_BATCH_PROMPT_SPEC = "Output format: a single markdown document with two top-level sections,\n" +
+    "in this exact order. Do NOT wrap the document in fenced code blocks, do\n" +
+    "NOT add prose before or after the document.\n" +
+    "\n" +
+    "# 剧本\n" +
+    "\n" +
+    "## 场景 1\n" +
+    "- 时空: <内|外> <日|夜>\n" +
+    "- 地点: <稳定主空间地点名>[【场景状态】]\n" +
+    "- 角色: <跨场景复用的具体单人角色1>, <角色2>(状态), <角色3>\n" +
+    "- 道具: <需要单独生成并保持一致的prop1>, <prop2>\n" +
+    "\n" +
+    "> [act] 动作或环境描写。\n" +
+    "> [dlg|name] 角色对白原文。\n" +
+    "> [dlg|name|emotion] 带情绪标签的对白。\n" +
+    "> [dlg|system:<发声源名>] 非人物发声源对白。\n" +
+    "> [dlg|prop:<道具名>] 道具发声对白。\n" +
+    "> [dlg|broadcast:<广播名>] 广播 / 喇叭发声对白。\n" +
+    "> [dlg|<speaker1>/<speaker2>|simultaneous] 多人同时说同一句。\n" +
+    "> [dlg|overlap] <speaker1>:<line1> / <speaker2>:<line2>\n" +
+    "> [think|name] 角色心声/内心独白。\n" +
+    "\n" +
+    "## 场景 2\n" +
+    "...\n" +
+    "\n" +
+    "# 资产\n" +
+    "\n" +
+    "## 人物\n" +
+    "- 具体单人角色名: 简短角色描述\n" +
+    "- 具体单人角色名\n" +
+    "\n" +
+    "## 场景\n" +
+    "- 地点名: 地点用途/氛围\n" +
+    "- 地点名\n" +
+    "\n" +
+    "## 道具\n" +
+    "- 道具名: 道具描述\n" +
+    "- 道具名\n" +
+    "\n" +
+    "## 发声源\n" +
+    "- <发声源名>(system): 声音描述\n" +
+    "- <广播名>(broadcast)\n" +
+    "\n" +
+    "## 人物状态\n" +
+    "- <角色名>|<状态名>: <只描述这个稳定状态的可视资产差异>\n" +
+    "\n" +
+    "## 场景状态\n" +
+    "- <地点名>|<状态名>: <只描述这个稳定状态的可视资产差异>\n" +
+    "\n" +
+    "## 道具状态\n" +
+    "- <道具名>|<状态名>: <只描述这个稳定状态的可视资产差异>\n" +
+    "\n" +
+    "Rules:\n" +
+    "- Extract every scene from Batch Source only. Do not summarize or skip scenes.\n" +
+    "- Each `> [...]` line is one action. The action body is single-line by default;\n" +
+    "  if the source spans multiple lines, append continuation lines directly under\n" +
+    "  the anchor (no `>` prefix, no leading `-` or `#`) — the parser joins them with newlines.\n" +
+    "- For actor dialogue/inner_thought, the speaker name in the anchor must appear\n" +
+    "  in the scene's `- 角色: ...` list.\n" +
+    "- `- 角色:` and `## 人物` are only for concrete single-person character assets\n" +
+    "  that may need reuse across scenes. Crowd/group labels such as 众人, 群众,\n" +
+    "  围观者, 路人们, or 大家 must stay out of actors; use `group:name` speakers\n" +
+    "  or action narration instead.\n" +
+    "- For non-human speech, do not add the source to `- 角色`. Use a typed speaker\n" +
+    "  anchor: `system:name`, `broadcast:name`, `prop:name`, `location:name`,\n" +
+    "  `group:name`, or `other:name`. If a prop/location speaks, also list it in\n" +
+    "  `- 道具:` or `- 地点:` / the asset section.\n" +
+    "- Asset names must be canonical names only. Never include bracketed or\n" +
+    "  parenthesized state/role/status text in actor, location, prop, or speaker\n" +
+    "  names. Put durable traits in descriptions and temporary details in actions.\n" +
+    "- For `- 地点:`, prefer the stable main space. Micro-areas such as doorways,\n" +
+    "  corners, table-side, corridors, or car-front positions stay in action text\n" +
+    "  unless they recur as visually distinct production assets.\n" +
+    "- For `- 道具:`, list only props that need independent visual generation and\n" +
+    "  continuity: plot keys/evidence/weapons/tokens/devices, speaking props,\n" +
+    "  recurring props, or props with durable states. Temporary held objects,\n" +
+    "  background furniture, one-off consumables, passerby objects, and generic\n" +
+    "  set dressing stay in action text only. Props that are unlikely to appear\n" +
+    "  across more than 1 scene should not be promoted to props.\n" +
+    "- Do not create states from scene occurrence notes. A state exists only when it\n" +
+    "  is listed in 人物状态 / 场景状态 / 道具状态. If unsure, do not list a state.\n" +
+    "- States are only persistent, reusable visual variants that need separate\n" +
+    "  assets and can be inherited by later actions. Identity, age, occupation,\n" +
+    "  emotion, posture, action, temporary injury/illness/dirt, transient held\n" +
+    "  objects, local body/equipment details, and mixed A/B labels are not states.\n" +
+    "- A transformation action has two parts: keep the action content as the process\n" +
+    "  description, and use script state-change/transition fields only when a\n" +
+    "  durable later-inherited state actually changes.\n" +
+    "- If multiple speakers say the same line at the same time, emit one line:\n" +
+    "  `[dlg|speaker1/speaker2|simultaneous] content`. Do not split it into two\n" +
+    "  sequential dialogue lines.\n" +
+    "- If multiple speakers talk over each other with different lines, emit one line:\n" +
+    "  `[dlg|overlap] speaker1:content1 / system:source:content2`. Use typed\n" +
+    "  prefixes for non-human speakers inside overlap lines too.\n" +
+    "- Action content must be copied verbatim from Batch Source — do not paraphrase,\n" +
+    "  translate, summarize, or add commentary.\n" +
+    "- When a single source line packs multiple semantic parts (e.g. a speaker label\n" +
+    "  `Name(emotion):`, the spoken line, and a parenthetical translation/aside), put\n" +
+    "  only the spoken line into the action content. The speaker name belongs after\n" +
+    "  `dlg|`, the emotion belongs after `dlg|name|`. Translations/asides in\n" +
+    "  parentheses must be discarded.\n" +
+    "- For action narration prefixed with ▲ △ or 【字幕/音效/特效/屏幕字/...】, the action\n" +
+    "  content is the narration body without the bracket label. Spoken system,\n" +
+    "  broadcast, prop, location, or group voices are dialogue, not action.\n" +
+    "- Do not invent dialogue or actions not present in Batch Source. Do not split a\n" +
+    "  single coherent line into many tiny fragments.\n" +
+    "- Subtitles, sound effects, character captions, and on-screen text use `> [act]`.\n" +
+    "  Never invent action kinds outside act/dlg/think.\n" +
+    "- The 资产 section lists only people/locations/props/speakers that are reusable\n" +
+    "  production assets for this batch's scenes, not every noun that appears.\n" +
+    "  Each item: a name, optionally followed by `: description`.\n" +
+    "  An item without `:` carries no description.\n" +
+    "- Lines marked [meta] in Batch Source are read-only metadata; do not promote\n" +
+    "  them to actions.\n";
+export const METADATA_EXTRACTION_SCHEMA = {
+    type: "object",
+    required: ["confidence", "worldview", "worldview_raw", "actors", "locations", "props"],
+    additionalProperties: false,
+    properties: {
+        confidence: { type: "string", enum: ["high", "medium", "low"] },
+        worldview: { type: "string", enum: WORLDVIEW_VALUES },
+        worldview_raw: { type: "string" },
+        actors: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["actor_id", "role_type", "description"],
+                additionalProperties: false,
+                properties: {
+                    actor_id: { type: "string" },
+                    role_type: { type: "string", enum: ROLE_TYPE_VALUES },
+                    description: { type: "string" },
+                },
+            },
+        },
+        locations: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["location_id", "description"],
+                additionalProperties: false,
+                properties: {
+                    location_id: { type: "string" },
+                    description: { type: "string" },
+                },
+            },
+        },
+        props: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["prop_id", "description"],
+                additionalProperties: false,
+                properties: {
+                    prop_id: { type: "string" },
+                    description: { type: "string" },
+                },
+            },
+        },
+    },
+};
+export const ASSET_CURATION_SCHEMA = {
+    type: "object",
+    required: ["locations"],
+    additionalProperties: false,
+    properties: {
+        locations: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["location_id", "decision", "target_location_id", "reason"],
+                additionalProperties: false,
+                properties: {
+                    location_id: { type: "string" },
+                    decision: { type: "string", enum: ["keep", "merge"] },
+                    target_location_id: { type: ["string", "null"] },
+                    reason: { type: "string" },
+                },
+            },
+        },
+    },
+};
+export const EPISODE_TITLE_EXTRACTION_SCHEMA = {
+    type: "object",
+    required: ["episode_titles"],
+    additionalProperties: false,
+    properties: {
+        episode_titles: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["episode", "title"],
+                additionalProperties: false,
+                properties: {
+                    episode: { type: "integer" },
+                    title: { type: "string" },
+                },
+            },
+        },
+    },
+};
+export class CliError extends Error {
+    title;
+    exitCode;
+    required;
+    received;
+    nextSteps;
+    op;
+    errorCode;
+    hint;
+    constructor(title, message, opts) {
+        super(message);
+        this.name = "CliError";
+        this.title = title;
+        this.exitCode = opts.exitCode;
+        this.required = opts.required ?? [];
+        this.received = opts.received ?? [];
+        this.nextSteps = opts.nextSteps ?? [];
+        this.op = opts.op;
+        this.errorCode = opts.errorCode;
+        this.hint = opts.hint;
+    }
+}
+export function workspaceLayout(workspace) {
+    return new WorkspaceLayout(workspace);
+}
+export function directDir(workspace) {
+    return workspaceLayout(workspace).directDir;
+}
+export function scriptJsonPath(opts) {
+    const v = opts["script_path"] ?? opts["scriptPath"];
+    if (typeof v === "string" && v.length > 0)
+        return v;
+    return SCRIPT_REL;
+}
+export function fmtId(prefix, n) {
+    return `${prefix}_${String(n).padStart(3, "0")}`;
+}
+export function readJson(p) {
+    return DEFAULT_STORE.readJson(p);
+}
+export function writeJson(p, data) {
+    DEFAULT_STORE.writeJson(p, data);
+}
+export function readText(p) {
+    return DEFAULT_STORE.readText(p);
+}
+export function exists(p) {
+    return DEFAULT_STORE.exists(p);
+}
+export function writeText(p, text) {
+    DEFAULT_STORE.writeText(p, text);
+}
+export function deletePath(p) {
+    DEFAULT_STORE.delete(p);
+}
+export function deleteTree(p) {
+    DEFAULT_STORE.deleteTree(p);
+}
+export function copyFile(src, dst) {
+    DEFAULT_STORE.copyToPath(src, dst);
+}
+export function sha256Text(text) {
+    return crypto.createHash("sha256").update(text, "utf-8").digest("hex");
+}
+export function sha256File(p) {
+    const digest = crypto.createHash("sha256");
+    const fd = fs.openSync(p, "r");
+    try {
+        const buf = Buffer.alloc(1024 * 1024);
+        while (true) {
+            const n = fs.readSync(fd, buf, 0, buf.length, null);
+            if (n <= 0)
+                break;
+            digest.update(buf.subarray(0, n));
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return digest.digest("hex");
+}
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

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

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

@@ -0,0 +1,114 @@
+import { CliError } from "../common.js";
+type Dict = Record<string, unknown>;
+export declare const _ZH_DIGITS: Record<string, number>;
+export declare const _EP_HEADER_RE: RegExp;
+export declare const _EP_TITLE_PREFIX_RE: RegExp;
+export declare const _TECHNICAL_EP_TITLE_RE: RegExp;
+export declare const BRACKET_ACTION_LABELS: Set<string>;
+export declare function sceneContext(scene: Dict): Dict;
+export declare function setSceneContext(scene: Dict, context: Dict): void;
+export declare function normalizeDigits(value: string): string;
+export declare function parseEpNumber(raw: string): number | null;
+export declare function episodeNumberFromValue(value: unknown, defaultVal?: number | null): number | null;
+export declare function cleanEpisodeShortTitle(rawTitle: unknown): string;
+export declare function isTechnicalEpisodeTitle(rawTitle: unknown): boolean;
+export declare function formatEpisodeTitle(episodeNum: number, rawTitle: unknown): string | null;
+export declare function extractEpisodeTitleCandidate(header: string): string;
+export declare function buildEpisodePlan(sourceText: string): Dict;
+export declare function cleanName(name: unknown): string;
+export declare function splitEntityState(raw: unknown): [string, string | null];
+export declare function stateLabelError(stateName: unknown): string | null;
+export declare function isStateLabelValid(stateName: unknown): boolean;
+export declare function stateRejectionReason(targetKind: string, stateName: unknown): string | null;
+export declare function isReusableState(targetKind: string, stateName: unknown): boolean;
+export declare function splitNames(raw: string): Array<[string, string | null]>;
+export declare function stripLocationState(location: string): [string, string | null];
+export declare function parseSceneHeader(line: string): Dict | null;
+export declare function lineItemsWithSpans(text: string, base: number): Array<[string, number, number]>;
+export declare function contentSpan(line: string, lineStart: number, content: string): {
+    start: number;
+    end: number;
+};
+export declare function deterministicExtractEpisode(sourceText: string, episodePlan: Dict): Dict;
+export declare function normalizeInt(value: unknown, defaultVal: number): number;
+export declare function validateResultActionTypes(planItem: Dict, result: Dict): void;
+export declare function validateEpisodeExtractionQuality(_sourceText: string, episodePlan: Dict, result: Dict): void;
+export declare function isMetadataLine(line: string): boolean;
+export declare function isSceneLine(line: string): boolean;
+export declare function extractSourceLineAction(line: string, start: number): Dict | null;
+export declare function sourceContentLineRecords(sourceText: string, planItem: Dict): Dict[];
+export declare function episodesNeedingGeneratedTitles(episodePlan: Dict): Dict[];
+export declare function deterministicEpisodeShortTitle(sourceText: string, episode: Dict): string;
+export declare function buildEpisodeTitleContext(sourceText: string, episodePlan: Dict): Dict[];
+export declare function episodeTitleResponseMap(payload: unknown): Map<number, string>;
+export interface ProviderLike {
+    name?: string;
+    extractEpisode?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
+    extractBatch?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
+    extractMetadata?(sourceText: string, script: Dict): Promise<Dict> | Dict;
+    extractAssetCuration?(sourceText: string, script: Dict): Promise<Dict> | Dict;
+    extractEpisodeTitles?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
+}
+export declare function enrichEpisodePlanTitles(sourceText: string, episodePlan: Dict, provider: ProviderLike): Promise<Dict>;
+export declare function formatBatchSource(sourceText: string, batchPlan: Dict): string;
+export declare function lineNumberAt(sourceText: string, offset: number): number;
+export declare function batchContextFor(sourceText: string, episode: Dict, start: number): Dict;
+export declare function makeBatch(sourceText: string, episode: Dict, batchIndex: number, part: number, lines: Array<[string, number, number]>): Dict;
+export interface BuildBatchPlanOptions {
+    targetLines?: number;
+    maxChars?: number;
+    minLines?: number;
+    mode?: string;
+}
+export declare function buildBatchPlan(sourceText: string, episodePlan: Dict, opts?: BuildBatchPlanOptions): Dict;
+export declare function validateBatchExtractionQuality(_sourceText: string, batchPlan: Dict, result: Dict): void;
+export declare function recoverBatchFromSource(sourceText: string, batchPlan: Dict): Dict;
+export declare function isRecoverableBatchCliError(exc: CliError): boolean;
+export declare function isRetryableProviderError(exc: unknown): boolean;
+export declare function providerAttempts(): number;
+export declare function providerExtractBatch(provider: ProviderLike, sourceText: string, batch: Dict): Promise<Dict>;
+export declare function providerExtractAssetCuration(provider: ProviderLike, sourceText: string, script: Dict): Promise<Dict>;
+export declare function extractBatchWithRecovery(provider: ProviderLike, sourceText: string, batch: Dict): Promise<Dict>;
+export declare function _md_push_asset(items: Dict[], rawName: string, description: string | null): void;
+export declare function parseSpeakerRef(raw: unknown): [string, string];
+export declare function parseSpeakerAsset(raw: unknown): [string, string];
+export declare function inferNonActorSpeakerKind(name: string, scene?: Dict | null): string;
+export declare function normalizeDeliveryToken(value: unknown): string;
+export declare function contentHasSpeakerPrefix(content: string, speakerNames: Set<string>): boolean;
+export declare function splitSpeakerRefs(raw: unknown): string[];
+export declare function speakerRefEntry(scene: Dict, rawSpeaker: unknown, defaultKind?: string): {
+    speaker: string;
+    speaker_kind: string;
+} | null;
+export declare function applyDialogueSpeaker(action: Dict, scene: Dict, rawSpeaker: unknown, defaultKind?: string): void;
+export declare function parseOverlapMarkdownLines(content: string, scene: Dict): Array<{
+    speaker: string;
+    speaker_kind: string;
+    content: string;
+}>;
+export declare function parseMarkdownBatch(text: string, batchPlan: Dict): Dict;
+export declare function expandCompactEpisodeResult(result: Dict, episodePlan: Dict): Dict;
+export declare function compactEpisodeResult(result: Dict): Dict;
+export declare function compactBatchResult(result: Dict): Dict;
+export declare function normalizeEpisodeResult(result: Dict, episodePlan: Dict): Dict;
+export declare function _normalize_speaker_list(items: unknown): Dict[];
+export declare function uniqueAdd(order: string[], value: string): void;
+export declare function clipText(text: unknown, limit?: number): string;
+export declare function sceneExample(scene: Dict, limit?: number): string;
+export declare function buildMetadataContext(script: Dict): Dict;
+export declare function deterministicExtractMetadata(script: Dict): Dict;
+export declare function applyMetadataToScript(script: Dict, metadata: Dict): void;
+interface AssetUsage {
+    episodes: Set<string>;
+    scenes: Set<string>;
+}
+export declare function sceneAssetUsage(script: Dict, refKey: string, idKey: string): Map<string, AssetUsage>;
+export declare function buildAssetCurationContext(script: Dict): Dict;
+export declare function locationUsageExamples(script: Dict, locationId: string): Dict[];
+export declare function applyLocationMerges(script: Dict, replacements: Map<string, string>): void;
+export declare function actorCurationDecisions(script: Dict): Dict[];
+export declare function propCurationDecisions(script: Dict): Dict[];
+export declare function normalizeAssetCuration(script: Dict, rawCuration: unknown): Dict;
+export declare function curateScriptAssets(script: Dict, rawCuration?: unknown): Dict;
+export declare function mergeEpisodeResults(results: Dict[], title: string): Dict;
+export {};