@cleocode/cleo 2026.4.51 → 2026.4.52

package/dist/cli/index.js

@@ -9600,11 +9600,14 @@ var init_brain_schema = __esm({
         source: text("source").notNull(),
         /** Estimated tokens consumed by this retrieval. */
         tokensUsed: integer("tokens_used"),
+        /** Session ID (soft FK to tasks.db sessions). Enables grouping retrievals by session for STDP analysis. */
+        sessionId: text("session_id"),
         createdAt: text("created_at").notNull().default(sql2`(datetime('now'))`)
       },
       (table) => [
         index("idx_retrieval_log_created").on(table.createdAt),
-        index("idx_retrieval_log_source").on(table.source)
+        index("idx_retrieval_log_source").on(table.source),
+        index("idx_retrieval_log_session").on(table.sessionId)
       ]
     );
     brainPlasticityEvents = sqliteTable(
@@ -14952,7 +14955,7 @@ function clearEmbeddingProvider() {
   currentProvider = null;
 }
 async function embedText(text3) {
-  if (!currentProvider || !currentProvider.isAvailable()) return null;
+  if (!currentProvider?.isAvailable()) return null;
   return currentProvider.embed(text3);
 }
 function isEmbeddingAvailable() {
@@ -22823,7 +22826,7 @@ function parseIdPrefix(id) {
   return null;
 }
 async function searchSimilar(query, projectRoot, limit) {
-  if (!query || !query.trim()) return [];
+  if (!query?.trim()) return [];
   if (!isEmbeddingAvailable()) return [];
   const maxResults = limit ?? 10;
   const queryVector = await embedText(query);
@@ -50370,7 +50373,7 @@ async function computeLastSession(projectRoot, scopeFilter) {
     const accessor = await getAccessor(projectRoot);
     const allSessions = await accessor.loadSessions();
     const session = allSessions.find((s3) => s3.id === sessionId);
-    if (!session || !session.endedAt) return null;
+    if (!session?.endedAt) return null;
     let duration3 = 0;
     if (session.startedAt) {
       duration3 = Math.round(
@@ -51557,10 +51560,17 @@ async function searchBrainCompact(projectRoot, params) {
       setImmediate(() => {
         incrementCitationCounts(projectRoot, returnedIds).catch(() => {
         });
-        logRetrieval(projectRoot, query, returnedIds, "find-rrf", results2.length * 50).catch(
-          () => {
-          }
-        );
+        getCurrentSessionId(projectRoot).then((sessionId) => {
+          return logRetrieval(
+            projectRoot,
+            query,
+            returnedIds,
+            "find-rrf",
+            results2.length * 50,
+            sessionId
+          );
+        }).catch(() => {
+        });
       });
     }
     return { results: results2, total: results2.length, tokensEstimated: results2.length * 50 };
@@ -51623,7 +51633,16 @@ async function searchBrainCompact(projectRoot, params) {
     setImmediate(() => {
       incrementCitationCounts(projectRoot, returnedIds).catch(() => {
       });
-      logRetrieval(projectRoot, query, returnedIds, "find", results.length * 50).catch(() => {
+      getCurrentSessionId(projectRoot).then((sessionId) => {
+        return logRetrieval(
+          projectRoot,
+          query,
+          returnedIds,
+          "find",
+          results.length * 50,
+          sessionId
+        );
+      }).catch(() => {
       });
     });
   }
@@ -51811,13 +51830,16 @@ async function fetchBrainEntries(projectRoot, params) {
     setImmediate(() => {
       incrementCitationCounts(projectRoot, fetchedIds).catch(() => {
       });
-      logRetrieval(
-        projectRoot,
-        fetchedIds.join(","),
-        fetchedIds,
-        "fetch",
-        results.length * 500
-      ).catch(() => {
+      getCurrentSessionId(projectRoot).then((sessionId) => {
+        return logRetrieval(
+          projectRoot,
+          fetchedIds.join(","),
+          fetchedIds,
+          "fetch",
+          results.length * 500,
+          sessionId
+        );
+      }).catch(() => {
       });
     });
   }
@@ -52235,6 +52257,15 @@ async function retrieveWithBudget(projectRoot, query, tokenBudget = 500, options
     excluded
   };
 }
+async function getCurrentSessionId(projectRoot) {
+  try {
+    const { sessionStatus: sessionStatus3 } = await Promise.resolve().then(() => (init_sessions2(), sessions_exports2));
+    const session = await sessionStatus3(projectRoot);
+    return session?.id;
+  } catch {
+    return void 0;
+  }
+}
 async function incrementCitationCounts(projectRoot, ids) {
   if (ids.length === 0) return;
   const { getBrainDb: getBrainDb2, getBrainNativeDb: getBrainNativeDb2 } = await Promise.resolve().then(() => (init_brain_sqlite(), brain_sqlite_exports));
@@ -52261,13 +52292,13 @@ async function incrementCitationCounts(projectRoot, ids) {
     }
   }
 }
-async function logRetrieval(projectRoot, query, entryIds, source, tokensUsed) {
+async function logRetrieval(projectRoot, query, entryIds, source, tokensUsed, sessionId) {
   if (entryIds.length === 0) return;
   const { getBrainDb: getBrainDb2, getBrainNativeDb: getBrainNativeDb2 } = await Promise.resolve().then(() => (init_brain_sqlite(), brain_sqlite_exports));
   await getBrainDb2(projectRoot);
   const nativeDb = getBrainNativeDb2();
   if (!nativeDb) return;
-  const createSql = "CREATE TABLE IF NOT EXISTS brain_retrieval_log (id INTEGER PRIMARY KEY AUTOINCREMENT,query TEXT NOT NULL,entry_ids TEXT NOT NULL,entry_count INTEGER NOT NULL,source TEXT NOT NULL,tokens_used INTEGER,created_at TEXT NOT NULL DEFAULT (datetime('now')))";
+  const createSql = "CREATE TABLE IF NOT EXISTS brain_retrieval_log (id INTEGER PRIMARY KEY AUTOINCREMENT,query TEXT NOT NULL,entry_ids TEXT NOT NULL,entry_count INTEGER NOT NULL,source TEXT NOT NULL,tokens_used INTEGER,session_id TEXT,created_at TEXT NOT NULL DEFAULT (datetime('now')))";
   try {
     nativeDb.prepare(createSql).run();
   } catch {
@@ -52275,8 +52306,15 @@ async function logRetrieval(projectRoot, query, entryIds, source, tokensUsed) {
   }
   try {
     nativeDb.prepare(
-      "INSERT INTO brain_retrieval_log (query, entry_ids, entry_count, source, tokens_used) VALUES (?, ?, ?, ?, ?)"
-    ).run(query, entryIds.join(","), entryIds.length, source, tokensUsed ?? null);
+      "INSERT INTO brain_retrieval_log (query, entry_ids, entry_count, source, tokens_used, session_id) VALUES (?, ?, ?, ?, ?, ?)"
+    ).run(
+      query,
+      entryIds.join(","),
+      entryIds.length,
+      source,
+      tokensUsed ?? null,
+      sessionId ?? null
+    );
   } catch {
   }
 }
@@ -58851,7 +58889,7 @@ function prepareSpawnMulti(skillNames, tokenValues, cwd) {
     const skillName = skillNames[i];
     const isPrimary = i === 0;
     const skill = findSkill(skillName, cwd);
-    if (!skill || !skill.content) {
+    if (!skill?.content) {
       continue;
     }
     let content = isPrimary ? skill.content : loadProgressive(skill.content);
@@ -74367,7 +74405,7 @@ async function injectProtocol(skillContent, taskId, tokenValues, cwd, tier) {
 }
 async function orchestratorSpawnSkill(taskId, skillName, tokenValues, cwd, tier) {
   const skill = findSkill(skillName, cwd);
-  if (!skill || !skill.content) {
+  if (!skill?.content) {
     throw new CleoError(4 /* NOT_FOUND */, `Skill not found: ${skillName}`, {
       fix: `Check skills directory for ${skillName}/SKILL.md`
     });
@@ -74937,7 +74975,7 @@ async function buildPrompt(taskId, templateName = "TASK-EXECUTOR", cwd, tier) {
     throw new CleoError(4 /* NOT_FOUND */, `Task ${taskId} not found`);
   }
   const skill = findSkill(templateName, cwd);
-  if (!skill || !skill.content) {
+  if (!skill?.content) {
     const { canonical } = mapSkillName(templateName);
     throw new CleoError(4 /* NOT_FOUND */, `Skill template ${templateName} not found`, {
       fix: `Expected at skills/${canonical}/SKILL.md`
@@ -77732,7 +77770,7 @@ async function analyzeArchive(opts, accessor) {
   const acc = accessor ?? await getAccessor(opts.cwd);
   const data = await acc.loadArchive();
   const reportType = opts.report ?? "summary";
-  if (!data || !data.archivedTasks?.length) {
+  if (!data?.archivedTasks?.length) {
     return {
       report: reportType,
       filters: null,
@@ -85793,16 +85831,12 @@ function allEpicChildrenVerified(epicId, tasks2) {
   if (children.length === 0) return false;
   const incomplete = children.filter((t) => t.status !== "done");
   if (incomplete.length > 0) return false;
-  const unverified = children.filter(
-    (t) => t.status === "done" && (!t.verification || !t.verification.passed)
-  );
+  const unverified = children.filter((t) => t.status === "done" && !t.verification?.passed);
   return unverified.length === 0;
 }
 function allSiblingsVerified(parentId, tasks2) {
   const siblings = tasks2.filter((t) => t.parentId === parentId);
-  const unverifiedDone = siblings.filter(
-    (t) => t.status === "done" && (!t.verification || !t.verification.passed)
-  );
+  const unverifiedDone = siblings.filter((t) => t.status === "done" && !t.verification?.passed);
   const incomplete = siblings.filter(
     (t) => t.status === "pending" || t.status === "active" || t.status === "blocked"
   );
@@ -87208,7 +87242,7 @@ var init_init = __esm({
 // packages/core/src/sessions/context-alert.ts
 import { existsSync as existsSync109, readFileSync as readFileSync80, writeFileSync as writeFileSync20 } from "node:fs";
 import { join as join109 } from "node:path";
-function getCurrentSessionId(cwd) {
+function getCurrentSessionId2(cwd) {
   if (process.env.CLEO_SESSION) return process.env.CLEO_SESSION;
   const sessionFile = join109(getCleoDir(cwd), ".current-session");
   if (existsSync109(sessionFile)) {
@@ -87242,7 +87276,7 @@ function createCliMeta(operation, duration_ms = 0) {
     duration_ms,
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const sessionId = getCurrentSessionId();
+  const sessionId = getCurrentSessionId2();
   if (sessionId) {
     meta3["sessionId"] = sessionId;
   }
@@ -90912,6 +90946,160 @@ var init_brain_backfill = __esm({
   }
 });
 
+// packages/core/src/memory/brain-export.ts
+async function exportBrainAsGexf(projectRoot) {
+  const db = await getBrainDb(projectRoot);
+  let nodes = [];
+  let edges = [];
+  try {
+    nodes = await db.select({
+      id: brainPageNodes.id,
+      nodeType: brainPageNodes.nodeType,
+      label: brainPageNodes.label,
+      qualityScore: brainPageNodes.qualityScore,
+      contentHash: brainPageNodes.contentHash,
+      lastActivityAt: brainPageNodes.lastActivityAt,
+      metadataJson: brainPageNodes.metadataJson,
+      createdAt: brainPageNodes.createdAt,
+      updatedAt: brainPageNodes.updatedAt
+    }).from(brainPageNodes);
+  } catch {
+    nodes = [];
+  }
+  try {
+    const rawEdges = await db.select({
+      fromId: brainPageEdges.fromId,
+      toId: brainPageEdges.toId,
+      edgeType: brainPageEdges.edgeType,
+      weight: brainPageEdges.weight,
+      createdAt: brainPageEdges.createdAt
+    }).from(brainPageEdges);
+    edges = rawEdges.map((e) => ({ ...e, provenance: null }));
+  } catch {
+    edges = [];
+  }
+  const gexf = buildGexfDocument(nodes, edges);
+  return {
+    success: true,
+    format: "gexf",
+    nodeCount: nodes.length,
+    edgeCount: edges.length,
+    content: gexf,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+async function exportBrainAsJson(projectRoot) {
+  const db = await getBrainDb(projectRoot);
+  let nodes = [];
+  let edges = [];
+  try {
+    nodes = await db.select({
+      id: brainPageNodes.id,
+      nodeType: brainPageNodes.nodeType,
+      label: brainPageNodes.label,
+      qualityScore: brainPageNodes.qualityScore,
+      contentHash: brainPageNodes.contentHash,
+      lastActivityAt: brainPageNodes.lastActivityAt,
+      metadataJson: brainPageNodes.metadataJson,
+      createdAt: brainPageNodes.createdAt,
+      updatedAt: brainPageNodes.updatedAt
+    }).from(brainPageNodes);
+  } catch {
+    nodes = [];
+  }
+  try {
+    const rawEdges = await db.select({
+      fromId: brainPageEdges.fromId,
+      toId: brainPageEdges.toId,
+      edgeType: brainPageEdges.edgeType,
+      weight: brainPageEdges.weight,
+      createdAt: brainPageEdges.createdAt
+    }).from(brainPageEdges);
+    edges = rawEdges.map((e) => ({ ...e, provenance: null }));
+  } catch {
+    edges = [];
+  }
+  return {
+    success: true,
+    format: "json",
+    nodeCount: nodes.length,
+    edgeCount: edges.length,
+    nodes,
+    edges,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function buildGexfDocument(nodes, edges) {
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<gexf xmlns="http://www.gexf.net/1.3draft" version="1.3">',
+    '  <meta lastmodifieddate="' + (/* @__PURE__ */ new Date()).toISOString() + '">',
+    "    <creator>CLEO Brain Export (T626-M6)</creator>",
+    "    <description>Living brain knowledge graph (brain_page_nodes + brain_page_edges)</description>",
+    "  </meta>",
+    '  <graph mode="static" defaultedgetype="directed">'
+  ];
+  lines.push('    <attributes class="node">');
+  lines.push('      <attribute id="node_type" title="Node Type" type="string"/>');
+  lines.push('      <attribute id="quality_score" title="Quality Score" type="double"/>');
+  lines.push('      <attribute id="content_hash" title="Content Hash" type="string"/>');
+  lines.push('      <attribute id="last_activity_at" title="Last Activity" type="string"/>');
+  lines.push('      <attribute id="created_at" title="Created At" type="string"/>');
+  lines.push("    </attributes>");
+  lines.push('    <attributes class="edge">');
+  lines.push('      <attribute id="edge_type" title="Edge Type" type="string"/>');
+  lines.push('      <attribute id="provenance" title="Provenance" type="string"/>');
+  lines.push('      <attribute id="created_at" title="Created At" type="string"/>');
+  lines.push("    </attributes>");
+  lines.push("    <nodes>");
+  for (const node of nodes) {
+    lines.push(`      <node id="${escapeXml(node.id)}" label="${escapeXml(node.label)}">`);
+    lines.push("        <attvalues>");
+    lines.push(`          <attvalue for="node_type" value="${escapeXml(node.nodeType)}"/>`);
+    lines.push(`          <attvalue for="quality_score" value="${node.qualityScore ?? 0.5}"/>`);
+    if (node.contentHash) {
+      lines.push(`          <attvalue for="content_hash" value="${escapeXml(node.contentHash)}"/>`);
+    }
+    lines.push(
+      `          <attvalue for="last_activity_at" value="${escapeXml(node.lastActivityAt)}"/>`
+    );
+    lines.push(`          <attvalue for="created_at" value="${escapeXml(node.createdAt)}"/>`);
+    lines.push("        </attvalues>");
+    lines.push("      </node>");
+  }
+  lines.push("    </nodes>");
+  lines.push("    <edges>");
+  for (let i = 0; i < edges.length; i++) {
+    const edge = edges[i];
+    const weight = edge.weight ?? 1;
+    lines.push(
+      `      <edge id="${i}" source="${escapeXml(edge.fromId)}" target="${escapeXml(edge.toId)}" weight="${weight}">`
+    );
+    lines.push("        <attvalues>");
+    lines.push(`          <attvalue for="edge_type" value="${escapeXml(edge.edgeType)}"/>`);
+    if (edge.provenance) {
+      lines.push(`          <attvalue for="provenance" value="${escapeXml(edge.provenance)}"/>`);
+    }
+    lines.push(`          <attvalue for="created_at" value="${escapeXml(edge.createdAt)}"/>`);
+    lines.push("        </attvalues>");
+    lines.push("      </edge>");
+  }
+  lines.push("    </edges>");
+  lines.push("  </graph>");
+  lines.push("</gexf>");
+  return lines.join("\n");
+}
+function escapeXml(text3) {
+  return text3.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+var init_brain_export = __esm({
+  "packages/core/src/memory/brain-export.ts"() {
+    "use strict";
+    init_brain_schema();
+    init_brain_sqlite();
+  }
+});
+
 // packages/core/src/memory/brain-maintenance.ts
 async function runBrainMaintenance(projectRoot, options) {
   const {
@@ -91321,7 +91509,7 @@ Use --source <path> to specify a custom location.`
       }
       try {
         for (const row of batch) {
-          if (!row.learned || !row.learned.trim()) {
+          if (!row.learned?.trim()) {
             continue;
           }
           const learnId = `CML-${row.id}`;
@@ -98701,7 +98889,7 @@ function measureDependencyDepth(taskId, taskMap, visited = /* @__PURE__ */ new S
   if (visited.has(taskId)) return 0;
   visited.add(taskId);
   const task = taskMap.get(taskId);
-  if (!task || !task.depends || task.depends.length === 0) return 0;
+  if (!task?.depends || task.depends.length === 0) return 0;
   let maxDepth = 0;
   for (const depId of task.depends) {
     const depth = 1 + measureDependencyDepth(depId, taskMap, visited);
@@ -99055,7 +99243,7 @@ async function coreTaskUnarchive(projectRoot, taskId, params) {
     throw new Error(`Task '${taskId}' already exists in active tasks`);
   }
   const archive = await accessor.loadArchive();
-  if (!archive || !archive.archivedTasks) {
+  if (!archive?.archivedTasks) {
     throw new Error("No archive file found");
   }
   const taskIndex = archive.archivedTasks.findIndex((t) => t.id === taskId);
@@ -113440,6 +113628,8 @@ __export(internal_exports, {
   ensureSqliteDb: () => ensureSqliteDb,
   estimateContext: () => estimateContext,
   executeTransfer: () => executeTransfer,
+  exportBrainAsGexf: () => exportBrainAsGexf,
+  exportBrainAsJson: () => exportBrainAsJson,
   exportSnapshot: () => exportSnapshot,
   exportTasks: () => exportTasks,
   exportTasksPackage: () => exportTasksPackage,
@@ -113509,7 +113699,7 @@ __export(internal_exports, {
   getConfigValue: () => getConfigValue,
   getContextDrift: () => getContextDrift,
   getCriticalPath: () => getCriticalPath,
-  getCurrentSessionId: () => getCurrentSessionId,
+  getCurrentSessionId: () => getCurrentSessionId2,
   getDashboard: () => getDashboard,
   getDb: () => getDb,
   getDecisionLog: () => getDecisionLog,
@@ -114017,6 +114207,7 @@ var init_internal = __esm({
     init_stages();
     init_tessera_engine();
     init_brain_backfill();
+    init_brain_export();
     init_brain_lifecycle();
     init_brain_maintenance();
     init_brain_purge();
@@ -136332,6 +136523,47 @@ Recent Events (newest first, limit=${limit})`);
       process.exit(1);
     }
   });
+  brain.command("export").description("Export brain graph as GEXF (Gephi) or JSON format").option(
+    "--format <format>",
+    "Export format: gexf (Gephi standard) or json (flat arrays)",
+    "gexf"
+  ).option("--output <file>", "Write to file instead of stdout (optional)").action(async (opts) => {
+    const root = getProjectRoot();
+    const format = opts.format ?? "gexf";
+    if (format !== "gexf" && format !== "json") {
+      console.error(`Invalid format: ${format}. Use 'gexf' or 'json'.`);
+      process.exit(1);
+    }
+    try {
+      let content;
+      let nodeCount;
+      let edgeCount;
+      if (format === "gexf") {
+        const result = await exportBrainAsGexf(root);
+        content = result.content;
+        nodeCount = result.nodeCount;
+        edgeCount = result.edgeCount;
+      } else {
+        const result = await exportBrainAsJson(root);
+        content = JSON.stringify(result, null, 2);
+        nodeCount = result.nodeCount;
+        edgeCount = result.edgeCount;
+      }
+      if (opts.output) {
+        const fs11 = await import("node:fs");
+        fs11.writeFileSync(opts.output, content, "utf-8");
+        console.log(
+          `Exported to ${opts.output}: ${nodeCount} nodes, ${edgeCount} edges (${format.toUpperCase()})`
+        );
+      } else {
+        console.log(content);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(`Brain export failed: ${message}`);
+      process.exit(1);
+    }
+  });
 }
 
 // packages/cleo/src/cli/commands/briefing.ts
@@ -139643,6 +139875,175 @@ var NODE_KIND_PRIORITY = {
   file: 40,
   folder: 41
 };
+function generateGexf(nodes, relations) {
+  const nodeById = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    nodeById.set(String(n["id"]), n);
+  }
+  const kindColors = {
+    function: "#3498db",
+    // blue
+    method: "#2980b9",
+    // darker blue
+    class: "#e74c3c",
+    // red
+    interface: "#e67e22",
+    // orange
+    file: "#95a5a6",
+    // gray
+    folder: "#34495e",
+    // dark gray
+    community: "#9b59b6",
+    // purple
+    process: "#1abc9c",
+    // teal
+    import: "#f39c12",
+    // amber
+    default: "#7f8c8d"
+    // medium gray
+  };
+  const getNodeColor = (kind) => {
+    return kindColors[kind] ?? kindColors["default"];
+  };
+  let gexf = '<?xml version="1.0" encoding="UTF-8"?>\n';
+  gexf += '<gexf xmlns="http://www.gexf.net/1.2draft" xmlns:viz="http://www.gexf.net/1.2draft/viz" version="1.2">\n';
+  gexf += '  <meta lastmodifieddate="' + (/* @__PURE__ */ new Date()).toISOString().split("T")[0] + '">\n';
+  gexf += "    <creator>CLEO nexus export</creator>\n";
+  gexf += "    <description>Code intelligence graph from CLEO nexus</description>\n";
+  gexf += "  </meta>\n";
+  gexf += '  <graph mode="static" defaultedgetype="directed">\n';
+  gexf += '    <attributes class="node">\n';
+  gexf += '      <attribute id="kind" title="Node Kind" type="string" />\n';
+  gexf += '      <attribute id="filePath" title="File Path" type="string" />\n';
+  gexf += '      <attribute id="language" title="Language" type="string" />\n';
+  gexf += '      <attribute id="startLine" title="Start Line" type="integer" />\n';
+  gexf += '      <attribute id="endLine" title="End Line" type="integer" />\n';
+  gexf += '      <attribute id="isExported" title="Is Exported" type="boolean" />\n';
+  gexf += '      <attribute id="projectId" title="Project ID" type="string" />\n';
+  gexf += "    </attributes>\n";
+  gexf += '    <attributes class="edge">\n';
+  gexf += '      <attribute id="relationType" title="Relation Type" type="string" />\n';
+  gexf += '      <attribute id="confidence" title="Confidence" type="double" />\n';
+  gexf += '      <attribute id="reason" title="Reason" type="string" />\n';
+  gexf += "    </attributes>\n";
+  gexf += "    <nodes>\n";
+  for (const node of nodes) {
+    const nodeId = String(node["id"]).replace(/[<>"'&]/g, (c) => {
+      const map2 = {
+        "<": "&lt;",
+        ">": "&gt;",
+        '"': "&quot;",
+        "'": "&apos;",
+        "&": "&amp;"
+      };
+      return map2[c];
+    });
+    const label = String(node["label"] ?? node["id"]);
+    const kind = String(node["kind"] ?? "unknown");
+    const color = getNodeColor(kind);
+    gexf += `      <node id="${nodeId}" label="${escapeXml2(label)}">
+`;
+    gexf += `        <viz:color r="${hexToRgb(color).r}" g="${hexToRgb(color).g}" b="${hexToRgb(color).b}" />
+`;
+    gexf += "        <attvalues>\n";
+    gexf += `          <attvalue id="kind" value="${escapeXml2(kind)}" />
+`;
+    if (node["filePath"]) {
+      gexf += `          <attvalue id="filePath" value="${escapeXml2(String(node["filePath"]))}" />
+`;
+    }
+    if (node["language"]) {
+      gexf += `          <attvalue id="language" value="${escapeXml2(String(node["language"]))}" />
+`;
+    }
+    if (node["startLine"] != null) {
+      gexf += `          <attvalue id="startLine" value="${node["startLine"]}" />
+`;
+    }
+    if (node["endLine"] != null) {
+      gexf += `          <attvalue id="endLine" value="${node["endLine"]}" />
+`;
+    }
+    if (node["isExported"] != null) {
+      gexf += `          <attvalue id="isExported" value="${node["isExported"] ? "true" : "false"}" />
+`;
+    }
+    if (node["projectId"]) {
+      gexf += `          <attvalue id="projectId" value="${escapeXml2(String(node["projectId"]))}" />
+`;
+    }
+    gexf += "        </attvalues>\n";
+    gexf += "      </node>\n";
+  }
+  gexf += "    </nodes>\n";
+  gexf += "    <edges>\n";
+  for (let i = 0; i < relations.length; i++) {
+    const rel = relations[i];
+    const sourceId = String(rel["sourceId"]).replace(/[<>"'&]/g, (c) => {
+      const map2 = {
+        "<": "&lt;",
+        ">": "&gt;",
+        '"': "&quot;",
+        "'": "&apos;",
+        "&": "&amp;"
+      };
+      return map2[c];
+    });
+    const targetId = String(rel["targetId"]).replace(/[<>"'&]/g, (c) => {
+      const map2 = {
+        "<": "&lt;",
+        ">": "&gt;",
+        '"': "&quot;",
+        "'": "&apos;",
+        "&": "&amp;"
+      };
+      return map2[c];
+    });
+    if (!nodeById.has(String(rel["sourceId"])) || !nodeById.has(String(rel["targetId"]))) {
+      continue;
+    }
+    const confidence = typeof rel["confidence"] === "number" ? rel["confidence"] : 1;
+    const relationType = String(rel["type"] ?? "unknown");
+    const reason = rel["reason"] ? String(rel["reason"]) : "";
+    gexf += `      <edge id="e${i}" source="${sourceId}" target="${targetId}" weight="${confidence}">
+`;
+    gexf += "        <attvalues>\n";
+    gexf += `          <attvalue id="relationType" value="${escapeXml2(relationType)}" />
+`;
+    gexf += `          <attvalue id="confidence" value="${confidence}" />
+`;
+    if (reason) {
+      gexf += `          <attvalue id="reason" value="${escapeXml2(reason)}" />
+`;
+    }
+    gexf += "        </attvalues>\n";
+    gexf += "      </edge>\n";
+  }
+  gexf += "    </edges>\n";
+  gexf += "  </graph>\n";
+  gexf += "</gexf>\n";
+  return gexf;
+}
+function escapeXml2(str) {
+  return String(str).replace(/[<>"'&]/g, (c) => {
+    const map2 = {
+      "<": "&lt;",
+      ">": "&gt;",
+      '"': "&quot;",
+      "'": "&apos;",
+      "&": "&amp;"
+    };
+    return map2[c];
+  });
+}
+function hexToRgb(hex3) {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex3);
+  return result ? {
+    r: parseInt(result[1], 16),
+    g: parseInt(result[2], 16),
+    b: parseInt(result[3], 16)
+  } : { r: 127, g: 140, b: 141 };
+}
 function sortMatchingNodes(nodes, symbolName) {
   const lowerSymbol = symbolName.toLowerCase();
   return [...nodes].sort((a, b2) => {
@@ -140877,6 +141278,84 @@ function registerNexusCommand(program) {
       process.exitCode = 1;
     }
   });
+  nexus.command("export").description("Export nexus graph to GEXF (Gephi) or JSON format").option("--format <format>", "Output format: gexf, json", "gexf").option("--output <file>", "Output file path (stdout if omitted)").option("--project <id>", "Filter by project ID (exports all projects if omitted)").action(async (opts) => {
+    const startTime = Date.now();
+    const format = opts["format"] ?? "gexf";
+    const outputFile = opts["output"];
+    const projectFilter = opts["project"];
+    try {
+      const { getNexusDb: getNexusDb2, nexusSchema } = await import("@cleocode/core/store/nexus-sqlite");
+      const db = await getNexusDb2();
+      let allNodes = [];
+      let allRelations = [];
+      try {
+        allNodes = db.select().from(nexusSchema.nexusNodes).all();
+        allRelations = db.select().from(nexusSchema.nexusRelations).all();
+      } catch {
+      }
+      const nodes = projectFilter ? allNodes.filter((n) => n["projectId"] === projectFilter) : allNodes;
+      const relations = projectFilter ? allRelations.filter((r) => r["projectId"] === projectFilter) : allRelations;
+      let output = "";
+      if (format === "json") {
+        output = JSON.stringify(
+          {
+            nodes: nodes.map((n) => ({
+              id: n["id"],
+              kind: n["kind"],
+              label: n["label"],
+              name: n["name"],
+              filePath: n["filePath"],
+              language: n["language"],
+              isExported: n["isExported"],
+              startLine: n["startLine"],
+              endLine: n["endLine"],
+              projectId: n["projectId"]
+            })),
+            edges: relations.map((r) => ({
+              id: r["id"],
+              source: r["sourceId"],
+              target: r["targetId"],
+              type: r["type"],
+              confidence: r["confidence"],
+              reason: r["reason"]
+            }))
+          },
+          null,
+          2
+        );
+      } else if (format === "gexf") {
+        output = generateGexf(nodes, relations);
+      } else {
+        process.stderr.write(
+          `[nexus] Error: Unknown format '${format}'. Supported: gexf, json
+`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      if (outputFile) {
+        const { writeFileSync: writeFileSync26 } = await import("node:fs");
+        writeFileSync26(outputFile, output, "utf-8");
+        process.stdout.write(
+          `[nexus] Exported to ${outputFile} (${nodes.length} nodes, ${relations.length} edges)
+`
+        );
+      } else {
+        process.stdout.write(output);
+        if (!output.endsWith("\n")) process.stdout.write("\n");
+      }
+      const durationMs = Date.now() - startTime;
+      if (outputFile) {
+        process.stderr.write(`[nexus] Export completed in ${durationMs}ms
+`);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`[nexus] Error: ${msg}
+`);
+      process.exitCode = 1;
+    }
+  });
   nexus.command("diff").description(
     "Compare NEXUS index state between two git commits \u2014 shows new/removed relations and broken call chains"
   ).option("--before <sha>", 'Git SHA or ref for the "before" snapshot (default: HEAD~1)').option("--after <sha>", 'Git SHA or ref for the "after" snapshot (default: HEAD)', "HEAD").option("--path <dir>", "Repository directory to analyze (default: cwd)").option("--json", "Output result as JSON (LAFS envelope format)").option("--project-id <id>", "Override the project ID (default: auto-detected from path)").action(async (opts) => {