nemoris 0.1.0 → 0.1.2

package/src/setup.js

@@ -1,369 +1,369 @@
-/**
- * First-run setup script for Nemoris V2.
- *
- * Validates the environment, detects API keys, checks external services,
- * validates config, and ensures state directories exist.
- *
- * No npm dependencies — uses native fetch, native fs, ANSI codes only.
- * Idempotent and non-interactive (no prompts).
- * Exit code 0 if all critical checks pass, 1 otherwise.
- */
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-// ── ANSI helpers ────────────────────────────────────────────────────
-
-const BOLD = "\x1b[1m";
-const RESET = "\x1b[0m";
-const GREEN = "\x1b[32m";
-const RED = "\x1b[31m";
-const YELLOW = "\x1b[33m";
-const DIM = "\x1b[2m";
-
-const PASS = `${GREEN}\u2713${RESET}`;
-const FAIL = `${RED}\u2717${RESET}`;
-const WARN = `${YELLOW}!${RESET}`;
-
-function bold(text) {
-  return `${BOLD}${text}${RESET}`;
-}
-
-// ── Path resolution ─────────────────────────────────────────────────
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const projectRoot = path.resolve(__dirname, "..");
-const configRoot = path.join(projectRoot, "config");
-const stateRoot = path.join(projectRoot, "state", "memory");
-
-// ── Env loader (mirrors cli.js) ─────────────────────────────────────
-
-function loadParentEnv(envPath) {
-  try {
-    const content = fs.readFileSync(envPath, "utf8");
-    for (const line of content.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const eqIdx = trimmed.indexOf("=");
-      if (eqIdx < 1) continue;
-      const key = trimmed.slice(0, eqIdx).trim();
-      if (process.env[key] !== undefined) continue;
-      let value = trimmed.slice(eqIdx + 1).trim();
-      if (
-        (value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))
-      ) {
-        value = value.slice(1, -1);
-      }
-      process.env[key] = value;
-    }
-  } catch {
-    // .env file is optional
-  }
-}
-
-// ── Helpers ─────────────────────────────────────────────────────────
-
-function maskKey(key) {
-  if (!key || key.length < 7) return "***";
-  return key.slice(0, 6) + "...";
-}
-
-function readPackageJson() {
-  const raw = fs.readFileSync(path.join(projectRoot, "package.json"), "utf8");
-  return JSON.parse(raw);
-}
-
-// ── Step 1: Welcome banner ──────────────────────────────────────────
-
-function printBanner(pkg) {
-  console.log("");
-  console.log(
-    bold("── Nemoris V2 Setup ") +
-      DIM +
-      `v${pkg.version}` +
-      RESET +
-      bold(" ─────────────────────")
-  );
-  console.log("");
-}
-
-// ── Step 2: Node.js version check ───────────────────────────────────
-
-function checkNodeVersion() {
-  const full = process.version; // e.g. "v25.8.0"
-  const major = parseInt(full.slice(1), 10);
-  const ok = major >= 22;
-  if (ok) {
-    console.log(`  Node.js        ${full}          ${PASS}`);
-  } else {
-    console.log(
-      `  Node.js        ${full}          ${FAIL}  (need >= 22.5)`
-    );
-  }
-  return ok;
-}
-
-// ── Step 3: Detect API keys ─────────────────────────────────────────
-
-function detectApiKeys() {
-  // Load parent .env first
-  const parentEnvPath = path.resolve(
-    process.env.HOME || os.homedir(),
-    ".openclaw",
-    ".env"
-  );
-  loadParentEnv(parentEnvPath);
-
-  const keys = {};
-
-  // OpenRouter (primary for battle-testing)
-  const orKey = process.env.OPENROUTER_API_KEY;
-  if (orKey) {
-    console.log(`  OpenRouter     ${maskKey(orKey)}  ${PASS}  (primary)`);
-    keys.openrouter = orKey;
-  } else {
-    console.log(`  OpenRouter     not found       ${FAIL}`);
-    keys.openrouter = null;
-  }
-
-  // Anthropic (optional — routes through OpenRouter when unavailable)
-  const antKey = process.env.NEMORIS_ANTHROPIC_API_KEY;
-  if (antKey) {
-    console.log(`  Anthropic      ${maskKey(antKey)}  ${PASS}`);
-    keys.anthropic = antKey;
-  } else {
-    console.log(`  Anthropic      not found       ${WARN}  (optional)`);
-    keys.anthropic = null;
-  }
-
-  return keys;
-}
-
-// ── Step 4: Validate OpenRouter API key ─────────────────────────────
-
-async function validateOpenRouterKey(apiKey) {
-  if (!apiKey) return false;
-
-  try {
-    const res = await fetch("https://openrouter.ai/api/v1/models", {
-      headers: {
-        "Authorization": `Bearer ${apiKey}`,
-      },
-      signal: AbortSignal.timeout(10000),
-    });
-
-    if (res.ok) {
-      console.log(`  API check      verified        ${PASS}`);
-      return true;
-    }
-
-    console.log(`  API check      invalid         ${FAIL}  (HTTP ${res.status})`);
-    return false;
-  } catch (err) {
-    console.log(`  API check      error           ${FAIL}  (${err.message})`);
-    return false;
-  }
-}
-
-// ── Step 5: Check Ollama ────────────────────────────────────────────
-
-async function checkOllama() {
-  try {
-    const res = await fetch("http://localhost:11434/api/tags", {
-      signal: AbortSignal.timeout(5000),
-    });
-    if (!res.ok) {
-      console.log(
-        `  Ollama         unreachable      ${WARN}  (HTTP ${res.status})`
-      );
-      return { ok: false, modelCount: 0 };
-    }
-    const data = await res.json();
-    const models = data.models || [];
-    if (models.length === 0) {
-      console.log(`  Ollama         0 models        ${WARN}  (no models pulled)`);
-    } else {
-      console.log(
-        `  Ollama         ${models.length} model${models.length === 1 ? "" : "s"}${models.length < 10 ? "         " : "        "} ${PASS}`
-      );
-      for (const m of models) {
-        console.log(`${DIM}    - ${m.name}${RESET}`);
-      }
-    }
-    return { ok: true, modelCount: models.length };
-  } catch {
-    console.log(
-      `  Ollama         not running      ${WARN}  (remote providers still work)`
-    );
-    return { ok: false, modelCount: 0 };
-  }
-}
-
-// ── Step 6: Validate config ─────────────────────────────────────────
-
-async function checkConfig() {
-  try {
-    const { ConfigLoader } = await import("./config/loader.js");
-    const { validateAllConfigs } = await import(
-      "./config/schema-validator.js"
-    );
-
-    const loader = new ConfigLoader({ rootDir: configRoot });
-    const config = await loader.loadAll();
-    const result = validateAllConfigs(config, configRoot);
-
-    if (result.ok) {
-      console.log(`  Config         all valid        ${PASS}`);
-    } else {
-      console.log(
-        `  Config         ${result.errors.length} error${result.errors.length === 1 ? "" : "s"}        ${FAIL}`
-      );
-      for (const e of result.errors) {
-        console.log(`${DIM}    - ${e}${RESET}`);
-      }
-    }
-    return result.ok;
-  } catch (err) {
-    console.log(
-      `  Config         load error       ${FAIL}  (${err.message})`
-    );
-    return false;
-  }
-}
-
-// ── Step 7: Ensure state directories ────────────────────────────────
-
-async function ensureStateDirs() {
-  try {
-    // Read agent configs to know which dirs are needed
-    const agentsDir = path.join(configRoot, "agents");
-    const agentFiles = fs.readdirSync(agentsDir).filter((f) => f.endsWith(".toml"));
-    const agentIds = agentFiles.map((f) => path.basename(f, ".toml"));
-
-    let created = 0;
-    let _existed = 0;
-
-    for (const id of agentIds) {
-      const dir = path.join(stateRoot, id);
-      if (fs.existsSync(dir)) {
-        _existed++;
-      } else {
-        fs.mkdirSync(dir, { recursive: true });
-        created++;
-      }
-    }
-
-    if (created > 0) {
-      console.log(
-        `  State dirs     ${created} created       ${PASS}`
-      );
-    } else {
-      console.log(
-        `  State dirs     all present      ${PASS}`
-      );
-    }
-    return true;
-  } catch (err) {
-    console.log(
-      `  State dirs     error            ${FAIL}  (${err.message})`
-    );
-    return false;
-  }
-}
-
-// ── Summary ─────────────────────────────────────────────────────────
-
-function printSummary(results) {
-  console.log("");
-  console.log(bold("── Setup Complete ") + bold("─".repeat(30)));
-
-  const nodeLabel = results.nodeVersion
-    ? `${process.version}`
-    : process.version;
-  console.log(
-    `  Node.js:     ${nodeLabel.padEnd(17)}${results.nodeVersion ? PASS : FAIL}`
-  );
-
-  const orLabel = results.keys.openrouter
-    ? `${maskKey(results.keys.openrouter)}`
-    : "missing";
-  const orStatus = results.apiKeyValid
-    ? `${PASS} (verified)`
-    : results.keys.openrouter
-      ? `${FAIL} (unverified)`
-      : FAIL;
-  console.log(`  OpenRouter:  ${orLabel.padEnd(17)}${orStatus}`);
-
-  const antLabel = results.keys.anthropic
-    ? `${maskKey(results.keys.anthropic)}`
-    : "not set";
-  const antStatus = results.keys.anthropic ? PASS : `${WARN} (optional)`;
-  console.log(`  Anthropic:   ${antLabel.padEnd(17)}${antStatus}`);
-
-  const ollamaLabel = results.ollama.ok
-    ? `${results.ollama.modelCount} model${results.ollama.modelCount === 1 ? "" : "s"}`
-    : "offline";
-  const ollamaStatus = results.ollama.ok ? PASS : WARN;
-  console.log(
-    `  Ollama:      ${ollamaLabel.padEnd(17)}${ollamaStatus}`
-  );
-
-  const configLabel = results.configValid ? "all valid" : "errors";
-  console.log(
-    `  Config:      ${configLabel.padEnd(17)}${results.configValid ? PASS : FAIL}`
-  );
-
-  const stateLabel = results.stateDirs ? "ready" : "error";
-  console.log(
-    `  State dirs:  ${stateLabel.padEnd(17)}${results.stateDirs ? PASS : FAIL}`
-  );
-
-  console.log("");
-  console.log(bold("  Ready to run:"));
-  console.log(
-    `    ${DIM}npm run run:heartbeat${RESET}           # dry-run (no API calls)`
-  );
-  console.log(
-    `    ${DIM}npm run run:heartbeat:provider${RESET}  # live run (uses API)`
-  );
-  console.log("");
-}
-
-// ── Main ────────────────────────────────────────────────────────────
-
-export async function runSetup() {
-  const pkg = readPackageJson();
-  printBanner(pkg);
-
-  // Critical checks
-  const nodeVersion = checkNodeVersion();
-  const keys = detectApiKeys();
-  const apiKeyValid = await validateOpenRouterKey(keys.openrouter);
-
-  // Non-blocking check
-  const ollama = await checkOllama();
-
-  // Critical checks (continued)
-  const configValid = await checkConfig();
-  const stateDirs = await ensureStateDirs();
-
-  const results = {
-    nodeVersion,
-    keys,
-    apiKeyValid,
-    ollama,
-    configValid,
-    stateDirs,
-  };
-
-  printSummary(results);
-
-  // Exit code: fail if any critical check failed
-  const criticalPass =
-    nodeVersion && keys.openrouter && apiKeyValid && configValid && stateDirs;
-
-  return criticalPass ? 0 : 1;
-}
+/**
+ * First-run setup script for Nemoris V2.
+ *
+ * Validates the environment, detects API keys, checks external services,
+ * validates config, and ensures state directories exist.
+ *
+ * No npm dependencies — uses native fetch, native fs, ANSI codes only.
+ * Idempotent and non-interactive (no prompts).
+ * Exit code 0 if all critical checks pass, 1 otherwise.
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+// ── ANSI helpers ────────────────────────────────────────────────────
+
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const DIM = "\x1b[2m";
+
+const PASS = `${GREEN}\u2713${RESET}`;
+const FAIL = `${RED}\u2717${RESET}`;
+const WARN = `${YELLOW}!${RESET}`;
+
+function bold(text) {
+  return `${BOLD}${text}${RESET}`;
+}
+
+// ── Path resolution ─────────────────────────────────────────────────
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(__dirname, "..");
+const configRoot = path.join(projectRoot, "config");
+const stateRoot = path.join(projectRoot, "state", "memory");
+
+// ── Env loader (mirrors cli.js) ─────────────────────────────────────
+
+function loadParentEnv(envPath) {
+  try {
+    const content = fs.readFileSync(envPath, "utf8");
+    for (const line of content.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eqIdx = trimmed.indexOf("=");
+      if (eqIdx < 1) continue;
+      const key = trimmed.slice(0, eqIdx).trim();
+      if (process.env[key] !== undefined) continue;
+      let value = trimmed.slice(eqIdx + 1).trim();
+      if (
+        (value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))
+      ) {
+        value = value.slice(1, -1);
+      }
+      process.env[key] = value;
+    }
+  } catch {
+    // .env file is optional
+  }
+}
+
+// ── Helpers ─────────────────────────────────────────────────────────
+
+function maskKey(key) {
+  if (!key || key.length < 7) return "***";
+  return key.slice(0, 6) + "...";
+}
+
+function readPackageJson() {
+  const raw = fs.readFileSync(path.join(projectRoot, "package.json"), "utf8");
+  return JSON.parse(raw);
+}
+
+// ── Step 1: Welcome banner ──────────────────────────────────────────
+
+function printBanner(pkg) {
+  console.log("");
+  console.log(
+    bold("── Nemoris V2 Setup ") +
+      DIM +
+      `v${pkg.version}` +
+      RESET +
+      bold(" ─────────────────────")
+  );
+  console.log("");
+}
+
+// ── Step 2: Node.js version check ───────────────────────────────────
+
+function checkNodeVersion() {
+  const full = process.version; // e.g. "v25.8.0"
+  const major = parseInt(full.slice(1), 10);
+  const ok = major >= 22;
+  if (ok) {
+    console.log(`  Node.js        ${full}          ${PASS}`);
+  } else {
+    console.log(
+      `  Node.js        ${full}          ${FAIL}  (need >= 22.5)`
+    );
+  }
+  return ok;
+}
+
+// ── Step 3: Detect API keys ─────────────────────────────────────────
+
+function detectApiKeys() {
+  // Load parent .env first
+  const parentEnvPath = path.resolve(
+    process.env.HOME || os.homedir(),
+    ".openclaw",
+    ".env"
+  );
+  loadParentEnv(parentEnvPath);
+
+  const keys = {};
+
+  // OpenRouter (primary for battle-testing)
+  const orKey = process.env.OPENROUTER_API_KEY;
+  if (orKey) {
+    console.log(`  OpenRouter     ${maskKey(orKey)}  ${PASS}  (primary)`);
+    keys.openrouter = orKey;
+  } else {
+    console.log(`  OpenRouter     not found       ${FAIL}`);
+    keys.openrouter = null;
+  }
+
+  // Anthropic (optional — routes through OpenRouter when unavailable)
+  const antKey = process.env.NEMORIS_ANTHROPIC_API_KEY;
+  if (antKey) {
+    console.log(`  Anthropic      ${maskKey(antKey)}  ${PASS}`);
+    keys.anthropic = antKey;
+  } else {
+    console.log(`  Anthropic      not found       ${WARN}  (optional)`);
+    keys.anthropic = null;
+  }
+
+  return keys;
+}
+
+// ── Step 4: Validate OpenRouter API key ─────────────────────────────
+
+async function validateOpenRouterKey(apiKey) {
+  if (!apiKey) return false;
+
+  try {
+    const res = await fetch("https://openrouter.ai/api/v1/models", {
+      headers: {
+        "Authorization": `Bearer ${apiKey}`,
+      },
+      signal: AbortSignal.timeout(10000),
+    });
+
+    if (res.ok) {
+      console.log(`  API check      verified        ${PASS}`);
+      return true;
+    }
+
+    console.log(`  API check      invalid         ${FAIL}  (HTTP ${res.status})`);
+    return false;
+  } catch (err) {
+    console.log(`  API check      error           ${FAIL}  (${err.message})`);
+    return false;
+  }
+}
+
+// ── Step 5: Check Ollama ────────────────────────────────────────────
+
+async function checkOllama() {
+  try {
+    const res = await fetch("http://localhost:11434/api/tags", {
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok) {
+      console.log(
+        `  Ollama         unreachable      ${WARN}  (HTTP ${res.status})`
+      );
+      return { ok: false, modelCount: 0 };
+    }
+    const data = await res.json();
+    const models = data.models || [];
+    if (models.length === 0) {
+      console.log(`  Ollama         0 models        ${WARN}  (no models pulled)`);
+    } else {
+      console.log(
+        `  Ollama         ${models.length} model${models.length === 1 ? "" : "s"}${models.length < 10 ? "         " : "        "} ${PASS}`
+      );
+      for (const m of models) {
+        console.log(`${DIM}    - ${m.name}${RESET}`);
+      }
+    }
+    return { ok: true, modelCount: models.length };
+  } catch {
+    console.log(
+      `  Ollama         not running      ${WARN}  (remote providers still work)`
+    );
+    return { ok: false, modelCount: 0 };
+  }
+}
+
+// ── Step 6: Validate config ─────────────────────────────────────────
+
+async function checkConfig() {
+  try {
+    const { ConfigLoader } = await import("./config/loader.js");
+    const { validateAllConfigs } = await import(
+      "./config/schema-validator.js"
+    );
+
+    const loader = new ConfigLoader({ rootDir: configRoot });
+    const config = await loader.loadAll();
+    const result = validateAllConfigs(config, configRoot);
+
+    if (result.ok) {
+      console.log(`  Config         all valid        ${PASS}`);
+    } else {
+      console.log(
+        `  Config         ${result.errors.length} error${result.errors.length === 1 ? "" : "s"}        ${FAIL}`
+      );
+      for (const e of result.errors) {
+        console.log(`${DIM}    - ${e}${RESET}`);
+      }
+    }
+    return result.ok;
+  } catch (err) {
+    console.log(
+      `  Config         load error       ${FAIL}  (${err.message})`
+    );
+    return false;
+  }
+}
+
+// ── Step 7: Ensure state directories ────────────────────────────────
+
+async function ensureStateDirs() {
+  try {
+    // Read agent configs to know which dirs are needed
+    const agentsDir = path.join(configRoot, "agents");
+    const agentFiles = fs.readdirSync(agentsDir).filter((f) => f.endsWith(".toml"));
+    const agentIds = agentFiles.map((f) => path.basename(f, ".toml"));
+
+    let created = 0;
+    let _existed = 0;
+
+    for (const id of agentIds) {
+      const dir = path.join(stateRoot, id);
+      if (fs.existsSync(dir)) {
+        _existed++;
+      } else {
+        fs.mkdirSync(dir, { recursive: true });
+        created++;
+      }
+    }
+
+    if (created > 0) {
+      console.log(
+        `  State dirs     ${created} created       ${PASS}`
+      );
+    } else {
+      console.log(
+        `  State dirs     all present      ${PASS}`
+      );
+    }
+    return true;
+  } catch (err) {
+    console.log(
+      `  State dirs     error            ${FAIL}  (${err.message})`
+    );
+    return false;
+  }
+}
+
+// ── Summary ─────────────────────────────────────────────────────────
+
+function printSummary(results) {
+  console.log("");
+  console.log(bold("── Setup Complete ") + bold("─".repeat(30)));
+
+  const nodeLabel = results.nodeVersion
+    ? `${process.version}`
+    : process.version;
+  console.log(
+    `  Node.js:     ${nodeLabel.padEnd(17)}${results.nodeVersion ? PASS : FAIL}`
+  );
+
+  const orLabel = results.keys.openrouter
+    ? `${maskKey(results.keys.openrouter)}`
+    : "missing";
+  const orStatus = results.apiKeyValid
+    ? `${PASS} (verified)`
+    : results.keys.openrouter
+      ? `${FAIL} (unverified)`
+      : FAIL;
+  console.log(`  OpenRouter:  ${orLabel.padEnd(17)}${orStatus}`);
+
+  const antLabel = results.keys.anthropic
+    ? `${maskKey(results.keys.anthropic)}`
+    : "not set";
+  const antStatus = results.keys.anthropic ? PASS : `${WARN} (optional)`;
+  console.log(`  Anthropic:   ${antLabel.padEnd(17)}${antStatus}`);
+
+  const ollamaLabel = results.ollama.ok
+    ? `${results.ollama.modelCount} model${results.ollama.modelCount === 1 ? "" : "s"}`
+    : "offline";
+  const ollamaStatus = results.ollama.ok ? PASS : WARN;
+  console.log(
+    `  Ollama:      ${ollamaLabel.padEnd(17)}${ollamaStatus}`
+  );
+
+  const configLabel = results.configValid ? "all valid" : "errors";
+  console.log(
+    `  Config:      ${configLabel.padEnd(17)}${results.configValid ? PASS : FAIL}`
+  );
+
+  const stateLabel = results.stateDirs ? "ready" : "error";
+  console.log(
+    `  State dirs:  ${stateLabel.padEnd(17)}${results.stateDirs ? PASS : FAIL}`
+  );
+
+  console.log("");
+  console.log(bold("  Ready to run:"));
+  console.log(
+    `    ${DIM}npm run run:heartbeat${RESET}           # dry-run (no API calls)`
+  );
+  console.log(
+    `    ${DIM}npm run run:heartbeat:provider${RESET}  # live run (uses API)`
+  );
+  console.log("");
+}
+
+// ── Main ────────────────────────────────────────────────────────────
+
+export async function runSetup() {
+  const pkg = readPackageJson();
+  printBanner(pkg);
+
+  // Critical checks
+  const nodeVersion = checkNodeVersion();
+  const keys = detectApiKeys();
+  const apiKeyValid = await validateOpenRouterKey(keys.openrouter);
+
+  // Non-blocking check
+  const ollama = await checkOllama();
+
+  // Critical checks (continued)
+  const configValid = await checkConfig();
+  const stateDirs = await ensureStateDirs();
+
+  const results = {
+    nodeVersion,
+    keys,
+    apiKeyValid,
+    ollama,
+    configValid,
+    stateDirs,
+  };
+
+  printSummary(results);
+
+  // Exit code: fail if any critical check failed
+  const criticalPass =
+    nodeVersion && keys.openrouter && apiKeyValid && configValid && stateDirs;
+
+  return criticalPass ? 0 : 1;
+}