novel-writer-cli 0.0.1

package/dist/__tests__/next-step-prejudge-guardrails.test.js

@@ -0,0 +1,325 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, symlink, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import test from "node:test";
+import { buildInstructionPacket } from "../instructions.js";
+import { computeNextStep } from "../next-step.js";
+async function writeJson(absPath, payload) {
+    await mkdir(dirname(absPath), { recursive: true });
+    await writeFile(absPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+}
+function makePlatformProfileRaw(extra) {
+    return {
+        schema_version: 1,
+        platform: "qidian",
+        created_at: "2026-01-01T00:00:00Z",
+        word_count: { target_min: 1, target_max: 2, hard_min: 1, hard_max: 2 },
+        hook_policy: { required: false, min_strength: 3, allowed_types: ["question"], fix_strategy: "hook-fix" },
+        info_load: { max_new_entities_per_chapter: 0, max_unknown_entities_per_chapter: 0, max_new_terms_per_1k_words: 0 },
+        compliance: { banned_words: [], duplicate_name_policy: "warn" },
+        ...extra
+    };
+}
+async function setupProjectDir() {
+    const rootDir = await mkdtemp(join(tmpdir(), "novel-next-prejudge-guardrails-"));
+    await writeJson(join(rootDir, ".checkpoint.json"), { last_completed_chapter: 0, current_volume: 1, pipeline_stage: null, inflight_chapter: null });
+    return rootDir;
+}
+test("computeNextStep returns review when naming lint has blocking issues", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "judged:prejudge_guardrails_blocking:naming_lint");
+});
+test("computeNextStep returns review when readability lint has blocking issues (deterministic script)", async () => {
+    const rootDir = await setupProjectDir();
+    await mkdir(join(rootDir, "scripts"), { recursive: true });
+    const stubJson = '{"schema_version":1,"generated_at":"2026-01-01T00:00:00.000Z","scope":{"chapter":1},"policy":{"enabled":true,"max_paragraph_chars":10,"max_consecutive_exposition_paragraphs":2,"blocking_severity":"hard_only"},"issues":[{"id":"readability.mobile.overlong_paragraph","severity":"hard","summary":"Hard issue blocks."}]}';
+    const stubScript = `#!/usr/bin/env bash\nset -euo pipefail\nprintf '%s\\n' '${stubJson}'\n`;
+    await writeFile(join(rootDir, "scripts/lint-readability.sh"), stubScript, "utf8");
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        compliance: { banned_words: [], duplicate_name_policy: "warn", script_paths: { lint_readability: "scripts/lint-readability.sh" } },
+        retention: null,
+        readability: { mobile: { enabled: true, max_paragraph_chars: 10, max_consecutive_exposition_paragraphs: 2, blocking_severity: "hard_only" } },
+        naming: null
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "judged:prejudge_guardrails_blocking:readability_lint");
+});
+test("buildInstructionPacket (judge) includes prejudge guardrails report path and writes the report file", async () => {
+    const rootDir = await setupProjectDir();
+    await mkdir(join(rootDir, "scripts"), { recursive: true });
+    const stubJson = '{"schema_version":1,"generated_at":"2026-01-01T00:00:00.000Z","scope":{"chapter":1},"policy":{"enabled":true,"max_paragraph_chars":10,"max_consecutive_exposition_paragraphs":2,"blocking_severity":"hard_only"},"issues":[]}';
+    const stubScript = `#!/usr/bin/env bash\nset -euo pipefail\nprintf '%s\\n' '${stubJson}'\n`;
+    await writeFile(join(rootDir, "scripts/lint-readability.sh"), stubScript, "utf8");
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        compliance: { banned_words: [], duplicate_name_policy: "warn", script_paths: { lint_readability: "scripts/lint-readability.sh" } },
+        retention: null,
+        readability: { mobile: { enabled: true, max_paragraph_chars: 10, max_consecutive_exposition_paragraphs: 2, blocking_severity: "hard_only" } },
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/state"), { recursive: true });
+    await writeJson(join(rootDir, "staging/state/chapter-001-crossref.json"), {});
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    const built = await buildInstructionPacket({
+        rootDir,
+        checkpoint,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    const packet = built.packet;
+    const guardrailRel = packet?.manifest?.paths?.prejudge_guardrails;
+    assert.equal(typeof guardrailRel, "string");
+    const reportRaw = JSON.parse(await readFile(join(rootDir, guardrailRel), "utf8"));
+    assert.equal(reportRaw.schema_version, 2);
+    assert.equal(reportRaw.scope?.chapter, 1);
+    assert.equal(reportRaw.dependencies?.characters_active?.rel_path, "characters/active");
+    assert.equal(typeof reportRaw.dependencies?.characters_active?.fingerprint, "string");
+    assert.equal(reportRaw.readability_lint?.schema_version, 1);
+    const inlineRef = packet?.manifest?.inline?.prejudge_guardrails?.report_path;
+    assert.equal(inlineRef, guardrailRel);
+});
+test("computeNextStep returns review on refined stage when naming lint blocks", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "refined:prejudge_guardrails_blocking:naming_lint");
+});
+test("computeNextStep returns draft (not crash) when judged but staging chapter is missing", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: null
+    }));
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:draft");
+    assert.equal(next.reason, "judged:missing_chapter");
+});
+test("computeNextStep tolerates invalid cached prejudge guardrails JSON (recomputes)", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    await mkdir(join(rootDir, "staging/guardrails"), { recursive: true });
+    await writeFile(join(rootDir, "staging/guardrails/prejudge-guardrails-chapter-001.json"), "{not-json", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "judged:prejudge_guardrails_blocking:naming_lint");
+    assert.equal(next.evidence?.prejudge_guardrails?.cache?.status, "miss");
+});
+test("computeNextStep does not use cached report when platform profile changes (fingerprint invalidation)", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    // Generate and persist a cached guardrails report via judge instructions.
+    const checkpointRefined = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    await buildInstructionPacket({
+        rootDir,
+        checkpoint: checkpointRefined,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    // Now change platform profile to disable naming (cached report should be ignored).
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ retention: null, readability: null, naming: null }));
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    const checkpointJudged = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpointJudged);
+    assert.equal(next.step, "chapter:001:commit");
+});
+test("computeNextStep uses cached prejudge guardrails report when fresh", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/state"), { recursive: true });
+    await writeJson(join(rootDir, "staging/state/chapter-001-crossref.json"), {});
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    // Generate and persist a cached guardrails report via judge instructions.
+    const checkpointRefined = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    await buildInstructionPacket({
+        rootDir,
+        checkpoint: checkpointRefined,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    const checkpointJudged = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpointJudged);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "judged:prejudge_guardrails_blocking:naming_lint");
+    assert.equal(next.evidence?.prejudge_guardrails?.cache?.status, "hit");
+});
+test("computeNextStep ignores cached guardrails report when characters change", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/state"), { recursive: true });
+    await writeJson(join(rootDir, "staging/state/chapter-001-crossref.json"), {});
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    await mkdir(join(rootDir, "characters/active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    // Generate cached report with a blocking duplicate.
+    const checkpointRefined = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    await buildInstructionPacket({
+        rootDir,
+        checkpoint: checkpointRefined,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    // Fix the duplicate by renaming a character; cache must be ignored.
+    await writeJson(join(rootDir, "characters/active/b.json"), { id: "b", display_name: "李四五", aliases: [] });
+    const checkpointJudged = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpointJudged);
+    assert.equal(next.step, "chapter:001:commit");
+});
+test("computeNextStep ignores cached guardrails report when characters/active is a symlink", { skip: process.platform === "win32" }, async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/state"), { recursive: true });
+    await writeJson(join(rootDir, "staging/state/chapter-001-crossref.json"), {});
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    await mkdir(join(rootDir, "characters/shared-active"), { recursive: true });
+    await writeJson(join(rootDir, "characters/shared-active/a.json"), { id: "a", display_name: "张三", aliases: [] });
+    await writeJson(join(rootDir, "characters/shared-active/b.json"), { id: "b", display_name: "张三", aliases: [] });
+    await symlink(join(rootDir, "characters/shared-active"), join(rootDir, "characters/active"));
+    // Generate cached report with a blocking duplicate (via judge instructions).
+    const checkpointRefined = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    const built = await buildInstructionPacket({
+        rootDir,
+        checkpoint: checkpointRefined,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    const packet = built.packet;
+    const guardrailRel = packet?.manifest?.paths?.prejudge_guardrails;
+    assert.equal(typeof guardrailRel, "string");
+    const reportRaw = JSON.parse(await readFile(join(rootDir, guardrailRel), "utf8"));
+    assert.equal(reportRaw.has_blocking_issues, true);
+    // Fix the duplicate in the symlink target; cache must be ignored.
+    await writeJson(join(rootDir, "characters/shared-active/b.json"), { id: "b", display_name: "李四五", aliases: [] });
+    const checkpointJudged = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpointJudged);
+    assert.equal(next.step, "chapter:001:commit");
+});
+test("computeNextStep returns review when guardrails computation errors", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ retention: null, readability: null, naming: null }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    // Make chapter path a directory to trigger EISDIR read error.
+    await mkdir(join(rootDir, "staging/chapters/chapter-001.md"), { recursive: true });
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), { chapter: 1, overall: 4, recommendation: "pass" });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+    assert.equal(next.reason, "judged:prejudge_guardrails_error");
+    assert.equal(next.evidence?.prejudge_guardrails?.cache?.status, "miss");
+    assert.equal(typeof next.evidence?.prejudge_guardrails?.error, "string");
+});
+test("buildInstructionPacket (judge) sets prejudge_guardrails_degraded when report compute fails", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({
+        retention: null,
+        readability: null,
+        naming: { enabled: true, near_duplicate_threshold: 0.9, blocking_conflict_types: ["duplicate"], exemptions: {} }
+    }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    // Intentionally create a directory at the chapter path to trigger fingerprint/read failure.
+    await mkdir(join(rootDir, "staging/chapters/chapter-001.md"), { recursive: true });
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1 };
+    const built = await buildInstructionPacket({
+        rootDir,
+        checkpoint,
+        step: { kind: "chapter", chapter: 1, stage: "judge" },
+        embedMode: null,
+        writeManifest: false
+    });
+    const packet = built.packet;
+    assert.equal(packet?.manifest?.inline?.prejudge_guardrails, null);
+    assert.equal(packet?.manifest?.inline?.prejudge_guardrails_degraded, true);
+    assert.equal(packet?.manifest?.paths?.prejudge_guardrails, undefined);
+});

package/dist/__tests__/next-step-title-fix.test.js

@@ -0,0 +1,153 @@
+import assert from "node:assert/strict";
+import { mkdtemp, mkdir, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import test from "node:test";
+import { advanceCheckpointForStep } from "../advance.js";
+import { buildInstructionPacket } from "../instructions.js";
+import { computeNextStep } from "../next-step.js";
+import { titleFixSnapshotRel } from "../steps.js";
+import { validateStep } from "../validate.js";
+async function writeJson(absPath, payload) {
+    await mkdir(dirname(absPath), { recursive: true });
+    await writeFile(absPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+}
+function makePlatformProfileRaw(args) {
+    const max_chars = args.max_chars ?? 10;
+    return {
+        schema_version: 1,
+        platform: "qidian",
+        created_at: "2026-01-01T00:00:00Z",
+        word_count: { target_min: 1, target_max: 2, hard_min: 1, hard_max: 2 },
+        hook_policy: { required: false, min_strength: 3, allowed_types: ["question"], fix_strategy: "hook-fix" },
+        info_load: { max_new_entities_per_chapter: 0, max_unknown_entities_per_chapter: 0, max_new_terms_per_1k_words: 0 },
+        compliance: { banned_words: [], duplicate_name_policy: "warn" },
+        scoring: { genre_drive_type: "plot", weight_profile_id: "plot:v1" },
+        retention: args.enabled
+            ? {
+                title_policy: {
+                    enabled: true,
+                    min_chars: 2,
+                    max_chars,
+                    forbidden_patterns: [],
+                    auto_fix: args.auto_fix
+                },
+                hook_ledger: {
+                    enabled: false,
+                    fulfillment_window_chapters: 10,
+                    diversity_window_chapters: 5,
+                    max_same_type_streak: 2,
+                    min_distinct_types_in_window: 2,
+                    overdue_policy: "warn"
+                }
+            }
+            : null
+    };
+}
+async function setupProjectDir() {
+    const rootDir = await mkdtemp(join(tmpdir(), "novel-next-title-fix-"));
+    await writeJson(join(rootDir, ".checkpoint.json"), { last_completed_chapter: 0, current_volume: 1, pipeline_stage: null, inflight_chapter: null });
+    return rootDir;
+}
+test("computeNextStep returns title-fix on hard title violations when auto_fix=true", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 0 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:title-fix");
+});
+test("computeNextStep returns review after title-fix was already attempted", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 1 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+});
+test("computeNextStep returns review on hard title violations when auto_fix=false", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: false }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 0 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:review");
+});
+test("computeNextStep does not block on warn-only title issues when auto_fix=false", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: false, max_chars: 3 }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 太长的标题\n正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 0 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:judge");
+});
+test("computeNextStep returns title-fix on warn-only title issues when auto_fix=true", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true, max_chars: 3 }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "# 太长的标题\n正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 0 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:title-fix");
+});
+test("computeNextStep returns title-fix on judged stage when eval exists and title violates policy (auto_fix=true)", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    await writeFile(join(rootDir, "staging/chapters/chapter-001.md"), "正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/evaluations"), { recursive: true });
+    await writeJson(join(rootDir, "staging/evaluations/chapter-001-eval.json"), {});
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "judged", inflight_chapter: 1, title_fix_count: 0 };
+    const next = await computeNextStep(rootDir, checkpoint);
+    assert.equal(next.step, "chapter:001:title-fix");
+});
+test("title-fix snapshot is write-once (rerunning instructions does not bypass body guard)", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    const chapterAbs = join(rootDir, "staging/chapters/chapter-001.md");
+    await writeFile(chapterAbs, "# 标题\n正文\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: "refined", inflight_chapter: 1, title_fix_count: 0 };
+    await buildInstructionPacket({
+        rootDir,
+        checkpoint,
+        step: { kind: "chapter", chapter: 1, stage: "title-fix" },
+        embedMode: null,
+        writeManifest: false
+    });
+    const snapshotRel = titleFixSnapshotRel(1);
+    const snapshotAbs = join(rootDir, snapshotRel);
+    const snapshot1 = await readFile(snapshotAbs, "utf8");
+    // Illegal edit: body changed.
+    await writeFile(chapterAbs, "# 标题\n正文改了\n", "utf8");
+    // Re-run instructions (snapshot must not be overwritten).
+    await buildInstructionPacket({
+        rootDir,
+        checkpoint,
+        step: { kind: "chapter", chapter: 1, stage: "title-fix" },
+        embedMode: null,
+        writeManifest: false
+    });
+    const snapshot2 = await readFile(snapshotAbs, "utf8");
+    assert.equal(snapshot2, snapshot1);
+    await assert.rejects(() => validateStep({ rootDir, checkpoint, step: { kind: "chapter", chapter: 1, stage: "title-fix" } }), /chapter body changed/i);
+});
+test("advance draft cleans up title-fix snapshot to avoid stale reuse", async () => {
+    const rootDir = await setupProjectDir();
+    await writeJson(join(rootDir, "platform-profile.json"), makePlatformProfileRaw({ enabled: true, auto_fix: true }));
+    await mkdir(join(rootDir, "staging/chapters"), { recursive: true });
+    const chapterAbs = join(rootDir, "staging/chapters/chapter-001.md");
+    await writeFile(chapterAbs, "# 标题\n正文\n", "utf8");
+    await mkdir(join(rootDir, "staging/logs"), { recursive: true });
+    const snapshotRel = titleFixSnapshotRel(1);
+    await writeFile(join(rootDir, snapshotRel), "old snapshot\n", "utf8");
+    const checkpoint = { last_completed_chapter: 0, current_volume: 1, pipeline_stage: null, inflight_chapter: null, title_fix_count: 1 };
+    await writeJson(join(rootDir, ".checkpoint.json"), checkpoint);
+    await advanceCheckpointForStep({ rootDir, step: { kind: "chapter", chapter: 1, stage: "draft" } });
+    // validate cleanup is best-effort; the file should be gone.
+    await assert.rejects(() => readFile(join(rootDir, snapshotRel), "utf8"));
+});