@aetheros/cli 0.1.0 → 0.1.1

package/bin/aether.js

@@ -107,9 +107,11 @@ export function run(args, cwd = process.cwd(), log = console.log) {
     log('workflow docs ok');
     return;
   }
-  throw new Error('Usage: aether <init|doctor|status|install <kit>...|check|spec ...|run <pack>|run init <dir>|room [serve|snapshot|html <file>|install-vscode]|owner ...|idea ...|githooks <install|uninstall|status>|setup [--yes|--kits a,b] [--os-name ..] [--assistant ..] [--accent #hex] [--dry-run]|setup machine [--install [--yes]]|doctor machine|version|sprint <status|plan|close>|voice [--ai provider] [--model id|--tier t] [--agents [--agent id]] [--pack dir]|workspace [init] [--no-memory] [--no-price-refresh]|models [list|pick --tier cheap|balanced|strong|init|prices [update]]>');
+  throw new Error('Usage: aether <start [--reset|--where|--no-open|--no-voice|--launchers]|init|doctor|status|install <kit>...|check|spec ...|run <pack>|run init <dir>|room [serve|snapshot|html <file>|install-vscode]|owner ...|idea ...|githooks <install|uninstall|status>|setup [--yes|--kits a,b] [--os-name ..] [--assistant ..] [--accent #hex] [--dry-run]|setup machine [--install [--yes]]|doctor machine|version|sprint <status|plan|close>|voice [--ai provider] [--model id|--tier t] [--agents [--agent id]] [--pack dir]|workspace [init] [--no-memory] [--no-price-refresh]|models [list|pick --tier cheap|balanced|strong|init|prices [update]]>');
 }
-if (isMain && process.argv[2] === 'sprint') {
+if (isMain && process.argv[2] === 'start') {
+  import('../src/start.js').then(m => m.start(process.argv.slice(3), process.cwd())).catch(error => { console.error(error.message); process.exitCode = 1; });
+} else if (isMain && process.argv[2] === 'sprint') {
   runSprint(process.argv.slice(3), process.cwd(), console.log).catch(error => { console.error(error.message); process.exitCode = 1; });
 } else if (isMain && process.argv[2] === 'setup') {
   (process.argv[3] === 'machine'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aetheros/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,21 +12,21 @@
     "aether": "./bin/aether.js"
   },
   "scripts": {
-    "check": "node --check bin/aether.js && node --check src/setup.js && node --check src/sprint.js && node --check src/machine.js",
+    "check": "node --check bin/aether.js && node --check src/setup.js && node --check src/sprint.js && node --check src/machine.js && node --check src/start.js",
     "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "@aetheros/workflow": "0.1.0",
-    "@aetheros/provider-claude": "0.1.0",
-    "@aetheros/provider-openai": "0.1.0",
-    "@aetheros/spec-kit": "0.1.0",
-    "@aetheros/runner": "0.1.0",
-    "@aetheros/control-room": "0.1.0",
-    "@aetheros/voice": "0.1.0",
-    "@aetheros/workspace": "0.1.0",
-    "@aetheros/models": "0.1.0",
-    "@aetheros/provider-google": "0.1.0",
-    "@aetheros/provider-openai-compatible": "0.1.0"
+    "@aetheros/workflow": "0.1.1",
+    "@aetheros/provider-claude": "0.1.1",
+    "@aetheros/provider-openai": "0.1.1",
+    "@aetheros/spec-kit": "0.1.1",
+    "@aetheros/runner": "0.1.1",
+    "@aetheros/control-room": "0.1.1",
+    "@aetheros/voice": "0.1.1",
+    "@aetheros/workspace": "0.1.1",
+    "@aetheros/models": "0.1.1",
+    "@aetheros/provider-google": "0.1.1",
+    "@aetheros/provider-openai-compatible": "0.1.1"
   },
   "files": [
     "src",

package/src/start.js

@@ -0,0 +1,176 @@
+// `aether start`: one command (or a double-click on start-aetheros.cmd) that starts everything and opens it.
+// First run: asks for an AI provider key and saves it outside the project (in the home folder, owner-only).
+// Every run: starts the workspace and the voice console, then opens both in the browser.
+// Already running: opens the pages again and exits.
+import {spawn} from 'node:child_process';
+import {createHash} from 'node:crypto';
+import {chmodSync, existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync} from 'node:fs';
+import {homedir} from 'node:os';
+import {basename, join} from 'node:path';
+import {createInterface} from 'node:readline';
+import {fileURLToPath} from 'node:url';
+
+export const PROVIDER_KEYS = [
+  {env: 'ANTHROPIC_API_KEY', name: 'Anthropic (Claude)', hint: 'sk-ant-…, from console.anthropic.com (create it inside a workspace)'},
+  {env: 'OPENAI_API_KEY', name: 'OpenAI', hint: 'sk-…, from platform.openai.com'},
+  {env: 'GEMINI_API_KEY', name: 'Google Gemini', hint: 'from aistudio.google.com'},
+];
+const ALL_KEYS = [...PROVIDER_KEYS.map(p => p.env), 'GOOGLE_API_KEY', 'XAI_API_KEY', 'MISTRAL_API_KEY'];
+const STATE = join('.aether', 'local', 'start.json');
+
+export const LAUNCHERS = {
+  'start-aetheros.cmd': '@echo off\r\nREM Starts AetherOS for this project and opens it in the browser. Double-click or run: start-aetheros\r\ncd /d "%~dp0"\r\nnode .aether\\aether.mjs start %*\r\nif errorlevel 1 pause\r\n',
+  'start-aetheros.sh': '#!/bin/sh\n# Starts AetherOS for this project and opens it in the browser. Run: ./start-aetheros.sh\ncd "$(dirname "$0")" && exec node .aether/aether.mjs start "$@"\n',
+};
+
+/** Where this project's settings live: the home folder, never the project (keys must not reach git). */
+export function settingsFile(root, home = homedir()) {
+  let real = root;
+  try { real = realpathSync(root); } catch {}
+  const id = createHash('sha256').update(real.toLowerCase()).digest('hex').slice(0, 10);
+  return join(home, '.aether', 'projects', `${basename(real).replace(/[^\w.-]/g, '_')}-${id}.json`);
+}
+
+export function loadSettings(file) {
+  try { const s = JSON.parse(readFileSync(file, 'utf8')); return s && typeof s.env === 'object' ? s : {env: {}}; } catch { return {env: {}}; }
+}
+
+export function saveSettings(file, settings) {
+  mkdirSync(join(file, '..'), {recursive: true, mode: 0o700});
+  writeFileSync(file, JSON.stringify({schemaVersion: 1, ...settings}, null, 2) + '\n', {mode: 0o600});
+  try { chmodSync(file, 0o600); } catch {}
+}
+
+/** Writes the double-click launchers into the project when they're missing. Returns the names written. */
+export function writeLaunchers(root) {
+  const written = [];
+  for (const [name, text] of Object.entries(LAUNCHERS)) {
+    const file = join(root, name);
+    if (existsSync(file)) continue;
+    writeFileSync(file, text, {mode: 0o755});
+    written.push(name);
+  }
+  return written;
+}
+
+/** The keys to start with: the terminal's own variables win, then the saved ones. */
+export function resolveKeys(env, settings) {
+  const keys = {};
+  for (const name of ALL_KEYS) {
+    if (env[name]) keys[name] = env[name];
+    else if (settings.env?.[name]) keys[name] = settings.env[name];
+  }
+  return keys;
+}
+
+/** Asks for one key, Anthropic first; the typed key is not shown on screen. */
+export async function askForKey(ask, log) {
+  log('\nAetherOS needs one AI provider key so your agents can answer. It is saved in your home folder, never in the project.');
+  for (const p of PROVIDER_KEYS) {
+    const key = String(await ask(`Paste your ${p.name} API key (${p.hint}), or press Enter to skip: `, {secret: true})).trim();
+    if (key) return {[p.env]: key};
+  }
+  return {};
+}
+
+function terminalAsk() {
+  return (question, {secret} = {}) => new Promise(resolveAnswer => {
+    const rl = createInterface({input: process.stdin, output: process.stdout, terminal: true});
+    if (secret) {
+      const write = rl._writeToOutput?.bind(rl);
+      rl._writeToOutput = text => { if (text.startsWith(question)) write?.(text); else if (!/^\r?\n$/.test(text)) write?.('*'); else write?.(text); };
+    }
+    rl.question(question, answer => { rl.close(); if (secret) process.stdout.write('\n'); resolveAnswer(answer); });
+  });
+}
+
+export function openInBrowser(url, {spawnImpl = spawn, platform = process.platform} = {}) {
+  const [cmd, args] = platform === 'win32' ? ['rundll32', ['url.dll,FileProtocolHandler', url]] : platform === 'darwin' ? ['open', [url]] : ['xdg-open', [url]];
+  try { spawnImpl(cmd, args, {stdio: 'ignore', detached: true}).unref?.(); return true; } catch { return false; }
+}
+
+async function answers(url, fetchImpl) {
+  try { return (await fetchImpl(url, {signal: AbortSignal.timeout(1500)})).status < 500; } catch { return false; }
+}
+
+/** Starts a child `aether <args>` and resolves with the first http URL it prints after `label`. */
+function startChild(cliPath, args, {root, env, label, log, spawnImpl}) {
+  return new Promise((resolveUrl, reject) => {
+    const child = spawnImpl(process.execPath, [cliPath, ...args], {cwd: root, env, stdio: ['ignore', 'pipe', 'pipe']});
+    let found = false, buffer = '';
+    const onData = chunk => {
+      buffer += chunk;
+      const lines = buffer.split(/\r?\n/);
+      buffer = lines.pop();
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        if (!found) {
+          const match = line.includes(label) && line.match(/https?:\/\/127\.0\.0\.1:\d+\/\S*/);
+          if (match) { found = true; resolveUrl({child, url: match[0]}); continue; }
+        }
+        log(`  [${args[0]}] ${line}`);
+      }
+    };
+    child.stdout.on('data', onData);
+    child.stderr.on('data', onData);
+    child.on('exit', code => { if (!found) reject(new Error(`aether ${args[0]} stopped (exit ${code}) before it was ready`)); });
+  });
+}
+
+export async function start(args, root, {log = console.log, env = process.env, home = homedir(), ask, interactive = Boolean(process.stdin.isTTY), cliPath, open = openInBrowser, spawnImpl = spawn, fetchImpl = fetch, wait = true} = {}) {
+  if (!existsSync(join(root, '.aether')) && !existsSync(join(root, 'aether.config.json'))) {
+    throw new Error('AetherOS is not set up in this folder yet. Run:  npx @aetheros/create');
+  }
+  for (const name of writeLaunchers(root)) log(`created ${name} (double-click it, or run it, to start AetherOS next time)`);
+  if (args.includes('--launchers')) return {launchersOnly: true};
+
+  const file = settingsFile(root, home);
+  const settings = loadSettings(file);
+  if (args.includes('--where')) { log(file); return {file}; }
+  let keys = resolveKeys(env, args.includes('--reset') ? {env: {}} : settings);
+  if (!Object.keys(keys).length || args.includes('--reset')) {
+    if (interactive) {
+      const typed = await askForKey(ask ?? terminalAsk(), log);
+      if (Object.keys(typed).length) {
+        saveSettings(file, {...settings, env: {...(args.includes('--reset') ? {} : settings.env), ...typed}});
+        log(`Saved in ${file} (only your user can read it; delete the file to forget the key).`);
+        keys = {...keys, ...typed};
+      }
+    }
+    if (!Object.keys(keys).length) log('No AI provider key: the pages open, but agents can only answer once you add one. Run  node .aether/aether.mjs start --reset  to add it.');
+  }
+
+  const noOpen = args.includes('--no-open') || env.AETHER_NO_OPEN === '1';
+  const statePath = join(root, STATE);
+  let state = {};
+  try { state = JSON.parse(readFileSync(statePath, 'utf8')); } catch {}
+  if (state.workspace && await answers(state.workspace, fetchImpl)) {
+    log(`AetherOS is already running.\n  Workspace:      ${state.workspace}\n  Voice console:  ${state.voice ?? '(not running)'}`);
+    if (!noOpen) { open(state.workspace); if (state.voice) open(state.voice); }
+    return {alreadyRunning: true, ...state};
+  }
+
+  const childEnv = {...env, ...keys};
+  const cli = cliPath ?? fileURLToPath(new URL('../bin/aether.js', import.meta.url));
+  log('Starting AetherOS…');
+  const workspace = await startChild(cli, ['workspace', '--port', String(Number(value(args, '--port') ?? 4850))], {root, env: childEnv, label: 'Workspace:', log, spawnImpl});
+  let voice;
+  if (!args.includes('--no-voice')) {
+    try { voice = await startChild(cli, ['voice', '--agents', '--port', String(Number(value(args, '--voice-port') ?? 4747))], {root, env: childEnv, label: 'Voice console:', log, spawnImpl}); }
+    catch (error) { log(`Voice console not started: ${error.message}`); }
+  }
+  mkdirSync(join(root, '.aether', 'local'), {recursive: true});
+  writeFileSync(statePath, JSON.stringify({workspace: workspace.url, ...(voice && {voice: voice.url}), startedAt: new Date().toISOString()}, null, 2) + '\n');
+  log(`\nAetherOS is running.\n  Workspace:      ${workspace.url}\n  Voice console:  ${voice?.url ?? '(not started)'}  (Chrome or Edge, allow the microphone)\nPress Ctrl+C here to stop.`);
+  if (!noOpen) { open(workspace.url); if (voice) open(voice.url); }
+  const children = [workspace.child, voice?.child].filter(Boolean);
+  const stop = () => { for (const c of children) try { c.kill(); } catch {} };
+  if (!wait) return {workspace: workspace.url, voice: voice?.url, stop};
+  process.on('SIGINT', () => { stop(); process.exit(0); });
+  process.on('SIGTERM', () => { stop(); process.exit(0); });
+  await new Promise(resolveDone => workspace.child.on('exit', resolveDone));
+  stop();
+  return {workspace: workspace.url, voice: voice?.url};
+}
+
+function value(args, name) { const i = args.indexOf(name); return i >= 0 ? args[i + 1] : undefined; }