petari 0.9.0 → 0.9.1

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

@@ -8,6 +8,7 @@ import { join, resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { invalidPathReason, planChangeSet, } from "../core/applier.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 +16,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 { confirm } from "../infra/prompt.js";
 import { findProjectRoot } from "../infra/root.js";
+import { formatVbprojPlan, planVbprojRegistrations } from "./vbproj-register.js";
 /** このファイルは書き込み対象か (適用済みのみのファイルは書き込み不要なので含めない) */
 function isApplicable(o) {
     if (o.alreadyApplied)
@@ -78,6 +81,8 @@ 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 },
         },
         allowPositionals: true,
     });
@@ -200,7 +205,22 @@ 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`);
@@ -208,6 +228,20 @@ export async function applyCommand(argv) {
         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)) {
@@ -223,6 +257,7 @@ export async function applyCommand(argv) {
     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 +273,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 +294,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 +308,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,8 +343,25 @@ 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(),
@@ -314,6 +380,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/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/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

@@ -242,9 +242,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/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/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/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.9.1",
   "description": "petari — paste AI chat patches onto your codebase",
   "keywords": [
     "cli",