@kienmatu/inkos-core 0.1.0

package/dist/pipeline/chapter-review-cycle.d.ts

@@ -0,0 +1,81 @@
+import type { AuditIssue, AuditResult } from "../agents/continuity.js";
+import type { ReviseMode, ReviseOutput } from "../agents/reviser.js";
+import type { WriteChapterOutput } from "../agents/writer.js";
+import type { ChapterIntent, ChapterMemo, ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { LengthSpec } from "../models/length-governance.js";
+export interface ChapterReviewCycleUsage {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+}
+export interface ChapterReviewCycleControlInput {
+    readonly chapterIntent: string;
+    readonly chapterMemo?: ChapterMemo;
+    readonly chapterIntentData?: ChapterIntent;
+    readonly contextPackage: ContextPackage;
+    readonly ruleStack: RuleStack;
+}
+export interface ChapterReviewCycleResult {
+    readonly finalContent: string;
+    readonly finalWordCount: number;
+    readonly preAuditWordCount: number;
+    readonly revised: boolean;
+    readonly auditResult: AuditResult;
+    readonly totalUsage: ChapterReviewCycleUsage;
+    readonly postReviseCount: number;
+    readonly repairApplied: boolean;
+}
+export declare function runChapterReviewCycle(params: {
+    readonly book: Pick<{
+        genre: string;
+    }, "genre">;
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly initialOutput: Pick<WriteChapterOutput, "content" | "wordCount" | "postWriteErrors">;
+    readonly reducedControlInput?: ChapterReviewCycleControlInput;
+    readonly lengthSpec: LengthSpec;
+    readonly initialUsage: ChapterReviewCycleUsage;
+    readonly createReviser: () => {
+        reviseChapter: (bookDir: string, chapterContent: string, chapterNumber: number, issues: ReadonlyArray<AuditIssue>, mode?: ReviseMode, genre?: string, options?: {
+            chapterIntent?: string;
+            chapterMemo?: ChapterMemo;
+            chapterIntentData?: ChapterIntent;
+            contextPackage?: ContextPackage;
+            ruleStack?: RuleStack;
+            lengthSpec?: LengthSpec;
+        }) => Promise<ReviseOutput>;
+    };
+    readonly auditor: {
+        auditChapter: (bookDir: string, chapterContent: string, chapterNumber: number, genre?: string, options?: {
+            temperature?: number;
+            chapterIntent?: string;
+            chapterMemo?: ChapterMemo;
+            contextPackage?: ContextPackage;
+            ruleStack?: RuleStack;
+        }) => Promise<AuditResult>;
+    };
+    readonly normalizePostWriteSurface?: (chapterContent: string) => string;
+    readonly assertChapterContentNotEmpty: (content: string, stage: string) => void;
+    readonly addUsage: (left: ChapterReviewCycleUsage, right?: ChapterReviewCycleUsage) => ChapterReviewCycleUsage;
+    readonly analyzeAITells: (content: string) => {
+        issues: ReadonlyArray<AuditIssue>;
+    };
+    readonly analyzeSensitiveWords: (content: string) => {
+        found: ReadonlyArray<{
+            severity: string;
+        }>;
+        issues: ReadonlyArray<AuditIssue>;
+    };
+    /** Re-run deterministic post-write checks (chapter-ref, paragraph shape, etc.) on any content. */
+    readonly runPostWriteChecks?: (content: string) => ReadonlyArray<AuditIssue>;
+    readonly maxReviewIterations?: number;
+    readonly logWarn: (message: {
+        zh: string;
+        en: string;
+    }) => void;
+    readonly logStage: (message: {
+        zh: string;
+        en: string;
+    }) => void;
+}): Promise<ChapterReviewCycleResult>;
+//# sourceMappingURL=chapter-review-cycle.d.ts.map

package/dist/pipeline/chapter-review-cycle.d.ts.map

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

package/dist/pipeline/chapter-review-cycle.js

@@ -0,0 +1,190 @@
+import { countChapterLength, isOutsideHardRange } from "../utils/length-metrics.js";
+const DEFAULT_MAX_REVIEW_ITERATIONS = 1;
+const PASS_SCORE_THRESHOLD = 85;
+const NET_IMPROVEMENT_EPSILON = 3;
+export async function runChapterReviewCycle(params) {
+    let totalUsage = params.initialUsage;
+    let finalContent = params.normalizePostWriteSurface?.(params.initialOutput.content)
+        ?? params.initialOutput.content;
+    let finalWordCount = countChapterLength(finalContent, params.lengthSpec.countingMode);
+    const preAuditWordCount = finalWordCount;
+    // Convert initial postWriteErrors into AuditIssues as fallback when runPostWriteChecks isn't provided.
+    const initialPostWriteIssues = params.initialOutput.postWriteErrors.map((violation) => ({
+        severity: "critical",
+        category: violation.rule,
+        description: violation.description,
+        suggestion: violation.suggestion,
+    }));
+    params.assertChapterContentNotEmpty(finalContent, "draft generation");
+    // ---------------------------------------------------------------------------
+    // Helper: assess a chapter (audit + deterministic checks + length + score)
+    // ---------------------------------------------------------------------------
+    const assess = async (content, options) => {
+        const llmAudit = await params.auditor.auditChapter(params.bookDir, content, params.chapterNumber, params.book.genre, params.reducedControlInput
+            ? { ...params.reducedControlInput, ...(options ?? {}) }
+            : options);
+        totalUsage = params.addUsage(totalUsage, llmAudit.tokenUsage);
+        const aiTellsResult = params.analyzeAITells(content);
+        const sensitiveResult = params.analyzeSensitiveWords(content);
+        const hasBlockedWords = sensitiveResult.found.some((item) => item.severity === "block");
+        const wordCount = countChapterLength(content, params.lengthSpec.countingMode);
+        const lengthInRange = !isOutsideHardRange(wordCount, params.lengthSpec);
+        const lengthIssues = lengthInRange ? [] : [{
+                severity: "critical",
+                category: "length-budget",
+                description: `Chapter length ${wordCount} is outside the required range ${params.lengthSpec.hardMin}-${params.lengthSpec.hardMax}.`,
+                suggestion: `Repair only the scenes that are underdeveloped or redundant, then land near ${params.lengthSpec.target} without changing established facts.`,
+            }];
+        // Deterministic post-write checks: run every round, not just the first.
+        // If runPostWriteChecks is provided, use it; otherwise fall back to initial postWriteErrors.
+        const postWriteIssues = params.runPostWriteChecks
+            ? params.runPostWriteChecks(content)
+            : initialPostWriteIssues;
+        const allIssues = [
+            ...llmAudit.issues,
+            ...aiTellsResult.issues,
+            ...sensitiveResult.issues,
+            ...postWriteIssues,
+            ...lengthIssues,
+        ];
+        const hasPostWriteCritical = postWriteIssues.some((i) => i.severity === "critical");
+        const auditResult = {
+            passed: (hasBlockedWords || hasPostWriteCritical || !lengthInRange) ? false : llmAudit.passed,
+            issues: allIssues,
+            summary: llmAudit.summary,
+            parseFailed: llmAudit.parseFailed,
+            overallScore: llmAudit.overallScore,
+        };
+        const score = llmAudit.overallScore ?? 0;
+        return { auditResult, score, lengthInRange };
+    };
+    const isPassed = (assessment) => assessment.auditResult.passed && assessment.score >= PASS_SCORE_THRESHOLD && assessment.lengthInRange;
+    // ---------------------------------------------------------------------------
+    // Scoring loop: assess → revise → assess. Default is one automatic repair pass;
+    // projects can raise it when they accept slower but more persistent repair.
+    // ---------------------------------------------------------------------------
+    const maxReviewIterations = Math.max(0, Math.floor(params.maxReviewIterations ?? DEFAULT_MAX_REVIEW_ITERATIONS));
+    params.logStage({ zh: "审计草稿", en: "auditing draft" });
+    const initial = await assess(finalContent);
+    const snapshots = [{
+            content: finalContent,
+            wordCount: finalWordCount,
+            auditResult: initial.auditResult,
+            score: initial.score,
+            lengthInRange: initial.lengthInRange,
+        }];
+    let currentAudit = initial;
+    let postReviseCount = 0;
+    if (initial.auditResult.parseFailed) {
+        params.logWarn({
+            zh: "审稿输出解析失败，跳过自动修稿以避免误改正文",
+            en: "Audit output parsing failed; skipping automatic repair to avoid rewriting valid prose from an unreliable audit.",
+        });
+        return {
+            finalContent,
+            finalWordCount,
+            preAuditWordCount,
+            revised: false,
+            auditResult: initial.auditResult,
+            totalUsage,
+            postReviseCount,
+            repairApplied: false,
+        };
+    }
+    if (!isPassed(initial)) {
+        for (let iteration = 0; iteration < maxReviewIterations; iteration++) {
+            params.logStage({
+                zh: `修复轮次 ${iteration + 1}/${maxReviewIterations}（当前 ${currentAudit.score} 分）`,
+                en: `repair iteration ${iteration + 1}/${maxReviewIterations} (current score: ${currentAudit.score})`,
+            });
+            const reviser = params.createReviser();
+            const reviseOutput = await reviser.reviseChapter(params.bookDir, finalContent, params.chapterNumber, currentAudit.auditResult.issues, "auto", params.book.genre, { ...params.reducedControlInput, lengthSpec: params.lengthSpec });
+            totalUsage = params.addUsage(totalUsage, reviseOutput.tokenUsage);
+            if (reviseOutput.revisedContent.length === 0 || reviseOutput.revisedContent === finalContent) {
+                params.logWarn({
+                    zh: `修复轮次 ${iteration + 1} 未产出新内容，退出循环`,
+                    en: `repair iteration ${iteration + 1} produced no new content, exiting loop`,
+                });
+                break;
+            }
+            params.assertChapterContentNotEmpty(reviseOutput.revisedContent, `repair iteration ${iteration + 1}`);
+            const revisedContent = params.normalizePostWriteSurface?.(reviseOutput.revisedContent) ?? reviseOutput.revisedContent;
+            const revisedWordCount = countChapterLength(revisedContent, params.lengthSpec.countingMode);
+            // Re-assess revised content. If REVISED_CONTENT drifted on length,
+            // lengthInRange will be false → isPassed fails → bestSnapshot picks
+            // the earlier in-range version. No in-loop normalize needed.
+            const nextAssessment = await assess(revisedContent, { temperature: 0 });
+            snapshots.push({
+                content: revisedContent,
+                wordCount: revisedWordCount,
+                auditResult: nextAssessment.auditResult,
+                score: nextAssessment.score,
+                lengthInRange: nextAssessment.lengthInRange,
+            });
+            // Check if passed
+            if (isPassed(nextAssessment)) {
+                params.logStage({
+                    zh: `修复后达到通过线（${nextAssessment.score} 分），退出循环`,
+                    en: `repair reached pass threshold (${nextAssessment.score}), exiting loop`,
+                });
+                finalContent = revisedContent;
+                finalWordCount = revisedWordCount;
+                postReviseCount = revisedWordCount;
+                currentAudit = nextAssessment;
+                break;
+            }
+            // Check net improvement
+            if (nextAssessment.score >= currentAudit.score + NET_IMPROVEMENT_EPSILON) {
+                finalContent = revisedContent;
+                finalWordCount = revisedWordCount;
+                postReviseCount = revisedWordCount;
+                currentAudit = nextAssessment;
+                // Continue to next iteration
+            }
+            else {
+                params.logWarn({
+                    zh: `修复轮次 ${iteration + 1} 未净提升（${currentAudit.score} → ${nextAssessment.score}），退出循环`,
+                    en: `repair iteration ${iteration + 1} no net improvement (${currentAudit.score} → ${nextAssessment.score}), exiting loop`,
+                });
+                break;
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Pick the best scoring snapshot for final output
+    // ---------------------------------------------------------------------------
+    const bestSnapshot = snapshots.reduce((best, snap) => {
+        if (snap.lengthInRange !== best.lengthInRange) {
+            return snap.lengthInRange ? snap : best;
+        }
+        return snap.score >= best.score + NET_IMPROVEMENT_EPSILON ? snap : best;
+    });
+    // If best snapshot differs from current content (repair made things worse
+    // but an earlier version was better), roll back to the best version.
+    const shouldRestoreBestSnapshot = bestSnapshot.content !== finalContent && ((bestSnapshot.lengthInRange && !currentAudit.lengthInRange)
+        || bestSnapshot.score >= currentAudit.score + NET_IMPROVEMENT_EPSILON);
+    if (shouldRestoreBestSnapshot) {
+        params.logWarn({
+            zh: `回退到最高分版本（${bestSnapshot.score} 分 vs 当前 ${currentAudit.score} 分）`,
+            en: `rolling back to highest-scoring version (${bestSnapshot.score} vs current ${currentAudit.score})`,
+        });
+        finalContent = bestSnapshot.content;
+        finalWordCount = bestSnapshot.wordCount;
+        currentAudit = {
+            auditResult: bestSnapshot.auditResult,
+            score: bestSnapshot.score,
+            lengthInRange: bestSnapshot.lengthInRange,
+        };
+    }
+    return {
+        finalContent,
+        finalWordCount,
+        preAuditWordCount,
+        revised: snapshots.length > 1 && finalContent !== params.initialOutput.content,
+        auditResult: currentAudit.auditResult,
+        totalUsage,
+        postReviseCount,
+        repairApplied: snapshots.length > 1 && finalContent !== params.initialOutput.content,
+    };
+}
+//# sourceMappingURL=chapter-review-cycle.js.map

package/dist/pipeline/chapter-review-cycle.js.map

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

package/dist/pipeline/chapter-state-recovery.d.ts

@@ -0,0 +1,61 @@
+import type { AuditIssue } from "../agents/continuity.js";
+import type { ValidationResult, ValidationWarning } from "../agents/state-validator.js";
+import type { StateValidatorAgent } from "../agents/state-validator.js";
+import type { WriteChapterOutput } from "../agents/writer.js";
+import type { WriterAgent } from "../agents/writer.js";
+import type { Logger } from "../utils/logger.js";
+import type { BookConfig } from "../models/book.js";
+import type { ChapterMeta } from "../models/chapter.js";
+import type { ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { LengthLanguage } from "../utils/length-metrics.js";
+export interface SettlementRetryParams {
+    readonly writer: Pick<WriterAgent, "settleChapterState">;
+    readonly validator: Pick<StateValidatorAgent, "validate">;
+    readonly book: BookConfig;
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly baselineChapter?: number;
+    readonly allowNewHooks?: boolean;
+    readonly title: string;
+    readonly content: string;
+    readonly reducedControlInput?: {
+        chapterIntent: string;
+        contextPackage: ContextPackage;
+        ruleStack: RuleStack;
+    };
+    readonly oldState: string;
+    readonly oldHooks: string;
+    readonly originalValidation: ValidationResult;
+    readonly language: LengthLanguage;
+    readonly logWarn?: (message: {
+        zh: string;
+        en: string;
+    }) => void;
+    readonly logger?: Pick<Logger, "warn">;
+}
+export type SettlementRetryResult = {
+    readonly kind: "recovered";
+    readonly output: WriteChapterOutput;
+    readonly validation: ValidationResult;
+} | {
+    readonly kind: "degraded";
+    readonly issues: ReadonlyArray<AuditIssue>;
+};
+export declare function retrySettlementAfterValidationFailure(params: SettlementRetryParams): Promise<SettlementRetryResult>;
+export declare function buildStateValidationFeedback(warnings: ReadonlyArray<ValidationWarning>, language: LengthLanguage): string;
+export declare function buildStateDegradedIssues(warnings: ReadonlyArray<ValidationWarning>, language: LengthLanguage): ReadonlyArray<AuditIssue>;
+export declare function buildStateDegradedPersistenceOutput(params: {
+    readonly output: WriteChapterOutput;
+    readonly oldState: string;
+    readonly oldHooks: string;
+    readonly oldLedger: string;
+}): WriteChapterOutput;
+export interface StateDegradedReviewNote {
+    readonly kind: "state-degraded";
+    readonly baseStatus: "ready-for-review" | "audit-failed";
+    readonly injectedIssues: ReadonlyArray<string>;
+}
+export declare function buildStateDegradedReviewNote(baseStatus: "ready-for-review" | "audit-failed", issues: ReadonlyArray<AuditIssue>): string;
+export declare function parseStateDegradedReviewNote(reviewNote?: string): StateDegradedReviewNote | null;
+export declare function resolveStateDegradedBaseStatus(chapter: Pick<ChapterMeta, "reviewNote" | "auditIssues">): "ready-for-review" | "audit-failed";
+//# sourceMappingURL=chapter-state-recovery.d.ts.map

package/dist/pipeline/chapter-state-recovery.d.ts.map

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

package/dist/pipeline/chapter-state-recovery.js

@@ -0,0 +1,135 @@
+export async function retrySettlementAfterValidationFailure(params) {
+    params.logWarn?.({
+        zh: `状态校验失败，正在仅重试结算层（第${params.chapterNumber}章）`,
+        en: `State validation failed; retrying settlement only for chapter ${params.chapterNumber}`,
+    });
+    const retryOutput = await params.writer.settleChapterState({
+        book: params.book,
+        bookDir: params.bookDir,
+        chapterNumber: params.chapterNumber,
+        title: params.title,
+        content: params.content,
+        allowReapply: true,
+        baselineChapter: params.baselineChapter,
+        allowNewHooks: params.allowNewHooks,
+        chapterIntent: params.reducedControlInput?.chapterIntent,
+        contextPackage: params.reducedControlInput?.contextPackage,
+        ruleStack: params.reducedControlInput?.ruleStack,
+        validationFeedback: buildStateValidationFeedback(params.originalValidation.warnings, params.language),
+    });
+    let retryValidation;
+    try {
+        retryValidation = await params.validator.validate(params.content, params.chapterNumber, params.oldState, retryOutput.updatedState, params.oldHooks, retryOutput.updatedHooks, params.language);
+    }
+    catch (error) {
+        throw new Error(`State validation retry failed for chapter ${params.chapterNumber}: ${String(error)}`);
+    }
+    if (retryValidation.warnings.length > 0) {
+        params.logWarn?.({
+            zh: `状态校验重试后，第${params.chapterNumber}章仍有 ${retryValidation.warnings.length} 条警告`,
+            en: `State validation retry still reports ${retryValidation.warnings.length} warning(s) for chapter ${params.chapterNumber}`,
+        });
+        for (const warning of retryValidation.warnings) {
+            params.logger?.warn(`  [${warning.category}] ${warning.description}`);
+        }
+    }
+    if (retryValidation.passed && !retryValidation.repairRequired) {
+        return {
+            kind: "recovered",
+            output: retryOutput,
+            validation: retryValidation,
+        };
+    }
+    return {
+        kind: "degraded",
+        issues: buildStateDegradedIssues(retryValidation.warnings, params.language),
+    };
+}
+export function buildStateValidationFeedback(warnings, language) {
+    if (warnings.length === 0) {
+        return language === "en"
+            ? "The previous settlement contradicted the chapter text. Reconcile truth files strictly to the body."
+            : "上一次状态结算与正文矛盾。请严格以正文为准修正 truth files。";
+    }
+    if (language === "en") {
+        return [
+            "The previous settlement failed validation. Fix these contradictions against the chapter body:",
+            ...warnings.map((warning) => `- [${warning.category}] ${warning.description}`),
+        ].join("\n");
+    }
+    return [
+        "上一次状态结算未通过校验。请对照正文修正以下矛盾：",
+        ...warnings.map((warning) => `- [${warning.category}] ${warning.description}`),
+    ].join("\n");
+}
+export function buildStateDegradedIssues(warnings, language) {
+    if (warnings.length > 0) {
+        return warnings.map((warning) => ({
+            severity: "warning",
+            category: "state-validation",
+            description: warning.description,
+            suggestion: language === "en"
+                ? "Repair chapter state from the persisted body before continuing."
+                : "请先基于已保存正文修复本章 state，再继续后续章节。",
+        }));
+    }
+    return [{
+            severity: "warning",
+            category: "state-validation",
+            description: language === "en"
+                ? "State validation still failed after settlement retry."
+                : "状态结算重试后仍未通过校验。",
+            suggestion: language === "en"
+                ? "Repair chapter state from the persisted body before continuing."
+                : "请先基于已保存正文修复本章 state，再继续后续章节。",
+        }];
+}
+export function buildStateDegradedPersistenceOutput(params) {
+    return {
+        ...params.output,
+        runtimeStateDelta: undefined,
+        runtimeStateSnapshot: undefined,
+        updatedState: params.oldState,
+        updatedLedger: params.oldLedger,
+        updatedHooks: params.oldHooks,
+        updatedChapterSummaries: undefined,
+    };
+}
+export function buildStateDegradedReviewNote(baseStatus, issues) {
+    return JSON.stringify({
+        kind: "state-degraded",
+        baseStatus,
+        injectedIssues: issues.map((issue) => `[${issue.severity}] ${issue.description}`),
+    });
+}
+export function parseStateDegradedReviewNote(reviewNote) {
+    if (!reviewNote) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(reviewNote);
+        if (parsed.kind !== "state-degraded"
+            || (parsed.baseStatus !== "ready-for-review" && parsed.baseStatus !== "audit-failed")
+            || !Array.isArray(parsed.injectedIssues)) {
+            return null;
+        }
+        return {
+            kind: "state-degraded",
+            baseStatus: parsed.baseStatus,
+            injectedIssues: parsed.injectedIssues.filter((issue) => typeof issue === "string"),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveStateDegradedBaseStatus(chapter) {
+    const metadata = parseStateDegradedReviewNote(chapter.reviewNote);
+    if (metadata) {
+        return metadata.baseStatus;
+    }
+    return chapter.auditIssues.some((issue) => issue.startsWith("[critical]"))
+        ? "audit-failed"
+        : "ready-for-review";
+}
+//# sourceMappingURL=chapter-state-recovery.js.map

package/dist/pipeline/chapter-state-recovery.js.map

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

package/dist/pipeline/chapter-truth-validation.d.ts

@@ -0,0 +1,42 @@
+import type { AuditIssue, AuditResult } from "../agents/continuity.js";
+import type { StateValidationAuthorityContext, ValidationResult, StateValidatorAgent } from "../agents/state-validator.js";
+import type { WriteChapterOutput, WriterAgent } from "../agents/writer.js";
+import type { BookConfig } from "../models/book.js";
+import type { ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { Logger } from "../utils/logger.js";
+import type { LengthLanguage } from "../utils/length-metrics.js";
+export declare function validateChapterTruthPersistence(params: {
+    readonly writer: Pick<WriterAgent, "settleChapterState">;
+    readonly validator: Pick<StateValidatorAgent, "validate">;
+    readonly book: BookConfig;
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly title: string;
+    readonly content: string;
+    readonly persistenceOutput: WriteChapterOutput;
+    readonly auditResult: AuditResult;
+    readonly previousTruth: {
+        readonly oldState: string;
+        readonly oldHooks: string;
+        readonly oldLedger: string;
+    };
+    readonly authorityContext?: StateValidationAuthorityContext;
+    readonly reducedControlInput?: {
+        chapterIntent: string;
+        contextPackage: ContextPackage;
+        ruleStack: RuleStack;
+    };
+    readonly language: LengthLanguage;
+    readonly logWarn: (message: {
+        zh: string;
+        en: string;
+    }) => void;
+    readonly logger?: Pick<Logger, "warn">;
+}): Promise<{
+    readonly validation: ValidationResult;
+    readonly chapterStatus: "state-degraded" | null;
+    readonly degradedIssues: ReadonlyArray<AuditIssue>;
+    readonly persistenceOutput: WriteChapterOutput;
+    readonly auditResult: AuditResult;
+}>;
+//# sourceMappingURL=chapter-truth-validation.d.ts.map

package/dist/pipeline/chapter-truth-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapter-truth-validation.d.ts","sourceRoot":"","sources":["../../src/pipeline/chapter-truth-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC3H,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;IAC5D,QAAQ,CAAC,mBAAmB,CAAC,EAAE;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,cAAc,CAAC;QAC/B,SAAS,EAAE,SAAS,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC,CAAC,CAsGD"}

package/dist/pipeline/chapter-truth-validation.js

@@ -0,0 +1,93 @@
+import { buildStateDegradedPersistenceOutput, retrySettlementAfterValidationFailure, } from "./chapter-state-recovery.js";
+export async function validateChapterTruthPersistence(params) {
+    let validation;
+    let chapterStatus = null;
+    let degradedIssues = [];
+    let persistenceOutput = params.persistenceOutput;
+    let auditResult = params.auditResult;
+    try {
+        validation = await params.validator.validate(params.content, params.chapterNumber, params.previousTruth.oldState, persistenceOutput.updatedState, params.previousTruth.oldHooks, persistenceOutput.updatedHooks, params.language, params.authorityContext);
+    }
+    catch (error) {
+        params.logger?.warn(`State validation error for chapter ${params.chapterNumber}: ${String(error)}`);
+        const errorDescription = params.language === "en"
+            ? `State validation unavailable: ${String(error)}`
+            : `状态校验不可用：${String(error)}`;
+        const errorIssue = {
+            severity: "warning",
+            category: "state-validation",
+            description: errorDescription,
+            suggestion: params.language === "en"
+                ? "Repair chapter state from the persisted body before continuing."
+                : "请先基于已保存正文修复本章 state，再继续后续章节。",
+        };
+        return {
+            validation: { passed: true, warnings: [] },
+            chapterStatus: "state-degraded",
+            degradedIssues: [errorIssue],
+            persistenceOutput: buildStateDegradedPersistenceOutput({
+                output: persistenceOutput,
+                oldState: params.previousTruth.oldState,
+                oldHooks: params.previousTruth.oldHooks,
+                oldLedger: params.previousTruth.oldLedger,
+            }),
+            auditResult: {
+                ...params.auditResult,
+                issues: [...params.auditResult.issues, errorIssue],
+            },
+        };
+    }
+    if (validation.warnings.length > 0) {
+        params.logWarn({
+            zh: `状态校验：第${params.chapterNumber}章发现 ${validation.warnings.length} 条警告`,
+            en: `State validation: ${validation.warnings.length} warning(s) for chapter ${params.chapterNumber}`,
+        });
+        for (const warning of validation.warnings) {
+            params.logger?.warn(`  [${warning.category}] ${warning.description}`);
+        }
+    }
+    if (!validation.passed || validation.repairRequired) {
+        const recovery = await retrySettlementAfterValidationFailure({
+            writer: params.writer,
+            validator: params.validator,
+            book: params.book,
+            bookDir: params.bookDir,
+            chapterNumber: params.chapterNumber,
+            title: params.title,
+            content: params.content,
+            reducedControlInput: params.reducedControlInput,
+            oldState: params.previousTruth.oldState,
+            oldHooks: params.previousTruth.oldHooks,
+            originalValidation: validation,
+            language: params.language,
+            logWarn: params.logWarn,
+            logger: params.logger,
+        });
+        if (recovery.kind === "recovered") {
+            persistenceOutput = recovery.output;
+            validation = recovery.validation;
+        }
+        else {
+            chapterStatus = "state-degraded";
+            degradedIssues = recovery.issues;
+            persistenceOutput = buildStateDegradedPersistenceOutput({
+                output: persistenceOutput,
+                oldState: params.previousTruth.oldState,
+                oldHooks: params.previousTruth.oldHooks,
+                oldLedger: params.previousTruth.oldLedger,
+            });
+            auditResult = {
+                ...auditResult,
+                issues: [...auditResult.issues, ...recovery.issues],
+            };
+        }
+    }
+    return {
+        validation,
+        chapterStatus,
+        degradedIssues,
+        persistenceOutput,
+        auditResult,
+    };
+}
+//# sourceMappingURL=chapter-truth-validation.js.map