@lingjingai/scriptctl 0.34.0 → 0.36.0

package/dist/domain/direct/stages/source-prepare.js

@@ -1,9 +0,0 @@
-import { stageSourcePrepare } from "../../../usecases/direct.js";
-// Convert the raw source file into source.txt (+ source_manifest.json). Reads:
-// the --source-path file. Writes: workspace/source.txt, source_manifest.json.
-export const sourcePrepareStage = {
-    name: "source-prepare",
-    output: "source_manifest.json",
-    run: (ctx) => stageSourcePrepare(ctx),
-};
-//# sourceMappingURL=source-prepare.js.map

package/dist/domain/direct/stages/source-prepare.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"source-prepare.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/source-prepare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAU;IACvC,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,sBAAsB;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC;CACtC,CAAC"}

package/dist/domain/direct/stages/state-binding.d.ts

@@ -1,2 +0,0 @@
-import type { Stage } from "../stage.js";
-export declare const stateBindingStage: Stage;

package/dist/domain/direct/stages/state-binding.js

@@ -1,9 +0,0 @@
-import { stageStateBinding } from "../../../usecases/direct.js";
-// LLM-assisted scene-level state binding. Reads: ctx.state.script after asset
-// curation. Writes: state_binding.json (+ mutates the in-memory script).
-export const stateBindingStage = {
-    name: "state-binding",
-    output: "state_binding.json",
-    run: (ctx) => stageStateBinding(ctx),
-};
-//# sourceMappingURL=state-binding.js.map

package/dist/domain/direct/stages/state-binding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-binding.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/state-binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAU;IACtC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,oBAAoB;IAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;CACrC,CAAC"}

package/dist/domain/direct/stages/state-curation.d.ts

@@ -1,2 +0,0 @@
-import type { Stage } from "../stage.js";
-export declare const stateCurationStage: Stage;

package/dist/domain/direct/stages/state-curation.js

@@ -1,10 +0,0 @@
-import { stageStateCuration } from "../../../usecases/direct.js";
-// LLM-assisted state catalog compression. Reads ctx.state.script after asset
-// curation, writes state_curation.json, and rewrites scene refs/state_changes
-// before state-binding chooses per-scene states.
-export const stateCurationStage = {
-    name: "state-curation",
-    output: "state_curation.json",
-    run: (ctx) => stageStateCuration(ctx),
-};
-//# sourceMappingURL=state-curation.js.map

package/dist/domain/direct/stages/state-curation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-curation.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/state-curation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,6EAA6E;AAC7E,8EAA8E;AAC9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAU;IACvC,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,qBAAqB;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC;CACtC,CAAC"}

package/dist/domain/direct/stages/validate.d.ts

@@ -1,2 +0,0 @@
-import type { Stage } from "../stage.js";
-export declare const validateStage: Stage;

package/dist/domain/direct/stages/validate.js

@@ -1,10 +0,0 @@
-import { stageValidate } from "../../../usecases/direct.js";
-// Validate the assembled script.initial.json. Reads: script.initial.json.
-// Writes: validation.json. `output: null` — validation is cheap and always
-// re-run so status reflects the latest script.
-export const validateStage = {
-    name: "validate",
-    output: null,
-    run: (ctx) => stageValidate(ctx),
-};
-//# sourceMappingURL=validate.js.map

package/dist/domain/direct/stages/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,0EAA0E;AAC1E,2EAA2E;AAC3E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAU;IAClC,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC;CACjC,CAAC"}

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

@@ -1,313 +0,0 @@
-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 splitLocationState(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;
-    completeText?(request: {
-        system: string;
-        user: string;
-        signal?: AbortSignal;
-    }): Promise<{
-        text: string;
-        raw?: unknown;
-    }> | {
-        text: string;
-        raw?: unknown;
-    };
-    extractEpisode?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
-    extractBatch?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
-    extractMetadata?(sourceText: string, script: Dict): Promise<Dict> | Dict;
-    groupAssets?(script: Dict, contextText: string): Promise<string> | string;
-    curateAssets?(script: Dict, contextText: string): Promise<string> | string;
-    curateStates?(script: Dict, contextText: string): Promise<string> | string;
-    bindStates?(script: Dict, context: Dict): Promise<Dict> | Dict;
-    extractEpisodeTitles?(sourceText: string, plan: Dict): Promise<Dict> | Dict;
-    extractEpisodeSynopsis?(synopses: string[], ctx: Dict): Promise<Dict> | Dict;
-    extractScriptSynopsis?(synopses: string[], ctx: Dict): Promise<Dict> | Dict;
-}
-export declare const DEFAULT_TITLE_CHUNK_SIZE = 10;
-export declare function chunkEpisodesNeedingTitles(episodePlan: Dict, chunkSize: number): Dict[][];
-export declare function applyEpisodeTitlesToPlan(sourceText: string, episodePlan: Dict, generated: Map<number, string>): number[];
-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 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 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;
-/**
- * Parse one single-kind asset document for `scriptctl parse`.
- *
- * The parse workflow is deliberately NOT the write/direct layout: the 正文 md
- * carries only the screenplay (no asset registration at all), and each asset
- * KIND lives in ONE shared file that every subagent appends to —
- * 人物.md / 场景.md / 道具.md / 发声源.md.
- *
- * Primary format = a bullet per asset, with its 外观造型档位（状态）as INDENTED
- * sub-bullets:
- *   - 陈墨: 归国的复仇者          ← 顶级 bullet = 一个资产（: 后是身份/描述）
- *     - 默认: 深色风衣            ← 缩进 sub-bullet = 该资产的一个状态
- *     - 西装: 一身定制西装
- * A flat `- 陈墨|西装: 描述` line is also accepted (self-contained state), so
- * workers can append either way; duplicates are tolerated and collapsed later.
- * 发声源 uses `- name(kind): description` and has no states. Any markdown header
- * (`# 人物` / `## …`) is ignored.
- */
-export declare function parseAssetDoc(text: string, kind: "actors" | "locations" | "props" | "speakers"): Dict;
-export declare function serializeAssetDoc(script: Dict, kind: "actors" | "locations" | "props" | "speakers"): string;
-export declare function serializeMetaDoc(script: Dict): string;
-export declare function expandCompactEpisodeResult(result: Dict, episodePlan: Dict): Dict;
-export declare function compactEpisodeResult(result: Dict): Dict;
-export declare function compactBatchResult(result: Dict): Dict;
-export interface SynopsisReductionPlan {
-    fitsInOnePass: boolean;
-    groups: number[][];
-}
-/**
- * Plan ONE level of the whole-script synopsis reduce.
- *
- * We can only char-group the items we actually have (their lengths are known);
- * a merged group's output length isn't known until the LLM produces it. So this
- * stays single-level and the orchestrator loops — call it on the episode
- * synopses, merge each group, then call it again on the merged outputs until it
- * returns fitsInOnePass, then run the final extractScriptSynopsis on whatever
- * survives. Pure: it never calls the provider.
- *
- * Boundaries: total ≤ threshold (or ≤1 item) → one pass; total ≫ threshold →
- * multiple bounded groups; every item alone already over threshold → no
- * grouping can make progress, so degrade to one pass rather than loop forever.
- */
-export declare function planSynopsisReduction(synopses: string[], thresholdChars: number, groupSize: number): SynopsisReductionPlan;
-export declare function cleanSynopsisList(items: unknown): string[];
-export declare function readCarriedSynopsis(d: Dict): string;
-export declare function sortDeep(value: unknown): unknown;
-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 interface MetadataMdSections {
-    worldviewRaw: string;
-    actors: Map<string, {
-        role: string;
-        description: string;
-    }>;
-    locations: Map<string, string>;
-    props: Map<string, string>;
-}
-export declare function overlayMetadataSections(parsed: MetadataMdSections, script: Dict): Dict;
-export declare function parseGlobalMetadataMd(raw: string): {
-    worldviewRaw: string;
-    protagonistIds: string[];
-};
-export declare function parseAssetDescriptionsMd(raw: string): Map<string, string>;
-export declare function assembleMetadataFromParts(script: Dict, worldviewRaw: string, protagonistIds: string[], descriptionsById: Map<string, string>): 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 type AssetCurationSelection = Partial<Record<AssetKind, readonly string[]>>;
-export declare const ASSET_GROUP_MAX_ITEMS = 8;
-export declare const ASSET_GROUP_MAX_CONTEXT_CHARS = 22000;
-export declare function buildAssetCurationContext(script: Dict, kinds?: readonly AssetKind[], selection?: AssetCurationSelection): Dict;
-export declare function formatAssetCurationContextText(context: Dict): string;
-export declare function buildAssetCurationContextText(script: Dict, kinds?: readonly AssetKind[], selection?: AssetCurationSelection): string;
-export declare function buildAssetGroupingContextText(script: Dict, kind: AssetKind): string;
-export interface AssetCurationChunkOptions {
-    maxItems: number;
-    maxContextChars: number;
-}
-export declare function buildPrimaryAssetCurationChunks(script: Dict, kind: AssetKind, options?: AssetCurationChunkOptions): string[][];
-export declare function extractAssetGroupingExpressions(rawText: string): string[];
-export declare function parseAssetGroupingExpressions(rawText: string): Dict;
-export declare function validateAssetGroupingPlan(script: Dict, kind: AssetKind, rawPlan: Dict): Dict;
-export declare function groupedAssetCurationChunks(script: Dict, kind: AssetKind, groups: readonly Dict[], options?: AssetCurationChunkOptions): string[][];
-export declare function buildAssetCurationRepairContextText(opts: {
-    baseContextText: string;
-    repairSourceKeys: readonly string[];
-    rejectedExpressions: readonly Dict[];
-    acceptedDecisions: readonly Dict[];
-}): string;
-export declare function missingAssetCurationRequiredSourceKeys(script: Dict, rawPlan: unknown): string[];
-export declare function assetCurationAuditCandidateSourceKeys(script: Dict, rawPlan: unknown): string[];
-export declare function assetCurationAuditSourceKeys(script: Dict, rawPlan: unknown): string[];
-export declare function buildAssetCurationAuditContextText(script: Dict, primaryPlan: unknown, selectedSourceKeys?: readonly string[]): string;
-export declare function locationCanonicalizationCandidateSourceKeys(script: Dict, rawPlan: unknown): string[];
-export declare function buildLocationCanonicalizationAuditContextText(script: Dict, rawPlan: unknown, selectedSourceKeys?: readonly string[]): string;
-export declare function assertLocationCanonicalizationPlan(rawPlan: unknown): void;
-export declare function combineLocationCanonicalizationPlan(script: Dict, basePlan: Dict, locationPlan: Dict, allowedNewLocationSources?: 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 extractAssetCurationExpressions(rawText: string): string[];
-export interface RejectedAssetCurationExpression {
-    index: number;
-    raw: string;
-    error: string;
-    source_key: string | null;
-}
-export declare function guessAssetCurationExpressionSourceKey(rawExpression: string): string | null;
-export declare function parseAssetCurationExpressionsTolerant(rawText: string): Dict;
-export declare function parseAssetCurationExpressions(rawText: string): Dict;
-export declare function formatAssetCurationDecisionExpressions(plan: Dict): string;
-export declare function combineAssetCurationExpressionPlans(plans: readonly Dict[]): Dict;
-export declare function combinePrimaryAssetCurationPlans(plans: readonly Dict[]): Dict;
-interface CombineAssetCurationPlanOptions {
-    salvageInvalidAuditSources?: boolean;
-}
-export declare function combineAssetCurationPlans(primaryPlan: Dict, auditPlan: Dict, allowedNewAuditSources?: string[], options?: CombineAssetCurationPlanOptions): Dict;
-export declare function applyAssetCurationPlan(script: Dict, rawPlan: unknown): Dict;
-export declare function applyAssetGroupingDuplicateMerges(script: Dict, rawPlan: unknown): Dict;
-export declare function normalizeAssetCuration(script: Dict, rawCuration: unknown): Dict;
-export declare function curateScriptAssets(script: Dict, rawCuration?: unknown): Dict;
-export declare const STATE_CURATION_MAX_ASSETS = 4;
-export declare const STATE_CURATION_MAX_CONTEXT_CHARS = 28000;
-export interface StateCurationAssetRef {
-    kind: AssetKind;
-    asset_id: string;
-}
-export declare function buildStateCurationContextText(script: Dict, refs?: readonly StateCurationAssetRef[]): string;
-export declare function buildStateCurationChunks(script: Dict, options?: {
-    maxAssets?: number;
-    maxContextChars?: number;
-}): Array<{
-    part_id: string;
-    refs: StateCurationAssetRef[];
-}>;
-export declare function parseStateCurationExpressions(rawText: string): Dict;
-export declare function formatStateCurationDecisionExpressions(plan: Dict): string;
-export declare function stateCurationSourceKeysForRefs(script: Dict, refs: readonly StateCurationAssetRef[]): string[];
-export declare function missingStateCurationRequiredSourceKeys(script: Dict, plan: Dict, requiredKeys?: readonly string[]): string[];
-export declare function assertStateCurationPlan(script: Dict, plan: Dict, requiredKeys?: readonly string[]): Dict;
-export declare function applyStateCurationPlan(script: Dict, rawPlan: Dict): Dict;
-export declare function normalizeStateBindingPlanShape(rawPlan: unknown): Dict | null;
-export declare function ensureDefaultStates(script: Dict): Dict;
-export declare function bindDefaultStateRefsInScript(script: Dict): Dict;
-export declare function buildStateBindingContexts(script: Dict, chunkSize?: number): Dict[];
-interface StateBindingApplyOptions {
-    invalidStateMode?: "reject" | "skip";
-}
-export declare function applyStateBindingPlan(script: Dict, rawPlan: unknown, options?: StateBindingApplyOptions): Dict;
-export type AssetKind = "actor" | "location" | "prop";
-export type CanonicalAssetKey = string;
-export type AssetNormalizationAction = "canonical_merge" | "location_state_from_name" | "location_state_from_time" | "review";
-export interface AssetNormalizationDecision {
-    action: AssetNormalizationAction;
-    kind: AssetKind;
-    from?: string;
-    into?: string;
-    state?: string;
-    episode?: number;
-    scene_num?: number;
-    reason: string;
-}
-export interface AssetNormalizationReport {
-    version: 1;
-    mode: "conservative";
-    summary: {
-        asset_merges: number;
-        location_states_from_names: number;
-        location_states_from_time: number;
-        review_items: number;
-    };
-    decisions: AssetNormalizationDecision[];
-}
-interface MergeEpisodeResultsOptions {
-    bindDefaultStateRefs?: boolean;
-    trackUnresolvedStateRefs?: boolean;
-    assetNormalization?: "conservative" | "off";
-}
-export interface MergeEpisodeResultsWithReportResult {
-    script: Dict;
-    assetNormalization: AssetNormalizationReport;
-}
-export declare function canonicalAssetNameKey(kind: AssetKind, rawName: unknown): CanonicalAssetKey;
-export declare function mergeEpisodeResultsWithReport(results: Dict[], title: string, opts?: MergeEpisodeResultsOptions): MergeEpisodeResultsWithReportResult;
-export declare function mergeEpisodeResults(results: Dict[], title: string, opts?: MergeEpisodeResultsOptions): Dict;
-export {};