@kienmatu/inkos-core 0.1.0

package/dist/interaction/draft-directive-parser.js

@@ -0,0 +1,208 @@
+/**
+ * Draft directive parser — extracts structured form data from LLM output
+ * that uses markdown directive syntax (:::type{attrs}...:::).
+ *
+ * Used by both TUI (textContent) and Studio (raw + fields).
+ */
+const DIRECTIVE_OPEN_RE = /^:::(field|pick|number|group)\{(.+)\}\s*$/;
+const DIRECTIVE_CLOSE_RE = /^:::\s*$/;
+const CODE_FENCE_RE = /^(`{3,}|~{3,})/;
+const LIST_ITEM_RE = /^-\s+(.+)$/;
+function parseAttrs(attrStr) {
+    const attrs = {};
+    // Match key="value" or key='value'
+    const re = /(\w+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+    let m;
+    while ((m = re.exec(attrStr)) !== null) {
+        attrs[m[1]] = m[2] ?? m[3] ?? "";
+    }
+    return attrs;
+}
+function parseDirectiveOpen(line) {
+    const m = DIRECTIVE_OPEN_RE.exec(line);
+    if (!m)
+        return null;
+    const type = m[1];
+    const rawAttrs = parseAttrs(m[2]);
+    return {
+        type,
+        key: rawAttrs["key"],
+        label: rawAttrs["label"],
+        fieldType: rawAttrs["type"],
+    };
+}
+/**
+ * Parse raw LLM output containing markdown directive blocks.
+ *
+ * State machine:
+ *   text → directive (on :::type{...})
+ *   text → codeblock (on ``` or ~~~)
+ *   directive → text (on standalone :::)
+ *   directive → directive (on nested :::type{...} inside group)
+ *   codeblock → text (on matching fence close)
+ */
+export function parseDraftDirectives(raw) {
+    const lines = raw.split("\n");
+    const fields = {};
+    const labels = [];
+    const textLines = [];
+    let mode = "text";
+    let codeFenceMarker = "";
+    // Stack of open directives — supports nesting (group > field/number).
+    const stack = [];
+    for (const line of lines) {
+        // --- Code-block handling (highest priority) ---
+        if (mode === "codeblock") {
+            textLines.push(line);
+            if (CODE_FENCE_RE.test(line) && line.trimStart().startsWith(codeFenceMarker)) {
+                mode = "text";
+                codeFenceMarker = "";
+            }
+            continue;
+        }
+        if (mode === "text") {
+            const fenceMatch = CODE_FENCE_RE.exec(line);
+            if (fenceMatch) {
+                codeFenceMarker = fenceMatch[1];
+                mode = "codeblock";
+                textLines.push(line);
+                continue;
+            }
+        }
+        // --- Directive close (standalone :::) ---
+        if (DIRECTIVE_CLOSE_RE.test(line) && stack.length > 0) {
+            const frame = stack.pop();
+            const { attrs, contentLines } = frame;
+            if (attrs.type !== "group" && attrs.key) {
+                const value = extractValue(attrs.type, contentLines);
+                fields[attrs.key] = value;
+                if (attrs.label) {
+                    labels.push(attrs.label);
+                }
+            }
+            // If we just closed the last frame, we're back in text mode
+            if (stack.length === 0) {
+                mode = "text";
+            }
+            continue;
+        }
+        // --- Directive open ---
+        const directiveOpen = parseDirectiveOpen(line);
+        if (directiveOpen) {
+            stack.push({ attrs: directiveOpen, contentLines: [] });
+            mode = "directive";
+            continue;
+        }
+        // --- Inside a directive: collect content ---
+        if (mode === "directive" && stack.length > 0) {
+            stack[stack.length - 1].contentLines.push(line);
+            continue;
+        }
+        // --- Normal text ---
+        textLines.push(line);
+    }
+    return {
+        fields,
+        textContent: textLines.join("\n"),
+        summary: buildSummary(labels),
+        raw,
+    };
+}
+// ---------------------------------------------------------------------------
+// Value extraction per directive type
+// ---------------------------------------------------------------------------
+function extractValue(type, contentLines) {
+    if (type === "pick") {
+        // Extract first list item value
+        for (const line of contentLines) {
+            const m = LIST_ITEM_RE.exec(line.trim());
+            if (m)
+                return m[1].trim();
+        }
+        return "";
+    }
+    // field, number — join all content lines, trim surrounding whitespace
+    return contentLines.join("\n").trim();
+}
+// ---------------------------------------------------------------------------
+// Summary builder
+// ---------------------------------------------------------------------------
+function buildSummary(labels) {
+    if (labels.length === 0)
+        return "";
+    if (labels.length === 1)
+        return `确立了${labels[0]}`;
+    if (labels.length === 2)
+        return `确立了${labels[0]}和${labels[1]}`;
+    // 3+: 确立了A、B和C
+    const allButLast = labels.slice(0, -1).join("、");
+    return `确立了${allButLast}和${labels[labels.length - 1]}`;
+}
+// ---------------------------------------------------------------------------
+// Streaming filter
+// ---------------------------------------------------------------------------
+/**
+ * Creates a stateful filter function for streaming LLM output.
+ * Text portions pass through immediately; directive blocks (:::...:::)
+ * are buffered and suppressed.
+ *
+ * Usage:
+ *   const filter = createDirectiveStreamFilter();
+ *   onChunk(chunk => { const visible = filter(chunk); display(visible); });
+ */
+export function createDirectiveStreamFilter() {
+    let depth = 0; // nesting depth of open directives
+    let inCodeBlock = false;
+    let codeFenceMarker = "";
+    return (chunk) => {
+        const lines = chunk.split("\n");
+        const outputParts = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const isLastLine = i === lines.length - 1;
+            // --- Code-block toggle ---
+            if (inCodeBlock) {
+                if (CODE_FENCE_RE.test(line) && line.trimStart().startsWith(codeFenceMarker)) {
+                    inCodeBlock = false;
+                    codeFenceMarker = "";
+                }
+                outputParts.push(line);
+                if (!isLastLine)
+                    outputParts.push("\n");
+                continue;
+            }
+            // Detect code-fence opening (only outside directives)
+            if (depth === 0) {
+                const fenceMatch = CODE_FENCE_RE.exec(line);
+                if (fenceMatch) {
+                    inCodeBlock = true;
+                    codeFenceMarker = fenceMatch[1];
+                    outputParts.push(line);
+                    if (!isLastLine)
+                        outputParts.push("\n");
+                    continue;
+                }
+            }
+            // --- Directive open ---
+            if (parseDirectiveOpen(line)) {
+                depth++;
+                continue;
+            }
+            // --- Directive close ---
+            if (DIRECTIVE_CLOSE_RE.test(line) && depth > 0) {
+                depth--;
+                continue;
+            }
+            // --- Inside directive: suppress ---
+            if (depth > 0) {
+                continue;
+            }
+            // --- Normal text: pass through ---
+            outputParts.push(line);
+            if (!isLastLine)
+                outputParts.push("\n");
+        }
+        return outputParts.join("");
+    };
+}
+//# sourceMappingURL=draft-directive-parser.js.map

package/dist/interaction/draft-directive-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-directive-parser.js","sourceRoot":"","sources":["../../src/interaction/draft-directive-parser.ts"],"names":[],"mappings":"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"}

package/dist/interaction/edit-controller.d.ts

@@ -0,0 +1,62 @@
+import type { ChapterMeta } from "../models/chapter.js";
+import { type ChapterVersionSource } from "../state/chapter-workspace.js";
+import { type TruthAuthority } from "./truth-authority.js";
+export type EditRequest = {
+    readonly kind: "entity-rename";
+    readonly bookId: string;
+    readonly entityType: "protagonist" | "character" | "location" | "organization";
+    readonly oldValue: string;
+    readonly newValue: string;
+} | {
+    readonly kind: "chapter-rewrite";
+    readonly bookId: string;
+    readonly chapterNumber: number;
+    readonly instruction: string;
+} | {
+    readonly kind: "chapter-replace";
+    readonly bookId: string;
+    readonly chapterNumber: number;
+    readonly fullText: string;
+    readonly versionSource?: ChapterVersionSource;
+} | {
+    readonly kind: "chapter-local-edit";
+    readonly bookId: string;
+    readonly chapterNumber: number;
+    readonly instruction: string;
+    readonly targetText?: string;
+    readonly replacementText?: string;
+} | {
+    readonly kind: "truth-file-edit";
+    readonly bookId: string;
+    readonly fileName: string;
+    readonly instruction: string;
+} | {
+    readonly kind: "focus-edit";
+    readonly bookId: string;
+    readonly instruction: string;
+};
+export interface PlannedEditTransaction {
+    readonly transactionType: EditRequest["kind"];
+    readonly bookId: string;
+    readonly chapterNumber?: number;
+    readonly truthAuthority?: TruthAuthority;
+    readonly normalizedFileName?: string;
+    readonly affectedScope: "chapter" | "downstream" | "future" | "book";
+    readonly requiresTruthRebuild: boolean;
+}
+export interface EditExecutionDeps {
+    readonly bookDir: (bookId: string) => string;
+    readonly loadChapterIndex: (bookId: string) => Promise<ReadonlyArray<ChapterMeta>>;
+    readonly saveChapterIndex: (bookId: string, index: ReadonlyArray<ChapterMeta>) => Promise<void>;
+}
+export interface ExecutedEditTransaction {
+    readonly transactionType: EditRequest["kind"];
+    readonly bookId: string;
+    readonly chapterNumber?: number;
+    readonly touchedFiles: ReadonlyArray<string>;
+    readonly reviewRequired: boolean;
+    readonly summary: string;
+}
+export declare function planEditTransaction(request: EditRequest): PlannedEditTransaction;
+export declare function executeEditTransaction(deps: EditExecutionDeps, request: EditRequest): Promise<ExecutedEditTransaction>;
+//# sourceMappingURL=edit-controller.d.ts.map

package/dist/interaction/edit-controller.d.ts.map

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

package/dist/interaction/edit-controller.js

@@ -0,0 +1,381 @@
+import { access, readdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative } from "node:path";
+import { archiveChapterVersion, } from "../state/chapter-workspace.js";
+import { classifyTruthAuthority, normalizeTruthFileName } from "./truth-authority.js";
+function isMissingDirectoryError(error) {
+    return typeof error === "object"
+        && error !== null
+        && "code" in error
+        && error.code === "ENOENT";
+}
+export function planEditTransaction(request) {
+    switch (request.kind) {
+        case "entity-rename":
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                affectedScope: "book",
+                requiresTruthRebuild: true,
+            };
+        case "chapter-rewrite":
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                chapterNumber: request.chapterNumber,
+                affectedScope: "downstream",
+                requiresTruthRebuild: true,
+            };
+        case "chapter-replace":
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                chapterNumber: request.chapterNumber,
+                affectedScope: "chapter",
+                requiresTruthRebuild: true,
+            };
+        case "chapter-local-edit":
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                chapterNumber: request.chapterNumber,
+                affectedScope: "chapter",
+                requiresTruthRebuild: true,
+            };
+        case "truth-file-edit": {
+            const normalizedFileName = normalizeTruthFileName(request.fileName);
+            const truthAuthority = classifyTruthAuthority(normalizedFileName);
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                normalizedFileName,
+                truthAuthority,
+                affectedScope: truthAuthority === "runtime-truth" ? "book" : truthAuthority === "memory" ? "book" : "book",
+                requiresTruthRebuild: truthAuthority === "runtime-truth" || truthAuthority === "memory",
+            };
+        }
+        case "focus-edit":
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                truthAuthority: "direction",
+                normalizedFileName: "current_focus.md",
+                affectedScope: "future",
+                requiresTruthRebuild: false,
+            };
+    }
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function collectEditableFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true }).catch((error) => {
+        if (isMissingDirectoryError(error)) {
+            return [];
+        }
+        throw error;
+    });
+    const files = await Promise.all(entries.map(async (entry) => {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            // Snapshots are frozen history; dot-directories (e.g. chapters/.trash)
+            // hold discarded content — neither may be rewritten by edits.
+            if (entry.name === "snapshots" || entry.name.startsWith("."))
+                return [];
+            return collectEditableFiles(fullPath);
+        }
+        if (!/\.(md|json|ya?ml|txt)$/i.test(entry.name)) {
+            return [];
+        }
+        return [fullPath];
+    }));
+    return files.flat();
+}
+// newValue is LLM-supplied (system boundary). A name embedded into a filename must stay a single
+// path component — reject path separators so a rename target can never escape its directory.
+function assertEntityRenameTargetIsSafe(newValue) {
+    if (/[/\\]/.test(newValue)) {
+        throw new Error(`Invalid rename target "${newValue}": entity names cannot contain path separators.`);
+    }
+}
+// Entity files are addressed by path elsewhere (e.g. roles/主要角色/<name>.md). When the content pass
+// rewrites those path references from oldValue to newValue, the files themselves must be renamed too,
+// or the references dangle. Plan the disk renames up front (before any write) so a name collision
+// aborts the whole transaction cleanly instead of leaving content half-rewritten.
+async function planEntityFileRenames(root, files, oldValue, newValue) {
+    const planned = [];
+    for (const filePath of files) {
+        const base = basename(filePath);
+        if (!base.includes(oldValue)) {
+            continue;
+        }
+        const nextBase = base.split(oldValue).join(newValue);
+        if (nextBase === base) {
+            continue;
+        }
+        const toAbs = join(dirname(filePath), nextBase);
+        const targetExists = await access(toAbs).then(() => true).catch(() => false);
+        if (targetExists) {
+            throw new Error(`Cannot rename "${relative(root, filePath)}" to "${nextBase}": a file with that name already exists.`);
+        }
+        planned.push({ fromAbs: filePath, toAbs, from: relative(root, filePath), to: relative(root, toAbs) });
+    }
+    return planned;
+}
+async function executeEntityRename(deps, request) {
+    const root = deps.bookDir(request.bookId);
+    assertEntityRenameTargetIsSafe(request.newValue);
+    const files = await collectEditableFiles(root);
+    const plannedRenames = await planEntityFileRenames(root, files, request.oldValue, request.newValue);
+    const matcher = new RegExp(escapeRegExp(request.oldValue), "g");
+    const touched = new Set();
+    for (const filePath of files) {
+        const content = await readFile(filePath, "utf-8");
+        const nextContent = content.replace(matcher, request.newValue);
+        if (nextContent === content) {
+            continue;
+        }
+        await writeFile(filePath, nextContent, "utf-8");
+        touched.add(relative(root, filePath));
+    }
+    for (const planned of plannedRenames) {
+        await rename(planned.fromAbs, planned.toAbs);
+        touched.delete(planned.from);
+        touched.add(planned.to);
+    }
+    if (touched.size === 0) {
+        throw new Error(`No occurrences of "${request.oldValue}" were found in "${request.bookId}".`);
+    }
+    const touchedFiles = [...touched];
+    const renameNote = plannedRenames.length > 0
+        ? ` (${plannedRenames.length} file${plannedRenames.length === 1 ? "" : "s"} renamed on disk)`
+        : "";
+    return {
+        transactionType: request.kind,
+        bookId: request.bookId,
+        touchedFiles,
+        reviewRequired: false,
+        summary: `Renamed ${request.oldValue} to ${request.newValue} across ${touchedFiles.length} files${renameNote}.`,
+    };
+}
+async function findChapterPath(root, chapterNumber) {
+    const chaptersDir = join(root, "chapters");
+    const paddedChapter = String(chapterNumber).padStart(4, "0");
+    const chapterFile = (await readdir(chaptersDir).catch((error) => {
+        if (isMissingDirectoryError(error)) {
+            return [];
+        }
+        throw error;
+    }))
+        .find((file) => file.startsWith(`${paddedChapter}_`) && file.endsWith(".md"));
+    if (!chapterFile) {
+        throw new Error(`Chapter ${chapterNumber} not found.`);
+    }
+    return { chaptersDir, chapterPath: join(chaptersDir, chapterFile), chapterFile };
+}
+async function clearChapterRuntimeFiles(root, chapterNumber) {
+    const paddedChapter = String(chapterNumber).padStart(4, "0");
+    const runtimeDir = join(root, "story", "runtime");
+    const runtimeFiles = (await readdir(runtimeDir).catch((error) => {
+        if (isMissingDirectoryError(error)) {
+            return [];
+        }
+        throw error;
+    }))
+        .filter((file) => (file.startsWith(`chapter-${paddedChapter}.`)
+        && file !== `chapter-${paddedChapter}.user-brief.md`));
+    await Promise.all(runtimeFiles.map((file) => unlink(join(runtimeDir, file)).catch(() => undefined)));
+    return runtimeFiles.map((file) => relative(root, join(runtimeDir, file)));
+}
+function markChapterForManualReview(index, chapterNumber, issue, wordCount) {
+    const now = new Date().toISOString();
+    return index.map((chapter) => chapter.number === chapterNumber
+        ? {
+            ...chapter,
+            status: "audit-failed",
+            updatedAt: now,
+            ...(typeof wordCount === "number" ? { wordCount } : {}),
+            auditIssues: [
+                ...chapter.auditIssues.filter((existing) => !existing.includes(issue)),
+                `[warning] ${issue}`,
+            ],
+        }
+        : chapter);
+}
+function roughChapterLength(content) {
+    return content
+        .replace(/^---[\s\S]*?---\s*/m, "")
+        .replace(/^#{1,6}\s+.*$/gm, "")
+        .replace(/\s+/g, "")
+        .length;
+}
+async function executeChapterReplace(deps, request) {
+    const root = deps.bookDir(request.bookId);
+    const fullText = request.fullText.trim();
+    if (!fullText) {
+        throw new Error("Chapter replacement requires fullText.");
+    }
+    const { chapterPath } = await findChapterPath(root, request.chapterNumber);
+    const previousContent = await readFile(chapterPath, "utf-8");
+    await archiveChapterVersion(root, request.chapterNumber, previousContent, request.versionSource ?? "agent");
+    await writeFile(chapterPath, fullText.endsWith("\n") ? fullText : `${fullText}\n`, "utf-8");
+    const removedRuntimeFiles = await clearChapterRuntimeFiles(root, request.chapterNumber);
+    const updatedIndex = markChapterForManualReview(await deps.loadChapterIndex(request.bookId), request.chapterNumber, "Manual chapter replacement requires review before continuation.", roughChapterLength(fullText));
+    await deps.saveChapterIndex(request.bookId, updatedIndex);
+    return {
+        transactionType: request.kind,
+        bookId: request.bookId,
+        chapterNumber: request.chapterNumber,
+        touchedFiles: [
+            relative(root, chapterPath),
+            ...removedRuntimeFiles,
+            "chapters/index.json",
+        ],
+        reviewRequired: true,
+        summary: `Replaced chapter ${request.chapterNumber} and marked it for review.`,
+    };
+}
+async function executeChapterLocalEdit(deps, request) {
+    const root = deps.bookDir(request.bookId);
+    const { chapterPath } = await findChapterPath(root, request.chapterNumber);
+    if (!request.targetText || request.replacementText === undefined) {
+        throw new Error("Chapter-local edits require targetText and replacementText.");
+    }
+    const content = await readFile(chapterPath, "utf-8");
+    const nextContent = replaceChapterTargetText(content, request.targetText, request.replacementText);
+    if (nextContent === content) {
+        throw new Error(`Target text was not found in chapter ${request.chapterNumber}.`);
+    }
+    await archiveChapterVersion(root, request.chapterNumber, content, "agent");
+    await writeFile(chapterPath, nextContent, "utf-8");
+    const removedRuntimeFiles = await clearChapterRuntimeFiles(root, request.chapterNumber);
+    const updatedIndex = markChapterForManualReview(await deps.loadChapterIndex(request.bookId), request.chapterNumber, "Manual text edit requires review before continuation.", roughChapterLength(nextContent));
+    await deps.saveChapterIndex(request.bookId, updatedIndex);
+    return {
+        transactionType: request.kind,
+        bookId: request.bookId,
+        chapterNumber: request.chapterNumber,
+        touchedFiles: [
+            relative(root, chapterPath),
+            ...removedRuntimeFiles,
+            "chapters/index.json",
+        ],
+        reviewRequired: true,
+        summary: `Patched chapter ${request.chapterNumber} and marked it for review.`,
+    };
+}
+function replaceChapterTargetText(content, targetText, replacementText) {
+    const exact = content.split(targetText).join(replacementText);
+    if (exact !== content)
+        return exact;
+    const pattern = flexibleWhitespacePattern(targetText);
+    if (pattern) {
+        let matched = false;
+        const replaced = content.replace(pattern, () => {
+            matched = true;
+            return replacementText;
+        });
+        if (matched)
+            return replaced;
+    }
+    return replaceApproximateParagraph(content, targetText, replacementText);
+}
+function flexibleWhitespacePattern(targetText) {
+    const parts = targetText.trim().split(/\s+/).filter(Boolean);
+    if (parts.length < 2)
+        return null;
+    const escaped = parts.map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+    return new RegExp(escaped.join("\\s+"), "g");
+}
+function replaceApproximateParagraph(content, targetText, replacementText) {
+    const target = normalizeApproximateText(targetText);
+    if (target.length < 24)
+        return content;
+    let best;
+    let secondBestScore = 0;
+    const paragraphPattern = /\S[\s\S]*?(?=\n\s*\n|$)/g;
+    for (const match of content.matchAll(paragraphPattern)) {
+        const raw = match[0] ?? "";
+        const start = match.index ?? 0;
+        const normalized = normalizeApproximateText(raw);
+        if (normalized.length < 24)
+            continue;
+        if (normalized.length < target.length * 0.35 || normalized.length > target.length * 3)
+            continue;
+        const score = approximateTextScore(target, normalized);
+        if (!best || score > best.score) {
+            secondBestScore = best?.score ?? secondBestScore;
+            best = { start, end: start + raw.length, score };
+        }
+        else if (score > secondBestScore) {
+            secondBestScore = score;
+        }
+    }
+    // High threshold + margin keeps this as a target locator, not a semantic rewrite engine.
+    if (!best || best.score < 0.72 || (best.score < 0.86 && best.score - secondBestScore < 0.06)) {
+        return content;
+    }
+    return `${content.slice(0, best.start)}${replacementText}${content.slice(best.end)}`;
+}
+function normalizeApproximateText(text) {
+    return text
+        .normalize("NFKC")
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, "");
+}
+function approximateTextScore(target, candidate) {
+    if (candidate.includes(target) || target.includes(candidate)) {
+        return Math.min(target.length, candidate.length) / Math.max(target.length, candidate.length);
+    }
+    return diceCoefficient(toBigrams(target), toBigrams(candidate));
+}
+function toBigrams(text) {
+    if (text.length < 2)
+        return text ? [text] : [];
+    const out = [];
+    for (let i = 0; i < text.length - 1; i += 1) {
+        out.push(text.slice(i, i + 2));
+    }
+    return out;
+}
+function diceCoefficient(left, right) {
+    if (left.length === 0 || right.length === 0)
+        return 0;
+    const counts = new Map();
+    for (const item of left)
+        counts.set(item, (counts.get(item) ?? 0) + 1);
+    let overlap = 0;
+    for (const item of right) {
+        const count = counts.get(item) ?? 0;
+        if (count <= 0)
+            continue;
+        overlap += 1;
+        counts.set(item, count - 1);
+    }
+    return (2 * overlap) / (left.length + right.length);
+}
+export async function executeEditTransaction(deps, request) {
+    switch (request.kind) {
+        case "entity-rename":
+            return executeEntityRename(deps, request);
+        case "chapter-replace":
+            return executeChapterReplace(deps, request);
+        case "chapter-local-edit":
+            return executeChapterLocalEdit(deps, request);
+        case "truth-file-edit": {
+            const root = deps.bookDir(request.bookId);
+            const normalizedFileName = normalizeTruthFileName(request.fileName);
+            const filePath = join(root, "story", normalizedFileName);
+            await writeFile(filePath, request.instruction, "utf-8");
+            return {
+                transactionType: request.kind,
+                bookId: request.bookId,
+                touchedFiles: [relative(root, filePath)],
+                reviewRequired: false,
+                summary: `Updated ${normalizedFileName}.`,
+            };
+        }
+        default:
+            throw new Error(`Edit transaction "${request.kind}" is not executable yet.`);
+    }
+}
+//# sourceMappingURL=edit-controller.js.map