superlocalmemory 4.1.24 → 4.2.0

package/scripts/postinstall/media-request.js

@@ -0,0 +1,203 @@
+/**
+ * What's-new banner and the "turn on images and documents" request.
+ *
+ * The installer never downloads anything. It only records a request in
+ * <data root>/features.json; the SLM daemon acts on it the next time it
+ * starts. Nothing is written unless the person asked (a flag, the
+ * SLM_ENABLE_MEDIA=1 environment variable, or a "yes" at a terminal).
+ *
+ * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+ * Licensed under AGPL-3.0-or-later.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+const { nodeRunsTranslated } = require('./node-arch.js');
+
+const FEATURES_FILE = 'features.json';
+
+const GIB = 1024 ** 3;
+// Same threshold and override as the Python side (MEDIA_MIN_RAM_BYTES and
+// LOW_RAM_OVERRIDE_ENV in runtimes/media_env.py): 15 GiB, because machines sold as
+// 16 GB report a little less.
+const MIN_RAM_BYTES = 15 * GIB;
+const LOW_RAM_OVERRIDE_ENV = 'SLM_MEDIA_ALLOW_LOW_RAM';
+
+/**
+ * Why images and documents cannot be turned on here, or '' when they can.
+ * Unknown memory (0) is allowed; SLM_MEDIA_ALLOW_LOW_RAM=1 is the developer override.
+ */
+function ramRefusal(totalBytes, env = process.env) {
+  if (!(totalBytes > 0 && totalBytes < MIN_RAM_BYTES)) return '';
+  if (env && env[LOW_RAM_OVERRIDE_ENV] === '1') return '';
+  return 'Images and documents need a computer with at least 16 GB of memory; this one has '
+    + (totalBytes / GIB).toFixed(1) + ' GB. Your text memories keep working.';
+}
+
+// Where the managed picture and document environment has a build (the same list as
+// runtimes/locks): Apple Silicon Macs, x86_64 and ARM64 Linux, and x64 Windows. `translated` is a
+// Node that runs as an Intel program on an Apple Silicon Mac.
+const NOT_SUPPORTED = 'Images and documents are not supported on this computer yet. Your text memories keep working.';
+
+function mediaPlatformRefusal({ platform, arch, translated } = {}) {
+  if (platform === 'darwin' && arch === 'x64') {
+    if (translated) {
+      return 'This Node.js runs as an Intel program on an Apple Silicon Mac, so SLM cannot tell that your '
+        + 'Mac can use images and documents. Run Node natively (the Apple Silicon build), then try again.';
+    }
+    return NOT_SUPPORTED;
+  }
+  if (platform === 'linux' && arch !== 'x64' && arch !== 'arm64') return NOT_SUPPORTED;
+  if (platform === 'win32' && arch !== 'x64') return NOT_SUPPORTED;
+  return '';
+}
+
+function currentMachine() {
+  return { platform: process.platform, arch: process.arch, translated: nodeRunsTranslated(process.platform) };
+}
+
+function printWhatsNew(log = console.log) {
+  log('');
+  log("What's new in 4.1.25:");
+  log('  + Images & documents: off until you turn them on (about 1.5 GB of models). Run: slm media enable');
+  log('  + Bots on the web can message each other through the mesh (remote access is still off).');
+  log('  + See what is on and what you can turn on: slm features');
+}
+
+// Same alias order as every other entry point.
+function resolveDataRoot(env = process.env) {
+  return env.SLM_DATA_DIR
+    || env.SL_MEMORY_PATH
+    || env.SLM_HOME
+    || path.join(env.HOME || os.homedir(), '.superlocalmemory');
+}
+
+function mediaRequested(args, env) {
+  const viaNpm = env && ['true', '1'].includes(String(env.npm_config_media || '').toLowerCase());
+  return Boolean((args && args.media) || (env && env.SLM_ENABLE_MEDIA === '1') || viaNpm);
+}
+
+/**
+ * Merge {"media": {"requested": true, ...}} into features.json (mode 0600).
+ * Never throws; returns { ok, note }.
+ */
+function recordMediaRequest(slmDir, now = new Date()) {
+  const file = path.join(slmDir, FEATURES_FILE);
+  try {
+    let data = { schema: 1 };
+    if (fs.existsSync(file)) {
+      try {
+        data = JSON.parse(fs.readFileSync(file, 'utf8'));
+      } catch (_e) {
+        return { ok: false, note: 'features.json could not be read; left untouched. Run: slm media enable' };
+      }
+      if (!data || typeof data !== 'object' || Array.isArray(data)) {
+        return { ok: false, note: 'features.json has an unexpected shape; left untouched. Run: slm media enable' };
+      }
+    }
+    const media = data.media && typeof data.media === 'object' ? data.media : {};
+    if (media.enabled) return { ok: true, note: 'images and documents are already on' };
+    data.media = Object.assign({}, media, {
+      requested: true,
+      requested_at: now.toISOString(),
+      choice_source: 'npm',
+    });
+    fs.mkdirSync(slmDir, { recursive: true });
+    const tmp = file + '.tmp';
+    const fd = fs.openSync(tmp, 'w', 0o600);
+    try {
+      fs.writeSync(fd, JSON.stringify(data), 0, 'utf8');
+    } finally {
+      fs.closeSync(fd);
+    }
+    fs.renameSync(tmp, file);
+    if (process.platform !== 'win32') {
+      try { fs.chmodSync(file, 0o600); } catch (_e) { /* best-effort */ }
+    }
+    return { ok: true, note: 'recorded' };
+  } catch (e) {
+    return { ok: false, note: 'could not record the request (' + e.message + '). Run: slm media enable' };
+  }
+}
+
+function askYesNo(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(/^\s*y(es)?\s*$/i.test(answer || ''));
+    });
+  });
+}
+
+/**
+ * Decide and (unless dry-run) record. `interactive` allows the question,
+ * which defaults to No. Returns true when a request was recorded. On a computer
+ * with less than 16 GB of memory it says so once and neither asks nor records.
+ */
+async function handleMediaChoice({ args, env, slmDir, interactive, ask = askYesNo, log = console.log,
+  totalMem = os.totalmem(), machine = currentMachine() }) {
+  let wanted = mediaRequested(args, env);
+  const unsupported = mediaPlatformRefusal(machine);
+  if ((wanted || interactive) && unsupported) {
+    log('');
+    log('SLM: ' + unsupported);
+    return false;  // not asked, nothing recorded: the daemon would refuse it anyway
+  }
+  const refusal = ramRefusal(totalMem, env);
+  if ((wanted || interactive) && refusal) {
+    log('');
+    log('SLM: ' + refusal);
+    return false;  // not asked, nothing recorded: the daemon would refuse it anyway
+  }
+  if ((wanted || interactive) && totalMem > 0 && totalMem < MIN_RAM_BYTES) {
+    log('SLM: ' + LOW_RAM_OVERRIDE_ENV + '=1 is set; allowing images and documents on '
+      + (totalMem / GIB).toFixed(1) + ' GB of memory (16 GB needed).');
+  }
+  if (!wanted && interactive) {
+    log('');
+    wanted = await ask('Turn on images and documents later? It downloads about 1.5 GB when SLM next starts. [y/N] ');
+  }
+  if (!wanted) return false;
+  if (args && args.dryRun) {
+    log('SLM dry-run: would record a request to turn on images and documents.');
+    return false;
+  }
+  const result = recordMediaRequest(slmDir);
+  if (result.ok) {
+    log('SLM: images and documents will start setting up the next time SLM starts (' + result.note + ').');
+  } else {
+    log('SLM: ' + result.note);
+  }
+  return result.ok;
+}
+
+/**
+ * The step npm's own postinstall runs: --media / npm_config_media /
+ * SLM_ENABLE_MEDIA=1 record a request; on a real terminal (never in CI) a
+ * default-No question is asked. Never downloads, never throws.
+ */
+async function runMediaStep({ argv = [], env = process.env, tty, ask, log = console.log } = {}) {
+  try {
+    const isTty = tty !== undefined ? tty
+      : Boolean(process.stdout.isTTY && process.stdin.isTTY);
+    const ci = env.CI === 'true' || env.CI === '1';
+    return await handleMediaChoice({
+      args: { media: argv.includes('--media'), dryRun: argv.includes('--dry-run') },
+      env,
+      slmDir: resolveDataRoot(env),
+      interactive: isTty && !ci,
+      ask: ask || askYesNo,
+      log,
+    });
+  } catch (e) {
+    log('SLM: could not record the images and documents choice (' + e.message + '). Run: slm media enable');
+    return false;
+  }
+}
+
+module.exports = { mediaPlatformRefusal, ramRefusal, MIN_RAM_BYTES, runMediaStep, resolveDataRoot, printWhatsNew, mediaRequested, recordMediaRequest, handleMediaChoice, FEATURES_FILE };

package/scripts/postinstall/node-arch.js

@@ -0,0 +1,27 @@
+/**
+ * Whether this Node.js is an Intel program run by Rosetta on an Apple Silicon Mac.
+ *
+ * Both the Python check and the pictures request need to tell that apart from a
+ * real Intel Mac: a universal2 Python started by a translated Node reports x86_64.
+ *
+ * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+ * Licensed under AGPL-3.0-or-later.
+ */
+
+'use strict';
+
+const os = require('os');
+const { spawnSync } = require('child_process');
+
+// Only macOS has the question; any failure to ask answers false.
+function nodeRunsTranslated(platform = os.platform(), run = spawnSync) {
+  if (platform !== 'darwin') return false;
+  try {
+    const result = run('sysctl', ['-n', 'sysctl.proc_translated'], { stdio: 'pipe', timeout: 3000, encoding: 'utf8' });
+    return Boolean(result) && !result.error && String(result.stdout || '').trim() === '1';
+  } catch (_) {
+    return false;
+  }
+}
+
+module.exports = { nodeRunsTranslated };

package/scripts/postinstall-interactive.js

@@ -33,9 +33,11 @@
  *   --reconfigure          Allow overwrite of existing config.toml.
  *   --home=<path>          Override $HOME (test hook).
  *   --reply-file=<json>    JSON file providing custom-knob answers.
+ *   --media                Record a request to turn on images and documents.
  *
  * Environment variables (test/CI hooks):
  *   CI=true                        Force non-TTY path.
+ *   SLM_ENABLE_MEDIA=1             Same as --media (records a request; never downloads).
  *   SLM_INSTALL_FREE_RAM_MB=<int>  Override free-RAM probe (benchmark).
  *   SLM_INSTALL_COLD_START_MS=<n>  Override Python cold-start probe.
  *   SLM_INSTALL_DISK_FREE_GB=<n>   Override disk-free probe.
@@ -144,6 +146,7 @@ function parseArgs(argv) {
     home: null,
     replyFile: null,
     homeOutsideHome: false, // H-10: opt-in flag for --home outside $HOME
+    media: false, // --media: record a request to turn on images and documents
     // v3.8.0: deployment mode — "personal" | "enterprise" (default: personal)
     deployment: null,
   };
@@ -151,6 +154,7 @@ function parseArgs(argv) {
     if (a === '--dry-run') args.dryRun = true;
     else if (a === '--reconfigure') args.reconfigure = true;
     else if (a === '--home-outside-home') args.homeOutsideHome = true; // H-10
+    else if (a === '--media') args.media = true;
     else if (a.startsWith('--profile=')) args.profile = a.slice('--profile='.length);
     else if (a.startsWith('--home=')) args.home = a.slice('--home='.length);
     else if (a.startsWith('--reply-file=')) args.replyFile = a.slice('--reply-file='.length);
@@ -188,6 +192,9 @@ const {
   executeIdeConnections,
 } = require('./postinstall/ide-multiselect.js');
 
+// 4.1.25 — what's-new banner + the (never-downloading) media request
+const { printWhatsNew, handleMediaChoice } = require('./postinstall/media-request.js');
+
 // ------------------------------------------------------------------------
 // TTY detection
 // ------------------------------------------------------------------------
@@ -526,22 +533,6 @@ async function runInteractiveFlow(rl, recommendedProfile) {
 // First-run checklist
 // ------------------------------------------------------------------------
 
-// UX-G2 — one-screen "what's new in v3.4.21" banner for upgraders so
-// existing users see the headline before the first-run checklist. Kept
-// under 60 LOC per Stage-8 G2 scope.
-function printLivingBrainDelta() {
-  console.log('');
-  console.log('Current setup guarantees:');
-  console.log('  + session_init mandate hook — Claude calls ToolSearch→session_init first, every session');
-  console.log('  + External IDE integrations are installed only after explicit consent in `slm setup`');
-  console.log('  + M017 migration — ccq_consolidated_blocks gets scope column (no more silent CCQ scope drop)');
-  console.log('  + GC-safe test flags baked into pyproject.toml + Makefile (no more macOS ARM SIGSEGV)');
-  console.log('What\'s unchanged:');
-  console.log('  * Your memory.db — zero deletes, zero rewrites');
-  console.log('  * Your profile settings');
-  console.log('  * All CLI commands you already use');
-}
-
 function printFirstRunChecklist(config) {
   console.log('');
   console.log('SuperLocalMemory is configured.');
@@ -608,6 +599,8 @@ async function main() {
   if (cfgExists && !args.reconfigure) {
     console.log('SLM: existing config.toml detected at ' + cfgPath);
     console.log('SLM: skipping installer. Use --reconfigure to change settings.');
+    printWhatsNew();
+    await handleMediaChoice({ args, env: process.env, slmDir, interactive: false });
     return 0;
   }
 
@@ -710,6 +703,8 @@ async function main() {
   if (args.dryRun) {
     console.log('SLM dry-run: would write profile=' + config.profile +
       ' to ' + cfgPath);
+    printWhatsNew();
+    await handleMediaChoice({ args, env: process.env, slmDir, interactive: false });
     printFirstRunChecklist(config);
     return 0;
   }
@@ -764,8 +759,9 @@ async function main() {
   // v3.8.0: Execute IDE connections after config write so state is consistent.
   if (config._pendingIdes) executeIdeConnections(config._pendingIdes, slmDir);
 
-  // UX-G2: show the one-screen delta banner so upgraders see what shipped.
-  printLivingBrainDelta();
+  // Show what shipped, then the (default-No) question about images and documents.
+  printWhatsNew();
+  await handleMediaChoice({ args, env: process.env, slmDir, interactive: !nonInteractive });
 
   printFirstRunChecklist(config);
   return 0;
@@ -800,7 +796,7 @@ module.exports = {
   LLM_MODEL_CHOICES,
   PROFILES,
   CUSTOM_KNOB_ENUMS, // UX-M3
-  printLivingBrainDelta, // UX-G2 (exposed for the test harness only)
+  printWhatsNew, // shared with scripts/postinstall.js (exposed for the test harness)
   // v3.8.0 — deployment
   DEPLOYMENT_PRESETS,
   DEFAULT_DEPLOYMENT_MODE,

package/scripts/postinstall.js

@@ -16,6 +16,9 @@ const { spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { printWhatsNew, runMediaStep } = require('./postinstall/media-request.js');
+const { nodeRunsTranslated } = require('./postinstall/node-arch.js');
+const { runUpgradeStep } = require('./postinstall/engine-upgrade.js');
 
 const MIN_PYTHON = Object.freeze([3, 12]);
 const MAX_PYTHON_EXCLUSIVE = Object.freeze([3, 15]);
@@ -242,13 +245,82 @@ function validateRuntimeLocation(venvRoot) {
   }
 }
 
+function pythonGuidance(platform = os.platform()) {
+  const lines = ['', 'SuperLocalMemory requires Python 3.12, 3.13, or 3.14.'];
+  if (platform === 'darwin') {
+    lines.push('Install it with Homebrew:  brew install python@3.13');
+    lines.push('or the installer from https://www.python.org/downloads/macos/');
+  } else if (platform === 'win32') {
+    lines.push('Install it with:  winget install Python.Python.3.13');
+    lines.push('or from https://www.python.org/downloads/windows/ (the py launcher is found automatically).');
+  } else if (platform === 'linux') {
+    lines.push('Debian 13 / Ubuntu 24.04 and later:  sudo apt install python3 python3-venv');
+    lines.push('Ubuntu 22.04:  sudo add-apt-repository ppa:deadsnakes/ppa && sudo apt install python3.12 python3.12-venv');
+    lines.push('Fedora / RHEL 9:  sudo dnf install python3.12');
+  } else {
+    lines.push('Install it from https://www.python.org/downloads/');
+  }
+  lines.push('Then finish the install:  npm rebuild -g superlocalmemory');
+  lines.push('(or set SLM_PYTHON to the interpreter if it is somewhere unusual).');
+  lines.push('The npm installer creates a private virtual environment;');
+  lines.push('it never installs packages into your system Python.');
+  return lines;
+}
+
+// Machines SuperLocalMemory cannot run on: an Intel (x86_64) Python on macOS (the
+// pinned security library, cryptography 50, has no Intel Mac build), a 32-bit Python
+// on Windows or Linux, and Windows on ARM. pip would fail deep in dependency
+// resolution instead. An Intel answer on a Mac can be false: a universal2 Python
+// started by a Node that runs translated (Rosetta) reports x86_64 although the Mac
+// is Apple Silicon, so `translated` (see nodeRunsTranslated) changes the advice.
+function unsupportedMachine(platform, machine, is64, translated = false) {
+  const m = String(machine || '').toLowerCase();
+  if (platform === 'darwin' && m === 'x86_64') {
+    if (translated === true) {
+      return [
+        'This Node.js is running as an Intel program on an Apple Silicon Mac (translated by Rosetta),',
+        'so the Python it starts reports Intel too. SuperLocalMemory needs everything to run natively.',
+        'Install the Apple Silicon (arm64) Node.js (nodejs.org installer, or Homebrew in /opt/homebrew),',
+        'open a new terminal, and run Node natively, then: npm rebuild -g superlocalmemory',
+      ].join('\n');
+    }
+    return [
+      'This Python is an Intel (x86_64) build, and SuperLocalMemory needs an Apple Silicon (arm64) one.',
+      'On an Apple Silicon Mac, install the arm64 Python (Homebrew in /opt/homebrew: brew install python@3.13,',
+      'or the python.org installer run natively, not under Rosetta), then: npm rebuild -g superlocalmemory',
+      'Intel Macs are not supported: the security library SuperLocalMemory pins has no Intel Mac build.',
+    ].join('\n');
+  }
+  if (platform === 'win32' && m === 'arm64') {
+    return 'Windows on ARM is not supported yet: the security library SuperLocalMemory pins has no '
+      + 'Windows ARM build. Use a 64-bit Intel or AMD Windows computer, or WSL with an x86_64 Linux.';
+  }
+  if (platform === 'win32' && is64 === false) {
+    return 'This Python is 32-bit. SuperLocalMemory needs 64-bit Python 3.12-3.14 on Windows '
+      + '(winget install Python.Python.3.13), then: npm rebuild -g superlocalmemory';
+  }
+  if (platform === 'linux' && (is64 === false || ['i386', 'i486', 'i586', 'i686', 'armv6l', 'armv7l'].includes(m))) {
+    return 'This computer or this Python is 32-bit. SuperLocalMemory needs a 64-bit Linux '
+      + '(x86_64 or aarch64) with 64-bit Python 3.12-3.14, then: npm rebuild -g superlocalmemory';
+  }
+  return null;
+}
+
+function pythonMachine(python) {
+  try {
+    const result = spawnSync(python.command, [...python.prefixArgs, '-c',
+      'import platform, sys; print(sys.platform, platform.machine(), sys.maxsize > 2**32)'], {
+      stdio: 'pipe', timeout: 5000, env: process.env,
+    });
+    const [platform, machine, wide] = String(result.stdout || '').trim().split(/\s+/);
+    return { platform: platform || '', machine: machine || '', is64: wide === 'True' ? true : wide === 'False' ? false : null };
+  } catch (_) {
+    return { platform: '', machine: '', is64: null };
+  }
+}
+
 function printPythonGuidance() {
-  console.error('');
-  console.error('SuperLocalMemory requires Python 3.12, 3.13, or 3.14.');
-  console.error('Install Python from https://www.python.org/downloads/ and rerun:');
-  console.error('  npm rebuild superlocalmemory');
-  console.error('The npm installer will create a private virtual environment;');
-  console.error('it will not install packages into your system Python.');
+  for (const line of pythonGuidance()) console.error(line);
 }
 
 function failureDetail(result) {
@@ -277,12 +349,19 @@ function main(argv = process.argv.slice(2)) {
     printPythonGuidance();
     return 1;
   }
+  const machine = pythonMachine(python);
+  const refusal = unsupportedMachine(machine.platform, machine.machine, machine.is64, nodeRunsTranslated());
+  if (refusal) {
+    console.error('');
+    console.error(refusal);
+    return 1;
+  }
 
   const locationCheck = validateRuntimeLocation(venvRoot);
   if (!locationCheck.ok) {
     console.error(`SuperLocalMemory: refusing unsafe runtime location: ${locationCheck.error}.`);
     console.error('Move that path aside manually, verify it contains no needed files, then run:');
-    console.error('  npm rebuild superlocalmemory');
+    console.error('  npm rebuild -g superlocalmemory');
     return 1;
   }
 
@@ -311,7 +390,7 @@ function main(argv = process.argv.slice(2)) {
     } else {
       console.error('Repair the selected Python installation so the stdlib venv module is available, then run:');
     }
-    console.error('  npm rebuild superlocalmemory');
+    console.error('  npm rebuild -g superlocalmemory');
     return 1;
   }
 
@@ -361,10 +440,9 @@ function main(argv = process.argv.slice(2)) {
   if (installPackage.status !== 0) {
     console.error(`SuperLocalMemory: private-runtime installation failed (${failureDetail(installPackage)}).`);
     console.error(`Tried Python source: ${packageSource}`);
-    console.error('This install needs network access to PyPI, or set SLM_LOCAL_WHEEL=/path/to/superlocalmemory-<version>-py3-none-any.whl for air-gapped installs, then run:');
-    console.error('  npm rebuild superlocalmemory');
+    console.error('This install needs network access to PyPI (or set SLM_LOCAL_WHEEL=/path/to/superlocalmemory-<version>-py3-none-any.whl for air-gapped installs).');
     console.error('Check network access, available disk space, and Python build prerequisites, then run:');
-    console.error('  npm rebuild superlocalmemory');
+    console.error('  npm rebuild -g superlocalmemory');
     console.error('No system Python packages or SLM durable data were modified.');
     return 1;
   }
@@ -391,7 +469,7 @@ function main(argv = process.argv.slice(2)) {
     console.error(
       `SuperLocalMemory: runtime identity check failed (npm=${packageVersion}, python=${installedVersion || 'unavailable'}).`,
     );
-    console.error('Run `npm rebuild superlocalmemory` to repair the package-owned runtime.');
+    console.error('Run `npm rebuild -g superlocalmemory` to repair the package-owned runtime.');
     return 1;
   }
 
@@ -416,12 +494,16 @@ function main(argv = process.argv.slice(2)) {
   console.log('      slm upgrade-hosts');
   console.log('');
   console.log('  Prefer to tune performance profiles? Use:  slm reconfigure');
+  printWhatsNew();
   console.log('');
   return 0;
 }
 
 if (require.main === module) {
-  process.exit(main());
+  const code = main();
+  const done = () => process.exit(code);
+  if (code !== 0) done();
+  else runMediaStep({ argv: process.argv.slice(2) }).then(() => runUpgradeStep()).then(done, done);
 }
 
 module.exports = {
@@ -430,10 +512,14 @@ module.exports = {
   hasNvidiaGpu,
   isSupportedPython,
   main,
+  runMediaStep,
   parsePythonVersion,
   probePython,
   pypiSpecifier,
   pythonCandidates,
+  pythonGuidance,
+  unsupportedMachine,
+  nodeRunsTranslated,
   runtimePythonPath,
   shouldForceCpuTorch,
   TORCH_CPU_INDEX_URL,

package/scripts/preuninstall.js

@@ -3,8 +3,10 @@
  * SuperLocalMemory NPM pre-uninstall notice.
  *
  * npm owns and removes the package directory, including its private Python
- * runtime. Durable SLM data has separate ownership and is never inspected or
- * modified by an application-code uninstall.
+ * runtime. Durable SLM data has separate ownership and is never modified or
+ * deleted by an application-code uninstall. The one thing worth saying: the
+ * images-and-documents models (about 1.5 GB) live in the data folder, so this
+ * names where they are, how big they are, and the command that removes them.
  *
  * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
  * Licensed under AGPL-3.0-or-later.
@@ -12,5 +14,55 @@
 
 'use strict';
 
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function dataRoot(env = process.env) {
+  return env.SLM_DATA_DIR
+    || env.SL_MEMORY_PATH
+    || env.SLM_HOME
+    || path.join(os.homedir(), '.superlocalmemory');
+}
+
+// Total bytes under dir; read-only, bounded, never follows links, never throws.
+function folderBytes(dir, limit = 200000) {
+  let total = 0;
+  let seen = 0;
+  const stack = [dir];
+  while (stack.length && seen < limit) {
+    const current = stack.pop();
+    let entries = [];
+    try { entries = fs.readdirSync(current, { withFileTypes: true }); } catch (_e) { continue; }
+    for (const entry of entries) {
+      seen += 1;
+      const full = path.join(current, entry.name);
+      try {
+        if (entry.isSymbolicLink()) continue;
+        if (entry.isDirectory()) stack.push(full);
+        else total += fs.lstatSync(full).size;
+      } catch (_e) { /* skip unreadable entries */ }
+    }
+  }
+  return total;
+}
+
+function humanSize(bytes) {
+  if (bytes >= 1024 ** 3) return (bytes / 1024 ** 3).toFixed(1) + ' GB';
+  return Math.max(1, Math.round(bytes / 1024 ** 2)) + ' MB';
+}
+
+function mediaEnvNotice(env = process.env, log = console.log) {
+  try {
+    const mediaDir = path.join(dataRoot(env), 'runtimes', 'media');
+    if (!fs.existsSync(mediaDir)) return;
+    log('Images & documents models are kept at ' + mediaDir + ' (' + humanSize(folderBytes(mediaDir)) + ').');
+    log('To remove them, run: slm media disable --remove-files');
+  } catch (_e) { /* a notice must never fail an uninstall */ }
+}
+
 console.log('SuperLocalMemory application code is being removed.');
-console.log('Memory data is preserved. No database, profile, backup, or configuration was inspected or changed.');
+console.log('Memory data is preserved. No database, profile, backup, or configuration was changed.');
+mediaEnvNotice();
+
+module.exports = { mediaEnvNotice, folderBytes, dataRoot };