@lingjingai/scriptctl 0.28.3 → 0.29.0

package/dist/domain/direct/stages/batch-extract.js

@@ -0,0 +1,12 @@
+import { stageBatchExtract } from "../../../usecases/direct.js";
+// LLM-extract each batch concurrently, persisting per-batch result/error files
+// (the resume unit). Reads: source.txt + episode_plan.json + batch_plan.json.
+// Writes: batch_results/<key>.json|.error.json. `output: null` — completion is
+// per-batch, not a single artifact, so the runner never skips it wholesale;
+// reuse is decided per batch inside the stage (classifyBatch).
+export const batchExtractStage = {
+    name: "batch-extract",
+    output: null,
+    run: (ctx) => stageBatchExtract(ctx),
+};
+//# sourceMappingURL=batch-extract.js.map

package/dist/domain/direct/stages/batch-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-extract.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/batch-extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAU;IACtC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;CACrC,CAAC"}

package/dist/domain/direct/stages/batch-plan.d.ts

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

package/dist/domain/direct/stages/batch-plan.js

@@ -0,0 +1,9 @@
+import { stageBatchPlan } from "../../../usecases/direct.js";
+// Split each episode into natural extraction batches (deterministic). Reads:
+// source.txt + episode_plan.json. Writes: batch_plan.json.
+export const batchPlanStage = {
+    name: "batch-plan",
+    output: "batch_plan.json",
+    run: (ctx) => stageBatchPlan(ctx),
+};
+//# sourceMappingURL=batch-plan.js.map

package/dist/domain/direct/stages/batch-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-plan.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/batch-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,6EAA6E;AAC7E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAU;IACnC,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,iBAAiB;IACzB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC;CAClC,CAAC"}

package/dist/domain/direct/stages/episode-merge.d.ts

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

package/dist/domain/direct/stages/episode-merge.js

@@ -0,0 +1,11 @@
+import { stageEpisodeMerge } from "../../../usecases/direct.js";
+// Merge each episode's batch results into one episode result (deterministic).
+// Reads: batch_results/ + plans. Writes: in-memory merged results carried on
+// ctx.state (persisted by the episode-synopsis stage, matching the god-command
+// order). `output: null` — the persisted artifact is written by the next stage.
+export const episodeMergeStage = {
+    name: "episode-merge",
+    output: null,
+    run: (ctx) => stageEpisodeMerge(ctx),
+};
+//# sourceMappingURL=episode-merge.js.map

package/dist/domain/direct/stages/episode-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-merge.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/episode-merge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAU;IACtC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;CACrC,CAAC"}

package/dist/domain/direct/stages/episode-plan.d.ts

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

package/dist/domain/direct/stages/episode-plan.js

@@ -0,0 +1,9 @@
+import { stageEpisodePlan } from "../../../usecases/direct.js";
+// Split source.txt into episodes (deterministic). Reads: source.txt. Writes:
+// episode_plan.json.
+export const episodePlanStage = {
+    name: "episode-plan",
+    output: "episode_plan.json",
+    run: (ctx) => stageEpisodePlan(ctx),
+};
+//# sourceMappingURL=episode-plan.js.map

package/dist/domain/direct/stages/episode-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-plan.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/episode-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,6EAA6E;AAC7E,qBAAqB;AACrB,MAAM,CAAC,MAAM,gBAAgB,GAAU;IACrC,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,mBAAmB;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;CACpC,CAAC"}

package/dist/domain/direct/stages/episode-synopsis.d.ts

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

package/dist/domain/direct/stages/episode-synopsis.js

@@ -0,0 +1,12 @@
+import { stageEpisodeSynopsis } from "../../../usecases/direct.js";
+// Resolve each episode's synopsis (reduce-1: passthrough / reuse / skip / LLM
+// stitch) then persist episode_results/ep_NNN.json. Reads: merged results +
+// prior persisted syn. Writes: episode_results/*.json. Also raises the resumable
+// "incomplete" stop when an episode still has unextracted batches. `output: null`
+// — completion is per-episode, decided inside the stage.
+export const episodeSynopsisStage = {
+    name: "episode-synopsis",
+    output: null,
+    run: (ctx) => stageEpisodeSynopsis(ctx),
+};
+//# sourceMappingURL=episode-synopsis.js.map

package/dist/domain/direct/stages/episode-synopsis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-synopsis.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/episode-synopsis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,kFAAkF;AAClF,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAU;IACzC,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC;CACxC,CAAC"}

package/dist/domain/direct/stages/episode-titles.d.ts

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

package/dist/domain/direct/stages/episode-titles.js

@@ -0,0 +1,12 @@
+import { stageEpisodeTitles } from "../../../usecases/direct.js";
+// LLM-enrich the plan's missing episode titles (soft-degrade to deterministic
+// titles). Reads: source.txt + episode_plan.json. Writes: episode_plan.json
+// (titles filled in place). `output: null` — the plan artifact already exists
+// from episode-plan, so completion isn't captured by file presence; the runner
+// never skips titles wholesale.
+export const episodeTitlesStage = {
+    name: "episode-titles",
+    output: null,
+    run: (ctx) => stageEpisodeTitles(ctx),
+};
+//# sourceMappingURL=episode-titles.js.map

package/dist/domain/direct/stages/episode-titles.js.map

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

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

@@ -0,0 +1,17 @@
+import type { Stage, StageName } from "../stage.js";
+import { sourcePrepareStage } from "./source-prepare.js";
+import { episodePlanStage } from "./episode-plan.js";
+import { episodeTitlesStage } from "./episode-titles.js";
+import { batchPlanStage } from "./batch-plan.js";
+import { batchExtractStage } from "./batch-extract.js";
+import { episodeMergeStage } from "./episode-merge.js";
+import { episodeSynopsisStage } from "./episode-synopsis.js";
+import { scriptMergeStage } from "./script-merge.js";
+import { assetCurationStage } from "./asset-curation.js";
+import { metadataStage } from "./metadata.js";
+import { scriptSynopsisStage } from "./script-synopsis.js";
+import { validateStage } from "./validate.js";
+export declare const STAGES: readonly Stage[];
+export declare function stageByName(name: string): Stage | undefined;
+export declare function stageNames(): StageName[];
+export { sourcePrepareStage, episodePlanStage, episodeTitlesStage, batchPlanStage, batchExtractStage, episodeMergeStage, episodeSynopsisStage, scriptMergeStage, assetCurationStage, metadataStage, scriptSynopsisStage, validateStage, };

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

@@ -0,0 +1,37 @@
+import { sourcePrepareStage } from "./source-prepare.js";
+import { episodePlanStage } from "./episode-plan.js";
+import { episodeTitlesStage } from "./episode-titles.js";
+import { batchPlanStage } from "./batch-plan.js";
+import { batchExtractStage } from "./batch-extract.js";
+import { episodeMergeStage } from "./episode-merge.js";
+import { episodeSynopsisStage } from "./episode-synopsis.js";
+import { scriptMergeStage } from "./script-merge.js";
+import { assetCurationStage } from "./asset-curation.js";
+import { metadataStage } from "./metadata.js";
+import { scriptSynopsisStage } from "./script-synopsis.js";
+import { validateStage } from "./validate.js";
+// The full direct pipeline, in execution order. This is the single source of
+// truth for stage ordering — runStages walks it, runOne indexes into it, and
+// `direct run <stage>` validates against it.
+export const STAGES = [
+    sourcePrepareStage,
+    episodePlanStage,
+    episodeTitlesStage,
+    batchPlanStage,
+    batchExtractStage,
+    episodeMergeStage,
+    episodeSynopsisStage,
+    scriptMergeStage,
+    assetCurationStage,
+    metadataStage,
+    scriptSynopsisStage,
+    validateStage,
+];
+export function stageByName(name) {
+    return STAGES.find((s) => s.name === name);
+}
+export function stageNames() {
+    return STAGES.map((s) => s.name);
+}
+export { sourcePrepareStage, episodePlanStage, episodeTitlesStage, batchPlanStage, batchExtractStage, episodeMergeStage, episodeSynopsisStage, scriptMergeStage, assetCurationStage, metadataStage, scriptSynopsisStage, validateStage, };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,6EAA6E;AAC7E,6EAA6E;AAC7E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAqB;IACtC,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,aAAa;CACd,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,CAAC"}

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

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

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

@@ -0,0 +1,11 @@
+import { stageMetadata } from "../../../usecases/direct.js";
+// LLM metadata extraction (worldview / role_type / asset descriptions), applied
+// onto the script. Honors --skip-metadata. Reads: source.txt + ctx.state.script.
+// Writes: asset_metadata.json (+ mutates the in-memory script). `output: null` —
+// --skip-metadata deletes the artifact, so file presence isn't a skip signal.
+export const metadataStage = {
+    name: "metadata",
+    output: null,
+    run: (ctx) => stageMetadata(ctx),
+};
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,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/stages/script-merge.d.ts

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

package/dist/domain/direct/stages/script-merge.js

@@ -0,0 +1,15 @@
+import { stageScriptMerge } from "../../../usecases/direct.js";
+// Merge all episode results into one script + asset normalization report
+// (deterministic). Reads: episode_results/. Writes: ctx.state.script (persisted
+// later by script-synopsis) + asset_normalization.json. `output: null` — the
+// script must be re-derived from episode_results on EVERY run (a reused or
+// edited batch changes its episode result, which has to flow back into the
+// script), so this stage is never skipped on artifact presence. Presence of
+// asset_normalization.json is therefore NOT a completion signal; script.initial
+// .json is written later by script-synopsis, matching the god-command order.
+export const scriptMergeStage = {
+    name: "script-merge",
+    output: null,
+    run: (ctx) => stageScriptMerge(ctx),
+};
+//# sourceMappingURL=script-merge.js.map

package/dist/domain/direct/stages/script-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-merge.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/script-merge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,yEAAyE;AACzE,gFAAgF;AAChF,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,gFAAgF;AAChF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAU;IACrC,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;CACpC,CAAC"}

package/dist/domain/direct/stages/script-synopsis.d.ts

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

package/dist/domain/direct/stages/script-synopsis.js

@@ -0,0 +1,12 @@
+import { stageScriptSynopsis } from "../../../usecases/direct.js";
+// Whole-script overview (reduce-2): synopsis/theme/logline/style/main_characters,
+// soft-degrading on provider failure. Persists script.initial.json (the write
+// point inherited from the god-command). Reads: ctx.state.script. Writes:
+// synopsis.json + script.initial.json. `output: null` — degraded/skip outcomes
+// mean presence of script.initial.json isn't a clean skip signal.
+export const scriptSynopsisStage = {
+    name: "script-synopsis",
+    output: null,
+    run: (ctx) => stageScriptSynopsis(ctx),
+};
+//# sourceMappingURL=script-synopsis.js.map

package/dist/domain/direct/stages/script-synopsis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-synopsis.js","sourceRoot":"","sources":["../../../../src/domain/direct/stages/script-synopsis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,kFAAkF;AAClF,8EAA8E;AAC9E,0EAA0E;AAC1E,+EAA+E;AAC/E,kEAAkE;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAU;IACxC,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC;CACvC,CAAC"}

package/dist/domain/direct/stages/source-prepare.d.ts

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

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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1 @@
+{"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/validate.d.ts

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

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1 @@
+{"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.js

@@ -417,11 +417,25 @@ export function buildEpisodePlan(sourceText) {
     let confidence;
     let strategy;
     if (matches.length > 0) {
+        // Episode identity must be unique: ep_NNN is the dedup key for episode_results
+        // and the status table. Sources sometimes reuse a number (two different
+        // chapters both headed 第35集) — trust document order over the broken label and
+        // reassign the duplicate to the next free integer so neither segment's content
+        // is overwritten downstream. A well-formed source (sequential numbers) is
+        // unaffected: parseEpNumber already equals the position.
+        const usedEpNums = new Set();
         for (let idx = 0; idx < matches.length; idx++) {
             const match = matches[idx];
             const groups = match.groups ?? {};
             const raw = groups["zh"] || groups["ep"] || String(idx + 1);
-            const epNum = parseEpNumber(raw) ?? idx + 1;
+            let epNum = parseEpNumber(raw) ?? idx + 1;
+            if (usedEpNums.has(epNum)) {
+                let next = idx + 1;
+                while (usedEpNums.has(next))
+                    next++;
+                epNum = next;
+            }
+            usedEpNums.add(epNum);
             const end = idx + 1 < matches.length ? matches[idx + 1].index : sourceText.length;
             const header = match[0].trim();
             const rawTitle = extractEpisodeTitleCandidate(header);