@cleocode/cleo 2026.4.51 → 2026.4.53

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(
@@ -11139,44 +11142,6 @@ var init_platform_paths = __esm({
 });
 
 // packages/core/src/paths.ts
-var paths_exports = {};
-__export(paths_exports, {
-  getAgentOutputsAbsolute: () => getAgentOutputsAbsolute,
-  getAgentOutputsDir: () => getAgentOutputsDir,
-  getAgentsHome: () => getAgentsHome,
-  getArchivePath: () => getArchivePath,
-  getBackupDir: () => getBackupDir,
-  getClaudeAgentsDir: () => getClaudeAgentsDir,
-  getClaudeMemDbPath: () => getClaudeMemDbPath,
-  getCleoCacheDir: () => getCleoCacheDir,
-  getCleoCantWorkflowsDir: () => getCleoCantWorkflowsDir,
-  getCleoConfigDir: () => getCleoConfigDir,
-  getCleoDir: () => getCleoDir,
-  getCleoDirAbsolute: () => getCleoDirAbsolute,
-  getCleoDocsDir: () => getCleoDocsDir,
-  getCleoGlobalAgentsDir: () => getCleoGlobalAgentsDir,
-  getCleoGlobalJustfilePath: () => getCleoGlobalJustfilePath,
-  getCleoGlobalRecipesDir: () => getCleoGlobalRecipesDir,
-  getCleoHome: () => getCleoHome,
-  getCleoLogDir: () => getCleoLogDir,
-  getCleoPiExtensionsDir: () => getCleoPiExtensionsDir,
-  getCleoSchemasDir: () => getCleoSchemasDir,
-  getCleoTempDir: () => getCleoTempDir,
-  getCleoTemplatesDir: () => getCleoTemplatesDir,
-  getCleoTemplatesTildePath: () => getCleoTemplatesTildePath,
-  getConfigPath: () => getConfigPath,
-  getGlobalConfigPath: () => getGlobalConfigPath,
-  getLogPath: () => getLogPath,
-  getManifestArchivePath: () => getManifestArchivePath,
-  getManifestPath: () => getManifestPath,
-  getProjectRoot: () => getProjectRoot,
-  getSessionsPath: () => getSessionsPath,
-  getTaskPath: () => getTaskPath,
-  isAbsolutePath: () => isAbsolutePath,
-  isProjectInitialized: () => isProjectInitialized,
-  resolveProjectPath: () => resolveProjectPath,
-  worktreeScope: () => worktreeScope
-});
 import { AsyncLocalStorage } from "node:async_hooks";
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
 import { homedir } from "node:os";
@@ -11195,9 +11160,6 @@ function getCleoTemplatesDir() {
 function getCleoSchemasDir() {
   return join4(getCleoHome(), "schemas");
 }
-function getCleoDocsDir() {
-  return join4(getCleoHome(), "docs");
-}
 function getCleoDir(cwd) {
   if (cwd) {
     return getCleoDirAbsolute(cwd);
@@ -11269,15 +11231,6 @@ function getTaskPath(cwd) {
 function getConfigPath(cwd) {
   return join4(getCleoDirAbsolute(cwd), "config.json");
 }
-function getSessionsPath(cwd) {
-  return join4(getCleoDirAbsolute(cwd), "sessions.json");
-}
-function getArchivePath(cwd) {
-  return join4(getCleoDirAbsolute(cwd), "tasks-archive.json");
-}
-function getLogPath(cwd) {
-  return join4(getCleoDirAbsolute(cwd), "logs", "cleo.log");
-}
 function getBackupDir(cwd) {
   return join4(getCleoDirAbsolute(cwd), "backups", "operational");
 }
@@ -14330,8 +14283,8 @@ async function cleanupMigrationArtifacts(backupPath) {
 }
 async function validateSqliteDatabase(dbPath) {
   try {
-    const { createRequire: createRequire19 } = await import("node:module");
-    const _req = createRequire19(import.meta.url);
+    const { createRequire: createRequire20 } = await import("node:module");
+    const _req = createRequire20(import.meta.url);
     const { DatabaseSync: DatabaseSync10 } = _req("node:sqlite");
     const db = new DatabaseSync10(dbPath, { readOnly: true });
     const integrityRow = db.prepare("PRAGMA integrity_check").get();
@@ -14952,7 +14905,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 +22776,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 +50323,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 +51510,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 +51583,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 +51780,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 +52207,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 +52242,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 +52256,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 {
   }
 }
@@ -56018,6 +56006,7 @@ __export(scaffold_exports, {
   checkConfig: () => checkConfig,
   checkGitignore: () => checkGitignore,
   checkGlobalHome: () => checkGlobalHome,
+  checkGlobalIdentity: () => checkGlobalIdentity,
   checkGlobalTemplates: () => checkGlobalTemplates,
   checkLogDir: () => checkLogDir,
   checkMemoryBridge: () => checkMemoryBridge,
@@ -56034,6 +56023,7 @@ __export(scaffold_exports, {
   ensureContributorMcp: () => ensureContributorMcp,
   ensureGitignore: () => ensureGitignore,
   ensureGlobalHome: () => ensureGlobalHome,
+  ensureGlobalIdentity: () => ensureGlobalIdentity,
   ensureGlobalScaffold: () => ensureGlobalScaffold,
   ensureGlobalTemplates: () => ensureGlobalTemplates,
   ensureProjectContext: () => ensureProjectContext,
@@ -56051,6 +56041,7 @@ import { execFile as execFile3 } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { existsSync as existsSync40, constants as fsConstants3, readFileSync as readFileSync26, statSync as statSync8 } from "node:fs";
 import { access as access3, copyFile as copyFile2, mkdir as mkdir6, readdir as readdir2, readFile as readFile7, rm as rm2, writeFile as writeFile6 } from "node:fs/promises";
+import { createRequire as createRequire9 } from "node:module";
 import { homedir as getHomedir } from "node:os";
 import { dirname as dirname10, join as join42, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
@@ -56906,6 +56897,102 @@ async function ensureCleoOsHub() {
     details: `pi-extensions: ${piResult.copied} created/${piResult.kept} kept, global-recipes: ${recipesResult.copied} created/${recipesResult.kept} kept`
   };
 }
+function resolveIdentitySourcePath() {
+  const monorepoPath = join42(
+    process.cwd(),
+    "packages",
+    "cleo-os",
+    "starter-bundle",
+    "CLEOOS-IDENTITY.md"
+  );
+  if (existsSync40(monorepoPath)) return monorepoPath;
+  try {
+    const require2 = createRequire9(import.meta.url);
+    const pkgJson = require2.resolve("@cleocode/cleo-os/package.json");
+    const pkgDir = pkgJson.replace(/\/package\.json$/, "");
+    const installedPath = join42(pkgDir, "starter-bundle", "CLEOOS-IDENTITY.md");
+    if (existsSync40(installedPath)) return installedPath;
+  } catch {
+  }
+  return null;
+}
+async function ensureGlobalIdentity(forceRefresh = false) {
+  const sourcePath = resolveIdentitySourcePath();
+  if (!sourcePath) {
+    return {
+      action: "skipped",
+      path: "",
+      details: "CLEOOS-IDENTITY.md source not found in monorepo or installed package"
+    };
+  }
+  const cleoHome = getCleoHome();
+  const dst = join42(cleoHome, "CLEOOS-IDENTITY.md");
+  try {
+    await mkdir6(cleoHome, { recursive: true });
+  } catch (err) {
+    return {
+      action: "skipped",
+      path: dst,
+      details: `Failed to create global cleo home: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+  if (existsSync40(dst) && !forceRefresh) {
+    return { action: "skipped", path: dst, details: "identity already present" };
+  }
+  const existedBefore = existsSync40(dst);
+  try {
+    const content = readFileSync26(sourcePath, "utf-8");
+    await writeFile6(dst, content);
+    return {
+      action: existedBefore ? "repaired" : "created",
+      path: dst,
+      details: `from ${sourcePath}`
+    };
+  } catch (err) {
+    return {
+      action: "skipped",
+      path: dst,
+      details: `Failed to write identity: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+}
+function checkGlobalIdentity() {
+  const cleoHome = getCleoHome();
+  const identityPath = join42(cleoHome, "CLEOOS-IDENTITY.md");
+  if (!existsSync40(identityPath)) {
+    return {
+      id: "global_identity",
+      category: "global",
+      status: "failed",
+      message: "Global CLEOOS-IDENTITY.md not found \u2014 orchestrator persona missing",
+      details: { path: identityPath, exists: false },
+      fix: "cleo upgrade (auto-deploys identity)"
+    };
+  }
+  let size = 0;
+  try {
+    size = statSync8(identityPath).size;
+  } catch {
+  }
+  if (size === 0) {
+    return {
+      id: "global_identity",
+      category: "global",
+      status: "failed",
+      message: "Global CLEOOS-IDENTITY.md exists but is empty",
+      details: { path: identityPath, exists: true, size: 0 },
+      fix: "cleo upgrade --refresh-identity"
+    };
+  }
+  return {
+    id: "global_identity",
+    category: "global",
+    status: "passed",
+    message: "Global CLEOOS-IDENTITY.md present",
+    details: { path: identityPath, exists: true, size },
+    fix: ""
+  };
+}
 function checkGlobalHome() {
   const cleoHome = getCleoHome();
   if (!existsSync40(cleoHome)) {
@@ -58851,7 +58938,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);
@@ -63304,7 +63391,7 @@ var init_agent_outputs = __esm({
 // packages/core/src/migration/checksum.ts
 import { createHash as createHash8 } from "node:crypto";
 import { readFileSync as readFileSync37 } from "node:fs";
-import { createRequire as createRequire9 } from "node:module";
+import { createRequire as createRequire10 } from "node:module";
 async function computeChecksum2(filePath) {
   const content = readFileSync37(filePath);
   return createHash8("sha256").update(content).digest("hex");
@@ -63350,7 +63437,7 @@ var _require9, DatabaseSync4;
 var init_checksum = __esm({
   "packages/core/src/migration/checksum.ts"() {
     "use strict";
-    _require9 = createRequire9(import.meta.url);
+    _require9 = createRequire10(import.meta.url);
     ({ DatabaseSync: DatabaseSync4 } = _require9("node:sqlite"));
   }
 });
@@ -74367,7 +74454,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 +75024,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 +77819,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,
@@ -79528,7 +79615,7 @@ __export(parser_exports, {
   parseFile: () => parseFile2
 });
 import { readFileSync as readFileSync67 } from "node:fs";
-import { createRequire as createRequire10 } from "node:module";
+import { createRequire as createRequire11 } from "node:module";
 import { relative as relative11 } from "node:path";
 function tryRequire2(id) {
   try {
@@ -79729,7 +79816,7 @@ var init_parser4 = __esm({
   "packages/core/src/code/parser.ts"() {
     "use strict";
     init_tree_sitter_languages2();
-    _require10 = createRequire10(import.meta.url);
+    _require10 = createRequire11(import.meta.url);
     _ParserClass2 = null;
     _QueryClass2 = null;
     _parserInstance2 = null;
@@ -79835,7 +79922,7 @@ __export(dependencies_exports, {
   getDependencySpecs: () => getDependencySpecs
 });
 import { execFileSync as execFileSync10 } from "node:child_process";
-import { createRequire as createRequire11 } from "node:module";
+import { createRequire as createRequire12 } from "node:module";
 import { dirname as dirname19 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function tryExec(cmd, args, timeoutMs = 3e3) {
@@ -80108,7 +80195,7 @@ var init_dependencies = __esm({
   "packages/core/src/system/dependencies.ts"() {
     "use strict";
     init_platform();
-    _require11 = createRequire11(import.meta.url);
+    _require11 = createRequire12(import.meta.url);
     _dirname = dirname19(fileURLToPath5(import.meta.url));
     DEPENDENCY_SPECS = [
       // ── Required ────────────────────────────────────────────────────────────
@@ -80180,7 +80267,7 @@ var init_dependencies = __esm({
 // packages/core/src/system/health.ts
 import { execFileSync as execFileSync11 } from "node:child_process";
 import { existsSync as existsSync92, readFileSync as readFileSync68, statSync as statSync19 } from "node:fs";
-import { createRequire as createRequire12 } from "node:module";
+import { createRequire as createRequire13 } from "node:module";
 import { join as join94 } from "node:path";
 function resolveStructuredLogPath(cleoDir) {
   const defaultPath = join94(cleoDir, "logs", "cleo.log");
@@ -80721,6 +80808,7 @@ async function coreDoctorReport(projectRoot) {
   });
   checks.push(mapCheckResult(checkGlobalHome()));
   checks.push(mapCheckResult(checkGlobalTemplates()));
+  checks.push(mapCheckResult(checkGlobalIdentity()));
   checks.push(mapSchemaCheckResult(checkGlobalSchemas()));
   checks.push(mapCheckResult(checkLogDir(projectRoot)));
   const hookResults = await checkGitHooks(projectRoot);
@@ -81152,7 +81240,7 @@ var init_health = __esm({
     init_checks3();
     init_dependencies();
     init_storage_preflight();
-    _require12 = createRequire12(import.meta.url);
+    _require12 = createRequire13(import.meta.url);
     databaseSyncCtor = (() => {
       try {
         return _require12("node:sqlite").DatabaseSync;
@@ -85793,16 +85881,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"
   );
@@ -86526,8 +86610,8 @@ import { platform as platform4 } from "node:os";
 import { basename as basename17, dirname as dirname23, join as join108 } from "node:path";
 async function resolveSeedAgentsDir() {
   try {
-    const { createRequire: createRequire19 } = await import("node:module");
-    const req = createRequire19(import.meta.url);
+    const { createRequire: createRequire20 } = await import("node:module");
+    const req = createRequire20(import.meta.url);
     const agentsPkgMain = req.resolve("@cleocode/agents/package.json");
     const agentsPkgRoot = dirname23(agentsPkgMain);
     const candidate = join108(agentsPkgRoot, "seed-agents");
@@ -86554,8 +86638,8 @@ async function resolveSeedAgentsDir() {
 async function initAgentDefinition(created, warnings) {
   let agentSourceDir = null;
   try {
-    const { createRequire: createRequire19 } = await import("node:module");
-    const req = createRequire19(import.meta.url);
+    const { createRequire: createRequire20 } = await import("node:module");
+    const req = createRequire20(import.meta.url);
     const agentsPkgMain = req.resolve("@cleocode/agents/package.json");
     const agentsPkgRoot = dirname23(agentsPkgMain);
     const candidate = join108(agentsPkgRoot, "cleo-subagent");
@@ -86621,8 +86705,8 @@ async function initCoreSkills(created, warnings) {
     const packageRoot = getPackageRoot();
     let ctSkillsRoot = null;
     try {
-      const { createRequire: createRequire19 } = await import("node:module");
-      const req = createRequire19(import.meta.url);
+      const { createRequire: createRequire20 } = await import("node:module");
+      const req = createRequire20(import.meta.url);
       const skillsPkgMain = req.resolve("@cleocode/skills/package.json");
       const skillsPkgRoot = dirname23(skillsPkgMain);
       if (existsSync108(join108(skillsPkgRoot, "skills.json"))) {
@@ -87130,8 +87214,8 @@ async function deployStarterBundle(cleoDir, created, warnings) {
   if (hasCantFiles) return;
   let starterBundleSrc = null;
   try {
-    const { createRequire: createRequire19 } = await import("node:module");
-    const req = createRequire19(import.meta.url);
+    const { createRequire: createRequire20 } = await import("node:module");
+    const req = createRequire20(import.meta.url);
     const cleoOsPkgMain = req.resolve("@cleocode/cleo-os/package.json");
     const cleoOsPkgRoot = dirname23(cleoOsPkgMain);
     const candidate = join108(cleoOsPkgRoot, "starter-bundle");
@@ -87171,20 +87255,20 @@ async function deployStarterBundle(cleoDir, created, warnings) {
       }
     }
   }
-  const identitySrc = join108(starterBundleSrc, "CLEOOS-IDENTITY.md");
-  const identityDst = join108(cleoDir, "CLEOOS-IDENTITY.md");
-  if (existsSync108(identitySrc) && !existsSync108(identityDst)) {
-    await copyFile4(identitySrc, identityDst);
-  }
   try {
-    const { getCleoHome: getCleoHome2 } = await Promise.resolve().then(() => (init_paths(), paths_exports));
-    const globalIdentityDst = join108(getCleoHome2(), "CLEOOS-IDENTITY.md");
-    if (existsSync108(identitySrc) && !existsSync108(globalIdentityDst)) {
-      await copyFile4(identitySrc, globalIdentityDst);
+    const { ensureGlobalIdentity: ensureGlobalIdentity2 } = await Promise.resolve().then(() => (init_scaffold(), scaffold_exports));
+    const identityResult = await ensureGlobalIdentity2();
+    if (identityResult.action === "created") {
+      created.push(`identity: ${identityResult.path}`);
+    } else if (identityResult.action === "skipped" && identityResult.details) {
+      warnings.push(`identity skipped: ${identityResult.details}`);
     }
-  } catch {
+  } catch (err) {
+    warnings.push(`identity deploy failed: ${err instanceof Error ? err.message : String(err)}`);
   }
-  created.push("starter-bundle: team + agent .cant files + identity deployed to .cleo/");
+  created.push(
+    "starter-bundle: team + agent .cant files deployed to .cleo/ (identity at global XDG)"
+  );
 }
 var DIR_SYMLINK_TYPE2;
 var init_init = __esm({
@@ -87208,7 +87292,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 +87326,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 +90996,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 {
@@ -91162,7 +91400,7 @@ var init_brain_purge = __esm({
 
 // packages/core/src/memory/claude-mem-migration.ts
 import { existsSync as existsSync111 } from "node:fs";
-import { createRequire as createRequire13 } from "node:module";
+import { createRequire as createRequire14 } from "node:module";
 function typedAll3(db, sql16) {
   return db.prepare(sql16).all();
 }
@@ -91321,7 +91559,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}`;
@@ -91392,7 +91630,7 @@ var init_claude_mem_migration = __esm({
     init_paths();
     init_brain_sqlite();
     init_brain_search();
-    _require13 = createRequire13(import.meta.url);
+    _require13 = createRequire14(import.meta.url);
     ({ DatabaseSync: DatabaseSync5 } = _require13("node:sqlite"));
     VALID_OBSERVATION_TYPES = /* @__PURE__ */ new Set([
       "discovery",
@@ -97146,7 +97384,7 @@ var init_t310_readiness = __esm({
 // packages/core/src/store/backup-pack.ts
 import crypto5 from "node:crypto";
 import fs4 from "node:fs";
-import { createRequire as createRequire14 } from "node:module";
+import { createRequire as createRequire15 } from "node:module";
 import os2 from "node:os";
 import path4 from "node:path";
 function resolveContractsSchemasDir() {
@@ -97586,7 +97824,7 @@ var init_backup_pack = __esm({
     init_nexus_sqlite();
     init_signaldock_sqlite();
     init_t310_readiness();
-    _require14 = createRequire14(import.meta.url);
+    _require14 = createRequire15(import.meta.url);
     ({ DatabaseSync: DatabaseSync6 } = _require14("node:sqlite"));
   }
 });
@@ -97655,7 +97893,7 @@ var init_cleanup_legacy = __esm({
 
 // packages/core/src/store/migrate-signaldock-to-conduit.ts
 import { existsSync as existsSync117, mkdirSync as mkdirSync27, renameSync as renameSync9, unlinkSync as unlinkSync9 } from "node:fs";
-import { createRequire as createRequire15 } from "node:module";
+import { createRequire as createRequire16 } from "node:module";
 import { join as join115 } from "node:path";
 function needsSignaldockToConduitMigration(projectRoot) {
   const legacyPath = join115(projectRoot, ".cleo", "signaldock.db");
@@ -97995,7 +98233,7 @@ var init_migrate_signaldock_to_conduit = __esm({
     init_conduit_sqlite();
     init_global_salt();
     init_signaldock_sqlite();
-    _require15 = createRequire15(import.meta.url);
+    _require15 = createRequire16(import.meta.url);
     ({ DatabaseSync: DatabaseSync7 } = _require15("node:sqlite"));
     PROJECT_TIER_TABLES = [
       "messages",
@@ -98701,7 +98939,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 +99293,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);
@@ -101118,6 +101356,16 @@ async function runUpgrade(options = {}) {
       }
     } catch {
     }
+    try {
+      const { ensureGlobalIdentity: ensureGlobalIdentity2 } = await Promise.resolve().then(() => (init_scaffold(), scaffold_exports));
+      const identityResult = await ensureGlobalIdentity2();
+      actions.push({
+        action: "global_identity",
+        status: identityResult.action === "created" || identityResult.action === "repaired" ? "applied" : "skipped",
+        details: `${identityResult.path} (${identityResult.details ?? identityResult.action})`
+      });
+    } catch {
+    }
     try {
       const skillsCreated = [];
       const skillsWarnings = [];
@@ -110919,7 +111167,7 @@ var require__ = __commonJS({
 // packages/core/src/store/backup-unpack.ts
 import crypto6 from "node:crypto";
 import fs6 from "node:fs";
-import { createRequire as createRequire16 } from "node:module";
+import { createRequire as createRequire17 } from "node:module";
 import os3 from "node:os";
 import path6 from "node:path";
 import { default as addFormatsImport2 } from "ajv-formats";
@@ -111188,7 +111436,7 @@ var init_backup_unpack = __esm({
     import__ = __toESM(require__(), 1);
     init_index_min();
     init_backup_crypto();
-    _require16 = createRequire16(import.meta.url);
+    _require16 = createRequire17(import.meta.url);
     ({ DatabaseSync: DatabaseSync8 } = _require16("node:sqlite"));
     ajv2020Mod = import__.default;
     Ajv2020 = typeof ajv2020Mod.default === "function" ? ajv2020Mod.default : import__.default;
@@ -112512,7 +112760,7 @@ var init_api_key_kdf = __esm({
 // packages/core/src/store/agent-registry-accessor.ts
 import { randomBytes as randomBytes17 } from "node:crypto";
 import { existsSync as existsSync127, mkdirSync as mkdirSync32, readFileSync as readFileSync96, statSync as statSync21, writeFileSync as writeFileSync23 } from "node:fs";
-import { createRequire as createRequire17 } from "node:module";
+import { createRequire as createRequire18 } from "node:module";
 import { join as join123 } from "node:path";
 function readMachineKey() {
   const keyPath = join123(getCleoHome(), "machine-key");
@@ -112807,7 +113055,7 @@ var init_agent_registry_accessor = __esm({
     init_conduit_sqlite();
     init_global_salt();
     init_signaldock_sqlite();
-    _require17 = createRequire17(import.meta.url);
+    _require17 = createRequire18(import.meta.url);
     ({ DatabaseSync: DatabaseSync9 } = _require17("node:sqlite"));
     MACHINE_KEY_LENGTH = 32;
     AgentRegistryAccessor = class {
@@ -113440,6 +113688,8 @@ __export(internal_exports, {
   ensureSqliteDb: () => ensureSqliteDb,
   estimateContext: () => estimateContext,
   executeTransfer: () => executeTransfer,
+  exportBrainAsGexf: () => exportBrainAsGexf,
+  exportBrainAsJson: () => exportBrainAsJson,
   exportSnapshot: () => exportSnapshot,
   exportTasks: () => exportTasks,
   exportTasksPackage: () => exportTasksPackage,
@@ -113509,7 +113759,7 @@ __export(internal_exports, {
   getConfigValue: () => getConfigValue,
   getContextDrift: () => getContextDrift,
   getCriticalPath: () => getCriticalPath,
-  getCurrentSessionId: () => getCurrentSessionId,
+  getCurrentSessionId: () => getCurrentSessionId2,
   getDashboard: () => getDashboard,
   getDb: () => getDb,
   getDecisionLog: () => getDecisionLog,
@@ -114017,6 +114267,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();
@@ -131522,7 +131773,7 @@ __export(cli_exports, {
 });
 import { randomUUID as randomUUID14 } from "node:crypto";
 import { existsSync as existsSync130 } from "node:fs";
-import { createRequire as createRequire18 } from "node:module";
+import { createRequire as createRequire19 } from "node:module";
 import { dirname as dirname27, join as join127 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 import { catalog as catalog4, registerSkillLibraryFromPath } from "@cleocode/caamp";
@@ -131531,7 +131782,7 @@ function ensureCaampLibrary() {
   try {
     let skillsRoot = null;
     try {
-      const req = createRequire18(import.meta.url);
+      const req = createRequire19(import.meta.url);
       const skillsPkgJson = req.resolve("@cleocode/skills/package.json");
       const candidate = dirname27(skillsPkgJson);
       if (existsSync130(join127(candidate, "skills.json"))) {
@@ -136332,6 +136583,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 +139935,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 +141338,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) => {