@nitsan-ai/ragsuite-test 0.1.4 → 0.1.5

package/src/commands/update.js

@@ -2,23 +2,23 @@
 
 const fs = require('fs');
 const path = require('path');
-const { resolveRepoRoot, isImagesInstall, looksLikeGitCheckout } = require('../utils/paths');
+const { resolveRepoRoot, assertNativeDeploy, looksLikeGitCheckout } = require('../utils/paths');
 const { readConfig } = require('../utils/config');
 const { setActiveInstall } = require('../utils/global-config');
-const { captureCommand, runScript } = require('../utils/spawn');
+const { captureCommand } = require('../utils/spawn');
 const { info, warn, error } = require('../utils/log');
 
 const name = 'update';
-const summary = 'Update app in place (git pull or image pull) — keeps data & .env';
+const summary = 'git pull in place — keeps .env and data (no Docker)';
 
 function help() {
   return `Usage: ragsuite-test update
 
-Upgrades the active install without wiping data:
-  • Git install  → git pull (keeps .env + Docker volumes)
-  • Images install → docker compose pull (keeps .env + volumes)
+Upgrades the active git install without wiping data:
+  • git pull --ff-only in the install dir
+  • Keeps .env and any host Postgres/Redis/Chroma data
 
-Never runs docker compose down -v.
+Never runs docker compose (no volume risk).
 
 Typical flow after a new release:
   npm install -g @nitsan-ai/ragsuite-test@latest
@@ -39,6 +39,7 @@ function run(ctx) {
       repoRootFlag: ctx.globals.repoRoot,
       env: ctx.env,
     });
+    assertNativeDeploy(repoRoot);
   } catch (err) {
     error(err.message);
     return 1;
@@ -46,48 +47,18 @@ function run(ctx) {
 
   setActiveInstall(repoRoot);
   const cfg = readConfig(repoRoot);
-  const source = (cfg && cfg.source) || (isImagesInstall(repoRoot) ? 'images' : 'git');
-  const images = source === 'images' || isImagesInstall(repoRoot);
+  const source = (cfg && cfg.source) || 'git';
 
   info(`Updating install: ${repoRoot}`);
-  info(`  source=${source}`);
-  info('  (.env and Docker volumes are kept — never wiped)');
+  info(`  source=${source} mode=native`);
+  info('  (.env and database data are kept)');
   info('');
 
   if (ctx.globals.dryRun) {
-    info(`[dry-run] would update ${images ? 'images (compose pull)' : 'git (pull)'}`);
+    info('[dry-run] would update via git pull --ff-only');
     return 0;
   }
 
-  if (images) {
-    info('Pulling newer Docker images…');
-    const pull = captureCommand(
-      'docker',
-      ['compose', '-f', 'docker-compose.yml', 'pull'],
-      { cwd: repoRoot, env: ctx.env },
-    );
-    if (pull.status !== 0) {
-      error(`Image pull failed (exit ${pull.status}).`);
-      if (pull.stderr) error(String(pull.stderr).trimEnd());
-      error('Publish GHCR images / check IMAGE_TAG in .env, then retry.');
-      return 1;
-    }
-    info('Images pulled.');
-    info('');
-    info('Apply update:');
-    info('  ragsuite-test stop');
-    info('  ragsuite-test start');
-    info('(or: ragsuite-test start — compose recreate with new images)');
-    // Recreate containers with new images without wiping volumes
-    info('');
-    info('Recreating containers with new images (volumes preserved)…');
-    return runScript(repoRoot, path.join('scripts', 'docker-start-images.sh'), ['--detach'], {
-      dryRun: false,
-      env: { ...ctx.env, RAGSUITE_MODE: 'docker' },
-    });
-  }
-
-  // Git / checkout install
   if (!looksLikeGitCheckout(repoRoot) && !fs.existsSync(path.join(repoRoot, '.git'))) {
     error('This install has no .git directory. Re-run: ragsuite-test init --force');
     return 1;
@@ -113,8 +84,7 @@ function run(ctx) {
   info('Restart to apply:');
   info('  ragsuite-test stop');
   info('  ragsuite-test start');
-  info('');
-  info('Never: docker compose down -v  (would delete Postgres/Chroma data)');
+  info('  # or: cd install && npm run stop && npm start');
   return 0;
 }
 

package/src/index.js

@@ -19,7 +19,8 @@ function globalHelp() {
     'RAGSuite test CLI (experimental)',
     '',
     'Usage: ragsuite-test <command> [options]',
-    '       (from cli/: node src/index.js <command> [options])',
+    '',
+    'Deploy path: git clone + native npm scripts (no Docker).',
     '',
     'Commands:',
   ];
@@ -30,9 +31,8 @@ function globalHelp() {
     '',
     'Global options:',
     '  --help, -h              Show help',
-    '  --repo-root <path>      Monorepo / install root',
+    '  --repo-root <path>      Override active install',
     '  --from-git [url]        init: clone source (default public repo)',
-    '  --from-images           init: Docker images only (no app source on disk)',
     '  --install-dir <path>    init: install target (default ~/ragsuite-test)',
     '  --llm-api-key <key>     init: optional override for CUSTOM_LLM_INTERNAL_API_KEY',
     '  --smtp-host <host>      init: optional SMTP override',
@@ -40,11 +40,10 @@ function globalHelp() {
     '  --smtp-password <pass>  init: optional SMTP override',
     '  --email-from <email>    init: optional SMTP override',
     '  --force                 init: overwrite non-empty install dir / .env',
-    '  --yes, -y               Non-interactive (same defaults as plain init)',
-    '  --mode <docker|native>  Override config (Docker optional)',
+    '  --yes, -y               Non-interactive',
     '  --dry-run               Print actions without running (start/stop/doctor/logs/update)',
     '',
-    'Active install: ~/.ragsuite-test/config.json (set by init; used by start/update/stop)',
+    'Active install: ~/.ragsuite-test/config.json (set by init)',
     'Env: RAGSUITE_REPO_ROOT or RAGSUITE_INSTALL_DIR',
     '     RAGSUITE_TEST_LLM_API_KEY, RAGSUITE_TEST_SMTP_* , RAGSUITE_TEST_EMAIL_FROM',
     '',
@@ -94,7 +93,7 @@ async function main(argv = process.argv) {
     const code = typeof result?.then === 'function' ? await result : result;
     return typeof code === 'number' ? code : 0;
   } catch (err) {
-    if (err && (err.code === 'NOT_REPO_ROOT' || err.code === 'USAGE' || err.code === 'INSTALL_DIR_NONEMPTY' || err.code === 'ENV_EXISTS' || err.code === 'ENV_INCOMPLETE' || err.code === 'PORT_IN_USE' || err.code === 'LLM_KEY_INVALID' || err.code === 'SMTP_REQUIRED' || err.code === 'GIT_CLONE_FAILED' || err.code === 'MISSING_GIT')) {
+    if (err && (err.code === 'NOT_REPO_ROOT' || err.code === 'USAGE' || err.code === 'INSTALL_DIR_NONEMPTY' || err.code === 'ENV_EXISTS' || err.code === 'ENV_INCOMPLETE' || err.code === 'PORT_IN_USE' || err.code === 'LLM_KEY_INVALID' || err.code === 'SMTP_REQUIRED' || err.code === 'GIT_CLONE_FAILED' || err.code === 'MISSING_GIT' || err.code === 'IMAGES_REMOVED' || err.code === 'NATIVE_SCRIPT_MISSING')) {
       error(err.message);
       return 1;
     }

package/src/utils/args.js

@@ -72,7 +72,7 @@ function parseArgv(argv) {
       const { value, nextI } = takeValue('--mode', t, i);
       i = nextI;
       if (!value || String(value).startsWith('-')) {
-        const err = new Error('--mode requires docker or native');
+        const err = new Error('--mode requires native (docker was removed from deployment)');
         err.code = 'USAGE';
         throw err;
       }
@@ -208,8 +208,15 @@ function parseArgv(argv) {
 
 function normalizeMode(value) {
   const m = String(value).trim().toLowerCase();
-  if (m !== 'docker' && m !== 'native') {
-    const err = new Error(`Invalid mode "${value}" (use docker or native)`);
+  if (m === 'docker') {
+    const err = new Error(
+      'Docker mode was removed from deployment. Use native (omit --mode or pass --mode native).',
+    );
+    err.code = 'USAGE';
+    throw err;
+  }
+  if (m !== 'native') {
+    const err = new Error(`Invalid mode "${value}" (use native)`);
     err.code = 'USAGE';
     throw err;
   }

package/src/utils/config.js

@@ -10,11 +10,11 @@ function configPath(repoRoot) {
   return path.join(repoRoot, CONFIG_DIR, 'config.json');
 }
 
-function defaultConfig(repoRoot, mode = 'docker') {
+function defaultConfig(repoRoot) {
   const root = path.resolve(repoRoot);
   return {
     version: CONFIG_VERSION,
-    mode: mode === 'native' ? 'native' : 'docker',
+    mode: 'native',
     source: 'checkout',
     repoRoot: root,
     installDir: root,
@@ -23,7 +23,9 @@ function defaultConfig(repoRoot, mode = 'docker') {
 
 function normalizeSource(raw) {
   const s = String(raw || '').trim();
-  if (s === 'images' || s === 'git' || s === 'zip' || s === 'checkout') return s;
+  if (s === 'git' || s === 'checkout' || s === 'zip') return s === 'zip' ? 'checkout' : s;
+  // Legacy images installs are no longer supported for start/stop
+  if (s === 'images') return 'images';
   return 'checkout';
 }
 
@@ -39,7 +41,7 @@ function readConfig(repoRoot) {
     }
     return {
       version: Number(raw.version) || CONFIG_VERSION,
-      mode: raw.mode === 'native' ? 'native' : 'docker',
+      mode: 'native',
       source: normalizeSource(raw.source),
       repoRoot: path.resolve(String(raw.repoRoot || repoRoot)),
       installDir: path.resolve(String(raw.installDir || raw.repoRoot || repoRoot)),
@@ -62,37 +64,20 @@ function writeConfig(repoRoot, partial = {}) {
     ...existing,
     ...partial,
     version: CONFIG_VERSION,
-    source,
+    source: source === 'images' ? 'git' : source,
     repoRoot: path.resolve(partial.repoRoot || existing.repoRoot || repoRoot),
     installDir: path.resolve(
       partial.installDir || existing.installDir || partial.repoRoot || existing.repoRoot || repoRoot,
     ),
-    mode: (partial.mode || existing.mode) === 'native' ? 'native' : 'docker',
+    mode: 'native',
   };
   fs.writeFileSync(configPath(repoRoot), `${JSON.stringify(next, null, 2)}\n`, 'utf8');
   return next;
 }
 
-/**
- * Resolve runtime mode: CLI --mode > config > RAGSUITE_MODE > docker.
- */
-function resolveMode({ flagMode, repoRoot, env = process.env } = {}) {
-  if (flagMode === 'docker' || flagMode === 'native') {
-    return flagMode;
-  }
-  if (repoRoot) {
-    const cfg = readConfig(repoRoot);
-    if (cfg && (cfg.mode === 'docker' || cfg.mode === 'native')) {
-      return cfg.mode;
-    }
-  }
-  const fromEnv = String(env.RAGSUITE_MODE || '')
-    .trim()
-    .toLowerCase();
-  if (fromEnv === 'native') {
-    return 'native';
-  }
-  return 'docker';
+/** Deployment always uses native npm scripts. */
+function resolveMode() {
+  return 'native';
 }
 
 module.exports = {

package/src/utils/distribution.js

@@ -1,42 +1,36 @@
 'use strict';
 
 /**
- * Distribution modes for the testing CLI.
- *
- * - git-clone: `ragsuite-test init` (source on disk)
- * - images: `ragsuite-test init --from-images` (pull GHCR, no app source)
- * - local-checkout: --repo-root
+ * Distribution for the testing CLI.
+ * Deploy path is git clone + native npm scripts only (no Docker).
  */
 
 const MODE_LOCAL = 'local-checkout';
 const MODE_GIT = 'git-clone';
-const MODE_IMAGES = 'images';
-const MODE_REGISTRY = 'registry-compose';
 
 function assertSupportedInstall() {}
 
 function resolveComposeBundle() {
-  const err = new Error(
-    'Use: ragsuite-test init --from-images  (pull-only)  OR  ragsuite-test init  (git source)',
-  );
+  const err = new Error('Docker compose bundles were removed from deployment. Use: ragsuite-test init');
   err.code = 'DIST_NOT_READY';
   throw err;
 }
 
 function installHint() {
   return [
-    'Day-to-day:',
+    'Day-to-day (native / npm scripts — no Docker):',
     '  ragsuite-test start',
     '  ragsuite-test update',
     '  ragsuite-test stop',
+    'Or in the install dir:',
+    '  npm start',
+    '  npm run stop',
   ].join('\n');
 }
 
 module.exports = {
   MODE_LOCAL,
   MODE_GIT,
-  MODE_IMAGES,
-  MODE_REGISTRY,
   mode: MODE_GIT,
   assertSupportedInstall,
   resolveComposeBundle,

package/src/utils/git-install.js

@@ -81,7 +81,7 @@ function cloneGitToInstallDir(gitUrl, options = {}) {
   const repoRoot = target;
   if (!looksLikeRepoRoot(repoRoot) && !looksLikeFullBundleRoot(repoRoot)) {
     const err = new Error(
-      `Cloned repo at ${repoRoot} does not look like a RAGSuite monorepo (missing scripts/docker-start.sh).`,
+      `Cloned repo at ${repoRoot} does not look like a RAGSuite monorepo (missing scripts/native-start.sh or docker-start.sh).`,
     );
     err.code = 'GIT_INVALID_REPO';
     throw err;

package/src/utils/paths.js

@@ -12,9 +12,11 @@ function defaultInstallDir() {
 }
 
 function looksLikeGitCheckout(dir) {
-  const start = path.join(dir, 'scripts', 'docker-start.sh');
   const pkg = path.join(dir, 'package.json');
-  return fs.existsSync(start) && fs.existsSync(pkg);
+  const native = path.join(dir, 'scripts', 'native-start.sh');
+  const docker = path.join(dir, 'scripts', 'docker-start.sh');
+  // Prefer native marker; still recognize older checkouts that only had docker-start.sh
+  return fs.existsSync(pkg) && (fs.existsSync(native) || fs.existsSync(docker));
 }
 
 function looksLikeImagesInstall(dir) {
@@ -30,16 +32,15 @@ function looksLikeImagesInstall(dir) {
       /* fall through */
     }
   }
-  return !fs.existsSync(path.join(dir, 'scripts', 'docker-start.sh'));
+  return !fs.existsSync(path.join(dir, 'scripts', 'native-start.sh'));
 }
 
 function looksLikeRepoRoot(dir) {
-  return looksLikeGitCheckout(dir) || looksLikeImagesInstall(dir);
+  return looksLikeGitCheckout(dir);
 }
 
 function looksLikeFullBundleRoot(dir) {
-  if (!looksLikeGitCheckout(dir)) return false;
-  return fs.existsSync(path.join(dir, 'docker-compose.yml'));
+  return looksLikeGitCheckout(dir);
 }
 
 function walkUpForRepoRoot(startDir) {
@@ -130,7 +131,6 @@ function resolveRepoRoot({
     [
       'No RAGSuite install found.',
       '  First time:  ragsuite-test init',
-      '  Or images:   ragsuite-test init --from-images',
       '  Then:        ragsuite-test start',
     ].join('\n'),
   );
@@ -158,6 +158,33 @@ function isImagesInstall(repoRoot) {
   return looksLikeImagesInstall(repoRoot) && !looksLikeGitCheckout(repoRoot);
 }
 
+/**
+ * Reject legacy images-only installs (Docker deployment removed).
+ */
+function assertNativeDeploy(repoRoot) {
+  if (isImagesInstall(repoRoot)) {
+    const err = new Error(
+      [
+        'This install was created with --from-images (Docker). That path was removed.',
+        '  Your Docker volumes were NOT touched.',
+        '  Reinstall with source + native npm scripts:',
+        '    ragsuite-test init --install-dir ~/ragsuite-test-native',
+        '    ragsuite-test start',
+      ].join('\n'),
+    );
+    err.code = 'IMAGES_REMOVED';
+    throw err;
+  }
+  const native = path.join(repoRoot, 'scripts', 'native-start.sh');
+  if (!fs.existsSync(native)) {
+    const err = new Error(
+      `Missing scripts/native-start.sh in ${repoRoot}. Run: ragsuite-test update  (or re-init)`,
+    );
+    err.code = 'NATIVE_SCRIPT_MISSING';
+    throw err;
+  }
+}
+
 function isDirEmptyOrMissing(dir) {
   if (!fs.existsSync(dir)) return true;
   return fs.readdirSync(dir).filter((n) => n !== '.DS_Store').length === 0;
@@ -176,5 +203,6 @@ module.exports = {
   ensureRagsuiteDir,
   nativeLogDir,
   isImagesInstall,
+  assertNativeDeploy,
   isDirEmptyOrMissing,
 };

package/src/utils/port.js

@@ -67,14 +67,13 @@ async function assertPortsFree(ports = DEFAULT_INSTALL_PORTS) {
         '',
         'If a previous RAGSuite install is running:',
         '  ragsuite-test stop',
-        '  # or from a monorepo checkout: cd <checkout> && npm run down',
+        '  # or: npm run stop',
         '',
         'See what owns the ports (macOS/Linux):',
         '  lsof -nP -iTCP:9090 -sTCP:LISTEN',
-        '  lsof -nP -iTCP:9091 -sTCP:LISTEN',
+        '  lsof -nP -iTCP:9191 -sTCP:LISTEN',
         '  lsof -nP -iTCP:5436 -sTCP:LISTEN',
         '  lsof -nP -iTCP:6382 -sTCP:LISTEN',
-        '  docker ps',
       ].join('\n'),
     );
     err.code = 'PORT_IN_USE';

package/src/utils/prereqs.js

@@ -1,59 +1,40 @@
 'use strict';
 
 const { spawnSync } = require('child_process');
-const { info, warn, error } = require('./log');
+const { info, error } = require('./log');
 
 function commandExists(cmd) {
   const r = spawnSync('which', [cmd], { encoding: 'utf8' });
   return r.status === 0;
 }
 
-function dockerDaemonRunning() {
-  const r = spawnSync('docker', ['info'], {
-    encoding: 'utf8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-  return r.status === 0;
-}
-
 function nodeMajorOk() {
   const major = Number(String(process.versions.node).split('.')[0]);
   return Number.isFinite(major) && major >= 18;
 }
 
-/**
- * How to install a missing prerequisite (shown in doctor/init).
- */
 function installHintFor(issueKey) {
   const hints = {
     node: 'Install Node 18+: https://nodejs.org/ or `brew install node` / `sudo apt install nodejs`',
-    docker:
-      'Docker is optional. Install Docker Desktop, OR use --mode native (Postgres :5436 + Redis :6382 on the host).',
-    'docker-compose': 'Install Docker Desktop (includes compose) or the docker compose plugin.',
     python3: 'Install Python 3: `brew install python` / `sudo apt install python3 python3-venv`',
-    yarn: 'Optional: `corepack enable && corepack prepare yarn@stable --activate` or `npm i -g yarn`',
+    yarn: '`corepack enable && corepack prepare yarn@stable --activate` or `npm i -g yarn`',
     git: 'Install git: macOS `xcode-select --install` / `brew install git`; Linux `sudo apt install git`',
     postgres:
-      'Native mode: Postgres on localhost:5436, db ragsuite_v3. Example: `brew install postgresql@15` then create DB/user.',
-    redis: 'Native mode: Redis on localhost:6382. Example: `brew install redis` then `redis-server --port 6382`.',
+      'Postgres on localhost:5436, db ragsuite_v3. Example: `brew install postgresql@15` then create DB/user.',
+    redis: 'Redis on localhost:6382. Example: `brew install redis` then `redis-server --port 6382`.',
   };
   return hints[issueKey] || null;
 }
 
-/**
- * Pick run mode when user did not pass --mode.
- * Docker is never required — prefer native if Docker is unavailable.
- */
-function resolvePreferredMode(flagMode) {
-  if (flagMode === 'docker' || flagMode === 'native') return flagMode;
-  if (commandExists('docker') && dockerDaemonRunning()) return 'docker';
+/** Deployment is always native (npm scripts). */
+function resolvePreferredMode() {
   return 'native';
 }
 
 /**
- * Check prerequisites for install mode. Returns { ok, issues[], notes[], hints[] }.
+ * Check prerequisites for native deploy. Returns { ok, issues[], notes[], hints[] }.
  */
-function checkPrereqs(mode = 'native', options = {}) {
+function checkPrereqs(_mode = 'native', options = {}) {
   const { needGit = false } = options;
   const issues = [];
   const notes = [];
@@ -73,44 +54,28 @@ function checkPrereqs(mode = 'native', options = {}) {
 
   if (needGit) {
     if (!commandExists('git')) {
-      pushIssue('git not found (required for --from-git)', 'git');
+      pushIssue('git not found (required for init)', 'git');
     } else {
       notes.push('git present');
     }
   }
 
-  if (mode === 'docker') {
-    if (!commandExists('docker')) {
-      pushIssue('Docker CLI not found', 'docker');
-    } else if (!dockerDaemonRunning()) {
-      pushIssue('Docker daemon not running — start Docker Desktop / dockerd', 'docker');
-    } else {
-      notes.push('Docker CLI + daemon OK');
-      const compose = spawnSync('docker', ['compose', 'version'], { encoding: 'utf8' });
-      if (compose.status !== 0) {
-        pushIssue('docker compose plugin not available', 'docker-compose');
-      } else {
-        notes.push('docker compose OK');
-      }
-    }
+  notes.push('Deploy mode=native (Docker is not used)');
+  if (!commandExists('python3')) {
+    pushIssue('python3 not found', 'python3');
   } else {
-    notes.push('Mode=native — Docker is NOT required');
-    if (!commandExists('python3')) {
-      pushIssue('python3 not found (required for native mode)', 'python3');
-    } else {
-      notes.push('python3 present');
-    }
-    if (!commandExists('yarn')) {
-      notes.push('yarn missing — enable with corepack or npm i -g yarn');
-      const h = installHintFor('yarn');
-      if (h) hints.push(h);
-    } else {
-      notes.push('yarn present');
-    }
-    notes.push('Need Postgres :5436 (ragsuite_v3) and Redis :6382 on this machine');
-    hints.push(installHintFor('postgres'));
-    hints.push(installHintFor('redis'));
+    notes.push('python3 present');
   }
+  if (!commandExists('yarn')) {
+    notes.push('yarn missing — enable with corepack or npm i -g yarn');
+    const h = installHintFor('yarn');
+    if (h) hints.push(h);
+  } else {
+    notes.push('yarn present');
+  }
+  notes.push('Need Postgres :5436 (ragsuite_v3) and Redis :6382 on this machine');
+  hints.push(installHintFor('postgres'));
+  hints.push(installHintFor('redis'));
 
   if (process.platform === 'win32') {
     notes.push('Windows: use WSL or Git Bash — start/stop spawn bash scripts');
@@ -124,9 +89,9 @@ function checkPrereqs(mode = 'native', options = {}) {
   };
 }
 
-function printPrereqs(mode, options = {}) {
+function printPrereqs(mode = 'native', options = {}) {
   const { ok, issues, notes, hints } = checkPrereqs(mode, options);
-  info(`Prerequisites (mode=${mode}):`);
+  info('Prerequisites (native / npm scripts):');
   for (const n of notes) info(`  ✓ ${n}`);
   for (const i of issues) error(`  ✗ ${i}`);
   if (hints.length) {
@@ -134,16 +99,11 @@ function printPrereqs(mode, options = {}) {
     info('How to get missing pieces:');
     for (const h of hints) info(`  → ${h}`);
   }
-  if (!ok && mode === 'docker') {
-    warn('');
-    warn('Docker is optional. Re-run with --mode native if you prefer host Postgres/Redis (no Docker).');
-  }
   return ok;
 }
 
 module.exports = {
   commandExists,
-  dockerDaemonRunning,
   nodeMajorOk,
   installHintFor,
   resolvePreferredMode,

package/src/utils/images-install.js

@@ -1,106 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { defaultInstallDir } = require('./git-install');
-
-function templatesRoot() {
-  return path.join(__dirname, '..', '..', 'templates', 'images');
-}
-
-function isDirEmptyOrMissing(dir) {
-  if (!fs.existsSync(dir)) return true;
-  const items = fs.readdirSync(dir).filter((n) => n !== '.DS_Store');
-  return items.length === 0;
-}
-
-function copyFile(src, dest) {
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-}
-
-/**
- * Materialize a pull-only install dir (compose + scripts + .env.example).
- * No monorepo source.
- */
-function materializeImagesInstall(options = {}) {
-  const { installDir = defaultInstallDir(), force = false } = options;
-  const srcRoot = templatesRoot();
-  if (!fs.existsSync(path.join(srcRoot, 'docker-compose.yml'))) {
-    const err = new Error(
-      `Images templates missing in CLI package (${srcRoot}). Reinstall @nitsan-ai/ragsuite-test.`,
-    );
-    err.code = 'IMAGES_TEMPLATE_MISSING';
-    throw err;
-  }
-
-  const target = path.resolve(installDir);
-  if (!isDirEmptyOrMissing(target)) {
-    if (!force) {
-      const err = new Error(
-        [
-          `Install directory is not empty: ${target}`,
-          '  If already installed:  ragsuite-test start',
-          '  To upgrade in place:   ragsuite-test update',
-          '  To wipe & reinstall:   ragsuite-test init --from-images --force',
-          '  Or use another path:   ragsuite-test init --from-images --install-dir <path>',
-        ].join('\n'),
-      );
-      err.code = 'INSTALL_DIR_NONEMPTY';
-      throw err;
-    }
-    fs.rmSync(target, { recursive: true, force: true });
-  }
-
-  fs.mkdirSync(target, { recursive: true });
-  copyFile(
-    path.join(srcRoot, 'docker-compose.yml'),
-    path.join(target, 'docker-compose.yml'),
-  );
-  copyFile(
-    path.join(srcRoot, '.env.example'),
-    path.join(target, '.env.example'),
-  );
-  copyFile(
-    path.join(srcRoot, 'scripts', 'docker-start-images.sh'),
-    path.join(target, 'scripts', 'docker-start-images.sh'),
-  );
-  copyFile(
-    path.join(srcRoot, 'scripts', 'docker-stop-images.sh'),
-    path.join(target, 'scripts', 'docker-stop-images.sh'),
-  );
-  copyFile(
-    path.join(srcRoot, 'scripts', 'docker-doctor-images.sh'),
-    path.join(target, 'scripts', 'docker-doctor-images.sh'),
-  );
-  try {
-    fs.chmodSync(path.join(target, 'scripts', 'docker-start-images.sh'), 0o755);
-    fs.chmodSync(path.join(target, 'scripts', 'docker-stop-images.sh'), 0o755);
-    fs.chmodSync(path.join(target, 'scripts', 'docker-doctor-images.sh'), 0o755);
-  } catch {
-    /* windows */
-  }
-
-  // Minimal package.json so tooling can identify the install dir
-  fs.writeFileSync(
-    path.join(target, 'package.json'),
-    `${JSON.stringify(
-      {
-        name: 'ragsuite-images-install',
-        private: true,
-        description: 'RAGSuite pull-only images install (no source tree)',
-      },
-      null,
-      2,
-    )}\n`,
-    'utf8',
-  );
-
-  return { repoRoot: target };
-}
-
-module.exports = {
-  templatesRoot,
-  materializeImagesInstall,
-  defaultInstallDir,
-};