petari 0.1.0

package/dist/commands/list.js

@@ -0,0 +1,73 @@
+/**
+ * petari list — 履歴の一覧 (§4.4)。
+ * ID・日時・概要 (CHANGES 先頭行)・対象ファイル数・成否と、履歴全体のサイズを表示する。
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { historyRoot, listHistoryIds, readManifest } from "../infra/history.js";
+import { findProjectRoot } from "../infra/root.js";
+import { out } from "../infra/term.js";
+function dirSize(dir) {
+    let total = 0;
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const p = join(dir, e.name);
+        if (e.isDirectory())
+            total += dirSize(p);
+        else
+            total += statSync(p).size;
+    }
+    return total;
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+/** changes.md の CHANGES 概要の先頭行 (## CHANGES の次の非空行) */
+function summaryLine(historyDir) {
+    const p = join(historyDir, "changes.md");
+    if (!existsSync(p))
+        return "";
+    const lines = readFileSync(p, "utf8").split(/\r?\n/);
+    const start = lines.findIndex((l) => l.trimEnd() === "## CHANGES");
+    for (let i = start + 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line.startsWith("### FILE:"))
+            break;
+        if (line !== "")
+            return line;
+    }
+    return "";
+}
+export async function listCommand(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: { root: { type: "string" } },
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    const ids = listHistoryIds(root);
+    if (ids.length === 0) {
+        out("履歴がありません。");
+        return 0;
+    }
+    let total = 0;
+    for (const id of [...ids].reverse()) {
+        const dir = join(historyRoot(root), id);
+        total += dirSize(dir);
+        const m = readManifest(root, id);
+        if (m === null) {
+            out(`${id}  (manifest なし)`);
+            continue;
+        }
+        const appliedCount = m.files.filter((f) => f.applied).length;
+        const status = m.success ? "成功" : m.partial ? "部分適用" : "失敗";
+        const summary = summaryLine(dir);
+        out(`${id}  ${status}  ${appliedCount} ファイル  ${summary}`);
+    }
+    out("");
+    out(`履歴 ${ids.length} 件 / 合計 ${formatSize(total)} (.petari/history)`);
+    return 0;
+}

package/dist/commands/protocol.js

@@ -0,0 +1,9 @@
+/**
+ * petari protocol — 規約文を標準出力に出す (§4.5)。
+ * slnmix / repomix 連携の single source。
+ */
+import { PROTOCOL_TEXT } from "../assets/protocol.js";
+export async function protocolCommand(_argv) {
+    process.stdout.write(PROTOCOL_TEXT);
+    return 0;
+}

package/dist/commands/show.js

@@ -0,0 +1,162 @@
+/**
+ * petari show <ID> — VS Code のネイティブ差分ビューで履歴を表示 (§4.3)。
+ * - 既定: before vs after (AI の変更そのもの)
+ * - --mine: after vs 現在のファイル = 適用後の手修正分だけを可視化
+ * - --changes: 保存済み changes.md の CHANGES セクション (概要・Mermaid) を表示
+ * 複数ファイルの履歴はファイル一覧を提示して選択させる (--file で直接指定も可)。
+ */
+import { execFile } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { parseArgs } from "node:util";
+import { promisify } from "node:util";
+import { invalidPathReason } from "../core/applier.js";
+import { parseChanges } from "../core/parser.js";
+import { loadConfig } from "../infra/config.js";
+import { historyRoot, listHistoryIds, readManifest } from "../infra/history.js";
+import { createInterface } from "node:readline/promises";
+import { findProjectRoot } from "../infra/root.js";
+import { err, out } from "../infra/term.js";
+const execFileP = promisify(execFile);
+/**
+ * vscodeCommand の形式制限 (セキュリティレビュー指摘 3)。
+ * プロジェクト設定はリポジトリに同梱され得るため、リポジトリ内のスクリプトを
+ * 指せる相対パス (./evil.sh 等) を拒否する。PATH 上のコマンド名か絶対パスのみ許可。
+ */
+export function invalidVscodeCommandReason(cmd) {
+    if (cmd.trim() === "")
+        return "vscodeCommand が空です";
+    if (cmd.startsWith("\\\\") || cmd.startsWith("//")) {
+        return "vscodeCommand に UNC パスは使えません";
+    }
+    if ((cmd.includes("/") || cmd.includes("\\")) && !isAbsolute(cmd)) {
+        return "vscodeCommand に相対パスは使えません (コマンド名または絶対パスを指定してください)";
+    }
+    return null;
+}
+let emptyFileCache = null;
+function emptyFile() {
+    if (emptyFileCache === null) {
+        emptyFileCache = join(mkdtempSync(join(tmpdir(), "petari-")), "empty");
+        writeFileSync(emptyFileCache, "");
+    }
+    return emptyFileCache;
+}
+/** 差分対象のファイルパス組を解決する (create/delete の欠損側は空ファイル) */
+export function resolveDiffPair(root, historyDir, entry, mine) {
+    const before = join(historyDir, "before", entry.path);
+    const after = join(historyDir, "after", entry.path);
+    const current = join(root, entry.path);
+    if (mine) {
+        if (entry.op === "delete")
+            return { error: `${entry.path} は delete のため --mine の比較対象がありません` };
+        if (!existsSync(current))
+            return { error: `${entry.path} は現在存在しません (undo 済み?)` };
+        return { left: after, right: current, title: `${entry.path} (適用直後 → 現在 = 手修正分)` };
+    }
+    return {
+        left: existsSync(before) ? before : emptyFile(),
+        right: existsSync(after) ? after : emptyFile(),
+        title: `${entry.path} (before → after)`,
+    };
+}
+async function pickEntry(entries) {
+    out("対象ファイルを選択してください:");
+    entries.forEach((e, i) => out(`  ${i + 1}. ${e.op.padEnd(7)} ${e.path}`));
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question(`番号 [1-${entries.length}]: `)).trim();
+        const n = Number.parseInt(answer, 10);
+        if (Number.isNaN(n) || n < 1 || n > entries.length)
+            return null;
+        return entries[n - 1];
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function showCommand(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            root: { type: "string" },
+            mine: { type: "boolean", default: false },
+            changes: { type: "boolean", default: false },
+            file: { type: "string" },
+        },
+        allowPositionals: true,
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    const config = loadConfig(root);
+    const ids = listHistoryIds(root);
+    if (ids.length === 0) {
+        err("petari: 履歴がありません");
+        return 1;
+    }
+    const id = positionals[0] ?? ids[ids.length - 1];
+    const manifest = readManifest(root, id);
+    if (manifest === null) {
+        err(`petari: 履歴 ${id} が見つかりません (petari list で確認してください)`);
+        return 1;
+    }
+    const hdir = join(historyRoot(root), id);
+    // --changes: CHANGES セクション (概要・影響一覧・Mermaid) の表示 (§13-4)
+    if (values.changes) {
+        const text = readFileSync(join(hdir, "changes.md"), "utf8");
+        const { changeSet } = parseChanges(text);
+        out(changeSet.header !== "" ? changeSet.header : "(CHANGES セクションがありません)");
+        return 0;
+    }
+    const applied = manifest.files.filter((f) => f.applied);
+    if (applied.length === 0) {
+        err(`petari: 履歴 ${id} に適用済みファイルがありません`);
+        return 1;
+    }
+    let entry;
+    if (values.file !== undefined) {
+        const found = applied.find((e) => e.path === values.file);
+        if (found === undefined) {
+            err(`petari: ${values.file} は履歴 ${id} にありません`);
+            return 1;
+        }
+        entry = found;
+    }
+    else if (applied.length === 1) {
+        entry = applied[0];
+    }
+    else {
+        const picked = await pickEntry(applied);
+        if (picked === null) {
+            err("petari: 中止しました");
+            return 1;
+        }
+        entry = picked;
+    }
+    // manifest は改ざんされ得るため、パスと起動コマンドをここでも検証する (§9)
+    const pathReason = invalidPathReason(entry.path);
+    if (pathReason !== null) {
+        err(`petari: manifest のパスが不正です: ${entry.path} (${pathReason})`);
+        return 1;
+    }
+    const cmdReason = invalidVscodeCommandReason(config.vscodeCommand);
+    if (cmdReason !== null) {
+        err(`petari: ${cmdReason}: ${config.vscodeCommand}`);
+        return 1;
+    }
+    const pair = resolveDiffPair(root, hdir, entry, values.mine);
+    if ("error" in pair) {
+        err(`petari: ${pair.error}`);
+        return 1;
+    }
+    out(`${config.vscodeCommand} --diff で開きます: ${pair.title}`);
+    try {
+        await execFileP(config.vscodeCommand, ["--diff", pair.left, pair.right]);
+    }
+    catch (e) {
+        err(`petari: ${config.vscodeCommand} の起動に失敗しました: ${e instanceof Error ? e.message : String(e)}`);
+        err("  .petari/config.json の vscodeCommand を確認してください");
+        return 1;
+    }
+    return 0;
+}

package/dist/commands/undo.js

@@ -0,0 +1,107 @@
+/**
+ * petari undo [ID] — 履歴の巻き戻し (§4.2)。
+ * manifest の操作種別に基づき逆適用する:
+ *   replace/rewrite → before を書き戻し / create → ファイル削除 / delete → before から復元
+ * 適用後に手修正されている場合 (現状ハッシュ ≠ after ハッシュ) は警告して確認する。
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { invalidPathReason } from "../core/applier.js";
+import { loadConfig } from "../infra/config.js";
+import { deleteFile, isInsideRoot, readFileState, sha256, writeBytes } from "../infra/files.js";
+import { historyRoot, listHistoryIds, readManifest } from "../infra/history.js";
+import { confirm } from "../infra/prompt.js";
+import { findProjectRoot } from "../infra/root.js";
+import { err, out } from "../infra/term.js";
+export async function undoCommand(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            root: { type: "string" },
+            yes: { type: "boolean", short: "y", default: false },
+        },
+        allowPositionals: true,
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    loadConfig(root); // 設定エラーの早期検出のみ
+    const ids = listHistoryIds(root);
+    if (ids.length === 0) {
+        err("petari: 履歴がありません");
+        return 1;
+    }
+    const id = positionals[0] ?? ids[ids.length - 1];
+    const manifest = readManifest(root, id);
+    if (manifest === null) {
+        err(`petari: 履歴 ${id} が見つかりません (petari list で確認してください)`);
+        return 1;
+    }
+    const hdir = join(historyRoot(root), id);
+    const applied = manifest.files.filter((f) => f.applied);
+    if (applied.length === 0) {
+        err(`petari: 履歴 ${id} に適用済みファイルがありません`);
+        return 1;
+    }
+    // 逆適用の材料を全件検証してから書き込む (undo 自体も all-or-nothing)
+    const actions = [];
+    for (const entry of applied) {
+        // manifest は改ざんされ得るため、apply と同じパス検証をここでも行う (§9)
+        const pathReason = invalidPathReason(entry.path);
+        if (pathReason !== null) {
+            err(`petari: manifest のパスが不正です: ${entry.path} (${pathReason})`);
+            return 1;
+        }
+        const abs = join(root, entry.path);
+        if (!isInsideRoot(root, abs)) {
+            err(`petari: manifest のパスがプロジェクトルートの外を指しています: ${entry.path}`);
+            return 1;
+        }
+        const current = readFileState(abs);
+        if (current.symlink) {
+            err(`petari: シンボリックリンクは巻き戻し対象外です: ${entry.path}`);
+            return 1;
+        }
+        let restoreBytes = null;
+        if (entry.op !== "create") {
+            const beforePath = join(hdir, "before", entry.path);
+            if (!existsSync(beforePath)) {
+                err(`petari: 履歴の before ファイルが欠損しています: ${beforePath}`);
+                return 1;
+            }
+            restoreBytes = new Uint8Array(readFileSync(beforePath));
+        }
+        const modified = entry.op === "delete"
+            ? current.exists // delete したはずのファイルが存在する
+            : !current.exists ||
+                current.bytes === null ||
+                sha256(current.bytes) !== entry.afterSha256;
+        actions.push({ entry, restoreBytes, modified });
+    }
+    const modified = actions.filter((a) => a.modified);
+    out(`履歴 ${id} を巻き戻します (${applied.length} ファイル)`);
+    if (modified.length > 0) {
+        out("警告: 適用後に手修正されたファイルがあります。巻き戻すと手修正が失われます:");
+        for (const a of modified)
+            out(`  ${a.entry.path}`);
+    }
+    if (!values.yes) {
+        if (!(await confirm(modified.length > 0 ? "手修正が失われますが戻しますか?" : "巻き戻しますか?"))) {
+            out("中止しました。");
+            return 1;
+        }
+    }
+    for (const a of actions) {
+        const abs = join(root, a.entry.path);
+        if (a.entry.op === "create") {
+            if (existsSync(abs))
+                deleteFile(abs);
+            out(`  削除: ${a.entry.path} (create の巻き戻し)`);
+        }
+        else {
+            writeBytes(abs, a.restoreBytes);
+            out(`  復元: ${a.entry.path}`);
+        }
+    }
+    out(`巻き戻しました (履歴 ID: ${id})`);
+    return 0;
+}

package/dist/core/applier.js

@@ -0,0 +1,150 @@
+import { EncodingError, decodeFile, encodeDocument, findUnencodable, makeDocument, } from "./encoding.js";
+import { STAGE_LABEL, matchBlock } from "./matcher.js";
+/** Windows の予約デバイス名 (拡張子付きも不可) */
+const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\..+)?$/i;
+/** §9: プロジェクトルート相対のみ。絶対パス・`..`・`~`・Windows 特殊パスを拒否 */
+export function invalidPathReason(path) {
+    if (path.trim() === "")
+        return "パスが空です";
+    if (path.startsWith("/") || path.startsWith("\\\\") || /^[a-zA-Z]:/.test(path)) {
+        return "絶対パスは使えません (プロジェクトルート相対で指定してください)";
+    }
+    if (path.includes(":"))
+        return "':' を含むパスは使えません (Windows の代替データストリーム対策)";
+    const segments = path.split("/");
+    if (segments.includes(".."))
+        return "'..' を含むパスは使えません";
+    if (path.startsWith("~"))
+        return "'~' で始まるパスは使えません";
+    // Windows は末尾のドット/空白を無視して解釈するため、除去してから予約名判定する
+    if (segments.some((s) => WINDOWS_RESERVED.test(s.replace(/[. ]+$/, "")))) {
+        return "Windows の予約デバイス名 (CON, NUL, COM1 等) を含むパスは使えません";
+    }
+    return null;
+}
+function fileFailure(change, kind, message) {
+    return {
+        change,
+        failures: [{ path: change.path, kind, message }],
+        afterBytes: null,
+        appliedBlocks: [],
+        totalBlocks: change.op === "replace" ? change.blocks.length : 0,
+    };
+}
+function planReplace(change, state, fallbackEol) {
+    let doc;
+    try {
+        doc = decodeFile(state.bytes);
+    }
+    catch (e) {
+        return fileFailure(change, "undecodable", e instanceof EncodingError ? e.message : String(e));
+    }
+    const failures = [];
+    const applied = [];
+    let docLines = doc.lines;
+    let textLines = docLines.map((l) => l.text);
+    for (const block of change.blocks) {
+        const m = matchBlock(textLines, block);
+        if (!m.ok) {
+            const message = m.reason === "ambiguous"
+                ? `ブロック ${block.index}: SEARCH が ${m.count} 箇所にマッチしました (${STAGE_LABEL[m.stage]})。一意に特定できる範囲を含めてください`
+                : `ブロック ${block.index}: SEARCH が現在のファイル内容に見つかりません`;
+            failures.push({ path: change.path, kind: m.reason === "ambiguous" ? "block-ambiguous" : "block-not-found", message, block });
+            continue;
+        }
+        const replacement = m.replacement;
+        const bad = findUnencodable(replacement.join("\n"), doc.encoding);
+        if (bad.length > 0) {
+            failures.push({
+                path: change.path,
+                kind: "unencodable",
+                message: `ブロック ${block.index}: REPLACE 側に Shift_JIS へ変換できない文字が含まれています: ${bad.join(" ")}`,
+                block,
+            });
+            continue;
+        }
+        applied.push({
+            block,
+            stage: m.stage,
+            start: m.start,
+            removed: textLines.slice(m.start, m.end),
+            inserted: replacement,
+        });
+        const newDocLines = replacement.map((text) => ({ text, raw: null, eol: null }));
+        docLines = [...docLines.slice(0, m.start), ...newDocLines, ...docLines.slice(m.end)];
+        textLines = [...textLines.slice(0, m.start), ...replacement, ...textLines.slice(m.end)];
+    }
+    const afterBytes = applied.length > 0 ? encodeDocument({ ...doc, lines: docLines }, fallbackEol) : null;
+    return {
+        change,
+        failures,
+        afterBytes,
+        appliedBlocks: applied,
+        totalBlocks: change.blocks.length,
+    };
+}
+function planFile(change, state, newFile) {
+    const pathReason = invalidPathReason(change.path);
+    if (pathReason !== null)
+        return fileFailure(change, "path-invalid", pathReason);
+    if (state.escapesRoot === true) {
+        return fileFailure(change, "path-invalid", "シンボリックリンクを経由してプロジェクトルートの外を指しています (§9)");
+    }
+    if (state.symlink) {
+        return fileFailure(change, "symlink", "シンボリックリンクは書き換え対象外です (§9)");
+    }
+    switch (change.op) {
+        case "create": {
+            if (state.exists) {
+                return fileFailure(change, "target-exists", "create 指定ですがファイルが既に存在します (全文置き換えなら rewrite を使用)");
+            }
+            const bad = findUnencodable(change.content.join("\n"), newFile.encoding);
+            if (bad.length > 0) {
+                return fileFailure(change, "unencodable", `新規ファイルの既定エンコーディング (${newFile.encoding}) に変換できない文字: ${bad.join(" ")}`);
+            }
+            const doc = makeDocument(change.content, newFile);
+            return { change, failures: [], afterBytes: encodeDocument(doc), appliedBlocks: [], totalBlocks: 0 };
+        }
+        case "rewrite": {
+            if (!state.exists) {
+                return fileFailure(change, "target-missing", "rewrite 指定ですがファイルが存在しません (新規作成なら create を使用)");
+            }
+            let doc;
+            try {
+                doc = decodeFile(state.bytes);
+            }
+            catch (e) {
+                return fileFailure(change, "undecodable", e instanceof EncodingError ? e.message : String(e));
+            }
+            const bad = findUnencodable(change.content.join("\n"), doc.encoding);
+            if (bad.length > 0) {
+                return fileFailure(change, "unencodable", `Shift_JIS へ変換できない文字が含まれています: ${bad.join(" ")}`);
+            }
+            // 既存のエンコーディング・BOM・支配的 EOL・末尾改行の有無を維持して全文を差し替える (§8)
+            const lines = change.content.map((text) => ({ text, raw: null, eol: null }));
+            const afterBytes = encodeDocument({ ...doc, lines });
+            return { change, failures: [], afterBytes, appliedBlocks: [], totalBlocks: 0 };
+        }
+        case "delete": {
+            if (!state.exists) {
+                return fileFailure(change, "target-missing", "delete 指定ですがファイルが存在しません");
+            }
+            return { change, failures: [], afterBytes: null, appliedBlocks: [], totalBlocks: 0 };
+        }
+        case "replace": {
+            if (!state.exists) {
+                return fileFailure(change, "target-missing", "replace 指定ですがファイルが存在しません");
+            }
+            return planReplace(change, state, newFile.eol);
+        }
+    }
+}
+/** 全ファイルをドライラン検証し適用計画を立てる (§4.1 手順 2)。書き込みは行わない */
+export function planChangeSet(changeSet, states, newFile) {
+    const outcomes = changeSet.files.map((change) => {
+        const state = states.get(change.path) ?? { exists: false, symlink: false, bytes: null };
+        return planFile(change, state, newFile);
+    });
+    const failures = outcomes.flatMap((o) => o.failures);
+    return { outcomes, failures, ok: failures.length === 0 };
+}

package/dist/core/encoding.js

@@ -0,0 +1,135 @@
+/**
+ * エンコーディングと改行の保全 (§8 — 最重要要件)。
+ *
+ * 方針: ファイルを「行単位のドキュメント」として扱い、各行の元バイト列 (raw) と
+ * 実際の改行コードを保持する。書き込み時、変更していない行は raw をそのまま出力する。
+ * これにより Shift_JIS の重複マッピング (NEC/IBM 拡張等) があっても、
+ * 触っていない行のバイト列は原理的に変わらない。再エンコードは変更行のみ。
+ */
+import { sjisEncode } from "./sjis.js";
+export class EncodingError extends Error {
+}
+const BOM = Uint8Array.of(0xef, 0xbb, 0xbf);
+const LF = Uint8Array.of(0x0a);
+const CRLF = Uint8Array.of(0x0d, 0x0a);
+function tryDecode(bytes, label) {
+    try {
+        new TextDecoder(label, { fatal: true }).decode(bytes);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * バイト列からエンコーディング・BOM・改行を検出し、行ドキュメントに分解する (§8)。
+ * 判定順: UTF-16 BOM → 非対応エラー / UTF-8 BOM / 厳密 UTF-8 / Shift_JIS / エラー。
+ * (対象環境のエンコーディングは UTF-8 / Shift_JIS の 2 択という前提。ASCII のみの
+ *  ファイルは UTF-8 と判定されるが、どちらで書いても同一バイトになるため実害はない)
+ */
+export function decodeFile(bytes) {
+    if (bytes.length >= 2) {
+        const [b0, b1] = [bytes[0], bytes[1]];
+        if ((b0 === 0xff && b1 === 0xfe) || (b0 === 0xfe && b1 === 0xff)) {
+            throw new EncodingError("UTF-16 のファイルは対象外です (UTF-8 か Shift_JIS に変換してから使用してください)");
+        }
+    }
+    let hasBom = false;
+    let body = bytes;
+    if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+        hasBom = true;
+        body = bytes.subarray(3);
+    }
+    let encoding;
+    if (hasBom || tryDecode(body, "utf-8")) {
+        if (hasBom && !tryDecode(body, "utf-8")) {
+            throw new EncodingError("UTF-8 BOM 付きですが本文が UTF-8 として不正です");
+        }
+        encoding = "utf8";
+    }
+    else if (tryDecode(body, "shift_jis")) {
+        encoding = "shift_jis";
+    }
+    else {
+        throw new EncodingError("エンコーディングを判定できません (UTF-8 でも Shift_JIS でもありません)");
+    }
+    // 行分割はバイトレベルで行う。UTF-8 の継続バイトも Shift_JIS の 2 バイト目
+    // (0x40-0xFC) も 0x0A/0x0D と衝突しないため安全。
+    const decoder = new TextDecoder(encoding === "utf8" ? "utf-8" : "shift_jis", { fatal: true });
+    const lines = [];
+    let lineStart = 0;
+    let crlfCount = 0;
+    let lfCount = 0;
+    for (let i = 0; i < body.length; i++) {
+        if (body[i] === 0x0a) {
+            const isCrlf = i > lineStart && body[i - 1] === 0x0d;
+            const raw = body.subarray(lineStart, isCrlf ? i - 1 : i);
+            lines.push({ text: decoder.decode(raw), raw, eol: isCrlf ? "crlf" : "lf" });
+            if (isCrlf)
+                crlfCount++;
+            else
+                lfCount++;
+            lineStart = i + 1;
+        }
+    }
+    let trailingNewline = lines.length > 0;
+    if (lineStart < body.length) {
+        const raw = body.subarray(lineStart);
+        lines.push({ text: decoder.decode(raw), raw, eol: null });
+        trailingNewline = false;
+    }
+    const eol = crlfCount === 0 && lfCount === 0 ? null : crlfCount >= lfCount ? "crlf" : "lf";
+    return { encoding, hasBom, eol, trailingNewline, lines };
+}
+function encodeText(text, encoding) {
+    if (encoding === "utf8")
+        return new TextEncoder().encode(text);
+    const { bytes, unencodable } = sjisEncode(text);
+    if (unencodable.length > 0) {
+        throw new EncodingError(`Shift_JIS に変換できない文字が含まれています: ${unencodable.join(" ")}`);
+    }
+    return bytes;
+}
+/**
+ * 行ドキュメントをバイト列に書き戻す。raw を持つ行はバイト列をそのまま出力し、
+ * raw のない行 (新規・置換) のみエンコードする。
+ * fallbackEol は改行を 1 つも持たないファイルに行を追加した場合にのみ使われる。
+ */
+export function encodeDocument(doc, fallbackEol = "lf") {
+    const chunks = [];
+    if (doc.hasBom)
+        chunks.push(BOM);
+    const defaultEol = doc.eol ?? fallbackEol;
+    for (let i = 0; i < doc.lines.length; i++) {
+        const line = doc.lines[i];
+        chunks.push(line.raw ?? encodeText(line.text, doc.encoding));
+        const isLast = i === doc.lines.length - 1;
+        if (!isLast || doc.trailingNewline) {
+            chunks.push((line.eol ?? defaultEol) === "crlf" ? CRLF : LF);
+        }
+    }
+    const total = chunks.reduce((n, c) => n + c.length, 0);
+    const out = new Uint8Array(total);
+    let off = 0;
+    for (const c of chunks) {
+        out.set(c, off);
+        off += c.length;
+    }
+    return out;
+}
+/** 新規ファイル (create) 用のドキュメントを作る。既定は UTF-8 / LF / 末尾改行あり (§8) */
+export function makeDocument(textLines, opts) {
+    return {
+        encoding: opts.encoding,
+        hasBom: opts.bom ?? false,
+        eol: opts.eol,
+        trailingNewline: opts.trailingNewline ?? textLines.length > 0,
+        lines: textLines.map((text) => ({ text, raw: null, eol: null })),
+    };
+}
+/** テキストが対象エンコーディングで表現できない文字を返す (適用前検証・§8) */
+export function findUnencodable(text, encoding) {
+    if (encoding === "utf8")
+        return [];
+    return sjisEncode(text).unencodable;
+}