local-knowledge-graph 1.10.4 → 1.12.0

package/lib/diff.js

@@ -0,0 +1,63 @@
+'use strict';
+
+// 版本 Diff：对比两个保存点快照，输出结构化差异（Archify Before/Delta/After 式对比回执）
+// attributes 在库内为 JSON 文本，规范化解析后比较，键序差异不误报
+
+function normAttrs(a) {
+  if (a === null || a === undefined || a === '') return {};
+  if (typeof a === 'object') return a;
+  try { const v = JSON.parse(a); return v && typeof v === 'object' ? v : { '值': v }; } catch (_) { return { '原文': String(a) }; }
+}
+
+function stable(v) {
+  if (v === null || v === undefined) return '';
+  if (typeof v !== 'object') return String(v);
+  const keys = Object.keys(v).sort();
+  return JSON.stringify(keys.map((k) => [k, v[k]]));
+}
+
+// 实体比较字段：name/category/attributes；关系比较字段：source_id/target_id/name/category/confidence/source_ref/attributes
+function diffRows(oldRows, newRows, fields, label) {
+  const oldById = new Map(oldRows.map((r) => [r.id, r]));
+  const newById = new Map(newRows.map((r) => [r.id, r]));
+  const added = [], removed = [], changed = [];
+  for (const [id, row] of newById) {
+    if (!oldById.has(id)) { added.push(pick(row, fields)); continue; }
+    const prev = oldById.get(id);
+    const attrPrev = normAttrs(prev.attributes);
+    const attrNow = normAttrs(row.attributes);
+    const changedFields = [];
+    const detail = { id, fields: changedFields, from: {}, to: {} };
+    for (const f of fields) {
+      const a = f === 'attributes' ? stable(attrPrev) : String(prev[f] === null || prev[f] === undefined ? '' : prev[f]);
+      const b = f === 'attributes' ? stable(attrNow) : String(row[f] === null || row[f] === undefined ? '' : row[f]);
+      if (a !== b) {
+        changedFields.push(f);
+        detail.from[f] = f === 'attributes' ? attrPrev : (prev[f] === null || prev[f] === undefined ? '' : prev[f]);
+        detail.to[f] = f === 'attributes' ? attrNow : (row[f] === null || row[f] === undefined ? '' : row[f]);
+      }
+    }
+    if (changedFields.length) changed.push(detail);
+  }
+  for (const [id, row] of oldById) if (!newById.has(id)) removed.push(pick(row, fields));
+  return { added, removed, changed, summary: { [label + '_added']: added.length, [label + '_removed']: removed.length, [label + '_changed']: changed.length } };
+}
+
+function pick(row, fields) {
+  const out = { id: row.id };
+  for (const f of fields) out[f] = f === 'attributes' ? normAttrs(row.attributes) : (row[f] === null || row[f] === undefined ? '' : row[f]);
+  return out;
+}
+
+// 对比两个快照 {entities, relations}；from=旧 to=新
+function diffSnapshots(fromSnap, toSnap) {
+  const ent = diffRows(fromSnap.entities, toSnap.entities, ['name', 'category', 'attributes'], 'entities');
+  const rel = diffRows(fromSnap.relations, toSnap.relations, ['source_id', 'target_id', 'name', 'category', 'confidence', 'source_ref', 'attributes'], 'relations');
+  return {
+    entities: { added: ent.added, removed: ent.removed, changed: ent.changed },
+    relations: { added: rel.added, removed: rel.removed, changed: rel.changed },
+    summary: { ...ent.summary, ...rel.summary },
+  };
+}
+
+module.exports = { diffSnapshots, normAttrs };

package/lib/git.js

@@ -172,4 +172,27 @@ function restore(hash) {
   return { restored: hash, backup: backup && backup.hash ? backup.hash : null, counts };
 }
 
-module.exports = { ensureRepo, savepoint, history, restore, readMeta, writeMeta, backupCopy, DATA_DIR };
+// 导出任意保存点的库快照（只读）：供版本 Diff 对比，不动主库
+function exportSnapshot(hash) {
+  ensureRepo();
+  if (!hasCommits()) { const e = new Error('仓库中还没有任何保存点'); e.status = 400; throw e; }
+  try { git(['cat-file', '-e', `${hash}^{commit}`]); } catch (_) {
+    const e = new Error(`保存点 ${hash} 不存在`); e.status = 404; throw e;
+  }
+  const buf = gitBuffer(['show', `${hash}:${DB_FILE}`]);
+  const tmp = path.join(os.tmpdir(), `kg_snap_${Date.now()}_${Math.random().toString(36).slice(2, 8)}.db`);
+  fs.writeFileSync(tmp, buf);
+  const { DatabaseSync } = require('node:sqlite');
+  let probe;
+  try {
+    probe = new DatabaseSync(tmp, { readOnly: true });
+    const entities = probe.prepare('SELECT id, name, category, attributes FROM entities ORDER BY id').all();
+    const relations = probe.prepare('SELECT id, source_id, target_id, name, category, confidence, source_ref, attributes FROM relations ORDER BY id').all();
+    return { entities, relations };
+  } finally {
+    try { if (probe) probe.close(); } catch (_) {}
+    try { fs.unlinkSync(tmp); } catch (_) {}
+  }
+}
+
+module.exports = { ensureRepo, savepoint, history, restore, exportSnapshot, readMeta, writeMeta, backupCopy, DATA_DIR };

package/lib/ocbin.js

@@ -0,0 +1,194 @@
+'use strict';
+
+// opencode CLI 可执行文件定位：
+// 1. 环境变量 KG_OPENCODE_PATH 显式指定（优先级最高）
+// 2. PATH 逐目录扫描（Windows 按 PATHEXT 优先级匹配 .exe/.cmd/.bat）
+// 3. 常见安装位置兜底（curl 官方脚本 / Homebrew / npm 全局 / WinGet / Scoop）
+// 4. npm 全局 prefix 兜底（PATH 未包含 npm bin 目录的场景，如 GUI 启动）
+//
+// 背景：npm 安装的 opencode 在 Windows 上是 opencode.cmd 垫片，Node 出于安全策略
+// （CVE-2024-27980）禁止 spawn/execFile 直接执行 .cmd/.bat，导致"已安装却检测不到"。
+// 垫片指向 node_modules/opencode-ai/bin/opencode.exe（postinstall 复制的真实二进制），
+// 本模块会将垫片还原为真实 exe，直接 spawn，绕开 cmd.exe 与引号转义问题。
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let cached; // undefined=未解析；null=确认不存在；{path,isCmdShim}=解析成功
+
+function isExecutable(p) {
+  try {
+    return fs.statSync(p).isFile() && Boolean(fs.statSync(p).mode & 0o111);
+  } catch (_) {
+    return false;
+  }
+}
+
+function fileExists(p) {
+  try { return fs.statSync(p).isFile(); } catch (_) { return false; }
+}
+
+function pathDirs() {
+  const sep = process.platform === 'win32' ? ';' : ':';
+  return String(process.env.PATH || '')
+    .split(sep)
+    .map((d) => d.trim().replace(/^"|"$/g, ''))
+    .filter(Boolean);
+}
+
+// Windows：按可执行优先级生成候选（.exe 可直接 spawn，垫片需还原）
+function candidatesInDir(dir) {
+  if (process.platform !== 'win32') return [path.join(dir, 'opencode')];
+  const pathext = String(process.env.PATHEXT || '.COM;.EXE;.BAT;.CMD')
+    .split(';').map((e) => e.toLowerCase());
+  return ['.exe', '.cmd', '.bat']
+    .filter((ext) => pathext.includes(ext))
+    .map((ext) => path.join(dir, 'opencode' + ext));
+}
+
+// 解析 npm .cmd 垫片的真实目标：优先约定路径，其次解析垫片内容中的 %~dp0 引用
+function cmdShimTarget(shimPath) {
+  const dir = path.dirname(shimPath);
+  const conventional = path.join(dir, 'node_modules', 'opencode-ai', 'bin', 'opencode.exe');
+  if (fileExists(conventional)) return conventional;
+  try {
+    const text = fs.readFileSync(shimPath, 'utf8');
+    // 匹配 "%dp0%\..." 与 "%~dp0\..." 两种 npm/cmd-shim 模板中的 exe 引用
+    const m = text.match(/"%(?:~dp0|dp0)%?\\([^"]+\.exe)"/i);
+    if (m) {
+      const target = path.join(dir, m[1].replace(/\\+/g, '\\'));
+      if (fileExists(target)) return target;
+    }
+  } catch (_) { /* 读不了就放弃 */ }
+  return null;
+}
+
+function wellKnownCandidates() {
+  const home = os.homedir();
+  if (process.platform === 'win32') {
+    const appdata = process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+    const local = process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
+    const npmDir = path.join(appdata, 'npm');
+    return [
+      path.join(npmDir, 'node_modules', 'opencode-ai', 'bin', 'opencode.exe'),
+      path.join(npmDir, 'opencode.exe'),
+      path.join(local, 'Microsoft', 'WinGet', 'Links', 'opencode.exe'),
+      path.join(local, 'Programs', 'opencode', 'bin', 'opencode.exe'),
+      path.join(home, '.opencode', 'bin', 'opencode.exe'),
+      path.join(home, 'scoop', 'shims', 'opencode.exe'),
+    ];
+  }
+  return [
+    path.join(home, '.opencode', 'bin', 'opencode'), // 官方 curl 安装脚本默认位置
+    path.join(home, '.local', 'bin', 'opencode'),
+    path.join(path.dirname(process.execPath), 'opencode'), // nvm 等 node 同目录
+    '/opt/homebrew/bin/opencode',
+    '/usr/local/bin/opencode',
+    '/usr/bin/opencode',
+  ];
+}
+
+// 最后兜底：问 npm 要全局 prefix（子进程调用较慢，仅在前序全部未命中时执行）
+function npmGlobalCandidates() {
+  try {
+    const { execFileSync } = require('child_process');
+    const prefix = execFileSync('npm', ['config', 'get', 'prefix'], {
+      encoding: 'utf8',
+      timeout: 10000,
+      shell: process.platform === 'win32',
+      stdio: ['ignore', 'pipe', 'pipe'],
+    }).trim();
+    if (!prefix) return [];
+    if (process.platform === 'win32') {
+      return [
+        path.join(prefix, 'node_modules', 'opencode-ai', 'bin', 'opencode.exe'),
+        path.join(prefix, 'opencode.exe'),
+      ];
+    }
+    return [path.join(prefix, 'bin', 'opencode')];
+  } catch (_) {
+    return [];
+  }
+}
+
+function resolveSync() {
+  const tried = [];
+
+  // 1) 环境变量显式指定
+  if (process.env.KG_OPENCODE_PATH) {
+    const p = process.env.KG_OPENCODE_PATH;
+    if (isExecutable(p) || fileExists(p)) {
+      return { path: p, isCmdShim: /\.(cmd|bat)$/i.test(p), via: 'env' };
+    }
+    tried.push(p);
+  }
+
+  // 2) PATH 扫描
+  for (const dir of pathDirs()) {
+    for (const c of candidatesInDir(dir)) {
+      if (!fileExists(c)) continue;
+      if (process.platform === 'win32' && /\.(cmd|bat)$/i.test(c)) {
+        const target = cmdShimTarget(c);
+        if (target) return { path: target, isCmdShim: false, via: 'path-shim' };
+        return { path: c, isCmdShim: true, via: 'path-shim' };
+      }
+      if (isExecutable(c)) return { path: c, isCmdShim: false, via: 'path' };
+    }
+  }
+
+  // 3) 常见安装位置
+  for (const c of wellKnownCandidates()) {
+    if (fileExists(c)) return { path: c, isCmdShim: false, via: 'wellknown' };
+  }
+
+  // 4) npm 全局 prefix
+  for (const c of npmGlobalCandidates()) {
+    if (fileExists(c)) return { path: c, isCmdShim: false, via: 'npm-prefix' };
+  }
+
+  if (tried.length) {
+    console.warn(`[OpenCode] KG_OPENCODE_PATH 指定的文件不可用: ${tried.join(', ')}`);
+  }
+  return null;
+}
+
+/**
+ * 定位 opencode CLI。结果缓存在进程内，传 { refresh: true } 强制重新解析。
+ * @returns {{path: string, isCmdShim: boolean, via: string} | null}
+ */
+function findOpenCodeBin({ refresh = false } = {}) {
+  if (refresh) cached = undefined;
+  if (cached === undefined) cached = resolveSync();
+  return cached;
+}
+
+/**
+ * 生成 spawn/execFile 所需的启动参数。
+ * 极少数场景垫片 exe 缺失只剩 .cmd 时，经 cmd.exe 执行（仅版本探测等安全参数可用）。
+ * @returns {{file: string, args: string[], opts: {shell?: boolean}}}
+ */
+function buildLauncher(bin, args) {
+  if (!bin.isCmdShim) return { file: bin.path, args, opts: {} };
+  const comspec = process.env.comspec || 'cmd.exe';
+  return {
+    file: comspec,
+    args: ['/d', '/s', '/c', `"${bin.path}" ${args.join(' ')}`],
+    opts: { windowsVerbatimArguments: true },
+  };
+}
+
+/**
+ * 用已定位的二进制探测版本号；失败返回 null
+ */
+function probeVersion(bin, timeoutMs = 15000) {
+  try {
+    const { execFileSync } = require('child_process');
+    const { file, args, opts } = buildLauncher(bin, ['--version']);
+    return String(execFileSync(file, args, { encoding: 'utf8', timeout: timeoutMs, stdio: ['ignore', 'pipe', 'pipe'], ...opts })).trim() || null;
+  } catch (_) {
+    return null;
+  }
+}
+
+module.exports = { findOpenCodeBin, buildLauncher, probeVersion };

package/lib/ocinstall.js

@@ -0,0 +1,229 @@
+'use strict';
+
+// OpenCode 一键安装与模型配置：
+// - 安装：npm 全局安装 opencode-ai。本应用本身即 npm 包，npm 必然可用，
+//   且全程无交互，Windows/macOS/Linux 通用（curl 脚本在 Windows 不可用）。
+// - 模型配置（写入 opencode 全局配置 ~/.config/opencode/opencode.json）：
+//   1) 已有认证(auth.json)或已设默认模型 → 尊重现有配置，不改动
+//   2) 本机 Ollama (127.0.0.1:11434) → 自动写入 provider 与默认模型
+//   3) 本机 LM Studio (127.0.0.1:1234) → 同上
+//   4) 兜底：OpenCode Zen 免费模型 opencode/grok-code（官方源码确认免费模型无需登录）
+// - 完成后通过 onDone 钩子通知调用方重新检测，无需重启应用即可使用。
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const NPM_PKG = 'opencode-ai';
+const FREE_MODEL = 'opencode/grok-code';
+const INSTALL_TIMEOUT_MS = 10 * 60 * 1000;
+const LOG_KEEP = 300;
+
+// phase: idle | installing | configuring | done | error
+const state = {
+  phase: 'idle',
+  step: '',
+  log: [],
+  error: null,
+  model: null, // { source: existing|ollama|lmstudio|free|error, model, detail }
+  started_at: null,
+  ended_at: null,
+};
+let running = false;
+let onDone = null; // 安装完成后的回调（server 用它重新 checkAgent）
+
+function pushLog(line) {
+  const t = new Date().toISOString().slice(11, 19);
+  state.log.push(`[${t}] ${line}`);
+  if (state.log.length > LOG_KEEP) state.log.splice(0, state.log.length - LOG_KEEP);
+}
+
+// npm 与 node 同目录（官方安装/nvm 均如此），GUI 启动 PATH 缺失时也能找到
+function npmCommand() {
+  const dir = path.dirname(process.execPath);
+  if (process.platform === 'win32') {
+    const local = path.join(dir, 'npm.cmd');
+    return { file: fs.existsSync(local) ? local : 'npm.cmd', shell: true };
+  }
+  const local = path.join(dir, 'npm');
+  return { file: fs.existsSync(local) ? local : 'npm', shell: false };
+}
+
+function runNpmInstall() {
+  return new Promise((resolve) => {
+    const npm = npmCommand();
+    let child;
+    try {
+      // --no-audit/--no-fund：跳过审计与赞助提示，大包安装明显提速
+      child = spawn(npm.file, ['install', '-g', NPM_PKG, '--no-audit', '--no-fund'], { env: process.env, stdio: ['ignore', 'pipe', 'pipe'], shell: npm.shell });
+    } catch (e) {
+      return resolve({ ok: false, error: `无法启动 npm: ${e.message}` });
+    }
+    // npm 非 TTY 运行时几乎没有中间输出，用心跳日志证明进程仍在下载
+    const t0 = Date.now();
+    const heartbeat = setInterval(() => pushLog(`下载安装中… 已耗时 ${Math.round((Date.now() - t0) / 1000)}s（首次需下载较大二进制，请耐心等待）`), 15000);
+    const timer = setTimeout(() => {
+      try { child.kill('SIGKILL'); } catch (_) { /* 已退出 */ }
+      resolve({ ok: false, error: `npm 安装超时(${INSTALL_TIMEOUT_MS / 60000}分钟)，已终止` });
+    }, INSTALL_TIMEOUT_MS);
+    const finish = (r) => { clearInterval(heartbeat); clearTimeout(timer); resolve(r); };
+    child.stdout.on('data', (d) => String(d).split('\n').forEach((l) => { if (l.trim()) pushLog(l.trim()); }));
+    child.stderr.on('data', (d) => String(d).split('\n').forEach((l) => { if (l.trim()) pushLog(l.trim()); }));
+    child.on('error', (e) => finish({ ok: false, error: `npm 启动失败: ${e.message}` }));
+    child.on('close', (code) => {
+      finish(code === 0 ? { ok: true } : { ok: false, error: `npm 退出码 ${code}（详见日志，可检查网络后重试）` });
+    });
+  });
+}
+
+// ---- opencode 配置文件 ----
+
+function xdgConfigHome() { return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'); }
+function xdgDataHome() { return process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share'); }
+function globalConfigPath() { return path.join(xdgConfigHome(), 'opencode', 'opencode.json'); }
+function authFilePath() { return path.join(xdgDataHome(), 'opencode', 'auth.json'); }
+
+function readJsonSafe(p) {
+  try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch (_) { return null; }
+}
+
+function existingSetup() {
+  const auth = readJsonSafe(authFilePath());
+  if (auth && typeof auth === 'object' && Object.keys(auth).length) return { configured: true, where: 'auth' };
+  const cfg = readJsonSafe(globalConfigPath());
+  if (cfg && typeof cfg === 'object' && cfg.model) return { configured: true, where: 'config' };
+  return { configured: false, where: null };
+}
+
+// 合并写入全局配置；原文件不可解析（如 jsonc 带注释）时先备份再重写
+function writeGlobalConfig(mutate) {
+  const p = globalConfigPath();
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  let cfg = readJsonSafe(p);
+  if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {
+    if (fs.existsSync(p)) {
+      try { fs.copyFileSync(p, `${p}.bak-${Date.now()}`); } catch (_) { /* 备份失败也继续 */ }
+    }
+    cfg = {};
+  }
+  mutate(cfg);
+  if (!cfg.$schema) cfg.$schema = 'https://opencode.ai/config.json';
+  fs.writeFileSync(p, JSON.stringify(cfg, null, 2) + '\n');
+  return p;
+}
+
+function fetchJson(url, timeoutMs = 2000) {
+  return fetch(url, { signal: AbortSignal.timeout(timeoutMs) })
+    .then((r) => (r.ok ? r.json() : null))
+    .catch(() => null);
+}
+
+const EMBED_RE = /embed|bge|clip|rerank|minilm|nomic|e5[-_]|jina|gte/i;
+
+async function detectLocalModels() {
+  const ollama = await fetchJson('http://127.0.0.1:11434/api/tags');
+  const oModels = ((ollama && Array.isArray(ollama.models)) ? ollama.models : [])
+    .map((m) => m && m.name).filter((n) => n && !EMBED_RE.test(n));
+  if (oModels.length) {
+    return { provider: 'ollama', baseURL: 'http://localhost:11434/v1', label: 'Ollama', models: oModels, pick: oModels[0] };
+  }
+  const lms = await fetchJson('http://127.0.0.1:1234/v1/models');
+  const lModels = ((lms && Array.isArray(lms.data)) ? lms.data : [])
+    .map((m) => m && m.id).filter((n) => n && !EMBED_RE.test(n));
+  if (lModels.length) {
+    return { provider: 'lmstudio', baseURL: 'http://127.0.0.1:1234/v1', label: 'LM Studio', models: lModels, pick: lModels[0] };
+  }
+  return null;
+}
+
+function applyLocalProvider(local) {
+  const models = {};
+  for (const id of local.models) models[id] = { name: id };
+  writeGlobalConfig((cfg) => {
+    cfg.provider = cfg.provider || {};
+    cfg.provider[local.provider] = {
+      npm: '@ai-sdk/openai-compatible',
+      name: `${local.label} (local)`,
+      options: { baseURL: local.baseURL },
+      models,
+    };
+    cfg.model = `${local.provider}/${local.pick}`;
+  });
+  return { source: local.provider, model: `${local.provider}/${local.pick}`, detail: `检测到本机 ${local.label}，已接入 ${local.models.length} 个模型，默认使用 ${local.pick}` };
+}
+
+function applyFreeModel() {
+  writeGlobalConfig((cfg) => { cfg.model = FREE_MODEL; });
+  return { source: 'free', model: FREE_MODEL, detail: '未检测到本机模型，已设置 OpenCode Zen 免费模型（无需登录，可在 opencode 配置中更换）' };
+}
+
+async function configureModel() {
+  const existing = existingSetup();
+  if (existing.configured) {
+    return { source: 'existing', model: null, detail: existing.where === 'auth' ? '检测到已有 opencode 认证，保留现有模型配置' : '检测到已设置默认模型，保留现有配置' };
+  }
+  const local = await detectLocalModels();
+  return local ? applyLocalProvider(local) : applyFreeModel();
+}
+
+// ---- 主流程 ----
+
+async function installFlow() {
+  running = true;
+  Object.assign(state, { phase: 'installing', step: `正在通过 npm 安装 ${NPM_PKG}…`, error: null, model: null, started_at: Date.now(), ended_at: null });
+  pushLog(`开始安装 ${NPM_PKG}`);
+
+  const inst = await runNpmInstall();
+  if (!inst.ok) {
+    Object.assign(state, { phase: 'error', step: '', error: inst.error, ended_at: Date.now() });
+    pushLog(`安装失败: ${inst.error}`);
+    running = false;
+    return;
+  }
+  pushLog('npm 安装完成，正在识别 opencode…');
+  state.phase = 'configuring';
+  state.step = '正在检测安装结果与配置模型…';
+
+  const ocbin = require('./ocbin');
+  const bin = ocbin.findOpenCodeBin({ refresh: true });
+  const version = bin && ocbin.probeVersion(bin);
+  if (!version) {
+    const msg = `安装完成但未能识别 opencode${bin ? `（${bin.path} 探测失败）` : ''}，可用环境变量 KG_OPENCODE_PATH 指定可执行文件路径后重试`;
+    Object.assign(state, { phase: 'error', step: '', error: msg, ended_at: Date.now() });
+    pushLog(msg);
+    running = false;
+    return;
+  }
+  pushLog(`已识别 opencode: ${bin.path}（${version}）`);
+
+  try {
+    state.model = await configureModel();
+    pushLog(`模型配置: ${state.model.detail}${state.model.model ? `，默认模型 ${state.model.model}` : ''}`);
+  } catch (e) {
+    state.model = { source: 'error', model: null, detail: `模型配置失败: ${e.message}（opencode 本体已可用，可手动在其配置中设置模型）` };
+    pushLog(state.model.detail);
+  }
+
+  Object.assign(state, { phase: 'done', step: '', ended_at: Date.now() });
+  pushLog('全部完成，OpenCode 已就绪');
+  running = false;
+  if (typeof onDone === 'function') { try { onDone(); } catch (_) { /* 回调异常不影响状态 */ } }
+}
+
+function startInstall(force = false) {
+  if (running) return { started: false, reason: '安装正在进行中' };
+  if (state.phase === 'done' && !force) return { started: false, reason: '已安装完成，无需重复安装（强制重装请带 force）' };
+  if (force) Object.assign(state, { phase: 'idle', log: [], error: null, model: null });
+  installFlow().catch((e) => {
+    Object.assign(state, { phase: 'error', step: '', error: e.message, ended_at: Date.now() });
+    running = false;
+  });
+  return { started: true };
+}
+
+function status() {
+  return { ...state, running, log: state.log.slice(-40) };
+}
+
+module.exports = { startInstall, status, FREE_MODEL, set onDone(fn) { onDone = fn; }, _internal: { configureModel, existingSetup, detectLocalModels, globalConfigPath, authFilePath } };