ask-later 0.1.0

package/lib/hook.mjs

@@ -0,0 +1,220 @@
+// フック本体。Claude Code から stdin に JSON を受け取り、stdout に JSON を返す。
+//
+//   SessionStart      集計（期限切れの取り下げ・番兵）→ 未処理件数と INBOX 未読を additionalContext に注入
+//   UserPromptSubmit  未読があれば毎回注入
+//   PostToolUse       未読の集合が前回の注入から変わったときだけ注入（同じ内容は繰り返さない。署名で管理。
+//                     署名はセッション（session_id）とサブエージェント（agent_id）ごとに持つ——サブエージェントの
+//                     ツール呼び出しが先に消費して本体に届かない、を防ぐ）
+//   Stop              未読があれば decision:block で停止を差し止め。同じ未読の集合・同じセッションにつき
+//                     config.stopBlockMax 回（既定 2・上限 7）まで。回数はセッションごとに持つ（state.stopBlocksBySession。
+//                     別のセッションの Stop が割り込んでも数え直さない）。人が次の入力をしたら（UserPromptSubmit）
+//                     そのセッションの回数は 0 に戻る——本体の「連続 8 回」も人の入力で切れるので、人の 1 入力につき最大 N 回。
+//                     Claude Code 本体は連続 8 回で打ち切るので、stop_hook_active を見なくても無限ループにはならない。集計・通知
+//   SessionEnd        番兵を更新する（出力は Claude Code に読まれない。通知は出さない——SessionEnd の予算は既定 1.5 秒で、
+//                     プラグイン形では timeout で延ばせない。通知は Stop が同じ条件で出している）
+//
+// 【原則】このモジュールは何があっても exit 0 で終わる。stdin が JSON でない・ファイルが無い・壊れている・
+//         書き込めない——どれでも本体の作業を止めない。読める 1 行を hook.log に残すだけ。
+import { appendFileSync, statSync, mkdirSync, renameSync } from "node:fs";
+import { dirname } from "node:path";
+import { readStream, formatLocal } from "./text.mjs";
+import { loadConfig, loadState, saveState, logPath, DEFAULTS } from "./config.mjs";
+import { summarize } from "./queue.mjs";
+import { msg } from "./messages.mjs";
+
+export const EVENTS = ["SessionStart", "UserPromptSubmit", "PostToolUse", "Stop", "SessionEnd"];
+export const MAX_LISTED = 30; // additionalContext は 10,000 字で切られる（公式）。一覧は 30 件で「ほか N 件」
+const SIGNATURE_KEYS = 20; // 署名を覚えておくセッション数（古い順に落とす）
+
+// 署名の鍵。session_id と（サブエージェントの中なら）agent_id。無ければ "-"
+export function signatureKey(input) {
+  const sid = typeof input?.session_id === "string" && input.session_id ? input.session_id : "-";
+  const aid = typeof input?.agent_id === "string" && input.agent_id ? input.agent_id : "main";
+  return `${sid}/${aid}`;
+}
+
+function lastSignature(state, key) {
+  const by = state?.inboxSignatureBySession;
+  const v = by && typeof by === "object" ? by[key] : null;
+  return v && typeof v.sig === "string" ? v.sig : "";
+}
+
+// そのセッション（鍵）の差し止め回数。署名（未読の集合）が違えば 0
+function stopCount(state, key, sig) {
+  const by = state?.stopBlocksBySession;
+  const v = by && typeof by === "object" ? by[key] : null;
+  return v && v.signature === sig && Number.isInteger(v.count) ? v.count : 0;
+}
+
+// 鍵ごとの記録を上限件数に保つ（古い順に落とす）。by を書き換えて返す
+function keepRecent(by, key, value) {
+  delete by[key];
+  by[key] = value;
+  for (const k of Object.keys(by).slice(0, Math.max(0, Object.keys(by).length - SIGNATURE_KEYS))) delete by[k];
+  return by;
+}
+
+function formatInbox(lines, m, config, garbled = 0) {
+  const shown = lines.slice(0, MAX_LISTED);
+  const parts = [m.ctxInboxHead(lines.length, config.inbox), ...shown.map((t) => `  > ${t}`)];
+  if (lines.length > shown.length) parts.push(m.ctxOpenMore(lines.length - shown.length));
+  parts.push(...m.ctxInboxTail(config.pending));
+  if (garbled > 0) parts.push(m.ctxGarbled(config.inbox));
+  return parts.join("\n");
+}
+
+// 純関数: イベント・入力・集計結果・状態から、出力と「保存すべき署名」「差し止め回数」「回数の数え直し」を決める
+export function decide(event, input, snap, state, config) {
+  const m = msg(config.lang);
+  const unread = snap.inboxLines ?? [];
+  const sig = snap.signature ?? "";
+  const key = signatureKey(input);
+  const last = lastSignature(state, key);
+  const garbled = snap.inboxGarbled ?? 0;
+  let output = null;
+  let saveSignature = null;
+  let stopBlocks = null;
+  let resetStopBlocks = false;
+
+  switch (event) {
+    case "SessionStart": {
+      const ctx = [];
+      if (snap.openCount > 0) {
+        ctx.push(m.ctxOpen(snap.openCount, config.pending));
+        const shown = snap.openItems.slice(0, MAX_LISTED);
+        for (const it of shown) ctx.push(`  - ${it.id} ${it.title}`);
+        if (snap.openItems.length > shown.length) ctx.push(m.ctxOpenMore(snap.openItems.length - shown.length));
+        ctx.push(m.ctxOpenTail);
+      }
+      if (snap.withdrawn?.length) ctx.push(m.ctxWithdrawn(snap.withdrawn));
+      if (unread.length) ctx.push(formatInbox(unread, m, config, garbled));
+      if (snap.malformed?.length) ctx.push(m.ctxMalformed(snap.malformed, config.pending));
+      if (!snap.pendingExists) ctx.push(m.ctxNoPending(config.pending));
+      if (ctx.length) output = { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: ctx.join("\n") } };
+      saveSignature = sig;
+      break;
+    }
+    case "UserPromptSubmit": {
+      // 人の入力で、このセッションの差し止め回数は数え直す（本体の「連続 8 回」も人の入力で切れる）
+      resetStopBlocks = Boolean(state?.stopBlocksBySession?.[key]);
+      if (unread.length) {
+        output = { hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: formatInbox(unread, m, config, garbled) } };
+        saveSignature = sig;
+      }
+      break;
+    }
+    case "PostToolUse": {
+      if (unread.length && sig !== last) {
+        output = { hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: formatInbox(unread, m, config, garbled) } };
+        saveSignature = sig;
+      }
+      break;
+    }
+    case "Stop": {
+      if (!unread.length) break;
+      const max = Number.isInteger(config.stopBlockMax) ? config.stopBlockMax : DEFAULTS.stopBlockMax;
+      const count = stopCount(state, key, sig);
+      if (count < max) {
+        const k = count + 1;
+        const head = `${m.stopReason(unread.length, config.inbox)}${k > 1 ? m.stopReasonAgain(k, max) : ""}`;
+        output = { decision: "block", reason: `${head}\n${formatInbox(unread, m, config, garbled)}` };
+        stopBlocks = { key, signature: sig, count: k };
+        saveSignature = sig;
+      }
+      break;
+    }
+    default:
+      break;
+  }
+  return { output, saveSignature, stopBlocks, resetStopBlocks };
+}
+
+function appendLog(root, line) {
+  try {
+    const p = logPath(root);
+    mkdirSync(dirname(p), { recursive: true });
+    try {
+      if (statSync(p).size > 1_000_000) renameSync(p, `${p}.1`); // 1 MB で世代を 1 つ回す
+    } catch {
+      /* 無い */
+    }
+    appendFileSync(p, line + "\n", "utf8");
+  } catch {
+    /* ログすら書けなくても止めない */
+  }
+}
+
+// I/O を含む本体。返り値 { exitCode: 0, output: string|null }。呼び出し側が output を stdout に書く
+//   version  hook.log に残す版（init の写しなら VERSION ファイル、プラグイン形なら package.json）。無ければ書かない
+export async function main(event, { root, stdin = process.stdin, stdinText = null, now = new Date(), version = null } = {}) {
+  const res = { exitCode: 0, output: null };
+  const stamp = () => formatLocal(now, { seconds: true });
+  const ver = version ? ` v${version}` : "";
+  let m = msg(DEFAULTS.lang);
+  try {
+    if (!root) root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+    const raw = stdinText != null ? String(stdinText) : await readStream(stdin);
+    let input = {};
+    if (raw && raw.trim().startsWith("{")) {
+      try {
+        input = JSON.parse(raw);
+      } catch {
+        input = {};
+      }
+    }
+    const config = loadConfig(root);
+    m = msg(config.lang);
+    if (!EVENTS.includes(event)) {
+      appendLog(root, `${stamp()}  ${String(event).padEnd(16)} ${m.logUnknown}${ver}`);
+      return res;
+    }
+    const heavy = event === "SessionStart" || event === "Stop" || event === "SessionEnd";
+    const snap = await summarize(root, config, { now, expire: heavy, notify: event === "Stop", write: heavy });
+    const state = loadState(root);
+    const { output, saveSignature, stopBlocks, resetStopBlocks } = decide(event, input, snap, state, config);
+    if (saveSignature != null || stopBlocks || resetStopBlocks) {
+      const key = signatureKey(input);
+      if (saveSignature != null) {
+        const by = state.inboxSignatureBySession && typeof state.inboxSignatureBySession === "object" ? state.inboxSignatureBySession : {};
+        state.inboxSignatureBySession = keepRecent(by, key, { sig: saveSignature, at: now.toISOString(), event });
+        delete state.inboxSignature; // 旧形式（プロジェクト単位）は使わない
+        delete state.inboxSignatureAt;
+        delete state.inboxSignatureEvent;
+      }
+      const blocks = state.stopBlocksBySession && typeof state.stopBlocksBySession === "object" ? state.stopBlocksBySession : {};
+      if (stopBlocks) state.stopBlocksBySession = keepRecent(blocks, key, { signature: stopBlocks.signature, count: stopBlocks.count, at: now.toISOString() });
+      if (resetStopBlocks) {
+        delete blocks[key];
+        state.stopBlocksBySession = blocks;
+      }
+      delete state.stopBlocks; // 旧形式（プロジェクトで 1 組）は使わない（設計監査 2 巡目 #2）
+      try {
+        saveState(root, state);
+      } catch {
+        /* 次回は同じ内容をもう一度注入するだけ */
+      }
+    }
+    if (output) res.output = JSON.stringify(output) + "\n";
+    // ログの鍵は [session_id の先頭 8 字] か、サブエージェントの中なら [sid/agent_id の先頭 8 字]（本体と区別できるように）
+    const sid = typeof input.session_id === "string" ? input.session_id.slice(0, 8) : "--------";
+    const aid = typeof input.agent_id === "string" && input.agent_id ? `/${input.agent_id.slice(0, 8)}` : "";
+    const what = output
+      ? output.decision === "block"
+        ? m.logBlock(snap.inboxUnread, stopBlocks?.count ?? 1, config.stopBlockMax)
+        : m.logInject(snap.openCount, snap.inboxUnread)
+      : m.logNone(snap.openCount, snap.inboxUnread);
+    const errs = [
+      snap.pendingError && `${config.pending}: ${snap.pendingError}`,
+      snap.inboxError && `${config.inbox}: ${snap.inboxError}`,
+      ...(snap.writeErrors ?? []),
+      snap.sentinelError && `sentinel: ${snap.sentinelError}`,
+      snap.inboxGarbled > 0 && m.logGarbled(snap.inboxGarbled),
+      config.error,
+    ].filter(Boolean);
+    const tail = [snap.withdrawn?.length ? m.logWithdrawn(snap.withdrawn) : "", snap.notified ? m.logNotified : ""].filter(Boolean).map((s) => ` ${s}`).join("");
+    appendLog(root, `${stamp()}  ${event.padEnd(16)} [${sid}${aid}] ${what}${tail}${errs.length ? `  ! ${errs.join(" / ")}` : ""}${ver}`);
+  } catch (e) {
+    appendLog(root ?? process.cwd(), `${stamp()}  ${String(event).padEnd(16)} ${m.logFail(e?.message ?? e)}${ver}`);
+  }
+  return res;
+}

package/lib/inbox.mjs

@@ -0,0 +1,46 @@
+// INBOX.md の未読行。
+//   区切り線 "---" より後ろの、空行・見出し・引用・既読マーク・水平線でない行を「記載」とみなす。
+//   加えて、最初の見出しより前に書かれた行も「記載」とみなす（ファイルの先頭に書いてしまう実例があった。
+//   テンプレートの位置に縛らない）。見出しと区切り線の間はテンプレート（書き方の例）で、読まない。
+//   行頭が ✔（✓ ✅ も可）のものはエージェントが処理済みにしたもの。
+//   見出しは Markdown と同じく「# の後に空白」があるときだけ（"#1 done" のような行は記載として読む）。
+import { splitLines, sha256 } from "./text.mjs";
+
+export const DONE_MARKS = ["✔", "✓", "✅"];
+const HR = /^(-{3,}|\*{3,}|_{3,})\s*$/;
+const HEADING = /^#+(\s|$)/;
+
+export function isDone(trimmedLine) {
+  return DONE_MARKS.some((m) => trimmedLine.startsWith(m));
+}
+
+export function unreadLines(text) {
+  if (text == null) return [];
+  const out = [];
+  let afterSep = false;
+  let seenHeading = false;
+  for (const raw of splitLines(text)) {
+    const t = raw.trim();
+    if (!afterSep) {
+      if (HR.test(t)) {
+        afterSep = true;
+        continue;
+      }
+      if (HEADING.test(t)) {
+        seenHeading = true;
+        continue;
+      }
+      if (seenHeading) continue;
+    }
+    if (t === "") continue;
+    if (HEADING.test(t) || t.startsWith(">") || HR.test(t)) continue;
+    if (isDone(t)) out.push({ done: true, text: t });
+    else out.push({ done: false, text: t });
+  }
+  return out.filter((l) => !l.done).map((l) => l.text);
+}
+
+// 未読集合の署名（同じ集合には繰り返し注入しない）。空なら ""
+export function signatureOf(lines) {
+  return lines.length ? sha256(lines.join("\n")) : "";
+}

package/lib/install.mjs

@@ -0,0 +1,282 @@
+// init / uninit。.claude/settings.json の hooks にマージし（既存を壊さない）、uninit で元に戻す。
+//
+// フックのエントリは既定で exec 形（args 形式）:
+//   { "type": "command", "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs", "<Event>"] }
+// 公式仕様は「パスのプレースホルダを参照するフックは exec 形にせよ」で、${CLAUDE_PROJECT_DIR} は args の各要素の中でも
+// 置換される。シェルを通さないので、Git Bash の無い Windows（PowerShell がシェルになる）や旧版でも引用に依存しない。
+// --shell で旧来の shell 形 `node "${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs" <Event>` も書ける。
+// 本体はプロジェクトの .claude/ask-later/ に写すので、npx のキャッシュや node_modules が消えても動き、
+// settings.json をそのままリポジトリに入れて共有できる。
+// 自分のエントリは command / args に "ask-later/hook.mjs" を含むことで識別する（settings に余計なキーを足さない）。
+import { existsSync, mkdirSync, copyFileSync, rmSync, readFileSync, writeFileSync } from "node:fs";
+import { join, dirname, basename } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readText, writeTextAtomic, isDirectory, detectJsonFormat, formatJson, detectEol } from "./text.mjs";
+import { STATE_DIR, DEFAULTS, configPath } from "./config.mjs";
+import { removeSentinels } from "./sentinel.mjs";
+import { LANGS } from "./messages.mjs";
+
+const here = dirname(fileURLToPath(import.meta.url));
+export const TEMPLATE_DIR = join(here, "..", "templates");
+export const HOOK_DIR = join(".claude", "ask-later");
+export const HOOK_MARK = "ask-later/hook.mjs";
+export const HOOK_PATH_PLACEHOLDER = "${CLAUDE_PROJECT_DIR}/.claude/ask-later/hook.mjs";
+// タイムアウト（秒）。公式の既定は command フックが 600 秒・UserPromptSubmit が 30 秒で、集計には十分だが、
+// SessionEnd だけは既定 1.5 秒の共有予算（settings.json の per-hook timeout で最大 60 秒まで延びる。プラグイン形では延びない）。
+// 既定に依存しないよう全部に明示する。
+export const HOOK_EVENTS = [
+  ["SessionStart", 20],
+  ["UserPromptSubmit", 15],
+  ["PostToolUse", 15],
+  ["Stop", 20],
+  ["SessionEnd", 20],
+];
+// フックに要るファイルだけ写す（cli / install は要らない）
+export const HOOK_LIB_FILES = ["text.mjs", "messages.mjs", "config.mjs", "pending.mjs", "inbox.mjs", "sentinel.mjs", "notify.mjs", "queue.mjs", "hook.mjs"];
+export const GITIGNORE_LINES = [".ask-later/", "\\!pending_*.txt"];
+export const CLAUDE_MD_MARK = { ja: "## 非同期キュー（ask-later）", en: "## Async queue (ask-later)" };
+
+export class UserError extends Error {}
+
+export function packageVersion() {
+  try {
+    return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8")).version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// 写しの版（.claude/ask-later/VERSION）。無ければ null（VERSION を書く前の写し）
+export function hookCopyVersion(root) {
+  try {
+    return readFileSync(join(root, HOOK_DIR, "VERSION"), "utf8").trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+export function hookEntry(event, timeout, { form = "exec" } = {}) {
+  if (form === "shell") {
+    return { type: "command", command: `node "${HOOK_PATH_PLACEHOLDER}" ${event}`, timeout };
+  }
+  return { type: "command", command: "node", args: [HOOK_PATH_PLACEHOLDER, event], timeout };
+}
+
+export function isOurs(def) {
+  if (!def || typeof def !== "object") return false;
+  const norm = (s) => String(s).replace(/\\/g, "/");
+  if (typeof def.command === "string" && norm(def.command).includes(HOOK_MARK)) return true;
+  if (Array.isArray(def.args) && def.args.some((a) => norm(a).includes(HOOK_MARK))) return true;
+  return false;
+}
+
+// 純関数（引数のオブジェクトを書き換えて返す）。自分のエントリを取り除いてから足す（再 init は更新になる）
+export function mergeHooks(settings, opts = {}) {
+  const s = settings && typeof settings === "object" && !Array.isArray(settings) ? settings : {};
+  if (!s.hooks || typeof s.hooks !== "object" || Array.isArray(s.hooks)) s.hooks = {};
+  for (const [event, timeout] of HOOK_EVENTS) {
+    const groups = Array.isArray(s.hooks[event]) ? s.hooks[event] : [];
+    const kept = stripOurs(groups);
+    kept.push({ hooks: [hookEntry(event, timeout, opts)] });
+    s.hooks[event] = kept;
+  }
+  return s;
+}
+
+function stripOurs(groups) {
+  const out = [];
+  for (const g of groups) {
+    if (!g || typeof g !== "object" || !Array.isArray(g.hooks)) {
+      out.push(g);
+      continue;
+    }
+    const rest = g.hooks.filter((h) => !isOurs(h));
+    if (rest.length === g.hooks.length) out.push(g);
+    else if (rest.length) out.push({ ...g, hooks: rest });
+    // 自分のものだけだったグループは落とす
+  }
+  return out;
+}
+
+export function removeHooks(settings) {
+  const s = settings && typeof settings === "object" && !Array.isArray(settings) ? settings : {};
+  if (!s.hooks || typeof s.hooks !== "object") return s;
+  for (const event of Object.keys(s.hooks)) {
+    if (!Array.isArray(s.hooks[event])) continue;
+    const kept = stripOurs(s.hooks[event]);
+    if (kept.length) s.hooks[event] = kept;
+    else delete s.hooks[event];
+  }
+  if (!Object.keys(s.hooks).length) delete s.hooks;
+  return s;
+}
+
+function readSettings(path) {
+  const raw = readText(path);
+  if (raw == null) return { settings: null, raw: null };
+  let settings;
+  try {
+    settings = JSON.parse(raw);
+  } catch (e) {
+    throw new UserError(`${path} が JSON として読めません（${e.message}）。直してから再実行してください。何も書き換えていません`);
+  }
+  if (!settings || typeof settings !== "object" || Array.isArray(settings)) {
+    throw new UserError(`${path} の中身がオブジェクトではありません。何も書き換えていません`);
+  }
+  return { settings, raw };
+}
+
+// 元ファイルの体裁（字下げ幅・改行コード・末尾改行）を写して書く。元が無ければ 2 スペース・LF・末尾改行あり
+function writeSettings(path, settings, raw) {
+  writeTextAtomic(path, formatJson(settings, detectJsonFormat(raw)));
+}
+
+export function templatePath(kind, lang) {
+  return join(TEMPLATE_DIR, `${kind}.${lang}.md`);
+}
+
+export function snippet(lang = "ja") {
+  return readFileSync(templatePath("CLAUDE.snippet", LANGS.includes(lang) ? lang : "ja"), "utf8");
+}
+
+// 本体をプロジェクトに写す。VERSION に写したときのパッケージの版を残す（status が古い写しを言えるように）
+export function copyHookFiles(root) {
+  const dst = join(root, HOOK_DIR);
+  mkdirSync(join(dst, "lib"), { recursive: true });
+  copyFileSync(join(here, "hook-entry.mjs"), join(dst, "hook.mjs"));
+  for (const f of HOOK_LIB_FILES) copyFileSync(join(here, f), join(dst, "lib", f));
+  writeFileSync(join(dst, "VERSION"), `${packageVersion() ?? "?"}\n`, "utf8");
+  return dst;
+}
+
+// CLAUDE.md に規律の断片を足す（見出しが既にあれば触らない）。返り値: "created" | "appended" | "kept"
+export function appendClaudeMd(root, lang) {
+  const p = join(root, "CLAUDE.md");
+  const body = snippet(lang);
+  const cur = readText(p);
+  if (cur == null) {
+    writeTextAtomic(p, body);
+    return "created";
+  }
+  if (Object.values(CLAUDE_MD_MARK).some((mark) => cur.includes(mark))) return "kept";
+  const eol = detectEol(cur);
+  const sep = cur === "" ? "" : cur.endsWith("\n") ? eol : eol + eol;
+  writeTextAtomic(p, cur + sep + body.replace(/\r?\n/g, eol));
+  return "appended";
+}
+
+// .gitignore に 2 行を足す（無い行だけ）。返り値: 足した行
+export function appendGitignore(root) {
+  const p = join(root, ".gitignore");
+  const cur = readText(p) ?? "";
+  const have = new Set(cur.split(/\r?\n/).map((l) => l.trim()));
+  const add = GITIGNORE_LINES.filter((l) => !have.has(l));
+  if (!add.length) return [];
+  const eol = detectEol(cur);
+  const sep = cur === "" ? "" : cur.endsWith("\n") ? "" : eol;
+  writeTextAtomic(p, cur + sep + add.join(eol) + eol);
+  return add;
+}
+
+export async function init(root, { lang = "ja", force = false, local = false, hooks = true, files = true, form = "exec", claudeMd = true, gitignore = true, log = () => {} } = {}) {
+  if (!isDirectory(root)) throw new UserError(`ディレクトリがありません: ${root}`);
+  if (!LANGS.includes(lang)) throw new UserError(`--lang は ${LANGS.join(" | ")} のどれかです: ${lang}`);
+  const r = { created: [], updated: [], skipped: [], settingsPath: null, hookDir: null, claudeMd: null, gitignore: [] };
+
+  if (files) {
+    for (const [kind, name] of [
+      ["PENDING", DEFAULTS.pending],
+      ["INBOX", DEFAULTS.inbox],
+    ]) {
+      const dst = join(root, name);
+      if (existsSync(dst) && !force) {
+        r.skipped.push(name);
+        continue;
+      }
+      const existed = existsSync(dst);
+      writeTextAtomic(dst, readFileSync(templatePath(kind, lang), "utf8"));
+      (existed ? r.updated : r.created).push(name);
+      log(`${name} を書きました`);
+    }
+    const cp = configPath(root);
+    if (!existsSync(cp)) {
+      writeTextAtomic(cp, JSON.stringify({ ...DEFAULTS, lang }, null, 2) + "\n");
+      r.created.push(`${STATE_DIR}/config.json`);
+    } else r.skipped.push(`${STATE_DIR}/config.json`);
+    if (claudeMd) {
+      r.claudeMd = appendClaudeMd(root, lang);
+      if (r.claudeMd === "created") r.created.push("CLAUDE.md");
+      else if (r.claudeMd === "appended") r.updated.push("CLAUDE.md");
+      else r.skipped.push("CLAUDE.md");
+    }
+    if (gitignore) {
+      const existed = existsSync(join(root, ".gitignore"));
+      r.gitignore = appendGitignore(root);
+      if (r.gitignore.length) (existed ? r.updated : r.created).push(".gitignore");
+    }
+  }
+
+  if (hooks) {
+    r.hookDir = copyHookFiles(root);
+    const settingsPath = join(root, ".claude", local ? "settings.local.json" : "settings.json");
+    const { settings, raw } = readSettings(settingsPath);
+    const merged = mergeHooks(settings ?? {}, { form });
+    writeSettings(settingsPath, merged, raw);
+    // init が作った settings ファイルは、uninit で「{} だけの空ファイル」を残さず消す（設計監査 2 巡目 #9）。
+    // 印は写しの中（uninit が消す前に読む。再 init では残る）。init 前からあったファイルには印を付けない
+    if (!settings) writeFileSync(join(r.hookDir, "CREATED_SETTINGS"), `${basename(settingsPath)}\n`, "utf8");
+    r.settingsPath = settingsPath;
+    (settings ? r.updated : r.created).push(settingsPath.slice(root.length + 1).replace(/\\/g, "/"));
+    log(`${settingsPath} に hooks を${settings ? "マージ" : "作成"}しました`);
+  }
+  return r;
+}
+
+export async function uninit(root, { purge = false, log = () => {} } = {}) {
+  if (!isDirectory(root)) throw new UserError(`ディレクトリがありません: ${root}`);
+  const rel = (p) => p.slice(root.length + 1).replace(/\\/g, "/");
+  const r = { settings: [], removed: [] };
+  const createdByInit = (readText(join(root, HOOK_DIR, "CREATED_SETTINGS")) ?? "").trim();
+  for (const name of ["settings.json", "settings.local.json"]) {
+    const p = join(root, ".claude", name);
+    const { settings, raw } = readSettings(p);
+    if (!settings) continue;
+    const before = JSON.stringify(settings);
+    removeHooks(settings);
+    if (JSON.stringify(settings) !== before) {
+      if (createdByInit === name && Object.keys(settings).length === 0) {
+        // init が作り、他に何も書かれていないファイル → 元どおり「無い」に戻す
+        rmSync(p, { force: true });
+        r.removed.push(rel(p));
+        log(`${rel(p)} は init が作ったもので他に中身が無いので消しました / removed (created by init, nothing else in it)`);
+      } else {
+        writeSettings(p, settings, raw);
+        r.settings.push(rel(p));
+        log(`${rel(p)} から hooks を外しました / removed hooks from ${rel(p)}`);
+      }
+    } else if (raw != null) {
+      log(`${rel(p)}: ask-later の hooks はありません / no ask-later hooks`);
+    }
+  }
+  const hookDir = join(root, HOOK_DIR);
+  if (existsSync(hookDir)) {
+    rmSync(hookDir, { recursive: true, force: true });
+    r.removed.push(HOOK_DIR.replace(/\\/g, "/"));
+  }
+  r.removed.push(...removeSentinels(root, DEFAULTS.sentinelPrefix));
+  const stateDir = join(root, STATE_DIR);
+  if (existsSync(stateDir)) {
+    rmSync(stateDir, { recursive: true, force: true });
+    r.removed.push(STATE_DIR);
+  }
+  if (purge) {
+    for (const name of [DEFAULTS.pending, DEFAULTS.inbox]) {
+      const p = join(root, name);
+      if (existsSync(p)) {
+        rmSync(p, { force: true });
+        r.removed.push(name);
+      }
+    }
+  }
+  return r;
+}