petari 0.10.0 → 0.12.0

package/README.md

@@ -25,6 +25,12 @@ git diff                 # VS Code で差分レビュー・手修正
 petari undo              # 直近の適用を巻き戻す
 ```
 
+往復が続くときは、別の端末で `petari watch` を起動しておくと、ダウンロードした
+changes.md が届くたびに確認なしで適用されます (毎回 `petari` を打たなくてよくなります。
+v0.12.0)。失敗したときはレポートがクリップボードに入るので、そのまま AI に貼り返します。
+止めるときは Ctrl+C です。ブラウザのダウンロード先とコードが同じ PC にあることが前提で、
+RDP 越しに受け渡す運用では従来どおり `petari` / `petari --clip` を使います。
+
 ### slnmix 連携 (レガシー VB.NET プロジェクト)
 
 [slnmix](https://www.npmjs.com/package/slnmix) v0.7.0 以降は、入力 (.sln / .vbproj) と
@@ -32,12 +38,15 @@ petari undo              # 直近の適用を巻き戻す
 `instructionFilePath` 相当。別の場所に置く場合は `--instruction-file <path>`)。
 
 ```sh
-npx petari init      # protocol.md を生成 (.sln と同じプロジェクト直下に)
+npx slnmix init      # 初回だけ。protocol.md / .petari/ / docs/ / .gitignore をまとめて準備
+                     # (slnmix v0.18.0 以降。内部で petari init --yes --no-repomix を実行)
 npx slnmix           # .sln を解析。出力末尾に規約文が自動で付く
                      # → 出力を M365 Copilot Chat に貼る
 petari               # 返答 (changes.md) を適用
 ```
 
+slnmix v0.17.0 以前では `npx petari init` で protocol.md を作ります (.sln と同じプロジェクト直下に)。
+
 **変更を依頼するメッセージには、必ず次の 1 行を添えてください。**
 貼り付け本文に埋め込まれた規約文は、チャットサービス側の要約・検索処理で
 モデルに届かなかったり、チャット本文の指示より弱く扱われたりすることがあります
@@ -86,11 +95,12 @@ slnmix の出力) が実ファイルとずれている**可能性が高いです
 | コマンド | 説明 |
 |---|---|
 | `petari [path]` | changes.md を適用。省略時は Downloads とプロジェクト直下から自動検出 (直近 30 分)。`--clip` でクリップボードから |
+| `petari watch` | Downloads とプロジェクト直下を見張り、起動後に届いた changes*.md を確認なしで適用し続ける (Ctrl+C で終了)。`--dry-run` で検証とプレビューだけ |
 | `petari undo [ID]` | 履歴を巻き戻す (手修正がある場合は警告) |
 | `petari show [ID]` | 履歴の差分を表示 (VS Code、なければブラウザにフォールバック)。`--edit` で現在のファイルを差分を見ながら手修正、`--mine` で適用後の手修正分、`--changes` で変更概要、`--browser` でブラウザ強制 |
 | `petari list` | 履歴の一覧と合計サイズ |
 | `petari protocol` | AI への規約文を標準出力に出す (slnmix / repomix 連携用) |
-| `petari init` | プロジェクト初回セットアップ (`--yes` で全提案に同意) |
+| `petari init` | プロジェクト初回セットアップ (`--yes` で全提案に同意。`--no-repomix` で repomix 連携を省く。slnmix 利用者は `npx slnmix init` が代わりに呼ぶ) |
 
 主なオプション: `--dry-run` (検証と差分プレビューのみ) / `--partial` (成功分のみ適用) /
 `--root <dir>` / `--yes` / `--clip-report` (失敗レポートをクリップボードへ。v0.5.0 から既定で自動コピーされるため、config で無効化した場合の個別指定用) /

package/dist/cli.js

@@ -3,7 +3,7 @@ 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"];
+const SUBCOMMANDS = ["undo", "show", "list", "protocol", "init", "watch"];
 function version() {
     const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
     return JSON.parse(readFileSync(pkgPath, "utf8")).version;
@@ -12,11 +12,14 @@ const HELP = `petari — paste AI chat patches onto your codebase
 
 Usage:
   petari [path]         changes.md を適用 (省略時: Downloads から自動検出)
+  petari watch          Downloads を見張り、届いた changes.md を確認なしで適用
+                        (Ctrl+C で終了)
   petari undo [ID]      履歴を巻き戻す (ID 省略時: 直近)
   petari show [ID]      履歴の差分を表示 (VS Code / ブラウザ)。--edit で手修正
   petari list           履歴の一覧を表示
   petari protocol       AI への規約文を標準出力に出す
-  petari init           プロジェクト初回セットアップ
+  petari init           プロジェクト初回セットアップ (--yes で全提案に同意、
+                        --no-repomix で repomix 連携を省く)
 
 Options:
   -h, --help            ヘルプを表示
@@ -64,6 +67,10 @@ export async function main(argv) {
             const { initCommand } = await import("./commands/init.js");
             return initCommand(rest);
         }
+        case "watch": {
+            const { watchCommand } = await import("./commands/watch.js");
+            return watchCommand(rest);
+        }
         default:
             process.stderr.write(`petari: "${sub}" は未実装です\n`);
             return 1;

package/dist/commands/apply.js

@@ -73,7 +73,7 @@ function printAlreadyApplied(outcomes) {
         }
     }
 }
-export async function applyCommand(argv) {
+export async function applyCommand(argv, detected) {
     const { values, positionals } = parseArgs({
         args: argv,
         options: {
@@ -119,7 +119,17 @@ export async function applyCommand(argv) {
     let changesText;
     let source;
     const inputPath = positionals[0];
-    if (inputPath !== undefined) {
+    if (detected !== undefined) {
+        try {
+            changesText = stripBom(readFileSync(detected.path, "utf8"));
+        }
+        catch {
+            err(`petari: ファイルを読めません: ${detected.path}`);
+            return 1;
+        }
+        source = { type: detected.origin, path: detected.path };
+    }
+    else if (inputPath !== undefined) {
         const abs = resolve(process.cwd(), inputPath);
         try {
             changesText = stripBom(readFileSync(abs, "utf8"));

package/dist/commands/init.js

@@ -1,6 +1,8 @@
 /**
  * petari init — プロジェクト初回セットアップの一括実行 (§4.6)。
  * 対話形式 (--yes で全提案に自動同意)。既存ファイルは上書きせず確認する。
+ * --no-repomix は repomix 連携 (手順 3) を丸ごと省く。slnmix の `slnmix init` が
+ * `--yes --no-repomix` で呼ぶ (slnmix 利用者に repomix.config.json は要らないため)。
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
@@ -24,6 +26,7 @@ export async function initCommand(argv) {
         options: {
             root: { type: "string" },
             yes: { type: "boolean", short: "y", default: false },
+            "no-repomix": { type: "boolean", default: false },
         },
     });
     const root = findProjectRoot(process.cwd(), values.root);
@@ -57,7 +60,10 @@ export async function initCommand(argv) {
     }
     // 3. repomix 連携 (§4.6-3)
     const repomixPath = join(root, "repomix.config.json");
-    if (existsSync(repomixPath)) {
+    if (values["no-repomix"]) {
+        out("3. repomix 連携は省略します (--no-repomix)");
+    }
+    else if (existsSync(repomixPath)) {
         let parsed;
         try {
             parsed = JSON.parse(readFileSync(repomixPath, "utf8"));
@@ -114,6 +120,10 @@ export async function initCommand(argv) {
         out("   作成しました: .gitignore");
     }
     out("");
+    if (values["no-repomix"]) {
+        out("セットアップ完了。");
+        return 0;
+    }
     out("セットアップ完了。repomix 実行で規約文入りのコンテキストが生成されます。");
     out("slnmix (v0.7.0+) は同じディレクトリの protocol.md を出力末尾に自動連結します。");
     return 0;

package/dist/commands/watch.js

@@ -0,0 +1,105 @@
+/**
+ * petari watch — Downloads とプロジェクト直下を監視し、届いた changes*.md を自動で適用する (§4.7)。
+ * 新着 1 件ごとに applyCommand へ確認なしで渡す。検証・失敗レポートの自動コピー・
+ * 二重適用の防止・成功後の履歴への移動は `petari` (引数なし) と同じ。Ctrl+C で終了する。
+ */
+import { readFileSync } from "node:fs";
+import { setTimeout as delay } from "node:timers/promises";
+import { parseArgs } from "node:util";
+import { hasChangesHeading } from "../core/parser.js";
+import { initialWatchState, observeWatch } from "../core/watch.js";
+import { loadConfig } from "../infra/config.js";
+import { listChangesFiles, resolveDownloadsDir } from "../infra/downloads.js";
+import { findProjectRoot } from "../infra/root.js";
+import { err, out } from "../infra/term.js";
+import { applyCommand } from "./apply.js";
+const DEFAULT_INTERVAL_MS = 1000;
+export async function watchCommand(argv, options = {}) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            root: { type: "string" },
+            "dry-run": { type: "boolean", default: false },
+            "no-vbproj": { type: "boolean", default: false },
+        },
+        allowPositionals: false,
+    });
+    const root = findProjectRoot(process.cwd(), values.root);
+    const config = loadConfig(root);
+    const downloadsDir = await resolveDownloadsDir(config.downloadsDir);
+    const list = () => {
+        const seen = new Set();
+        return [
+            ...listChangesFiles(downloadsDir).map((f) => ({ ...f, origin: "downloads" })),
+            ...listChangesFiles(root).map((f) => ({ ...f, origin: "project-root" })),
+        ].filter((f) => !seen.has(f.path) && (seen.add(f.path), true));
+    };
+    const stop = new AbortController();
+    const onSigint = () => stop.abort();
+    process.once("SIGINT", onSigint);
+    const onAbort = () => stop.abort();
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    if (options.signal?.aborted === true)
+        stop.abort();
+    const applyArgs = ["--root", root, "--yes"];
+    if (values["dry-run"])
+        applyArgs.push("--dry-run");
+    if (values["no-vbproj"])
+        applyArgs.push("--no-vbproj");
+    try {
+        // 開始時に既にあるファイルは対象外 (古い changes.md を黙って当てない)
+        const state = initialWatchState(list());
+        out("changes*.md の到着を待っています。届いたら確認なしで適用します (Ctrl+C で終了)");
+        out(`  Downloads:        ${downloadsDir}`);
+        out(`  プロジェクト直下: ${root}`);
+        if (values["dry-run"])
+            out("  --dry-run: 検証と差分プレビューだけで、書き込みはしません");
+        if (state.settled.size > 0) {
+            out(`  (既にある ${state.settled.size} 件は対象外です。それを当てるときは petari を実行してください)`);
+        }
+        const interval = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+        while (!stop.signal.aborted) {
+            try {
+                await delay(interval, undefined, { signal: stop.signal });
+            }
+            catch {
+                break; // 中断
+            }
+            for (const f of observeWatch(state, list())) {
+                if (stop.signal.aborted)
+                    break;
+                out("");
+                out(`━━ 新しい changes.md: ${f.path}`);
+                let text;
+                try {
+                    text = readFileSync(f.path, "utf8");
+                }
+                catch {
+                    err(`petari: ファイルを読めません: ${f.path}`);
+                    continue;
+                }
+                // 変更履歴の CHANGES.md 等を当てに行かない (失敗レポートでクリップボードを上書きしないため)
+                if (!hasChangesHeading(text.replace(/^/, ""))) {
+                    out("  ## CHANGES の見出しがないため、changes.md ではないと判断して適用しません");
+                    out("  (AI の返答なら `petari <パス>` で実行すると失敗の理由を確認できます)");
+                    continue;
+                }
+                try {
+                    await applyCommand(applyArgs, { path: f.path, origin: f.origin });
+                }
+                catch (e) {
+                    // 1 件の失敗で監視ごと止めない
+                    err(`petari: ${e instanceof Error ? e.message : String(e)}`);
+                }
+                out("");
+                out("引き続き待っています (Ctrl+C で終了)");
+            }
+        }
+    }
+    finally {
+        process.removeListener("SIGINT", onSigint);
+        options.signal?.removeEventListener("abort", onAbort);
+    }
+    out("監視を終了しました。");
+    return 0;
+}

package/dist/core/parser.js

@@ -28,6 +28,18 @@ 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 見出し (寛容パースが受け付けるレベル違いを含む) があるか。
+ * petari watch が changes.md 以外の CHANGES.md 等 (変更履歴) を当てに行かないための判定
+ */
+export function hasChangesHeading(text) {
+    return text
+        .split(/\r?\n/)
+        .some((raw) => {
+        const line = raw.trimEnd();
+        return line === CHANGES_HEADING || LENIENT_CHANGES_RE.test(line);
+    });
+}
 /**
  * changes.md をパースする (§3)。
  *

package/dist/core/watch.js

@@ -0,0 +1,42 @@
+/**
+ * petari watch の新着検出 (純粋ロジック。§4.7)。
+ * 監視先の changes*.md の一覧 (パス・更新時刻・サイズ) を毎回受け取り、
+ * 「監視開始後に現れた / 更新された、書き込みが落ち着いたファイル」を返す。
+ *
+ * - 開始時に既にあるファイルは対象外 (古い changes.md を黙って当てない)
+ * - 書き込み途中を読まないよう、同じ時刻・サイズを 2 回続けて観測してから渡す
+ * - 0 バイトは渡さない (Firefox は最終名の空ファイルを先に作り、完了時に置き換える)
+ * - 一度渡したファイルは、内容が変わる (時刻かサイズが変わる) まで再び渡さない
+ *   (失敗した changes.md を毎回当て直してレポートでクリップボードを上書きしないため)
+ */
+const stamp = (f) => `${f.mtimeMs}:${f.size}`;
+export function initialWatchState(files) {
+    return { settled: new Map(files.map((f) => [f.path, stamp(f)])), pending: new Map() };
+}
+/**
+ * 1 回分の観測を反映し、今回渡すファイルを古い順に返す。state は書き換える。
+ * 一覧から消えたファイルは忘れる (同じ名前で再ダウンロードされたら新着として扱う)
+ */
+export function observeWatch(state, files) {
+    const present = new Set(files.map((f) => f.path));
+    for (const path of [...state.settled.keys()])
+        if (!present.has(path))
+            state.settled.delete(path);
+    for (const path of [...state.pending.keys()])
+        if (!present.has(path))
+            state.pending.delete(path);
+    const ready = [];
+    for (const f of files) {
+        const s = stamp(f);
+        if (state.settled.get(f.path) === s)
+            continue;
+        if (f.size > 0 && state.pending.get(f.path) === s) {
+            state.pending.delete(f.path);
+            state.settled.set(f.path, s);
+            ready.push(f);
+            continue;
+        }
+        state.pending.set(f.path, s);
+    }
+    return ready.sort((a, b) => a.mtimeMs - b.mtimeMs || a.path.localeCompare(b.path));
+}

package/dist/infra/downloads.js

@@ -50,6 +50,8 @@ export async function resolveDownloadsDir(configured) {
     }
     return join(homedir(), "Downloads");
 }
+/** 自動検出・監視の対象になるファイル名 (§4.1)。ブラウザが付ける "changes (1).md" 等も含む */
+const CHANGES_FILE_NAME = /^changes.*\.md$/i;
 /**
  * changes*.md のうち更新が maxAgeMinutes 以内のものを新しい順に返す (§4.1)。
  * 古いファイルの誤適用を防ぐため、既定 30 分より古いものは対象外。
@@ -64,7 +66,7 @@ export function findRecentChangesFiles(dir, now, maxAgeMinutes = 30) {
     }
     const found = [];
     for (const name of names) {
-        if (!/^changes.*\.md$/i.test(name))
+        if (!CHANGES_FILE_NAME.test(name))
             continue;
         const path = join(dir, name);
         try {
@@ -81,3 +83,28 @@ export function findRecentChangesFiles(dir, now, maxAgeMinutes = 30) {
     }
     return found.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
 }
+/** petari watch 用: changes*.md を時刻・サイズ付きで列挙する (時刻での絞り込みはしない・§4.7) */
+export function listChangesFiles(dir) {
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const name of names) {
+        if (!CHANGES_FILE_NAME.test(name))
+            continue;
+        const path = join(dir, name);
+        try {
+            const st = statSync(path);
+            if (st.isFile())
+                found.push({ path, mtimeMs: st.mtimeMs, size: st.size });
+        }
+        catch {
+            // ダウンロード直後の一時的なロック等で読めないファイルは次回に回す
+        }
+    }
+    return found;
+}

package/package.json

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