@basou/core 0.49.0 → 0.51.0

package/dist/index.js

@@ -23,13 +23,142 @@ function summarizeAdapterOutput(_stream, _raw) {
   throw new Error("adapter_output summary is not implemented in this release");
 }
 
+// src/adapters/codex/hooks-json.ts
+var SESSION_START_HOOK_TIMEOUT_SECONDS = 30;
+var SESSION_START_HOOK_MATCHER = "startup|resume|clear";
+var SESSION_START_HOOK_CONTEXT_LIMIT = 0;
+var SESSION_START_HOOK_STATUS_MESSAGE = "basou orient";
+var BASOU_SESSION_START_HOOK = /(?:\bbasou|(?:@basou|packages)\/cli\/dist\/index\.js['"]?)\s+hook\s+session-start\b/;
+function isBasouSessionStartHookCommand(command) {
+  return BASOU_SESSION_START_HOOK.test(command);
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function buildSessionStartHookCommand(options) {
+  return `node ${shellQuote(options.cliEntry)} hook session-start 2>/dev/null || true`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneHooksFile(hooksFile) {
+  if (hooksFile === void 0 || hooksFile === null) return {};
+  if (!isRecord(hooksFile)) {
+    throw new Error("The Codex hooks.json is not a JSON object.");
+  }
+  return structuredClone(hooksFile);
+}
+function canonicalHandler(command) {
+  return {
+    type: "command",
+    command,
+    timeout: SESSION_START_HOOK_TIMEOUT_SECONDS,
+    statusMessage: SESSION_START_HOOK_STATUS_MESSAGE,
+    additionalContextLimit: SESSION_START_HOOK_CONTEXT_LIMIT
+  };
+}
+function handlerIsCanonical(entry, command) {
+  const want = canonicalHandler(command);
+  return Object.keys(want).every((k) => entry[k] === want[k]);
+}
+function upsertSessionStartHook(hooksFile, command) {
+  const root = cloneHooksFile(hooksFile);
+  if (root.hooks === void 0) {
+    root.hooks = {};
+  } else if (!isRecord(root.hooks)) {
+    throw new Error("The 'hooks' key in the Codex hooks.json is not an object.");
+  }
+  const hooks = root.hooks;
+  if (hooks.SessionStart === void 0) {
+    hooks.SessionStart = [];
+  } else if (!Array.isArray(hooks.SessionStart)) {
+    throw new Error("The 'hooks.SessionStart' key in the Codex hooks.json is not an array.");
+  }
+  const groups = hooks.SessionStart;
+  for (const group of groups) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (!isRecord(entry)) continue;
+      if (typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
+        const unchanged = handlerIsCanonical(entry, command);
+        Object.assign(entry, canonicalHandler(command));
+        return { hooksFile: root, action: unchanged ? "unchanged" : "updated" };
+      }
+    }
+  }
+  groups.push({ matcher: SESSION_START_HOOK_MATCHER, hooks: [canonicalHandler(command)] });
+  return { hooksFile: root, action: "installed" };
+}
+function removeSessionStartHook(hooksFile) {
+  const root = cloneHooksFile(hooksFile);
+  if (!isRecord(root.hooks) || !Array.isArray(root.hooks.SessionStart)) {
+    return { hooksFile: root, action: "absent" };
+  }
+  const hooks = root.hooks;
+  const groups = hooks.SessionStart;
+  let removed = false;
+  const kept = [];
+  for (const group of groups) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) {
+      kept.push(group);
+      continue;
+    }
+    const keptHandlers = group.hooks.filter((entry) => {
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
+        removed = true;
+        return false;
+      }
+      return true;
+    });
+    if (keptHandlers.length === group.hooks.length) {
+      kept.push(group);
+    } else if (keptHandlers.length > 0) {
+      group.hooks = keptHandlers;
+      kept.push(group);
+    }
+  }
+  if (!removed) return { hooksFile: root, action: "absent" };
+  if (kept.length === 0) {
+    delete hooks.SessionStart;
+  } else {
+    hooks.SessionStart = kept;
+  }
+  if (Object.keys(hooks).length === 0) {
+    delete root.hooks;
+  }
+  return { hooksFile: root, action: "removed" };
+}
+function findBasouSessionStartHook(hooksFile) {
+  if (!isRecord(hooksFile) || !isRecord(hooksFile.hooks) || !Array.isArray(hooksFile.hooks.SessionStart)) {
+    return null;
+  }
+  const groups = hooksFile.hooks.SessionStart;
+  for (let g = 0; g < groups.length; g++) {
+    const group = groups[g];
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (let h = 0; h < group.hooks.length; h++) {
+      const entry = group.hooks[h];
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
+        return {
+          command: entry.command,
+          groupIndex: g,
+          handlerIndex: h,
+          matcher: typeof group.matcher === "string" ? group.matcher : void 0,
+          handler: structuredClone(entry)
+        };
+      }
+    }
+  }
+  return null;
+}
+
 // src/adapters/claude-code/settings-hook.ts
 var STOP_HOOK_TIMEOUT_SECONDS = 20;
 var BASOU_STOP_HOOK = /(?:\bbasou|(?:@basou|packages)\/cli\/dist\/index\.js['"]?)\s+hook\s+stop\b/;
 function isBasouStopHookCommand(command) {
   return BASOU_STOP_HOOK.test(command);
 }
-function shellQuote(value) {
+function shellQuote2(value) {
   return `'${value.replace(/'/g, "'\\''")}'`;
 }
 function buildStopHookCommand(options) {
@@ -38,14 +167,14 @@ function buildStopHookCommand(options) {
   if (options.requireReview === true) flags.push("--require-review");
   if (options.minEdits !== void 0) flags.push(`--min-edits ${options.minEdits}`);
   const suffix = flags.length > 0 ? ` ${flags.join(" ")}` : "";
-  return `node ${shellQuote(options.cliEntry)} hook stop${suffix} 2>/dev/null || true`;
+  return `node ${shellQuote2(options.cliEntry)} hook stop${suffix} 2>/dev/null || true`;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function cloneSettings(settings) {
   if (settings === void 0 || settings === null) return {};
-  if (!isRecord(settings)) {
+  if (!isRecord2(settings)) {
     throw new Error("Claude settings is not a JSON object.");
   }
   return structuredClone(settings);
@@ -54,7 +183,7 @@ function upsertStopHook(settings, command) {
   const root = cloneSettings(settings);
   if (root.hooks === void 0) {
     root.hooks = {};
-  } else if (!isRecord(root.hooks)) {
+  } else if (!isRecord2(root.hooks)) {
     throw new Error("The 'hooks' key in Claude settings is not an object.");
   }
   const hooks = root.hooks;
@@ -65,9 +194,9 @@ function upsertStopHook(settings, command) {
   }
   const stop = hooks.Stop;
   for (const group of stop) {
-    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
     for (const entry of group.hooks) {
-      if (!isRecord(entry)) continue;
+      if (!isRecord2(entry)) continue;
       if (typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
         const unchanged = entry.type === "command" && entry.command === command && entry.timeout === STOP_HOOK_TIMEOUT_SECONDS;
         entry.type = "command";
@@ -82,7 +211,7 @@ function upsertStopHook(settings, command) {
 }
 function removeStopHook(settings) {
   const root = cloneSettings(settings);
-  if (!isRecord(root.hooks) || !Array.isArray(root.hooks.Stop)) {
+  if (!isRecord2(root.hooks) || !Array.isArray(root.hooks.Stop)) {
     return { settings: root, action: "absent" };
   }
   const hooks = root.hooks;
@@ -90,12 +219,12 @@ function removeStopHook(settings) {
   let removed = false;
   const newStop = [];
   for (const group of stop) {
-    if (!isRecord(group) || !Array.isArray(group.hooks)) {
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) {
       newStop.push(group);
       continue;
     }
     const keptHooks = group.hooks.filter((entry) => {
-      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+      if (isRecord2(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
         removed = true;
         return false;
       }
@@ -122,19 +251,198 @@ function removeStopHook(settings) {
   return { settings: root, action: "removed" };
 }
 function findBasouStopHookCommand(settings) {
-  if (!isRecord(settings) || !isRecord(settings.hooks) || !Array.isArray(settings.hooks.Stop)) {
+  if (!isRecord2(settings) || !isRecord2(settings.hooks) || !Array.isArray(settings.hooks.Stop)) {
     return null;
   }
   for (const group of settings.hooks.Stop) {
-    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
     for (const entry of group.hooks) {
-      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+      if (isRecord2(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
         return entry.command;
       }
     }
   }
   return null;
 }
+var ENTRY = String.raw`(?:[^\s'"]*/)?(?:@basou|packages)/cli/dist/index\.js`;
+var INVOCATION = String.raw`(?:basou|node[ \t]+(?:'(?:[^']*/)?(?:@basou|packages)/cli/dist/index\.js'|"(?:[^"]*/)?(?:@basou|packages)/cli/dist/index\.js"|${ENTRY}))`;
+var WRAPPER = String.raw`(?:[ \t]+2>[ \t]*/dev/null)?(?:[ \t]*\|\|[ \t]*true)?`;
+var CLAUDE_SESSION_START = new RegExp(
+  String.raw`^[ \t]*${INVOCATION}[ \t]+hook[ \t]+session-start${WRAPPER}[ \t]*$`
+);
+var CLAUDE_ORIENT_SESSION_START = new RegExp(
+  String.raw`^[ \t]*${INVOCATION}[ \t]+orient${WRAPPER}[ \t]*$`
+);
+function isClaudeSessionStartHookCommand(command) {
+  return CLAUDE_SESSION_START.test(command);
+}
+function isBasouOrientSessionStartCommand(command) {
+  return CLAUDE_ORIENT_SESSION_START.test(command);
+}
+function basouSessionStartKind(entry) {
+  if (!isRecord2(entry) || typeof entry.command !== "string") return null;
+  if (isClaudeSessionStartHookCommand(entry.command)) return "session-start";
+  if (isBasouOrientSessionStartCommand(entry.command)) return "orient";
+  return null;
+}
+function matcherKey(group) {
+  const m = group.matcher;
+  return m === void 0 || m === "" || m === "*" ? "*" : String(m);
+}
+function upsertClaudeSessionStartHook(settings, command) {
+  const root = cloneSettings(settings);
+  if (root.hooks === void 0) {
+    root.hooks = {};
+  } else if (!isRecord2(root.hooks)) {
+    throw new Error("The 'hooks' key in Claude settings is not an object.");
+  }
+  const hooks = root.hooks;
+  if (hooks.SessionStart === void 0) {
+    hooks.SessionStart = [];
+  } else if (!Array.isArray(hooks.SessionStart)) {
+    throw new Error("The 'hooks.SessionStart' key in Claude settings is not an array.");
+  }
+  const groups = hooks.SessionStart;
+  let found = false;
+  let changed = false;
+  let replacedOrient = false;
+  const keptUnder = /* @__PURE__ */ new Set();
+  const nextGroups = [];
+  for (const group of groups) {
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) {
+      nextGroups.push(group);
+      continue;
+    }
+    const key = matcherKey(group);
+    const nextHooks = [];
+    let removedHere = false;
+    for (const entry of group.hooks) {
+      const kind = basouSessionStartKind(entry);
+      if (kind === null || !isRecord2(entry)) {
+        nextHooks.push(entry);
+        continue;
+      }
+      found = true;
+      if (kind === "orient") replacedOrient = true;
+      if (keptUnder.has(key)) {
+        changed = true;
+        removedHere = true;
+        continue;
+      }
+      if (entry.type !== "command" || entry.command !== command || entry.timeout !== SESSION_START_HOOK_TIMEOUT_SECONDS) {
+        changed = true;
+      }
+      entry.type = "command";
+      entry.command = command;
+      entry.timeout = SESSION_START_HOOK_TIMEOUT_SECONDS;
+      keptUnder.add(key);
+      nextHooks.push(entry);
+    }
+    if (removedHere && nextHooks.length === 0) continue;
+    group.hooks = nextHooks;
+    nextGroups.push(group);
+  }
+  hooks.SessionStart = nextGroups;
+  if (!found) {
+    nextGroups.push({
+      matcher: SESSION_START_HOOK_MATCHER,
+      hooks: [{ type: "command", command, timeout: SESSION_START_HOOK_TIMEOUT_SECONDS }]
+    });
+    return { settings: root, action: "installed" };
+  }
+  if (replacedOrient) return { settings: root, action: "replaced" };
+  return { settings: root, action: changed ? "updated" : "unchanged" };
+}
+function removeClaudeSessionStartHook(settings) {
+  const root = cloneSettings(settings);
+  if (!isRecord2(root.hooks) || !Array.isArray(root.hooks.SessionStart)) {
+    return { settings: root, action: "absent" };
+  }
+  const hooks = root.hooks;
+  let removed = false;
+  const nextGroups = [];
+  for (const group of hooks.SessionStart) {
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) {
+      nextGroups.push(group);
+      continue;
+    }
+    const keptHooks = group.hooks.filter((entry) => basouSessionStartKind(entry) === null);
+    if (keptHooks.length === group.hooks.length) {
+      nextGroups.push(group);
+    } else {
+      removed = true;
+      if (keptHooks.length > 0) {
+        group.hooks = keptHooks;
+        nextGroups.push(group);
+      }
+    }
+  }
+  if (!removed) return { settings: root, action: "absent" };
+  if (nextGroups.length === 0) {
+    delete hooks.SessionStart;
+  } else {
+    hooks.SessionStart = nextGroups;
+  }
+  if (Object.keys(hooks).length === 0) delete root.hooks;
+  return { settings: root, action: "removed" };
+}
+function findClaudeSessionStartHooks(settings) {
+  const found = [];
+  if (!isRecord2(settings) || !isRecord2(settings.hooks)) return found;
+  const groups = settings.hooks.SessionStart;
+  if (!Array.isArray(groups)) return found;
+  for (const group of groups) {
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      const kind = basouSessionStartKind(entry);
+      if (kind === null || !isRecord2(entry) || typeof entry.command !== "string") continue;
+      found.push({
+        command: entry.command,
+        kind,
+        matcher: typeof group.matcher === "string" ? group.matcher : void 0
+      });
+    }
+  }
+  return found;
+}
+function isClaudeSessionStartMalformed(settings) {
+  return isRecord2(settings) && isRecord2(settings.hooks) && settings.hooks.SessionStart !== void 0 && !Array.isArray(settings.hooks.SessionStart);
+}
+var RUNS_BASOU = new RegExp(
+  String.raw`(?:^|[\s;&|(])(?:basou|node(?:[ \t]+-[^\s]+)*[ \t]+(?:'[^']*(?:@basou|packages)/cli/dist/index\.js'|"[^"]*(?:@basou|packages)/cli/dist/index\.js"|${ENTRY})|npx(?:[ \t]+-y)?[ \t]+@basou/cli)[ \t]+(orient|hook[ \t]+session-start)(?=$|[\s;&|)])`,
+  "g"
+);
+function isInsideQuotes(text, index) {
+  let single = false;
+  let double = false;
+  for (let i = 0; i < index; i++) {
+    const c = text[i];
+    if (c === "'" && !double) single = !single;
+    else if (c === '"' && !single) double = !double;
+  }
+  return single || double;
+}
+function findUnrecognizedSessionStart(settings) {
+  const found = [];
+  if (!isRecord2(settings) || !isRecord2(settings.hooks)) return found;
+  const groups = settings.hooks.SessionStart;
+  if (!Array.isArray(groups)) return found;
+  for (const group of groups) {
+    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (!isRecord2(entry) || typeof entry.command !== "string") continue;
+      if (basouSessionStartKind(entry) !== null) continue;
+      const command = entry.command;
+      for (const m of command.matchAll(RUNS_BASOU)) {
+        const at = (m.index ?? 0) + (m[0].length - m[0].trimStart().length);
+        if (isInsideQuotes(command, at)) continue;
+        found.push({ command, runs: m[1] === "orient" ? "orient" : "session-start" });
+        break;
+      }
+    }
+  }
+  return found;
+}
 
 // src/adapters/claude-code/ask-user-question.ts
 function readString(value) {
@@ -1065,135 +1373,6 @@ async function resolveCodexCommand(lookup = isOnPath) {
   throw new Error("Codex CLI not found in PATH. Install codex first.");
 }
 
-// src/adapters/codex/hooks-json.ts
-var SESSION_START_HOOK_TIMEOUT_SECONDS = 30;
-var SESSION_START_HOOK_MATCHER = "startup|resume|clear";
-var SESSION_START_HOOK_CONTEXT_LIMIT = 0;
-var SESSION_START_HOOK_STATUS_MESSAGE = "basou orient";
-var BASOU_SESSION_START_HOOK = /(?:\bbasou|(?:@basou|packages)\/cli\/dist\/index\.js['"]?)\s+hook\s+session-start\b/;
-function isBasouSessionStartHookCommand(command) {
-  return BASOU_SESSION_START_HOOK.test(command);
-}
-function shellQuote2(value) {
-  return `'${value.replace(/'/g, "'\\''")}'`;
-}
-function buildSessionStartHookCommand(options) {
-  return `node ${shellQuote2(options.cliEntry)} hook session-start 2>/dev/null || true`;
-}
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function cloneHooksFile(hooksFile) {
-  if (hooksFile === void 0 || hooksFile === null) return {};
-  if (!isRecord2(hooksFile)) {
-    throw new Error("The Codex hooks.json is not a JSON object.");
-  }
-  return structuredClone(hooksFile);
-}
-function canonicalHandler(command) {
-  return {
-    type: "command",
-    command,
-    timeout: SESSION_START_HOOK_TIMEOUT_SECONDS,
-    statusMessage: SESSION_START_HOOK_STATUS_MESSAGE,
-    additionalContextLimit: SESSION_START_HOOK_CONTEXT_LIMIT
-  };
-}
-function handlerIsCanonical(entry, command) {
-  const want = canonicalHandler(command);
-  return Object.keys(want).every((k) => entry[k] === want[k]);
-}
-function upsertSessionStartHook(hooksFile, command) {
-  const root = cloneHooksFile(hooksFile);
-  if (root.hooks === void 0) {
-    root.hooks = {};
-  } else if (!isRecord2(root.hooks)) {
-    throw new Error("The 'hooks' key in the Codex hooks.json is not an object.");
-  }
-  const hooks = root.hooks;
-  if (hooks.SessionStart === void 0) {
-    hooks.SessionStart = [];
-  } else if (!Array.isArray(hooks.SessionStart)) {
-    throw new Error("The 'hooks.SessionStart' key in the Codex hooks.json is not an array.");
-  }
-  const groups = hooks.SessionStart;
-  for (const group of groups) {
-    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
-    for (const entry of group.hooks) {
-      if (!isRecord2(entry)) continue;
-      if (typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
-        const unchanged = handlerIsCanonical(entry, command);
-        Object.assign(entry, canonicalHandler(command));
-        return { hooksFile: root, action: unchanged ? "unchanged" : "updated" };
-      }
-    }
-  }
-  groups.push({ matcher: SESSION_START_HOOK_MATCHER, hooks: [canonicalHandler(command)] });
-  return { hooksFile: root, action: "installed" };
-}
-function removeSessionStartHook(hooksFile) {
-  const root = cloneHooksFile(hooksFile);
-  if (!isRecord2(root.hooks) || !Array.isArray(root.hooks.SessionStart)) {
-    return { hooksFile: root, action: "absent" };
-  }
-  const hooks = root.hooks;
-  const groups = hooks.SessionStart;
-  let removed = false;
-  const kept = [];
-  for (const group of groups) {
-    if (!isRecord2(group) || !Array.isArray(group.hooks)) {
-      kept.push(group);
-      continue;
-    }
-    const keptHandlers = group.hooks.filter((entry) => {
-      if (isRecord2(entry) && typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
-        removed = true;
-        return false;
-      }
-      return true;
-    });
-    if (keptHandlers.length === group.hooks.length) {
-      kept.push(group);
-    } else if (keptHandlers.length > 0) {
-      group.hooks = keptHandlers;
-      kept.push(group);
-    }
-  }
-  if (!removed) return { hooksFile: root, action: "absent" };
-  if (kept.length === 0) {
-    delete hooks.SessionStart;
-  } else {
-    hooks.SessionStart = kept;
-  }
-  if (Object.keys(hooks).length === 0) {
-    delete root.hooks;
-  }
-  return { hooksFile: root, action: "removed" };
-}
-function findBasouSessionStartHook(hooksFile) {
-  if (!isRecord2(hooksFile) || !isRecord2(hooksFile.hooks) || !Array.isArray(hooksFile.hooks.SessionStart)) {
-    return null;
-  }
-  const groups = hooksFile.hooks.SessionStart;
-  for (let g = 0; g < groups.length; g++) {
-    const group = groups[g];
-    if (!isRecord2(group) || !Array.isArray(group.hooks)) continue;
-    for (let h = 0; h < group.hooks.length; h++) {
-      const entry = group.hooks[h];
-      if (isRecord2(entry) && typeof entry.command === "string" && isBasouSessionStartHookCommand(entry.command)) {
-        return {
-          command: entry.command,
-          groupIndex: g,
-          handlerIndex: h,
-          matcher: typeof group.matcher === "string" ? group.matcher : void 0,
-          handler: structuredClone(entry)
-        };
-      }
-    }
-  }
-  return null;
-}
-
 // src/schemas/observed-duration.ts
 function readObservedDuration(ev) {
   const stored = ev.duration_ms;
@@ -4356,6 +4535,31 @@ async function countOpenDecisionGaps(input) {
 import { lstat as lstat2 } from "fs/promises";
 import { dirname as dirname2, join as join11, resolve } from "path";
 
+// src/lib/display-path.ts
+function displayPath(path2) {
+  let shown = "";
+  for (const c of path2) {
+    const code = c.codePointAt(0) ?? 0;
+    if (!isActing(code)) {
+      shown += c;
+    } else if (c === "\n") {
+      shown += "\\n";
+    } else if (c === "\r") {
+      shown += "\\r";
+    } else if (c === "	") {
+      shown += "\\t";
+    } else if (code <= 255) {
+      shown += `\\x${code.toString(16).padStart(2, "0")}`;
+    } else {
+      shown += `\\u${code.toString(16).padStart(4, "0")}`;
+    }
+  }
+  return shown;
+}
+function isActing(code) {
+  return code <= 31 || code >= 127 && code <= 159 || code === 8232 || code === 8233 || code >= 8234 && code <= 8238 || code >= 8294 && code <= 8297;
+}
+
 // src/lib/one-line.ts
 function oneLine(text) {
   return text.replace(/\s+/g, " ").trim();
@@ -5139,10 +5343,10 @@ async function formatDecisionsBody(args) {
     if (d.linkedFiles !== void 0 && d.linkedFiles.length > 0) {
       const parts = await Promise.all(
         d.linkedFiles.map(
-          async (path2) => await args.fileExists(path2) ? path2 : `${path2} (missing)`
+          async (path2) => await args.fileExists(path2) ? displayPath(path2) : `${displayPath(path2)} (missing)`
         )
       );
-      lines.push(`- linked_files: ${oneLine(parts.join(", "))}`);
+      lines.push(`- linked_files: ${parts.join(", ")}`);
     }
     lines.push("");
   }
@@ -5621,7 +5825,7 @@ async function getDiff(repoRoot, baseRef, headRef) {
   if (baseRef === headRef) return { changed_files: [] };
   let raw;
   try {
-    raw = await git.raw(["diff", "--name-status", `${baseRef}..${headRef}`]);
+    raw = await git.raw(["diff", "--name-status", "-z", `${baseRef}..${headRef}`]);
   } catch (error) {
     throw translateDiffError(error);
   }
@@ -5639,7 +5843,7 @@ async function getChangesSince(repoRoot, baseRef) {
   }
   let raw;
   try {
-    raw = await git.raw(["-c", "core.quotePath=false", "diff", "--name-status", baseRef]);
+    raw = await git.raw(["diff", "--name-status", "-z", baseRef]);
   } catch (error) {
     throw translateDiffError(error);
   }
@@ -5659,27 +5863,25 @@ function translateDiffError(error) {
   return new Error("Failed to compute git diff", { cause: error });
 }
 function parseDiffNameStatus(raw) {
-  const lines = raw.split("\n").filter((l) => l.trim() !== "");
+  const fields = raw.split("\0");
   const changes = [];
-  for (const line of lines) {
-    const parts = line.split("	");
-    const code = parts[0];
-    if (code === void 0 || code.length === 0) continue;
-    if (code.startsWith("R") && parts.length >= 3) {
-      const newPath = parts[2];
-      const oldPath = parts[1];
-      if (newPath === void 0) continue;
-      changes.push({
-        path: newPath,
-        status: "renamed",
-        ...oldPath !== void 0 ? { old_path: oldPath } : {}
-      });
-    } else if (code === "A" && parts[1]) {
-      changes.push({ path: parts[1], status: "added" });
-    } else if (code === "M" && parts[1]) {
-      changes.push({ path: parts[1], status: "modified" });
-    } else if (code === "D" && parts[1]) {
-      changes.push({ path: parts[1], status: "deleted" });
+  let i = 0;
+  while (i < fields.length) {
+    const code = fields[i] ?? "";
+    const twoPaths = code.startsWith("R") || code.startsWith("C");
+    const first = fields[i + 1];
+    const second = twoPaths ? fields[i + 2] : void 0;
+    i += twoPaths ? 3 : 2;
+    if (first === void 0 || first.length === 0) continue;
+    if (code.startsWith("R")) {
+      if (second === void 0 || second.length === 0) continue;
+      changes.push({ path: second, status: "renamed", old_path: first });
+    } else if (code === "A") {
+      changes.push({ path: first, status: "added" });
+    } else if (code === "M") {
+      changes.push({ path: first, status: "modified" });
+    } else if (code === "D") {
+      changes.push({ path: first, status: "deleted" });
     }
   }
   return changes;
@@ -6091,7 +6293,7 @@ function formatHandoffBody(args) {
   if (args.displayedFiles.length === 0) {
     lines.push("(no related files recorded)");
   } else {
-    for (const f of args.displayedFiles) lines.push(`- ${f}`);
+    for (const f of args.displayedFiles) lines.push(`- ${displayPath(f)}`);
     if (args.overflow > 0) lines.push(`- ... +${args.overflow} more`);
   }
   lines.push("");
@@ -6144,7 +6346,7 @@ function formatHandoffBody(args) {
   lines.push(t.handoff.headingReadNext);
   lines.push("");
   lines.push("- .basou/decisions.md");
-  for (const f of args.displayedFiles.slice(0, 3)) lines.push(`- ${f}`);
+  for (const f of args.displayedFiles.slice(0, 3)) lines.push(`- ${displayPath(f)}`);
   lines.push("");
   lines.push(t.handoff.headingNextWork);
   lines.push("");
@@ -6251,7 +6453,7 @@ function parseBuildStamp(raw) {
   }
 }
 var BASOU_CORE_BUILD = parseBuildStamp(
-  true ? '{"version":"0.49.0","commit":"6c4704a","committedAt":"2026-09-23T11:46:39+09:00"}' : void 0
+  true ? '{"version":"0.51.0","commit":"22ef44f","committedAt":"2026-09-23T22:27:59+09:00"}' : void 0
 );
 
 // src/lib/duration.ts
@@ -6781,7 +6983,7 @@ function formatOrientationBody(summary, opts) {
     const parts = [];
     if (summary.relatedFiles.displayed.length > 0) {
       const more = summary.relatedFiles.overflow > 0 ? ` (... +${summary.relatedFiles.overflow} more)` : "";
-      parts.push(`${summary.relatedFiles.displayed.join(", ")}${more}`);
+      parts.push(`${summary.relatedFiles.displayed.map(displayPath).join(", ")}${more}`);
     }
     if (summary.relatedFiles.omitted > 0) {
       parts.push(t.orientation.scratchOmitted(summary.relatedFiles.omitted));
@@ -6790,7 +6992,7 @@ function formatOrientationBody(summary, opts) {
     if (summary.relatedFiles.outOfRoot.length > 0) {
       const OUT_OF_ROOT_DISPLAY = 10;
       const out = summary.relatedFiles.outOfRoot;
-      const shownOut = out.slice(0, OUT_OF_ROOT_DISPLAY).join(", ");
+      const shownOut = out.slice(0, OUT_OF_ROOT_DISPLAY).map(displayPath).join(", ");
       const outMore = out.length > OUT_OF_ROOT_DISPLAY ? ` (... +${out.length - OUT_OF_ROOT_DISPLAY} more)` : "";
       lines.push(`  - ${t.orientation.outOfRootWarning(out.length, `${shownOut}${outMore}`)}`);
     }
@@ -6818,7 +7020,9 @@ function formatOrientationBody(summary, opts) {
         lines.push(`  - ${t.orientation.recentNextStepLabel}: ${noteSummary(note)}`);
       }
       if (s.files.length > 0) {
-        lines.push(`  - ${t.orientation.recentChangedLabel}: ${s.files.join(", ")}`);
+        lines.push(
+          `  - ${t.orientation.recentChangedLabel}: ${s.files.map(displayPath).join(", ")}`
+        );
       }
     }
   }
@@ -8614,7 +8818,9 @@ function formatReportBody(data, t) {
   if (data.changedFiles.length === 0) {
     lines.push("(no related files recorded)");
   } else {
-    for (const f of data.changedFiles.slice(0, CHANGED_FILES_MARKDOWN_LIMIT)) lines.push(`- ${f}`);
+    for (const f of data.changedFiles.slice(0, CHANGED_FILES_MARKDOWN_LIMIT)) {
+      lines.push(`- ${displayPath(f)}`);
+    }
     const overflow = data.changedFiles.length - CHANGED_FILES_MARKDOWN_LIMIT;
     if (overflow > 0) lines.push(`- ... +${overflow} more`);
   }
@@ -10568,6 +10774,7 @@ export {
   createManifest,
   createTaskWithEvent,
   deleteTask,
+  displayPath,
   editTask,
   ensureBasouDirectory,
   enumerateApprovals,
@@ -10578,10 +10785,12 @@ export {
   finalizeSessionYaml,
   findBasouSessionStartHook,
   findBasouStopHookCommand,
+  findClaudeSessionStartHooks,
   findDecisionGaps,
   findErrorCode,
   findReviewGaps,
   findUnbindableRepos,
+  findUnrecognizedSessionStart,
   formatDurationMs,
   genesisHash,
   getChangesSince,
@@ -10592,8 +10801,11 @@ export {
   importSessionFromJson,
   inspectChainTail,
   instructionMode,
+  isBasouOrientSessionStartCommand,
   isBasouSessionStartHookCommand,
   isBasouStopHookCommand,
+  isClaudeSessionStartHookCommand,
+  isClaudeSessionStartMalformed,
   isGitNotFound,
   isImportDerivedSource,
   isLazyExpired,
@@ -10646,6 +10858,7 @@ export {
   recordSessionBaseline,
   refreshTaskLinkedSessions,
   reimportPreservingId,
+  removeClaudeSessionStartHook,
   removeMarkerSection,
   removeSessionStartHook,
   removeStopHook,
@@ -10693,6 +10906,7 @@ export {
   unknownManifestKeys,
   unstampedProtocolSectionsFrom,
   updateTaskStatusWithEvent,
+  upsertClaudeSessionStartHook,
   upsertSessionStartHook,
   upsertStopHook,
   verifyEventsChain,