claude-nomad 0.41.0 → 0.43.0

package/dist/nomad.mjs

@@ -449,6 +449,17 @@ function deepMerge(target, source) {
   }
   return out;
 }
+function sortKeysDeep(value) {
+  if (Array.isArray(value)) return value.map(sortKeysDeep);
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const key of Object.keys(value).sort((a, b) => a.localeCompare(b, "en"))) {
+      out[key] = sortKeysDeep(value[key]);
+    }
+    return out;
+  }
+  return value;
+}
 var encodePath;
 var init_utils_json = __esm({
   "src/utils.json.ts"() {
@@ -550,31 +561,31 @@ var init_utils_fs = __esm({
 });
 
 // src/push-gitleaks.config.ts
-import { existsSync as existsSync9, mkdtempSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync10, mkdtempSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 import { fileURLToPath } from "node:url";
 function resolveTomlPath() {
-  const repoToml = join10(REPO_HOME, ".gitleaks.toml");
-  if (existsSync9(repoToml)) return repoToml;
+  const repoToml = join11(REPO_HOME, ".gitleaks.toml");
+  if (existsSync10(repoToml)) return repoToml;
   const bundled = fileURLToPath(new URL("../.gitleaks.toml", import.meta.url));
-  return existsSync9(bundled) ? bundled : null;
+  return existsSync10(bundled) ? bundled : null;
 }
 function buildOverlayTempConfig(overlayBody, bundled) {
   const tempBody = `[extend]
 path = ${JSON.stringify(bundled)}
 
 ${overlayBody}`;
-  const tempPath = mkdtempSync(join10(tmpdir(), "nomad-gitleaks-cfg-"));
-  const configPath = join10(tempPath, "config.toml");
+  const tempPath = mkdtempSync(join11(tmpdir(), "nomad-gitleaks-cfg-"));
+  const configPath = join11(tempPath, "config.toml");
   writeFileSync2(configPath, tempBody, { mode: 384, flag: "wx" });
   return { configPath, tempPath };
 }
 function resolveTomlConfig() {
-  const overlayPath = join10(REPO_HOME, ".gitleaks.overlay.toml");
-  const repoToml = join10(REPO_HOME, ".gitleaks.toml");
+  const overlayPath = join11(REPO_HOME, ".gitleaks.overlay.toml");
+  const repoToml = join11(REPO_HOME, ".gitleaks.toml");
   const bundled = resolveTomlPath();
-  if (!existsSync9(overlayPath)) {
+  if (!existsSync10(overlayPath)) {
     return { path: bundled, tempPath: null };
   }
   if (bundled === repoToml) {
@@ -615,9 +626,9 @@ var init_push_gitleaks_config = __esm({
 
 // src/push-checks.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { readdirSync as readdirSync3, rmSync as rmSync3 } from "node:fs";
+import { readdirSync as readdirSync4, rmSync as rmSync3 } from "node:fs";
 import { homedir as homedir2, platform } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function gitleaksInstallHint() {
   const head = "gitleaks not on PATH (required for nomad push). Install:";
   const plat = platform();
@@ -655,12 +666,12 @@ function findGitlinks(dir) {
   function walk(current) {
     let entries;
     try {
-      entries = readdirSync3(current, { withFileTypes: true });
+      entries = readdirSync4(current, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
-      const p = join11(current, e.name);
+      const p = join12(current, e.name);
       if (e.name === ".git") {
         hits.push(p);
         continue;
@@ -712,7 +723,7 @@ var init_push_checks = __esm({
 import { execFileSync as execFileSync5 } from "node:child_process";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, rmSync as rmSync4 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function readGitleaksReport(reportPath) {
   try {
     const raw = readFileSync4(reportPath, "utf8");
@@ -724,9 +735,9 @@ function readGitleaksReport(reportPath) {
   }
 }
 function scanStagedTree(repoDir, forwardStreams = false) {
-  const cacheDir = join15(homedir3(), ".cache", "claude-nomad");
+  const cacheDir = join16(homedir3(), ".cache", "claude-nomad");
   mkdirSync2(cacheDir, { recursive: true });
-  const reportPath = join15(cacheDir, `gitleaks-${nowTimestamp()}-${process.pid}.json`);
+  const reportPath = join16(cacheDir, `gitleaks-${nowTimestamp()}-${process.pid}.json`);
   const { path: toml, tempPath } = resolveTomlConfig();
   const args = [
     "protect",
@@ -758,9 +769,9 @@ function scanStagedTree(repoDir, forwardStreams = false) {
   }
 }
 function scanFile(filePath, forwardStreams = false) {
-  const cacheDir = join15(homedir3(), ".cache", "claude-nomad");
+  const cacheDir = join16(homedir3(), ".cache", "claude-nomad");
   mkdirSync2(cacheDir, { recursive: true });
-  const reportPath = join15(cacheDir, `gitleaks-file-${nowTimestamp()}-${process.pid}.json`);
+  const reportPath = join16(cacheDir, `gitleaks-file-${nowTimestamp()}-${process.pid}.json`);
   const { path: toml, tempPath } = resolveTomlConfig();
   const args = [
     "detect",
@@ -1209,8 +1220,8 @@ function cmdClean(opts, backupBase = BACKUP_BASE) {
 }
 
 // src/commands.doctor.ts
-import { existsSync as existsSync18 } from "node:fs";
-import { join as join22 } from "node:path";
+import { existsSync as existsSync21 } from "node:fs";
+import { join as join25 } from "node:path";
 
 // src/commands.doctor.checks.repo.ts
 init_color();
@@ -1230,6 +1241,9 @@ function section(header, raw = false) {
 function addItem(s, text) {
   s.items.push(text);
 }
+function addChildItem(s, text) {
+  s.items.push(`	${text}`);
+}
 function sectionFailed(s) {
   return s.items.some((line) => line.includes(failGlyph));
 }
@@ -1246,12 +1260,27 @@ function renderSection(s) {
   }
   const header = sectionFailed(s) ? `${red(FAIL_GLYPH_BARE)} ${s.header}` : s.header;
   console.log(header);
-  const lastContent = s.items.reduce((acc, item, j) => item === "" ? acc : j, -1);
+  const lastContent = s.items.reduce(
+    (acc, item, j) => item === "" || isChild(item) ? acc : j,
+    -1
+  );
   for (let j = 0; j < s.items.length; j++) {
-    if (s.items[j] === "") console.log("");
-    else console.log(`${j === lastContent ? "  \u2514 " : "  \u251C "}${s.items[j]}`);
+    const item = s.items[j];
+    if (item === "") console.log("");
+    else if (isChild(item)) console.log(renderChildLine(s.items, j));
+    else console.log(`${j === lastContent ? "  \u2514 " : "  \u251C "}${item}`);
   }
 }
+function isChild(item) {
+  return item.startsWith("	");
+}
+function renderChildLine(items, j) {
+  const parentContinues = items.some((it, k) => k > j && it !== "" && !isChild(it));
+  const gutter = parentContinues ? "  \u2502 " : "    ";
+  const next = items[j + 1];
+  const elbow = next === void 0 || !isChild(next) ? "\u2514 " : "\u251C ";
+  return `${gutter}  ${elbow}${items[j].slice(1)}`;
+}
 function renderTree(sections) {
   const visible = sections.filter((s) => s.items.length > 0);
   for (let i = 0; i < visible.length; i++) {
@@ -1321,7 +1350,11 @@ function isOverrideActive() {
   return Boolean(process.env.NOMAD_REPO);
 }
 function reportHostAndPaths(section2) {
-  addItem(section2, `${dim(infoGlyph)} host: ${cyan(HOST)}`);
+  const unsetHint = process.env.NOMAD_HOST ? "" : dim(" (env unset, using hostname)");
+  addItem(section2, `${dim(infoGlyph)} NOMAD_HOST: ${cyan(HOST)}${unsetHint}`);
+  if (isOverrideActive()) {
+    addItem(section2, `${dim(infoGlyph)} NOMAD_REPO: ${blue(REPO_HOME)}`);
+  }
   addItem(
     section2,
     `${existsSync6(REPO_HOME) ? green(okGlyph) : yellow(warnGlyph)} repo: ${blue(REPO_HOME)}`
@@ -1427,7 +1460,7 @@ function loadAndReportSettings(section2) {
   if (unknownKeys.length > 0) {
     addItem(
       section2,
-      `${yellow(warnGlyph)} settings.json has unknown keys (schema drift?): ${unknownKeys.join(", ")}`
+      `${yellow(warnGlyph)} settings.json has unknown keys (schema drift?): ${unknownKeys.join(", ")} (verify: nomad doctor --check-schema)`
     );
   } else {
     addItem(section2, `${green(okGlyph)} settings.json schema: known keys only`);
@@ -1467,17 +1500,33 @@ function reportHostOverrides(section2, base, settings) {
 // src/commands.doctor.checks.pathmap.ts
 init_color();
 init_config();
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3 } from "node:fs";
 import { join as join9 } from "node:path";
 init_utils_json();
 function reportMappedProjects(section2, map) {
   const mapped = Object.entries(map.projects).filter(([, hosts]) => hosts[HOST]);
-  addItem(
-    section2,
-    `${dim(infoGlyph)} mapped projects for ${cyan(HOST)}: ${dim(String(mapped.length))}`
-  );
+  addItem(section2, `Mapped projects for ${cyan(HOST)}: ${dim(String(mapped.length))}`);
   for (const [name, hosts] of mapped) {
-    addItem(section2, `      ${name} -> ${blue(hosts[HOST])}`);
+    addChildItem(section2, `${name} -> ${blue(hosts[HOST])}`);
+  }
+}
+function reportUnmappedProjects(section2, map) {
+  const localProjects = join9(CLAUDE_HOME, "projects");
+  if (!existsSync8(localProjects)) return;
+  let localDirs;
+  try {
+    localDirs = readdirSync3(localProjects);
+  } catch {
+    return;
+  }
+  const mappedEncodings = new Set(
+    Object.values(map.projects).map((hosts) => hosts[HOST]).filter(Boolean).map((abspath) => encodePath(abspath))
+  );
+  const unmapped = localDirs.filter((dir) => !mappedEncodings.has(dir));
+  if (unmapped.length === 0) return;
+  addItem(section2, `Unmapped local projects (not synced): ${dim(String(unmapped.length))}`);
+  for (const dir of unmapped) {
+    addChildItem(section2, dim(dir));
   }
 }
 function reportPathCollisions(section2, map) {
@@ -1541,28 +1590,48 @@ function reportPathMap(section2) {
     }
   }
   reportMappedProjects(section2, map);
+  reportUnmappedProjects(section2, map);
   reportPathCollisions(section2, map);
 }
 function reportNeverSync(section2) {
-  addItem(section2, `${dim(infoGlyph)} never-sync items: ${[...NEVER_SYNC].join(", ")}`);
+  addItem(
+    section2,
+    `${dim(infoGlyph)} never-sync items: ${NEVER_SYNC.size} protected ${dim(
+      "(https://funkadelic.github.io/claude-nomad/how-it-works/)"
+    )}`
+  );
 }
 
 // src/commands.doctor.checks.repository.ts
 init_color();
 init_config();
 import { execFileSync as execFileSync3 } from "node:child_process";
-import { existsSync as existsSync10 } from "node:fs";
-import { join as join12, relative as relative2 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { join as join13, relative as relative2 } from "node:path";
+
+// src/commands.pull.wedge.ts
+import { existsSync as existsSync9 } from "node:fs";
+import { join as join10 } from "node:path";
+function detectWedge(repo) {
+  const g = join10(repo, ".git");
+  if (existsSync9(join10(g, "rebase-merge")) || existsSync9(join10(g, "rebase-apply"))) return "rebase";
+  if (existsSync9(join10(g, "MERGE_HEAD"))) return "merge";
+  return null;
+}
+
+// src/commands.doctor.checks.repository.ts
 init_push_checks();
 init_utils();
 function reportGitleaksProbe(section2) {
   try {
-    const v = execFileSync3("gitleaks", ["version"], { stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
-    addItem(section2, `${green(okGlyph)} gitleaks: ${dim(v)}`);
+    execFileSync3("gitleaks", ["version"], { stdio: ["ignore", "pipe", "pipe"] });
     return true;
   } catch (err) {
     if (err.code === "ENOENT") {
-      addItem(section2, `${yellow(warnGlyph)} gitleaks: not on PATH (required for nomad push)`);
+      addItem(
+        section2,
+        `${yellow(warnGlyph)} gitleaks: not on PATH (required for nomad push; install: https://github.com/gitleaks/gitleaks)`
+      );
     } else {
       addItem(section2, `${red(failGlyph)} gitleaks: probe failed: ${err.message}`);
       process.exitCode = 1;
@@ -1571,8 +1640,8 @@ function reportGitleaksProbe(section2) {
   }
 }
 function reportGitlinks(section2) {
-  const sharedDir = join12(REPO_HOME, "shared");
-  if (existsSync10(sharedDir)) {
+  const sharedDir = join13(REPO_HOME, "shared");
+  if (existsSync11(sharedDir)) {
     const gitlinks = findGitlinks(sharedDir);
     for (const p of gitlinks) {
       const rel = relative2(REPO_HOME, p);
@@ -1611,16 +1680,30 @@ function reportRebaseClean(section2) {
   } catch {
   }
 }
+function reportRebaseState(section2) {
+  try {
+    const wedge = detectWedge(REPO_HOME);
+    if (wedge !== null) {
+      const state = wedge === "rebase" ? "mid-rebase" : "mid-merge";
+      addItem(
+        section2,
+        `${red(failGlyph)} repo is ${state}: run 'nomad pull --force-remote' to auto-recover`
+      );
+      process.exitCode = 1;
+    }
+  } catch {
+  }
+}
 
 // src/commands.doctor.checks.backups.ts
 init_color();
-import { existsSync as existsSync11, lstatSync as lstatSync5, readdirSync as readdirSync4 } from "node:fs";
-import { join as join13 } from "node:path";
+import { existsSync as existsSync12, lstatSync as lstatSync5, readdirSync as readdirSync5 } from "node:fs";
+import { join as join14 } from "node:path";
 init_config();
 var TS_SHAPE2 = /^\d{8}-\d{6}(-\d+)?$/;
 function safeReaddir(dir) {
   try {
-    return readdirSync4(dir);
+    return readdirSync5(dir);
   } catch {
     return [];
   }
@@ -1631,7 +1714,7 @@ var BYTES_PER_MB = 1024 * 1024;
 function dirSizeBytes(dir) {
   let bytes = 0;
   for (const entry of safeReaddir(dir)) {
-    const full = join13(dir, entry);
+    const full = join14(dir, entry);
     const st = lstatSync5(full, { throwIfNoEntry: false });
     if (!st) continue;
     if (st.isSymbolicLink()) continue;
@@ -1642,11 +1725,11 @@ function dirSizeBytes(dir) {
 }
 function totalSizeMb(backupBase, dirs) {
   let bytes = 0;
-  for (const name of dirs) bytes += dirSizeBytes(join13(backupBase, name));
+  for (const name of dirs) bytes += dirSizeBytes(join14(backupBase, name));
   return bytes / BYTES_PER_MB;
 }
 function reportBackupsCheck(section2, backupBase = BACKUP_BASE) {
-  if (!existsSync11(backupBase)) return;
+  if (!existsSync12(backupBase)) return;
   const dirs = safeReaddir(backupBase).filter((n) => TS_SHAPE2.test(n));
   const count = dirs.length;
   const sizeMb = totalSizeMb(backupBase, dirs);
@@ -1660,8 +1743,8 @@ function reportBackupsCheck(section2, backupBase = BACKUP_BASE) {
 
 // src/commands.doctor.check-schema.ts
 init_color();
-import { existsSync as existsSync12 } from "node:fs";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync13 } from "node:fs";
+import { join as join15 } from "node:path";
 init_config();
 
 // src/http-fetch.ts
@@ -1698,8 +1781,8 @@ function fetchSchemaKeys() {
   }
 }
 function reportCheckSchema(section2) {
-  const settingsPath = join14(CLAUDE_HOME, "settings.json");
-  if (!existsSync12(settingsPath)) {
+  const settingsPath = join15(CLAUDE_HOME, "settings.json");
+  if (!existsSync13(settingsPath)) {
     addItem(section2, `${dim(infoGlyph)} no ~/.claude/settings.json to check`);
     return;
   }
@@ -1729,18 +1812,18 @@ function reportCheckSchema(section2) {
 init_color();
 import { randomBytes } from "node:crypto";
 import { execFileSync as execFileSync6 } from "node:child_process";
-import { existsSync as existsSync14, mkdirSync as mkdirSync4, readdirSync as readdirSync6, rmSync as rmSync6 } from "node:fs";
+import { existsSync as existsSync15, mkdirSync as mkdirSync4, readdirSync as readdirSync7, rmSync as rmSync6 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 
 // src/commands.doctor.check-shared.scan.ts
 init_color();
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 init_config();
 init_push_gitleaks();
 function scrubPath(logical, sid, logicalToEncoded) {
   const encoded = logicalToEncoded.get(logical) ?? logical;
-  return join16(CLAUDE_HOME, "projects", encoded, `${sid}.jsonl`);
+  return join17(CLAUDE_HOME, "projects", encoded, `${sid}.jsonl`);
 }
 function reportSessionFindings(section2, bySession) {
   for (const [sid, counts] of bySession) {
@@ -1832,8 +1915,8 @@ init_config();
 init_utils();
 init_utils_fs();
 init_utils_json();
-import { cpSync as cpSync3, existsSync as existsSync13, mkdirSync as mkdirSync3, readdirSync as readdirSync5, rmSync as rmSync5, statSync as statSync4 } from "node:fs";
-import { join as join17, relative as relative3, sep } from "node:path";
+import { cpSync as cpSync3, existsSync as existsSync14, mkdirSync as mkdirSync3, readdirSync as readdirSync6, rmSync as rmSync5, statSync as statSync4 } from "node:fs";
+import { join as join18, relative as relative3, sep } from "node:path";
 function copyDir(src, dst) {
   rmSync5(dst, { recursive: true, force: true });
   cpSync3(src, dst, { recursive: true, force: true });
@@ -1863,15 +1946,15 @@ function remapPull(ts, opts = {}) {
   let unmapped = 0;
   const pulled = [];
   const wouldPull = [];
-  const mapPath = join17(REPO_HOME, "path-map.json");
-  const repoProjects = join17(REPO_HOME, "shared", "projects");
-  if (!existsSync13(mapPath) || !existsSync13(repoProjects)) {
+  const mapPath = join18(REPO_HOME, "path-map.json");
+  const repoProjects = join18(REPO_HOME, "shared", "projects");
+  if (!existsSync14(mapPath) || !existsSync14(repoProjects)) {
     const text = "no path-map or repo projects dir; skipping session remap";
     emitPreview(opts.onPreview, { kind: "note", text }, text);
     return { unmapped: 0, pulled, wouldPull };
   }
   const map = readJson(mapPath);
-  const localProjects = join17(CLAUDE_HOME, "projects");
+  const localProjects = join18(CLAUDE_HOME, "projects");
   if (!dryRun) mkdirSync3(localProjects, { recursive: true });
   for (const [logical, hosts] of Object.entries(map.projects)) {
     assertSafeLogical(logical);
@@ -1880,9 +1963,9 @@ function remapPull(ts, opts = {}) {
       unmapped++;
       continue;
     }
-    const src = join17(repoProjects, logical);
-    if (!existsSync13(src)) continue;
-    const dst = join17(localProjects, encodePath(localPath));
+    const src = join18(repoProjects, logical);
+    if (!existsSync14(src)) continue;
+    const dst = join18(localProjects, encodePath(localPath));
     if (dryRun) {
       wouldPull.push(logical);
       emitPreview(
@@ -1927,30 +2010,30 @@ function remapPush(ts, opts = {}) {
   let unmapped = 0;
   const pushed = [];
   const wouldPush = [];
-  const mapPath = join17(REPO_HOME, "path-map.json");
-  if (!existsSync13(mapPath)) {
+  const mapPath = join18(REPO_HOME, "path-map.json");
+  if (!existsSync14(mapPath)) {
     log("no path-map.json; skipping session export");
     return { unmapped: 0, collisions: 0, pushed, wouldPush };
   }
   const map = readJson(mapPath);
-  const localProjects = join17(CLAUDE_HOME, "projects");
-  const repoProjects = join17(REPO_HOME, "shared", "projects");
+  const localProjects = join18(CLAUDE_HOME, "projects");
+  const repoProjects = join18(REPO_HOME, "shared", "projects");
   const reverse = buildReverseMap(map);
-  if (!existsSync13(localProjects)) return { unmapped, collisions: 0, pushed, wouldPush };
+  if (!existsSync14(localProjects)) return { unmapped, collisions: 0, pushed, wouldPush };
   if (!dryRun) mkdirSync3(repoProjects, { recursive: true });
-  for (const dir of readdirSync5(localProjects)) {
+  for (const dir of readdirSync6(localProjects)) {
     const logical = reverse.get(dir);
     if (!logical) {
       unmapped++;
       continue;
     }
-    const repoDst = join17(repoProjects, logical);
+    const repoDst = join18(repoProjects, logical);
     if (dryRun) {
       wouldPush.push(logical);
       continue;
     }
     backupRepoWrite(repoDst, ts, REPO_HOME);
-    copyDirJsonlOnly(join17(localProjects, dir), repoDst);
+    copyDirJsonlOnly(join18(localProjects, dir), repoDst);
     pushed.push(logical);
   }
   return { unmapped, collisions: 0, pushed, wouldPush };
@@ -1962,8 +2045,8 @@ init_utils_json();
 function buildScanTree(tmpRoot) {
   const logicalToEncoded = /* @__PURE__ */ new Map();
   let staged = 0;
-  const mapPath = join18(REPO_HOME, "path-map.json");
-  if (!existsSync14(mapPath)) return { logicalToEncoded, staged, malformed: false };
+  const mapPath = join19(REPO_HOME, "path-map.json");
+  if (!existsSync15(mapPath)) return { logicalToEncoded, staged, malformed: false };
   let map;
   try {
     map = readJson(mapPath);
@@ -1980,12 +2063,12 @@ function buildScanTree(tmpRoot) {
     if (!p || p === "TBD") continue;
     reverse.set(encodePath(p), logical);
   }
-  const localProjects = join18(CLAUDE_HOME, "projects");
-  if (!existsSync14(localProjects)) return { logicalToEncoded, staged, malformed: false };
-  for (const dir of readdirSync6(localProjects)) {
+  const localProjects = join19(CLAUDE_HOME, "projects");
+  if (!existsSync15(localProjects)) return { logicalToEncoded, staged, malformed: false };
+  for (const dir of readdirSync7(localProjects)) {
     const logical = reverse.get(dir);
     if (!logical) continue;
-    copyDirJsonlOnly(join18(localProjects, dir), join18(tmpRoot, "shared", "projects", logical));
+    copyDirJsonlOnly(join19(localProjects, dir), join19(tmpRoot, "shared", "projects", logical));
     logicalToEncoded.set(logical, dir);
     staged++;
   }
@@ -2016,11 +2099,11 @@ function ensureGitleaksReady(section2, gitleaksReady) {
 }
 function reportCheckShared(section2, gitleaksReady) {
   if (!ensureGitleaksReady(section2, gitleaksReady)) return;
-  const cacheDir = join18(homedir4(), ".cache", "claude-nomad");
+  const cacheDir = join19(homedir4(), ".cache", "claude-nomad");
   mkdirSync4(cacheDir, { recursive: true });
   const stamp = `${nowTimestamp()}-${process.pid}-${randomBytes(4).toString("hex")}`;
-  const reportPath = join18(cacheDir, `check-shared-${stamp}.json`);
-  const tmpRoot = join18(cacheDir, `check-shared-tree-${stamp}`);
+  const reportPath = join19(cacheDir, `check-shared-${stamp}.json`);
+  const tmpRoot = join19(cacheDir, `check-shared-tree-${stamp}`);
   try {
     const { logicalToEncoded, staged, malformed } = buildScanTree(tmpRoot);
     if (malformed) {
@@ -2041,8 +2124,8 @@ function reportCheckShared(section2, gitleaksReady) {
 
 // src/commands.doctor.checks.hooks.scope.ts
 init_color();
-import { existsSync as existsSync15, readFileSync as readFileSync5, readdirSync as readdirSync7, realpathSync } from "node:fs";
-import { dirname as dirname2, extname, join as join19 } from "node:path";
+import { existsSync as existsSync16, readFileSync as readFileSync5, readdirSync as readdirSync8, realpathSync } from "node:fs";
+import { dirname as dirname2, extname, join as join20 } from "node:path";
 init_config();
 function typeFromPackageJson(pkgPath) {
   try {
@@ -2064,8 +2147,8 @@ function effectiveType(hookPath) {
   }
   let dir = dirname2(real);
   for (; ; ) {
-    const pkg = join19(dir, "package.json");
-    if (existsSync15(pkg)) return typeFromPackageJson(pkg);
+    const pkg = join20(dir, "package.json");
+    if (existsSync16(pkg)) return typeFromPackageJson(pkg);
     const parent = dirname2(dir);
     if (parent === dir) return "cjs";
     dir = parent;
@@ -2094,7 +2177,7 @@ function remedy(family) {
 }
 function safeReaddir2(dir) {
   try {
-    return readdirSync7(dir);
+    return readdirSync8(dir);
   } catch {
     return [];
   }
@@ -2107,15 +2190,15 @@ function safeRead(path) {
   }
 }
 function reportHookScopeCheck(section2) {
-  const hooksDir = join19(CLAUDE_HOME, "hooks");
-  if (!existsSync15(hooksDir)) {
+  const hooksDir = join20(CLAUDE_HOME, "hooks");
+  if (!existsSync16(hooksDir)) {
     addItem(section2, `${dim(infoGlyph)} no ~/.claude/hooks; skipping module-scope check`);
     return;
   }
   let anyWarn = false;
   for (const name of safeReaddir2(hooksDir)) {
     if (extname(name) !== ".js") continue;
-    const abs = join19(hooksDir, name);
+    const abs = join20(hooksDir, name);
     const eff = effectiveType(abs);
     if (eff === null) continue;
     const src = safeRead(abs);
@@ -2135,8 +2218,8 @@ function reportHookScopeCheck(section2) {
 
 // src/commands.doctor.checks.hooks.ts
 init_color();
-import { existsSync as existsSync16 } from "node:fs";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync17 } from "node:fs";
+import { join as join21 } from "node:path";
 init_config();
 function expandHome(token) {
   return token.replace(/^\$\{HOME\}/, HOME).replace(/^\$HOME/, HOME).replace(/^~/, HOME);
@@ -2174,8 +2257,11 @@ function checkEventGroups(section2, event, groups) {
   for (const group of groups) {
     for (const cmd of commandsFromGroup(group)) {
       for (const resolved of claudePathsIn(cmd)) {
-        if (existsSync16(resolved)) continue;
-        addItem(section2, `${red(failGlyph)} hooks/${event}: command target missing: ${resolved}`);
+        if (existsSync17(resolved)) continue;
+        addItem(
+          section2,
+          `${red(failGlyph)} hooks/${event}: command target missing: ${resolved} (run nomad pull)`
+        );
         process.exitCode = 1;
         anyFail = true;
       }
@@ -2184,8 +2270,8 @@ function checkEventGroups(section2, event, groups) {
   return anyFail;
 }
 function reportHooksTargetCheck(section2) {
-  const settingsPath = join20(CLAUDE_HOME, "settings.json");
-  if (!existsSync16(settingsPath)) {
+  const settingsPath = join21(CLAUDE_HOME, "settings.json");
+  if (!existsSync17(settingsPath)) {
     addItem(section2, `${dim(infoGlyph)} no ~/.claude/settings.json; skipping hook target check`);
     return;
   }
@@ -2206,17 +2292,221 @@ function reportHooksTargetCheck(section2) {
   }
 }
 
+// src/commands.doctor.checks.hooks.preserve-symlinks.ts
+init_color();
+import { existsSync as existsSync19, readFileSync as readFileSync6 } from "node:fs";
+import { join as join23 } from "node:path";
+
+// src/commands.doctor.checks.hooks.preserve-symlinks.probe.ts
+import { closeSync as closeSync2, existsSync as existsSync18, openSync as openSync2, readSync, realpathSync as realpathSync2 } from "node:fs";
+import { dirname as dirname3, join as join22, resolve as resolve2 } from "node:path";
+function suppressedRanges(src) {
+  const ranges = [];
+  const re = /\/\*[\s\S]*?\*\/|\/\/[^\n]*|'[^']*'|"[^"]*"|`[^`]*`/g;
+  let m;
+  while ((m = re.exec(src)) !== null) {
+    ranges.push([m.index, m.index + m[0].length]);
+  }
+  return ranges;
+}
+function inSuppressedRange(pos, ranges) {
+  for (const [start, end] of ranges) {
+    if (pos >= start && pos < end) return true;
+  }
+  return false;
+}
+function topRelativeSpecifiers(src) {
+  const ranges = suppressedRanges(src);
+  const specifiers = [];
+  const reqRe = /\brequire\s*\(\s*(['"])(\.\.?\/[^'"]*)\1\s*\)/g;
+  let m;
+  while ((m = reqRe.exec(src)) !== null) {
+    if (!inSuppressedRange(m.index, ranges)) specifiers.push(m[2]);
+  }
+  const impRe = /\bfrom\s+(['"])(\.\.?\/[^'"]*)\1/g;
+  while ((m = impRe.exec(src)) !== null) {
+    if (!inSuppressedRange(m.index, ranges)) specifiers.push(m[2]);
+  }
+  return specifiers;
+}
+function specifierIsMissing(specifier, baseDir) {
+  const base = resolve2(baseDir, specifier);
+  if (existsSync18(base)) return false;
+  for (const ext of [".js", ".cjs", ".mjs"]) {
+    if (existsSync18(base + ext)) return false;
+  }
+  for (const idx of ["index.js", "index.cjs", "index.mjs"]) {
+    if (existsSync18(join22(base, idx))) return false;
+  }
+  return true;
+}
+function relativeRequireTargetsBroken(scriptPath) {
+  let realPath;
+  try {
+    realPath = realpathSync2(scriptPath);
+  } catch {
+    return false;
+  }
+  let raw;
+  try {
+    const fd = openSync2(realPath, "r");
+    try {
+      const buf = Buffer.alloc(65536);
+      const bytesRead = readSync(fd, buf, 0, 65536, 0);
+      raw = buf.toString("utf8", 0, bytesRead);
+    } finally {
+      closeSync2(fd);
+    }
+  } catch {
+    return false;
+  }
+  const specifiers = topRelativeSpecifiers(raw);
+  if (specifiers.length === 0) return false;
+  const baseDir = dirname3(realPath);
+  for (const spec of specifiers) {
+    if (specifierIsMissing(spec, baseDir)) return true;
+  }
+  return false;
+}
+
+// src/commands.doctor.checks.hooks.preserve-symlinks.ts
+init_config();
+function expandHome2(token) {
+  return token.replace(/^\$\{HOME\}/, HOME).replace(/^\$HOME/, HOME).replace(/^~/, HOME);
+}
+function stripShellPunct(token) {
+  const head = token.replace(/^['"]+/, "");
+  let end = head.length;
+  while (end > 0 && "'\"`;)|&>".includes(head[end - 1])) end--;
+  return head.slice(0, end);
+}
+function commandTokens(command) {
+  const tokens = [];
+  for (const seg of command.split(/&&|\|\||;|\|/)) {
+    for (const raw of seg.trim().split(/\s+/).filter(Boolean)) {
+      tokens.push(expandHome2(stripShellPunct(raw)));
+    }
+  }
+  return tokens;
+}
+function readPathMapSafe() {
+  const mapPath = join23(REPO_HOME, "path-map.json");
+  if (!existsSync19(mapPath)) return { projects: {} };
+  try {
+    return JSON.parse(readFileSync6(mapPath, "utf8"));
+  } catch {
+    return { projects: {} };
+  }
+}
+function resolvesUnderSymlinkedShared(scriptPath, sharedLinkNames) {
+  for (const name of sharedLinkNames) {
+    const prefix = `${CLAUDE_HOME}/${name}/`;
+    if (scriptPath.startsWith(prefix)) return true;
+  }
+  return false;
+}
+function nodeScriptArg(tokens, nodeIdx) {
+  for (let i = nodeIdx + 1; i < tokens.length; i++) {
+    const t = tokens[i];
+    if (t.startsWith("-")) continue;
+    if (t.endsWith(".js") || t.endsWith(".cjs")) return t;
+    break;
+  }
+  return null;
+}
+function hasPreserveSymlinksMain(tokens, nodeIdx) {
+  for (let i = nodeIdx + 1; i < tokens.length; i++) {
+    if (tokens[i] === "--preserve-symlinks-main") return true;
+    if (!tokens[i].startsWith("-")) break;
+  }
+  return false;
+}
+function* commandsFromFlatEntries(entries) {
+  for (const entry of entries) {
+    if (typeof entry !== "object" || entry === null) continue;
+    const e = entry;
+    if (e.type === "command" && typeof e.command === "string") yield e.command;
+  }
+}
+function* commandsFromOneGroup(group) {
+  if (typeof group !== "object" || group === null) return;
+  const g = group;
+  if (Array.isArray(g.hooks)) {
+    yield* commandsFromFlatEntries(g.hooks);
+    return;
+  }
+  if (g.type === "command" && typeof g.command === "string") yield g.command;
+}
+function flaggedScript(command, sharedLinkNames) {
+  const tokens = commandTokens(command);
+  const nodeIdx = tokens.indexOf("node");
+  if (nodeIdx < 0) return null;
+  if (hasPreserveSymlinksMain(tokens, nodeIdx)) return null;
+  const script = nodeScriptArg(tokens, nodeIdx);
+  if (script === null) return null;
+  if (!resolvesUnderSymlinkedShared(script, sharedLinkNames)) return null;
+  if (!relativeRequireTargetsBroken(script)) return null;
+  return script;
+}
+function checkEventForPreserveSymlinks(section2, event, groups, sharedLinkNames) {
+  let anyWarn = false;
+  for (const group of groups) {
+    for (const cmd of commandsFromOneGroup(group)) {
+      const script = flaggedScript(cmd, sharedLinkNames);
+      if (script === null) continue;
+      addItem(
+        section2,
+        `${yellow(warnGlyph)} hooks/${event}: node ${script} needs --preserve-symlinks-main (add it to the hook command in shared/settings.base.json)`
+      );
+      anyWarn = true;
+    }
+  }
+  return anyWarn;
+}
+function reportPreserveSymlinksCheck(section2) {
+  const settingsPath = join23(CLAUDE_HOME, "settings.json");
+  if (!existsSync19(settingsPath)) {
+    addItem(
+      section2,
+      `${dim(infoGlyph)} no ~/.claude/settings.json; skipping preserve-symlinks-main check`
+    );
+    return;
+  }
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync6(settingsPath, "utf8"));
+  } catch {
+    return;
+  }
+  if (settings === null) return;
+  const hooks = settings.hooks;
+  if (typeof hooks !== "object" || hooks === null || Array.isArray(hooks)) {
+    addItem(section2, `${green(okGlyph)} hooks: preserve-symlinks-main not needed`);
+    return;
+  }
+  const map = readPathMapSafe();
+  const sharedLinkNames = allSharedLinks(map);
+  let anyWarn = false;
+  for (const [event, groups] of Object.entries(hooks)) {
+    if (!Array.isArray(groups)) continue;
+    if (checkEventForPreserveSymlinks(section2, event, groups, sharedLinkNames)) anyWarn = true;
+  }
+  if (!anyWarn) {
+    addItem(section2, `${green(okGlyph)} hooks: preserve-symlinks-main not needed`);
+  }
+}
+
 // src/commands.doctor.ts
 init_config();
 
 // src/commands.doctor.engine.ts
 init_color();
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/commands.doctor.version.ts
 init_color();
-import { readFileSync as readFileSync6 } from "node:fs";
+import { readFileSync as readFileSync7 } from "node:fs";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 init_config();
 var STRICT_SEMVER = /^\d+\.\d+\.\d+$/;
@@ -2233,7 +2523,7 @@ function compareSemver(a, b) {
 function readLocalVersion() {
   try {
     const pkgPath = fileURLToPath2(new URL("../package.json", import.meta.url));
-    const parsed = JSON.parse(readFileSync6(pkgPath, "utf8"));
+    const parsed = JSON.parse(readFileSync7(pkgPath, "utf8"));
     if (typeof parsed.version === "string" && parsed.version.length > 0) {
       return parsed.version;
     }
@@ -2260,7 +2550,13 @@ function reportVersionCheck(section2) {
   const localPure = STRICT_SEMVER_PREFIX.exec(local)?.[1] ?? null;
   if (localPure === null) return;
   const latest = fetchLatestVersion();
-  if (latest === null) return;
+  if (latest === null) {
+    addItem(
+      section2,
+      `${dim(infoGlyph)} claude-nomad: ${local} (version check skipped: could not determine latest version)`
+    );
+    return;
+  }
   const cmp = compareSemver(localPure, latest);
   if (cmp === 0) {
     addItem(section2, `${green(okGlyph)} claude-nomad: ${local} (latest)`);
@@ -2286,7 +2582,7 @@ function parseMinVersion(spec) {
 function readEnginesNode() {
   try {
     const pkgPath = fileURLToPath3(new URL("../package.json", import.meta.url));
-    const parsed = JSON.parse(readFileSync7(pkgPath, "utf8"));
+    const parsed = JSON.parse(readFileSync8(pkgPath, "utf8"));
     const node = parsed.engines?.node;
     if (typeof node === "string" && node.length > 0) return node;
     return null;
@@ -2315,8 +2611,8 @@ function reportNodeEngineCheck(section2) {
 // src/commands.doctor.gitleaks-version.ts
 init_color();
 import { execFileSync as execFileSync7 } from "node:child_process";
-import { existsSync as existsSync17 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync20 } from "node:fs";
+import { join as join24 } from "node:path";
 init_config();
 var SEMVER_MAJOR_MINOR = /^(\d+)\.(\d+)\.\d+$/;
 var GITLEAKS_TIMEOUT_MS = 5e3;
@@ -2325,7 +2621,7 @@ function majorMinorOf(value) {
   return m === null ? null : [m[1], m[2]];
 }
 function readGitleaksVersion(run, tomlExists) {
-  const tomlPath = join21(REPO_HOME, ".gitleaks.toml");
+  const tomlPath = join24(REPO_HOME, ".gitleaks.toml");
   const args = ["version"];
   if (tomlExists(tomlPath)) args.push("--config", tomlPath);
   try {
@@ -2337,7 +2633,7 @@ function readGitleaksVersion(run, tomlExists) {
     return null;
   }
 }
-function reportGitleaksVersionCheck(section2, run = execFileSync7, tomlExists = existsSync17) {
+function reportGitleaksVersionCheck(section2, run = execFileSync7, tomlExists = existsSync20) {
   const raw = readGitleaksVersion(run, tomlExists);
   if (raw === null) return;
   const local = majorMinorOf(raw);
@@ -2504,19 +2800,47 @@ function reportActionsDrift(section2, run = execFileSync10) {
   );
 }
 
+// src/commands.doctor.verdict.ts
+init_color();
+function isFailLine(item) {
+  return item.includes(failGlyph);
+}
+function isWarnLine(item) {
+  return !isFailLine(item) && item.includes(warnGlyph);
+}
+function buildVerdictSection(sections) {
+  const summary = section("Summary");
+  const lines = sections.flatMap((s) => s.items).map((item) => item.replace(/^\t/, ""));
+  const failures = lines.filter(isFailLine);
+  const warnings = lines.filter(isWarnLine);
+  for (const line of [...failures, ...warnings]) addItem(summary, line);
+  if (failures.length > 0) {
+    addItem(
+      summary,
+      `${red(failGlyph)} ${failures.length} failure(s), ${warnings.length} warning(s)`
+    );
+  } else if (warnings.length > 0) {
+    addItem(summary, `${yellow(warnGlyph)} ${warnings.length} warning(s)`);
+  } else {
+    addItem(summary, `${green(okGlyph)} healthy`);
+  }
+  return summary;
+}
+
 // src/commands.doctor.ts
 function cmdDoctor(opts = {}) {
-  const host = section("Host");
+  const host = section("Environment");
   reportHostAndPaths(host);
   reportRepoState(host);
   const links = section("Shared links");
-  const mapPath = join22(REPO_HOME, "path-map.json");
-  const rawMap = existsSync18(mapPath) ? readJsonSafe(mapPath, mapPath, links) : null;
+  const mapPath = join25(REPO_HOME, "path-map.json");
+  const rawMap = existsSync21(mapPath) ? readJsonSafe(mapPath, mapPath, links) : null;
   const map = rawMap ?? { projects: {} };
   reportSharedLinks(links, map);
   const hooksScan = section("Hook targets");
   reportHooksTargetCheck(hooksScan);
   reportHookScopeCheck(hooksScan);
+  reportPreserveSymlinksCheck(hooksScan);
   const settings = section("Settings");
   const base = loadBaseSettings(settings);
   const parsedSettings = loadAndReportSettings(settings);
@@ -2530,10 +2854,12 @@ function cmdDoctor(opts = {}) {
   reportGitlinks(repository);
   reportRemote(repository);
   reportRebaseClean(repository);
+  reportRebaseState(repository);
   reportActionsDrift(repository);
   const nomadVersion = section("Nomad Version");
   reportVersionCheck(nomadVersion);
-  reportBackupsCheck(nomadVersion);
+  const housekeeping = section("Housekeeping");
+  reportBackupsCheck(housekeeping);
   const depVersions = section("Dependency Versions");
   reportNodeEngineCheck(depVersions);
   reportGitleaksVersionCheck(depVersions);
@@ -2542,7 +2868,7 @@ function cmdDoctor(opts = {}) {
   if (opts.checkShared === true) reportCheckShared(sharedScan, gitleaksReady);
   const schemaScan = section("Schema scan");
   if (opts.checkSchema === true) reportCheckSchema(schemaScan);
-  renderDoctor([
+  const body = [
     nomadVersion,
     depVersions,
     host,
@@ -2552,16 +2878,18 @@ function cmdDoctor(opts = {}) {
     pathMap,
     neverSync,
     repository,
+    housekeeping,
     sharedScan,
     schemaScan
-  ]);
+  ];
+  renderDoctor([...body, buildVerdictSection(body)]);
 }
 
 // src/commands.drop-session.ts
 init_config();
 import { execFileSync as execFileSync12 } from "node:child_process";
-import { existsSync as existsSync20, readdirSync as readdirSync8, statSync as statSync5 } from "node:fs";
-import { join as join25, relative as relative4 } from "node:path";
+import { existsSync as existsSync23, readdirSync as readdirSync9, statSync as statSync5 } from "node:fs";
+import { join as join28, relative as relative4 } from "node:path";
 
 // src/commands.drop-session.git.ts
 init_config();
@@ -2604,8 +2932,8 @@ function isInIndex(rel) {
 init_config();
 init_utils();
 init_utils_json();
-import { existsSync as existsSync19 } from "node:fs";
-import { join as join23 } from "node:path";
+import { existsSync as existsSync22 } from "node:fs";
+import { join as join26 } from "node:path";
 var SHARED_PROJECT_LOGICAL = /^shared\/projects\/([^/]+)\//;
 function reportScrubHint(id, matches) {
   const live = resolveLiveTranscript(id, matches);
@@ -2621,16 +2949,16 @@ function reportScrubHint(id, matches) {
 }
 function resolveLiveTranscript(id, matches) {
   try {
-    const mapPath = join23(REPO_HOME, "path-map.json");
-    if (!existsSync19(mapPath)) return null;
+    const mapPath = join26(REPO_HOME, "path-map.json");
+    if (!existsSync22(mapPath)) return null;
     const projects = readJson(mapPath).projects;
     for (const rel of matches) {
       const logical = SHARED_PROJECT_LOGICAL.exec(rel)?.[1];
       if (logical === void 0) continue;
       const abs = projects[logical]?.[HOST];
       if (abs === void 0) continue;
-      const live = join23(CLAUDE_HOME, "projects", encodePath(abs), `${id}.jsonl`);
-      if (existsSync19(live)) return live;
+      const live = join26(CLAUDE_HOME, "projects", encodePath(abs), `${id}.jsonl`);
+      if (existsSync22(live)) return live;
     }
     return null;
   } catch {
@@ -2644,18 +2972,18 @@ init_utils();
 // src/utils.lockfile.ts
 init_config();
 init_utils();
-import { closeSync as closeSync2, mkdirSync as mkdirSync5, openSync as openSync2, readFileSync as readFileSync8, unlinkSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname3, join as join24 } from "node:path";
-var LOCK_PATH = join24(HOME, ".cache", "claude-nomad", "nomad.lock");
+import { closeSync as closeSync3, mkdirSync as mkdirSync5, openSync as openSync3, readFileSync as readFileSync9, unlinkSync, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname4, join as join27 } from "node:path";
+var LOCK_PATH = join27(HOME, ".cache", "claude-nomad", "nomad.lock");
 function acquireLock(verb) {
-  mkdirSync5(dirname3(LOCK_PATH), { recursive: true });
+  mkdirSync5(dirname4(LOCK_PATH), { recursive: true });
   try {
-    const fd = openSync2(LOCK_PATH, "wx");
+    const fd = openSync3(LOCK_PATH, "wx");
     try {
       writeFileSync3(fd, String(process.pid));
     } catch (writeErr) {
       try {
-        closeSync2(fd);
+        closeSync3(fd);
       } catch {
       }
       try {
@@ -2674,7 +3002,7 @@ function acquireLock(verb) {
 function releaseLock(handle) {
   if (handle === null) return;
   try {
-    closeSync2(handle.fd);
+    closeSync3(handle.fd);
   } catch {
   }
   try {
@@ -2686,7 +3014,7 @@ function releaseLock(handle) {
 function unlinkIfSamePid(expectedPidStr) {
   let current;
   try {
-    current = readFileSync8(LOCK_PATH, "utf8").trim();
+    current = readFileSync9(LOCK_PATH, "utf8").trim();
   } catch {
     return false;
   }
@@ -2701,7 +3029,7 @@ function unlinkIfSamePid(expectedPidStr) {
 function checkStaleAndRetry(verb) {
   let pidStr;
   try {
-    pidStr = readFileSync8(LOCK_PATH, "utf8").trim();
+    pidStr = readFileSync9(LOCK_PATH, "utf8").trim();
   } catch {
     pidStr = "";
   }
@@ -2728,12 +3056,12 @@ function checkStaleAndRetry(verb) {
 }
 function retryOnce(verb) {
   try {
-    const fd = openSync2(LOCK_PATH, "wx");
+    const fd = openSync3(LOCK_PATH, "wx");
     try {
       writeFileSync3(fd, String(process.pid));
     } catch {
       try {
-        closeSync2(fd);
+        closeSync3(fd);
       } catch {
       }
       try {
@@ -2756,12 +3084,12 @@ function cmdDropSession(id) {
     fail(`invalid session id: ${id}`);
     process.exit(1);
   }
-  if (!existsSync20(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+  if (!existsSync23(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
   const handle = acquireLock("drop-session");
   if (handle === null) process.exit(0);
   try {
-    const repoProjects = join25(REPO_HOME, "shared", "projects");
-    if (!existsSync20(repoProjects)) {
+    const repoProjects = join28(REPO_HOME, "shared", "projects");
+    if (!existsSync23(repoProjects)) {
       throw new NomadFatal(`no staged session matches ${id}`);
     }
     const matches = collectMatches(repoProjects, id);
@@ -2782,13 +3110,13 @@ function cmdDropSession(id) {
 }
 function collectMatches(repoProjects, id) {
   const matches = [];
-  for (const logical of readdirSync8(repoProjects)) {
-    const candidate = join25(repoProjects, logical, `${id}.jsonl`);
-    if (existsSync20(candidate)) {
+  for (const logical of readdirSync9(repoProjects)) {
+    const candidate = join28(repoProjects, logical, `${id}.jsonl`);
+    if (existsSync23(candidate)) {
       matches.push(relative4(REPO_HOME, candidate));
     }
-    const dir = join25(repoProjects, logical, id);
-    if (existsSync20(dir) && statSync5(dir).isDirectory()) {
+    const dir = join28(repoProjects, logical, id);
+    if (existsSync23(dir) && statSync5(dir).isDirectory()) {
       const dirRel = relative4(REPO_HOME, dir);
       const staged = expandStagedDir(dirRel);
       if (staged.length > 0) matches.push(...staged);
@@ -2824,19 +3152,19 @@ function unstageOne(rel) {
 
 // src/commands.redact.ts
 init_config();
-import { existsSync as existsSync22, statSync as statSync7 } from "node:fs";
-import { dirname as dirname4, join as join27 } from "node:path";
+import { existsSync as existsSync25, statSync as statSync7 } from "node:fs";
+import { dirname as dirname5, join as join30 } from "node:path";
 
 // src/commands.redact.subtree.ts
-import { existsSync as existsSync21, lstatSync as lstatSync6, readFileSync as readFileSync9, readdirSync as readdirSync9, statSync as statSync6, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join26 } from "node:path";
+import { existsSync as existsSync24, lstatSync as lstatSync6, readFileSync as readFileSync10, readdirSync as readdirSync10, statSync as statSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join29 } from "node:path";
 init_utils_fs();
 function collectFiles(dir, out) {
-  if (!existsSync21(dir)) return;
+  if (!existsSync24(dir)) return;
   const st = lstatSync6(dir);
   if (!st.isDirectory()) return;
-  for (const entry of readdirSync9(dir)) {
-    const abs = join26(dir, entry);
+  for (const entry of readdirSync10(dir)) {
+    const abs = join29(dir, entry);
     const lst = lstatSync6(abs);
     if (lst.isSymbolicLink()) continue;
     if (lst.isDirectory()) {
@@ -2873,7 +3201,7 @@ function applySubtreeRedactions(mainPath, mainFindings, subtreeFiles, rule, ts,
   if (!dryRun && total > 0) {
     for (const { path: filePath, findings } of dirty) {
       backupBeforeWrite(filePath, ts);
-      writeFileSync4(filePath, applyRedactions(readFileSync9(filePath, "utf8"), findings), "utf8");
+      writeFileSync4(filePath, applyRedactions(readFileSync10(filePath, "utf8"), findings), "utf8");
     }
   }
   return { total, dirty };
@@ -2886,14 +3214,14 @@ init_utils_json();
 init_utils();
 function resolveLiveTranscript2(id) {
   try {
-    const mapPath = join27(REPO_HOME, "path-map.json");
-    if (!existsSync22(mapPath)) return null;
+    const mapPath = join30(REPO_HOME, "path-map.json");
+    if (!existsSync25(mapPath)) return null;
     const projects = readJson(mapPath).projects;
     for (const hostMap of Object.values(projects)) {
       const abs = hostMap[HOST];
       if (abs === void 0) continue;
-      const live = join27(CLAUDE_HOME, "projects", encodePath(abs), `${id}.jsonl`);
-      if (existsSync22(live)) return live;
+      const live = join30(CLAUDE_HOME, "projects", encodePath(abs), `${id}.jsonl`);
+      if (existsSync25(live)) return live;
     }
     return null;
   } catch {
@@ -2911,17 +3239,17 @@ function cmdRedact(opts, nowMs = Date.now, scan = scanFile) {
     fail(`invalid session id: ${id}`);
     process.exit(1);
   }
-  if (!existsSync22(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+  if (!existsSync25(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
   const handle = acquireLock("redact");
   if (handle === null) process.exit(0);
   try {
     const localPath = resolveLiveTranscript2(id);
-    if (localPath === null || !existsSync22(localPath)) {
+    if (localPath === null || !existsSync25(localPath)) {
       fail(`could not resolve local transcript for session ${id} on this host`);
       process.exitCode = 1;
       return;
     }
-    const sessionDir = join27(dirname4(localPath), id);
+    const sessionDir = join30(dirname5(localPath), id);
     const subtreeFiles = listSubtreeFiles(sessionDir);
     const subtreeMtime = newestSubtreeMtimeMs(localPath, subtreeFiles, (p) => statSync7(p).mtimeMs);
     if (isRecentlyModified(subtreeMtime, nowMs())) {
@@ -2974,8 +3302,8 @@ ${lines}`);
 }
 
 // src/commands.pull.ts
-import { existsSync as existsSync30, mkdirSync as mkdirSync8 } from "node:fs";
-import { join as join36 } from "node:path";
+import { existsSync as existsSync33, mkdirSync as mkdirSync8 } from "node:fs";
+import { join as join39 } from "node:path";
 
 // src/commands.push.sections.ts
 init_color();
@@ -3063,22 +3391,34 @@ init_config();
 
 // src/extras-sync.ts
 init_config();
-import { existsSync as existsSync25 } from "node:fs";
-import { join as join30 } from "node:path";
+import { existsSync as existsSync28 } from "node:fs";
+import { join as join33 } from "node:path";
 
 // src/extras-sync.diff.ts
 init_utils();
 import { execFileSync as execFileSync13 } from "node:child_process";
+function labelDiffLine(line) {
+  const tab = line.indexOf("	");
+  if (tab === -1) return line;
+  const status = line.slice(0, tab);
+  const path = line.slice(tab + 1);
+  if (status === "D") return `${path} (local only)`;
+  if (status === "A") return `${path} (repo only)`;
+  return path;
+}
+function parseDiffOutput(stdout) {
+  return stdout.split("\n").filter((line) => line.length > 0).map(labelDiffLine);
+}
 function listDivergingFiles(a, b) {
   try {
-    const stdout = execFileSync13("git", ["diff", "--no-index", "--name-only", a, b], {
+    const stdout = execFileSync13("git", ["diff", "--no-index", "--name-status", a, b], {
       stdio: ["ignore", "pipe", "pipe"]
     }).toString();
-    return stdout.split("\n").filter((line) => line.length > 0);
+    return parseDiffOutput(stdout);
   } catch (err) {
     const e = err;
     if (e.status === 1 && e.stdout !== void 0) {
-      return e.stdout.toString().split("\n").filter((line) => line.length > 0);
+      return parseDiffOutput(e.stdout.toString());
     }
     if (e.code === "ENOENT") {
       warn(`git not on PATH; divergence check skipped for ${a}`);
@@ -3091,8 +3431,8 @@ function listDivergingFiles(a, b) {
 
 // src/extras-sync.core.ts
 init_config();
-import { cpSync as cpSync4, existsSync as existsSync23, rmSync as rmSync7 } from "node:fs";
-import { join as join28 } from "node:path";
+import { cpSync as cpSync4, existsSync as existsSync26, rmSync as rmSync7 } from "node:fs";
+import { join as join31 } from "node:path";
 
 // src/extras-sync.guards.ts
 init_utils();
@@ -3115,9 +3455,9 @@ function assertSafeLocalRoot(localRoot, logical) {
 init_utils();
 init_utils_json();
 function loadValidatedExtras(opts) {
-  const mapPath = join28(REPO_HOME, "path-map.json");
-  const repoExtras = join28(REPO_HOME, "shared", "extras");
-  if (!existsSync23(mapPath) || opts.requireRepoExtras === true && !existsSync23(repoExtras)) {
+  const mapPath = join31(REPO_HOME, "path-map.json");
+  const repoExtras = join31(REPO_HOME, "shared", "extras");
+  if (!existsSync26(mapPath) || opts.requireRepoExtras === true && !existsSync26(repoExtras)) {
     if (opts.missingMsg !== void 0) log(opts.missingMsg);
     return null;
   }
@@ -3139,12 +3479,12 @@ function* eachExtrasTarget(v, counts) {
       counts.unmapped++;
       continue;
     }
-    for (const dirname6 of dirnames) {
-      if (!whitelist.includes(dirname6)) {
+    for (const dirname7 of dirnames) {
+      if (!whitelist.includes(dirname7)) {
         counts.skipped++;
         continue;
       }
-      yield { logical, localRoot, dirname: dirname6 };
+      yield { logical, localRoot, dirname: dirname7 };
     }
   }
 }
@@ -3159,8 +3499,8 @@ init_utils_json();
 
 // src/extras-sync.remap.ts
 init_config();
-import { existsSync as existsSync24, mkdirSync as mkdirSync6 } from "node:fs";
-import { join as join29 } from "node:path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync6 } from "node:fs";
+import { join as join32 } from "node:path";
 init_utils_fs();
 function runExtrasOp(v, dryRun, paths, backup) {
   const counts = { unmapped: 0, skipped: 0 };
@@ -3168,7 +3508,7 @@ function runExtrasOp(v, dryRun, paths, backup) {
   const would = [];
   for (const t of eachExtrasTarget(v, counts)) {
     const { src, dst } = paths(t);
-    if (!existsSync24(src)) continue;
+    if (!existsSync27(src)) continue;
     const item = `${t.logical}/${t.dirname}`;
     if (dryRun) {
       would.push(item);
@@ -3184,14 +3524,14 @@ function remapExtrasPush(ts, opts = {}) {
   const dryRun = opts.dryRun === true;
   const v = loadValidatedExtras({ missingMsg: "no path-map.json; skipping extras push" });
   if (v === null) return { unmapped: 0, skipped: 0, pushed: [], wouldPush: [] };
-  const repoExtras = join29(REPO_HOME, "shared", "extras");
+  const repoExtras = join32(REPO_HOME, "shared", "extras");
   if (!dryRun) mkdirSync6(repoExtras, { recursive: true });
   const { unmapped, skipped, done, would } = runExtrasOp(
     v,
     dryRun,
-    ({ localRoot, logical, dirname: dirname6 }) => ({
-      src: join29(localRoot, dirname6),
-      dst: join29(repoExtras, logical, dirname6)
+    ({ localRoot, logical, dirname: dirname7 }) => ({
+      src: join32(localRoot, dirname7),
+      dst: join32(repoExtras, logical, dirname7)
     }),
     (dst) => backupRepoWrite(dst, ts, REPO_HOME)
   );
@@ -3204,13 +3544,13 @@ function remapExtrasPull(ts, opts = {}) {
     missingMsg: "no path-map or repo extras dir; skipping extras remap"
   });
   if (v === null) return { unmapped: 0, skipped: 0, pulled: [], wouldPull: [] };
-  const repoExtras = join29(REPO_HOME, "shared", "extras");
+  const repoExtras = join32(REPO_HOME, "shared", "extras");
   const { unmapped, skipped, done, would } = runExtrasOp(
     v,
     dryRun,
-    ({ localRoot, logical, dirname: dirname6 }) => ({
-      src: join29(repoExtras, logical, dirname6),
-      dst: join29(localRoot, dirname6)
+    ({ localRoot, logical, dirname: dirname7 }) => ({
+      src: join32(repoExtras, logical, dirname7),
+      dst: join32(localRoot, dirname7)
     }),
     // Snapshot the host-side dst BEFORE copyExtras clobbers it. Anchor on
     // localRoot so the backup tree mirrors the project layout.
@@ -3224,16 +3564,16 @@ function divergenceCheckExtras(ts) {
   const v = loadValidatedExtras({});
   if (v === null) return;
   const counts = { unmapped: 0, skipped: 0 };
-  const backupRoot = join30(BACKUP_BASE, ts, "extras");
-  for (const { logical, localRoot, dirname: dirname6 } of eachExtrasTarget(v, counts)) {
-    const local = join30(localRoot, dirname6);
-    const repo = join30(REPO_HOME, "shared", "extras", logical, dirname6);
-    if (!existsSync25(local) || !existsSync25(repo)) continue;
+  const backupRoot = join33(BACKUP_BASE, ts, "extras");
+  for (const { logical, localRoot, dirname: dirname7 } of eachExtrasTarget(v, counts)) {
+    const local = join33(localRoot, dirname7);
+    const repo = join33(REPO_HOME, "shared", "extras", logical, dirname7);
+    if (!existsSync28(local) || !existsSync28(repo)) continue;
     const diff = listDivergingFiles(local, repo);
     if (diff.length === 0) continue;
-    const projectBackupRoot = join30(backupRoot, encodePath(localRoot));
+    const projectBackupRoot = join33(backupRoot, encodePath(localRoot));
     warn(
-      `local ${dirname6} for ${logical} diverges from origin in ${diff.length} file(s); next remapExtrasPull will overwrite them (backups at ${projectBackupRoot}/)`
+      `local ${dirname7} for ${logical} diverges from origin in ${diff.length} file(s); next remapExtrasPull will overwrite them (backups at ${projectBackupRoot}/)`
     );
     for (const f of diff) warn(`  ${f}`);
   }
@@ -3244,8 +3584,8 @@ init_config();
 init_utils();
 init_utils_fs();
 init_utils_json();
-import { existsSync as existsSync26, lstatSync as lstatSync7, rmSync as rmSync8 } from "node:fs";
-import { join as join31 } from "node:path";
+import { existsSync as existsSync29, lstatSync as lstatSync7, rmSync as rmSync8 } from "node:fs";
+import { join as join34 } from "node:path";
 function emitAutoMove(onPreview, linkPath, ts, name) {
   if (onPreview) {
     onPreview({ kind: "auto-move", from: linkPath, to: `backup/${ts}/${name}` });
@@ -3264,11 +3604,11 @@ function applySharedLinks(ts, map, opts = {}) {
   const dryRun = opts.dryRun === true;
   const linkNames = allSharedLinks(map);
   for (const name of linkNames) {
-    const linkPath = join31(CLAUDE_HOME, name);
-    const target = join31(REPO_HOME, "shared", name);
-    if (!existsSync26(linkPath)) continue;
+    const linkPath = join34(CLAUDE_HOME, name);
+    const target = join34(REPO_HOME, "shared", name);
+    if (!existsSync29(linkPath)) continue;
     if (lstatSync7(linkPath).isSymbolicLink()) continue;
-    if (!existsSync26(target)) continue;
+    if (!existsSync29(target)) continue;
     if (dryRun) {
       emitAutoMove(opts.onPreview, linkPath, ts, name);
       continue;
@@ -3277,28 +3617,28 @@ function applySharedLinks(ts, map, opts = {}) {
     rmSync8(linkPath, { recursive: true, force: true });
   }
   for (const name of linkNames) {
-    const target = join31(REPO_HOME, "shared", name);
-    if (!existsSync26(target)) continue;
+    const target = join34(REPO_HOME, "shared", name);
+    if (!existsSync29(target)) continue;
     if (dryRun) {
-      emitCreate(opts.onPreview, join31(CLAUDE_HOME, name), target);
+      emitCreate(opts.onPreview, join34(CLAUDE_HOME, name), target);
       continue;
     }
-    ensureSymlink(join31(CLAUDE_HOME, name), target);
+    ensureSymlink(join34(CLAUDE_HOME, name), target);
   }
 }
 function regenerateSettings(ts, opts = {}) {
   const dryRun = opts.dryRun === true;
-  const basePath = join31(REPO_HOME, "shared", "settings.base.json");
-  const hostPath = join31(REPO_HOME, "hosts", `${HOST}.json`);
-  if (!existsSync26(basePath)) {
+  const basePath = join34(REPO_HOME, "shared", "settings.base.json");
+  const hostPath = join34(REPO_HOME, "hosts", `${HOST}.json`);
+  if (!existsSync29(basePath)) {
     die("repo not initialized; run 'nomad init' to scaffold");
   }
   const base = readJson(basePath);
-  const hasOverrides = existsSync26(hostPath);
+  const hasOverrides = existsSync29(hostPath);
   const overrides = hasOverrides ? readJson(hostPath) : {};
   const merged = deepMerge(base, overrides);
-  const settingsPath = join31(CLAUDE_HOME, "settings.json");
-  if (!hasOverrides && existsSync26(settingsPath)) {
+  const settingsPath = join34(CLAUDE_HOME, "settings.json");
+  if (!hasOverrides && existsSync29(settingsPath)) {
     try {
       const existing = readJson(settingsPath);
       const baseKeys = new Set(Object.keys(base));
@@ -3324,8 +3664,8 @@ function regenerateSettings(ts, opts = {}) {
 
 // src/preview.ts
 init_config();
-import { existsSync as existsSync27 } from "node:fs";
-import { join as join32 } from "node:path";
+import { existsSync as existsSync30 } from "node:fs";
+import { join as join35 } from "node:path";
 
 // node_modules/diff/libesm/diff/base.js
 var Diff = class {
@@ -3600,6 +3940,7 @@ function diffLinesToUnified(oldStr, newStr) {
 
 // src/preview.ts
 init_utils_json();
+var CANONICAL_ORDER_NOTE = "settings.json will be rewritten in canonical key order; no value changes";
 function diffJsonStrings(currentJsonText, newJsonText) {
   if (currentJsonText === newJsonText) return "";
   const lines = [
@@ -3610,7 +3951,7 @@ function diffJsonStrings(currentJsonText, newJsonText) {
   return lines.join("\n");
 }
 function readJsonOrNull(path) {
-  if (!existsSync27(path)) return null;
+  if (!existsSync30(path)) return null;
   try {
     return readJson(path);
   } catch {
@@ -3624,18 +3965,20 @@ function previewSettings(basePath, hostPath, settingsPath) {
   }
   const notes = [];
   const hostOverrides = readJsonOrNull(hostPath);
-  if (hostOverrides === null && existsSync27(hostPath)) {
+  if (hostOverrides === null && existsSync30(hostPath)) {
     notes.push(`malformed hosts/${HOST}.json; ignoring overrides`);
   }
   const merged = deepMerge(base, hostOverrides ?? {});
   const current = readJsonOrNull(settingsPath);
-  if (current === null && existsSync27(settingsPath)) {
+  if (current === null && existsSync30(settingsPath)) {
     return { diff: "", notes: [...notes, "malformed; skipping diff"] };
   }
+  const rawEqual = JSON.stringify(current ?? {}, null, 2) === JSON.stringify(merged, null, 2);
   const diff = diffJsonStrings(
-    JSON.stringify(current ?? {}, null, 2),
-    JSON.stringify(merged, null, 2)
+    JSON.stringify(sortKeysDeep(current ?? {}), null, 2),
+    JSON.stringify(sortKeysDeep(merged), null, 2)
   );
+  if (diff === "" && !rawEqual) notes.push(CANONICAL_ORDER_NOTE);
   return { diff, notes };
 }
 function formatLinkRow(e) {
@@ -3665,9 +4008,9 @@ function computePreview(ts, map, verb = "pull") {
     onPreview: (e) => addItem(links, formatLinkRow(e))
   });
   const settingsResult = previewSettings(
-    join32(REPO_HOME, "shared", "settings.base.json"),
-    join32(REPO_HOME, "hosts", `${HOST}.json`),
-    join32(CLAUDE_HOME, "settings.json")
+    join35(REPO_HOME, "shared", "settings.base.json"),
+    join35(REPO_HOME, "hosts", `${HOST}.json`),
+    join35(CLAUDE_HOME, "settings.json")
   );
   const settingsSection = buildSettingsSectionForPreview(settingsResult);
   const sessions = section("Sessions");
@@ -3683,21 +4026,21 @@ function computePreview(ts, map, verb = "pull") {
 
 // src/spinner.ts
 init_color();
-import { existsSync as existsSync29 } from "node:fs";
+import { existsSync as existsSync32 } from "node:fs";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { Worker } from "node:worker_threads";
 
 // src/commands.push.recovery.ts
 init_config();
-import { readFileSync as readFileSync10, rmSync as rmSync10, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join35 } from "node:path";
+import { readFileSync as readFileSync11, rmSync as rmSync10, writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join38 } from "node:path";
 import { createInterface } from "node:readline/promises";
 
 // src/commands.push.recovery.redact.ts
 init_config();
 init_config_sharedDirs_guard();
-import { cpSync as cpSync5, existsSync as existsSync28, mkdirSync as mkdirSync7, statSync as statSync8 } from "node:fs";
-import { dirname as dirname5, join as join33, sep as sep2 } from "node:path";
+import { cpSync as cpSync5, existsSync as existsSync31, mkdirSync as mkdirSync7, statSync as statSync8 } from "node:fs";
+import { dirname as dirname6, join as join36, sep as sep2 } from "node:path";
 init_push_gitleaks_scan();
 init_utils_json();
 init_utils();
@@ -3728,8 +4071,8 @@ function resolveStagedDir(localPath, map) {
     assertSafeLogical(logical);
     const abs = hostMap[HOST];
     if (abs === void 0) continue;
-    if (localPath.startsWith(join33(CLAUDE_HOME, "projects", encodePath(abs)) + sep2)) {
-      return join33(REPO_HOME, "shared", "projects", logical);
+    if (localPath.startsWith(join36(CLAUDE_HOME, "projects", encodePath(abs)) + sep2)) {
+      return join36(REPO_HOME, "shared", "projects", logical);
     }
   }
   return null;
@@ -3751,7 +4094,7 @@ function applyRedact(f, ts, map, nowMs, scan = scanFile) {
       `could not locate the local transcript for session ${sid}; choose Skip or Drop session.`
     );
   }
-  const sessionDir = join33(dirname5(localPath), sid);
+  const sessionDir = join36(dirname6(localPath), sid);
   const subtreeFiles = listSubtreeFiles(sessionDir);
   const subtreeMtime = newestSubtreeMtimeMs(localPath, subtreeFiles, (p) => statSync8(p).mtimeMs);
   if (isRecentlyModified(subtreeMtime, nowMs())) {
@@ -3785,9 +4128,9 @@ function applyRedact(f, ts, map, nowMs, scan = scanFile) {
     );
   }
   mkdirSync7(stagedProjectDir, { recursive: true });
-  cpSync5(localPath, join33(stagedProjectDir, `${sid}.jsonl`), { force: true });
-  if (existsSync28(sessionDir)) {
-    cpSync5(sessionDir, join33(stagedProjectDir, sid), { force: true, recursive: true });
+  cpSync5(localPath, join36(stagedProjectDir, `${sid}.jsonl`), { force: true });
+  if (existsSync31(sessionDir)) {
+    cpSync5(sessionDir, join36(stagedProjectDir, sid), { force: true, recursive: true });
   }
   return true;
 }
@@ -3795,13 +4138,13 @@ function applyRedact(f, ts, map, nowMs, scan = scanFile) {
 // src/commands.push.recovery.drop.ts
 init_config();
 import { rmSync as rmSync9 } from "node:fs";
-import { join as join34 } from "node:path";
+import { join as join37 } from "node:path";
 function dropSessionFromStaged(sid, map) {
   const logicals = Object.keys(map.projects);
   if (logicals.length === 0) return false;
   for (const logical of logicals) {
-    const jsonl = join34(REPO_HOME, "shared", "projects", logical, `${sid}.jsonl`);
-    const dir = join34(REPO_HOME, "shared", "projects", logical, sid);
+    const jsonl = join37(REPO_HOME, "shared", "projects", logical, `${sid}.jsonl`);
+    const dir = join37(REPO_HOME, "shared", "projects", logical, sid);
     rmSync9(jsonl, { force: true });
     rmSync9(dir, { recursive: true, force: true });
   }
@@ -3919,10 +4262,10 @@ function applyThenRescan(scanVerdict, repoHome) {
   return next;
 }
 function allowThenRescan(append, scanVerdict, repoHome) {
-  const ignPath = join35(repoHome, ".gitleaksignore");
+  const ignPath = join38(repoHome, ".gitleaksignore");
   let before;
   try {
-    before = readFileSync10(ignPath, "utf8");
+    before = readFileSync11(ignPath, "utf8");
   } catch {
     before = null;
   }
@@ -4017,7 +4360,7 @@ function writeAnimatedDone(out, label, ms, useTTY) {
 `);
 }
 function resolveWorkerPath(deps = {}) {
-  const check = deps.existsSyncFn ?? existsSync29;
+  const check = deps.existsSyncFn ?? existsSync32;
   const base = deps.baseUrl ?? import.meta.url;
   const mjs = fileURLToPath4(new URL("./nomad.worker.mjs", base));
   if (check(mjs)) return mjs;
@@ -4081,6 +4424,112 @@ function withSpinner(label, fn, deps) {
   }
 }
 
+// src/commands.pull.recovery.ts
+init_config();
+import { execFileSync as execFileSync14 } from "node:child_process";
+init_utils();
+init_utils_fs();
+function gitCapture(args, cwd) {
+  return execFileSync14("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
+}
+function isSyncedConfig(path) {
+  return PUSH_ALLOWED_STATIC.some(
+    (entry) => entry.endsWith("/") ? path.startsWith(entry) : path === entry
+  );
+}
+function classifyTouched(touched) {
+  const synced = [];
+  const toolSource = [];
+  for (const p of touched) {
+    if (isSyncedConfig(p)) {
+      synced.push(p);
+    } else {
+      toolSource.push(p);
+    }
+  }
+  return { synced, toolSource };
+}
+function parsePorcelainZ(raw) {
+  const tracked = [];
+  const untracked = [];
+  if (!raw) return { tracked, untracked };
+  const records = raw.split("\0");
+  for (let i = 0; i < records.length; i++) {
+    const record = records[i];
+    if (record.length < 3) continue;
+    const xy = record.slice(0, 2);
+    const filePath = record.slice(3);
+    if (xy === "??") {
+      untracked.push(filePath);
+      continue;
+    }
+    tracked.push(filePath);
+    if (xy.startsWith("R") || xy.startsWith("C")) {
+      const src = records[i + 1];
+      if (src) {
+        tracked.push(src);
+        i++;
+      }
+    }
+  }
+  return { tracked, untracked };
+}
+function parseDirtyPaths(repo) {
+  return parsePorcelainZ(gitStatusPorcelainZ(repo));
+}
+function buildRecoverySummary(branchName, strandedLog, untracked) {
+  const strandedLines = strandedLog.split("\n").filter(Boolean).map((l) => `  ${l}`).join("\n");
+  const parts = [`parked stranded commits on ${branchName}`];
+  if (strandedLines) parts.push(`stranded:
+${strandedLines}`);
+  if (untracked.length > 0) parts.push(`untracked files preserved: ${untracked.join(", ")}`);
+  parts.push("continuing with normal pull");
+  return parts.join("; ");
+}
+function freshStrandedBranch(repo) {
+  const base = `nomad/stranded-${nowTimestamp()}`;
+  const exists = (name) => {
+    try {
+      gitCapture(["rev-parse", "--verify", "--quiet", `refs/heads/${name}`], repo);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  if (!exists(base)) return base;
+  let n = 1;
+  while (exists(`${base}-${n}`)) n++;
+  return `${base}-${n}`;
+}
+function recoverForceRemote(mode, repo) {
+  if (mode === "merge") {
+    gitOrFatal(["merge", "--abort"], "git merge --abort", repo);
+  } else {
+    gitOrFatal(["rebase", "--abort"], "git rebase --abort", repo);
+  }
+  gitOrFatal(["fetch", "origin", "main"], "git fetch origin main", repo);
+  try {
+    gitCapture(["rev-parse", "--verify", "origin/main"], repo);
+  } catch {
+    die("origin/main not found after fetch; check your remote configuration");
+  }
+  const committedRaw = gitCapture(["diff", "--name-only", "-z", "origin/main", "HEAD"], repo);
+  const committedTouched = committedRaw.split("\0").filter(Boolean);
+  const { tracked: dirtyTracked, untracked } = parseDirtyPaths(repo);
+  const allTouched = [...committedTouched, ...dirtyTracked];
+  const { synced } = classifyTouched(allTouched);
+  if (synced.length > 0) {
+    die(
+      "force-remote refused: stranded or dirty tracked changes touch synced config.\nAt-risk paths:\n" + synced.map((p) => `  ${p}`).join("\n") + "\nCopy or cherry-pick those changes out before retrying."
+    );
+  }
+  const branchName = freshStrandedBranch(repo);
+  gitOrFatal(["branch", branchName, "HEAD"], "park stranded commits", repo);
+  gitOrFatal(["reset", "--hard", "origin/main"], "reset to origin/main", repo);
+  const strandedLog = gitCapture(["log", "--oneline", `origin/main..${branchName}`], repo);
+  log(buildRecoverySummary(branchName, strandedLog, untracked));
+}
+
 // src/commands.pull.ts
 init_utils();
 init_utils_fs();
@@ -4102,18 +4551,32 @@ function applyWetPull(ts, map) {
     summary
   ]);
 }
+function handleWedge(repo, forceRemote) {
+  const wedge = detectWedge(repo);
+  if (wedge === null) return;
+  if (forceRemote) {
+    recoverForceRemote(wedge, repo);
+    return;
+  }
+  const state = wedge === "rebase" ? "mid-rebase" : "mid-merge";
+  die(
+    `repo is ${state} from a previous failed pull; run 'nomad pull --force-remote' to auto-recover, or resolve manually (see FAQ: "Every pull fails with unmerged files")`
+  );
+}
 function cmdPull(opts = {}) {
   const dryRun = opts.dryRun === true;
-  if (!existsSync30(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
-  if (!existsSync30(join36(REPO_HOME, "shared", "settings.base.json"))) {
+  const forceRemote = opts.forceRemote === true;
+  if (!existsSync33(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+  if (!existsSync33(join39(REPO_HOME, "shared", "settings.base.json"))) {
     die("repo not initialized; run 'nomad init' to scaffold");
   }
   const handle = acquireLock("pull");
   if (handle === null) process.exit(0);
   try {
     const ts = freshBackupTs(BACKUP_BASE);
+    handleWedge(REPO_HOME, forceRemote);
     if (!dryRun) {
-      const backupRoot = join36(BACKUP_BASE, ts);
+      const backupRoot = join39(BACKUP_BASE, ts);
       try {
         mkdirSync8(backupRoot, { recursive: true });
       } catch (err) {
@@ -4124,8 +4587,8 @@ function cmdPull(opts = {}) {
       dryRun ? `pulling on host=${HOST} (backup=${ts}; dry-run)` : `pull on host=${HOST} (backup=${ts})`
     );
     gitOrFatal(["pull", "--rebase", "--autostash"], "git pull --rebase", REPO_HOME);
-    const mapPath = join36(REPO_HOME, "path-map.json");
-    const map = existsSync30(mapPath) ? readPathMap(mapPath) : { projects: {} };
+    const mapPath = join39(REPO_HOME, "path-map.json");
+    const map = existsSync33(mapPath) ? readPathMap(mapPath) : { projects: {} };
     divergenceCheckExtras(ts);
     if (dryRun) {
       computePreview(ts, map, "pull");
@@ -4147,8 +4610,8 @@ function cmdPull(opts = {}) {
 
 // src/commands.push.ts
 init_config();
-import { existsSync as existsSync32 } from "node:fs";
-import { join as join38, relative as relative5 } from "node:path";
+import { existsSync as existsSync35 } from "node:fs";
+import { join as join41, relative as relative5 } from "node:path";
 
 // src/commands.push.allowlist.ts
 init_config();
@@ -4172,7 +4635,7 @@ function isNeverSync(path) {
   }
   return false;
 }
-function parsePorcelainZ(statusPorcelain) {
+function parsePorcelainZ2(statusPorcelain) {
   const records = statusPorcelain.split("\0");
   const paths = [];
   for (let i = 0; i < records.length; i++) {
@@ -4202,7 +4665,7 @@ function enforceAllowList(statusPorcelain, map) {
   ];
   const neverSyncHits = [];
   const violations = [];
-  for (const path of parsePorcelainZ(statusPorcelain)) {
+  for (const path of parsePorcelainZ2(statusPorcelain)) {
     if (isNeverSync(path)) {
       neverSyncHits.push(path);
     } else if (!isAllowed(path, allowed)) {
@@ -4228,9 +4691,9 @@ init_color();
 init_config();
 init_config_sharedDirs_guard();
 import { randomBytes as randomBytes2 } from "node:crypto";
-import { copyFileSync, existsSync as existsSync31, mkdirSync as mkdirSync9, readdirSync as readdirSync10, rmSync as rmSync11 } from "node:fs";
+import { copyFileSync, existsSync as existsSync34, mkdirSync as mkdirSync9, readdirSync as readdirSync11, rmSync as rmSync11 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join37 } from "node:path";
+import { join as join40 } from "node:path";
 init_push_leak_verdict();
 init_push_gitleaks();
 init_utils_fs();
@@ -4245,13 +4708,13 @@ function stageSessions(tmpRoot, map) {
     if (!p || p === "TBD") continue;
     reverse.set(encodePath(p), logical);
   }
-  const localProjects = join37(CLAUDE_HOME, "projects");
-  if (!existsSync31(localProjects)) return 0;
+  const localProjects = join40(CLAUDE_HOME, "projects");
+  if (!existsSync34(localProjects)) return 0;
   let staged = 0;
-  for (const dir of readdirSync10(localProjects)) {
+  for (const dir of readdirSync11(localProjects)) {
     const logical = reverse.get(dir);
     if (!logical) continue;
-    copyDirJsonlOnly(join37(localProjects, dir), join37(tmpRoot, "shared", "projects", logical));
+    copyDirJsonlOnly(join40(localProjects, dir), join40(tmpRoot, "shared", "projects", logical));
     staged++;
   }
   return staged;
@@ -4265,11 +4728,11 @@ function stageExtras(tmpRoot, map) {
     assertSafeLogical(logical);
     const localRoot = map.projects[logical]?.[HOST];
     if (!localRoot || localRoot === "TBD") continue;
-    for (const dirname6 of dirnames) {
-      if (!whitelist.includes(dirname6)) continue;
-      const src = join37(localRoot, dirname6);
-      if (!existsSync31(src)) continue;
-      const dst = join37(tmpRoot, "shared", "extras", logical, dirname6);
+    for (const dirname7 of dirnames) {
+      if (!whitelist.includes(dirname7)) continue;
+      const src = join40(localRoot, dirname7);
+      if (!existsSync34(src)) continue;
+      const dst = join40(tmpRoot, "shared", "extras", logical, dirname7);
       copyExtras(src, dst);
       staged++;
     }
@@ -4277,19 +4740,19 @@ function stageExtras(tmpRoot, map) {
   return staged;
 }
 function previewPushLeaks(map) {
-  const cacheDir = join37(homedir5(), ".cache", "claude-nomad");
+  const cacheDir = join40(homedir5(), ".cache", "claude-nomad");
   mkdirSync9(cacheDir, { recursive: true });
   const stamp = `${nowTimestamp()}-${process.pid}-${randomBytes2(4).toString("hex")}`;
-  const tmpRoot = join37(cacheDir, `push-preview-tree-${stamp}`);
+  const tmpRoot = join40(cacheDir, `push-preview-tree-${stamp}`);
   try {
     const sessionCount = stageSessions(tmpRoot, map);
     const extrasCount = stageExtras(tmpRoot, map);
     if (sessionCount + extrasCount === 0) {
       return { leak: false, verdictRow: NOTHING_TO_SCAN_ROW, recovery: null, findings: [] };
     }
-    const ignoreFile = join37(REPO_HOME, ".gitleaksignore");
-    if (existsSync31(ignoreFile)) {
-      copyFileSync(ignoreFile, join37(tmpRoot, ".gitleaksignore"));
+    const ignoreFile = join40(REPO_HOME, ".gitleaksignore");
+    if (existsSync34(ignoreFile)) {
+      copyFileSync(ignoreFile, join40(tmpRoot, ".gitleaksignore"));
     }
     let findings;
     try {
@@ -4311,7 +4774,7 @@ init_utils();
 init_utils_fs();
 init_utils_json();
 function guardGitlinks() {
-  const gitlinks = findGitlinks(join38(REPO_HOME, "shared"));
+  const gitlinks = findGitlinks(join41(REPO_HOME, "shared"));
   if (gitlinks.length === 0) return;
   for (const p of gitlinks) {
     const rel = relative5(REPO_HOME, p);
@@ -4363,7 +4826,7 @@ async function cmdPush(opts = {}) {
   const allowAll = opts.allowAll === true;
   const allowRule = opts.allowRule;
   guardResolutionModeConflicts(dryRun, redactAll, allowAll, allowRule);
-  if (!existsSync32(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+  if (!existsSync35(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
   const handle = acquireLock("push");
   if (handle === null) process.exit(0);
   try {
@@ -4381,8 +4844,8 @@ async function cmdPush(opts = {}) {
       renderNoScanTree(st);
       return;
     }
-    const mapPath = join38(REPO_HOME, "path-map.json");
-    if (!existsSync32(mapPath)) {
+    const mapPath = join41(REPO_HOME, "path-map.json");
+    if (!existsSync35(mapPath)) {
       if (dryRun) return runDryRunPreview(st, null);
       die("path-map.json missing, cannot enforce push allow-list");
     }
@@ -4403,9 +4866,9 @@ async function cmdPush(opts = {}) {
 }
 
 // src/commands.update.ts
-import { execFileSync as execFileSync14 } from "node:child_process";
+import { execFileSync as execFileSync15 } from "node:child_process";
 init_utils();
-function cmdUpdate(run = execFileSync14) {
+function cmdUpdate(run = execFileSync15) {
   try {
     run("npm", ["update", "-g", "claude-nomad"], { stdio: "inherit" });
   } catch (err) {
@@ -4422,17 +4885,17 @@ init_config();
 
 // src/diff.ts
 init_config();
-import { existsSync as existsSync33 } from "node:fs";
-import { join as join39 } from "node:path";
+import { existsSync as existsSync36 } from "node:fs";
+import { join as join42 } from "node:path";
 init_utils();
 init_utils_fs();
 init_utils_json();
 function cmdDiff() {
   try {
-    if (!existsSync33(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+    if (!existsSync36(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
     const ts = freshBackupTs(BACKUP_BASE);
-    const mapPath = join39(REPO_HOME, "path-map.json");
-    const map = existsSync33(mapPath) ? readPathMap(mapPath) : { projects: {} };
+    const mapPath = join42(REPO_HOME, "path-map.json");
+    const map = existsSync36(mapPath) ? readPathMap(mapPath) : { projects: {} };
     computePreview(ts, map, "diff");
   } catch (err) {
     if (err instanceof NomadFatal) {
@@ -4446,19 +4909,19 @@ function cmdDiff() {
 
 // src/init.ts
 init_config();
-import { existsSync as existsSync35, mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join41 } from "node:path";
+import { existsSync as existsSync38, mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join44 } from "node:path";
 
 // src/init.gh-onboard.ts
 init_config();
-import { execFileSync as execFileSync15 } from "node:child_process";
+import { execFileSync as execFileSync16 } from "node:child_process";
 init_utils();
 var DEFAULT_REPO_NAME = "claude-nomad-config";
 function isValidRepoName(name) {
   return /^[A-Za-z0-9._-]{1,100}$/.test(name);
 }
 var GH_NETWORK_TIMEOUT_MS = 3e4;
-function ensureOriginRepo(repoName, run = execFileSync15) {
+function ensureOriginRepo(repoName, run = execFileSync16) {
   if (!isValidRepoName(repoName)) {
     die(
       `invalid repo name: ${JSON.stringify(repoName)}. Use only letters, digits, hyphens, underscores, and dots (1-100 chars).`
@@ -4528,31 +4991,31 @@ init_config();
 init_utils();
 init_utils_fs();
 init_utils_json();
-import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync34, rmSync as rmSync12, statSync as statSync9 } from "node:fs";
-import { join as join40 } from "node:path";
+import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync37, rmSync as rmSync12, statSync as statSync9 } from "node:fs";
+import { join as join43 } from "node:path";
 function snapshotIntoShared(map) {
   for (const name of allSharedLinks(map)) {
-    const src = join40(CLAUDE_HOME, name);
-    if (!existsSync34(src)) continue;
-    const dst = join40(REPO_HOME, "shared", name);
+    const src = join43(CLAUDE_HOME, name);
+    if (!existsSync37(src)) continue;
+    const dst = join43(REPO_HOME, "shared", name);
     if (statSync9(src).isDirectory()) {
-      const gk = join40(dst, ".gitkeep");
-      if (existsSync34(gk)) rmSync12(gk);
+      const gk = join43(dst, ".gitkeep");
+      if (existsSync37(gk)) rmSync12(gk);
       cpSync6(src, dst, { recursive: true, force: false, errorOnExist: true });
     } else {
       copyFileSync2(src, dst);
     }
     log(`snapshotted shared/${name} from ${src}`);
   }
-  const userSettings = join40(CLAUDE_HOME, "settings.json");
-  if (existsSync34(userSettings)) {
+  const userSettings = join43(CLAUDE_HOME, "settings.json");
+  if (existsSync37(userSettings)) {
     let parsed;
     try {
       parsed = readJson(userSettings);
     } catch (err) {
       return die(`malformed ${userSettings}: ${err.message}`);
     }
-    const hostFile = join40(REPO_HOME, "hosts", `${HOST}.json`);
+    const hostFile = join43(REPO_HOME, "hosts", `${HOST}.json`);
     writeJsonAtomic(hostFile, parsed);
     log(`snapshotted hosts/${HOST}.json from ${userSettings}`);
   }
@@ -4565,14 +5028,14 @@ var SHARED_CLAUDE_MD = "<!-- claude-nomad shared CLAUDE.md; symlinked into ~/.cl
 var SHARED_KEEP_DIRS = ["agents", "skills", "commands", "rules", "hooks"];
 function preflightConflict(repoHome) {
   const candidates = [
-    join41(repoHome, "shared", "settings.base.json"),
-    join41(repoHome, "shared", "CLAUDE.md"),
-    join41(repoHome, "path-map.json"),
-    join41(repoHome, "hosts"),
-    join41(repoHome, "shared")
+    join44(repoHome, "shared", "settings.base.json"),
+    join44(repoHome, "shared", "CLAUDE.md"),
+    join44(repoHome, "path-map.json"),
+    join44(repoHome, "hosts"),
+    join44(repoHome, "shared")
   ];
   for (const c of candidates) {
-    if (existsSync35(c)) return c;
+    if (existsSync38(c)) return c;
   }
   return null;
 }
@@ -4585,25 +5048,25 @@ function cmdInit(opts = {}) {
     die(`already initialized; refusing to clobber ${conflict}`);
   }
   ensureOriginRepo(opts.repoName ?? DEFAULT_REPO_NAME, opts.run);
-  mkdirSync10(join41(REPO_HOME, "shared"), { recursive: true });
-  mkdirSync10(join41(REPO_HOME, "hosts"), { recursive: true });
+  mkdirSync10(join44(REPO_HOME, "shared"), { recursive: true });
+  mkdirSync10(join44(REPO_HOME, "hosts"), { recursive: true });
   for (const name of SHARED_KEEP_DIRS) {
-    mkdirSync10(join41(REPO_HOME, "shared", name), { recursive: true });
+    mkdirSync10(join44(REPO_HOME, "shared", name), { recursive: true });
   }
-  const userClaudeMd = join41(CLAUDE_HOME, "CLAUDE.md");
-  if (!snapshot || !existsSync35(userClaudeMd)) {
-    writeFileSync6(join41(REPO_HOME, "shared", "CLAUDE.md"), SHARED_CLAUDE_MD);
+  const userClaudeMd = join44(CLAUDE_HOME, "CLAUDE.md");
+  if (!snapshot || !existsSync38(userClaudeMd)) {
+    writeFileSync6(join44(REPO_HOME, "shared", "CLAUDE.md"), SHARED_CLAUDE_MD);
     log("created shared/CLAUDE.md");
   }
   for (const name of SHARED_KEEP_DIRS) {
-    writeFileSync6(join41(REPO_HOME, "shared", name, ".gitkeep"), "");
+    writeFileSync6(join44(REPO_HOME, "shared", name, ".gitkeep"), "");
     log(`created shared/${name}/.gitkeep`);
   }
-  writeFileSync6(join41(REPO_HOME, "hosts", ".gitkeep"), "");
+  writeFileSync6(join44(REPO_HOME, "hosts", ".gitkeep"), "");
   log("created hosts/.gitkeep");
-  writeJsonAtomic(join41(REPO_HOME, "shared", "settings.base.json"), {});
+  writeJsonAtomic(join44(REPO_HOME, "shared", "settings.base.json"), {});
   log("created shared/settings.base.json");
-  writeJsonAtomic(join41(REPO_HOME, "path-map.json"), { projects: {} });
+  writeJsonAtomic(join44(REPO_HOME, "path-map.json"), { projects: {} });
   log("created path-map.json");
   if (snapshot) {
     snapshotIntoShared({ projects: {} });
@@ -4807,6 +5270,28 @@ function parseAllowArgs(argv) {
   return positionals;
 }
 
+// src/nomad.dispatch.pull.ts
+function parsePullArgs(argv) {
+  let dryRun = false;
+  let forceRemote = false;
+  let i = 3;
+  while (i < argv.length) {
+    const token = argv[i];
+    if (token === "--dry-run") {
+      if (dryRun) return null;
+      dryRun = true;
+    } else if (token === "--force-remote") {
+      if (forceRemote) return null;
+      forceRemote = true;
+    } else {
+      return null;
+    }
+    i++;
+  }
+  if (dryRun && forceRemote) return null;
+  return { dryRun, forceRemote };
+}
+
 // src/nomad.dispatch.push.ts
 var REJECT2 = { ok: false, advance: 0 };
 function applyBool2(seen, set) {
@@ -4865,7 +5350,7 @@ function parsePushArgs(argv) {
 // package.json
 var package_default = {
   name: "claude-nomad",
-  version: "0.41.0",
+  version: "0.43.0",
   type: "module",
   description: "Sync Claude Code config (~/.claude/) across machines via a private Git repo, with path remapping and per-host settings overrides.",
   keywords: [
@@ -4963,6 +5448,11 @@ var DEFAULT_HELP = [
   "Commands:",
   row("  pull", "Sync ~/.claude/ from the shared repo (settings, symlinks, sessions)."),
   row("       --dry-run", "Run lock + git pull, then preview every mutation without writing."),
+  row("       --force-remote", "Recover from a wedged repo (stuck mid-rebase or mid-merge):"),
+  cont("abort the in-progress rebase/merge, park stranded commits on"),
+  cont("nomad/stranded-<ts>, reset to origin/main, and re-pull. Refuses"),
+  cont("if stranded or dirty tracked changes touch synced config (shared/,"),
+  cont("hosts/, path-map.json). Cannot combine with --dry-run."),
   "",
   row("  push", "Rebase, run safety checks (gitleaks, gitlinks, allow-list), commit, push."),
   row("       --dry-run", "Run pre-checks (rebase, gitleaks probe, gitlink scan) and preview"),
@@ -5055,15 +5545,15 @@ var DEFAULT_HELP = [
 init_config();
 init_utils();
 init_utils_json();
-import { existsSync as existsSync36, readFileSync as readFileSync11, readdirSync as readdirSync11 } from "node:fs";
-import { join as join42 } from "node:path";
+import { existsSync as existsSync39, readFileSync as readFileSync12, readdirSync as readdirSync12 } from "node:fs";
+import { join as join45 } from "node:path";
 function resumeCmd(sessionId) {
   if (!/^[A-Za-z0-9_-]+$/.test(sessionId) || sessionId.length > 128) {
     fail(`invalid session id: ${sessionId}`);
     process.exit(1);
   }
-  const projectsRoot = join42(CLAUDE_HOME, "projects");
-  if (!existsSync36(projectsRoot)) {
+  const projectsRoot = join45(CLAUDE_HOME, "projects");
+  if (!existsSync39(projectsRoot)) {
     fail(`${projectsRoot} does not exist`);
     process.exit(1);
   }
@@ -5077,8 +5567,8 @@ function resumeCmd(sessionId) {
     fail(`no cwd field found in ${jsonlPath}`);
     process.exit(1);
   }
-  const mapPath = join42(REPO_HOME, "path-map.json");
-  if (!existsSync36(mapPath)) {
+  const mapPath = join45(REPO_HOME, "path-map.json");
+  if (!existsSync39(mapPath)) {
     fail("path-map.json missing");
     process.exit(1);
   }
@@ -5100,14 +5590,14 @@ function resumeCmd(sessionId) {
   console.log(`cd ${shQuote(hit.localPath)} && claude --resume ${shQuote(sessionId)}`);
 }
 function findTranscriptPath(projectsRoot, sessionId) {
-  for (const dir of readdirSync11(projectsRoot)) {
-    const candidate = join42(projectsRoot, dir, `${sessionId}.jsonl`);
-    if (existsSync36(candidate)) return candidate;
+  for (const dir of readdirSync12(projectsRoot)) {
+    const candidate = join45(projectsRoot, dir, `${sessionId}.jsonl`);
+    if (existsSync39(candidate)) return candidate;
   }
   return null;
 }
 function extractRecordedCwd(jsonlPath) {
-  for (const line of readFileSync11(jsonlPath, "utf8").split("\n")) {
+  for (const line of readFileSync12(jsonlPath, "utf8").split("\n")) {
     if (!line.trim()) continue;
     try {
       const obj = JSON.parse(line);
@@ -5174,15 +5664,12 @@ try {
       console.log(package_default.version);
       break;
     case "pull": {
-      const sub = process.argv[3];
-      if (sub === void 0) {
-        cmdPull();
-      } else if (sub === "--dry-run" && process.argv.length === 4) {
-        cmdPull({ dryRun: true });
-      } else {
-        console.error("usage: nomad pull [--dry-run]");
+      const pullArgs = parsePullArgs(process.argv);
+      if (pullArgs === null) {
+        console.error("usage: nomad pull [--dry-run] [--force-remote]");
         process.exit(1);
       }
+      cmdPull({ dryRun: pullArgs.dryRun, forceRemote: pullArgs.forceRemote });
       break;
     }
     case "push": {