petari 0.4.1 → 0.6.0

package/README.md

@@ -48,6 +48,19 @@ petari               # 返答 (changes.md) を適用
 petari の更新で規約文が変わった場合は、`petari init` を再実行すると protocol.md の
 差分を検出して更新を提案します (slnmix 側の更新は不要)。
 
+### 適用が繰り返し失敗するとき
+
+失敗レポート (自動でクリップボードにコピーされます) をそのまま AI に貼り返すのが
+最短です。レポートには実ファイルの該当箇所の抜粋と、どの行がどう違うかの診断が
+含まれるため、AI は推測ではなくコピーで SEARCH を直せます。
+
+それでも同じ箇所が失敗を繰り返す場合は、**AI に渡したスナップショット (repomix /
+slnmix の出力) が実ファイルとずれている**可能性が高いです。特にチャットサービスは
+長い添付を要約・検索処理で部分的にしか読まないことがあり、AI が見えなかった箇所を
+もっともらしく補って出力することがあります。SEARCH の空白調整や言い換えを繰り返す
+より、スナップショットを取り直して渡し直すのが確実です (petari 側は空白・インデント・
+文字コードの差を吸収して照合するため、それらが原因で失敗することはありません)。
+
 ### コマンド
 
 | コマンド | 説明 |
@@ -60,7 +73,7 @@ petari の更新で規約文が変わった場合は、`petari init` を再実
 | `petari init` | プロジェクト初回セットアップ (`--yes` で全提案に同意) |
 
 主なオプション: `--dry-run` (検証と差分プレビューのみ) / `--partial` (成功分のみ適用) /
-`--root <dir>` / `--yes` / `--clip-report` (失敗レポートをクリップボードへ)
+`--root <dir>` / `--yes` / `--clip-report` (失敗レポートをクリップボードへ。v0.5.0 から既定で自動コピーされるため、config で無効化した場合の個別指定用)
 
 ## 特徴
 
@@ -71,7 +84,13 @@ petari の更新で規約文が変わった場合は、`petari init` を再実
   結果は `適用 / 済み / 失敗` の 3 状態で表示
 - **エンコーディング保全**: Shift_JIS / UTF-8 (BOM 有無)・CRLF / LF・末尾改行を完全維持。
   変更していない行は元のバイト列をそのまま書き戻す (レガシー VB.NET 資産でも安全)
-- **失敗レポート**: そのまま AI チャットに貼り返せる形式で出力。再依頼が 1 コピペで済む
+- **規約逸脱への耐性 (寛容パース)**: AI がマーカーの記号数・見出しレベルを崩したり
+  出力全体をコードフェンスで包んでも、厳密パース失敗時に限り安全な範囲で自動補正して
+  解釈する (補正内容は適用前に全件表示。曖昧さが残る場合は採用せずエラーに戻す)
+- **失敗レポート**: そのまま AI チャットに貼り返せる形式で出力し、**既定でクリップボードへ
+  自動コピー** (失敗した時点で貼り返し 1 ペーストの状態。config の
+  `clipReportOnFailure: false` で無効化可)。構文エラー時のレポートには規約フォーマットの
+  要点を同梱 (チャット側で規約文が失われていてもレポート 1 枚で再出力を依頼できる)
 - **git / VS Code がない端末でも差分確認・手修正**: `show` は VS Code がなければ自己完結
   HTML レポートをブラウザで開き、`show --edit` は同梱の Monaco Editor (VS Code と同じ
   差分エディタ) で現在のファイルを差分を見ながら直接編集・保存できる

package/dist/assets/protocol.js

@@ -6,7 +6,7 @@
  * 制約: slnmix (v0.7.0+) はこのテキストを <instruction>...</instruction> で囲んで
  * 出力へ連結するため、規約文に <instruction> という文字列を含めないこと。
  */
-export const PROTOCOL_VERSION = 2;
+export const PROTOCOL_VERSION = 3;
 export const PROTOCOL_TEXT = `<!-- petari protocol v${PROTOCOL_VERSION} -->
 # コード変更の出力規約 (changes.md)
 
@@ -76,4 +76,15 @@ new code
 7. 対象ファイルが日本語 Shift_JIS の場合、絵文字など Shift_JIS で表現できない文字を
    コード中に入れない
 8. changes.md 以外の出力 (前置き・後書き) は最小限にする
+
+## 出力前の自己チェック
+
+出力を確定する前に、次の 4 点を必ず確認してください。
+
+1. 出力は「## CHANGES」の行から始まっているか
+2. すべてのマーカー行が行頭にあり、綴りが正確か
+   (<<<<<<< と >>>>>>> は記号 7 個 + 半角スペース + 語、区切りは = 7 個のみの行)
+3. 各 SEARCH の内容は、提供された現在のファイルからの正確なコピーか
+   (記憶をもとに再構成していないか)
+4. 同じファイルの FILE セクションが重複していないか
 `;

package/dist/commands/apply.js

@@ -8,14 +8,14 @@ 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 { parseChanges } from "../core/parser.js";
+import { parseChangesRecovering } from "../core/parser.js";
 import { buildFailureReport, buildParseErrorReport } from "../core/report.js";
 import { readClipboard, writeClipboard } from "../infra/clipboard.js";
 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 { err, out } from "../infra/term.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";
@@ -86,13 +86,19 @@ export async function applyCommand(argv) {
     if (!existsSync(join(root, ".petari"))) {
         out("ヒント: 初回は `petari init` を実行すると protocol.md や設定の雛形が整います");
     }
-    // レポートを標準出力へ出し、--clip-report ならクリップボードにもコピーする (§7)
+    // レポートを標準出力へ出し、クリップボードにもコピーする (§7)。
+    // 既定 (clipReportOnFailure: true) で自動コピーし、config で無効化できる。--clip-report は常に有効
     const emitReport = async (report) => {
         out(report);
-        if (values["clip-report"]) {
+        if (values["clip-report"] || config.clipReportOnFailure) {
             try {
                 await writeClipboard(report);
-                out("(レポートをクリップボードにコピーしました)");
+                // 貼り返しを忘れないよう、コピー済みであることを最後に強調表示する
+                const rule = "━".repeat(56);
+                outEmphasis(rule);
+                outEmphasis(" 失敗レポートをクリップボードにコピーしました ", true);
+                outEmphasis("   → そのまま AI チャットに貼り付けて再依頼できます (Ctrl+V)");
+                outEmphasis(rule);
             }
             catch (e) {
                 err(`petari: クリップボードへのコピーに失敗: ${e instanceof Error ? e.message : String(e)}`);
@@ -166,13 +172,19 @@ export async function applyCommand(argv) {
         }
         source = { type: newest.origin, path: newest.path };
     }
-    // 1. パース (構文エラーは即時失敗・§4.1)
-    const { changeSet, issues } = parseChanges(changesText);
+    // 1. パース (構文エラーは即時失敗・§4.1)。strict で失敗したら寛容パースを試す (§3.5)
+    const { changeSet, issues, repairs } = parseChangesRecovering(changesText);
     if (issues.length > 0) {
         err("petari: changes.md の構文エラーです。何も書き込んでいません。\n");
         await emitReport(buildParseErrorReport(issues));
         return 1;
     }
+    if (repairs.length > 0) {
+        out(`規約からの軽微な逸脱 ${repairs.length} 件を自動補正して解釈しました:`);
+        for (const r of repairs)
+            out(`  ${r.line} 行目: ${r.message}`);
+        out("");
+    }
     // 2. 全ブロックのドライラン検証
     const states = new Map();
     for (const f of changeSet.files) {
@@ -192,7 +204,7 @@ export async function applyCommand(argv) {
     // 3. 失敗があれば何も書き込まずレポート (§4.1, §7)
     if (!plan.ok && !values.partial) {
         err(`petari: 検証に失敗しました (${plan.failures.length} 件)。何も書き込んでいません。\n`);
-        await emitReport(buildFailureReport(plan.failures));
+        await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes, nothingWritten: true }));
         return 1;
     }
     const applicable = plan.outcomes.filter(isApplicable);
@@ -205,7 +217,7 @@ export async function applyCommand(argv) {
             return 0;
         }
         err("petari: 適用できる変更がありません。\n");
-        await emitReport(buildFailureReport(plan.failures));
+        await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes, nothingWritten: true }));
         return 1;
     }
     if (values["dry-run"]) {
@@ -214,7 +226,7 @@ export async function applyCommand(argv) {
         printAlreadyApplied(plan.outcomes);
         if (plan.failures.length > 0) {
             out("");
-            await emitReport(buildFailureReport(plan.failures));
+            await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes, nothingWritten: true }));
         }
         return 0;
     }
@@ -303,7 +315,8 @@ export async function applyCommand(argv) {
     if (plan.failures.length > 0) {
         out(`スキップした失敗 ${plan.failures.length} 件のレポート:`);
         out("");
-        await emitReport(buildFailureReport(plan.failures));
+        // --partial で成功分は書き込み済みのため nothingWritten は付けない
+        await emitReport(buildFailureReport(plan.failures, { outcomes: plan.outcomes }));
     }
     // 6. 自動検出 (Downloads / プロジェクト直下) 由来なら changes.md を履歴へ移動
     //    (原本は history に保存済み・§4.1)。全件適用済みで履歴を作らなかった場合は削除しない

package/dist/commands/init.js

@@ -13,7 +13,8 @@ const CONFIG_TEMPLATE = `{
   "downloadsDir": null,
   "newFile": { "encoding": "utf8", "eol": "lf" },
   "historyLimit": null,
-  "vscodeCommand": "code"
+  "vscodeCommand": "code",
+  "clipReportOnFailure": true
 }
 `;
 export async function initCommand(argv) {

package/dist/commands/show.js

@@ -21,7 +21,7 @@ import { invalidPathReason } from "../core/applier.js";
 import { diffLines, toSideBySideRows } from "../core/diff.js";
 import { buildReportPage } from "../core/diff-html.js";
 import { EncodingError, decodeFile } from "../core/encoding.js";
-import { parseChanges } from "../core/parser.js";
+import { parseChangesRecovering } from "../core/parser.js";
 import { openInBrowser } from "../infra/browser.js";
 import { loadConfig } from "../infra/config.js";
 import { monacoVendorDir, startDiffServer } from "../infra/diff-server.js";
@@ -273,7 +273,8 @@ export async function showCommand(argv) {
     // --changes: CHANGES セクション (概要・影響一覧・Mermaid) の表示 (§13-4)
     if (values.changes) {
         const text = readFileSync(join(hdir, "changes.md"), "utf8");
-        const { changeSet } = parseChanges(text);
+        // 寛容パースで適用した履歴の changes.md も表示できるようにする (§3.5)
+        const { changeSet } = parseChangesRecovering(text);
         out(changeSet.header !== "" ? changeSet.header : "(CHANGES セクションがありません)");
         return 0;
     }

package/dist/core/applier.js

@@ -1,5 +1,6 @@
 import { EncodingError, decodeFile, encodeDocument, findUnencodable, makeDocument, } from "./encoding.js";
 import { STAGE_LABEL, contentEqualsStage, findContentStage, matchBlock, } from "./matcher.js";
+import { analyzeNearest } from "./nearest.js";
 /** Windows の予約デバイス名 (拡張子付きも不可) */
 const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\..+)?$/i;
 /** §9: プロジェクトルート相対のみ。絶対パス・`..`・`~`・Windows 特殊パスを拒否 */
@@ -70,14 +71,32 @@ function planReplace(change, state, fallbackEol) {
                     continue;
                 }
             }
+            if (m.reason === "ambiguous") {
+                // 位置は同一ファイル内の先行ブロック適用後の行配列に対する行番号 (通常は実ファイルと一致)
+                const positions = (m.positions ?? []).map((p) => `${p + 1}`);
+                const shown = positions.length > 5
+                    ? `${positions.slice(0, 5).join(", ")} 行目 他 ${positions.length - 5} 箇所`
+                    : `${positions.join(", ")} 行目`;
+                failures.push({
+                    path: change.path,
+                    kind: "block-ambiguous",
+                    message: `ブロック ${block.index}: SEARCH が ${m.count} 箇所にマッチしました (${STAGE_LABEL[m.stage]}: ${shown})。前後の行を追加して一意に特定できる範囲にしてください`,
+                    block,
+                });
+                continue;
+            }
             const checkedReplace = block.replace.some((l) => l.trim() !== "");
-            const message = m.reason === "ambiguous"
-                ? `ブロック ${block.index}: SEARCH が ${m.count} 箇所にマッチしました (${STAGE_LABEL[m.stage]})。一意に特定できる範囲を含めてください`
-                : `ブロック ${block.index}: SEARCH が現在のファイル内容に見つかりません` +
-                    (checkedReplace
-                        ? " (REPLACE の内容も見つからないため、changes.md の基準スナップショットが現在のコードベースとずれている可能性があります)"
-                        : "");
-            failures.push({ path: change.path, kind: m.reason === "ambiguous" ? "block-ambiguous" : "block-not-found", message, block });
+            const message = `ブロック ${block.index}: SEARCH が現在のファイル内容に見つかりません` +
+                (checkedReplace
+                    ? " (REPLACE の内容も見つからないため、changes.md の基準スナップショットが現在のコードベースとずれている可能性があります)"
+                    : "");
+            failures.push({
+                path: change.path,
+                kind: "block-not-found",
+                message,
+                block,
+                nearest: analyzeNearest(textLines, block.search, applied.length > 0),
+            });
             continue;
         }
         const replacement = m.replacement;

package/dist/core/matcher.js

@@ -102,7 +102,7 @@ export function matchBlock(lines, block) {
             return { ok: true, block, stage, start, end, replacement };
         }
         if (found.length > 1) {
-            return { ok: false, block, reason: "ambiguous", stage, count: found.length };
+            return { ok: false, block, reason: "ambiguous", stage, count: found.length, positions: found };
         }
     }
     return { ok: false, block, reason: "not-found" };

package/dist/core/nearest.js

@@ -0,0 +1,178 @@
+/**
+ * SEARCH 不一致時の近傍診断 (§7 失敗レポートの拡充)。
+ * 実ファイル内で SEARCH に最も近い領域を特定し、どの行がどう違うかを構造化して返す。
+ * I/O を持たない純粋ロジック。レポートの文字列化は renderNearest が行う。
+ *
+ * 2026-08-25 の実運用事例 (AI が失敗原因を空白/エンコーディングと誤診し 4 往復) を受けて追加。
+ * 抜粋行は verbatim で保持する — AI がそのまま次の SEARCH へコピーする前提のため、
+ * 制御文字の可視化などの加工は行わない (差分の説明は note 側に分離する)。
+ */
+/** 前後のコンテキストとして抜粋に含める行数 */
+const CONTEXT_LINES = 2;
+/** レポートに載せるウィンドウの最大行数 (巨大 SEARCH の暴走防止) */
+const MAX_RENDER_LINES = 40;
+/** 「存在しない行」一覧の最大表示数 */
+const MAX_MISSING_LINES = 8;
+const collapseWs = (s) => s.replace(/[ \t]+/g, " ");
+/**
+ * 目視で区別しづらい文字を通常の文字へ畳み込む。畳み込み後に一致するなら、
+ * その行の差は「見えない文字」だけに因る (レポートでコードポイントを示す価値がある)。
+ */
+const FOLD_RULES = [
+    [/[\u3000\u00A0]/g, " "], // 全角スペース / ノーブレークスペース
+    [/[\u200B-\u200D\uFEFF]/g, ""], // ゼロ幅文字
+    [/\u301C/g, "\uFF5E"], // 波ダッシュ ↔ 全角チルダ (Shift_JIS デコーダ差の定番)
+];
+const foldConfusable = (s) => FOLD_RULES.reduce((t, [re, rep]) => t.replace(re, rep), s);
+function verdictOf(fileTrim, searchTrim) {
+    if (fileTrim === searchTrim)
+        return "match";
+    if (collapseWs(fileTrim) === collapseWs(searchTrim))
+        return "ws-only";
+    return "differ";
+}
+/** 最初に異なるコードポイントの位置と内容 (前後空白は無視して比較) */
+function describeFirstDiff(fileLine, searchLine) {
+    const a = [...fileLine.trim()];
+    const b = [...searchLine.trim()];
+    let i = 0;
+    while (i < a.length && i < b.length && a[i] === b[i])
+        i++;
+    const cp = (arr, idx) => {
+        const ch = arr[idx];
+        if (ch === undefined)
+            return "行末";
+        return `U+${ch.codePointAt(0).toString(16).toUpperCase().padStart(4, "0")}`;
+    };
+    return `${i + 1} 文字目から異なります (実ファイル側: ${cp(a, i)} / SEARCH 側: ${cp(b, i)})`;
+}
+function noteFor(fileLine, searchLine, verdict) {
+    if (verdict === "ws-only") {
+        return "行内の連続空白の個数のみが異なります (実ファイル側の行をそのままコピーしてください)";
+    }
+    if (verdict === "differ") {
+        const ft = fileLine.trim();
+        const st = searchLine.trim();
+        if (collapseWs(foldConfusable(ft)) === collapseWs(foldConfusable(st))) {
+            return `見た目で区別しづらい文字の差です。${describeFirstDiff(fileLine, searchLine)}`;
+        }
+    }
+    return undefined;
+}
+/**
+ * SEARCH に最も近い実ファイル領域を探す。
+ * スコア: 前後空白無視の一致 = 3 点、空白圧縮一致 = 2 点、不可視文字の畳み込みまで
+ * かけて一致 = 1 点。最高得点の最初の位置を採用する (全比較段が 0 のときのみ null)。
+ * 走査が O(ファイル行数 × SEARCH 行数) になるため、正規化はすべて事前計算する。
+ */
+export function analyzeNearest(fileLines, search, afterPriorBlocks = false) {
+    const fTrim = fileLines.map((l) => l.trim());
+    const sTrim = search.map((l) => l.trim());
+    const fColl = fTrim.map(collapseWs);
+    const sColl = sTrim.map(collapseWs);
+    const fFold = fTrim.map((t) => collapseWs(foldConfusable(t)));
+    const sFold = sTrim.map((t) => collapseWs(foldConfusable(t)));
+    const lineHits = [];
+    search.forEach((text, i) => {
+        const t = sTrim[i];
+        if (t === "")
+            return; // 空行はどこにでも一致するため対象外
+        let count = 0;
+        for (const f of fTrim)
+            if (f === t)
+                count++;
+        lineHits.push({ index: i + 1, text, count });
+    });
+    const size = Math.min(search.length, fileLines.length);
+    let bestStart = -1;
+    let bestScore = 0;
+    let bestMatch = 0;
+    for (let i = 0; size > 0 && i + size <= fileLines.length; i++) {
+        let score = 0;
+        let matches = 0;
+        for (let j = 0; j < size; j++) {
+            if (fTrim[i + j] === sTrim[j]) {
+                score += 3;
+                matches++;
+            }
+            else if (fColl[i + j] === sColl[j]) {
+                score += 2;
+            }
+            else if (fFold[i + j] === sFold[j]) {
+                score += 1;
+            }
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestStart = i;
+            bestMatch = matches;
+        }
+    }
+    if (bestStart < 0)
+        return { lineHits, window: null, afterPriorBlocks };
+    const lines = [];
+    const from = Math.max(0, bestStart - CONTEXT_LINES);
+    const to = Math.min(fileLines.length, bestStart + size + CONTEXT_LINES);
+    for (let i = from; i < to; i++) {
+        const inWindow = i >= bestStart && i < bestStart + size;
+        if (!inWindow) {
+            lines.push({ lineNo: i + 1, text: fileLines[i], verdict: null });
+            continue;
+        }
+        const j = i - bestStart;
+        const verdict = verdictOf(fTrim[i], sTrim[j]);
+        const note = noteFor(fileLines[i], search[j], verdict);
+        lines.push({
+            lineNo: i + 1,
+            text: fileLines[i],
+            verdict,
+            ...(note !== undefined ? { note } : {}),
+        });
+    }
+    return {
+        lineHits,
+        window: { total: search.length, matchCount: bestMatch, lines },
+        afterPriorBlocks,
+    };
+}
+const MARK = { match: "=", "ws-only": "~", differ: "!" };
+/** 失敗レポートに埋め込む診断テキスト。抜粋行は「│」の右側が実ファイルの verbatim */
+export function renderNearest(a) {
+    const out = ["#### 参考: 実ファイルの該当箇所 (petari が現在のファイル内容から自動抽出)"];
+    if (a.afterPriorBlocks) {
+        out.push("(同一ファイル内の先行ブロックを適用した後の想定内容です。SEARCH はこの内容に一致させてください)");
+    }
+    out.push("");
+    const missing = a.lineHits.filter((h) => h.count === 0);
+    if (missing.length > 0) {
+        out.push("SEARCH のうち実ファイルに存在しない行 (前後の空白は無視して照合):");
+        for (const h of missing.slice(0, MAX_MISSING_LINES)) {
+            out.push(`- SEARCH ${h.index} 行目: ${h.text.trim()}`);
+        }
+        if (missing.length > MAX_MISSING_LINES) {
+            out.push(`- …他 ${missing.length - MAX_MISSING_LINES} 行`);
+        }
+    }
+    else if (a.window !== null) {
+        out.push("SEARCH の各行は実ファイル内に個別には存在しますが、この並びでは連続していません。");
+    }
+    if (a.window === null) {
+        out.push("", "SEARCH のどの行も (前後の空白を無視しても) 現在のファイルに見つかりません。", "changes.md の基準にしたスナップショット (repomix 等) が古いか、チャット側の要約・", "検索処理により実在しないコードを参照している可能性があります。推測で SEARCH を", "書き換えず、最新のファイル内容の共有を受けてから作り直してください。");
+        return out;
+    }
+    const w = a.window;
+    out.push("", `最も近い領域 (SEARCH ${w.total} 行中 ${w.matchCount} 行が一致):`, "```");
+    for (const line of w.lines.slice(0, MAX_RENDER_LINES)) {
+        const mark = line.verdict === null ? " " : MARK[line.verdict];
+        out.push(`${mark} ${String(line.lineNo).padStart(5)}│${line.text}`);
+    }
+    if (w.lines.length > MAX_RENDER_LINES) {
+        out.push(`… (以下 ${w.lines.length - MAX_RENDER_LINES} 行省略)`);
+    }
+    out.push("```", "凡例: ! = SEARCH と内容が異なる行 / ~ = 空白の個数のみ異なる行 / = = 一致した行 / 無印 = 前後の文脈");
+    for (const line of w.lines) {
+        if (line.note !== undefined)
+            out.push(`- ${line.lineNo} 行目: ${line.note}`);
+    }
+    return out;
+}

package/dist/core/parser.js

@@ -6,6 +6,28 @@ const CONTENT_END = ">>>>>>> END";
 const CHANGES_HEADING = "## CHANGES";
 const FILE_PREFIX = "### FILE:";
 const FILE_RE = /^### FILE:\s*(.+?)\s*\((replace|create|rewrite|delete)\)$/;
+const EXACT_MARKER = {
+    search: SEARCH,
+    divider: DIVIDER,
+    "replace-end": REPLACE_END,
+    content: CONTENT,
+    "content-end": CONTENT_END,
+};
+// 寛容モード (§3.5) の許容パターン。strict パースが失敗したときだけ試す「惜しい」逸脱で、
+// AI チャットの実出力で観測された崩れ (記号の個数ずれ・スペース欠落・見出しレベルずれ・
+// 全体のコードフェンス包み) を対象にする。誤検知しても lenient 結果は issues が 1 件でも
+// あれば破棄して strict のエラーに戻すため、静かな誤解釈は採用されない。
+const LENIENT_MARKER = {
+    search: /^<{5,16}\s*SEARCH$/,
+    divider: /^={6,10}$/,
+    "replace-end": /^>{5,16}\s*REPLACE$/,
+    content: /^<{5,16}\s*CONTENT$/,
+    "content-end": /^>{5,16}\s*END$/,
+};
+const LENIENT_CHANGES_RE = /^#{1,6}\s*CHANGES$/;
+const LENIENT_FILE_ATTEMPT_RE = /^#{1,6}\s*FILE\s*:/;
+const LENIENT_FILE_RE = /^#{1,6}\s*FILE\s*:\s*(.+?)\s*\((replace|create|rewrite|delete)\)$/;
+const FENCE_RE = /^`{3,}[A-Za-z0-9_-]*$/;
 /**
  * changes.md をパースする (§3)。
  *
@@ -15,6 +37,27 @@ const FILE_RE = /^### FILE:\s*(.+?)\s*\((replace|create|rewrite|delete)\)$/;
  * - 構文の問題は issues に集約する。issues が空でなければ適用してはならない。
  */
 export function parseChanges(text) {
+    return parseCore(text, null);
+}
+/**
+ * 寛容パース (§3.5)。strict で成功すればそのまま返し、失敗した場合のみ lenient で
+ * 再パースする。lenient 結果は issues がゼロかつ補正が 1 件以上のときだけ採用し、
+ * それ以外は strict の issues を返す (エラーメッセージの分かりやすさを優先)。
+ * ブロック内部 (SEARCH/REPLACE/CONTENT の本文) ではフェンス行を除去しないため、
+ * Markdown ファイル自体を変更対象にしても本文は壊れない。
+ */
+export function parseChangesRecovering(text) {
+    const strict = parseCore(text, null);
+    if (strict.issues.length === 0)
+        return { ...strict, repairs: [] };
+    const repairs = [];
+    const lenient = parseCore(text, repairs);
+    if (lenient.issues.length === 0 && repairs.length > 0)
+        return { ...lenient, repairs };
+    return { ...strict, repairs: [] };
+}
+/** repairs が null なら strict、配列なら lenient (補正内容を追記していく) */
+function parseCore(text, repairs) {
     const rawLines = text.split(/\r?\n/);
     const issues = [];
     const files = [];
@@ -26,6 +69,19 @@ export function parseChanges(text) {
     let replaceBuf = [];
     let contentBuf = [];
     let blockLine = 0;
+    // 該当行が指定マーカーか。lenient では許容パターンも試し、一致したら補正として記録する。
+    // 呼び出し側は true を返した分岐で必ずそのマーカーとして処理するため、記録と動作は一致する
+    const isMarker = (line, no, kind) => {
+        if (line === EXACT_MARKER[kind])
+            return true;
+        if (repairs === null || !LENIENT_MARKER[kind].test(line))
+            return false;
+        repairs.push({
+            line: no,
+            message: `マーカー "${line}" を "${EXACT_MARKER[kind]}" として解釈しました`,
+        });
+        return true;
+    };
     // クロージャ経由の代入は TS の narrowing が追えないため、cur へのアクセスはここを通す
     function requireCur() {
         if (cur === null)
@@ -76,13 +132,28 @@ export function parseChanges(text) {
         const line = raw.trimEnd();
         const no = idx + 1;
         if (state === "preamble") {
-            if (line === CHANGES_HEADING)
+            if (line === CHANGES_HEADING) {
+                state = "header";
+            }
+            else if (repairs !== null && LENIENT_CHANGES_RE.test(line)) {
+                repairs.push({ line: no, message: `見出し "${line}" を "${CHANGES_HEADING}" として解釈しました` });
                 state = "header";
+            }
             continue;
         }
         if (state === "header" || state === "fileTop") {
-            if (line.startsWith(FILE_PREFIX)) {
-                const m = FILE_RE.exec(line);
+            const fileAttempt = line.startsWith(FILE_PREFIX) || (repairs !== null && LENIENT_FILE_ATTEMPT_RE.test(line));
+            if (fileAttempt) {
+                let m = FILE_RE.exec(line);
+                if (m === null && repairs !== null) {
+                    m = LENIENT_FILE_RE.exec(line);
+                    if (m !== null) {
+                        repairs.push({
+                            line: no,
+                            message: `FILE 行 "${line}" を "### FILE: ${m[1]} (${m[2]})" として解釈しました`,
+                        });
+                    }
+                }
                 if (m !== null) {
                     startSection(m[1], m[2], no);
                 }
@@ -95,7 +166,10 @@ export function parseChanges(text) {
                 continue;
             }
             if (state === "header") {
-                if (line === SEARCH || line === CONTENT || line === REPLACE_END || line === CONTENT_END) {
+                if (isMarker(line, no, "search") ||
+                    isMarker(line, no, "content") ||
+                    isMarker(line, no, "replace-end") ||
+                    isMarker(line, no, "content-end")) {
                     issues.push({
                         line: no,
                         message: `${line} が最初の FILE 行より前に現れました (### FILE: 行が壊れている可能性があります)`,
@@ -109,9 +183,13 @@ export function parseChanges(text) {
             // fileTop: FILE セクション内・ブロック外
             if (line === "")
                 continue;
+            if (repairs !== null && FENCE_RE.test(line)) {
+                repairs.push({ line: no, message: `コードフェンス行 "${line}" を無視しました` });
+                continue;
+            }
             const section = requireCur();
             if (section.op === "replace") {
-                if (line === SEARCH) {
+                if (isMarker(line, no, "search")) {
                     state = "search";
                     searchBuf = [];
                     replaceBuf = [];
@@ -125,7 +203,7 @@ export function parseChanges(text) {
                 }
             }
             else if (section.op === "create" || section.op === "rewrite") {
-                if (line === CONTENT) {
+                if (isMarker(line, no, "content")) {
                     if (section.content !== null) {
                         issues.push({
                             line: no,
@@ -153,17 +231,17 @@ export function parseChanges(text) {
             continue;
         }
         if (state === "search") {
-            if (line === DIVIDER) {
+            if (isMarker(line, no, "divider")) {
                 state = "replace";
             }
-            else if (line === REPLACE_END) {
+            else if (isMarker(line, no, "replace-end")) {
                 issues.push({
                     line: no,
                     message: `${requireCur().path}: ======= (区切り) がないまま >>>>>>> REPLACE が現れました`,
                 });
                 state = "fileTop";
             }
-            else if (line === SEARCH) {
+            else if (isMarker(line, no, "search")) {
                 issues.push({
                     line: no,
                     message: `${requireCur().path}: SEARCH ブロックが閉じられないまま次の <<<<<<< SEARCH が現れました`,
@@ -178,7 +256,7 @@ export function parseChanges(text) {
         }
         if (state === "replace") {
             const section = requireCur();
-            if (line === REPLACE_END) {
+            if (isMarker(line, no, "replace-end")) {
                 if (searchBuf.length === 0) {
                     issues.push({ line: blockLine, message: `${section.path}: SEARCH ブロックが空です` });
                 }
@@ -190,14 +268,14 @@ export function parseChanges(text) {
                 });
                 state = "fileTop";
             }
-            else if (line === DIVIDER) {
+            else if (isMarker(line, no, "divider")) {
                 issues.push({
                     line: no,
                     message: `${section.path}: ======= (区切り) が 1 ブロック内に複数あります`,
                 });
                 state = "fileTop";
             }
-            else if (line === SEARCH) {
+            else if (isMarker(line, no, "search")) {
                 issues.push({
                     line: no,
                     message: `${section.path}: >>>>>>> REPLACE で閉じられないまま次の <<<<<<< SEARCH が現れました`,
@@ -213,7 +291,7 @@ export function parseChanges(text) {
             continue;
         }
         // state === "content"
-        if (line === CONTENT_END) {
+        if (isMarker(line, no, "content-end")) {
             requireCur().content = contentBuf;
             state = "fileTop";
         }

package/dist/core/report.js

@@ -1,26 +1,94 @@
+import { STAGE_LABEL } from "./matcher.js";
+import { renderNearest } from "./nearest.js";
+const MATCH_SPEC_NOTE = [
+    "## petari の照合仕様 (SEARCH を修正する前に必ず読んでください)",
+    "",
+    "- petari は行末空白・インデントの深さ (タブ/スペース混在含む)・改行コード・文字コード",
+    "  (UTF-8 / Shift_JIS) の違いを自動で吸収して照合しています",
+    "- したがって「SEARCH が見つかりません」は空白・インデント・エンコーディングの問題では",
+    "  ありません。行の文字内容そのものが現在のファイルと異なっています",
+    "- 空白の調整・ASCII 行だけへの縮小・別アンカーへの乗り換えでは解決しません。各失敗に",
+    "  添付した「実ファイルの該当箇所」の抜粋から、行をそのままコピーしてください",
+];
 const RE_REQUEST = `## 依頼
 
 上記の失敗した各ブロックについて、SEARCH 部分を現在のファイル内容と完全に一致するよう修正し、
 changes.md 全体を元の規約フォーマット (## CHANGES から始まる形式) で再出力してください。
+- SEARCH の修正には「実ファイルの該当箇所」の抜粋を使い、「│」より右側を一字一句そのまま
+  コピーしてください (行頭の「! ~ =」の記号と行番号は含めません)
 - SEARCH ブロックにはファイル内で一意に特定できる範囲を含めてください
-- 失敗していないファイル・ブロックも含めた完全な changes.md を出力してください`;
+- 失敗していないファイル・ブロックも含めた完全な changes.md を出力してください
+- 抜粋にも SEARCH に相当する行が見当たらない場合は、推測で書き換えず、その旨を報告して
+  最新のファイル内容の共有を依頼してください`;
+/** 検証結果の一覧 (成功したブロックも含めて全て)。ファイル間の対比が診断材料になる */
+function outcomeSummary(outcomes) {
+    const lines = ["## 検証結果の一覧 (全ファイル・全ブロック)", ""];
+    for (const o of outcomes) {
+        const c = o.change;
+        if (c.op !== "replace") {
+            const status = o.failures.length > 0
+                ? `NG (${o.failures[0]?.message})`
+                : o.alreadyApplied
+                    ? "OK (適用済みのためスキップ)"
+                    : "OK (検証通過)";
+            lines.push(`- ${c.path} (${c.op}): ${status}`);
+            continue;
+        }
+        const fileLevel = o.failures.find((f) => f.block === undefined);
+        if (fileLevel !== undefined) {
+            lines.push(`- ${c.path} (replace): NG (${fileLevel.message})`);
+            continue;
+        }
+        const okCount = o.appliedBlocks.length + o.alreadyAppliedBlocks.length;
+        lines.push(`- ${c.path} (replace): ${okCount}/${o.totalBlocks} ブロック一致`);
+        const byIndex = new Map();
+        for (const b of o.appliedBlocks) {
+            byIndex.set(b.block.index, `OK 一致 (${STAGE_LABEL[b.stage]})`);
+        }
+        for (const b of o.alreadyAppliedBlocks) {
+            byIndex.set(b.block.index, "OK 適用済み (REPLACE が既に存在)");
+        }
+        for (const f of o.failures) {
+            if (f.block === undefined)
+                continue;
+            const label = f.kind === "block-ambiguous"
+                ? "NG 複数箇所に一致 (一意でない)"
+                : f.kind === "unencodable"
+                    ? "NG 変換できない文字を含む"
+                    : "NG SEARCH 不一致 (詳細は下記)";
+            byIndex.set(f.block.index, label);
+        }
+        for (const [index, status] of [...byIndex.entries()].sort((a, b) => a[0] - b[0])) {
+            lines.push(`    - ブロック ${index}: ${status}`);
+        }
+    }
+    return lines;
+}
 /** 検証失敗 (マッチング・パス・エンコーディング) のレポート */
-export function buildFailureReport(failures) {
-    const parts = [
-        "以下の変更ブロックが現在のコードベースに適用できませんでした。",
-        "",
-        "## 適用失敗の詳細",
-    ];
+export function buildFailureReport(failures, ctx = {}) {
+    const parts = ["以下の変更ブロックが現在のコードベースに適用できませんでした。"];
+    if (ctx.nothingWritten === true) {
+        parts.push("", "※ この失敗により petari は何も書き込んでいません (all-or-nothing)。下の一覧で「一致」と", "表示されたブロックもまだファイルには適用されていないため、再出力には失敗していない", "ブロックもすべて含めてください。");
+    }
+    parts.push("", ...MATCH_SPEC_NOTE);
+    if (ctx.outcomes !== undefined) {
+        parts.push("", ...outcomeSummary(ctx.outcomes));
+    }
+    parts.push("", "## 適用失敗の詳細");
     for (const f of failures) {
         parts.push("", `### ${f.path}`, `失敗理由: ${f.message}`);
         if (f.block !== undefined) {
             parts.push("", "```", "<<<<<<< SEARCH", ...f.block.search, "=======", ...f.block.replace, ">>>>>>> REPLACE", "```");
         }
+        if (f.nearest !== undefined) {
+            parts.push("", ...renderNearest(f.nearest));
+        }
     }
     parts.push("", RE_REQUEST, "");
     return parts.join("\n");
 }
-/** 構文エラー (パース失敗) のレポート */
+/** 構文エラー (パース失敗) のレポート。規約文がチャット側で失われていても
+ * このレポート単体で再出力を依頼できるよう、フォーマットの要点を再掲する */
 export function buildParseErrorReport(issues) {
     const parts = [
         "受け取った changes.md が規約フォーマットとして解釈できませんでした。",
@@ -29,11 +97,22 @@ export function buildParseErrorReport(issues) {
         "",
         ...issues.map((i) => `- ${i.line} 行目: ${i.message}`),
         "",
+        "## 規約フォーマットの要点 (再掲)",
+        "",
+        "- 出力は必ず行頭の「## CHANGES」の行から始め、変更概要のあとに各ファイルのセクションを置く",
+        "- 各ファイルは「### FILE: 相対パス (replace|create|rewrite|delete)」の見出し行で始める",
+        "- replace は <<<<<<< SEARCH / ======= / >>>>>>> REPLACE のブロックで書き、",
+        "  SEARCH の内容は現在のファイルから一字一句そのままコピーする",
+        "- create / rewrite は <<<<<<< CONTENT / >>>>>>> END のブロックにファイル全文を書く。delete は本文なし",
+        "- マーカー行は必ず行頭から書き、前後に他の文字を付けない (< > = はいずれも 7 個)",
+        "- 出力全体や各ブロックをコードフェンス (```) で包まない",
+        "- FILE セクションの間に説明文を書かない (説明は冒頭の CHANGES セクションへ)",
+        "",
         "## 依頼",
         "",
         "上記の構文エラーを修正し、changes.md 全体を規約フォーマット (## CHANGES から始まり、",
         "### FILE: 行と <<<<<<< SEARCH / ======= / >>>>>>> REPLACE 等のマーカーを行頭に置く形式) で",
-        "再出力してください。",
+        "再出力してください。失敗していないファイル・ブロックも含めた完全な changes.md を出力してください。",
         "",
     ];
     return parts.join("\n");

package/dist/infra/clipboard.js

@@ -6,7 +6,7 @@
  *   Linux: xclip (インストールされている場合のみ)
  */
 import { execFile, spawn } from "node:child_process";
-import { mkdtempSync, writeFileSync } from "node:fs";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { promisify } from "node:util";
@@ -48,14 +48,21 @@ export async function writeClipboard(text) {
     if (process.platform === "win32") {
         // コンソールのコードページに依存しないよう UTF-8 の一時ファイル経由で渡す。
         // パスは PowerShell の単一引用符で渡す (' は '' にエスケープ。展開・注入が起きない)
-        const file = join(mkdtempSync(join(tmpdir(), "petari-clip-")), "report.txt");
-        writeFileSync(file, text, "utf8");
-        const quoted = `'${file.replaceAll("'", "''")}'`;
-        await execFileP("powershell", [
-            "-NoProfile",
-            "-Command",
-            `Get-Content -Raw -Encoding UTF8 -LiteralPath ${quoted} | Set-Clipboard`,
-        ]);
+        const dir = mkdtempSync(join(tmpdir(), "petari-clip-"));
+        const file = join(dir, "report.txt");
+        try {
+            writeFileSync(file, text, "utf8");
+            const quoted = `'${file.replaceAll("'", "''")}'`;
+            await execFileP("powershell", [
+                "-NoProfile",
+                "-Command",
+                `Get-Content -Raw -Encoding UTF8 -LiteralPath ${quoted} | Set-Clipboard`,
+            ]);
+        }
+        finally {
+            // レポートはコードの断片を含むため一時ファイルを残さない
+            rmSync(dir, { recursive: true, force: true });
+        }
         return;
     }
     await viaStdin("xclip", ["-selection", "clipboard"], text);

package/dist/infra/config.js

@@ -6,6 +6,7 @@ export const DEFAULT_CONFIG = {
     newFile: { encoding: "utf8", eol: "lf" },
     historyLimit: null,
     vscodeCommand: "code",
+    clipReportOnFailure: true,
 };
 /** グローバル設定のパス (§10)。Windows は %APPDATA%、他は XDG (~/.config) */
 export function globalConfigPath() {
@@ -45,6 +46,9 @@ function validateConfig(c) {
     if (c.downloadsDir !== null && typeof c.downloadsDir !== "string") {
         throw new Error("config の downloadsDir が不正です (null または文字列を指定)");
     }
+    if (typeof c.clipReportOnFailure !== "boolean") {
+        throw new Error("config の clipReportOnFailure が不正です (true | false)");
+    }
     return c;
 }
 /** 既定 < グローバル < プロジェクトの順でマージする (プロジェクト優先・§10) */

package/dist/infra/term.js

@@ -12,3 +12,17 @@ export function sanitizeForTerminal(s) {
 }
 export const out = (s) => void process.stdout.write(sanitizeForTerminal(s) + "\n");
 export const err = (s) => void process.stderr.write(sanitizeForTerminal(s) + "\n");
+const RESET = "\u001B[0m";
+const BOLD_YELLOW = "\u001B[1;33m";
+const BOLD_REVERSE_YELLOW = "\u001B[1;7;33m";
+/**
+ * 目立たせたい行の出力。装飾コードはこのファイルのリテラル定数のみで、
+ * 本文はサニタイズ後に着色するため ANSI 注入対策 (上記) は保たれる。
+ * 非 TTY (パイプ・リダイレクト) と NO_COLOR 指定時は装飾なしで出力する。
+ */
+export const outEmphasis = (s, reverse = false) => {
+    const clean = sanitizeForTerminal(s);
+    const decorate = process.stdout.isTTY === true && process.env["NO_COLOR"] === undefined;
+    const colored = decorate ? `${reverse ? BOLD_REVERSE_YELLOW : BOLD_YELLOW}${clean}${RESET}` : clean;
+    process.stdout.write(colored + "\n");
+};

package/package.json

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