scava-ai 0.1.0 → 0.2.0

package/cli/scava.js

@@ -1,285 +1,287 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import { CMD, serverUrl, openBrowser, formatProblems, ScavaError, appOfFolder, readFolder, uploadFolder, testLink, pullLink } from './lib.js';
-import { callTool, whoAmI, logout, signIn, finishWithAddress, signInHelper, credentialsPath } from './account.js';
-import { testRun, describe as describeRun } from './check.js';
-
-// "scava dev" needs Scava's own server code. That is only in the repo, never in the npm package: there the command is
-// not listed and says so.
-const HAS_DEV = fs.existsSync(new URL('./dev.js', import.meta.url));
-const DEV_HELP = `${CMD} dev [folder] [--port 8788] [--no-browser]
-    The app with its server code on this computer, before it goes online: published again on every save, secrets
-    from .env, type "run <schedule>" to run a schedule.
-
-`;
-
-const HELP = `Scava: hosting, sign-in and a database for the apps your AI builds. One command, for you and for any AI with a terminal.
-
-${CMD} deploy [folder]
-    Puts the app in this folder online, on its own address. A new app the first time, a new version after that.
-    The folder needs an index.html; for a build, deploy the output folder. Afterwards it opens the app once in a
-    browser here and lists what went wrong.
-    --name NAME  --message TEXT  --resolves 1,2 (change requests this version builds)  --app APP  --no-check
-
-${CMD} share WHO...
-    Lets people open the app: someone@company.com, "@company.com", group:leads. --remove WHO takes them out.
-    Without WHO: who can open it now.
-${CMD} apps
-    Your apps, the apps you co-edit, the apps shared with you.
-${CMD} requests
-    Change requests you accepted, ready to build. --done: the ones already built.
-${CMD} requests done ID
-    Marks one as done (deploy --resolves does that too). --note TEXT
-${CMD} test
-    Opens the live app once in a browser here, lists what goes wrong and what visitors reported.
-${CMD} server
-    The server part of the app: state, usage, secrets, schedules, outside services.
-${CMD} pull APP [folder]
-    The files of an app into a folder, to work on it here.
-${CMD} docs
-    What an app can use on Scava: data, rules, files, server code.
-${CMD} secret set NAME [--host HOST]
-    Where to set a key: the browser, so its value never passes through a terminal an AI can read.
-
-Inside a folder you deployed or pulled the app is known. Elsewhere add --app APP.
-
-The first command that needs your account opens a browser: sign in to Scava and choose Allow. After that it runs
-without a browser. The access stays on this computer, and whoever works under your user here acts as you.
-
-${CMD} whoami
-    Which account this computer is signed in as.
-${CMD} login
-    Signs in now. --no-browser prints the address, --wait SECONDS, --paste ADDRESS (from a browser on another device).
-${CMD} logout
-    Ends the access on this computer.
-
-${HAS_DEV ? DEV_HELP : ''}With a one-time link from the Scava tools in your AI (no sign-in here):
-
-  ${CMD} upload <folder> <link> [--no-check]
-  ${CMD} test <link>
-  ${CMD} pull <link> [folder]
-
-Claude or ChatGPT in the browser have no terminal: add a connector with the address https://scava.ai/mcp.
-All of it: https://scava.ai/docs
-`;
-
-// Options without a value, and options that may come several times. Everything else takes the next word as its value.
-const FLAGS = new Set(['no-check', 'no-browser', 'done', 'help', 'version']);
-const LISTS = new Set(['remove']);
-
-function parse(argv) {
-  const pos = [];
-  const opts = {};
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (!a.startsWith('--')) {
-      pos.push(a);
-      continue;
-    }
-    const eq = a.indexOf('=');
-    const k = eq === -1 ? a.slice(2) : a.slice(2, eq);
-    let v = eq === -1 ? undefined : a.slice(eq + 1);
-    if (v === undefined && !FLAGS.has(k) && argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) v = argv[++i];
-    v ??= true;
-    if (LISTS.has(k)) (opts[k] ||= []).push(v);
-    else opts[k] = v;
-  }
-  return { pos, opts };
-}
-
-const text = (v) => (typeof v === 'string' && v ? v : undefined);
-const isLink = (s) => /^https?:\/\//i.test(s ?? '');
-
-async function main() {
-  const [cmd, ...rest] = process.argv.slice(2);
-  // The small program that waits for the browser (account.js), started by the commands below.
-  if (cmd === '__sign-in') {
-    await signInHelper(rest[0], rest[1]);
-    return;
-  }
-  const { pos, opts } = parse(rest);
-  // "deploy --help" is a question, not a deploy.
-  if (opts.help || rest.includes('-h')) {
-    console.log(HELP);
-    return;
-  }
-  const server = serverUrl(text(opts.server));
-  const signInOptions = {
-    browser: !opts['no-browser'],
-    ...(opts.wait !== undefined && Number.isFinite(Number(opts.wait)) ? { waitMs: Math.max(0, Number(opts.wait)) * 1000 } : {}),
-  };
-
-  // Which account a command acts for, once. Under one user on a computer that may not be who you think.
-  let named = false;
-  const tool = async (name, args) => {
-    const r = await callTool(server, name, args, signInOptions);
-    if (!named && r.account) console.log(`Account: ${r.account}`);
-    named = true;
-    return r;
-  };
-  const appHere = () => {
-    const app = text(opts.app) || appOfFolder('.');
-    if (!app) throw new ScavaError(`Which app? This folder was not deployed. Add --app APP (${CMD} apps lists them), or run this in the folder of the app.`);
-    return app;
-  };
-
-  switch (cmd) {
-    case 'deploy':
-    case 'publish': {
-      // Before anything else: is there an app here at all? Nobody signs in for nothing.
-      const folder = readFolder(pos[0] || '.');
-      const remembered = appOfFolder(folder.root);
-      const app = text(opts.app) || remembered || undefined;
-      const resolves = text(opts.resolves)?.split(',').map(Number).filter(Number.isInteger);
-      let asked;
-      try {
-        // No path of this computer leaves it: the answer is a one-time link for this upload.
-        asked = await tool('publish_app', { path: '.', app, name: text(opts.name), message: text(opts.message), resolves });
-      } catch (e) {
-        if (remembered && !text(opts.app)) e.message += `\nThis folder remembers the app ${remembered} (in the file .scava-app). If it belongs to another account, delete that file to start a new app.`;
-        throw e;
-      }
-      const r = await uploadFolder(asked.data.link, folder.root, { server, folder });
-      for (const line of r.lines) console.log(line);
-      if (!opts['no-check'] && r.check_url) {
-        console.log('');
-        console.log(describeRun(await testRun(r.check_url)));
-      }
-      console.log('');
-      console.log('Next:');
-      console.log(`  ${CMD} share someone@company.com "@company.com"   let people open it`);
-      console.log(`  ${CMD} requests                                   change requests you accepted, ready to build`);
-      console.log(`  ${CMD} docs                                       what an app can use on Scava: data, rules, files, server code`);
-      return;
-    }
-    case 'share': {
-      const r = await tool('share_app', { app: appHere(), add: pos, remove: opts.remove?.filter((x) => typeof x === 'string') });
-      console.log(r.text);
-      return;
-    }
-    case 'apps':
-      console.log((await tool('list_apps', {})).text);
-      return;
-    case 'requests': {
-      if (pos[0] === 'done') {
-        const id = Number(pos[1]);
-        if (!Number.isInteger(id)) throw new ScavaError(`Usage: ${CMD} requests done ID [--note TEXT]`);
-        console.log((await tool('update_change_request', { id, status: 'done', note: text(opts.note) })).text);
-        return;
-      }
-      console.log((await tool('list_change_requests', { app: text(opts.app), status: opts.done ? 'done' : 'accepted' })).text);
-      return;
-    }
-    case 'server':
-      console.log((await tool('get_server_info', { app: appHere() })).text);
-      return;
-    case 'test': {
-      const link = isLink(pos[0]) ? pos[0] : (await tool('get_app_problems', { app: pos[0] || appHere(), test_run: true })).data.link;
-      const r = await testLink(link, { server });
-      console.log(describeRun(await testRun(r.url)));
-      console.log('');
-      console.log(r.problems);
-      return;
-    }
-    case 'pull': {
-      const [first, folder] = pos;
-      if (!first) throw new ScavaError(`Usage: ${CMD} pull APP [folder]. ${CMD} apps lists your apps.`);
-      const link = isLink(first) ? first : (await tool('pull_app', { app: first, path: '.' })).data.link;
-      const r = await pullLink(link, folder, { server });
-      console.log(`Pulled "${r.name}" v${r.version} (${r.fileCount} file${r.fileCount === 1 ? '' : 's'}) into ${r.dir}`);
-      console.log(`Change the files there, then run ${CMD} deploy in that folder: it goes to the same app.`);
-      return;
-    }
-    case 'upload': {
-      const [folder, link] = pos;
-      if (!folder || !link) throw new ScavaError(`Usage: ${CMD} upload <folder> <link>. Your AI gets the link from publish_app. Without a link: ${CMD} deploy`);
-      const r = await uploadFolder(link, folder, { server });
-      for (const line of r.lines) console.log(line);
-      if (opts['no-check'] || !r.check_url) return;
-      console.log('');
-      console.log(describeRun(await testRun(r.check_url)));
-      return;
-    }
-    case 'login': {
-      if (typeof opts.paste === 'string') {
-        await finishWithAddress(server, opts.paste);
-        const me = await whoAmI(server);
-        console.log(`Signed in to Scava as ${me?.account ?? 'your account'}. The access stays on this computer, in ${credentialsPath()}.`);
-        console.log(`Next: ${CMD} deploy`);
-        return;
-      }
-      const me = await whoAmI(server);
-      if (me) {
-        console.log(`Already signed in to Scava as ${me.account ?? 'your account'}. To use another account: ${CMD} logout`);
-        return;
-      }
-      await signIn(server, { ...signInOptions, reopen: true });
-      console.log(`Next: ${CMD} deploy`);
-      return;
-    }
-    case 'whoami': {
-      const me = await whoAmI(server);
-      if (!me) {
-        console.log(`Not signed in to Scava at ${server}. The next command that needs your account opens the browser.`);
-        process.exitCode = 1;
-        return;
-      }
-      console.log(`Signed in to Scava as ${me.account ?? 'your account'} (${server}). The access is in ${credentialsPath()}. End it with: ${CMD} logout`);
-      return;
-    }
-    case 'logout': {
-      const r = await logout(server);
-      if (!r.was) console.log('This computer was not signed in.');
-      else if (r.reached) console.log(`Signed out ${r.account ?? 'your account'} on this computer. The connection at Scava has ended too.`);
-      else console.log(`Removed the access of ${r.account ?? 'your account'} from this computer. Scava could not be reached, so disconnect it on the Connect page as well: ${server}/#/connect`);
-      return;
-    }
-    case 'secret': {
-      const [action, name] = pos;
-      if (action !== 'set') throw new ScavaError(`Usage: ${CMD} secret set NAME [--host api.example.com] [--app APP]`);
-      const slug = text(opts.app) || appOfFolder('.');
-      const page = `${server}/#/${slug ? `apps/${encodeURIComponent(slug)}` : ''}`;
-      console.log('Keys are set in the browser, so the value never passes through a terminal an AI can read.');
-      console.log(`Open ${page} and go to "Server code"${slug ? '' : ' of your app'}.`);
-      if (name) console.log(`Name: ${name}${text(opts.host) ? `, only for: ${opts.host}` : ''}`);
-      if (!opts['no-browser']) openBrowser(page);
-      return;
-    }
-    case 'dev': {
-      let dev;
-      try {
-        ({ dev } = await import('./dev.js'));
-      } catch (e) {
-        if (e?.code !== 'ERR_MODULE_NOT_FOUND') throw e;
-        throw new ScavaError('scava dev is not part of the scava package. Test the app online instead: deploying runs a test run.');
-      }
-      await dev({ dir: pos[0] || '.', port: Number(opts.port) || 8788, browser: !opts['no-browser'], email: text(opts.email) });
-      return;
-    }
-    case 'docs': {
-      const r = await fetch(`${server}/llms.txt`).catch(() => null);
-      if (!r?.ok) throw new ScavaError(`Cannot reach Scava at ${server}`);
-      console.log(await r.text());
-      return;
-    }
-    case undefined:
-    case 'help':
-    case '--help':
-    case '-h':
-      console.log(HELP);
-      return;
-    case '--version':
-    case '-v':
-      console.log(JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version);
-      return;
-    default:
-      console.error(`Unknown command: ${cmd}\n`);
-      console.log(HELP);
-      process.exitCode = 1;
-  }
-}
-
-main().catch((e) => {
-  console.error(e instanceof ScavaError ? formatProblems(e) : e.message);
-  process.exitCode = 1;
-});
+#!/usr/bin/env node
+import fs from 'node:fs';
+import { CMD, serverUrl, openBrowser, formatProblems, ScavaError, appOfFolder, readFolder, uploadFolder, testLink, pullLink } from './lib.js';
+import { callTool, whoAmI, logout, signIn, finishWithAddress, signInHelper, credentialsPath } from './account.js';
+import { testRun, describe as describeRun } from './check.js';
+
+// "scava dev" needs Scava's own server code. That is only in the repo, never in the npm package: there the command is
+// not listed and says so.
+const HAS_DEV = fs.existsSync(new URL('./dev.js', import.meta.url));
+const DEV_HELP = `${CMD} dev [folder] [--port 8788] [--no-browser]
+    The app with its server code on this computer, before it goes online: published again on every save, secrets
+    from .env, type "run <schedule>" to run a schedule.
+
+`;
+
+const HELP = `Scava: hosting, sign-in and a database for the apps your AI builds. One command, for you and for any AI with a terminal.
+
+${CMD} setup [folder]
+    Puts the app in this folder online, on its own address. A new app the first time, a new version after that.
+    The folder needs an index.html; for a build, use the output folder. Afterwards it opens the app once in a
+    browser here and lists what went wrong.
+    --name NAME  --message TEXT  --resolves 1,2 (change requests this version builds)  --app APP  --no-check
+
+${CMD} share WHO...
+    Lets people open the app: someone@company.com, "@company.com", group:leads. --remove WHO takes them out.
+    Without WHO: who can open it now.
+${CMD} apps
+    Your apps, the apps you co-edit, the apps shared with you.
+${CMD} requests
+    Change requests you accepted, ready to build. --done: the ones already built.
+${CMD} requests done ID
+    Marks one as done (setup --resolves does that too). --note TEXT
+${CMD} test
+    Opens the live app once in a browser here, lists what goes wrong and what visitors reported.
+${CMD} server
+    The server part of the app: state, usage, secrets, schedules, outside services.
+${CMD} pull APP [folder]
+    The files of an app into a folder, to work on it here.
+${CMD} docs
+    What an app can use on Scava: data, rules, files, server code.
+${CMD} secret set NAME [--host HOST]
+    Where to set a key: the browser, so its value never passes through a terminal an AI can read.
+
+Inside a folder you put online or pulled the app is known. Elsewhere add --app APP.
+
+The first command that needs your account opens a browser: sign in to Scava and choose Allow. After that it runs
+without a browser. The access stays on this computer, and whoever works under your user here acts as you.
+
+${CMD} whoami
+    Which account this computer is signed in as.
+${CMD} login
+    Signs in now. --no-browser prints the address, --wait SECONDS, --paste ADDRESS (from a browser on another device).
+${CMD} logout
+    Ends the access on this computer.
+
+${HAS_DEV ? DEV_HELP : ''}With a one-time link from the Scava tools in your AI (no sign-in here):
+
+  ${CMD} upload <folder> <link> [--no-check]
+  ${CMD} test <link>
+  ${CMD} pull <link> [folder]
+
+Claude or ChatGPT in the browser have no terminal: add a connector with the address https://scava.ai/mcp.
+All of it: https://scava.ai/docs
+`;
+
+// Options without a value, and options that may come several times. Everything else takes the next word as its value.
+const FLAGS = new Set(['no-check', 'no-browser', 'done', 'help', 'version']);
+const LISTS = new Set(['remove']);
+
+function parse(argv) {
+  const pos = [];
+  const opts = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith('--')) {
+      pos.push(a);
+      continue;
+    }
+    const eq = a.indexOf('=');
+    const k = eq === -1 ? a.slice(2) : a.slice(2, eq);
+    let v = eq === -1 ? undefined : a.slice(eq + 1);
+    if (v === undefined && !FLAGS.has(k) && argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) v = argv[++i];
+    v ??= true;
+    if (LISTS.has(k)) (opts[k] ||= []).push(v);
+    else opts[k] = v;
+  }
+  return { pos, opts };
+}
+
+const text = (v) => (typeof v === 'string' && v ? v : undefined);
+const isLink = (s) => /^https?:\/\//i.test(s ?? '');
+
+async function main() {
+  const [cmd, ...rest] = process.argv.slice(2);
+  // The small program that waits for the browser (account.js), started by the commands below.
+  if (cmd === '__sign-in') {
+    await signInHelper(rest[0], rest[1]);
+    return;
+  }
+  const { pos, opts } = parse(rest);
+  // "setup --help" is a question, not a publish.
+  if (opts.help || rest.includes('-h')) {
+    console.log(HELP);
+    return;
+  }
+  const server = serverUrl(text(opts.server));
+  const signInOptions = {
+    browser: !opts['no-browser'],
+    ...(opts.wait !== undefined && Number.isFinite(Number(opts.wait)) ? { waitMs: Math.max(0, Number(opts.wait)) * 1000 } : {}),
+  };
+
+  // Which account a command acts for, once. Under one user on a computer that may not be who you think.
+  let named = false;
+  const tool = async (name, args) => {
+    const r = await callTool(server, name, args, signInOptions);
+    if (!named && r.account) console.log(`Account: ${r.account}`);
+    named = true;
+    return r;
+  };
+  const appHere = () => {
+    const app = text(opts.app) || appOfFolder('.');
+    if (!app) throw new ScavaError(`Which app? This folder is not online yet. Add --app APP (${CMD} apps lists them), or run this in the folder of the app.`);
+    return app;
+  };
+
+  switch (cmd) {
+    // "setup" is the word on every page (07.11.2026). "deploy" (the first version on npm) and "publish" do the same.
+    case 'setup':
+    case 'deploy':
+    case 'publish': {
+      // Before anything else: is there an app here at all? Nobody signs in for nothing.
+      const folder = readFolder(pos[0] || '.');
+      const remembered = appOfFolder(folder.root);
+      const app = text(opts.app) || remembered || undefined;
+      const resolves = text(opts.resolves)?.split(',').map(Number).filter(Number.isInteger);
+      let asked;
+      try {
+        // No path of this computer leaves it: the answer is a one-time link for this upload.
+        asked = await tool('publish_app', { path: '.', app, name: text(opts.name), message: text(opts.message), resolves });
+      } catch (e) {
+        if (remembered && !text(opts.app)) e.message += `\nThis folder remembers the app ${remembered} (in the file .scava-app). If it belongs to another account, delete that file to start a new app.`;
+        throw e;
+      }
+      const r = await uploadFolder(asked.data.link, folder.root, { server, folder });
+      for (const line of r.lines) console.log(line);
+      if (!opts['no-check'] && r.check_url) {
+        console.log('');
+        console.log(describeRun(await testRun(r.check_url)));
+      }
+      console.log('');
+      console.log('Next:');
+      console.log(`  ${CMD} share someone@company.com "@company.com"   let people open it`);
+      console.log(`  ${CMD} requests                                   change requests you accepted, ready to build`);
+      console.log(`  ${CMD} docs                                       what an app can use on Scava: data, rules, files, server code`);
+      return;
+    }
+    case 'share': {
+      const r = await tool('share_app', { app: appHere(), add: pos, remove: opts.remove?.filter((x) => typeof x === 'string') });
+      console.log(r.text);
+      return;
+    }
+    case 'apps':
+      console.log((await tool('list_apps', {})).text);
+      return;
+    case 'requests': {
+      if (pos[0] === 'done') {
+        const id = Number(pos[1]);
+        if (!Number.isInteger(id)) throw new ScavaError(`Usage: ${CMD} requests done ID [--note TEXT]`);
+        console.log((await tool('update_change_request', { id, status: 'done', note: text(opts.note) })).text);
+        return;
+      }
+      console.log((await tool('list_change_requests', { app: text(opts.app), status: opts.done ? 'done' : 'accepted' })).text);
+      return;
+    }
+    case 'server':
+      console.log((await tool('get_server_info', { app: appHere() })).text);
+      return;
+    case 'test': {
+      const link = isLink(pos[0]) ? pos[0] : (await tool('get_app_problems', { app: pos[0] || appHere(), test_run: true })).data.link;
+      const r = await testLink(link, { server });
+      console.log(describeRun(await testRun(r.url)));
+      console.log('');
+      console.log(r.problems);
+      return;
+    }
+    case 'pull': {
+      const [first, folder] = pos;
+      if (!first) throw new ScavaError(`Usage: ${CMD} pull APP [folder]. ${CMD} apps lists your apps.`);
+      const link = isLink(first) ? first : (await tool('pull_app', { app: first, path: '.' })).data.link;
+      const r = await pullLink(link, folder, { server });
+      console.log(`Pulled "${r.name}" v${r.version} (${r.fileCount} file${r.fileCount === 1 ? '' : 's'}) into ${r.dir}`);
+      console.log(`Change the files there, then run ${CMD} setup in that folder: it goes to the same app.`);
+      return;
+    }
+    case 'upload': {
+      const [folder, link] = pos;
+      if (!folder || !link) throw new ScavaError(`Usage: ${CMD} upload <folder> <link>. Your AI gets the link from publish_app. Without a link: ${CMD} setup`);
+      const r = await uploadFolder(link, folder, { server });
+      for (const line of r.lines) console.log(line);
+      if (opts['no-check'] || !r.check_url) return;
+      console.log('');
+      console.log(describeRun(await testRun(r.check_url)));
+      return;
+    }
+    case 'login': {
+      if (typeof opts.paste === 'string') {
+        await finishWithAddress(server, opts.paste);
+        const me = await whoAmI(server);
+        console.log(`Signed in to Scava as ${me?.account ?? 'your account'}. The access stays on this computer, in ${credentialsPath()}.`);
+        console.log(`Next: ${CMD} setup`);
+        return;
+      }
+      const me = await whoAmI(server);
+      if (me) {
+        console.log(`Already signed in to Scava as ${me.account ?? 'your account'}. To use another account: ${CMD} logout`);
+        return;
+      }
+      await signIn(server, { ...signInOptions, reopen: true });
+      console.log(`Next: ${CMD} setup`);
+      return;
+    }
+    case 'whoami': {
+      const me = await whoAmI(server);
+      if (!me) {
+        console.log(`Not signed in to Scava at ${server}. The next command that needs your account opens the browser.`);
+        process.exitCode = 1;
+        return;
+      }
+      console.log(`Signed in to Scava as ${me.account ?? 'your account'} (${server}). The access is in ${credentialsPath()}. End it with: ${CMD} logout`);
+      return;
+    }
+    case 'logout': {
+      const r = await logout(server);
+      if (!r.was) console.log('This computer was not signed in.');
+      else if (r.reached) console.log(`Signed out ${r.account ?? 'your account'} on this computer. The connection at Scava has ended too.`);
+      else console.log(`Removed the access of ${r.account ?? 'your account'} from this computer. Scava could not be reached, so disconnect it on the Connect page as well: ${server}/#/connect`);
+      return;
+    }
+    case 'secret': {
+      const [action, name] = pos;
+      if (action !== 'set') throw new ScavaError(`Usage: ${CMD} secret set NAME [--host api.example.com] [--app APP]`);
+      const slug = text(opts.app) || appOfFolder('.');
+      const page = `${server}/#/${slug ? `apps/${encodeURIComponent(slug)}` : ''}`;
+      console.log('Keys are set in the browser, so the value never passes through a terminal an AI can read.');
+      console.log(`Open ${page} and go to "Server code"${slug ? '' : ' of your app'}.`);
+      if (name) console.log(`Name: ${name}${text(opts.host) ? `, only for: ${opts.host}` : ''}`);
+      if (!opts['no-browser']) openBrowser(page);
+      return;
+    }
+    case 'dev': {
+      let dev;
+      try {
+        ({ dev } = await import('./dev.js'));
+      } catch (e) {
+        if (e?.code !== 'ERR_MODULE_NOT_FOUND') throw e;
+        throw new ScavaError('scava dev is not part of the scava package. Test the app online instead: setup runs a test run.');
+      }
+      await dev({ dir: pos[0] || '.', port: Number(opts.port) || 8788, browser: !opts['no-browser'], email: text(opts.email) });
+      return;
+    }
+    case 'docs': {
+      const r = await fetch(`${server}/llms.txt`).catch(() => null);
+      if (!r?.ok) throw new ScavaError(`Cannot reach Scava at ${server}`);
+      console.log(await r.text());
+      return;
+    }
+    case undefined:
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(HELP);
+      return;
+    case '--version':
+    case '-v':
+      console.log(JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version);
+      return;
+    default:
+      console.error(`Unknown command: ${cmd}\n`);
+      console.log(HELP);
+      process.exitCode = 1;
+  }
+}
+
+main().catch((e) => {
+  console.error(e instanceof ScavaError ? formatProblems(e) : e.message);
+  process.exitCode = 1;
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "scava-ai",
-  "version": "0.1.0",
-  "description": "Hosting, login and a database for the internal tools your AI agent builds, with sharing and change requests. One command: npx -y scava-ai deploy.",
+  "version": "0.2.0",
+  "description": "Hosting, login and a database for the internal tools your AI agent builds, with sharing and change requests. One command: npx -y scava-ai setup.",
   "type": "module",
   "bin": {
     "scava": "cli/scava.js"