petari 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuki Sakakibara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# petari
+
+**petari — paste AI chat patches onto your codebase**
+**petari — AIチャットの返答を、コードベースにぺたり。**
+
+チャットベース AI (M365 Copilot Chat 等) の返答を、ローカルのコードベースへ安全に一括適用する CLI ツールです。
+AI に規約形式の変更指示ファイル (changes.md) を出力させ、petari がパース・検証して適用します。
+レビューは Git の未コミット差分として VS Code で行い、適用の履歴 (before/after/指示原本) は
+`.petari/history/` に自動保存されます。
+
+## インストール
+
+```sh
+pnpm add -g petari   # または npx petari
+```
+
+## 使い方
+
+```sh
+petari init              # プロジェクト初回セットアップ (protocol.md / 設定 / repomix 連携 / .gitignore)
+repomix                  # 規約文入りのコンテキストを生成して AI チャットに渡す
+                         # → AI から changes.md をダウンロード
+petari                   # Downloads の changes.md を自動検出して適用
+git diff                 # VS Code で差分レビュー・手修正
+petari undo              # 直近の適用を巻き戻す
+```
+
+### コマンド
+
+| コマンド | 説明 |
+|---|---|
+| `petari [path]` | changes.md を適用。省略時は Downloads から自動検出 (直近 30 分)。`--clip` でクリップボードから |
+| `petari undo [ID]` | 履歴を巻き戻す (手修正がある場合は警告) |
+| `petari show <ID>` | VS Code の差分ビューで履歴を表示。`--mine` で適用後の手修正分、`--changes` で変更概要 |
+| `petari list` | 履歴の一覧と合計サイズ |
+| `petari protocol` | AI への規約文を標準出力に出す (slnmix / repomix 連携用) |
+| `petari init` | プロジェクト初回セットアップ (`--yes` で全提案に同意) |
+
+主なオプション: `--dry-run` (検証と差分プレビューのみ) / `--partial` (成功分のみ適用) /
+`--root <dir>` / `--yes` / `--clip-report` (失敗レポートをクリップボードへ)
+
+## 特徴
+
+- **all-or-nothing**: 全ブロックを事前検証し、1 つでも失敗があれば何も書き込まない
+- **エンコーディング保全**: Shift_JIS / UTF-8 (BOM 有無)・CRLF / LF・末尾改行を完全維持。
+  変更していない行は元のバイト列をそのまま書き戻す (レガシー VB.NET 資産でも安全)
+- **失敗レポート**: そのまま AI チャットに貼り返せる形式で出力。再依頼が 1 コピペで済む
+- **実行時依存ゼロ**: サプライチェーン対策として外部パッケージに依存しない
+  (Shift_JIS 変換テーブルも Node 組み込み ICU から自動生成して同梱)
+
+## セキュリティ設計
+
+社内利用の審査 (情報システム部門のレビュー等) を想定した要点です。
+
+### 通信・依存関係
+
+- **実行時のネットワーク通信は一切行いません**。AI との通信機能はなく、入力はローカルファイル
+  またはクリップボードのみ。テレメトリ・自動更新もありません
+- **実行時依存パッケージはゼロ**です。npm のインストールスクリプト (postinstall 等) も
+  使用しません。Shift_JIS 変換テーブルは Node.js 組み込みの ICU から生成しリポジトリに
+  同梱しています (外部データの取り込みなし)
+- 子プロセスの起動はすべて `execFile`/`spawn` の配列引数で行い、シェルを経由しません
+  (コマンドインジェクション不成立)。起動するのは `git` / `reg` / `powershell` /
+  `pbcopy`・`pbpaste` / VS Code (`code`) のみです
+
+### 入力の取り扱い (信頼境界)
+
+changes.md (AI 出力)・クリップボード・リポジトリに同梱され得る `.petari/` 内のファイルは
+**すべて非信頼入力**として扱います。
+
+- 書き込み先パスは**プロジェクトルート相対のみ**。絶対パス・UNC・ドライブレター・`..`・`~`・
+  `:` (NTFS 代替データストリーム)・Windows 予約デバイス名 (CON/NUL/COM1 等、末尾ドット・
+  空白による偽装を含む) を拒否します
+- シンボリックリンク自体の書き換えに加え、**symlink ディレクトリ経由でルート外へ出るパスも
+  realpath 検証で拒否**します
+- パス検証は apply だけでなく undo / show (履歴 manifest 由来のパス) にも適用します
+- 端末出力は制御文字 (ANSI エスケープ・双方向制御文字 = Trojan Source) を除去してから
+  表示します (表示偽装対策)
+- 差分ビューアのコマンド (`vscodeCommand` 設定) は PATH 上のコマンド名か絶対パスのみ許可し、
+  リポジトリ内スクリプトを指せる相対パスと UNC パスを拒否します
+
+### 適用の安全弁と監査性
+
+- 全変更を**事前検証してから書き込む all-or-nothing** (1 件でも失敗すれば何も書かない)。
+  `--dry-run` で書き込みなしの事前確認が可能
+- すべての適用は `.petari/history/` に **適用前後のファイル・指示原本・SHA-256 付き
+  manifest** として記録され、`petari undo` で巻き戻せます (監査証跡)
+- Git 作業ツリーに未コミット変更がある場合は警告し、適用前に確認を求めます
+
+### 既知の検知可能性・残リスク
+
+- Windows でクリップボード機能 (`--clip` / `--clip-report`) を使うと
+  `node.exe → powershell.exe (Get-Clipboard / Set-Clipboard)` の親子プロセスが発生し、
+  **EDR がログ・アラート対象にする可能性があります** (ユーザー起点の単発実行です。
+  PowerShell が制限された環境ではクリップボード機能のみ失敗し、ファイル入力は動作します)
+- 検証と書き込みの間の TOCTOU (ファイル差し替え) は検出しません (単独利用の CLI として許容)
+- 履歴には対象ファイルの複製が平文で保存されます。`.petari/` は `.gitignore` 推奨
+  (init が自動提案) で、リポジトリには含まれません
+
+## 開発
+
+```sh
+pnpm install
+pnpm typecheck   # tsc --noEmit
+pnpm test        # vitest
+pnpm build       # dist/ へビルド
+```
+
+設計方針・規約は [CLAUDE.md](CLAUDE.md)、仕様の正本は [requirements.md](requirements.md) を参照。
+
+## License
+
+MIT

package/dist/assets/protocol.js

@@ -0,0 +1,73 @@
+/**
+ * AI への規約文 (§4.5)。single source はこのファイル。
+ * slnmix は `petari protocol` の出力を取り込み、repomix は
+ * `petari protocol > protocol.md` + instructionFilePath で読み込む。
+ * 内容を変更したら PROTOCOL_VERSION を上げること。
+ */
+export const PROTOCOL_VERSION = 1;
+export const PROTOCOL_TEXT = `<!-- petari protocol v${PROTOCOL_VERSION} -->
+# コード変更の出力規約 (changes.md)
+
+コードの変更を提案するときは、必ず以下の規約に従った Markdown ファイルを 1 つ出力してください。
+ファイル名は changes.md とし、ダウンロードできる形で提供してください。
+このファイルはツールが機械的にパースしてローカルのコードベースへ適用します。
+規約から外れた出力は適用に失敗します。
+
+## 全体構造
+
+出力は必ず「## CHANGES」の行から始めます。
+
+\`\`\`
+## CHANGES
+
+(変更概要 — 必須。何を・なぜ変えるかを簡潔に)
+
+影響ファイル:
+- src/utils/date.ts
+- src/components/New.tsx
+
+(処理フローが変わる場合のみ、Mermaid 図を付ける — 任意)
+
+### FILE: src/utils/date.ts (replace)
+<<<<<<< SEARCH
+old code
+=======
+new code
+>>>>>>> REPLACE
+
+### FILE: src/components/New.tsx (create)
+<<<<<<< CONTENT
+(ファイル全文)
+>>>>>>> END
+
+### FILE: src/legacy/Old.vb (rewrite)
+<<<<<<< CONTENT
+(ファイル全文)
+>>>>>>> END
+
+### FILE: src/legacy/Unused.vb (delete)
+\`\`\`
+
+## 操作種別
+
+- replace: 部分変更。SEARCH/REPLACE ブロックを使う。1 ファイルに複数ブロック可
+- create: 新規ファイル作成。CONTENT ブロックに全文を書く。既存ファイルには使わない
+- rewrite: 既存ファイルの全文置き換え。**ファイルの過半が変わる場合は replace ではなく rewrite を使う**
+- delete: ファイル削除。ブロック本文は書かない
+- ファイル名変更 (rename) は「旧パスの delete + 新パスの create」で表現する
+
+## 厳守事項
+
+1. マーカー行 (\`### FILE:\` \`<<<<<<< SEARCH\` \`=======\` \`>>>>>>> REPLACE\` \`<<<<<<< CONTENT\` \`>>>>>>> END\`) は
+   必ず行頭から書き、前後に他の文字を付けない
+2. SEARCH ブロックの内容は、**現在のファイルから一字一句そのまま** (インデント・空白を含めて) コピーする。
+   記憶に頼って書き換えたり要約したりしない
+3. SEARCH ブロックには **ファイル内で一意に特定できる範囲** を含める
+   (同じコードが複数箇所にある場合は、前後の行を含めて一意にする)
+4. パスはプロジェクトルートからの相対パスを / 区切りで書く。絶対パスや .. は使わない
+5. 同じファイルへの変更は 1 つの FILE セクションにまとめる (セクションを重複させない)
+6. FILE セクションの間に説明文を書かない。説明はすべて冒頭の CHANGES セクションに書く
+7. 対象ファイルが日本語 Shift_JIS の場合、絵文字など Shift_JIS で表現できない文字を
+   コード中に入れない
+8. changes.md 以外の出力 (前置き・後書き) は最小限にする
+`;

package/dist/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { join, dirname } from "node:path";
+import { err as errLine } from "./infra/term.js";
+const SUBCOMMANDS = ["undo", "show", "list", "protocol", "init"];
+function version() {
+    const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    return JSON.parse(readFileSync(pkgPath, "utf8")).version;
+}
+const HELP = `petari — paste AI chat patches onto your codebase
+
+Usage:
+  petari [path]         changes.md を適用 (省略時: Downloads から自動検出)
+  petari undo [ID]      履歴を巻き戻す (ID 省略時: 直近)
+  petari show <ID>      履歴の差分を VS Code で表示
+  petari list           履歴の一覧を表示
+  petari protocol       AI への規約文を標準出力に出す
+  petari init           プロジェクト初回セットアップ
+
+Options:
+  -h, --help            ヘルプを表示
+  -v, --version         バージョンを表示
+`;
+export async function main(argv) {
+    if (argv.includes("-h") || argv.includes("--help")) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (argv.includes("-v") || argv.includes("--version")) {
+        process.stdout.write(version() + "\n");
+        return 0;
+    }
+    const first = argv[0];
+    const sub = first !== undefined && SUBCOMMANDS.includes(first)
+        ? first
+        : "apply";
+    const rest = sub === "apply" ? argv : argv.slice(1);
+    switch (sub) {
+        case "apply": {
+            const { applyCommand } = await import("./commands/apply.js");
+            return applyCommand(rest);
+        }
+        case "undo": {
+            const { undoCommand } = await import("./commands/undo.js");
+            return undoCommand(rest);
+        }
+        case "show": {
+            const { showCommand } = await import("./commands/show.js");
+            return showCommand(rest);
+        }
+        case "list": {
+            const { listCommand } = await import("./commands/list.js");
+            return listCommand(rest);
+        }
+        case "protocol": {
+            const { protocolCommand } = await import("./commands/protocol.js");
+            return protocolCommand(rest);
+        }
+        case "init": {
+            const { initCommand } = await import("./commands/init.js");
+            return initCommand(rest);
+        }
+        default:
+            process.stderr.write(`petari: "${sub}" は未実装です\n`);
+            return 1;
+    }
+}
+const invokedDirectly = process.argv[1] !== undefined &&
+    import.meta.url === new URL(`file://${process.argv[1]}`).href;
+if (invokedDirectly || process.argv[1]?.endsWith("cli.js") || process.argv[1]?.endsWith("cli.ts")) {
+    main(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    }, (err) => {
+        // エラーメッセージには changes.md 由来の文字が混入し得るためサニタイズして出力
+        errLine(`petari: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    });
+}

package/dist/commands/apply.js

@@ -0,0 +1,271 @@
+/**
+ * petari [path] — 適用コマンド (§4.1)。
+ * 手順: パース → 全件ドライラン検証 → (失敗があれば何も書かずレポート) →
+ * before 保存 → 書き換え → after 保存 → サマリ表示。
+ */
+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 { parseChanges } 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 { beginHistory, createHistoryId, finishHistory, pruneHistory, } from "../infra/history.js";
+import { confirm } from "../infra/prompt.js";
+import { findProjectRoot } from "../infra/root.js";
+/** --partial 時: このファイルは書き込み対象か */
+function isApplicable(o) {
+    if (o.failures.length === 0)
+        return true;
+    return o.change.op === "replace" && o.appliedBlocks.length > 0;
+}
+function opLabel(o) {
+    const c = o.change;
+    if (c.op === "replace")
+        return `replace ${c.path} — ${o.appliedBlocks.length}/${o.totalBlocks} ブロック`;
+    return `${c.op.padEnd(7)} ${c.path}`;
+}
+function printPreview(outcomes) {
+    for (const o of outcomes) {
+        out(`  ${opLabel(o)}`);
+        for (const b of o.appliedBlocks) {
+            out(`    @@ ${o.change.path}:${b.start + 1} (${b.stage})`);
+            for (const l of b.removed)
+                out(`    - ${l}`);
+            for (const l of b.inserted)
+                out(`    + ${l}`);
+        }
+    }
+}
+export async function applyCommand(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            "dry-run": { type: "boolean", default: false },
+            partial: { type: "boolean", default: false },
+            root: { type: "string" },
+            yes: { type: "boolean", short: "y", default: false },
+            clip: { type: "boolean", default: false },
+            "clip-report": { type: "boolean", default: false },
+        },
+        allowPositionals: true,
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    const config = loadConfig(root);
+    if (!existsSync(join(root, ".petari"))) {
+        out("ヒント: 初回は `petari init` を実行すると protocol.md や設定の雛形が整います");
+    }
+    // レポートを標準出力へ出し、--clip-report ならクリップボードにもコピーする (§7)
+    const emitReport = async (report) => {
+        out(report);
+        if (values["clip-report"]) {
+            try {
+                await writeClipboard(report);
+                out("(レポートをクリップボードにコピーしました)");
+            }
+            catch (e) {
+                err(`petari: クリップボードへのコピーに失敗: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    };
+    const stripBom = (s) => s.replace(/^\uFEFF/, "");
+    // 入力ソースの優先順位 (§4.1): 引数 > --clip > Downloads 自動検出
+    let changesText;
+    let source;
+    const inputPath = positionals[0];
+    if (inputPath !== undefined) {
+        const abs = resolve(process.cwd(), inputPath);
+        try {
+            changesText = stripBom(readFileSync(abs, "utf8"));
+        }
+        catch {
+            err(`petari: ファイルを読めません: ${abs}`);
+            return 1;
+        }
+        source = { type: "file", path: abs };
+    }
+    else if (values.clip) {
+        try {
+            changesText = stripBom(await readClipboard());
+        }
+        catch (e) {
+            err(`petari: クリップボードを読めません: ${e instanceof Error ? e.message : String(e)}`);
+            return 1;
+        }
+        if (changesText.trim() === "") {
+            err("petari: クリップボードが空です");
+            return 1;
+        }
+        source = { type: "clipboard" };
+    }
+    else {
+        const downloadsDir = await resolveDownloadsDir(config.downloadsDir);
+        const candidates = findRecentChangesFiles(downloadsDir, new Date());
+        if (candidates.length === 0) {
+            err(`petari: ${downloadsDir} に直近 30 分以内の changes*.md が見つかりません`);
+            err("  ファイルパスを指定するか、--clip でクリップボードから読み込んでください");
+            return 1;
+        }
+        const newest = candidates[0];
+        out(`Downloads から検出: ${newest.path}`);
+        if (candidates.length > 1) {
+            out(`  (他 ${candidates.length - 1} 件の候補があります。最新を使用します)`);
+            for (const c of candidates.slice(1))
+                out(`    - ${c.path}`);
+            if (!values.yes && !(await confirm("このファイルを適用しますか?"))) {
+                out("中止しました。");
+                return 1;
+            }
+        }
+        try {
+            changesText = stripBom(readFileSync(newest.path, "utf8"));
+        }
+        catch {
+            err(`petari: ファイルを読めません: ${newest.path}`);
+            return 1;
+        }
+        source = { type: "downloads", path: newest.path };
+    }
+    // 1. パース (構文エラーは即時失敗・§4.1)
+    const { changeSet, issues } = parseChanges(changesText);
+    if (issues.length > 0) {
+        err("petari: changes.md の構文エラーです。何も書き込んでいません。\n");
+        await emitReport(buildParseErrorReport(issues));
+        return 1;
+    }
+    // 2. 全ブロックのドライラン検証
+    const states = new Map();
+    for (const f of changeSet.files) {
+        if (invalidPathReason(f.path) !== null) {
+            states.set(f.path, { exists: false, symlink: false, bytes: null });
+            continue;
+        }
+        const abs = join(root, f.path);
+        // symlink ディレクトリ経由でルート外に出るパスは検証段階で失敗させる (§9)
+        if (!isInsideRoot(root, abs)) {
+            states.set(f.path, { exists: false, symlink: false, bytes: null, escapesRoot: true });
+            continue;
+        }
+        states.set(f.path, readFileState(abs));
+    }
+    const plan = planChangeSet(changeSet, states, config.newFile);
+    // 3. 失敗があれば何も書き込まずレポート (§4.1, §7)
+    if (!plan.ok && !values.partial) {
+        err(`petari: 検証に失敗しました (${plan.failures.length} 件)。何も書き込んでいません。\n`);
+        await emitReport(buildFailureReport(plan.failures));
+        return 1;
+    }
+    const applicable = plan.outcomes.filter(isApplicable);
+    if (applicable.length === 0) {
+        err("petari: 適用できる変更がありません。\n");
+        await emitReport(buildFailureReport(plan.failures));
+        return 1;
+    }
+    if (values["dry-run"]) {
+        out(`dry-run: 適用予定 ${applicable.length} ファイル (書き込みなし)`);
+        printPreview(applicable);
+        if (plan.failures.length > 0) {
+            out("");
+            await emitReport(buildFailureReport(plan.failures));
+        }
+        return 0;
+    }
+    // 確認 (§4.1, §9)
+    out(`プロジェクトルート: ${root}`);
+    out(`適用予定 ${applicable.length} ファイル:`);
+    for (const o of applicable)
+        out(`  ${opLabel(o)}`);
+    if (plan.failures.length > 0) {
+        out(`  (検証失敗 ${plan.failures.length} 件は --partial によりスキップ)`);
+    }
+    const dirty = await gitDirtyFiles(root);
+    if (dirty !== null && dirty.length > 0) {
+        out(`警告: Git 作業ツリーに未コミットの変更が ${dirty.length} 件あります`);
+    }
+    if (!values.yes) {
+        if (!(await confirm("適用しますか?"))) {
+            out("中止しました。");
+            return 1;
+        }
+    }
+    // 4. before 保存 → 書き換え → after 保存 (§4.1 手順 4, §5)
+    const id = createHistoryId(root, new Date());
+    const before = new Map();
+    for (const o of applicable) {
+        before.set(o.change.path, states.get(o.change.path)?.bytes ?? null);
+    }
+    beginHistory(root, id, changesText, before);
+    const after = new Map();
+    for (const o of applicable) {
+        const abs = join(root, o.change.path);
+        if (o.change.op === "delete") {
+            deleteFile(abs);
+            after.set(o.change.path, null);
+        }
+        else {
+            writeBytes(abs, o.afterBytes);
+            after.set(o.change.path, o.afterBytes);
+        }
+    }
+    const entries = plan.outcomes.map((o) => {
+        const applied = isApplicable(o);
+        const beforeBytes = states.get(o.change.path)?.bytes ?? null;
+        const afterBytes = applied ? (after.get(o.change.path) ?? null) : null;
+        const skipped = o.failures
+            .filter((f) => f.block !== undefined)
+            .map((f) => ({ index: f.block.index, reason: f.message }));
+        const entry = {
+            path: o.change.path,
+            op: o.change.op,
+            applied,
+            blocks: o.totalBlocks,
+            appliedBlocks: o.appliedBlocks.length,
+            beforeSha256: beforeBytes !== null ? sha256(beforeBytes) : null,
+            afterSha256: afterBytes !== null ? sha256(afterBytes) : null,
+        };
+        if (skipped.length > 0)
+            entry.skippedBlocks = skipped;
+        return entry;
+    });
+    const manifest = {
+        id,
+        appliedAt: new Date().toISOString(),
+        success: plan.ok,
+        partial: values.partial,
+        source,
+        files: entries,
+    };
+    finishHistory(root, id, manifest, after);
+    const pruned = pruneHistory(root, config.historyLimit);
+    if (pruned.length > 0) {
+        out(`古い履歴 ${pruned.length} 件を削除しました (historyLimit: ${config.historyLimit})`);
+    }
+    // 5. サマリ (§4.1 手順 5)
+    out("");
+    out(`適用しました (履歴 ID: ${id})`);
+    for (const o of applicable)
+        out(`  ${opLabel(o)}`);
+    if (plan.failures.length > 0) {
+        out(`スキップした失敗 ${plan.failures.length} 件のレポート:`);
+        out("");
+        await emitReport(buildFailureReport(plan.failures));
+    }
+    // 6. Downloads 由来なら changes.md を履歴へ移動 (原本は history に保存済み・§4.1)
+    if (source.type === "downloads" && source.path !== undefined) {
+        try {
+            deleteFile(source.path);
+            out(`Downloads の ${source.path} を履歴へ移動しました`);
+        }
+        catch {
+            err(`petari: ${source.path} を削除できませんでした (履歴には保存済み)`);
+        }
+    }
+    out("");
+    out("git diff で差分を確認してください。巻き戻しは `petari undo` です。");
+    return 0;
+}

package/dist/commands/init.js

@@ -0,0 +1,101 @@
+/**
+ * petari init — プロジェクト初回セットアップの一括実行 (§4.6)。
+ * 対話形式 (--yes で全提案に自動同意)。既存ファイルは上書きせず確認する。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { PROTOCOL_TEXT } from "../assets/protocol.js";
+import { confirm } from "../infra/prompt.js";
+import { findProjectRoot } from "../infra/root.js";
+import { err, out } from "../infra/term.js";
+const CONFIG_TEMPLATE = `{
+  "downloadsDir": null,
+  "newFile": { "encoding": "utf8", "eol": "lf" },
+  "historyLimit": null,
+  "vscodeCommand": "code"
+}
+`;
+export async function initCommand(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            root: { type: "string" },
+            yes: { type: "boolean", short: "y", default: false },
+        },
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    const ask = async (question) => values.yes ? true : confirm(question);
+    out(`プロジェクトルート: ${root}`);
+    // 1. .petari/config.json の雛形 (§4.6-1)
+    const configPath = join(root, ".petari", "config.json");
+    if (existsSync(configPath)) {
+        out(`1. ${configPath} は既にあります (変更しません)`);
+    }
+    else if (await ask("1. .petari/config.json の雛形を作成しますか?")) {
+        mkdirSync(join(root, ".petari"), { recursive: true });
+        writeFileSync(configPath, CONFIG_TEMPLATE, "utf8");
+        out(`   作成しました: ${configPath}`);
+    }
+    // 2. protocol.md (§4.6-2)
+    const protocolPath = join(root, "protocol.md");
+    if (existsSync(protocolPath)) {
+        const current = readFileSync(protocolPath, "utf8");
+        if (current === PROTOCOL_TEXT) {
+            out(`2. ${protocolPath} は最新です`);
+        }
+        else if (await ask("2. protocol.md の内容が規約文と異なります。更新しますか?")) {
+            writeFileSync(protocolPath, PROTOCOL_TEXT, "utf8");
+            out(`   更新しました: ${protocolPath}`);
+        }
+    }
+    else if (await ask("2. protocol.md (AI への規約文) をプロジェクト直下に作成しますか?")) {
+        writeFileSync(protocolPath, PROTOCOL_TEXT, "utf8");
+        out(`   作成しました: ${protocolPath}`);
+    }
+    // 3. repomix 連携 (§4.6-3)
+    const repomixPath = join(root, "repomix.config.json");
+    if (existsSync(repomixPath)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(repomixPath, "utf8"));
+        }
+        catch {
+            err(`3. ${repomixPath} を JSON として読めないためスキップします`);
+            parsed = { output: { instructionFilePath: "(parse error)" } };
+        }
+        if (parsed.output?.instructionFilePath !== undefined) {
+            out(`3. repomix.config.json は instructionFilePath 設定済みです (変更しません)`);
+        }
+        else if (await ask('3. repomix.config.json に output.instructionFilePath: "protocol.md" を追記しますか?')) {
+            parsed.output = { ...(parsed.output ?? {}), instructionFilePath: "protocol.md" };
+            writeFileSync(repomixPath, JSON.stringify(parsed, null, 2) + "\n", "utf8");
+            out(`   追記しました: ${repomixPath}`);
+        }
+    }
+    else if (await ask("3. repomix 連携用の repomix.config.json (最小構成) を作成しますか?")) {
+        writeFileSync(repomixPath, JSON.stringify({ output: { instructionFilePath: "protocol.md" } }, null, 2) + "\n", "utf8");
+        out(`   作成しました: ${repomixPath}`);
+    }
+    // 4. .gitignore に .petari/ (§4.6-4, §5)
+    const gitignorePath = join(root, ".gitignore");
+    if (existsSync(gitignorePath)) {
+        const lines = readFileSync(gitignorePath, "utf8").split(/\r?\n/);
+        if (lines.some((l) => l.trim() === ".petari/" || l.trim() === ".petari")) {
+            out("4. .gitignore は .petari/ を含んでいます");
+        }
+        else if (await ask("4. .gitignore に .petari/ を追記しますか?")) {
+            const text = readFileSync(gitignorePath, "utf8");
+            writeFileSync(gitignorePath, text + (text.endsWith("\n") || text === "" ? "" : "\n") + ".petari/\n", "utf8");
+            out("   追記しました: .gitignore");
+        }
+    }
+    else if (await ask("4. .gitignore を作成して .petari/ を追記しますか?")) {
+        writeFileSync(gitignorePath, ".petari/\n", "utf8");
+        out("   作成しました: .gitignore");
+    }
+    out("");
+    out("セットアップ完了。repomix 実行で規約文入りのコンテキストが生成されます。");
+    out("slnmix を使う場合は、出力に protocol.md を連結してください (petari protocol でも出力できます)。");
+    return 0;
+}