@researai/deepscientist 1.5.2 → 1.5.4

package/bin/ds.js

@@ -13,6 +13,7 @@ const pyprojectToml = fs.readFileSync(path.join(repoRoot, 'pyproject.toml'), 'ut
 const pythonCandidates = process.platform === 'win32' ? ['python', 'py'] : ['python3', 'python'];
 const requiredPythonSpec = parseRequiredPythonSpec(pyprojectToml);
 const minimumPythonVersion = parseMinimumPythonVersion(requiredPythonSpec);
+const launcherWrapperCommands = ['ds', 'ds-cli', 'research', 'resear'];
 const pythonCommands = new Set([
   'init',
   'new',
@@ -34,7 +35,6 @@ const pythonCommands = new Set([
 ]);
 const UPDATE_PACKAGE_NAME = String(packageJson.name || '@researai/deepscientist').trim() || '@researai/deepscientist';
 const UPDATE_CHECK_TTL_MS = 12 * 60 * 60 * 1000;
-const UPDATE_PROMPT_TTL_MS = 12 * 60 * 60 * 1000;
 
 const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode']);
 
@@ -46,6 +46,9 @@ Usage:
   ds update
   ds update --check
   ds update --yes
+  ds migrate /data/DeepScientist
+  ds --here
+  ds --here doctor
   ds --tui
   ds --both
   ds --host 0.0.0.0 --port 21000
@@ -67,6 +70,7 @@ Launcher flags:
   --stop                Stop the managed daemon
   --restart             Restart the managed daemon
   --home <path>         Use a custom DeepScientist home
+  --here                Use the current working directory as DeepScientist home
   --quest-id <id>       Open the TUI on one quest directly
 
 Update:
@@ -74,6 +78,10 @@ Update:
   ds update --check     Print structured update status
   ds update --yes       Install the latest npm release immediately
 
+Migration:
+  ds migrate <target>   Move the DeepScientist home/install root to a new absolute path
+  ds migrate <target> --yes --restart
+
 Runtime:
   DeepScientist uses uv to manage a locked local Python runtime.
   If uv is missing, ds bootstraps a local copy under the DeepScientist home automatically.
@@ -176,10 +184,7 @@ function detectInstallMode(rootPath = repoRoot) {
 }
 
 function updateManualCommand(installMode) {
-  if (installMode === 'npm-package') {
-    return `npm install -g ${UPDATE_PACKAGE_NAME}@latest`;
-  }
-  return 'git pull && bash install.sh';
+  return `npm install -g ${UPDATE_PACKAGE_NAME}@latest`;
 }
 
 function updateSupportSummary(installMode, npmBinary, launcherPath) {
@@ -194,14 +199,14 @@ function updateSupportSummary(installMode, npmBinary, launcherPath) {
     return {
       canCheck: true,
       canSelfUpdate: false,
-      reason: 'This DeepScientist installation comes from a source checkout and should be updated from Git.',
+      reason: 'Self-update is disabled for this installation. Use the npm command below to install the latest release build.',
     };
   }
   if (!launcherPath || !fs.existsSync(launcherPath)) {
     return {
       canCheck: true,
       canSelfUpdate: false,
-      reason: 'The launcher entrypoint could not be resolved.',
+      reason: 'Self-update is disabled because the launcher entrypoint could not be resolved. Use the npm command below instead.',
     };
   }
   return {
@@ -279,14 +284,17 @@ function buildUpdateStatus(home, statePatch = {}) {
   const support = updateSupportSummary(installMode, npmBinary, launcherPath);
   const currentVersion = normalizeVersion(state.current_version || packageJson.version);
   const latestVersion = normalizeVersion(state.latest_version || '');
+  const promptedVersion = normalizeVersion(state.last_prompted_version || '');
   const updateAvailable = Boolean(latestVersion) && compareVersions(latestVersion, currentVersion) > 0;
   const skippedVersion = normalizeVersion(state.last_skipped_version || '');
+  const promptedCurrentTarget = Boolean(updateAvailable && promptedVersion && promptedVersion === latestVersion);
   const skippedCurrentTarget = Boolean(updateAvailable && skippedVersion && skippedVersion === latestVersion);
   const promptRecommended =
     Boolean(updateAvailable)
     && !Boolean(state.busy)
+    && !promptedCurrentTarget
     && !skippedCurrentTarget
-    && isExpired(state.last_prompted_at || state.last_deferred_at, UPDATE_PROMPT_TTL_MS);
+    ;
 
   return {
     ok: true,
@@ -302,6 +310,7 @@ function buildUpdateStatus(home, statePatch = {}) {
     last_checked_at: state.last_checked_at || null,
     last_check_error: state.last_check_error || null,
     last_prompted_at: state.last_prompted_at || null,
+    last_prompted_version: promptedVersion || null,
     last_deferred_at: state.last_deferred_at || null,
     last_skipped_version: skippedVersion || null,
     last_update_started_at: state.last_update_started_at || null,
@@ -345,10 +354,12 @@ function checkForUpdates(home, { force = false, timeoutMs = 3500 } = {}) {
 }
 
 function markUpdateDeferred(home, version) {
+  const normalizedVersion = normalizeVersion(version || readUpdateState(home).latest_version || '');
   const patched = mergeUpdateState(home, {
     last_prompted_at: new Date().toISOString(),
     last_deferred_at: new Date().toISOString(),
-    latest_version: normalizeVersion(version || readUpdateState(home).latest_version || '') || null,
+    last_prompted_version: normalizedVersion || null,
+    latest_version: normalizedVersion || null,
   });
   return buildUpdateStatus(home, patched);
 }
@@ -357,6 +368,7 @@ function markUpdateSkipped(home, version) {
   const normalized = normalizeVersion(version);
   const patched = mergeUpdateState(home, {
     last_prompted_at: new Date().toISOString(),
+    last_prompted_version: normalized || null,
     last_skipped_version: normalized || null,
   });
   return buildUpdateStatus(home, patched);
@@ -384,6 +396,9 @@ function resolveHome(args) {
   if (index >= 0 && index + 1 < args.length) {
     return path.resolve(args[index + 1]);
   }
+  if (args.includes('--here')) {
+    return process.cwd();
+  }
   if (process.env.DEEPSCIENTIST_HOME) {
     return path.resolve(process.env.DEEPSCIENTIST_HOME);
   }
@@ -554,12 +569,14 @@ function renderLaunchHints({ home, url, bindUrl, pythonSelection }) {
   renderKeyValueRows([
     ['ds --port 21000', 'Change the web port'],
     ['ds --host 0.0.0.0 --port 21000', 'Bind on all interfaces'],
+    ['ds --here', 'Use the current directory as home'],
     ['ds --both', 'Start web + TUI together'],
     ['ds --tui', 'Start the terminal workspace only'],
     ['ds --no-browser', 'Do not auto-open the browser'],
     ['ds --status', 'Show daemon health as JSON'],
     ['ds --restart', 'Restart the managed daemon'],
     ['ds --stop', 'Stop the managed daemon'],
+    ['ds migrate /data/DeepScientist', 'Move the full home/install root safely'],
     ['ds --help', 'Show the full launcher help'],
   ]);
   console.log('');
@@ -630,6 +647,7 @@ function printLaunchCard({
   console.log(centerText(browserLine, width));
   console.log(centerText(nextStep, width));
   console.log(centerText('Run ds --stop to stop the managed daemon.', width));
+  console.log(centerText('Need to move this installation later? Use ds migrate /new/path.', width));
   console.log('');
   renderLaunchHints({ home, url, bindUrl, pythonSelection });
 }
@@ -894,6 +912,22 @@ Flags:
 `);
 }
 
+function printMigrateHelp() {
+  console.log(`DeepScientist migrate
+
+Usage:
+  ds migrate /absolute/target/path
+  ds migrate /absolute/target/path --yes
+  ds migrate /absolute/target/path --restart
+  ds migrate /absolute/target/path --home /current/source/path
+
+Flags:
+  --yes              Skip the interactive double-confirmation prompt
+  --restart          Start the managed daemon again from the migrated home
+  --home <path>      Override the current DeepScientist source home/root
+`);
+}
+
 function parseUpdateArgs(argv) {
   const args = [...argv];
   if (args[0] === 'update') {
@@ -950,6 +984,40 @@ function parseUpdateArgs(argv) {
   };
 }
 
+function parseMigrateArgs(argv) {
+  const args = [...argv];
+  if (args[0] === 'migrate') {
+    args.shift();
+  }
+  let home = null;
+  let target = null;
+  let yes = false;
+  let restart = false;
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === '--yes') yes = true;
+    else if (arg === '--restart') restart = true;
+    else if (arg === '--home' && args[index + 1]) home = path.resolve(expandUserPath(args[++index]));
+    else if (arg === '--help' || arg === '-h') return { help: true };
+    else if (arg.startsWith('--')) return null;
+    else if (!target) target = path.resolve(expandUserPath(arg));
+    else return null;
+  }
+
+  if (!target) {
+    return null;
+  }
+
+  return {
+    help: false,
+    home,
+    target,
+    yes,
+    restart,
+  };
+}
+
 function findFirstPositionalArg(args) {
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -973,6 +1041,188 @@ function realpathOrSelf(targetPath) {
   }
 }
 
+function isPathEqual(left, right) {
+  return realpathOrSelf(path.resolve(left)) === realpathOrSelf(path.resolve(right));
+}
+
+function isPathInside(candidatePath, parentPath) {
+  const candidate = realpathOrSelf(path.resolve(candidatePath));
+  const parent = realpathOrSelf(path.resolve(parentPath));
+  if (candidate === parent) {
+    return false;
+  }
+  const relative = path.relative(parent, candidate);
+  return Boolean(relative && !relative.startsWith('..') && !path.isAbsolute(relative));
+}
+
+function buildInstalledWrapperScript() {
+  return [
+    '#!/usr/bin/env bash',
+    'set -euo pipefail',
+    'SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"',
+    'HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"',
+    'if [ -z "${DEEPSCIENTIST_HOME:-}" ]; then',
+    '  export DEEPSCIENTIST_HOME="$HOME_DIR"',
+    'fi',
+    'NODE_BIN="${DEEPSCIENTIST_NODE:-node}"',
+    'exec "$NODE_BIN" "$SCRIPT_DIR/ds.js" "$@"',
+    '',
+  ].join('\n');
+}
+
+function buildGlobalWrapperScript({ installDir, home, commandName }) {
+  return [
+    '#!/usr/bin/env bash',
+    'set -euo pipefail',
+    'if [ -z "${DEEPSCIENTIST_HOME:-}" ]; then',
+    `  export DEEPSCIENTIST_HOME="${home}"`,
+    'fi',
+    `exec "${path.join(installDir, 'bin', commandName)}" "$@"`,
+    '',
+  ].join('\n');
+}
+
+function writeExecutableScript(targetPath, content) {
+  ensureDir(path.dirname(targetPath));
+  fs.writeFileSync(targetPath, content, { encoding: 'utf8', mode: 0o755 });
+  fs.chmodSync(targetPath, 0o755);
+}
+
+function repairMigratedInstallWrappers(targetHome) {
+  const installBinDir = path.join(targetHome, 'cli', 'bin');
+  if (!fs.existsSync(installBinDir)) {
+    return;
+  }
+  const content = buildInstalledWrapperScript();
+  for (const commandName of launcherWrapperCommands) {
+    const wrapperPath = path.join(installBinDir, commandName);
+    if (!fs.existsSync(wrapperPath)) {
+      continue;
+    }
+    writeExecutableScript(wrapperPath, content);
+  }
+}
+
+function candidateWrapperPathsForCommand(commandName) {
+  const directories = String(process.env.PATH || '')
+    .split(path.delimiter)
+    .filter(Boolean);
+  const candidates = [];
+  for (const directory of directories) {
+    candidates.push(path.join(directory, commandName));
+    if (process.platform === 'win32') {
+      candidates.push(path.join(directory, `${commandName}.cmd`));
+      candidates.push(path.join(directory, `${commandName}.ps1`));
+    }
+  }
+  return candidates;
+}
+
+function rewriteLauncherWrappersIfPointingAtSource({ sourceHome, targetHome }) {
+  if (process.platform === 'win32') {
+    return [];
+  }
+  const rewritten = [];
+  const sourceInstallDir = path.join(sourceHome, 'cli');
+  const targetInstallDir = path.join(targetHome, 'cli');
+  for (const commandName of launcherWrapperCommands) {
+    for (const candidate of candidateWrapperPathsForCommand(commandName)) {
+      if (!fs.existsSync(candidate) || !fs.statSync(candidate).isFile()) {
+        continue;
+      }
+      let text = '';
+      try {
+        text = fs.readFileSync(candidate, 'utf8');
+      } catch {
+        continue;
+      }
+      if (!text.includes(sourceInstallDir) && !text.includes(sourceHome)) {
+        continue;
+      }
+      writeExecutableScript(
+        candidate,
+        buildGlobalWrapperScript({
+          installDir: targetInstallDir,
+          home: targetHome,
+          commandName,
+        })
+      );
+      rewritten.push(candidate);
+    }
+  }
+  return rewritten;
+}
+
+function scheduleDeferredSourceCleanup({ sourceHome, targetHome }) {
+  const logPath = path.join(targetHome, 'logs', 'migrate-cleanup.log');
+  ensureDir(path.dirname(logPath));
+  const helperScript = [
+    "const fs = require('node:fs');",
+    "const { setTimeout: sleep } = require('node:timers/promises');",
+    'const parentPid = Number(process.argv[1]);',
+    'const sourceHome = process.argv[2];',
+    'const logPath = process.argv[3];',
+    '(async () => {',
+    '  for (let attempt = 0; attempt < 300; attempt += 1) {',
+    '    try {',
+    '      process.kill(parentPid, 0);',
+    '      await sleep(100);',
+    '      continue;',
+    '    } catch {',
+    '      break;',
+    '    }',
+    '  }',
+    '  try {',
+    '    fs.rmSync(sourceHome, { recursive: true, force: true });',
+    '  } catch (error) {',
+    "    fs.appendFileSync(logPath, `[${new Date().toISOString()}] ${error instanceof Error ? error.message : String(error)}\\n`, 'utf8');",
+    '    process.exit(1);',
+    '  }',
+    '})();',
+  ].join('\n');
+  const child = spawn(process.execPath, ['-e', helperScript, String(process.pid), sourceHome, logPath], {
+    detached: true,
+    stdio: 'ignore',
+    env: process.env,
+  });
+  child.unref();
+}
+
+async function promptMigrationConfirmation({ sourceHome, targetHome }) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error('DeepScientist migration needs a TTY for confirmation. Re-run with `--yes` to continue non-interactively.');
+  }
+  console.log('');
+  console.log('DeepScientist home migration');
+  console.log('');
+  console.log(`From: ${sourceHome}`);
+  console.log(`To:   ${targetHome}`);
+  console.log('');
+  console.log('This will stop the managed daemon, copy the full DeepScientist root, verify the copy, update launcher wrappers, and delete the old path after success.');
+  const ask = (question) => new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(String(answer || '').trim());
+    });
+  });
+  const first = await ask('Type YES to continue: ');
+  if (first !== 'YES') {
+    return false;
+  }
+  const second = await ask('Type MIGRATE to confirm old-path deletion after a successful copy: ');
+  return second === 'MIGRATE';
+}
+
+function printMigrationSummary({ sourceHome, targetHome, restart }) {
+  console.log('');
+  console.log('DeepScientist migrate');
+  console.log('');
+  console.log(`Source: ${sourceHome}`);
+  console.log(`Target: ${targetHome}`);
+  console.log(`Restart: ${restart ? 'yes' : 'no'}`);
+}
+
 function pythonMeetsMinimum(probe) {
   if (!probe || typeof probe.major !== 'number' || typeof probe.minor !== 'number') {
     return false;
@@ -1784,6 +2034,9 @@ function normalizePythonCliArgs(args, home) {
       index += 1;
       continue;
     }
+    if (arg === '--here') {
+      continue;
+    }
     normalized.push(arg);
   }
   return ['--home', home, ...normalized];
@@ -2242,96 +2495,11 @@ function runNpmInstallLatest(home, npmBinary) {
   };
 }
 
-async function promptUpdateAction(status) {
-  const options = [
-    {
-      value: 'update',
-      label: status.can_self_update ? 'Update now' : 'Show manual update',
-    },
-    { value: 'later', label: 'Remind me later' },
-    { value: 'skip', label: 'Skip this version' },
-  ];
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    return 'later';
-  }
-  return new Promise((resolve) => {
-    let selected = 1;
-    const lines = [
-      '',
-      'A new DeepScientist version is available.',
-      '',
-      `Current: ${status.current_version}`,
-      `Latest:  ${status.latest_version || 'unknown'}`,
-      '',
-      status.can_self_update
-        ? 'What do you want to do?'
-        : 'Self-update is not available for this installation. Choose an action:',
-    ];
-
-    const cleanup = () => {
-      process.stdin.off('keypress', onKeypress);
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false);
-      }
-      process.stdin.pause();
-      console.log('');
-    };
-
-    const render = () => {
-      console.clear();
-      for (const line of lines) {
-        console.log(line);
-      }
-      for (let index = 0; index < options.length; index += 1) {
-        const option = options[index];
-        console.log(`${index === selected ? '>' : ' '} ${option.label}`);
-      }
-      console.log('');
-      console.log('Use ↑/↓ and Enter.');
-    };
-
-    const onKeypress = (_str, key) => {
-      if (key?.name === 'up') {
-        selected = (selected - 1 + options.length) % options.length;
-        render();
-        return;
-      }
-      if (key?.name === 'down') {
-        selected = (selected + 1) % options.length;
-        render();
-        return;
-      }
-      if (key?.name === 'return') {
-        const choice = options[selected].value;
-        cleanup();
-        resolve(choice);
-        return;
-      }
-      if (key?.ctrl && key?.name === 'c') {
-        cleanup();
-        resolve('later');
-      }
-    };
-
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.on('keypress', onKeypress);
-    render();
-  });
-}
-
 function printUpdateStatus(status, { compact = false } = {}) {
   if (compact) {
     if (status.update_available) {
-      console.log(
-        `DeepScientist update available: ${status.current_version} -> ${status.latest_version}`
-      );
-      if (status.can_self_update) {
-        console.log('Run `ds update --yes` to install it.');
-      } else {
-        console.log(`Manual update: ${status.manual_update_command}`);
-      }
+      console.log(`DeepScientist update available: ${status.current_version} -> ${status.latest_version}`);
+      console.log(`Update with: ${status.manual_update_command}`);
       return;
     }
     console.log(`DeepScientist is up to date (${status.current_version}).`);
@@ -2344,16 +2512,15 @@ function printUpdateStatus(status, { compact = false } = {}) {
     ['Latest', status.latest_version || 'unknown'],
     ['Available', status.update_available ? 'yes' : 'no'],
     ['Install mode', status.install_mode],
-    ['Self-update', status.can_self_update ? 'supported' : 'manual-only'],
     ['Last checked', status.last_checked_at || 'never'],
   ]);
   if (status.last_check_error) {
     console.log('');
     console.log(`Version check error: ${status.last_check_error}`);
   }
-  if (!status.can_self_update) {
+  if (status.update_available || status.manual_update_command) {
     console.log('');
-    console.log(`Manual update command: ${status.manual_update_command}`);
+    console.log(`Update command: ${status.manual_update_command}`);
     if (status.reason) {
       console.log(status.reason);
     }
@@ -2381,26 +2548,6 @@ function spawnDetachedNode(args, options = {}) {
   return child;
 }
 
-async function restartIntoUpdatedLauncher(rawArgs) {
-  const launcherPath = resolveLauncherPath();
-  if (!launcherPath) {
-    throw new Error('Could not resolve the DeepScientist launcher after the update.');
-  }
-  const args = [launcherPath, '--skip-update-check', ...rawArgs.filter((item) => item !== '--skip-update-check')];
-  const child = spawn(process.execPath, args, {
-    cwd: repoRoot,
-    stdio: 'inherit',
-    env: process.env,
-  });
-  await new Promise((resolve, reject) => {
-    child.on('error', reject);
-    child.on('exit', (code) => {
-      process.exit(code ?? 0);
-      resolve();
-    });
-  });
-}
-
 async function performSelfUpdate(home, options = {}) {
   const status = checkForUpdates(home, { force: true });
   if (!status.update_available) {
@@ -2566,42 +2713,8 @@ async function maybeHandleStartupUpdate(home, rawArgs, options = {}) {
     return false;
   }
 
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    printUpdateStatus(status, { compact: true });
-    mergeUpdateState(home, {
-      last_prompted_at: new Date().toISOString(),
-    });
-    return false;
-  }
-
-  const action = await promptUpdateAction(status);
-  if (action === 'later') {
-    markUpdateDeferred(home, status.latest_version);
-    return false;
-  }
-  if (action === 'skip') {
-    markUpdateSkipped(home, status.latest_version);
-    return false;
-  }
-  if (action === 'update' && !status.can_self_update) {
-    console.log(`Manual update required: ${status.manual_update_command}`);
-    if (status.reason) {
-      console.log(status.reason);
-    }
-    markUpdateDeferred(home, status.latest_version);
-    return false;
-  }
-  if (action === 'update') {
-    console.log(`Updating DeepScientist ${status.current_version} -> ${status.latest_version} ...`);
-    const result = await performSelfUpdate(home, { restartDaemon: false });
-    if (!result.ok) {
-      console.error(result.message);
-      return false;
-    }
-    console.log(result.message);
-    await restartIntoUpdatedLauncher(rawArgs);
-    return true;
-  }
+  printUpdateStatus(status, { compact: true });
+  markUpdateDeferred(home, status.latest_version);
   return false;
 }
 
@@ -2968,32 +3081,137 @@ async function updateMain(rawArgs) {
     printUpdateStatus(status, { compact: true });
     process.exit(0);
   }
+  printUpdateStatus(status, { compact: true });
+  process.exit(0);
+}
 
-  const action = await promptUpdateAction(status);
-  if (action === 'later') {
-    markUpdateDeferred(home, status.latest_version);
-    console.log('Update reminder deferred.');
-    process.exit(0);
+async function migrateMain(rawArgs) {
+  const options = parseMigrateArgs(rawArgs);
+  if (!options) {
+    printMigrateHelp();
+    process.exit(1);
   }
-  if (action === 'skip') {
-    markUpdateSkipped(home, status.latest_version);
-    console.log(`Skipped ${status.latest_version}.`);
+  if (options.help) {
+    printMigrateHelp();
     process.exit(0);
   }
-  if (!status.can_self_update) {
-    console.log(`Manual update command: ${status.manual_update_command}`);
-    if (status.reason) {
-      console.log(status.reason);
+
+  const sourceHome = realpathOrSelf(options.home || resolveHome(rawArgs));
+  const targetHome = path.resolve(options.target);
+  if (!fs.existsSync(sourceHome)) {
+    console.error(`DeepScientist source path does not exist: ${sourceHome}`);
+    process.exit(1);
+  }
+  if (isPathEqual(sourceHome, targetHome)) {
+    console.error('DeepScientist source and target paths are identical. Choose a different migration target.');
+    process.exit(1);
+  }
+  if (isPathInside(targetHome, sourceHome) || isPathInside(sourceHome, targetHome)) {
+    console.error('DeepScientist migration requires two separate sibling paths. Do not nest one path inside the other.');
+    process.exit(1);
+  }
+  if (fs.existsSync(targetHome)) {
+    console.error(`DeepScientist target path already exists: ${targetHome}`);
+    process.exit(1);
+  }
+
+  printMigrationSummary({ sourceHome, targetHome, restart: options.restart });
+  if (!options.yes) {
+    const confirmed = await promptMigrationConfirmation({ sourceHome, targetHome });
+    if (!confirmed) {
+      console.log('DeepScientist migration cancelled.');
+      process.exit(1);
     }
-    process.exit(0);
   }
-  const payload = await performSelfUpdate(home, {
-    host: options.host,
-    port: options.port,
-    restartDaemon: options.restartDaemon,
-  });
-  console.log(payload.message);
-  process.exit(payload.ok ? 0 : 1);
+
+  const state = readDaemonState(sourceHome);
+  const configured = readConfiguredUiAddressFromFile(sourceHome);
+  const url = state?.url || browserUiUrl(configured.host, configured.port);
+  const health = await fetchHealth(url);
+  if (state || healthMatchesHome({ health, home: sourceHome })) {
+    await stopDaemon(sourceHome);
+  } else if (health && health.status === 'ok') {
+    console.log(`Skipping daemon stop because ${url} belongs to another DeepScientist home.`);
+  }
+
+  const pythonRuntime = ensurePythonRuntime(sourceHome);
+  const runtimePython = pythonRuntime.runtimePython;
+  const result = runPythonCli(
+    runtimePython,
+    ['--home', sourceHome, 'migrate', targetHome],
+    { capture: true, allowFailure: true }
+  );
+  let payload = null;
+  try {
+    payload = JSON.parse(String(result.stdout || '{}'));
+  } catch {
+    payload = null;
+  }
+  if (result.status !== 0 || !payload || payload.ok !== true) {
+    if (result.stdout) {
+      process.stdout.write(result.stdout);
+      if (!String(result.stdout).endsWith('\n')) {
+        process.stdout.write('\n');
+      }
+    }
+    if (result.stderr) {
+      process.stderr.write(result.stderr);
+      if (!String(result.stderr).endsWith('\n')) {
+        process.stderr.write('\n');
+      }
+    }
+    console.error('DeepScientist migration failed.');
+    process.exit(result.status ?? 1);
+  }
+
+  repairMigratedInstallWrappers(targetHome);
+  const rewrittenWrappers = rewriteLauncherWrappersIfPointingAtSource({ sourceHome, targetHome });
+
+  const sourceContainsCurrentInstall = isPathEqual(repoRoot, path.join(sourceHome, 'cli')) || isPathInside(repoRoot, sourceHome);
+  if (sourceContainsCurrentInstall) {
+    scheduleDeferredSourceCleanup({ sourceHome, targetHome });
+  } else {
+    fs.rmSync(sourceHome, { recursive: true, force: true });
+  }
+
+  let restartMessage = 'Restart skipped.';
+  if (options.restart) {
+    const migratedLauncher = path.join(targetHome, 'cli', 'bin', 'ds.js');
+    if (!fs.existsSync(migratedLauncher)) {
+      restartMessage = `Migration succeeded, but restart was skipped because the migrated launcher is missing: ${migratedLauncher}`;
+    } else {
+      const child = spawn(
+        process.execPath,
+        [migratedLauncher, '--home', targetHome, '--daemon-only', '--no-browser', '--skip-update-check'],
+        {
+          cwd: path.join(targetHome, 'cli'),
+          detached: true,
+          stdio: 'ignore',
+          env: process.env,
+        }
+      );
+      child.unref();
+      restartMessage = 'Managed daemon restart scheduled from the migrated home.';
+    }
+  }
+
+  console.log('');
+  console.log('DeepScientist migration completed.');
+  console.log(`New home: ${targetHome}`);
+  if (payload.summary) {
+    console.log(payload.summary);
+  }
+  if (rewrittenWrappers.length > 0) {
+    console.log(`Updated wrappers: ${rewrittenWrappers.join(', ')}`);
+  }
+  console.log(restartMessage);
+  if (sourceContainsCurrentInstall) {
+    console.log(`Old path cleanup has been scheduled: ${sourceHome}`);
+  } else {
+    console.log(`Old path removed: ${sourceHome}`);
+  }
+  console.log(`Use \`ds --home ${targetHome}\` if you want to override the default explicitly.`);
+  process.exit(0);
 }
 
 async function launcherMain(rawArgs) {
@@ -3097,6 +3315,10 @@ async function main() {
     await updateMain(args);
     return;
   }
+  if (positional && positional.value === 'migrate') {
+    await migrateMain(args);
+    return;
+  }
   if (args.length === 0 || args[0] === 'ui' || (!positional && args[0]?.startsWith('--'))) {
     await launcherMain(args);
     return;
@@ -3144,9 +3366,11 @@ module.exports = {
     legacyVenvRootPath,
     resolveUvBinary,
     resolveHome,
+    parseMigrateArgs,
     useEditableProjectInstall,
     compareVersions,
     detectInstallMode,
+    updateManualCommand,
     buildUpdateStatus,
   },
 };