@nitsan-ai/ragsuite-test 0.1.4 → 0.1.6

package/README.md

@@ -1,22 +1,33 @@
 # RAGSuite test CLI (`ragsuite-test`)
 
-npm-style install: **init once**, then **start / update / stop** — no `--repo-root` every time.
+npm-style deploy: **init once**, then **start / update / stop** via host **npm scripts** — **no Docker**.
 
 ```bash
 npm install -g @nitsan-ai/ragsuite-test
 
 # First time only
 ragsuite-test init
-# or without app source on disk:
-# ragsuite-test init --from-images
+# clones → ~/ragsuite-test
 
+# Needs Postgres :5436 + Redis :6382 (auto-started via data-only compose if Docker is available)
 ragsuite-test start
-# API http://localhost:9090  ·  Web http://localhost:9091
+# API http://localhost:9090  ·  Web http://localhost:9191
 
 ragsuite-test stop
+# stops host app + leftover Docker app containers; keeps DB volumes
 ```
 
-Active install is remembered in `~/.ragsuite-test/config.json` (default app dir: `~/ragsuite-test`).
+Same under the hood as:
+
+```bash
+cd ~/ragsuite-test
+npm start          # scripts/native-start.sh
+npm run stop       # scripts/native-stop.sh
+```
+
+Active install is remembered in `~/.ragsuite-test/config.json`.
+
+**Data safety:** `start` may run `docker compose up -d postgres redis` only (existing volumes). It never runs `down -v`. App code always runs natively.
 
 ---
 
@@ -24,28 +35,28 @@ Active install is remembered in `~/.ragsuite-test/config.json` (default app dir:
 
 ```bash
 npm install -g @nitsan-ai/ragsuite-test@latest
-ragsuite-test update
+ragsuite-test update    # git pull only
 ragsuite-test start
 ```
 
-| Install type | What `update` does |
-|--------------|--------------------|
-| Git (`init`) | `git pull` in `~/ragsuite-test` |
-| Images (`init --from-images`) | `docker compose pull` + recreate containers |
-
 **Never** run `docker compose down -v` or `init --force` unless you mean to wipe data.
 
-If you already installed and run `init` again → it says **Already installed** and exits OK (does not wipe).
+If you already installed and run `init` again → **Already installed** (exit OK).
 
 ---
 
-## Which first-time install?
+## Prerequisites (host)
+
+| Tool | Notes |
+|------|--------|
+| Node.js 18+ | |
+| Python 3 + venv | backend |
+| Yarn | Expo frontend |
+| Git | `init` clone |
+| Postgres + Redis | Host brew **or** data-only compose (`postgres`/`redis` services) on :5436 / :6382 |
+| Docker (optional) | Only to auto-start/reuse existing postgres/redis volumes |
 
-| | **Git source** `init` | **Images** `init --from-images` |
-|--|----------------------|----------------------------------|
-| App code on disk | Yes | No |
-| Docker | Optional (`--mode native`) | Required |
-| Best for | Dev / native | Testers / “just run it” |
+Docker is **not** required to run the API/UI (those are native).
 
 ---
 
@@ -53,17 +64,18 @@ If you already installed and run `init` again → it says **Already installed**
 
 | Command | Purpose |
 |---------|---------|
-| `init` | First-time install |
-| `start` | Start app (uses saved install path) |
-| `stop` | Stop app (volumes kept) |
-| `update` | Upgrade code/images in place |
-| `doctor` | Health / prereqs |
+| `init` | First-time git install (no port checks) |
+| `start` | `scripts/native-start.sh` (+ data services if needed) |
+| `stop` | Native PIDs + leftover app containers (DB kept) |
+| `update` | `git pull` in place |
+| `doctor` | Native prereq checks |
+| `logs` | Tail `.ragsuite/native/*.log` |
 | `version` | CLI version |
 
 ## Ports
 
-API **9090** · Web **9091** (Docker/images) · Web **9191** (native) · Postgres **5436** · Redis **6382**
+API **9090** · Web **9191** · Postgres **5436** · Redis **6382** · Chroma **8004** (started by native-start if needed)
 
 ## Publish (maintainers)
 
-See [PUBLISH.md](./PUBLISH.md). Also publish GHCR images before `--from-images` works for others.
+See [PUBLISH.md](./PUBLISH.md).

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@nitsan-ai/ragsuite-test",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
-  "description": "RAGSuite testing CLI — init once, then start/update/stop (npm-style).",
+  "description": "RAGSuite testing CLI — init once, then start/update/stop via native npm scripts.",
   "main": "src/index.js",
   "bin": {
     "ragsuite-test": "./bin/ragsuite-test.js"
@@ -10,7 +10,6 @@
   "files": [
     "bin/",
     "src/",
-    "templates/",
     "package.json",
     "README.md",
     "LICENSE"

package/src/commands/doctor.js

@@ -2,20 +2,22 @@
 
 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 = 'doctor';
-const summary = 'Run doctor checks (git or images install)';
+const summary = 'Check native deploy prerequisites';
 
 function help() {
   return `Usage: ragsuite-test doctor [options]
 
-Git install: scripts/doctor.sh
-Images install: scripts/docker-doctor-images.sh
+Runs scripts/doctor.sh with RAGSUITE_MODE=native.
+
+Postgres (:5436) and Redis (:6382) must be reachable for a real install.
+In CI smoke, runtime TCP checks are skipped unless RAGSUITE_DOCTOR_STRICT=1.
 
 Options:
-  --mode <docker|native>   Git install gate
   --repo-root <path>
   --dry-run
 `;
@@ -26,18 +28,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 script = images ? 'docker-doctor-images.sh' : 'doctor.sh';
-  return runScript(repoRoot, path.join('scripts', script), [], {
+  try {
+    assertNativeDeploy(repoRoot);
+  } catch (err) {
+    error(err.message);
+    return 1;
+  }
+
+  return runScript(repoRoot, path.join('scripts', 'doctor.sh'), [], {
     dryRun: ctx.globals.dryRun,
-    env: { ...ctx.env, RAGSUITE_MODE: mode },
+    env: { ...ctx.env, RAGSUITE_MODE: resolveMode() },
   });
 }
 

package/src/commands/init.js

@@ -5,7 +5,6 @@ const { writeConfig, CONFIG_DIR, readConfig } = require('../utils/config');
 const {
   ensureRagsuiteDir,
   resolveRepoRoot,
-  isImagesInstall,
   looksLikeRepoRoot,
   isDirEmptyOrMissing,
 } = require('../utils/paths');
@@ -16,42 +15,36 @@ const {
   defaultInstallDir,
   cloneGitToInstallDir,
 } = require('../utils/git-install');
-const { materializeImagesInstall } = require('../utils/images-install');
 const { detectOs } = require('../utils/os-detect');
-const {
-  printPrereqs,
-  resolvePreferredMode,
-} = require('../utils/prereqs');
+const { printPrereqs, resolvePreferredMode } = require('../utils/prereqs');
+const { info, warn, error } = require('../utils/log');
 const {
   generateJwtSecret,
   isPlaceholderSecret,
   writeInstallEnv,
 } = require('../utils/env-file');
-const { assertPortsFree } = require('../utils/port');
-const { info, warn, error } = require('../utils/log');
 
 const name = 'init';
-const summary = 'First-time install (git or images). Safe if already installed.';
+const summary = 'First-time install (git + native npm scripts). Safe if already installed.';
 
-function printSuccess(repoRoot, mode, source) {
+function printSuccess(repoRoot) {
   info('');
   info('=== Install complete ===');
   info(`  Install dir : ${repoRoot}`);
-  info(`  Source      : ${source}`);
-  info(`  Mode        : ${mode}`);
+  info('  Mode        : native (npm scripts — no Docker)');
   info('');
   info('  API  http://localhost:9090');
-  if (source === 'images' || mode === 'docker') {
-    info('  Web  http://localhost:9091');
-  } else {
-    info('  Web  http://localhost:9191');
-  }
+  info('  Web  http://localhost:9191');
   info('');
   info('Next (no --repo-root needed):');
   info('  ragsuite-test start');
   info('  ragsuite-test stop');
   info('  ragsuite-test update   # later upgrades, keeps data');
   info('');
+  info('Or in the install directory:');
+  info('  npm start');
+  info('  npm run stop');
+  info('');
   info(installHint());
 }
 
@@ -61,11 +54,11 @@ function printAlreadyInstalled(repoRoot) {
   info('');
   info('=== Already installed ===');
   info(`  ${repoRoot}`);
-  if (cfg) info(`  source=${cfg.source} mode=${cfg.mode}`);
+  if (cfg) info(`  source=${cfg.source} mode=native`);
   info('');
   info('Use:');
-  info('  ragsuite-test start     # run the app');
-  info('  ragsuite-test update    # upgrade code/images (keeps .env + data)');
+  info('  ragsuite-test start     # run the app (npm scripts)');
+  info('  ragsuite-test update    # upgrade code (keeps .env + data)');
   info('  ragsuite-test stop');
   info('');
   info('Do NOT run init --force unless you intend to wipe and reinstall.');
@@ -78,24 +71,24 @@ function isInitializedInstall(dir) {
 function help() {
   return `Usage: ragsuite-test init [options]
 
-First-time setup only (npm-style):
+First-time setup (npm-style, no Docker):
 
   ragsuite-test init                 # git clone → ~/ragsuite-test
-  ragsuite-test init --from-images   # Docker images only (no app source)
+  ragsuite-test start                # scripts/native-start.sh
 
 If already installed, init exits OK and tells you to start/update.
 
+Requires host Postgres (:5436) and Redis (:6382).
+
 Day-to-day:
   ragsuite-test start
   ragsuite-test update
   ragsuite-test stop
 
 Options:
-  --from-images            Images-only install
   --from-git [url]         Clone URL (default public repo)
   --repo-root <path>       Point at an existing checkout
   --install-dir <path>     Default: ~/ragsuite-test
-  --mode <docker|native>   Git install only
   --force                  Wipe install dir and reinstall (destructive)
   --yes, -y                Non-interactive
 `;
@@ -118,10 +111,9 @@ function resolveLlmOverride(g, env) {
   return null;
 }
 
-function countSources(fromGit, fromImages, repoRootFlag) {
+function countSources(fromGit, repoRootFlag) {
   let n = 0;
   if (fromGit !== null && fromGit !== undefined) n += 1;
-  if (fromImages) n += 1;
   if (repoRootFlag) n += 1;
   return n;
 }
@@ -135,8 +127,30 @@ async function run(ctx) {
     return 1;
   }
 
-  if (countSources(g.fromGit, g.fromImages, g.repoRoot) > 1) {
-    error('Use only one of --from-images, --from-git, or --repo-root');
+  if (g.fromImages) {
+    error(
+      [
+        '--from-images was removed (Docker deployment retired).',
+        '  Use:  ragsuite-test init',
+        '  Then: ragsuite-test start',
+      ].join('\n'),
+    );
+    return 1;
+  }
+
+  if (g.mode === 'docker') {
+    error(
+      [
+        'Docker mode was removed from deployment.',
+        '  Init always uses native npm scripts (no containers).',
+        '  Omit --mode, or use --mode native.',
+      ].join('\n'),
+    );
+    return 1;
+  }
+
+  if (countSources(g.fromGit, g.repoRoot) > 1) {
+    error('Use only one of --from-git or --repo-root');
     return 1;
   }
 
@@ -144,11 +158,9 @@ async function run(ctx) {
   info(`OS: ${osInfo.label} (${osInfo.platform})`);
 
   let fromGit = g.fromGit;
-  let fromImages = Boolean(g.fromImages);
   let repoRootFlag = g.repoRoot;
   const installDir = path.resolve(g.installDir || defaultInstallDir());
 
-  // Existing configured install → friendly no-op (like other npm CLIs)
   if (!g.force) {
     if (repoRootFlag && isInitializedInstall(path.resolve(repoRootFlag))) {
       printAlreadyInstalled(path.resolve(repoRootFlag));
@@ -160,20 +172,15 @@ async function run(ctx) {
     }
   }
 
-  if (!fromImages && fromGit === null && !repoRootFlag) {
+  if (fromGit === null && !repoRootFlag) {
     fromGit = '';
     info(`First-time install (git): ${DEFAULT_GIT_URL}`);
     info(`  → ${installDir}`);
   }
-  if (fromImages) {
-    info(`First-time install (images, no source): → ${installDir}`);
-  }
 
-  // Checkout already on disk but never inited → wire config/.env, do not re-clone
   if (
     !g.force &&
     !repoRootFlag &&
-    !fromImages &&
     looksLikeRepoRoot(installDir) &&
     !readConfig(installDir)
   ) {
@@ -194,10 +201,10 @@ async function run(ctx) {
     return 1;
   }
 
-  let mode = fromImages ? 'docker' : g.mode || resolvePreferredMode(null);
-  info(`Run mode: ${mode}`);
+  const mode = resolvePreferredMode();
+  info(`Run mode: ${mode} (npm scripts — Docker not used)`);
 
-  const needGit = !fromImages && fromGit !== null && fromGit !== undefined;
+  const needGit = fromGit !== null && fromGit !== undefined;
   if (!printPrereqs(mode, { needGit })) {
     error('Fix prerequisites above and re-run init');
     return 1;
@@ -209,24 +216,14 @@ async function run(ctx) {
   const llmKey = resolveLlmOverride(g, ctx.env);
   const smtp = optionalSmtpOverrides(g, ctx.env);
 
-  if (ctx.env.RAGSUITE_TEST_SKIP_PORT_CHECK !== '1') {
-    try {
-      await assertPortsFree();
-    } catch (err) {
-      error(err.message);
-      return 1;
-    }
-  }
+  // Init only installs files — do not require ports free.
+  // (Postgres/Redis being "in use" is good; API busy is a start-time concern.)
 
   let repoRoot;
   let source = 'checkout';
 
   try {
-    if (fromImages) {
-      const result = materializeImagesInstall({ installDir, force: g.force });
-      repoRoot = result.repoRoot;
-      source = 'images';
-    } else if (fromGit !== null && fromGit !== undefined) {
+    if (fromGit !== null && fromGit !== undefined) {
       const url = fromGit === '' ? DEFAULT_GIT_URL : fromGit;
       const result = cloneGitToInstallDir(url, { installDir, force: g.force });
       repoRoot = result.repoRoot;
@@ -237,7 +234,6 @@ async function run(ctx) {
         repoRootFlag,
         env: ctx.env,
       });
-      if (isImagesInstall(repoRoot)) source = 'images';
     }
   } catch (err) {
     error(err.message || String(err));
@@ -246,7 +242,7 @@ async function run(ctx) {
 
   ensureRagsuiteDir(repoRoot);
   const cfg = writeConfig(repoRoot, {
-    mode,
+    mode: 'native',
     source,
     repoRoot,
     installDir: repoRoot,
@@ -273,7 +269,7 @@ async function run(ctx) {
   }
 
   info(`Config: mode=${cfg.mode} source=${cfg.source}`);
-  printSuccess(repoRoot, mode, source);
+  printSuccess(repoRoot);
   return 0;
 }
 

package/src/commands/logs.js

@@ -2,23 +2,20 @@
 
 const fs = require('fs');
 const path = require('path');
-const { resolveMode } = require('../utils/config');
-const { resolveRepoRoot, nativeLogDir } = require('../utils/paths');
+const { resolveRepoRoot, nativeLogDir, assertNativeDeploy } = require('../utils/paths');
 const { runCommand } = require('../utils/spawn');
 const { error, info } = require('../utils/log');
 
 const name = 'logs';
-const summary = 'Follow Docker compose or native process logs';
+const summary = 'Follow native process logs';
 
 function help() {
   return `Usage: ragsuite-test logs [options]
 
-Docker mode: docker compose logs -f (same as root npm run logs).
-Native mode: tail -f .ragsuite/native/*.log when present.
+Tails .ragsuite/native/*.log (host processes — no Docker).
 
 Options:
-  --mode <docker|native>   Override config / RAGSUITE_MODE
-  --repo-root <path>       Monorepo root
+  --repo-root <path>       Install root
   --dry-run                Print the command and exit 0
 `;
 }
@@ -28,36 +25,27 @@ function run(ctx) {
     cwd: ctx.cwd,
     repoRootFlag: ctx.globals.repoRoot,
   });
-  const mode = resolveMode({
-    flagMode: ctx.globals.mode,
-    repoRoot,
-    env: ctx.env,
-  });
-
-  if (mode === 'native') {
-    const dir = nativeLogDir(repoRoot);
-    let logs = [];
-    if (fs.existsSync(dir)) {
-      logs = fs
-        .readdirSync(dir)
-        .filter((f) => f.endsWith('.log'))
-        .map((f) => path.join(dir, f));
-    }
-    if (logs.length === 0) {
-      error(
-        `No native log files under ${dir}. Start with mode=native first, or use --mode docker.`,
-      );
-      return 1;
-    }
-    info(`Following ${logs.length} native log file(s)…`);
-    return runCommand('tail', ['-f', ...logs], {
-      cwd: repoRoot,
-      dryRun: ctx.globals.dryRun,
-      env: ctx.env,
-    });
+  try {
+    assertNativeDeploy(repoRoot);
+  } catch (err) {
+    error(err.message);
+    return 1;
   }
 
-  return runCommand('docker', ['compose', 'logs', '-f'], {
+  const dir = nativeLogDir(repoRoot);
+  let logs = [];
+  if (fs.existsSync(dir)) {
+    logs = fs
+      .readdirSync(dir)
+      .filter((f) => f.endsWith('.log'))
+      .map((f) => path.join(dir, f));
+  }
+  if (logs.length === 0) {
+    error(`No native log files under ${dir}. Start with: ragsuite-test start`);
+    return 1;
+  }
+  info(`Following ${logs.length} native log file(s)…`);
+  return runCommand('tail', ['-f', ...logs], {
     cwd: repoRoot,
     dryRun: ctx.globals.dryRun,
     env: ctx.env,

package/src/commands/start.js

@@ -2,25 +2,26 @@
 
 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 { error, info } = require('../utils/log');
 
 const name = 'start';
-const summary = 'Start stack (git scripts or images pull-only)';
+const summary = 'Start app via npm scripts (native); auto-starts DB containers if needed';
 
 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).
+
+App runs on the host. If Postgres/Redis are down, start may bring up
+data-only compose services (postgres + redis) using existing volumes —
+never \`down -v\`. Backend/frontend Docker containers are not started.
 
 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 +30,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);
@@ -54,25 +45,14 @@ async function run(ctx) {
       error(err.message);
       return 1;
     }
+  } else {
+    info('[dry-run] would run scripts/native-start.sh');
   }
 
-  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,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 { error } = require('../utils/log');
 
 const name = 'stop';
-const summary = 'Stop stack (git scripts or images pull-only)';
+const summary = 'Stop native app + leftover Docker app containers (keeps DB 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:
+  • Stops host API / Expo / chroma PIDs
+  • Stops leftover Docker backend/frontend/worker if present
+  • Leaves postgres/redis running (and never uses down -v)
 
 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 +28,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() },
   });
 }