claude-nomad 0.38.1 → 0.40.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.40.0](https://github.com/funkadelic/claude-nomad/compare/v0.39.0...v0.40.0) (2026-06-03)
+
+
+### Added
+
+* **spinner:** animate long-running operations ([#233](https://github.com/funkadelic/claude-nomad/issues/233)) ([e6755c3](https://github.com/funkadelic/claude-nomad/commit/e6755c3e5e86b52cbc5f996e9c5aee9d79da4574))
+
+
+### Changed
+
+* **docs-site:** build gate, link validation, and page metadata ([#231](https://github.com/funkadelic/claude-nomad/issues/231)) ([d4ad8ec](https://github.com/funkadelic/claude-nomad/commit/d4ad8ec0c414a91153a584156ccee2b32d824360))
+
+## [0.39.0](https://github.com/funkadelic/claude-nomad/compare/v0.38.1...v0.39.0) (2026-06-02)
+
+
+### Added
+
+* **doctor:** group version checks into Nomad + Dependency sections ([#228](https://github.com/funkadelic/claude-nomad/issues/228)) ([08e8bf7](https://github.com/funkadelic/claude-nomad/commit/08e8bf79a730f1e7f025a1c2ad9dd406f586b05e))
+
+
+### Documentation
+
+* **how-it-works:** render repo-layout trees with FileTree ([#229](https://github.com/funkadelic/claude-nomad/issues/229)) ([b52de15](https://github.com/funkadelic/claude-nomad/commit/b52de152416ac5dabb650a1970b53a3b45262396))
+
 ## [0.38.1](https://github.com/funkadelic/claude-nomad/compare/v0.38.0...v0.38.1) (2026-06-02)
 
 

package/README.md

@@ -57,6 +57,11 @@ $ nomad pull     # apply config to ~/.claude/
 $ nomad push     # publish local changes (sessions, settings)
 ```
 
+During `nomad push` and `nomad pull`, long-running steps (rebase, secret scan, git push, session
+sync) show an animated progress indicator on an interactive terminal so the CLI does not look hung.
+In CI and when output is piped, only plain text lines are printed, with no ANSI control codes, so
+log output remains grep-stable.
+
 When `nomad push` detects a potential secret, it drops into an interactive menu (TTY) or aborts with
 a recovery hint (non-TTY/CI). Three non-interactive recovery paths are available without the menu:
 

package/dist/nomad.mjs

@@ -2342,7 +2342,7 @@ init_color();
 import { execFileSync as execFileSync8 } from "node:child_process";
 var VERSION_TOKEN = /(\d{1,9}\.\d{1,9}\.\d{1,9})/;
 var PROBE_TIMEOUT_MS = 3e3;
-var FETCHER_LABEL = "HTTP fetcher (curl or wget)";
+var FETCHER_BASE = "HTTP fetcher";
 function parseFirstVersion(line) {
   const m = VERSION_TOKEN.exec(line);
   return m ? m[1] : null;
@@ -2366,13 +2366,13 @@ function reportFetcherRow(section2, run) {
   const curl = probeOptionalDep("curl", run);
   const wget = probeOptionalDep("wget", run);
   if (curl.status === "present") {
-    addItem(section2, `${green(okGlyph)} ${FETCHER_LABEL}: ${curl.version ?? "present"}`);
+    addItem(section2, `${green(okGlyph)} ${FETCHER_BASE}: curl ${curl.version ?? "(present)"}`);
   } else if (wget.status === "present") {
-    addItem(section2, `${green(okGlyph)} ${FETCHER_LABEL}: ${wget.version ?? "present"}`);
+    addItem(section2, `${green(okGlyph)} ${FETCHER_BASE}: wget ${wget.version ?? "(present)"}`);
   } else {
     addItem(
       section2,
-      `${yellow(warnGlyph)} ${FETCHER_LABEL}: not installed (optional; needed for release-version staleness check + nomad doctor --check-schema)`
+      `${yellow(warnGlyph)} ${FETCHER_BASE} (curl or wget): not installed (optional; needed for release-version staleness check + nomad doctor --check-schema)`
     );
   }
 }
@@ -2513,18 +2513,20 @@ function cmdDoctor(opts = {}) {
   reportRemote(repository);
   reportRebaseClean(repository);
   reportActionsDrift(repository);
-  const version = section("Version Checks");
-  reportVersionCheck(version);
-  reportNodeEngineCheck(version);
-  reportGitleaksVersionCheck(version);
-  reportOptionalDeps(version);
-  reportBackupsCheck(version);
+  const nomadVersion = section("Nomad Version");
+  reportVersionCheck(nomadVersion);
+  reportBackupsCheck(nomadVersion);
+  const depVersions = section("Dependency Versions");
+  reportNodeEngineCheck(depVersions);
+  reportGitleaksVersionCheck(depVersions);
+  reportOptionalDeps(depVersions);
   const sharedScan = section("Shared scan");
   if (opts.checkShared === true) reportCheckShared(sharedScan, gitleaksReady);
   const schemaScan = section("Schema scan");
   if (opts.checkSchema === true) reportCheckSchema(schemaScan);
   renderDoctor([
-    version,
+    nomadVersion,
+    depVersions,
     host,
     links,
     hooksScan,
@@ -2954,8 +2956,8 @@ ${lines}`);
 }
 
 // src/commands.pull.ts
-import { existsSync as existsSync28, mkdirSync as mkdirSync7 } from "node:fs";
-import { join as join33 } from "node:path";
+import { existsSync as existsSync30, mkdirSync as mkdirSync8 } from "node:fs";
+import { join as join36 } from "node:path";
 
 // src/commands.push.sections.ts
 init_color();
@@ -3631,156 +3633,23 @@ function computePreview(ts, map) {
   return { unmapped: remapResult.unmapped, collisions: 0 };
 }
 
-// src/commands.pull.ts
-init_utils();
-init_utils_fs();
-init_utils_json();
-function applyWetPull(ts, map) {
-  applySharedLinks(ts, map);
-  const { label } = regenerateSettings(ts);
-  const remapResult = remapPull(ts);
-  const extrasResult = remapExtrasPull(ts);
-  const summary = section("Summary");
-  addItem(
-    summary,
-    summaryRow("pull", remapResult.unmapped + extrasResult.unmapped, 0, extrasResult.skipped)
-  );
-  renderTree([
-    buildSettingsSection(label),
-    buildSessionsSection(remapResult.pulled, remapResult.unmapped),
-    buildExtrasSection(extrasResult.pulled, extrasResult.skipped),
-    summary
-  ]);
-}
-function cmdPull(opts = {}) {
-  const dryRun = opts.dryRun === true;
-  if (!existsSync28(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
-  if (!existsSync28(join33(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);
-    if (!dryRun) {
-      const backupRoot = join33(BACKUP_BASE, ts);
-      try {
-        mkdirSync7(backupRoot, { recursive: true });
-      } catch (err) {
-        die(`could not create backup dir: ${err.message}`);
-      }
-    }
-    log(
-      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 = join33(REPO_HOME, "path-map.json");
-    const map = existsSync28(mapPath) ? readPathMap(mapPath) : { projects: {} };
-    divergenceCheckExtras(ts);
-    if (dryRun) {
-      const previewResult = computePreview(ts, map);
-      log("dry-run complete; no mutation");
-      emitSummary("pull", previewResult.unmapped);
-    } else {
-      applyWetPull(ts, map);
-    }
-  } catch (err) {
-    if (err instanceof NomadFatal) {
-      fail(err.message);
-      process.exitCode = 1;
-    } else {
-      throw err;
-    }
-  } finally {
-    releaseLock(handle);
-  }
-}
-
-// src/commands.push.ts
-init_config();
-import { existsSync as existsSync31 } from "node:fs";
-import { join as join38, relative as relative5 } from "node:path";
-
-// src/commands.push.allowlist.ts
-init_config();
-init_config_sharedDirs_guard();
-init_utils();
-function isAllowed(path, allowed) {
-  for (const entry of allowed) {
-    if (path === entry) return true;
-    if (entry === "hosts/") {
-      if (/^hosts\/[^/]+\.json$/.test(path)) return true;
-      continue;
-    }
-    if (entry.endsWith("/") && path.startsWith(entry)) return true;
-  }
-  return false;
-}
-function isNeverSync(path) {
-  const blockSet = path.startsWith("shared/extras/") ? ALWAYS_NEVER_SYNC : NEVER_SYNC;
-  for (const segment of path.split("/")) {
-    if (blockSet.has(segment)) return true;
-  }
-  return false;
-}
-function parsePorcelainZ(statusPorcelain) {
-  const records = statusPorcelain.split("\0");
-  const paths = [];
-  for (let i = 0; i < records.length; i++) {
-    const rec = records[i];
-    if (rec === void 0 || rec === "") continue;
-    if (rec.length < 4) continue;
-    const xy = rec.slice(0, 2);
-    const newPath = rec.slice(3);
-    paths.push(newPath);
-    if (/[RC]/.test(xy)) {
-      const oldPath = records[i + 1];
-      if (oldPath !== void 0 && oldPath !== "") paths.push(oldPath);
-      i++;
-    }
-  }
-  return paths;
-}
-function enforceAllowList(statusPorcelain, map) {
-  const extrasWhitelist = SUPPORTED_EXTRAS;
-  const allowed = [
-    ...PUSH_ALLOWED_STATIC,
-    ...Object.keys(map.projects).map((l) => `shared/projects/${l}/`),
-    ...Object.entries(map.extras ?? {}).flatMap(
-      ([l, names]) => names.filter((n) => extrasWhitelist.includes(n)).flatMap((n) => [`shared/extras/${l}/${n}`, `shared/extras/${l}/${n}/`])
-    ),
-    ...(map.sharedDirs ?? []).filter((d) => isValidSharedDir(d)).map((d) => `shared/${d}/`)
-  ];
-  const neverSyncHits = [];
-  const violations = [];
-  for (const path of parsePorcelainZ(statusPorcelain)) {
-    if (isNeverSync(path)) {
-      neverSyncHits.push(path);
-    } else if (!isAllowed(path, allowed)) {
-      violations.push(path);
-    }
-  }
-  if (neverSyncHits.length === 0 && violations.length === 0) return;
-  for (const p of neverSyncHits) {
-    fail(`${p} is in NEVER_SYNC and must never be pushed`);
-  }
-  for (const p of violations) {
-    fail(`to sync ${p}, add to PUSH_ALLOWED in src/config.ts`);
-  }
-  throw new NomadFatal("push allow-list violations");
-}
+// src/spinner.ts
+init_color();
+import { existsSync as existsSync29 } 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 join36 } from "node:path";
+import { join as join35 } 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 existsSync29, mkdirSync as mkdirSync8, statSync as statSync8 } from "node:fs";
-import { dirname as dirname5, join as join34, sep as sep2 } from "node:path";
+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";
 init_push_gitleaks_scan();
 init_utils_json();
 init_utils();
@@ -3811,8 +3680,8 @@ function resolveStagedDir(localPath, map) {
     assertSafeLogical(logical);
     const abs = hostMap[HOST];
     if (abs === void 0) continue;
-    if (localPath.startsWith(join34(CLAUDE_HOME, "projects", encodePath(abs)) + sep2)) {
-      return join34(REPO_HOME, "shared", "projects", logical);
+    if (localPath.startsWith(join33(CLAUDE_HOME, "projects", encodePath(abs)) + sep2)) {
+      return join33(REPO_HOME, "shared", "projects", logical);
     }
   }
   return null;
@@ -3834,7 +3703,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 = join34(dirname5(localPath), sid);
+  const sessionDir = join33(dirname5(localPath), sid);
   const subtreeFiles = listSubtreeFiles(sessionDir);
   const subtreeMtime = newestSubtreeMtimeMs(localPath, subtreeFiles, (p) => statSync8(p).mtimeMs);
   if (isRecentlyModified(subtreeMtime, nowMs())) {
@@ -3867,10 +3736,10 @@ function applyRedact(f, ts, map, nowMs, scan = scanFile) {
       `nothing to redact in the local transcript for session ${sid}; choose Skip or Drop session.`
     );
   }
-  mkdirSync8(stagedProjectDir, { recursive: true });
-  cpSync5(localPath, join34(stagedProjectDir, `${sid}.jsonl`), { force: true });
-  if (existsSync29(sessionDir)) {
-    cpSync5(sessionDir, join34(stagedProjectDir, sid), { force: true, recursive: true });
+  mkdirSync7(stagedProjectDir, { recursive: true });
+  cpSync5(localPath, join33(stagedProjectDir, `${sid}.jsonl`), { force: true });
+  if (existsSync28(sessionDir)) {
+    cpSync5(sessionDir, join33(stagedProjectDir, sid), { force: true, recursive: true });
   }
   return true;
 }
@@ -3878,13 +3747,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 join35 } from "node:path";
+import { join as join34 } 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 = join35(REPO_HOME, "shared", "projects", logical, `${sid}.jsonl`);
-    const dir = join35(REPO_HOME, "shared", "projects", logical, sid);
+    const jsonl = join34(REPO_HOME, "shared", "projects", logical, `${sid}.jsonl`);
+    const dir = join34(REPO_HOME, "shared", "projects", logical, sid);
     rmSync9(jsonl, { force: true });
     rmSync9(dir, { recursive: true, force: true });
   }
@@ -4002,7 +3871,7 @@ function applyThenRescan(scanVerdict, repoHome) {
   return next;
 }
 function allowThenRescan(append, scanVerdict, repoHome) {
-  const ignPath = join36(repoHome, ".gitleaksignore");
+  const ignPath = join35(repoHome, ".gitleaksignore");
   let before;
   try {
     before = readFileSync10(ignPath, "utf8");
@@ -4081,6 +3950,225 @@ async function resolveLeakFindings(verdict, ts, map, deps = {}) {
   return current;
 }
 
+// src/spinner.ts
+function formatElapsed(ms) {
+  return `${(ms / 1e3).toFixed(1)}s`;
+}
+function writePlainStart(out, label) {
+  out.write(`${label}...
+`);
+}
+function writePlainDone(out, label, ms) {
+  out.write(`${label} done (${formatElapsed(ms)})
+`);
+}
+function writeAnimatedDone(out, label, ms, useTTY) {
+  out.write("\r\x1B[K");
+  const glyph = useTTY ? green(okGlyph) : okGlyph;
+  out.write(`${glyph} ${label} (${formatElapsed(ms)})
+`);
+}
+function resolveWorkerPath(deps = {}) {
+  const check = deps.existsSyncFn ?? existsSync29;
+  const base = deps.baseUrl ?? import.meta.url;
+  const mjs = fileURLToPath4(new URL("./nomad.worker.mjs", base));
+  if (check(mjs)) return mjs;
+  return fileURLToPath4(new URL("./spinner.worker.ts", base));
+}
+function makeRealWorker() {
+  return new Worker(resolveWorkerPath());
+}
+function startSpinner(label, deps = {}) {
+  const ttyCheck = deps.isTTYCheck ?? (() => isTTY());
+  const env = deps.env ?? process.env;
+  const out = deps.out ?? process.stderr;
+  const now = deps.now ?? Date.now;
+  const startMs = now();
+  const animate = ttyCheck() && !env.CI;
+  let worker = null;
+  let degraded = false;
+  let finalized = false;
+  if (animate) {
+    const factory = deps.makeWorker ?? makeRealWorker;
+    try {
+      worker = factory();
+      worker.unref?.();
+      worker.postMessage({ type: "start", label });
+    } catch {
+      degraded = true;
+      worker = null;
+      writePlainStart(out, label);
+    }
+  } else {
+    writePlainStart(out, label);
+  }
+  function finalize(success, doneLabel) {
+    if (finalized) return;
+    finalized = true;
+    const dl = doneLabel ?? label;
+    const elapsed = now() - startMs;
+    if (animate && !degraded && worker !== null) {
+      worker.postMessage({ type: "pause" });
+      if (success) writeAnimatedDone(out, dl, elapsed, ttyCheck());
+      else out.write("\r\x1B[K");
+      worker.terminate();
+      worker = null;
+    } else if (success) {
+      writePlainDone(out, dl, elapsed);
+    }
+  }
+  return {
+    succeed: (doneLabel) => finalize(true, doneLabel),
+    stop: () => finalize(false)
+  };
+}
+
+// src/commands.pull.ts
+init_utils();
+init_utils_fs();
+init_utils_json();
+function applyWetPull(ts, map) {
+  applySharedLinks(ts, map);
+  const { label } = regenerateSettings(ts);
+  const syncSp = startSpinner("Syncing sessions");
+  let remapResult;
+  try {
+    remapResult = remapPull(ts);
+    syncSp.succeed();
+  } finally {
+    syncSp.stop();
+  }
+  const extrasResult = remapExtrasPull(ts);
+  const summary = section("Summary");
+  addItem(
+    summary,
+    summaryRow("pull", remapResult.unmapped + extrasResult.unmapped, 0, extrasResult.skipped)
+  );
+  renderTree([
+    buildSettingsSection(label),
+    buildSessionsSection(remapResult.pulled, remapResult.unmapped),
+    buildExtrasSection(extrasResult.pulled, extrasResult.skipped),
+    summary
+  ]);
+}
+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"))) {
+    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);
+    if (!dryRun) {
+      const backupRoot = join36(BACKUP_BASE, ts);
+      try {
+        mkdirSync8(backupRoot, { recursive: true });
+      } catch (err) {
+        die(`could not create backup dir: ${err.message}`);
+      }
+    }
+    log(
+      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: {} };
+    divergenceCheckExtras(ts);
+    if (dryRun) {
+      const previewResult = computePreview(ts, map);
+      log("dry-run complete; no mutation");
+      emitSummary("pull", previewResult.unmapped);
+    } else {
+      applyWetPull(ts, map);
+    }
+  } catch (err) {
+    if (err instanceof NomadFatal) {
+      fail(err.message);
+      process.exitCode = 1;
+    } else {
+      throw err;
+    }
+  } finally {
+    releaseLock(handle);
+  }
+}
+
+// src/commands.push.ts
+init_config();
+import { existsSync as existsSync32 } from "node:fs";
+import { join as join38, relative as relative5 } from "node:path";
+
+// src/commands.push.allowlist.ts
+init_config();
+init_config_sharedDirs_guard();
+init_utils();
+function isAllowed(path, allowed) {
+  for (const entry of allowed) {
+    if (path === entry) return true;
+    if (entry === "hosts/") {
+      if (/^hosts\/[^/]+\.json$/.test(path)) return true;
+      continue;
+    }
+    if (entry.endsWith("/") && path.startsWith(entry)) return true;
+  }
+  return false;
+}
+function isNeverSync(path) {
+  const blockSet = path.startsWith("shared/extras/") ? ALWAYS_NEVER_SYNC : NEVER_SYNC;
+  for (const segment of path.split("/")) {
+    if (blockSet.has(segment)) return true;
+  }
+  return false;
+}
+function parsePorcelainZ(statusPorcelain) {
+  const records = statusPorcelain.split("\0");
+  const paths = [];
+  for (let i = 0; i < records.length; i++) {
+    const rec = records[i];
+    if (rec === void 0 || rec === "") continue;
+    if (rec.length < 4) continue;
+    const xy = rec.slice(0, 2);
+    const newPath = rec.slice(3);
+    paths.push(newPath);
+    if (/[RC]/.test(xy)) {
+      const oldPath = records[i + 1];
+      if (oldPath !== void 0 && oldPath !== "") paths.push(oldPath);
+      i++;
+    }
+  }
+  return paths;
+}
+function enforceAllowList(statusPorcelain, map) {
+  const extrasWhitelist = SUPPORTED_EXTRAS;
+  const allowed = [
+    ...PUSH_ALLOWED_STATIC,
+    ...Object.keys(map.projects).map((l) => `shared/projects/${l}/`),
+    ...Object.entries(map.extras ?? {}).flatMap(
+      ([l, names]) => names.filter((n) => extrasWhitelist.includes(n)).flatMap((n) => [`shared/extras/${l}/${n}`, `shared/extras/${l}/${n}/`])
+    ),
+    ...(map.sharedDirs ?? []).filter((d) => isValidSharedDir(d)).map((d) => `shared/${d}/`)
+  ];
+  const neverSyncHits = [];
+  const violations = [];
+  for (const path of parsePorcelainZ(statusPorcelain)) {
+    if (isNeverSync(path)) {
+      neverSyncHits.push(path);
+    } else if (!isAllowed(path, allowed)) {
+      violations.push(path);
+    }
+  }
+  if (neverSyncHits.length === 0 && violations.length === 0) return;
+  for (const p of neverSyncHits) {
+    fail(`${p} is in NEVER_SYNC and must never be pushed`);
+  }
+  for (const p of violations) {
+    fail(`to sync ${p}, add to PUSH_ALLOWED in src/config.ts`);
+  }
+  throw new NomadFatal("push allow-list violations");
+}
+
 // src/commands.push.ts
 init_push_leak_verdict();
 init_push_checks();
@@ -4090,7 +4178,7 @@ init_color();
 init_config();
 init_config_sharedDirs_guard();
 import { randomBytes as randomBytes2 } from "node:crypto";
-import { copyFileSync, existsSync as existsSync30, mkdirSync as mkdirSync9, readdirSync as readdirSync10, rmSync as rmSync11 } from "node:fs";
+import { copyFileSync, existsSync as existsSync31, mkdirSync as mkdirSync9, readdirSync as readdirSync10, rmSync as rmSync11 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { join as join37 } from "node:path";
 init_push_leak_verdict();
@@ -4108,7 +4196,7 @@ function stageSessions(tmpRoot, map) {
     reverse.set(encodePath(p), logical);
   }
   const localProjects = join37(CLAUDE_HOME, "projects");
-  if (!existsSync30(localProjects)) return 0;
+  if (!existsSync31(localProjects)) return 0;
   let staged = 0;
   for (const dir of readdirSync10(localProjects)) {
     const logical = reverse.get(dir);
@@ -4130,7 +4218,7 @@ function stageExtras(tmpRoot, map) {
     for (const dirname6 of dirnames) {
       if (!whitelist.includes(dirname6)) continue;
       const src = join37(localRoot, dirname6);
-      if (!existsSync30(src)) continue;
+      if (!existsSync31(src)) continue;
       const dst = join37(tmpRoot, "shared", "extras", logical, dirname6);
       copyExtras(src, dst);
       staged++;
@@ -4150,7 +4238,7 @@ function previewPushLeaks(map) {
       return { leak: false, verdictRow: NOTHING_TO_SCAN_ROW, recovery: null, findings: [] };
     }
     const ignoreFile = join37(REPO_HOME, ".gitleaksignore");
-    if (existsSync30(ignoreFile)) {
+    if (existsSync31(ignoreFile)) {
       copyFileSync(ignoreFile, join37(tmpRoot, ".gitleaksignore"));
     }
     let findings;
@@ -4184,15 +4272,34 @@ function guardGitlinks() {
     `gitlink trap: ${gitlinks.length} nested .git ${noun} in shared/; remove before retry`
   );
 }
+function runScan() {
+  const sp = startSpinner("Scanning for secrets");
+  try {
+    const verdict = scanPushVerdict();
+    sp.succeed();
+    return verdict;
+  } finally {
+    sp.stop();
+  }
+}
+function runPush() {
+  const sp = startSpinner("Pushing");
+  try {
+    gitOrFatal(["push"], "git push", REPO_HOME);
+    sp.succeed();
+  } finally {
+    sp.stop();
+  }
+}
 async function commitAndPush(st, ts, map, redactAll, allowAll, allowRule) {
   gitOrFatal(["add", "-A"], "git add", REPO_HOME);
-  let verdict = scanPushVerdict();
+  let verdict = runScan();
   if (verdict.leak) {
     renderPushTree(st, verdict);
     verdict = await resolveLeakFindings(verdict, ts, map, { redactAll, allowAll, allowRule });
   }
   gitOrFatal(["commit", "-m", `chore: sync from ${HOST}`], "git commit", REPO_HOME);
-  gitOrFatal(["push"], "git push", REPO_HOME);
+  runPush();
   renderPushTree(st, verdict);
 }
 function runDryRunPreview(st, map) {
@@ -4225,13 +4332,19 @@ async function cmdPush(opts = {}) {
   const allowAll = opts.allowAll === true;
   const allowRule = opts.allowRule;
   guardResolutionModeConflicts(dryRun, redactAll, allowAll, allowRule);
-  if (!existsSync31(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+  if (!existsSync32(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
   const handle = acquireLock("push");
   if (handle === null) process.exit(0);
   try {
     console.log(dryRun ? `push on host=${HOST} (dry-run)` : `push on host=${HOST}`);
     probeGitleaks();
-    rebaseBeforePush();
+    const rebaseSp = startSpinner("Rebasing onto origin");
+    try {
+      rebaseBeforePush();
+      rebaseSp.succeed();
+    } finally {
+      rebaseSp.stop();
+    }
     const ts = freshBackupTs(BACKUP_BASE);
     const remap = remapPush(ts, { dryRun });
     const extras = remapExtrasPush(ts, { dryRun });
@@ -4244,7 +4357,7 @@ async function cmdPush(opts = {}) {
       return;
     }
     const mapPath = join38(REPO_HOME, "path-map.json");
-    if (!existsSync31(mapPath)) {
+    if (!existsSync32(mapPath)) {
       if (dryRun) return runDryRunPreview(st, null);
       die("path-map.json missing, cannot enforce push allow-list");
     }
@@ -4284,17 +4397,17 @@ init_config();
 
 // src/diff.ts
 init_config();
-import { existsSync as existsSync32 } from "node:fs";
+import { existsSync as existsSync33 } from "node:fs";
 import { join as join39 } from "node:path";
 init_utils();
 init_utils_fs();
 init_utils_json();
 function cmdDiff() {
   try {
-    if (!existsSync32(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
+    if (!existsSync33(REPO_HOME)) die(`repo not cloned at ${REPO_HOME}`);
     const ts = freshBackupTs(BACKUP_BASE);
     const mapPath = join39(REPO_HOME, "path-map.json");
-    const map = existsSync32(mapPath) ? readPathMap(mapPath) : { projects: {} };
+    const map = existsSync33(mapPath) ? readPathMap(mapPath) : { projects: {} };
     const result = computePreview(ts, map);
     emitSummary("diff", result.unmapped);
   } catch (err) {
@@ -4309,7 +4422,7 @@ function cmdDiff() {
 
 // src/init.ts
 init_config();
-import { existsSync as existsSync34, mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync35, mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join41 } from "node:path";
 
 // src/init.gh-onboard.ts
@@ -4391,16 +4504,16 @@ init_config();
 init_utils();
 init_utils_fs();
 init_utils_json();
-import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync33, rmSync as rmSync12, statSync as statSync9 } from "node:fs";
+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";
 function snapshotIntoShared(map) {
   for (const name of allSharedLinks(map)) {
     const src = join40(CLAUDE_HOME, name);
-    if (!existsSync33(src)) continue;
+    if (!existsSync34(src)) continue;
     const dst = join40(REPO_HOME, "shared", name);
     if (statSync9(src).isDirectory()) {
       const gk = join40(dst, ".gitkeep");
-      if (existsSync33(gk)) rmSync12(gk);
+      if (existsSync34(gk)) rmSync12(gk);
       cpSync6(src, dst, { recursive: true, force: false, errorOnExist: true });
     } else {
       copyFileSync2(src, dst);
@@ -4408,7 +4521,7 @@ function snapshotIntoShared(map) {
     log(`snapshotted shared/${name} from ${src}`);
   }
   const userSettings = join40(CLAUDE_HOME, "settings.json");
-  if (existsSync33(userSettings)) {
+  if (existsSync34(userSettings)) {
     let parsed;
     try {
       parsed = readJson(userSettings);
@@ -4435,7 +4548,7 @@ function preflightConflict(repoHome) {
     join41(repoHome, "shared")
   ];
   for (const c of candidates) {
-    if (existsSync34(c)) return c;
+    if (existsSync35(c)) return c;
   }
   return null;
 }
@@ -4454,7 +4567,7 @@ function cmdInit(opts = {}) {
     mkdirSync10(join41(REPO_HOME, "shared", name), { recursive: true });
   }
   const userClaudeMd = join41(CLAUDE_HOME, "CLAUDE.md");
-  if (!snapshot || !existsSync34(userClaudeMd)) {
+  if (!snapshot || !existsSync35(userClaudeMd)) {
     writeFileSync6(join41(REPO_HOME, "shared", "CLAUDE.md"), SHARED_CLAUDE_MD);
     log("created shared/CLAUDE.md");
   }
@@ -4728,7 +4841,7 @@ function parsePushArgs(argv) {
 // package.json
 var package_default = {
   name: "claude-nomad",
-  version: "0.38.1",
+  version: "0.40.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: [
@@ -4918,7 +5031,7 @@ var DEFAULT_HELP = [
 init_config();
 init_utils();
 init_utils_json();
-import { existsSync as existsSync35, readFileSync as readFileSync11, readdirSync as readdirSync11 } from "node:fs";
+import { existsSync as existsSync36, readFileSync as readFileSync11, readdirSync as readdirSync11 } from "node:fs";
 import { join as join42 } from "node:path";
 function resumeCmd(sessionId) {
   if (!/^[A-Za-z0-9_-]+$/.test(sessionId) || sessionId.length > 128) {
@@ -4926,7 +5039,7 @@ function resumeCmd(sessionId) {
     process.exit(1);
   }
   const projectsRoot = join42(CLAUDE_HOME, "projects");
-  if (!existsSync35(projectsRoot)) {
+  if (!existsSync36(projectsRoot)) {
     fail(`${projectsRoot} does not exist`);
     process.exit(1);
   }
@@ -4941,7 +5054,7 @@ function resumeCmd(sessionId) {
     process.exit(1);
   }
   const mapPath = join42(REPO_HOME, "path-map.json");
-  if (!existsSync35(mapPath)) {
+  if (!existsSync36(mapPath)) {
     fail("path-map.json missing");
     process.exit(1);
   }
@@ -4965,7 +5078,7 @@ function resumeCmd(sessionId) {
 function findTranscriptPath(projectsRoot, sessionId) {
   for (const dir of readdirSync11(projectsRoot)) {
     const candidate = join42(projectsRoot, dir, `${sessionId}.jsonl`);
-    if (existsSync35(candidate)) return candidate;
+    if (existsSync36(candidate)) return candidate;
   }
   return null;
 }

package/dist/nomad.worker.mjs

@@ -0,0 +1,24 @@
+// src/spinner.worker.ts
+import { parentPort } from "node:worker_threads";
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var INTERVAL_MS = 80;
+var frame = 0;
+var timer = null;
+if (parentPort !== null) {
+  parentPort.on("message", (msg) => {
+    if (msg.type === "start" && msg.label !== void 0) {
+      const label = msg.label;
+      frame = 0;
+      if (timer !== null) clearInterval(timer);
+      timer = setInterval(() => {
+        process.stderr.write(`${FRAMES[frame % FRAMES.length]} ${label}\r`);
+        frame++;
+      }, INTERVAL_MS);
+    } else if (msg.type === "pause") {
+      if (timer !== null) {
+        clearInterval(timer);
+        timer = null;
+      }
+    }
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-nomad",
-  "version": "0.38.1",
+  "version": "0.40.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": [