@askexenow/exe-os 0.8.0

package/dist/bin/exe-settings.js

@@ -0,0 +1,354 @@
+// src/bin/exe-settings.ts
+import { createInterface } from "readline";
+
+// src/lib/config.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { readFileSync, existsSync, renameSync } from "fs";
+import path from "path";
+import os from "os";
+function resolveDataDir() {
+  if (process.env.EXE_OS_DIR) return process.env.EXE_OS_DIR;
+  if (process.env.EXE_MEM_DIR) return process.env.EXE_MEM_DIR;
+  const newDir = path.join(os.homedir(), ".exe-os");
+  const legacyDir = path.join(os.homedir(), ".exe-mem");
+  if (!existsSync(newDir) && existsSync(legacyDir)) {
+    try {
+      renameSync(legacyDir, newDir);
+      process.stderr.write(`[exe-os] Migrated data directory: ~/.exe-mem \u2192 ~/.exe-os
+`);
+    } catch {
+      return legacyDir;
+    }
+  }
+  return newDir;
+}
+var EXE_AI_DIR = resolveDataDir();
+var DB_PATH = path.join(EXE_AI_DIR, "memories.db");
+var MODELS_DIR = path.join(EXE_AI_DIR, "models");
+var CONFIG_PATH = path.join(EXE_AI_DIR, "config.json");
+var LEGACY_LANCE_PATH = path.join(EXE_AI_DIR, "local.lance");
+var CURRENT_CONFIG_VERSION = 1;
+var DEFAULT_CONFIG = {
+  config_version: CURRENT_CONFIG_VERSION,
+  dbPath: DB_PATH,
+  modelFile: "jina-embeddings-v5-small-q4_k_m.gguf",
+  embeddingDim: 1024,
+  batchSize: 20,
+  flushIntervalMs: 1e4,
+  autoIngestion: true,
+  autoRetrieval: true,
+  searchMode: "hybrid",
+  hookSearchMode: "hybrid",
+  fileGrepEnabled: true,
+  splashEffect: true,
+  consolidationEnabled: true,
+  consolidationIntervalMs: 6 * 60 * 60 * 1e3,
+  consolidationModel: "claude-haiku-4-5-20251001",
+  consolidationMaxCallsPerRun: 20,
+  selfQueryRouter: true,
+  selfQueryModel: "claude-haiku-4-5-20251001",
+  rerankerEnabled: true,
+  scalingRoadmap: {
+    rerankerAutoTrigger: {
+      enabled: true,
+      broadQueryMinCardinality: 5e4,
+      fetchTopK: 150,
+      returnTopK: 5
+    }
+  },
+  graphRagEnabled: true,
+  wikiEnabled: false,
+  wikiUrl: "",
+  wikiApiKey: "",
+  wikiSyncIntervalMs: 30 * 60 * 1e3,
+  wikiWorkspaceMapping: {
+    exe: "Executive",
+    yoshi: "Engineering",
+    mari: "Marketing",
+    tom: "Engineering",
+    sasha: "Production"
+  },
+  wikiAutoUpdate: true,
+  wikiAutoUpdateThreshold: 0.5,
+  wikiAutoUpdateCreateNew: true,
+  skillLearning: true,
+  skillThreshold: 3,
+  skillModel: "claude-haiku-4-5-20251001",
+  exeHeartbeat: {
+    enabled: true,
+    intervalSeconds: 60,
+    staleInProgressThresholdHours: 2
+  },
+  sessionLifecycle: {
+    idleKillEnabled: true,
+    idleKillTicksRequired: 3,
+    idleKillIntercomAckWindowMs: 1e4,
+    maxAutoInstances: 10
+  }
+};
+function migrateLegacyConfig(raw) {
+  if ("r2" in raw) {
+    process.stderr.write(
+      "[exe-os] Warning: config.json contains deprecated 'r2' field from v1.0. R2 sync has been replaced in v1.1. The 'r2' field will be ignored.\n"
+    );
+    delete raw.r2;
+  }
+  if ("syncIntervalMs" in raw) {
+    delete raw.syncIntervalMs;
+  }
+  return raw;
+}
+var CONFIG_MIGRATIONS = [
+  {
+    from: 0,
+    to: 1,
+    migrate: (cfg) => {
+      cfg.config_version = 1;
+      return cfg;
+    }
+  }
+];
+function migrateConfig(raw) {
+  const fromVersion = typeof raw.config_version === "number" ? raw.config_version : 0;
+  let currentVersion = fromVersion;
+  let migrated = false;
+  if (currentVersion > CURRENT_CONFIG_VERSION) {
+    return { config: raw, migrated: false, fromVersion };
+  }
+  for (const migration of CONFIG_MIGRATIONS) {
+    if (currentVersion === migration.from && migration.to <= CURRENT_CONFIG_VERSION) {
+      raw = migration.migrate(raw);
+      currentVersion = migration.to;
+      migrated = true;
+    }
+  }
+  return { config: raw, migrated, fromVersion };
+}
+function normalizeScalingRoadmap(raw) {
+  const defaultAuto = DEFAULT_CONFIG.scalingRoadmap.rerankerAutoTrigger;
+  const userRoadmap = raw.scalingRoadmap ?? {};
+  const userAuto = userRoadmap.rerankerAutoTrigger ?? {};
+  if (userAuto.enabled === void 0 && raw.rerankerEnabled !== void 0) {
+    userAuto.enabled = raw.rerankerEnabled;
+  }
+  raw.scalingRoadmap = {
+    ...userRoadmap,
+    rerankerAutoTrigger: { ...defaultAuto, ...userAuto }
+  };
+}
+function normalizeSessionLifecycle(raw) {
+  const defaultSL = DEFAULT_CONFIG.sessionLifecycle;
+  const userSL = raw.sessionLifecycle ?? {};
+  raw.sessionLifecycle = { ...defaultSL, ...userSL };
+}
+async function loadConfig() {
+  const dir = process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? EXE_AI_DIR;
+  await mkdir(dir, { recursive: true });
+  const configPath = path.join(dir, "config.json");
+  if (!existsSync(configPath)) {
+    return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db") };
+  }
+  const raw = await readFile(configPath, "utf-8");
+  try {
+    let parsed = JSON.parse(raw);
+    parsed = migrateLegacyConfig(parsed);
+    const { config: migratedCfg, migrated, fromVersion } = migrateConfig(parsed);
+    if (migrated) {
+      process.stderr.write(`[exe-os] Config migrated from v${fromVersion} to v${migratedCfg.config_version}
+`);
+      try {
+        await writeFile(configPath, JSON.stringify(migratedCfg, null, 2) + "\n");
+      } catch {
+      }
+    }
+    normalizeScalingRoadmap(migratedCfg);
+    normalizeSessionLifecycle(migratedCfg);
+    const config = { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db"), ...migratedCfg };
+    if (config.dbPath.startsWith("~")) {
+      config.dbPath = config.dbPath.replace(/^~/, os.homedir());
+    }
+    return config;
+  } catch {
+    return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db") };
+  }
+}
+async function saveConfig(config) {
+  const dir = process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? EXE_AI_DIR;
+  await mkdir(dir, { recursive: true });
+  const configPath = path.join(dir, "config.json");
+  await writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+
+// src/lib/is-main.ts
+import { realpathSync } from "fs";
+import { fileURLToPath } from "url";
+function isMainModule(importMetaUrl) {
+  if (process.argv[1] == null) return false;
+  try {
+    const scriptPath = realpathSync(process.argv[1]);
+    const modulePath = realpathSync(fileURLToPath(importMetaUrl));
+    return scriptPath === modulePath;
+  } catch {
+    return importMetaUrl === `file://${process.argv[1]}` || importMetaUrl === new URL(process.argv[1], "file://").href;
+  }
+}
+
+// src/bin/exe-settings.ts
+function label(value) {
+  return value ? "ON" : "OFF";
+}
+function searchLabel(mode) {
+  if (mode === "hybrid") return "hybrid   FTS + vector (best quality, uses embedding model)";
+  return "fts      Keywords only (fast, no embedding model)";
+}
+function hookSearchLabel(mode) {
+  if (mode === "hybrid") return "hybrid   FTS + vector (loads 639MB model \u2014 adds 3-8s on first call)";
+  return "fts      Keywords only (fast, ~200ms, no model load)";
+}
+function syncStatus(config) {
+  if (config.cloud?.apiKey) return "Exe Cloud";
+  if (config.turso?.url) return "libSQL (self-hosted)";
+  return "local-only";
+}
+function printSettings(config) {
+  console.log(`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502  exe-os settings                                 \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+
+  1. Auto-ingestion:    ${label(config.autoIngestion).padEnd(5)}  Store every tool call as a memory
+  2. Auto-retrieval:    ${label(config.autoRetrieval).padEnd(5)}  Inject relevant memories into context
+  3. MCP search mode:   ${searchLabel(config.searchMode)}
+  4. Hook search mode:  ${hookSearchLabel(config.hookSearchMode)}
+  5. Cloud sync:        ${syncStatus(config)}
+
+  Model:               ${config.modelFile}
+
+Type a number to toggle, or "q" to quit.
+`);
+}
+async function main() {
+  const config = await loadConfig();
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const prompt = () => {
+    printSettings(config);
+    rl.question("> ", async (answer) => {
+      const choice = answer.trim().toLowerCase();
+      if (choice === "1") {
+        config.autoIngestion = !config.autoIngestion;
+        await saveConfig(config);
+        console.log(`
+  Auto-ingestion ${label(config.autoIngestion)}`);
+        if (!config.autoIngestion) {
+          console.log("  Tool calls will no longer be saved to memory.");
+          console.log("  Use the store_memory MCP tool to save manually.");
+        }
+        prompt();
+      } else if (choice === "2") {
+        config.autoRetrieval = !config.autoRetrieval;
+        await saveConfig(config);
+        console.log(`
+  Auto-retrieval ${label(config.autoRetrieval)}`);
+        if (!config.autoRetrieval) {
+          console.log("  Memories won't be injected automatically.");
+          console.log("  Use recall_my_memory MCP tool to search manually.");
+        }
+        prompt();
+      } else if (choice === "3") {
+        config.searchMode = config.searchMode === "hybrid" ? "fts" : "hybrid";
+        await saveConfig(config);
+        console.log(`
+  MCP search mode: ${config.searchMode}`);
+        if (config.searchMode === "fts") {
+          console.log("  MCP tools now use keyword search only.");
+          console.log("  Faster queries, no embedding model needed for search.");
+        } else {
+          console.log("  MCP tools now use hybrid search (FTS + vector + RRF).");
+          console.log("  Best quality \u2014 model is already warm in MCP server.");
+        }
+        prompt();
+      } else if (choice === "4") {
+        config.hookSearchMode = config.hookSearchMode === "fts" ? "hybrid" : "fts";
+        await saveConfig(config);
+        console.log(`
+  Hook search mode: ${config.hookSearchMode}`);
+        if (config.hookSearchMode === "hybrid") {
+          console.log("  Hooks will load the embedding model for semantic search.");
+          console.log("  Better recall, but first invocation adds 3-8s cold-start.");
+        } else {
+          console.log("  Hooks use keyword search only (~200ms, no model load).");
+          console.log("  Recommended for daily use.");
+        }
+        prompt();
+      } else if (choice === "5") {
+        console.log(`
+  Current sync: ${syncStatus(config)}`);
+        console.log("\n  Configure cloud sync:");
+        console.log("    a. Exe Cloud \u2014 paste your API key (exe_sk_...)");
+        console.log("    b. Disconnect \u2014 switch to local-only");
+        console.log("    c. Cancel");
+        rl.question("\n  > ", async (syncChoice) => {
+          const sc = syncChoice.trim().toLowerCase();
+          if (sc === "a") {
+            rl.question("  API key: ", async (apiKey) => {
+              const key = apiKey.trim();
+              if (!key) {
+                console.log("  Cancelled.");
+                prompt();
+                return;
+              }
+              rl.question("  Endpoint [https://askexe.com/cloud]: ", async (ep) => {
+                const endpoint = ep.trim() || "https://askexe.com/cloud";
+                console.log("  Validating...");
+                try {
+                  const resp = await fetch(`${endpoint}/auth/verify`, {
+                    method: "POST",
+                    headers: { "Authorization": `Bearer ${key}`, "Content-Type": "application/json" }
+                  });
+                  if (resp.ok) {
+                    config.cloud = { apiKey: key, endpoint };
+                    delete config.turso;
+                    await saveConfig(config);
+                    console.log("  \u2713 Cloud sync configured. Memories will sync on next ingestion.");
+                  } else {
+                    console.log(`  \u2717 Validation failed (${resp.status}). Key not saved.`);
+                  }
+                } catch (err) {
+                  console.log(`  \u2717 Could not reach endpoint: ${err instanceof Error ? err.message : String(err)}`);
+                  console.log("  Key not saved. Check the endpoint URL.");
+                }
+                prompt();
+              });
+            });
+          } else if (sc === "b") {
+            delete config.cloud;
+            delete config.turso;
+            await saveConfig(config);
+            console.log("  \u2713 Switched to local-only. Cloud sync disconnected.");
+            prompt();
+          } else {
+            prompt();
+          }
+        });
+      } else if (choice === "q" || choice === "quit" || choice === "") {
+        rl.close();
+      } else {
+        console.log("\n  Unknown option. Type 1-5, or q.");
+        prompt();
+      }
+    });
+  };
+  prompt();
+}
+if (isMainModule(import.meta.url)) {
+  main().catch((err) => {
+    console.error("Settings error:", err instanceof Error ? err.message : err);
+    process.exit(1);
+  });
+}
+export {
+  main
+};