petari 0.1.0

package/dist/infra/config.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_CONFIG = {
+    downloadsDir: null,
+    newFile: { encoding: "utf8", eol: "lf" },
+    historyLimit: null,
+    vscodeCommand: "code",
+};
+/** グローバル設定のパス (§10)。Windows は %APPDATA%、他は XDG (~/.config) */
+export function globalConfigPath() {
+    if (process.platform === "win32" && process.env["APPDATA"] !== undefined) {
+        return join(process.env["APPDATA"], "petari", "config.json");
+    }
+    const base = process.env["XDG_CONFIG_HOME"] ?? join(homedir(), ".config");
+    return join(base, "petari", "config.json");
+}
+function readConfigFile(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (e) {
+        throw new Error(`${path} を JSON として読めません: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/** 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")`);
+    }
+    const eol = c.newFile.eol;
+    if (eol !== "lf" && eol !== "crlf") {
+        throw new Error(`config の newFile.eol が不正です: ${String(eol)} ("lf" | "crlf")`);
+    }
+    const limit = c.historyLimit;
+    if (limit !== null && (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1)) {
+        throw new Error(`config の historyLimit が不正です: ${String(limit)} (null または 1 以上の整数)`);
+    }
+    if (typeof c.vscodeCommand !== "string") {
+        throw new Error("config の vscodeCommand が不正です (文字列を指定)");
+    }
+    if (c.downloadsDir !== null && typeof c.downloadsDir !== "string") {
+        throw new Error("config の downloadsDir が不正です (null または文字列を指定)");
+    }
+    return c;
+}
+/** 既定 < グローバル < プロジェクトの順でマージする (プロジェクト優先・§10) */
+export function loadConfig(root) {
+    const global = readConfigFile(globalConfigPath());
+    const project = readConfigFile(join(root, ".petari", "config.json"));
+    return validateConfig({
+        ...DEFAULT_CONFIG,
+        ...global,
+        ...project,
+        newFile: {
+            ...DEFAULT_CONFIG.newFile,
+            ...(global.newFile ?? {}),
+            ...(project.newFile ?? {}),
+        },
+    });
+}

package/dist/infra/downloads.js

@@ -0,0 +1,83 @@
+/**
+ * ダウンロードフォルダの解決と changes*.md の自動検出 (§4.1, §10)。
+ * Windows は Known Folder (レジストリ) から取得し、OneDrive リダイレクトされた
+ * 社用 PC でも正しいフォルダを見つける。
+ */
+import { execFile } from "node:child_process";
+import { readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+const execFileP = promisify(execFile);
+/** Known Folder GUID: Downloads */
+const DOWNLOADS_GUID = "{374DE290-123F-4565-9164-39C4925E467B}";
+const USER_SHELL_FOLDERS_KEY = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders";
+/** %USERPROFILE% 等の Windows 環境変数参照を展開する */
+export function expandWindowsEnv(value) {
+    return value.replace(/%([^%]+)%/g, (whole, name) => {
+        return process.env[name] ?? process.env[name.toUpperCase()] ?? whole;
+    });
+}
+/** `reg query ... /v {GUID}` の出力から値 (REG_EXPAND_SZ / REG_SZ) を取り出す */
+export function parseRegQueryValue(stdout, guid) {
+    for (const line of stdout.split(/\r?\n/)) {
+        if (!line.toUpperCase().includes(guid.toUpperCase()))
+            continue;
+        const m = /REG_(?:EXPAND_)?SZ\s+(.+)$/.exec(line);
+        if (m !== null)
+            return m[1].trim();
+    }
+    return null;
+}
+export async function resolveDownloadsDir(configured) {
+    if (configured !== null && configured !== "")
+        return configured;
+    if (process.platform === "win32") {
+        try {
+            const { stdout } = await execFileP("reg", [
+                "query",
+                USER_SHELL_FOLDERS_KEY,
+                "/v",
+                DOWNLOADS_GUID,
+            ]);
+            const value = parseRegQueryValue(stdout, DOWNLOADS_GUID);
+            if (value !== null)
+                return expandWindowsEnv(value);
+        }
+        catch {
+            // reg が使えない場合は既定にフォールバック
+        }
+    }
+    return join(homedir(), "Downloads");
+}
+/**
+ * changes*.md のうち更新が maxAgeMinutes 以内のものを新しい順に返す (§4.1)。
+ * 古いファイルの誤適用を防ぐため、既定 30 分より古いものは対象外。
+ */
+export function findRecentChangesFiles(dir, now, maxAgeMinutes = 30) {
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const name of names) {
+        if (!/^changes.*\.md$/i.test(name))
+            continue;
+        const path = join(dir, name);
+        try {
+            const st = statSync(path);
+            if (!st.isFile())
+                continue;
+            if (now.getTime() - st.mtimeMs <= maxAgeMinutes * 60_000) {
+                found.push({ path, mtime: st.mtime });
+            }
+        }
+        catch {
+            // 読めないファイルは無視
+        }
+    }
+    return found.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+}

package/dist/infra/files.js

@@ -0,0 +1,59 @@
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, sep } from "node:path";
+/**
+ * absPath の「存在する最も近い祖先ディレクトリ」の実体 (realpath) が
+ * root 配下にあるかを検証する (§9 の defense-in-depth)。
+ * プロジェクト内の symlink ディレクトリを経由したルート外への書き込みを防ぐ。
+ */
+export function isInsideRoot(root, absPath) {
+    let rootReal;
+    try {
+        rootReal = realpathSync(root);
+    }
+    catch {
+        return false;
+    }
+    let dir = dirname(absPath);
+    for (;;) {
+        try {
+            const real = realpathSync(dir);
+            return real === rootReal || real.startsWith(rootReal + sep);
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                return false;
+            dir = parent;
+        }
+    }
+}
+/** 適用対象ファイルの状態を読む (シンボリックリンク検出は lstat・§9) */
+export function readFileState(absPath) {
+    let symlink = false;
+    let exists = false;
+    try {
+        const st = lstatSync(absPath);
+        symlink = st.isSymbolicLink();
+        exists = true;
+    }
+    catch {
+        return { exists: false, symlink: false, bytes: null };
+    }
+    if (symlink)
+        return { exists, symlink, bytes: null };
+    return { exists, symlink, bytes: new Uint8Array(readFileSync(absPath)) };
+}
+export function writeBytes(absPath, bytes) {
+    mkdirSync(dirname(absPath), { recursive: true });
+    writeFileSync(absPath, bytes);
+}
+export function deleteFile(absPath) {
+    unlinkSync(absPath);
+}
+export function fileExists(absPath) {
+    return existsSync(absPath);
+}
+export function sha256(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}

package/dist/infra/git.js

@@ -0,0 +1,16 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileP = promisify(execFile);
+/**
+ * 未コミット変更のあるファイル一覧 (§9)。
+ * Git が使えない / リポジトリでない場合は null (Git は必須ではない)。
+ */
+export async function gitDirtyFiles(root) {
+    try {
+        const { stdout } = await execFileP("git", ["status", "--porcelain"], { cwd: root });
+        return stdout.split("\n").filter((l) => l.trim() !== "");
+    }
+    catch {
+        return null;
+    }
+}

package/dist/infra/history.js

@@ -0,0 +1,72 @@
+/**
+ * 履歴ディレクトリ (.petari/history/) の読み書き (§5)。
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { sha256, writeBytes } from "./files.js";
+export function petariDir(root) {
+    return join(root, ".petari");
+}
+export function historyRoot(root) {
+    return join(petariDir(root), "history");
+}
+/** 履歴 ID: YYYY-MM-DD_HHmm。同分内の衝突は連番サフィックス (§5) */
+export function createHistoryId(root, now) {
+    const pad = (n) => String(n).padStart(2, "0");
+    const base = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}_${pad(now.getHours())}${pad(now.getMinutes())}`;
+    let id = base;
+    for (let n = 2; existsSync(join(historyRoot(root), id)); n++) {
+        id = `${base}-${n}`;
+    }
+    return id;
+}
+/**
+ * 履歴保存は 2 段階 (§4.1 手順 4)。
+ * begin: 書き換え前に changes.md 原本と before/ を保存 (途中クラッシュでも復元材料が残る)
+ * finish: 書き換え後に after/ と manifest.json を保存
+ */
+export function beginHistory(root, id, changesText, before) {
+    const dir = join(historyRoot(root), id);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "changes.md"), changesText, "utf8");
+    for (const [path, bytes] of before) {
+        if (bytes !== null)
+            writeBytes(join(dir, "before", path), bytes);
+    }
+    return dir;
+}
+export function finishHistory(root, id, manifest, after) {
+    const dir = join(historyRoot(root), id);
+    for (const [path, bytes] of after) {
+        if (bytes !== null)
+            writeBytes(join(dir, "after", path), bytes);
+    }
+    writeFileSync(join(dir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n", "utf8");
+}
+export function listHistoryIds(root) {
+    const dir = historyRoot(root);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .sort();
+}
+/** historyLimit を超えた古い履歴を削除する (§10)。null = 無制限 */
+export function pruneHistory(root, limit) {
+    if (limit === null || limit < 1)
+        return [];
+    const ids = listHistoryIds(root);
+    const excess = ids.slice(0, Math.max(0, ids.length - limit));
+    for (const id of excess) {
+        rmSync(join(historyRoot(root), id), { recursive: true, force: true });
+    }
+    return excess;
+}
+export function readManifest(root, id) {
+    const p = join(historyRoot(root), id, "manifest.json");
+    if (!existsSync(p))
+        return null;
+    return JSON.parse(readFileSync(p, "utf8"));
+}
+export { sha256 };

package/dist/infra/prompt.js

@@ -0,0 +1,12 @@
+import { createInterface } from "node:readline/promises";
+/** y/N 確認プロンプト。--yes 時は呼び出し側でスキップする */
+export async function confirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/infra/root.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/**
+ * プロジェクトルートの特定 (§9)。
+ * カレントから上方向に最も近い .git を探索。なければカレント。--root で明示上書き。
+ * ネスト構成 (メニュー単位の Git リポジトリ) では実行場所のリポジトリがルートになる。
+ */
+export function findProjectRoot(cwd, override) {
+    if (override !== undefined)
+        return resolve(cwd, override);
+    let dir = resolve(cwd);
+    for (;;) {
+        if (existsSync(join(dir, ".git")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return resolve(cwd);
+        dir = parent;
+    }
+}

package/dist/infra/term.js

@@ -0,0 +1,14 @@
+/**
+ * 端末出力のサニタイズ (セキュリティレビュー指摘 4)。
+ * changes.md 由来の文字列 (SEARCH 引用・プレビュー・パス表示) には
+ * ANSI エスケープ等を仕込めるため、\n \t 以外の C0/C1 制御文字を除去してから出力する。
+ * クリップボードへコピーするレポート本文は原文のまま (これは端末を通らない)。
+ */
+// C0/C1 制御文字 (\n \t 以外) に加え、表示順序を偽装できる双方向制御文字
+// (Trojan Source 対策: LRM/RLM/ALM・LRE〜PDF・LRI〜PDI) も除去する
+const CONTROL_CHARS = new RegExp("[\\u0000-\\u0008\\u000B-\\u001F\\u007F-\\u009F\\u061C\\u200E\\u200F\\u202A-\\u202E\\u2066-\\u2069]", "g");
+export function sanitizeForTerminal(s) {
+    return s.replace(CONTROL_CHARS, "");
+}
+export const out = (s) => void process.stdout.write(sanitizeForTerminal(s) + "\n");
+export const err = (s) => void process.stderr.write(sanitizeForTerminal(s) + "\n");

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "petari",
+  "version": "0.1.0",
+  "description": "petari — paste AI chat patches onto your codebase",
+  "keywords": [
+    "cli",
+    "ai",
+    "patch",
+    "diff",
+    "apply"
+  ],
+  "license": "MIT",
+  "author": "Yuki Sakakibara",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ishibashi0112/petari.git"
+  },
+  "homepage": "https://github.com/ishibashi0112/petari#readme",
+  "bugs": {
+    "url": "https://github.com/ishibashi0112/petari/issues"
+  },
+  "type": "module",
+  "bin": {
+    "petari": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "node src/cli.ts",
+    "gen:sjis": "node scripts/generate-sjis-table.ts"
+  }
+}