@lingjingai/scriptctl 0.31.0 → 0.32.0

package/dist/help-text.js

@@ -115,6 +115,7 @@ Usage
 
 Commands
 - init       Build source manifest, episode plan, initial script, validation.
+- run        Re-run one direct stage, e.g. state-binding or metadata.
 - validate   Validate script.initial.json.
 - review     Proofread the draft: curation/issues, or --episode N for source↔extract.
 - export     Export script.initial.json to the final script store.
@@ -181,11 +182,14 @@ Writes
 - workspace/draft/scriptctl/direct/batch_results/*.json
 - workspace/draft/scriptctl/direct/batch_results/*.error.json
 - workspace/draft/scriptctl/direct/episode_results/*.json
+- workspace/draft/scriptctl/direct/asset_grouping.json
 - workspace/draft/scriptctl/direct/asset_curation.json
+- workspace/draft/scriptctl/direct/state_binding.json
 - workspace/draft/scriptctl/direct/asset_metadata.json (unless --skip-metadata)
 - workspace/draft/scriptctl/direct/script.initial.json
 - workspace/draft/scriptctl/direct/validation.json
 - workspace/draft/scriptctl/direct/run_state.json
+- workspace/draft/scriptctl/direct/timings.json
 
 Exit codes
 - 0   initial script ready
@@ -193,6 +197,54 @@ Exit codes
 - 66  source file unavailable
 - 70  provider or runtime failure
 - 78  initial script written but agent repair is needed
+`,
+    ],
+    [
+        ["direct", "run"],
+        `Re-run one direct pipeline stage against an existing workspace.
+
+Usage
+- scriptctl direct run <stage> [options]
+
+Stages
+- source-prepare
+- episode-plan
+- episode-titles
+- batch-plan
+- batch-extract
+- episode-merge
+- episode-synopsis
+- script-merge
+- asset-curation
+- state-binding
+- metadata
+- script-synopsis
+- validate
+
+Options
+- --workspace-path    Workspace directory. Default: workspace
+- --force             Re-run the stage even when its primary artifact exists.
+- --provider          LLM provider for provider-backed stages. Default: anthropic
+- --model             Provider model. Default: claude-sonnet-4-6-aihubmix
+- --episodes <list>   Force re-run these episodes' batches where relevant.
+- --batches <list>    Force re-run these batch keys where relevant.
+- --retry-errors      Force re-run batches with existing error markers.
+- --skip-metadata     When running metadata, delete asset_metadata.json and mark metadata skipped.
+- --json              Print machine-readable JSON.
+- --help              Show this help.
+
+Notes
+- Script-mutating stages persist script.initial.json when run standalone:
+  script-merge, asset-curation, state-binding, metadata.
+- state-binding writes state_binding.json and updates scene state refs /
+  action state_changes using existing assets and states only.
+
+Exit codes
+- 0   stage completed
+- 64  usage or arguments error
+- 66  required artifact unavailable
+- 70  provider or runtime failure
+- 78  stage wrote diagnostics but agent repair is needed
 `,
     ],
     [
@@ -254,7 +306,7 @@ Exit codes
         `Proofread the direct draft. Read-only; no state side effects.
 
 Usage
-- scriptctl direct review [options]                 # curation decisions + issues (validation + batch failures)
+- scriptctl direct review [options]                 # curation/state-binding decisions + issues
 - scriptctl direct review --episode <n>[,<n>...]    # source.txt ↔ script.initial.json side-by-side per episode
 
 Options
@@ -271,7 +323,9 @@ Notes
 
 Reads
 - workspace/draft/scriptctl/direct/script.initial.json
+- workspace/draft/scriptctl/direct/asset_grouping.json
 - workspace/draft/scriptctl/direct/asset_curation.json
+- workspace/draft/scriptctl/direct/state_binding.json
 - workspace/draft/scriptctl/direct/batch_results/*.error.json
 - workspace/draft/scriptctl/direct/episode_plan.json (--episode)
 - workspace/source.txt (--episode)

package/dist/help-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAuC;IACvD;QACE,EAAE;QACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;CAUH;KACE;IACD;QACE,CAAC,WAAW,CAAC;QACb;;;;;;;;;;;;;;CAcH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;CAeH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;;;;;;CAsBH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,KAAK,CAAC;QACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACpB;;;;;;;;;;;;;;;;;;;CAmBH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,UAAU,CAAC;QACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BH;KACE;IACD;QACE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCH;KACE;IAED,4EAA4E;IAC5E,6CAA6C;IAC7C,4EAA4E;IAE5E;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;;;;;;;;;;;;;;;;;CAyBH;KACE;IACD;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;;;;;;;;;;;;;;CAsBH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;;;CAmBH;KACE;IACD;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;CAeH;KACE;IACD;QACE,CAAC,WAAW,CAAC;QACb;;;;;;;;;;CAUH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;CAUH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;CAeH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;CAiBH;KACE;IACD;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;;;;;;CAcH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;CAgBH;KACE;IACD;QACE,CAAC,MAAM,CAAC;QACR;;;;;;;;;;;;;;;;;;;;;;CAsBH;KACE;IACD;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;;;CAWH;KACE;IAED,4EAA4E;IAC5E,uBAAuB;IACvB,4EAA4E;IAE5E;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;;;;;;;;;;CAkBH;KACE;IACD;QACE,CAAC,MAAM,CAAC;QACR;;;;;;;CAOH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;CAQH;KACE;IACD;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;;;;;;CAcH;KACE;IAED,4EAA4E;IAC5E,kEAAkE;IAClE,4EAA4E;IAE5E;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BH;KACE;IACD;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;;;;;CAqBH;KACE;IACD;QACE,CAAC,MAAM,CAAC;QACR;;;;;;;;;;;;;;CAcH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;;;;;CAcH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;CAUH;KACE;IAED,4EAA4E;IAC5E,8DAA8D;IAC9D,4EAA4E;IAE5E;QACE,CAAC,cAAc,CAAC;QAChB;;;;;;;;;;;;;;;;;;;CAmBH;KACE;IACD;QACE,CAAC,YAAY,CAAC;QACd;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;;;;;CAaH;KACE;IAED,4EAA4E;IAC5E,8BAA8B;IAC9B,4EAA4E;IAE5E;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;;CAWH;KACE;IACD;QACE,CAAC,MAAM,CAAC;QACR;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,WAAW,CAAC;QACb;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;;;;;;CAcH;KACE;IACD;QACE,CAAC,UAAU,EAAE,UAAU,CAAC;QACxB;;;;;;;;;;;;;;;;;;;;;;CAsBH;KACE;IAED;QACE,CAAC,QAAQ,CAAC;QACV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCH;KACE;IAED,4EAA4E;IAC5E,gCAAgC;IAChC,4EAA4E;IAE5E;QACE,CAAC,WAAW,CAAC;QACb;;;;;;;;;;;;;;;;CAgBH;KACE;IACD;QACE,CAAC,cAAc,CAAC;QAChB;;;;;;;CAOH;KACE;IACD;QACE,CAAC,cAAc,CAAC;QAChB;;;;;;;;;;;;;CAaH;KACE;IAED,4EAA4E;IAC5E,kCAAkC;IAClC,4EAA4E;IAE5E;QACE,CAAC,UAAU,CAAC;QACZ;;;;;;;;;;CAUH;KACE;IACD;QACE,CAAC,SAAS,CAAC;QACX;;;;;;;;;CASH;KACE;IACD;QACE,CAAC,aAAa,CAAC;QACf;;;;;;;;;;;;;;;;;CAiBH;KACE;IAED,4EAA4E;IAC5E,6BAA6B;IAC7B,4EAA4E;IAE5E;QACE,CAAC,OAAO,CAAC;QACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BH;KACE;CACF,CAAC;AAEF,SAAS,KAAK,CAAC,OAA0B;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAC3C,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CACtD,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,OAA0B;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC"}

package/dist/infra/providers.d.ts

@@ -5,6 +5,9 @@ export interface ProviderCapabilities {
     extractBatch: boolean;
     extractEpisode: boolean;
     extractMetadata: boolean;
+    groupAssets: boolean;
+    curateAssets: boolean;
+    bindStates: boolean;
     extractEpisodeTitles: boolean;
     extractEpisodeSynopsis: boolean;
     extractScriptSynopsis: boolean;
@@ -22,6 +25,9 @@ export declare class MockProvider implements ProviderLike {
     extractEpisode(sourceText: string, episodePlan: Dict): Dict;
     extractBatch(sourceText: string, batchPlan: Dict): Dict;
     extractMetadata(_sourceText: string, script: Dict): Dict;
+    groupAssets(_script: Dict, contextText: string): string;
+    curateAssets(script: Dict, contextText: string): string;
+    bindStates(_script: Dict, context: Dict): Dict;
     extractEpisodeSynopsis(synopses: string[], _ctx: Dict): Dict;
     extractScriptSynopsis(synopses: string[], _ctx: Dict): Dict;
     extractEpisodeTitles(sourceText: string, episodePlan: Dict): Dict;
@@ -60,6 +66,9 @@ export declare class AnthropicProvider implements ProviderLike {
     }>;
     extractBatch(sourceText: string, batchPlan: Dict): Promise<Dict>;
     extractEpisodeTitles(sourceText: string, episodePlan: Dict): Promise<Dict>;
+    groupAssets(_script: Dict, contextText: string): Promise<string>;
+    curateAssets(_script: Dict, contextText: string): Promise<string>;
+    bindStates(_script: Dict, context: Dict): Promise<Dict>;
     extractMetadata(_sourceText: string, script: Dict): Promise<Dict>;
     private runMetadataMarkdown;
     private collectResponseTextWithRetry;

package/dist/infra/providers.js

@@ -1,12 +1,15 @@
 import Anthropic from "@anthropic-ai/sdk";
-import { CliError, DEFAULT_BATCH_MAX_TOKENS, DEFAULT_MAX_TOKENS, DEFAULT_THINKING_BUDGET_TOKENS, EPISODE_SYNOPSIS_SCHEMA, EPISODE_TITLE_EXTRACTION_SCHEMA, EXIT_RUNTIME, EXIT_USAGE, DEFAULT_METADATA_ASSET_CHUNK, MARKDOWN_BATCH_PROMPT_SPEC, METADATA_DESC_MD_SPEC, METADATA_GLOBAL_MD_SPEC, SCRIPT_SYNOPSIS_SCHEMA, } from "../common.js";
-import { _md_push_asset, _normalize_speaker_list, assembleMetadataFromParts, cleanSynopsisList, buildEpisodeTitleContext, buildMetadataContext, deterministicEpisodeShortTitle, deterministicExtractEpisode, deterministicExtractMetadata, episodesNeedingGeneratedTitles, formatBatchSource, isRetryableProviderError, parseAssetDescriptionsMd, parseGlobalMetadataMd, parseMarkdownBatch, providerAttempts, } from "../domain/direct-core.js";
+import { CliError, DEFAULT_BATCH_MAX_TOKENS, DEFAULT_MAX_TOKENS, DEFAULT_THINKING_BUDGET_TOKENS, EPISODE_SYNOPSIS_SCHEMA, EPISODE_TITLE_EXTRACTION_SCHEMA, EXIT_RUNTIME, EXIT_USAGE, DEFAULT_METADATA_ASSET_CHUNK, MARKDOWN_BATCH_PROMPT_SPEC, METADATA_DESC_MD_SPEC, METADATA_GLOBAL_MD_SPEC, SCRIPT_SYNOPSIS_SCHEMA, STATE_BINDING_SCHEMA, } from "../common.js";
+import { ASSET_GROUP_MAX_ITEMS, _md_push_asset, _normalize_speaker_list, assembleMetadataFromParts, cleanSynopsisList, buildEpisodeTitleContext, buildMetadataContext, deterministicEpisodeShortTitle, deterministicExtractEpisode, deterministicExtractMetadata, episodesNeedingGeneratedTitles, formatBatchSource, formatAssetCurationDecisionExpressions, isRetryableProviderError, parseAssetDescriptionsMd, parseGlobalMetadataMd, parseMarkdownBatch, providerAttempts, } from "../domain/direct-core.js";
 const PROVIDER_CAPABILITIES = {
     mock: {
         completeText: true,
         extractBatch: true,
         extractEpisode: true,
         extractMetadata: true,
+        groupAssets: true,
+        curateAssets: true,
+        bindStates: true,
         extractEpisodeTitles: true,
         extractEpisodeSynopsis: true,
         extractScriptSynopsis: true,
@@ -16,6 +19,9 @@ const PROVIDER_CAPABILITIES = {
         extractBatch: true,
         extractEpisode: true,
         extractMetadata: true,
+        groupAssets: true,
+        curateAssets: true,
+        bindStates: true,
         extractEpisodeTitles: true,
         extractEpisodeSynopsis: true,
         extractScriptSynopsis: true,
@@ -25,6 +31,9 @@ const PROVIDER_CAPABILITIES = {
         extractBatch: false,
         extractEpisode: false,
         extractMetadata: false,
+        groupAssets: false,
+        curateAssets: false,
+        bindStates: false,
         extractEpisodeTitles: false,
         extractEpisodeSynopsis: false,
         extractScriptSynopsis: false,
@@ -169,6 +178,157 @@ export class MockProvider {
     extractMetadata(_sourceText, script) {
         return deterministicExtractMetadata(script);
     }
+    groupAssets(_script, contextText) {
+        const kind = strOf(/^kind:\s*(actor|location|prop)$/m.exec(contextText)?.[1]);
+        const rows = contextText
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => /^(?:A|L|P)\s+\|/.test(line))
+            .map((line) => {
+            const parts = line.split("|").map((part) => part.trim());
+            return { id: parts[1] ?? "", name: parts[2] ?? "" };
+        })
+            .filter((row) => row.id && row.name);
+        const seenNames = new Set();
+        const keptIds = [];
+        for (const row of rows) {
+            const key = row.name.replace(/[\s_\-–—·.,，、:：;；'"“”‘’()[\]{}（）【】《》<>]+/g, "").toLowerCase();
+            if (seenNames.has(key))
+                continue;
+            seenNames.add(key);
+            keptIds.push(row.id);
+        }
+        const expressions = [];
+        for (let index = 0; index < keptIds.length; index += ASSET_GROUP_MAX_ITEMS) {
+            expressions.push(`<group>${kind} ${keptIds.slice(index, index + ASSET_GROUP_MAX_ITEMS).join(" ")} # mock name-order group</group>`);
+        }
+        return expressions.length > 0 ? expressions.join("\n") : `<group>${kind} __empty__ # mock empty group</group>`;
+    }
+    curateAssets(script, contextText) {
+        if (contextText.includes("# Asset Curation Audit Context") || contextText.includes("# Location Canonicalization Audit Context")) {
+            return "<exp>NOOP # no asset curation changes</exp>";
+        }
+        const decisions = [];
+        const actors = asList(script["actors"]).filter(isDict);
+        const locations = asList(script["locations"]).filter(isDict);
+        const props = asList(script["props"]).filter(isDict);
+        const actorByName = new Map();
+        for (const actor of actors) {
+            const name = mockAssetName(actor, "actor");
+            if (name)
+                actorByName.set(name, actor);
+        }
+        for (const actor of actors) {
+            const id = mockAssetId(actor, "actor");
+            const name = mockAssetName(actor, "actor");
+            if (!id)
+                continue;
+            const variant = actorVisualVariant(name);
+            const base = variant ? actorByName.get(variant.baseName) : null;
+            if (variant && base && mockAssetId(base, "actor") !== id) {
+                decisions.push({
+                    kind: "actor",
+                    source_id: id,
+                    decision: "move_to_state",
+                    target_kind: "actor",
+                    target_id: mockAssetId(base, "actor"),
+                    state_name: variant.stateName,
+                    reason: "mock: visual form variant belongs to the base actor state catalog.",
+                });
+                continue;
+            }
+            if (looksLikeGroupSpeaker(name)) {
+                decisions.push({
+                    kind: "actor",
+                    source_id: id,
+                    decision: "move_to_speaker",
+                    speaker_kind: "group",
+                    new_name: name,
+                    reason: "mock: crowd/extra label is a speaker source, not a reusable actor asset.",
+                });
+            }
+            else {
+                decisions.push({
+                    kind: "actor",
+                    source_id: id,
+                    decision: "keep",
+                    reason: "mock: named actor remains an actor asset.",
+                });
+            }
+        }
+        for (const loc of locations) {
+            const id = mockAssetId(loc, "location");
+            const name = mockAssetName(loc, "location");
+            if (!id)
+                continue;
+            const target = locations.find((candidate) => {
+                const candidateId = mockAssetId(candidate, "location");
+                const candidateName = mockAssetName(candidate, "location");
+                return Boolean(candidateId && candidateId !== id && candidateName && candidateName.length < name.length && name.includes(candidateName) && isMicroLocationName(name));
+            });
+            if (target) {
+                decisions.push({
+                    kind: "location",
+                    source_id: id,
+                    decision: "merge",
+                    target_kind: "location",
+                    target_id: mockAssetId(target, "location"),
+                    reason: "mock: micro-location folds into the stable parent location.",
+                });
+            }
+            else {
+                decisions.push({
+                    kind: "location",
+                    source_id: id,
+                    decision: "keep",
+                    reason: "mock: stable location remains a production set.",
+                });
+            }
+        }
+        for (const prop of props) {
+            const id = mockAssetId(prop, "prop");
+            const name = mockAssetName(prop, "prop");
+            if (!id)
+                continue;
+            if (isDisposableOrUiProp(name)) {
+                decisions.push({
+                    kind: "prop",
+                    source_id: id,
+                    decision: "drop",
+                    reason: "mock: disposable UI/screen detail stays in action text.",
+                });
+            }
+            else {
+                decisions.push({
+                    kind: "prop",
+                    source_id: id,
+                    decision: "keep",
+                    reason: "category=signature_instance; mock: hero prop remains explicit.",
+                });
+            }
+        }
+        return formatAssetCurationDecisionExpressions({ decisions });
+    }
+    bindStates(_script, context) {
+        const scenes = [];
+        for (const scene of asList(context["scenes"])) {
+            if (!isDict(scene))
+                continue;
+            const actions = asList(scene["actions"]);
+            const actionText = actions.map((action) => strOf(action["content"])).join("\n");
+            const actors = mockBindingRefs(scene, "actors", "actor_id", actionText);
+            const locations = mockBindingRefs(scene, "locations", "location_id", actionText);
+            const props = mockBindingRefs(scene, "props", "prop_id", actionText);
+            scenes.push({
+                scene_id: scene["scene_id"],
+                actors,
+                locations,
+                props,
+                state_changes: mockStateChanges(scene, actions),
+            });
+        }
+        return { scenes };
+    }
     extractEpisodeSynopsis(synopses, _ctx) {
         // Prefix marks that this deterministic STITCH ran — lets e2e tests tell a
         // real reduce-step call apart from the plain-join fallback (which has no
@@ -409,6 +569,165 @@ export class AnthropicProvider {
             nextSteps: ["Rerun init; title generation will retry before batch extraction."],
         });
     }
+    async groupAssets(_script, contextText) {
+        const prompt = "You plan small asset review groups for `scriptctl direct init`.\n" +
+            "You receive only asset ids and names. Do not make final keep/drop/merge/state decisions.\n" +
+            "\n" +
+            "Rules:\n" +
+            `- Output only <group>...</group> lines, with at most ${ASSET_GROUP_MAX_ITEMS} ids per group.\n` +
+            "- Group ids whose names suggest they should be reviewed together later: same identity/form, alias-like names, same place family, or same prop family.\n" +
+            "- Omit an id only when it is an obvious duplicate of a retained id with the same normalized name. Do not omit merely because an asset seems unimportant.\n" +
+            "- Every non-duplicate id must appear exactly once. Do not invent ids.\n" +
+            "- No JSON, markdown, headings, bullets, or prose outside group tags.\n" +
+            "\n" +
+            "Expression grammar:\n" +
+            "- `<group><kind> <source_id> [source_id...] # reason</group>`\n" +
+            "- `<kind>` is the context kind: actor, location, or prop.\n" +
+            "\n" +
+            "Context:\n" +
+            `${contextText}\n`;
+        const request = this.messageRequest(prompt, 8000);
+        const [raw, stopReason] = await this.collectResponseTextWithRetry(request);
+        if (stopReason === "max_tokens") {
+            throw new CliError("INIT FAILED: Asset grouping output truncated", "Asset grouping output truncated.", {
+                exitCode: EXIT_RUNTIME,
+                required: ["complete asset grouping expressions within provider max_tokens"],
+                received: [`stop_reason: ${stopReason}`, `max_tokens: ${request.max_tokens}`, `raw chars: ${raw.length}`, `tail: ${raw.slice(-160) || "<empty response>"}`],
+                nextSteps: ["Rerun init; completed extraction checkpoints will be reused and asset grouping will retry."],
+                errorCode: "PROVIDER_OUTPUT_TRUNCATED",
+            });
+        }
+        if (!raw.trim()) {
+            throw new CliError("INIT FAILED: Provider returned empty asset grouping", "Provider returned an empty asset grouping response.", {
+                exitCode: EXIT_RUNTIME,
+                required: ["one or more <group> asset grouping expressions"],
+                received: [`stop_reason: ${stopReason || "unknown"}`, "raw chars: 0"],
+                nextSteps: ["Rerun init; completed extraction checkpoints will be reused and asset grouping will retry."],
+                errorCode: "PROVIDER_EMPTY_RESPONSE",
+            });
+        }
+        return raw;
+    }
+    async curateAssets(_script, contextText) {
+        const prompt = "You curate assets for `scriptctl direct init` after batch merge.\n" +
+            "Return only asset curation operation expressions. The caller will parse and apply them deterministically.\n" +
+            "\n" +
+            "Policy:\n" +
+            "- Target profile: align with a human-refined asset boundary for AI short-drama production.\n" +
+            "- Actors: keep named, speaking, visually identifiable, or plot-functional roles even when they appear only once.\n" +
+            "- Move only anonymous crowds, system/broadcast sources, or pure voice labels into speakers.\n" +
+            "- Move Q版 / 幻影 / 兽形 / 本体 / 真身 / 伪装 / alternate visual form actors into states on the base actor.\n" +
+            "- Use `identity=` hints to merge same-identity aliases/forms/titles when evidence supports it; do not keep duplicate base/form actors apart.\n" +
+            "- Merge duplicate names, aliases, typo variants, and same-identity titles into stable canonical assets.\n" +
+            "- Locations: keep visually distinct production sets; do not blindly merge interiors, doors, rooftops, underground levels, warehouses, fields, pens, sky/air variants, or other shootable sub-spaces.\n" +
+            "- Use `parent=` and `gran=` hints to MERGE non-distinct doorway/transition/nearby/overhead/angle-only micro locations into a parent; KEEP distinct shootable subspaces.\n" +
+            "- Location canonical names should preserve world/domain scope when the context distinguishes worlds or realms.\n" +
+            "- If a location co-occurs with a scope marker such as a world/realm/domain location, prefer `renameHint=` scoped canonical names via RENAME when the unscoped name would be ambiguous.\n" +
+            "- Props: use a strict refined prop boundary. Most visible or plot-mentioned objects should stay in action text or actor/location state, not standalone props.\n" +
+            "- Default prop decision is DROP unless standalone continuity is clear.\n" +
+            "- KEEP a prop when it is a named/signature physical instance whose visual identity must be reused, the same object is exchanged/carried/inspected across scenes, it carries readable evidence/rules/secrets, drives a transformation/conflict, functions as recurring character/faction equipment, or is a functional set device with continuity.\n" +
+            "- Every KEEP prop reason must start with one category: category=readable_evidence; category=container_device; category=transformation_key; category=exchanged_object; category=signature_instance; category=character_bound_core; category=signature_weapon; category=visual_symbol; or category=set_device; then cite concise evidence.\n" +
+            "- Do not KEEP merely because an object appears multiple times, is plot-functional, held/used by a character, or is UI/display content, an ordinary document/bill, food, or generic set dressing.\n" +
+            "- Move actor body marks and worn appearance into actor states; detachable named devices/weapons/tools/accessories with standalone continuity may remain props.\n" +
+            "- When a prop line has `ownerA=actor_id:name`, distinguish body/worn styling (STATE) from detachable recurring core objects (KEEP with category=character_bound_core or category=signature_weapon).\n" +
+            "- In long scripts, keep a compact prop catalog; prefer the strongest standalone hero props and DROP/STATE borderline objects.\n" +
+            "- For each duplicate group, choose one final canonical target (prefer higher scene_count, then shorter stable name); merge every other source directly into that final target.\n" +
+            "- MERGE is for same-kind duplicates. For actor/location entries that are really props, use PROP instead of cross-kind MERGE.\n" +
+            "- Never create reciprocal merges or merge cycles. Do not merge A->B and B->A, and do not create A->B->C chains when A can point to C.\n" +
+            "- Every asset line with `req=Y:*` must receive an expression, including KEEP if it should stay.\n" +
+            "- Every prop line must receive an expression. Do not omit props.\n" +
+            "- Use `required_decision_ids` as the coverage checklist before final output.\n" +
+            "- Assets with `req=-` should be omitted when unchanged; do not spend output on KEEP for req=- assets.\n" +
+            "- If output is long, prioritize every req=Y decision over any optional req=- expression.\n" +
+            "- If the context header is `# Asset Curation Audit Context`, output only corrective expressions for listed candidates, or NOOP if no correction is needed.\n" +
+            "- If the context header is `# Location Canonicalization Audit Context`, output only RENAME/MERGE location expressions for listed candidates, or NOOP if no location canonicalization is needed.\n" +
+            "- If the context header is `# Asset Curation Repair Context`, output replacement expressions only for `repair_required_source_keys`; do not repeat unrelated accepted decisions.\n" +
+            "- In audit mode, the first character of your response must be `<`. Do not write candidate reviews, headings, bullets, or prose outside expressions.\n" +
+            "- In audit mode, primary KEEP actor candidates may be corrected to SPEAKER, MERGE, or RENAME when they are generic numbered roles, anonymous crowds, pure voice labels, or duplicate identities.\n" +
+            "- In audit mode, primary KEEP location candidates may be corrected to RENAME or MERGE when scoped canonical naming or duplicate/parent-child granularity is wrong.\n" +
+            "- In audit mode, primary KEEP prop candidates may output KEEP only to add/replace a valid category reason; otherwise output DROP/MERGE/STATE/RENAME when KEEP is too broad.\n" +
+            "- In audit mode, primary KEEP props with `ownerA=` should become STATE only for body marks or worn appearance; keep detachable recurring core objects when evidence supports it.\n" +
+            "- In audit mode, primary DROP/MERGE/STATE prop candidates may be corrected to KEEP/RENAME/MERGE when the evidence shows standalone hero-prop continuity.\n" +
+            "- In location canonicalization mode, do not output KEEP, DROP, STATE, PROP, SPEAKER, actor, or prop operations.\n" +
+            "- In location canonicalization mode, omit unchanged candidates; KEEP is invalid and will fail validation.\n" +
+            "- In location canonicalization mode, use `scopeHint=`/`renameHint=` to RENAME ambiguous unscoped locations into scoped canonical names; use `parent=`/`gran=` to MERGE only non-distinct micro/transition/angle locations into a parent; leave distinct shootable subspaces unchanged.\n" +
+            "- For STATE/PROP/MERGE targets, use only existing target ids visible in the context line, such as `identity=`, `parent=`, `same=`, `coA=`, `coL=`, or related cluster ids. If no valid target id is visible, choose DROP instead of guessing.\n" +
+            "- Reference existing ids only. Do not invent source_id or target_id values.\n" +
+            "- For every actionable merge/drop/move/rename, give a short concrete reason from the context.\n" +
+            "- For every KEEP expression, give a short concrete reason from the context; KEEP prop reasons must begin like `category=signature_instance; ...` using one allowed category.\n" +
+            "- Keep reasons short. Prefer one precise phrase over long explanations.\n" +
+            "\n" +
+            "Output format:\n" +
+            "- Output plain text only. Do not output JSON, markdown tables, fenced code blocks, or explanations outside expressions.\n" +
+            "- Each expression must be one line wrapped exactly as `<exp>...</exp>`.\n" +
+            "- Every expression must include `# reason` at the end; the reason is required for audit.\n" +
+            "- If there are no changes, output exactly `<exp>NOOP # no asset curation changes</exp>`.\n" +
+            "\n" +
+            "Expression grammar:\n" +
+            "- `<exp>KEEP <kind> <source_id> # reason</exp>`\n" +
+            "- `<exp>MERGE <kind> <source_id> -> <target_id> # reason</exp>`\n" +
+            "- `<exp>DROP <kind> <source_id> # reason</exp>`\n" +
+            "- `<exp>RENAME <kind> <source_id> \"<new_name>\" # reason</exp>`\n" +
+            "- `<exp>STATE <kind> <source_id> -> <target_kind> <target_id> \"<state_name>\" # reason</exp>`\n" +
+            "- `<exp>SPEAKER <kind> <source_id> -> <speaker_kind> \"<display_name>\" # reason</exp>`\n" +
+            "- `<exp>PROP <kind> <source_id> -> <target_prop_id|NEW> \"<prop_name>\" # reason</exp>`\n" +
+            "- `<kind>` is one of actor, location, prop. `<target_kind>` is one of actor, location, prop.\n" +
+            "- `<speaker_kind>` is one of system, broadcast, group, other.\n" +
+            "- Use double quotes for names. Escape only `\"` and `\\\\` inside quoted strings.\n" +
+            "- Do not write natural-language operations. If an operation cannot fit this grammar, omit it.\n" +
+            "\n" +
+            "Context:\n" +
+            `${contextText}\n`;
+        const request = this.messageRequest(prompt, 20000);
+        const [raw, stopReason] = await this.collectResponseTextWithRetry(request);
+        if (stopReason === "max_tokens") {
+            throw new CliError("INIT FAILED: Asset curation output truncated", "Asset curation output truncated.", {
+                exitCode: EXIT_RUNTIME,
+                required: ["complete asset curation expressions within provider max_tokens"],
+                received: [`stop_reason: ${stopReason}`, `max_tokens: ${request.max_tokens}`, `raw chars: ${raw.length}`, `tail: ${raw.slice(-160) || "<empty response>"}`],
+                nextSteps: ["Rerun init; completed extraction checkpoints will be reused and asset curation will retry."],
+                errorCode: "PROVIDER_OUTPUT_TRUNCATED",
+            });
+        }
+        if (!raw.trim()) {
+            throw new CliError("INIT FAILED: Provider returned empty asset curation", "Provider returned an empty asset curation response.", {
+                exitCode: EXIT_RUNTIME,
+                required: ["one or more <exp> asset curation expressions"],
+                received: [`stop_reason: ${stopReason || "unknown"}`, "raw chars: 0"],
+                nextSteps: ["Rerun init; completed extraction checkpoints will be reused and asset curation will retry."],
+                errorCode: "PROVIDER_EMPTY_RESPONSE",
+            });
+        }
+        return raw;
+    }
+    async bindStates(_script, context) {
+        const prompt = "You bind scene asset refs to existing visual states for `scriptctl direct init`.\n" +
+            "Return JSON through the forced tool call. The caller will reject unknown scene, asset, or state ids.\n" +
+            "\n" +
+            "Policy:\n" +
+            "- Use only state_id values listed under that exact scene ref's `states` array. Never borrow a state_id from another asset.\n" +
+            "- Each ref already has `current_state_id` from deterministic default/unique binding when available.\n" +
+            "- Omit refs that should keep `current_state_id`; output a ref only when the scene/actions prove it should change to another existing state.\n" +
+            "- Do not output null for refs; omit the ref instead.\n" +
+            "- Emit state_changes only for explicit durable transitions: transformation/form change, outfit change, breakage, repair, damage state, or location condition change.\n" +
+            "- Do not emit state_changes for emotions, poses, camera effects, dialogue tone, or momentary actions.\n" +
+            "- Do not include reason or explanation fields; return only the schema fields needed for deterministic apply.\n" +
+            "- Include each scene from the input chunk, even if its arrays are empty.\n" +
+            "- `action_index` is the zero-based index from the scene actions array.\n" +
+            "\n" +
+            "Context:\n" +
+            `${JSON.stringify(context)}\n`;
+        return this.runToolUse({
+            prompt,
+            maxTokens: 16000,
+            toolName: "submit_state_binding",
+            description: "Return scene state refs and explicit state changes for deterministic application.",
+            schema: STATE_BINDING_SCHEMA,
+            truncatedTitle: "INIT FAILED: State binding output truncated",
+            invalidTitle: "INIT FAILED: Provider returned invalid state binding JSON",
+            nextSteps: ["Rerun init; completed extraction and curation checkpoints will be reused and state binding will retry."],
+        });
+    }
     // Metadata is extracted as MANY small markdown requests instead of one big one:
     // a single GLOBAL call (worldview + protagonists, tiny input/output) plus
     // per-asset-chunk DESCRIPTION calls (≤ DEFAULT_METADATA_ASSET_CHUNK assets each).
@@ -558,7 +877,7 @@ export class AnthropicProvider {
             `${JSON.stringify(episodeSynopses)}\n`;
         return this.runToolUse({
             prompt,
-            maxTokens: 4096,
+            maxTokens: 2048,
             toolName: "submit_script_synopsis",
             description: "Return the whole-script overview (synopsis, theme, logline, style, main_characters).",
             schema: SCRIPT_SYNOPSIS_SCHEMA,
@@ -669,6 +988,126 @@ function firstNonEmptySourceLine(text) {
     const lines = text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
     return lines.find((line) => !line.endsWith("：") && !line.endsWith(":")) ?? lines[0] ?? "";
 }
+function mockAssetId(asset, kind) {
+    if (kind === "actor")
+        return strOf(asset["actor_id"]).trim();
+    if (kind === "location")
+        return strOf(asset["location_id"]).trim();
+    return strOf(asset["prop_id"]).trim();
+}
+function mockAssetName(asset, kind) {
+    if (kind === "actor")
+        return strOf(asset["actor_name"]).trim();
+    if (kind === "location")
+        return strOf(asset["location_name"]).trim();
+    return strOf(asset["prop_name"]).trim();
+}
+function actorVisualVariant(name) {
+    const prefix = /^(Q版|幻影|兽形|本体|灵体|黑化|幼年|少年|老年)[\s·：:、-]*(.+)$/.exec(name);
+    if (prefix)
+        return { baseName: prefix[2].trim(), stateName: prefix[1].trim() };
+    const suffix = /^(.+?)[\s·：:、-]*(Q版|幻影|兽形|本体|灵体|黑化|幼年|少年|老年)$/.exec(name);
+    if (suffix)
+        return { baseName: suffix[1].trim(), stateName: suffix[2].trim() };
+    return null;
+}
+function looksLikeGroupSpeaker(name) {
+    return /众人|群众|围观者|围观群众|路人们|大家|人群|村民们|族人们|员工们|同事们/.test(name) ||
+        /^路人[甲乙丙丁ABCD]$/.test(name);
+}
+function isMicroLocationName(name) {
+    return /门口|门前|门边|角落|墙边|窗边|桌边|床边|车旁|车前|车后|楼道|走廊/.test(name);
+}
+function isDisposableOrUiProp(name) {
+    return /一次性|手机画面|屏幕|界面|弹窗|提示框|聊天框|字幕条/.test(name);
+}
+function mockBindingRefs(scene, refKey, idKey, actionText) {
+    const refs = isDict(scene["refs"]) ? scene["refs"] : {};
+    const out = [];
+    for (const ref of asList(refs[refKey])) {
+        if (!isDict(ref))
+            continue;
+        const id = strOf(ref["id"]).trim();
+        const states = asList(ref["states"]);
+        if (!id || states.length === 0)
+            continue;
+        const stateId = pickMockStateId(states, actionText);
+        out.push({ [idKey]: id, state_id: stateId });
+    }
+    return out;
+}
+function pickMockStateId(states, actionText) {
+    for (const state of states) {
+        const name = strOf(state["state_name"]).trim();
+        const stateId = strOf(state["state_id"]).trim();
+        if (name && name !== "默认" && stateId && actionText.includes(name))
+            return stateId;
+    }
+    for (const state of states) {
+        if (strOf(state["state_name"]).trim() === "默认")
+            return strOf(state["state_id"]).trim() || null;
+    }
+    if (states.length === 1)
+        return strOf(states[0]["state_id"]).trim() || null;
+    return null;
+}
+function mockStateChanges(scene, actions) {
+    const refs = isDict(scene["refs"]) ? scene["refs"] : {};
+    const changeCues = /变成|变身|化作|恢复|变回|换上|穿上|脱下|破损|碎裂|修复|烧毁|亮起|熄灭/;
+    const out = [];
+    const seen = new Set();
+    for (let actionIndex = 0; actionIndex < actions.length; actionIndex++) {
+        const content = strOf(actions[actionIndex]["content"]);
+        if (!changeCues.test(content))
+            continue;
+        for (const [refKey, targetKind] of [
+            ["actors", "actor"],
+            ["locations", "location"],
+            ["props", "prop"],
+        ]) {
+            for (const ref of asList(refs[refKey])) {
+                if (!isDict(ref))
+                    continue;
+                const targetId = strOf(ref["id"]).trim();
+                const states = asList(ref["states"]);
+                const toStateId = pickExplicitMockStateId(states, content);
+                if (!targetId || !toStateId)
+                    continue;
+                const key = `${actionIndex}:${targetKind}:${targetId}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                const defaultStateId = mockDefaultStateId(states);
+                out.push({
+                    action_index: actionIndex,
+                    target_kind: targetKind,
+                    target_id: targetId,
+                    from_state_id: defaultStateId || null,
+                    to_state_id: toStateId,
+                    effective_from: "after_action",
+                    reason: "mock: action contains an explicit durable visual state change.",
+                });
+            }
+        }
+    }
+    return out;
+}
+function pickExplicitMockStateId(states, content) {
+    for (const state of states) {
+        const name = strOf(state["state_name"]).trim();
+        const stateId = strOf(state["state_id"]).trim();
+        if (name && name !== "默认" && stateId && content.includes(name))
+            return stateId;
+    }
+    return "";
+}
+function mockDefaultStateId(states) {
+    for (const state of states) {
+        if (strOf(state["state_name"]).trim() === "默认")
+            return strOf(state["state_id"]).trim();
+    }
+    return "";
+}
 /**
  * Find a forced tool_use block by name in a Message's content array.
  * Returns its `input` (already parsed by the SDK) or `null` when missing/non-object.