petari 0.9.0 → 0.10.0

package/README.md

@@ -94,7 +94,8 @@ slnmix の出力) が実ファイルとずれている**可能性が高いです
 
 主なオプション: `--dry-run` (検証と差分プレビューのみ) / `--partial` (成功分のみ適用) /
 `--root <dir>` / `--yes` / `--clip-report` (失敗レポートをクリップボードへ。v0.5.0 から既定で自動コピーされるため、config で無効化した場合の個別指定用) /
-`--no-vbproj` (create した .vb の .vbproj 自動登録を今回だけ無効化)
+`--no-vbproj` (create した .vb の .vbproj 自動登録を今回だけ無効化) /
+`--force` (適用済みの changes.md でも再適用する。下記「二重適用の防止」を今回だけ解除)
 
 ## 特徴
 
@@ -102,7 +103,11 @@ slnmix の出力) が実ファイルとずれている**可能性が高いです
 - **冪等 (再実行に安全)**: SEARCH が見つからなくても REPLACE の内容が既にファイルに
   存在すれば「適用済み」として成功扱いでスキップ。同じ changes.md を 2 回実行しても
   失敗せず、適用済み・未適用が混在していても未適用分だけを適用する。
+  SEARCH の前後に行を足す追記型の変更も、足す行が既にあれば「適用済み」になる。
   結果は `適用 / 済み / 失敗` の 3 状態で表示
+- **二重適用の防止**: 適用した changes.md の指紋を履歴に記録し、同じ changes.md を
+  もう一度渡して書き込みが発生する場合は何も書かずに止める (ファイル名・前置き・改行コードが
+  違っても同じ変更なら検出)。`petari undo` で戻したものは再適用でき、それ以外は `--force` で再適用
 - **エンコーディング保全**: Shift_JIS / UTF-8 (BOM 有無)・CRLF / LF・末尾改行を完全維持。
   変更していない行は元のバイト列をそのまま書き戻す (レガシー VB.NET 資産でも安全)
 - **規約逸脱への耐性 (寛容パース)**: AI がマーカーの記号数・見出しレベルを崩したり

package/dist/assets/protocol.js

@@ -6,7 +6,7 @@
  * 制約: slnmix (v0.7.0+) はこのテキストを <instruction>...</instruction> で囲んで
  * 出力へ連結するため、規約文に <instruction> という文字列を含めないこと。
  */
-export const PROTOCOL_VERSION = 3;
+export const PROTOCOL_VERSION = 4;
 export const PROTOCOL_TEXT = `<!-- petari protocol v${PROTOCOL_VERSION} -->
 # コード変更の出力規約 (changes.md)
 
@@ -69,7 +69,9 @@ new code
 2. SEARCH ブロックの内容は、**現在のファイルから一字一句そのまま** (インデント・空白を含めて) コピーする。
    記憶に頼って書き換えたり要約したりしない
 3. SEARCH ブロックには **ファイル内で一意に特定できる範囲** を含める
-   (同じコードが複数箇所にある場合は、前後の行を含めて一意にする)
+   (同じコードが複数箇所にある場合は、前後の行を含めて一意にする)。
+   ただし一意に特定できる範囲のうち **最小** (目安 3〜8 行) にする。大きな範囲は
+   一致に失敗しやすい。ファイルの過半が変わるなら rewrite を使う
 4. パスはプロジェクトルートからの相対パスを / 区切りで書く。絶対パスや .. は使わない
 5. 同じファイルへの変更は 1 つの FILE セクションにまとめる (セクションを重複させない)
 6. FILE セクションの間に説明文を書かない。説明はすべて冒頭の CHANGES セクションに書く

package/dist/commands/apply.js

@@ -7,7 +7,9 @@ import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { invalidPathReason, planChangeSet, } from "../core/applier.js";
+import { changeSetFingerprint } from "../core/fingerprint.js";
 import { PRESENCE_STAGE_LABEL } from "../core/matcher.js";
+import { fixedNewFile, resolveNewFileStyle } from "../core/new-file-style.js";
 import { parseChangesRecovering } from "../core/parser.js";
 import { buildBlankInsensitiveNote, buildFailureReport, buildParseErrorReport, } from "../core/report.js";
 import { readClipboard, writeClipboard } from "../infra/clipboard.js";
@@ -15,10 +17,12 @@ import { loadConfig } from "../infra/config.js";
 import { findRecentChangesFiles, resolveDownloadsDir, } from "../infra/downloads.js";
 import { deleteFile, isInsideRoot, readFileState, sha256, writeBytes } from "../infra/files.js";
 import { gitDirtyFiles } from "../infra/git.js";
+import { collectStyleSampleGroups } from "../infra/new-file-style.js";
 import { err, out, outEmphasis } from "../infra/term.js";
-import { beginHistory, createHistoryId, finishHistory, pruneHistory, } from "../infra/history.js";
+import { beginHistory, createHistoryId, findAppliedHistory, finishHistory, pruneHistory, } from "../infra/history.js";
 import { confirm } from "../infra/prompt.js";
 import { findProjectRoot } from "../infra/root.js";
+import { formatVbprojPlan, planVbprojRegistrations } from "./vbproj-register.js";
 /** このファイルは書き込み対象か (適用済みのみのファイルは書き込み不要なので含めない) */
 function isApplicable(o) {
     if (o.alreadyApplied)
@@ -64,7 +68,8 @@ function printAlreadyApplied(outcomes) {
             continue;
         }
         for (const b of o.alreadyAppliedBlocks) {
-            out(`  replace ${o.change.path} — ブロック ${b.block.index}: REPLACE が既に存在 (${PRESENCE_STAGE_LABEL[b.stage]})`);
+            const what = b.insertion === true ? "追記する行が SEARCH の前後に既に存在" : "REPLACE が既に存在";
+            out(`  replace ${o.change.path} — ブロック ${b.block.index}: ${what} (${PRESENCE_STAGE_LABEL[b.stage]})`);
         }
     }
 }
@@ -78,6 +83,10 @@ export async function applyCommand(argv) {
             yes: { type: "boolean", short: "y", default: false },
             clip: { type: "boolean", default: false },
             "clip-report": { type: "boolean", default: false },
+            // create した .vb の .vbproj 自動登録を今回だけ無効化 (config vbproj.register の一時上書き)
+            "no-vbproj": { type: "boolean", default: false },
+            // 履歴で適用済みの changes.md でも再適用する (二重適用防止の解除・§6.1)
+            force: { type: "boolean", default: false },
         },
         allowPositionals: true,
     });
@@ -185,6 +194,14 @@ export async function applyCommand(argv) {
             out(`  ${r.line} 行目: ${r.message}`);
         out("");
     }
+    // 同じ changes.md を以前に適用していないか (取り違え・二重実行の検出・§6.1)。
+    // 旧形式の履歴は保存済みの changes.md 原本をパースして指紋を算出する
+    const fingerprint = changeSetFingerprint(changeSet);
+    const previousId = findAppliedHistory(root, fingerprint, (text) => {
+        const r = parseChangesRecovering(stripBom(text));
+        return r.issues.length > 0 ? null : changeSetFingerprint(r.changeSet);
+    });
+    const previousNote = previousId !== null ? `この changes.md は適用済みです (履歴 ID: ${previousId})` : null;
     // 2. 全ブロックのドライラン検証
     const states = new Map();
     for (const f of changeSet.files) {
@@ -200,18 +217,51 @@ export async function applyCommand(argv) {
         }
         states.set(f.path, readFileState(abs));
     }
-    const plan = planChangeSet(changeSet, states, config.newFile);
+    // 新規ファイルの形式: encoding "auto" なら作成先の既存ファイルから推定する (設計書 §11.2)
+    const newFileBasis = new Map();
+    const resolveNewFile = (change) => {
+        if (config.newFile.encoding !== "auto" || change.op !== "create") {
+            return fixedNewFile(config.newFile);
+        }
+        // 不正パス・symlink 経由でルート外を指すパスは手本を探さない (検証段階で失敗する)
+        if (invalidPathReason(change.path) !== null || states.get(change.path)?.escapesRoot === true) {
+            return fixedNewFile(config.newFile);
+        }
+        const r = resolveNewFileStyle(change.path, config.newFile, collectStyleSampleGroups(root, change.path));
+        if (r.basis !== null)
+            newFileBasis.set(change.path, r.basis);
+        return r.config;
+    };
+    const plan = planChangeSet(changeSet, states, resolveNewFile);
     // 3. 失敗があれば何も書き込まずレポート (§4.1, §7)
     if (!plan.ok && !values.partial) {
         err(`petari: 検証に失敗しました (${plan.failures.length} 件)。何も書き込んでいません。\n`);
+        if (previousNote !== null)
+            err(`注: ${previousNote}。取り違えていないか確認してください\n`);
         await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes, nothingWritten: true }));
         return 1;
     }
     const applicable = plan.outcomes.filter(isApplicable);
+    // create した .vb の旧スタイル .vbproj への登録計画 (設計書 §11.1)。失敗しても create は成功扱い
+    const vbprojEnabled = config.vbproj.register && !values["no-vbproj"];
+    const vbprojPlan = vbprojEnabled
+        ? planVbprojRegistrations(root, applicable)
+        : { writes: new Map(), registrations: [], notes: [] };
+    const printExtras = () => {
+        for (const o of applicable) {
+            const basis = newFileBasis.get(o.change.path);
+            if (basis !== undefined)
+                out(`  新規ファイルの形式: ${o.change.path} → ${basis}`);
+        }
+        for (const line of formatVbprojPlan(vbprojPlan))
+            out(line);
+    };
     if (applicable.length === 0) {
         // 冪等性: 全変更が適用済みなら成功として終了 (書き込み・履歴なし)
         if (plan.ok && plan.outcomes.some((o) => o.alreadyApplied)) {
             out("すべての変更は適用済みです。書き込みは行いませんでした。");
+            if (previousNote !== null)
+                out(`  (${previousNote})`);
             for (const o of plan.outcomes)
                 out(`  ${opLabel(o)}`);
             return 0;
@@ -220,9 +270,28 @@ export async function applyCommand(argv) {
         await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes, nothingWritten: true }));
         return 1;
     }
+    // 適用済みの changes.md で、なお書き込みが発生する = 二重適用のおそれ。--force なしでは止める
+    if (previousNote !== null) {
+        if (values.force) {
+            out(`--force: ${previousNote}。再適用します`);
+        }
+        else if (values["dry-run"]) {
+            out(`警告: ${previousNote}。実際の適用は --force を付けない限り止まります`);
+        }
+        else {
+            err(`petari: ${previousNote}。何も書き込んでいません。`);
+            err("  このまま適用すると次のファイルに書き込みが発生します (二重適用のおそれ):");
+            for (const o of applicable)
+                err(`    ${opLabel(o)}`);
+            err("  取り違えでなければ --force を付けて再実行してください");
+            err("  (petari undo で巻き戻した履歴は対象外です。git 等で手動で戻した場合は --force が必要です)");
+            return 1;
+        }
+    }
     if (values["dry-run"]) {
         out(`dry-run: 適用予定 ${applicable.length} ファイル (書き込みなし)`);
         printPreview(applicable);
+        printExtras();
         printAlreadyApplied(plan.outcomes);
         const dryRunNote = buildBlankInsensitiveNote(plan.outcomes);
         if (dryRunNote !== null)
@@ -238,6 +307,7 @@ export async function applyCommand(argv) {
     out(`適用予定 ${applicable.length} ファイル:`);
     for (const o of applicable)
         out(`  ${opLabel(o)}`);
+    printExtras();
     printAlreadyApplied(plan.outcomes);
     if (plan.failures.length > 0) {
         out(`  (検証失敗 ${plan.failures.length} 件は --partial によりスキップ)`);
@@ -258,6 +328,11 @@ export async function applyCommand(argv) {
     for (const o of applicable) {
         before.set(o.change.path, states.get(o.change.path)?.bytes ?? null);
     }
+    // .vbproj 登録も履歴・undo の対象。changes.md の変更対象でもある .vbproj は元の before を保つ
+    for (const [path, w] of vbprojPlan.writes) {
+        if (!before.has(path))
+            before.set(path, w.before);
+    }
     beginHistory(root, id, changesText, before);
     const after = new Map();
     for (const o of applicable) {
@@ -267,10 +342,18 @@ export async function applyCommand(argv) {
             after.set(o.change.path, null);
         }
         else {
-            writeBytes(abs, o.afterBytes);
-            after.set(o.change.path, o.afterBytes);
+            // 同じ .vbproj への登録があれば登録後の内容 (変更後に登録を重ねたもの) を書く
+            const bytes = vbprojPlan.writes.get(o.change.path)?.after ?? o.afterBytes;
+            writeBytes(abs, bytes);
+            after.set(o.change.path, bytes);
         }
     }
+    for (const [path, w] of vbprojPlan.writes) {
+        if (after.has(path))
+            continue;
+        writeBytes(join(root, path), w.after);
+        after.set(path, w.after);
+    }
     const entries = plan.outcomes.map((o) => {
         const applied = isApplicable(o);
         const beforeBytes = states.get(o.change.path)?.bytes ?? null;
@@ -294,14 +377,32 @@ export async function applyCommand(argv) {
         }
         if (o.alreadyApplied)
             entry.alreadyApplied = true;
+        const registered = vbprojPlan.writes.get(o.change.path)?.registered;
+        if (registered !== undefined)
+            entry.registered = registered;
         return entry;
     });
+    for (const [path, w] of vbprojPlan.writes) {
+        if (entries.some((e) => e.path === path))
+            continue;
+        entries.push({
+            path,
+            op: "vbproj",
+            applied: true,
+            blocks: 0,
+            appliedBlocks: 0,
+            registered: w.registered,
+            beforeSha256: w.before !== null ? sha256(w.before) : null,
+            afterSha256: sha256(w.after),
+        });
+    }
     const manifest = {
         id,
         appliedAt: new Date().toISOString(),
         success: plan.ok,
         partial: values.partial,
         source,
+        changesFingerprint: fingerprint,
         files: entries,
     };
     finishHistory(root, id, manifest, after);
@@ -314,6 +415,7 @@ export async function applyCommand(argv) {
     out(`適用しました (履歴 ID: ${id})`);
     for (const o of applicable)
         out(`  ${opLabel(o)}`);
+    printExtras();
     printAlreadyApplied(plan.outcomes);
     const appliedNote = buildBlankInsensitiveNote(plan.outcomes);
     if (appliedNote !== null)

package/dist/commands/init.js

@@ -11,10 +11,11 @@ import { findProjectRoot } from "../infra/root.js";
 import { err, out } from "../infra/term.js";
 const CONFIG_TEMPLATE = `{
   "downloadsDir": null,
-  "newFile": { "encoding": "utf8", "eol": "lf" },
+  "newFile": { "encoding": "auto" },
   "historyLimit": null,
   "vscodeCommand": "code",
-  "clipReportOnFailure": true
+  "clipReportOnFailure": true,
+  "vbproj": { "register": true }
 }
 `;
 export async function initCommand(argv) {

package/dist/commands/list.js

@@ -63,7 +63,8 @@ export async function listCommand(argv) {
             continue;
         }
         const appliedCount = m.files.filter((f) => f.applied).length;
-        const status = m.success ? "成功" : m.partial ? "部分適用" : "失敗";
+        const status = (m.success ? "成功" : m.partial ? "部分適用" : "失敗") +
+            (m.undoneAt !== undefined ? " (巻き戻し済み)" : "");
         const summary = summaryLine(dir);
         out(`${id}  ${status}  ${appliedCount} ファイル  ${summary}`);
     }

package/dist/commands/show.js

@@ -22,6 +22,7 @@ import { diffLines, toSideBySideRows } from "../core/diff.js";
 import { buildReportPage } from "../core/diff-html.js";
 import { EncodingError, decodeFile } from "../core/encoding.js";
 import { parseChangesRecovering } from "../core/parser.js";
+import { fixedNewFile } from "../core/new-file-style.js";
 import { openInBrowser } from "../infra/browser.js";
 import { loadConfig } from "../infra/config.js";
 import { monacoVendorDir, startDiffServer } from "../infra/diff-server.js";
@@ -225,7 +226,7 @@ async function runEditServer(root, hdir, id, entries, mine, config, noOpen) {
         entries: editEntries,
         root,
         leftLabel: mine ? "適用直後 (after)" : "適用前 (before)",
-        fallbackEol: config.newFile.eol,
+        fallbackEol: fixedNewFile(config.newFile).eol,
     });
     out(`ブラウザ編集サーバーを起動しました: ${handle.url}`);
     out("  終了はページ内の「サーバーを終了」ボタンか Ctrl+C (無操作 30 分で自動終了)");

package/dist/commands/undo.js

@@ -10,7 +10,7 @@ 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 { historyRoot, listHistoryIds, markUndone, readManifest, } from "../infra/history.js";
 import { confirm } from "../infra/prompt.js";
 import { findProjectRoot } from "../infra/root.js";
 import { err, out } from "../infra/term.js";
@@ -103,5 +103,13 @@ export async function undoCommand(argv) {
         }
     }
     out(`巻き戻しました (履歴 ID: ${id})`);
+    // 巻き戻した changes.md は再適用できるよう、二重適用検出の対象から外す (§6.1)
+    try {
+        markUndone(root, id, new Date());
+    }
+    catch (e) {
+        err(`petari: 履歴 ${id} に巻き戻し済みの印を付けられませんでした (${e instanceof Error ? e.message : String(e)})。` +
+            "同じ changes.md を再適用するには --force が必要です");
+    }
     return 0;
 }

package/dist/commands/vbproj-register.js

@@ -0,0 +1,159 @@
+/**
+ * create した .vb の旧スタイル .vbproj への自動登録 (設計書 §11.1 P1-a) — apply の結線部。
+ * 判定・挿入は core/vbproj.ts、探索は infra/vbproj.ts。
+ *
+ * - 登録の失敗は create 自体の成否に影響しない (レポートに載せるだけ)
+ * - 同じ changes.md が .vbproj 自体を変更する場合は、その変更後の内容に対して登録する
+ * - 挿入行以外は元バイト列を書き戻す (行単位ドキュメント・§8)
+ */
+import { existsSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { EncodingError, decodeFile, encodeDocument, findUnencodable, } from "../core/encoding.js";
+import { designerParentName, detectSubType, registerCompileItem, toIncludePath, } from "../core/vbproj.js";
+import { isInsideRoot, readFileState } from "../infra/files.js";
+import { findNearestVbproj } from "../infra/vbproj.js";
+const EMPTY = { writes: new Map(), registrations: [], notes: [] };
+function relDirOf(path) {
+    const d = dirname(path);
+    return d === "." ? "" : d;
+}
+/**
+ * 書き込み対象 (applicable) の outcomes から create された .vb を拾い、登録計画を立てる。
+ * 書き込みは行わない。
+ */
+export function planVbprojRegistrations(root, applicable) {
+    const creates = applicable
+        .filter((o) => o.change.op === "create" && /\.vb$/i.test(o.change.path))
+        // X.vb を X.Designer.vb より先に登録する (VS の並びに合わせる。安定ソート)
+        .map((o, i) => ({ o, i, designer: designerParentName(basename(o.change.path)) !== null }))
+        .sort((a, b) => Number(a.designer) - Number(b.designer) || a.i - b.i)
+        .map((x) => x.o);
+    if (creates.length === 0)
+        return EMPTY;
+    const createdPaths = new Set(applicable.filter((o) => o.change.op === "create").map((o) => o.change.path.toLowerCase()));
+    const loaded = new Map();
+    const plan = { writes: new Map(), registrations: [], notes: [] };
+    const load = (vbproj) => {
+        const cached = loaded.get(vbproj);
+        if (cached !== undefined)
+            return cached;
+        const result = loadVbproj(root, vbproj, applicable);
+        loaded.set(vbproj, result);
+        return result;
+    };
+    for (const o of creates) {
+        const file = o.change.path;
+        const lookup = findNearestVbproj(root, relDirOf(file));
+        if (lookup.kind === "none") {
+            plan.notes.push({ file, message: "vbproj が見つからないため未登録" });
+            continue;
+        }
+        if (lookup.kind === "multiple") {
+            plan.notes.push({
+                file,
+                message: `${lookup.dir} に複数の .vbproj があるため未登録 (${lookup.names.join(", ")})。手動で登録してください`,
+            });
+            continue;
+        }
+        const target = load(lookup.path);
+        if ("error" in target) {
+            plan.notes.push({ file, message: `${lookup.path} に未登録 (${target.error})` });
+            continue;
+        }
+        const include = toIncludePath(relDirOf(lookup.path), file);
+        const parent = designerParentName(basename(file));
+        const opts = {};
+        if (parent !== null) {
+            // 親が同じ changes.md で create されるか、既にディスクにあれば DependentUpon を付ける
+            const parentPath = relDirOf(file) === "" ? parent : `${relDirOf(file)}/${parent}`;
+            if (createdPaths.has(parentPath.toLowerCase()) || existsSync(join(root, parentPath))) {
+                opts.dependentUpon = parent;
+            }
+        }
+        else if (o.change.op === "create") {
+            const subType = detectSubType(o.change.content);
+            if (subType !== undefined)
+                opts.subType = subType;
+        }
+        const r = registerCompileItem(target.lines.map((l) => l.text), include, opts);
+        if (r.status === "registered") {
+            plan.notes.push({ file, message: `${lookup.path} に登録済み (変更なし)` });
+            continue;
+        }
+        if (r.status === "sdk-style") {
+            plan.notes.push({ file, message: `${lookup.path} は SDK スタイルのため登録不要` });
+            continue;
+        }
+        if (r.status === "unsupported") {
+            plan.notes.push({
+                file,
+                message: `${lookup.path} は登録できない形式のため未登録 (${r.reason})。手動で登録してください`,
+            });
+            continue;
+        }
+        const bad = findUnencodable(r.inserted.join("\n"), target.doc.encoding);
+        if (bad.length > 0) {
+            plan.notes.push({
+                file,
+                message: `${lookup.path} (Shift_JIS) に変換できない文字がパスに含まれるため未登録: ${bad.join(" ")}`,
+            });
+            continue;
+        }
+        const inserted = r.inserted.map((text) => ({ text, raw: null, eol: null }));
+        target.lines = [...target.lines.slice(0, r.at), ...inserted, ...target.lines.slice(r.at)];
+        target.registered.push(file);
+        plan.registrations.push({ vbproj: lookup.path, file, include, ...opts });
+    }
+    for (const [vbproj, t] of loaded) {
+        if ("error" in t || t.registered.length === 0)
+            continue;
+        plan.writes.set(vbproj, {
+            before: t.before,
+            after: encodeDocument({ ...t.doc, lines: t.lines }),
+            registered: t.registered,
+        });
+    }
+    return plan;
+}
+/** .vbproj の現在の内容 (changes.md が同じ .vbproj を変更するならその変更後) を読む */
+function loadVbproj(root, vbproj, applicable) {
+    const own = applicable.find((o) => o.change.path === vbproj);
+    let bytes;
+    if (own !== undefined) {
+        if (own.change.op === "delete")
+            return { error: "changes.md がこの .vbproj を削除するため" };
+        bytes = own.afterBytes;
+    }
+    else {
+        const abs = join(root, vbproj);
+        if (!isInsideRoot(root, abs))
+            return { error: "プロジェクトルートの外を指しているため" };
+        const state = readFileState(abs);
+        if (state.symlink)
+            return { error: "シンボリックリンクのため" };
+        bytes = state.bytes;
+    }
+    if (bytes === null)
+        return { error: "内容を読めないため" };
+    try {
+        const doc = decodeFile(bytes);
+        return { doc, lines: doc.lines, before: bytes, registered: [] };
+    }
+    catch (e) {
+        return { error: e instanceof EncodingError ? e.message : String(e) };
+    }
+}
+/** 端末表示 (プレビュー・確認・サマリ共通)。該当がなければ何も出さない */
+export function formatVbprojPlan(plan) {
+    const lines = [];
+    for (const r of plan.registrations) {
+        const extra = [
+            r.subType !== undefined ? `SubType: ${r.subType}` : null,
+            r.dependentUpon !== undefined ? `DependentUpon: ${r.dependentUpon}` : null,
+        ].filter((x) => x !== null);
+        lines.push(`  vbproj に登録: ${r.vbproj} ← ${r.file}${extra.length > 0 ? ` (${extra.join(", ")})` : ""}`);
+    }
+    for (const n of plan.notes)
+        lines.push(`  vbproj: ${n.file} — ${n.message}`);
+    return lines;
+}

package/dist/core/applier.js

@@ -1,5 +1,5 @@
 import { EncodingError, decodeFile, encodeDocument, findUnencodable, makeDocument, } from "./encoding.js";
-import { STAGE_LABEL, contentEqualsStage, findContentStage, matchBlock, } from "./matcher.js";
+import { STAGE_LABEL, contentEqualsStage, findContentStage, findInsertionPresenceStage, matchBlock, } from "./matcher.js";
 import { analyzeNearest } from "./nearest.js";
 /** Windows の予約デバイス名 (拡張子付きも不可) */
 const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\..+)?$/i;
@@ -111,6 +111,13 @@ function planReplace(change, state, fallbackEol) {
             continue;
         }
         const replacement = m.replacement;
+        // 冪等性 (§6.1): 追記型ブロックは適用後も SEARCH が一致し続けるため、追記する行が
+        // 一致範囲の前後に既にあれば「適用済み」としてスキップする (再実行での重複追記を防ぐ)
+        const insertionStage = findInsertionPresenceStage(textLines, m.start, m.end, replacement === block.replace ? [replacement] : [replacement, block.replace]);
+        if (insertionStage !== null) {
+            already.push({ block, stage: insertionStage, insertion: true });
+            continue;
+        }
         const bad = findUnencodable(replacement.join("\n"), doc.encoding);
         if (bad.length > 0) {
             failures.push({
@@ -242,9 +249,10 @@ function planFile(change, state, newFile) {
 }
 /** 全ファイルをドライラン検証し適用計画を立てる (§4.1 手順 2)。書き込みは行わない */
 export function planChangeSet(changeSet, states, newFile) {
+    const resolve = typeof newFile === "function" ? newFile : () => newFile;
     const outcomes = changeSet.files.map((change) => {
         const state = states.get(change.path) ?? { exists: false, symlink: false, bytes: null };
-        return planFile(change, state, newFile);
+        return planFile(change, state, resolve(change));
     });
     const failures = outcomes.flatMap((o) => o.failures);
     return { outcomes, failures, ok: failures.length === 0 };

package/dist/core/diff-html.js

@@ -70,6 +70,7 @@ section.file{border:1px solid var(--border);border-radius:var(--radius);margin:1
 .op-create{color:var(--ok);background:color-mix(in srgb,var(--ok) 14%,transparent)}
 .op-delete{color:var(--err);background:color-mix(in srgb,var(--err) 14%,transparent)}
 .op-rewrite{color:var(--rewrite);background:color-mix(in srgb,var(--rewrite) 14%,transparent)}
+.op-vbproj{color:var(--accent);background:color-mix(in srgb,var(--accent) 14%,transparent)}
 .dlabels{display:grid;grid-template-columns:1fr 1fr;font-size:.74rem;color:var(--muted);
   background:var(--surface);border-bottom:1px solid var(--border)}
 .dlabels div{padding:.28rem .7rem}

package/dist/core/fingerprint.js

@@ -0,0 +1,23 @@
+/**
+ * changes.md の指紋 (§5, §6.1)。同じ changes.md の再適用 (取り違え・二重実行) を
+ * 履歴と突き合わせて止めるために使う。
+ *
+ * パース後の変更内容 (パス・操作・ブロック/本文の行) だけから算出する。
+ * チャットの前置き・CHANGES 概要・改行コード・寛容パースで補正したマーカー表記の
+ * 違いは指紋に影響しない (同じ変更なら同じ指紋)。
+ */
+import { createHash } from "node:crypto";
+export function changeSetFingerprint(changeSet) {
+    const normalized = changeSet.files.map((f) => {
+        switch (f.op) {
+            case "replace":
+                return { path: f.path, op: f.op, blocks: f.blocks.map((b) => [b.search, b.replace]) };
+            case "create":
+            case "rewrite":
+                return { path: f.path, op: f.op, content: f.content };
+            case "delete":
+                return { path: f.path, op: f.op };
+        }
+    });
+    return createHash("sha256").update(JSON.stringify(normalized), "utf8").digest("hex");
+}

package/dist/core/matcher.js

@@ -32,6 +32,63 @@ export function findContentStage(lines, content) {
     }
     return null;
 }
+/**
+ * 追記型ブロックの適用済み判定 (§6.1)。SEARCH が [start, end) に一意に一致したうえで、
+ * 挿入しようとしている行 (candidates のいずれか) が「一致範囲を内側に含む形で」既に
+ * ファイルにあるかを調べる。REPLACE が SEARCH を包含する追記型 (SEARCH `A` → REPLACE
+ * `A` + `B`) は適用後も SEARCH が一致し続けるため、SEARCH 不一致を起点とする
+ * findContentStage では拾えず、再実行で `B` が重複していた。
+ *
+ * - 比較は空行を除いた行列で行う (空行の欠落・追加だけの差は同一視)。空行まで含めて
+ *   一致すれば exact / trim-end、空行の並びだけ異なれば blank-insensitive を返す
+ * - 各行の比較は exact → trim-end のみ。インデント違いは別物として扱う
+ *   (入れ子の End If を補う変更を、隣の外側の End If を根拠に「済み」と誤判定しないため)
+ * - 一致範囲の外に内容のある行を 1 行以上足すものだけが対象。SEARCH と同数以下
+ *   (インデント修正などの書き換え) は null
+ *
+ * candidates には reindent 済みの置換行と REPLACE の原文を渡す (前回 trim-all で一致して
+ * 補正後の行が入っている場合と、原文のまま入っている場合の両方を拾うため)。
+ */
+export function findInsertionPresenceStage(lines, start, end, candidates) {
+    const nonBlank = [];
+    lines.forEach((line, i) => {
+        if (line.trim() !== "")
+            nonBlank.push(i);
+    });
+    const first = nonBlank.findIndex((i) => i >= start);
+    const matched = nonBlank.filter((i) => i >= start && i < end).length;
+    if (first < 0 || matched === 0)
+        return null;
+    for (const { stage, eq } of STAGES.slice(0, 2)) {
+        for (const rep of candidates) {
+            const repIdx = [];
+            rep.forEach((line, i) => {
+                if (line.trim() !== "")
+                    repIdx.push(i);
+            });
+            if (repIdx.length <= matched)
+                continue;
+            // q = REPLACE 内で一致範囲 (の最初の非空行) が始まる位置 (非空行単位)
+            for (let q = 0; q + matched <= repIdx.length; q++) {
+                const from = first - q;
+                if (from < 0 || from + repIdx.length > nonBlank.length)
+                    continue;
+                const all = repIdx.every((r, j) => eq(lines[nonBlank[from + j]], rep[r]));
+                if (!all)
+                    continue;
+                // 空行の並びまで同じか (ラベル用)
+                const lo = nonBlank[from];
+                const hi = nonBlank[from + repIdx.length - 1] + 1;
+                const repLo = repIdx[0];
+                const repHi = repIdx[repIdx.length - 1] + 1;
+                const sameLayout = hi - lo === repHi - repLo &&
+                    lines.slice(lo, hi).every((line, k) => eq(line, rep[repLo + k]));
+                return sameLayout ? stage : "blank-insensitive";
+            }
+        }
+    }
+    return null;
+}
 /** 適用済み判定 (rewrite/create): content がファイル全行と一致するか */
 export function contentEqualsStage(lines, content) {
     if (lines.length !== content.length)

package/dist/core/new-file-style.js

@@ -0,0 +1,73 @@
+function majority(values, tieBreak) {
+    const counts = new Map();
+    for (const v of values)
+        counts.set(v, (counts.get(v) ?? 0) + 1);
+    let best = null;
+    let bestCount = -1;
+    for (const [v, n] of counts) {
+        if (n > bestCount || (n === bestCount && v === tieBreak)) {
+            best = v;
+            bestCount = n;
+        }
+    }
+    return best ?? tieBreak;
+}
+function extensionOf(path) {
+    const name = path.slice(path.lastIndexOf("/") + 1);
+    const dot = name.lastIndexOf(".");
+    return dot <= 0 ? "" : name.slice(dot).toLowerCase();
+}
+/** auto 以外: 従来どおり明示値 (eol 既定 lf / bom 既定なし) */
+export function fixedNewFile(setting) {
+    const encoding = setting.encoding === "auto" ? "utf8" : setting.encoding;
+    return { encoding, bom: setting.bom ?? false, eol: setting.eol ?? "lf" };
+}
+function describe(c) {
+    return `${c.encoding}${c.encoding === "utf8" ? (c.bom === true ? " (BOM あり)" : " (BOM なし)") : ""} / ${c.eol}`;
+}
+/**
+ * 作成先に近いディレクトリから順に手本を探し、最初に見つかったディレクトリの多数決で決める。
+ * 手本がなければ拡張子別の既定 (.vb → utf8 + BOM + crlf、それ以外 → utf8 / BOM なし / lf)。
+ * .vb で utf8 かつ BOM なしになった場合は BOM を付ける (BOM なし UTF-8 の日本語は vbc で化ける。
+ * ASCII のみの Shift_JIS ファイルが UTF-8 判定される既知の限界への対処でもある)。
+ */
+export function resolveNewFileStyle(path, setting, groups) {
+    if (setting.encoding !== "auto")
+        return { config: fixedNewFile(setting), basis: null };
+    const ext = extensionOf(path);
+    const isVb = ext === ".vb";
+    let config;
+    let basis;
+    const found = groups
+        .map((g) => ({ g, samples: g.sameExt.length > 0 ? g.sameExt : g.others, same: g.sameExt.length > 0 }))
+        .find((x) => x.samples.length > 0);
+    if (found === undefined) {
+        config = isVb
+            ? { encoding: "utf8", bom: true, eol: "crlf" }
+            : { encoding: "utf8", bom: false, eol: "lf" };
+        basis = `手本となる既存ファイルなし → ${isVb ? ".vb" : "拡張子"} の既定`;
+    }
+    else {
+        const { g, samples, same } = found;
+        const encoding = majority(samples.map((s) => s.encoding), "utf8");
+        const utf8Samples = samples.filter((s) => s.encoding === "utf8");
+        const bom = encoding === "utf8" ? majority(utf8Samples.map((s) => s.bom), true) : false;
+        const eols = samples.map((s) => s.eol).filter((e) => e !== null);
+        const eol = eols.length > 0 ? majority(eols, "crlf") : isVb ? "crlf" : "lf";
+        config = { encoding, bom, eol };
+        const what = same
+            ? `${ext === "" ? "拡張子なし" : ext} ${samples.length} ファイル`
+            : `テキスト ${samples.length} ファイル (同じ拡張子の手本なし)`;
+        basis = `${g.dir === "." ? "プロジェクト直下" : g.dir} の ${what}の多数決`;
+    }
+    // 明示指定があれば推定より優先する
+    if (setting.bom !== undefined)
+        config.bom = setting.bom;
+    if (setting.eol !== undefined)
+        config.eol = setting.eol;
+    if (isVb && config.encoding === "utf8" && config.bom !== true && setting.bom === undefined) {
+        config.bom = true;
+        basis += " → .vb のため BOM を付与 (BOM なし UTF-8 は vbc で日本語が化ける)";
+    }
+    return { config, basis: `${describe(config)} (${basis})` };
+}

package/dist/core/report.js

@@ -50,7 +50,9 @@ function outcomeSummary(outcomes) {
             byIndex.set(b.block.index, `OK 一致 (${STAGE_LABEL[b.stage]})`);
         }
         for (const b of o.alreadyAppliedBlocks) {
-            byIndex.set(b.block.index, "OK 適用済み (REPLACE が既に存在)");
+            byIndex.set(b.block.index, b.insertion === true
+                ? "OK 適用済み (追記する行が SEARCH の前後に既に存在)"
+                : "OK 適用済み (REPLACE が既に存在)");
         }
         for (const f of o.failures) {
             if (f.block === undefined)

package/dist/core/vbproj.js

@@ -0,0 +1,230 @@
+/**
+ * 旧スタイル .vbproj への Compile 項目登録 (設計書 §11.1 P1-a)。
+ *
+ * 旧スタイル .vbproj は <Compile Include> に載っていないファイルをコンパイルしない。
+ * AI にこれをやらせるとパックに .vbproj 本体がなく SEARCH が一致しないため、
+ * petari が機械的に登録する。実行時依存ゼロの方針により XML パーサは使わず、
+ * 行単位の正規表現処理で <ItemGroup> / <Compile Include="..."> を扱う。
+ *
+ * 純粋関数のみ (ファイル I/O なし)。行配列 in → 挿入位置と挿入行 out。
+ * 挿入行以外には触れないため、呼び出し側は既存の行単位ドキュメント (encoding.ts) に
+ * 挿入行だけを差し込めばエンコーディング・改行・BOM が保たれる (§8)。
+ *
+ * 整形が特殊な .vbproj (1 行に複数要素、CDATA、閉じタグ欠落等) は「登録できない形式」として
+ * 未登録扱いにし、壊さない。
+ */
+/** `<Project Sdk="...">` または Sdk.props の Import があれば SDK スタイル */
+export function isSdkStyleVbproj(lines) {
+    const text = lines.join("\n");
+    if (/<Project\b[^>]*\bSdk\s*=/i.test(text))
+        return true;
+    if (/<Import\b[^>]*\bProject\s*=\s*"[^"]*Sdk\.props"/i.test(text))
+        return true;
+    return /<Sdk\b[^>]*\bName\s*=/i.test(text);
+}
+/** Include 属性値の比較用正規化 (区切り記号と大文字小文字の差は同じファイルとみなす) */
+function normalizeInclude(include) {
+    return unescapeXml(include).replace(/\//g, "\\").toLowerCase();
+}
+function escapeXmlAttr(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function unescapeXml(value) {
+    return value
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
+const RE_ITEMGROUP_OPEN = /^(\s*)<ItemGroup(\s[^<>]*)?>\s*$/i;
+const RE_ITEMGROUP_CLOSE = /^\s*<\/ItemGroup>\s*$/i;
+const RE_COMPILE_SELF = /^(\s*)<Compile\s[^<>]*\/>\s*$/i;
+const RE_COMPILE_OPEN = /^(\s*)<Compile\s[^<>]*[^/]>\s*$/i;
+const RE_COMPILE_CLOSE = /^\s*<\/Compile>\s*$/i;
+const RE_COMPILE_INCLUDE = /<Compile\s[^<>]*\bInclude\s*=\s*"([^"]*)"/i;
+const RE_PROJECT_CLOSE = /^\s*<\/Project>\s*$/i;
+/** 行構造を走査し ItemGroup の一覧を返す。形式が想定外なら文字列で理由を返す */
+function scanItemGroups(lines) {
+    const groups = [];
+    let current = null;
+    let openCompile = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.includes("<![CDATA["))
+            return "CDATA を含む";
+        const hasGroupOpen = /<ItemGroup\b/i.test(line);
+        const hasGroupClose = /<\/ItemGroup>/i.test(line);
+        const hasCompile = /<Compile\b/i.test(line);
+        const hasCompileClose = /<\/Compile>/i.test(line);
+        if (hasGroupOpen) {
+            const m = RE_ITEMGROUP_OPEN.exec(line);
+            if (m === null || hasGroupClose || hasCompile)
+                return `${i + 1} 行目: <ItemGroup> が単独の行ではない`;
+            if (current !== null)
+                return `${i + 1} 行目: <ItemGroup> が入れ子になっている`;
+            current = {
+                open: i,
+                close: -1,
+                conditional: /\bCondition\s*=/i.test(m[2] ?? ""),
+                firstCompile: null,
+                indent: m[1] ?? "",
+            };
+            continue;
+        }
+        if (hasGroupClose) {
+            if (!RE_ITEMGROUP_CLOSE.test(line))
+                return `${i + 1} 行目: </ItemGroup> が単独の行ではない`;
+            if (current === null)
+                return `${i + 1} 行目: 対応する <ItemGroup> がない`;
+            if (openCompile)
+                return `${i + 1} 行目: <Compile> が閉じられていない`;
+            current.close = i;
+            groups.push(current);
+            current = null;
+            continue;
+        }
+        if (hasCompile) {
+            if (current === null)
+                return `${i + 1} 行目: <Compile> が <ItemGroup> の外にある`;
+            if (openCompile)
+                return `${i + 1} 行目: <Compile> が閉じられていない`;
+            if (RE_COMPILE_SELF.test(line)) {
+                if (current.firstCompile === null)
+                    current.firstCompile = i;
+                continue;
+            }
+            if (RE_COMPILE_OPEN.test(line) && !hasCompileClose) {
+                if (current.firstCompile === null)
+                    current.firstCompile = i;
+                openCompile = true;
+                continue;
+            }
+            return `${i + 1} 行目: <Compile> 要素が 1 行 1 要素になっていない`;
+        }
+        if (hasCompileClose) {
+            if (!openCompile || !RE_COMPILE_CLOSE.test(line))
+                return `${i + 1} 行目: </Compile> の位置が不正`;
+            openCompile = false;
+        }
+    }
+    if (current !== null)
+        return "</ItemGroup> が欠けている";
+    return groups;
+}
+function leadingWhitespace(line) {
+    return /^\s*/.exec(line)?.[0] ?? "";
+}
+/**
+ * 既存の複数行 <Compile> から子要素のインデント増分を推定する。なければ 2 スペース
+ * (Visual Studio の既定整形: `  <ItemGroup>` / `    <Compile>` / `      <SubType>`)
+ */
+function childIndentDelta(lines) {
+    for (let i = 0; i < lines.length - 1; i++) {
+        const m = RE_COMPILE_OPEN.exec(lines[i]);
+        if (m === null)
+            continue;
+        const next = lines[i + 1];
+        if (RE_COMPILE_CLOSE.test(next))
+            continue;
+        const child = leadingWhitespace(next);
+        const parent = m[1] ?? "";
+        if (child.startsWith(parent) && child.length > parent.length)
+            return child.slice(parent.length);
+    }
+    return "  ";
+}
+/**
+ * relInclude (.vbproj からの相対パス・`\` 区切り) を Compile 項目として登録する位置と行を返す。
+ * 判定順: SDK スタイル → 登録済み → 形式検査 → 挿入位置計算。
+ */
+export function registerCompileItem(lines, relInclude, opts = {}) {
+    if (isSdkStyleVbproj(lines))
+        return { status: "sdk-style" };
+    const wanted = normalizeInclude(relInclude);
+    for (const line of lines) {
+        const m = RE_COMPILE_INCLUDE.exec(line);
+        if (m !== null && normalizeInclude(m[1] ?? "") === wanted)
+            return { status: "registered" };
+    }
+    if (!lines.some((l) => /<Project\b/i.test(l))) {
+        return { status: "unsupported", reason: "<Project> 要素が見つからない" };
+    }
+    const groups = scanItemGroups(lines);
+    if (typeof groups === "string")
+        return { status: "unsupported", reason: groups };
+    const delta = childIndentDelta(lines);
+    const item = (indent) => {
+        const include = escapeXmlAttr(relInclude);
+        const children = [];
+        if (opts.subType !== undefined)
+            children.push(`<SubType>${escapeXmlText(opts.subType)}</SubType>`);
+        if (opts.dependentUpon !== undefined) {
+            children.push(`<DependentUpon>${escapeXmlText(opts.dependentUpon)}</DependentUpon>`);
+        }
+        if (children.length === 0)
+            return [`${indent}<Compile Include="${include}" />`];
+        return [
+            `${indent}<Compile Include="${include}">`,
+            ...children.map((c) => `${indent}${delta}${c}`),
+            `${indent}</Compile>`,
+        ];
+    };
+    // Compile 項目を含む最初の (無条件の) ItemGroup の末尾に追加する
+    const target = groups.find((g) => g.firstCompile !== null && !g.conditional);
+    if (target !== undefined) {
+        const indent = leadingWhitespace(lines[target.firstCompile]);
+        return { status: "insert", at: target.close, inserted: item(indent) };
+    }
+    // なければ最後の ItemGroup の後に新しい ItemGroup を作る (ItemGroup が皆無なら </Project> の直前)
+    const last = groups[groups.length - 1];
+    const projectClose = lines.findIndex((l) => RE_PROJECT_CLOSE.test(l));
+    if (last === undefined && projectClose < 0) {
+        return { status: "unsupported", reason: "</Project> が見つからない" };
+    }
+    const groupIndent = last?.indent ?? "  ";
+    const at = last !== undefined ? last.close + 1 : projectClose;
+    return {
+        status: "insert",
+        at,
+        inserted: [`${groupIndent}<ItemGroup>`, ...item(groupIndent + delta), `${groupIndent}</ItemGroup>`],
+    };
+}
+function escapeXmlText(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** テスト・表示用: 挿入結果を行配列に反映する */
+export function applyInsertion(lines, result) {
+    return [...lines.slice(0, result.at), ...result.inserted, ...lines.slice(result.at)];
+}
+const RE_INHERITS = /^\s*Inherits\s+(?:(?:System\.)?Windows\.Forms\.)?(Form|UserControl)\s*(?:'.*)?$/i;
+/** 新規 .vb の内容から <SubType> を推定する (Inherits Form / UserControl)。該当なしは undefined */
+export function detectSubType(contentLines) {
+    for (const line of contentLines) {
+        const m = RE_INHERITS.exec(line);
+        if (m === null)
+            continue;
+        const name = m[1].toLowerCase();
+        return name === "form" ? "Form" : "UserControl";
+    }
+    return undefined;
+}
+/** `X.Designer.vb` なら親ファイル名 `X.vb` を返す (大文字小文字は区別しない)。それ以外は null */
+export function designerParentName(fileName) {
+    const m = /^(.+)\.designer\.vb$/i.exec(fileName);
+    return m === null ? null : `${m[1]}.vb`;
+}
+/** ルート相対パス (/ 区切り) を .vbproj のディレクトリからの相対 Include (\ 区切り) にする */
+export function toIncludePath(vbprojDir, filePath) {
+    const base = vbprojDir === "" ? [] : vbprojDir.split("/");
+    const target = filePath.split("/");
+    let common = 0;
+    while (common < base.length && common < target.length && base[common] === target[common])
+        common++;
+    const ups = base.slice(common).map(() => "..");
+    return [...ups, ...target.slice(common)].join("\\");
+}

package/dist/infra/config.js

@@ -7,6 +7,7 @@ export const DEFAULT_CONFIG = {
     historyLimit: null,
     vscodeCommand: "code",
     clipReportOnFailure: true,
+    vbproj: { register: true },
 };
 /** グローバル設定のパス (§10)。Windows は %APPDATA%、他は XDG (~/.config) */
 export function globalConfigPath() {
@@ -29,13 +30,21 @@ function readConfigFile(path) {
 /** JSON 由来の値は型注釈を素通りするため、使う前に実行時検証する */
 function validateConfig(c) {
     const enc = c.newFile.encoding;
-    if (enc !== "utf8" && enc !== "shift_jis") {
-        throw new Error(`config の newFile.encoding が不正です: ${String(enc)} ("utf8" | "shift_jis")`);
+    if (enc !== "utf8" && enc !== "shift_jis" && enc !== "auto") {
+        throw new Error(`config の newFile.encoding が不正です: ${String(enc)} ("utf8" | "shift_jis" | "auto")`);
     }
     const eol = c.newFile.eol;
-    if (eol !== "lf" && eol !== "crlf") {
+    if (eol !== undefined && eol !== "lf" && eol !== "crlf") {
         throw new Error(`config の newFile.eol が不正です: ${String(eol)} ("lf" | "crlf")`);
     }
+    const bom = c.newFile.bom;
+    if (bom !== undefined && typeof bom !== "boolean") {
+        throw new Error(`config の newFile.bom が不正です: ${String(bom)} (true | false)`);
+    }
+    const register = c.vbproj?.register;
+    if (typeof c.vbproj !== "object" || c.vbproj === null || typeof register !== "boolean") {
+        throw new Error('config の vbproj が不正です ({ "register": true | false } を指定)');
+    }
     const limit = c.historyLimit;
     if (limit !== null && (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1)) {
         throw new Error(`config の historyLimit が不正です: ${String(limit)} (null または 1 以上の整数)`);
@@ -59,10 +68,21 @@ export function loadConfig(root) {
         ...DEFAULT_CONFIG,
         ...global,
         ...project,
-        newFile: {
-            ...DEFAULT_CONFIG.newFile,
-            ...(global.newFile ?? {}),
-            ...(project.newFile ?? {}),
+        newFile: mergeNewFile(global.newFile, project.newFile),
+        vbproj: {
+            ...DEFAULT_CONFIG.vbproj,
+            ...(global.vbproj ?? {}),
+            ...(project.vbproj ?? {}),
         },
     });
 }
+/**
+ * newFile の合成。encoding "auto" のときは既定の eol: "lf" / bom を混ぜない
+ * (混ぜると eol / BOM の推定が効かなくなる)。ユーザーが明示した eol / bom は auto でも残る
+ */
+function mergeNewFile(global, project) {
+    const user = { ...(global ?? {}), ...(project ?? {}) };
+    if (user.encoding === "auto")
+        return user;
+    return { ...DEFAULT_CONFIG.newFile, ...user };
+}

package/dist/infra/history.js

@@ -69,4 +69,50 @@ export function readManifest(root, id) {
         return null;
     return JSON.parse(readFileSync(p, "utf8"));
 }
+/** undo の完了を manifest に記録する (再適用検出で「巻き戻し済み」を区別するため) */
+export function markUndone(root, id, at) {
+    const p = join(historyRoot(root), id, "manifest.json");
+    const manifest = JSON.parse(readFileSync(p, "utf8"));
+    manifest.undoneAt = at.toISOString();
+    writeFileSync(p, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+}
+/**
+ * 同じ指紋の changes.md を適用した履歴 (巻き戻し済み・書き込みなしを除く) を新しい順に
+ * 探し、最初に見つかった履歴 ID を返す。指紋を持たない旧形式の manifest は、保存済みの
+ * changes.md 原本から fallback で算出する (null = 算出不能として対象外)。
+ * manifest は非信頼入力のため、読めない・形が違うものは黙って対象外にする。
+ */
+export function findAppliedHistory(root, fingerprint, fallback) {
+    for (const id of listHistoryIds(root).reverse()) {
+        let manifest;
+        try {
+            manifest = readManifest(root, id);
+        }
+        catch {
+            continue;
+        }
+        if (manifest === null || typeof manifest !== "object")
+            continue;
+        if (manifest.undoneAt !== undefined)
+            continue;
+        if (!Array.isArray(manifest.files) || !manifest.files.some((f) => f?.applied === true))
+            continue;
+        let fp = null;
+        if (typeof manifest.changesFingerprint === "string") {
+            fp = manifest.changesFingerprint;
+        }
+        else {
+            const p = join(historyRoot(root), id, "changes.md");
+            try {
+                fp = fallback(readFileSync(p, "utf8"));
+            }
+            catch {
+                fp = null;
+            }
+        }
+        if (fp === fingerprint)
+            return id;
+    }
+    return null;
+}
 export { sha256 };

package/dist/infra/new-file-style.js

@@ -0,0 +1,81 @@
+/**
+ * 新規ファイルの形式推定に使う手本の収集 (設計書 §11.2)。ファイル I/O のみ。
+ * 多数決と既定の決定は core/new-file-style.ts。
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { decodeFile } from "../core/encoding.js";
+/** 1 ディレクトリで読む手本の上限と 1 ファイルの上限 (I/O を抑える) */
+const MAX_FILES_PER_DIR = 100;
+const MAX_FILE_BYTES = 1024 * 1024;
+function extensionOf(name) {
+    const dot = name.lastIndexOf(".");
+    return dot <= 0 ? "" : name.slice(dot).toLowerCase();
+}
+function sampleOf(absPath) {
+    let bytes;
+    try {
+        if (statSync(absPath).size > MAX_FILE_BYTES)
+            return null;
+        bytes = new Uint8Array(readFileSync(absPath));
+    }
+    catch {
+        return null;
+    }
+    if (bytes.length === 0 || bytes.includes(0))
+        return null; // 空 / バイナリは手本にしない
+    try {
+        const doc = decodeFile(bytes);
+        return { encoding: doc.encoding, bom: doc.hasBom, eol: doc.eol };
+    }
+    catch {
+        return null; // UTF-8 でも Shift_JIS でもないものは対象外
+    }
+}
+function collectDir(absDir, dir, ext) {
+    const group = { dir, sameExt: [], others: [] };
+    let entries;
+    try {
+        entries = readdirSync(absDir, { withFileTypes: true });
+    }
+    catch {
+        return group; // 未作成ディレクトリ (create 先)
+    }
+    const files = entries
+        .filter((e) => e.isFile() && !e.name.startsWith("."))
+        .map((e) => e.name)
+        .sort()
+        .slice(0, MAX_FILES_PER_DIR);
+    for (const name of files) {
+        const s = sampleOf(join(absDir, name));
+        if (s === null)
+            continue;
+        if (extensionOf(name) === ext)
+            group.sameExt.push(s);
+        else
+            group.others.push(s);
+    }
+    return group;
+}
+/**
+ * ルート相対パス path の作成先ディレクトリからルートまで、各ディレクトリの手本を近い順に集める。
+ * 手本が見つかったディレクトリで打ち切る (core 側は最初の非空グループを採用する)。
+ */
+export function collectStyleSampleGroups(root, path) {
+    const ext = extensionOf(path.slice(path.lastIndexOf("/") + 1));
+    const groups = [];
+    let dir = dirname(path);
+    if (dir === ".")
+        dir = "";
+    for (;;) {
+        const group = collectDir(dir === "" ? root : join(root, dir), dir === "" ? "." : dir, ext);
+        groups.push(group);
+        if (group.sameExt.length > 0 || group.others.length > 0)
+            break;
+        if (dir === "")
+            break;
+        const parent = dirname(dir);
+        dir = parent === "." ? "" : parent;
+    }
+    return groups;
+}

package/dist/infra/vbproj.js

@@ -0,0 +1,36 @@
+/**
+ * 最寄り .vbproj の探索 (設計書 §11.1)。ファイル I/O のみ。判定・挿入は core/vbproj.ts。
+ */
+import { readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+function listVbproj(absDir) {
+    try {
+        return readdirSync(absDir, { withFileTypes: true })
+            // 書き込み対象になるため symlink は除外する (Dirent 判定・§9)
+            .filter((e) => e.isFile() && /\.vbproj$/i.test(e.name))
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return null; // 未作成ディレクトリ (create 先) は手本なしとして上へ辿る
+    }
+}
+/**
+ * ルート相対ディレクトリ relDir から上へ辿り、プロジェクトルートまでの間で最寄りの .vbproj を探す。
+ * ルートの外には出ない。
+ */
+export function findNearestVbproj(root, relDir) {
+    let dir = relDir === "." ? "" : relDir;
+    for (;;) {
+        const names = listVbproj(dir === "" ? root : join(root, dir));
+        if (names !== null && names.length === 1) {
+            return { kind: "found", path: dir === "" ? names[0] : `${dir}/${names[0]}` };
+        }
+        if (names !== null && names.length > 1)
+            return { kind: "multiple", dir: dir === "" ? "." : dir, names };
+        if (dir === "")
+            return { kind: "none" };
+        const parent = dirname(dir);
+        dir = parent === "." ? "" : parent;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "petari",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "petari — paste AI chat patches onto your codebase",
   "keywords": [
     "cli",