@nitsan-ai/ragsuite-test 0.1.3 → 0.1.5

package/src/commands/start.js

@@ -2,25 +2,23 @@
 
 const path = require('path');
 const { resolveMode } = require('../utils/config');
-const { resolveRepoRoot, isImagesInstall } = require('../utils/paths');
+const { resolveRepoRoot, assertNativeDeploy } = require('../utils/paths');
 const { runScript } = require('../utils/spawn');
 const { assertApiPortFree } = require('../utils/port');
 const { error } = require('../utils/log');
 
 const name = 'start';
-const summary = 'Start stack (git scripts or images pull-only)';
+const summary = 'Start app via npm scripts (native — no Docker)';
 
 function help() {
   return `Usage: ragsuite-test start [options]
 
-Git install: scripts/docker-start.sh or native-start.sh
-Images install (--from-images): scripts/docker-start-images.sh (pull, no build)
+Runs scripts/native-start.sh (same as \`npm start\` in the install dir).
+Does not use Docker — no containers, no volume risk.
 
 Options:
-  --mode <docker|native>   Override (git install; images always docker)
-  --repo-root <path>       Install root
+  --repo-root <path>       Override active install
   --dry-run                Print script path and exit 0
-  --detach, -d             Detached start
 `;
 }
 
@@ -29,24 +27,14 @@ async function run(ctx) {
     cwd: ctx.cwd,
     repoRootFlag: ctx.globals.repoRoot,
   });
-  const images = isImagesInstall(repoRoot);
-  const mode = images
-    ? 'docker'
-    : resolveMode({
-        flagMode: ctx.globals.mode,
-        repoRoot,
-        env: ctx.env,
-      });
-
-  let scriptName;
-  if (images) {
-    scriptName = 'docker-start-images.sh';
-  } else {
-    scriptName = mode === 'native' ? 'native-start.sh' : 'docker-start.sh';
+  try {
+    assertNativeDeploy(repoRoot);
+  } catch (err) {
+    error(err.message);
+    return 1;
   }
 
-  const forward = normalizeStartArgs(ctx.commandArgs);
-
+  const mode = resolveMode();
   if (!ctx.globals.dryRun) {
     try {
       await assertApiPortFree(ctx.env);
@@ -56,23 +44,10 @@ async function run(ctx) {
     }
   }
 
-  return runScript(repoRoot, path.join('scripts', scriptName), forward, {
+  return runScript(repoRoot, path.join('scripts', 'native-start.sh'), [], {
     dryRun: ctx.globals.dryRun,
     env: { ...ctx.env, RAGSUITE_MODE: mode },
   });
 }
 
-function normalizeStartArgs(args) {
-  const out = [];
-  for (const a of args) {
-    if (a === '--detach' || a === '-d') {
-      out.push('--detach');
-      continue;
-    }
-    if (a === '--') continue;
-    out.push(a);
-  }
-  return out;
-}
-
 module.exports = { name, summary, help, run };

package/src/commands/stop.js

@@ -2,22 +2,21 @@
 
 const path = require('path');
 const { resolveMode } = require('../utils/config');
-const { resolveRepoRoot, isImagesInstall } = require('../utils/paths');
+const { resolveRepoRoot, assertNativeDeploy } = require('../utils/paths');
 const { runScript } = require('../utils/spawn');
+const { error } = require('../utils/log');
 
 const name = 'stop';
-const summary = 'Stop stack (git scripts or images pull-only)';
+const summary = 'Stop native app processes (does not touch Docker volumes)';
 
 function help() {
   return `Usage: ragsuite-test stop [options]
 
-Git install: docker-stop.sh / native-stop.sh
-Images install: docker-stop-images.sh
-Never wipes Docker volumes.
+Runs scripts/native-stop.sh (same as \`npm run stop\` in the install dir).
+Stops host processes only — never runs docker compose down.
 
 Options:
-  --mode <docker|native>   Override (git install)
-  --repo-root <path>       Install root
+  --repo-root <path>       Override active install
   --dry-run                Print script path and exit 0
 `;
 }
@@ -27,24 +26,16 @@ function run(ctx) {
     cwd: ctx.cwd,
     repoRootFlag: ctx.globals.repoRoot,
   });
-  const images = isImagesInstall(repoRoot);
-  const mode = images
-    ? 'docker'
-    : resolveMode({
-        flagMode: ctx.globals.mode,
-        repoRoot,
-        env: ctx.env,
-      });
-
-  const scriptName = images
-    ? 'docker-stop-images.sh'
-    : mode === 'native'
-      ? 'native-stop.sh'
-      : 'docker-stop.sh';
-
-  return runScript(repoRoot, path.join('scripts', scriptName), [], {
+  try {
+    assertNativeDeploy(repoRoot);
+  } catch (err) {
+    error(err.message);
+    return 1;
+  }
+
+  return runScript(repoRoot, path.join('scripts', 'native-stop.sh'), [], {
     dryRun: ctx.globals.dryRun,
-    env: { ...ctx.env, RAGSUITE_MODE: mode },
+    env: { ...ctx.env, RAGSUITE_MODE: resolveMode() },
   });
 }
 

package/src/commands/update.js

@@ -2,86 +2,89 @@
 
 const fs = require('fs');
 const path = require('path');
-const { resolveRepoRoot } = require('../utils/paths');
+const { resolveRepoRoot, assertNativeDeploy, looksLikeGitCheckout } = require('../utils/paths');
 const { readConfig } = require('../utils/config');
+const { setActiveInstall } = require('../utils/global-config');
 const { captureCommand } = require('../utils/spawn');
-const { info, warn } = require('../utils/log');
+const { info, warn, error } = require('../utils/log');
 
 const name = 'update';
-const summary = 'Verify install path and print safe update steps';
+const summary = 'git pull in place — keeps .env and data (no Docker)';
 
 function help() {
-  return `Usage: ragsuite-test update [options]
+  return `Usage: ragsuite-test update
 
-Verifies the install/repo path and prints safe update steps.
-Git installs: git fetch + pull guidance (no destructive reset).
+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
+  ragsuite-test update
+  ragsuite-test start
 
 Options:
-  --repo-root <path>       Monorepo / install root
+  --repo-root <path>       Override active install
+  --dry-run                Print actions only
 `;
 }
 
 function run(ctx) {
-  const repoRoot = resolveRepoRoot({
-    cwd: ctx.cwd,
-    repoRootFlag: ctx.globals.repoRoot,
-    env: ctx.env,
-  });
+  let repoRoot;
+  try {
+    repoRoot = resolveRepoRoot({
+      cwd: ctx.cwd,
+      repoRootFlag: ctx.globals.repoRoot,
+      env: ctx.env,
+    });
+    assertNativeDeploy(repoRoot);
+  } catch (err) {
+    error(err.message);
+    return 1;
+  }
 
+  setActiveInstall(repoRoot);
   const cfg = readConfig(repoRoot);
-  const source = (cfg && cfg.source) || 'checkout';
-
-  info(`Install path OK: ${repoRoot}`);
-  info(`  source=${source}`);
-  info('');
+  const source = (cfg && cfg.source) || 'git';
 
-  info('Safe update steps:');
-  info('  1. Stop the stack (ragsuite-test stop --repo-root …)');
-  info('  2. Update sources (git pull)');
-  info('  3. Docker: npm run rebuild or docker compose build');
-  info('  4. Native: re-run backend/scripts/setup.sh if Python deps changed');
-  info('  5. Start again (ragsuite-test start --repo-root …)');
-  info('  6. Run doctor after upgrades');
-  info('');
-  info('Never: docker compose down -v (destroys Postgres/Chroma data).');
+  info(`Updating install: ${repoRoot}`);
+  info(`  source=${source} mode=native`);
+  info('  (.env and database data are kept)');
   info('');
 
-  const gitDir = path.join(repoRoot, '.git');
-  if (!fs.existsSync(gitDir)) {
-    warn('No .git directory — skip fetch/status. Re-init with --from-git if needed.');
+  if (ctx.globals.dryRun) {
+    info('[dry-run] would update via git pull --ff-only');
     return 0;
   }
 
-  const remote = captureCommand('git', ['remote', '-v'], { cwd: repoRoot, env: ctx.env });
-  if (remote.status !== 0 || !String(remote.stdout || '').trim()) {
-    warn('No git remote configured — skip fetch.');
-    return 0;
+  if (!looksLikeGitCheckout(repoRoot) && !fs.existsSync(path.join(repoRoot, '.git'))) {
+    error('This install has no .git directory. Re-run: ragsuite-test init --force');
+    return 1;
   }
 
-  info('Git remotes:');
-  info(String(remote.stdout).trimEnd());
-  info('');
-  info('Running git fetch (non-destructive)…');
-  const fetch = captureCommand('git', ['fetch', '--all', '--prune'], {
+  info('Fetching and pulling latest from git (non-destructive)…');
+  const pull = captureCommand('git', ['pull', '--ff-only'], {
     cwd: repoRoot,
     env: ctx.env,
   });
-  if (fetch.status !== 0) {
-    warn(
-      `git fetch failed (exit ${fetch.status}). Private remotes need credentials. Continuing with status only.`,
-    );
-    if (fetch.stderr) warn(String(fetch.stderr).trimEnd());
-  } else {
-    info('git fetch OK');
-  }
-
-  const status = captureCommand('git', ['status', '-sb'], { cwd: repoRoot, env: ctx.env });
-  if (status.stdout) {
-    info('');
-    info(String(status.stdout).trimEnd());
+  if (pull.status !== 0) {
+    warn(`git pull --ff-only failed (exit ${pull.status}). Trying fetch + status…`);
+    if (pull.stderr) warn(String(pull.stderr).trimEnd());
+    captureCommand('git', ['fetch', '--all', '--prune'], { cwd: repoRoot, env: ctx.env });
+    const st = captureCommand('git', ['status', '-sb'], { cwd: repoRoot, env: ctx.env });
+    if (st.stdout) info(String(st.stdout).trimEnd());
+    error('Could not fast-forward. Fix local commits or stash, then: cd install && git pull');
+    return 1;
   }
+  if (pull.stdout) info(String(pull.stdout).trimEnd());
+  info('git pull OK.');
+  info('');
+  info('Restart to apply:');
+  info('  ragsuite-test stop');
+  info('  ragsuite-test start');
+  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,10 +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)',
-    '  --dry-run               Print actions without running (start/stop/doctor/logs)',
+    '  --yes, -y               Non-interactive',
+    '  --dry-run               Print actions without running (start/stop/doctor/logs/update)',
     '',
+    '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',
     '',
@@ -93,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 [
-    'Choose an install style:',
-    '  Source on disk:  ragsuite-test init',
-    '  No source:       ragsuite-test init --from-images',
-    'Then:              ragsuite-test start --repo-root ~/ragsuite-test --detach',
+    '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

@@ -1,18 +1,17 @@
 'use strict';
 
 const fs = require('fs');
-const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
-const { looksLikeFullBundleRoot, looksLikeRepoRoot } = require('./paths');
+const {
+  defaultInstallDir,
+  looksLikeFullBundleRoot,
+  looksLikeRepoRoot,
+} = require('./paths');
 
 /** Default public monorepo (when the GitHub repo is public). */
 const DEFAULT_GIT_URL = 'https://github.com/nitsan-ai/RAGSUITE.git';
 
-function defaultInstallDir() {
-  return path.join(os.homedir(), 'ragsuite-test');
-}
-
 function requireGit() {
   const which = spawnSync('which', ['git'], { encoding: 'utf8' });
   if (which.status !== 0) {
@@ -49,7 +48,13 @@ function cloneGitToInstallDir(gitUrl, options = {}) {
   if (!isDirEmptyOrMissing(target)) {
     if (!force) {
       const err = new Error(
-        `Install directory is not empty: ${target}. Pass --force to remove and re-clone, or choose another --install-dir.`,
+        [
+          `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 --force',
+          '  Or use another path:   ragsuite-test init --install-dir <path>',
+        ].join('\n'),
       );
       err.code = 'INSTALL_DIR_NONEMPTY';
       throw err;
@@ -76,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/global-config.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+/** User-level CLI state (not inside the app install). Like other npm CLIs. */
+function globalConfigDir() {
+  return path.join(os.homedir(), '.ragsuite-test');
+}
+
+function globalConfigPath() {
+  return path.join(globalConfigDir(), 'config.json');
+}
+
+function readGlobalConfig() {
+  const file = globalConfigPath();
+  if (!fs.existsSync(file)) return null;
+  try {
+    const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (!raw || typeof raw !== 'object') return null;
+    return {
+      installDir: raw.installDir ? path.resolve(String(raw.installDir)) : null,
+      updatedAt: raw.updatedAt || null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+function writeGlobalConfig(partial = {}) {
+  const dir = globalConfigDir();
+  fs.mkdirSync(dir, { recursive: true });
+  const existing = readGlobalConfig() || {};
+  const next = {
+    ...existing,
+    ...partial,
+    updatedAt: new Date().toISOString(),
+  };
+  if (next.installDir) next.installDir = path.resolve(String(next.installDir));
+  fs.writeFileSync(globalConfigPath(), `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+  return next;
+}
+
+function setActiveInstall(installDir) {
+  return writeGlobalConfig({ installDir: path.resolve(installDir) });
+}
+
+function getActiveInstall() {
+  const g = readGlobalConfig();
+  return g && g.installDir ? g.installDir : null;
+}
+
+module.exports = {
+  globalConfigDir,
+  globalConfigPath,
+  readGlobalConfig,
+  writeGlobalConfig,
+  setActiveInstall,
+  getActiveInstall,
+};