@nitsan-ai/ragsuite-test 0.1.1 → 0.1.2

package/README.md

@@ -1,64 +1,48 @@
 # RAGSuite test CLI (`ragsuite-test`)
 
-> **TESTING PACKAGE** — `@nitsan-ai/ragsuite-test` / `ragsuite-test` is temporary.
-> **Not** the final production `@nitsan-ai/ragsuite` / `ragsuite` CLI (later release).
+> **TESTING PACKAGE** — temporary. Final public CLI will be `ragsuite` later.
 
-Wraps monorepo Docker/native scripts. Does **not** reimplement compose.
-
-Requires **Node.js 18+**. **Docker is optional.** Public deploy path: **`npm` → `init --from-git`**.
-
-## Prerequisites
-
-| Need | Why | How to get it |
-|------|-----|----------------|
-| Node.js 18+ | CLI + native frontend tooling | https://nodejs.org · `brew install node` · `sudo apt install nodejs` |
-| git | `--from-git` clone | `xcode-select --install` · `brew install git` · `sudo apt install git` |
-| **SMTP** | No prompts. Real values only in **local `.env`** (gitignored) | Gmail App Password → edit `.env` |
-| LLM API key | Default in `.env.example` / `.env` — no prompt | Override in `.env` or `--llm-api-key` |
-| **Either Docker** *or* **native data stores** | Run the stack | See modes below |
-
-### Mode A — Docker (optional)
-
-- Docker Desktop / daemon + `docker compose`
-- https://www.docker.com/products/docker-desktop/
-
-### Mode B — Native (no Docker)
-
-- `python3`, `yarn` (or corepack)
-- Postgres on **localhost:5436**, database `ragsuite_v3`
-- Redis on **localhost:6382**
-
-## Install (public)
+**One-command public install** (GitHub repo must be public):
 
 ```bash
 npm install -g @nitsan-ai/ragsuite-test
-
-ragsuite-test init --yes \
-  --from-git \
-  --install-dir ~/ragsuite-test \
-  --mode docker
-
+ragsuite-test init
 ragsuite-test start --repo-root ~/ragsuite-test --detach
-# API http://localhost:9090  ·  Web http://localhost:9091
 ```
 
-SMTP + LLM: **no init prompts**. JWT is auto-generated. Real SMTP belongs only in local `.env` (never commit). If `.env.example` still has placeholders, init writes smoke SMTP so the app can start — edit `.env` for real mail.
+That clones `https://github.com/nitsan-ai/RAGSUITE.git` into `~/ragsuite-test`, writes `.env` (no SMTP/LLM questions), and picks **Docker** if the daemon is up, otherwise **native**.
 
-No Docker:
+- API: http://localhost:9090  
+- Web (Docker): http://localhost:9091  
+- Web (native): http://localhost:9191  
 
 ```bash
-ragsuite-test init --yes --from-git --install-dir ~/ragsuite-test --mode native
-ragsuite-test start --repo-root ~/ragsuite-test
-# API :9090 · Expo web :9191
+ragsuite-test stop --repo-root ~/ragsuite-test
 ```
 
-Existing checkout:
+## Prerequisites
+
+| Need | Required? | How |
+|------|-----------|-----|
+| Node.js 18+ | Yes | https://nodejs.org · `brew install node` |
+| git | Yes | `xcode-select --install` · `brew install git` |
+| Docker | No | Optional; without it init uses native (needs Postgres `:5436` + Redis `:6382`) |
+
+Real SMTP belongs only in local `.env` (gitignored). Init never asks for it.
+
+## Advanced (optional)
 
 ```bash
-ragsuite-test init --yes --repo-root /path/to/RAGSUITE --mode native
-```
+# Force native / docker
+ragsuite-test init --mode native
+ragsuite-test init --mode docker
 
-Interactive: `ragsuite-test init`
+# Custom install dir
+ragsuite-test init --install-dir ~/my-ragsuite
+
+# Existing checkout (CI / developers)
+ragsuite-test init --repo-root /path/to/RAGSUITE
+```
 
 ## Ports
 
@@ -70,28 +54,25 @@ Interactive: `ragsuite-test init`
 | Postgres | 5436 |
 | Redis | 6382 |
 
-```bash
-ragsuite-test stop --repo-root ~/ragsuite-test
-lsof -nP -iTCP:9090 -sTCP:LISTEN
-docker ps
-```
+Busy ports: `ragsuite-test stop --repo-root ~/ragsuite-test` · `lsof -nP -iTCP:9090 -sTCP:LISTEN`
 
 ## Commands
 
 | Command | Behavior |
 |---------|----------|
-| `init` | git clone or checkout → `.env` + config |
-| `start` / `stop` | `scripts/docker-*.sh` or `native-*.sh` |
-| `doctor` | prereqs + `scripts/doctor.sh` |
+| `init` | Clone public repo → `.env` + config (default) |
+| `start` / `stop` | Docker or native scripts |
+| `doctor` | Health / prereq hints |
 | `logs` / `update` / `version` | As before |
 
 ## Publish
 
-See [PUBLISH.md](./PUBLISH.md) and [TEST_DISTRIBUTION.md](./TEST_DISTRIBUTION.md).
+See [PUBLISH.md](./PUBLISH.md).
 
 ```bash
 cd cli && npm run prepublish:check
-RAGSUITE_TEST_ALLOW_PUBLISH=1 npm publish --access public   # only when approved
+# Only when approved:
+RAGSUITE_TEST_ALLOW_PUBLISH=1 npm publish --access public
 ```
 
 ## Windows

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@nitsan-ai/ragsuite-test",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "private": false,
-  "description": "RAGSuite testing CLI (ragsuite-test) — install from ZIP or --repo-root checkout. Temporary npm identity before public ragsuite release.",
+  "description": "RAGSuite testing CLI (ragsuite-test) — public install: npm i -g && ragsuite-test init (clones GitHub). Temporary name before public ragsuite release.",
   "main": "src/index.js",
   "bin": {
     "ragsuite-test": "./bin/ragsuite-test.js"

package/src/commands/init.js

@@ -2,7 +2,7 @@
 
 const path = require('path');
 const { writeConfig, CONFIG_DIR } = require('../utils/config');
-const { ensureRagsuiteDir, resolveRepoRoot, looksLikeRepoRoot } = require('../utils/paths');
+const { ensureRagsuiteDir, resolveRepoRoot } = require('../utils/paths');
 const { assertSupportedInstall, installHint } = require('../utils/distribution');
 const {
   DEFAULT_GIT_URL,
@@ -13,20 +13,17 @@ const { detectOs } = require('../utils/os-detect');
 const {
   printPrereqs,
   resolvePreferredMode,
-  dockerDaemonRunning,
-  commandExists,
 } = require('../utils/prereqs');
-const { ask, choose } = require('../utils/prompt');
 const {
   generateJwtSecret,
   isPlaceholderSecret,
   writeInstallEnv,
 } = require('../utils/env-file');
 const { assertPortsFree } = require('../utils/port');
-const { info, warn, error } = require('../utils/log');
+const { info, error } = require('../utils/log');
 
 const name = 'init';
-const summary = 'Installer wizard: git clone or checkout → .env + config';
+const summary = 'One-command install: clone public GitHub repo → .env + config';
 
 function printSuccess(repoRoot, mode) {
   info('');
@@ -42,9 +39,6 @@ function printSuccess(repoRoot, mode) {
     info('  Web  http://localhost:9091  (Docker nginx)');
   }
   info('');
-  info('  Docker is optional: native mode needs host Postgres :5436 + Redis :6382.');
-  info('  Each install directory is one deployment / one organization.');
-  info('');
   info('Next steps:');
   info(`  1. ragsuite-test start --repo-root ${repoRoot}${mode === 'docker' ? ' --detach' : ''}`);
   if (mode === 'native') {
@@ -60,29 +54,23 @@ function printSuccess(repoRoot, mode) {
 function help() {
   return `Usage: ragsuite-test init [options]
 
-Interactive installer (or --yes for CI) that:
-  - detects OS / prerequisites (Docker is optional)
-  - clones the public monorepo or configures an existing checkout
-  - writes .ragsuite-test/config.json and .env
-  - JWT is auto-generated; SMTP + LLM defaults come from .env.example
-  - checks ports 9090, 9091, 5436, 6382
-
-Install sources (pick one):
-  --from-git [url]         Clone public monorepo (default: ${DEFAULT_GIT_URL})
-  --repo-root <path>       Use an existing monorepo checkout
+Simple public install (default — no questions):
+  clones ${DEFAULT_GIT_URL}
+  into ~/ragsuite-test
+  picks docker mode if Docker is running, otherwise native
+  writes .env (JWT auto; SMTP/LLM from .env.example — no prompts)
 
-Run mode (Docker is NOT required):
-  --mode native            Default when Docker is unavailable — host Postgres/Redis
-  --mode docker            Full compose stack (needs Docker Desktop / daemon)
+  ragsuite-test init
+  ragsuite-test start --repo-root ~/ragsuite-test --detach
 
-Optional overrides (defaults come from .env.example — usually not needed):
-  --llm-api-key <key>      Override CUSTOM_LLM_INTERNAL_API_KEY
-  --smtp-host / --smtp-user / --smtp-password / --email-from
-
-Options:
-  --install-dir <path>     Target for --from-git (default: ~/ragsuite-test)
+Advanced (optional):
+  --from-git [url]         Clone this URL instead of the default
+  --repo-root <path>       Use an existing checkout (no clone)
+  --install-dir <path>     Clone target (default: ~/ragsuite-test)
+  --mode <docker|native>   Force run mode
   --force                  Overwrite non-empty install dir / existing .env
-  --yes, -y                Non-interactive (requires --from-git or --repo-root)
+  --yes, -y                Same defaults; for scripts/CI
+  --llm-api-key / --smtp-* Optional overrides (usually not needed)
 `;
 }
 
@@ -100,7 +88,7 @@ function resolveLlmOverride(g, env) {
   if (env.RAGSUITE_TEST_LLM_API_KEY && !isPlaceholderSecret(env.RAGSUITE_TEST_LLM_API_KEY)) {
     return env.RAGSUITE_TEST_LLM_API_KEY;
   }
-  return null; // keep .env.example default
+  return null;
 }
 
 function countSources(fromGit, repoRootFlag) {
@@ -113,10 +101,9 @@ function countSources(fromGit, repoRootFlag) {
 async function run(ctx) {
   assertSupportedInstall();
   const g = ctx.globals;
-  const interactive = Boolean(process.stdin.isTTY) && !g.yes;
 
   if (g.fromRelease) {
-    error('--from-release is not supported. Use --from-git or --repo-root.');
+    error('--from-release is not supported. Use default init, --from-git, or --repo-root.');
     return 1;
   }
 
@@ -130,78 +117,17 @@ async function run(ctx) {
 
   let fromGit = g.fromGit;
   let repoRootFlag = g.repoRoot;
-  let installDir = g.installDir || defaultInstallDir();
-  let mode = g.mode || null;
+  const installDir = g.installDir || defaultInstallDir();
 
-  if (g.yes) {
-    if (fromGit === null && !repoRootFlag) {
-      error('--yes requires --from-git [url] or --repo-root <path>');
-      return 1;
-    }
-  } else if (interactive && fromGit === null && !repoRootFlag) {
-    const method = await choose(
-      'Install method:',
-      [
-        {
-          id: 'git',
-          label: 'Public git clone (--from-git) — recommended',
-        },
-        {
-          id: 'checkout',
-          label: 'Existing checkout (--repo-root)',
-        },
-      ],
-      { defaultIndex: 0 },
-    );
-    if (method.id === 'git') {
-      const url = await ask('Git repository URL', {
-        defaultValue: DEFAULT_GIT_URL,
-        yesMode: false,
-      });
-      fromGit = url || DEFAULT_GIT_URL;
-      installDir = await ask('Install directory', {
-        defaultValue: defaultInstallDir(),
-        yesMode: false,
-      });
-    } else {
-      repoRootFlag = await ask('Path to existing RAGSUITE checkout', { yesMode: false });
-      if (!repoRootFlag || !looksLikeRepoRoot(path.resolve(repoRootFlag))) {
-        error('Not a valid checkout (need scripts/docker-start.sh)');
-        return 1;
-      }
-    }
-
-    const dockerOk = commandExists('docker') && dockerDaemonRunning();
-    const modeChoice = await choose(
-      'Run mode (Docker is optional — native works without Docker):',
-      [
-        {
-          id: 'native',
-          label: 'Native — no Docker; needs Postgres :5436 + Redis :6382 on this machine',
-        },
-        {
-          id: 'docker',
-          label: dockerOk
-            ? 'Docker — full compose stack (Docker Desktop / daemon)'
-            : 'Docker — not available on this machine (install Docker Desktop first)',
-        },
-      ],
-      { defaultIndex: 0 },
-    );
-    mode = modeChoice.id;
-    if (mode === 'docker' && !dockerOk) {
-      warn('Docker is not available — switching to native mode.');
-      mode = 'native';
-    }
-  } else if (fromGit === null && !repoRootFlag) {
-    error('Pass --from-git / --repo-root, or run in a TTY for the interactive wizard');
-    return 1;
+  // Default public path: no menus, no path prompts — clone GitHub → ~/ragsuite-test
+  if (fromGit === null && !repoRootFlag) {
+    fromGit = '';
+    info(`Install: clone ${DEFAULT_GIT_URL}`);
+    info(`Target:  ${path.resolve(installDir)}`);
   }
 
-  if (!mode) {
-    mode = resolvePreferredMode(g.mode);
-    info(`Run mode: ${mode} (Docker is optional; pass --mode docker|native to force)`);
-  }
+  const mode = g.mode || resolvePreferredMode(null);
+  info(`Run mode: ${mode} (Docker optional — pass --mode docker|native to force)`);
 
   const needGit = fromGit !== null && fromGit !== undefined;
   if (!printPrereqs(mode, { needGit })) {
@@ -211,7 +137,7 @@ async function run(ctx) {
 
   const jwtSecret = generateJwtSecret();
   info(`JWT_SECRET_KEY will be auto-generated (…${jwtSecret.slice(-8)})`);
-  info('SMTP + LLM: using defaults from .env.example (optional flags can override).');
+  info('SMTP + LLM: from .env.example into .env (no prompts).');
 
   const llmKey = resolveLlmOverride(g, ctx.env);
   const smtp = optionalSmtpOverrides(g, ctx.env);

package/src/index.js

@@ -31,15 +31,15 @@ function globalHelp() {
     'Global options:',
     '  --help, -h              Show help',
     '  --repo-root <path>      Monorepo / install root',
-    '  --from-git [url]        init: clone public monorepo',
-    '  --install-dir <path>    init: target for --from-git (default ~/ragsuite-test)',
+    '  --from-git [url]        init: clone this URL (default: public nitsan-ai/RAGSUITE)',
+    '  --install-dir <path>    init: clone target (default ~/ragsuite-test)',
     '  --llm-api-key <key>     init: optional override for CUSTOM_LLM_INTERNAL_API_KEY',
     '  --smtp-host <host>      init: optional SMTP override',
     '  --smtp-user <user>      init: optional SMTP override',
     '  --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',
+    '  --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)',
     '',

package/src/utils/distribution.js

@@ -3,22 +3,19 @@
 /**
  * Distribution modes for the testing CLI.
  *
- * - git-clone: init --from-git (public deploy)
- * - local-checkout: --repo-root / env / walk-up
- * Registry/GHCR compose remains stubbed.
+ * - git-clone: default `ragsuite-test init` (public GitHub)
+ * - local-checkout: --repo-root (advanced / CI)
  */
 
 const MODE_LOCAL = 'local-checkout';
 const MODE_GIT = 'git-clone';
 const MODE_REGISTRY = 'registry-compose';
 
-function assertSupportedInstall() {
-  // git + checkout supported
-}
+function assertSupportedInstall() {}
 
 function resolveComposeBundle() {
   const err = new Error(
-    'Registry/compose (GHCR) install is not available yet. Use: ragsuite-test init --from-git  OR  --repo-root <checkout>.',
+    'Registry/compose (GHCR) install is not available yet. Run: ragsuite-test init',
   );
   err.code = 'DIST_NOT_READY';
   throw err;
@@ -26,10 +23,11 @@ function resolveComposeBundle() {
 
 function installHint() {
   return [
-    'Install paths:',
-    '  Public:    ragsuite-test init --from-git [--install-dir ~/ragsuite-test]',
-    '  Checkout:  ragsuite-test init --repo-root <path>',
-    'Docker is optional — use --mode native (Postgres :5436 + Redis :6382) if you have no Docker.',
+    'Simple deploy:',
+    '  npm install -g @nitsan-ai/ragsuite-test',
+    '  ragsuite-test init',
+    '  ragsuite-test start --repo-root ~/ragsuite-test --detach',
+    'Docker is optional — init picks native automatically if Docker is not running.',
   ].join('\n');
 }