@cleocode/cleo 2026.4.142 → 2026.4.143

package/dist/cli/index.js

@@ -8556,10 +8556,11 @@ async function typedDispatch(handler, op, rawParams) {
 function defineTypedHandler(domain, operations) {
   return { domain, operations };
 }
-function lafsSuccess(data, _operation) {
+function lafsSuccess(data, _operation, extra) {
   return {
     success: true,
-    data
+    data,
+    ...extra?.page ? { page: extra.page } : {}
   };
 }
 function lafsError(code, message, _operation, fix) {
@@ -10127,6 +10128,7 @@ import {
   resolveAgent,
   resolveEffectiveTier,
   resolveProjectRoot,
+  selectHarnessSpawnProvider,
   startParallelExecution,
   validateSpawnReadiness
 } from "@cleocode/core/internal";
@@ -17019,7 +17021,7 @@ var init_check = __esm({
       },
       "compliance.summary": async (params) => {
         const projectRoot = getProjectRoot3();
-        if (params.detail) {
+        if (params?.detail) {
           const result2 = validateComplianceViolations(params.limit, projectRoot);
           if (!result2.success) {
             return lafsError(
@@ -17050,7 +17052,7 @@ var init_check = __esm({
       },
       test: async (params) => {
         const projectRoot = getProjectRoot3();
-        if (params.format === "coverage") {
+        if (params?.format === "coverage") {
           const result2 = validateTestCoverage(projectRoot);
           if (!result2.success) {
             return lafsError(
@@ -17496,10 +17498,10 @@ var init_check = __esm({
       "archive.stats": async (params) => {
         const projectRoot = getProjectRoot3();
         const result = await systemArchiveStats(projectRoot, {
-          period: params.period,
-          report: params.report,
-          since: params.since,
-          until: params.until
+          period: params?.period,
+          report: params?.report,
+          since: params?.since,
+          until: params?.until
         });
         if (!result.success) {
           return lafsError(
@@ -17650,7 +17652,7 @@ var init_check = __esm({
       async query(operation, params) {
         const startTime = Date.now();
         try {
-          const envelope = await typedDispatch(_checkTypedHandler, operation, params);
+          const envelope = await typedDispatch(_checkTypedHandler, operation, params ?? {});
           return {
             meta: dispatchMeta("query", "check", operation, startTime),
             success: envelope.success,
@@ -17668,7 +17670,7 @@ var init_check = __esm({
       async mutate(operation, params) {
         const startTime = Date.now();
         try {
-          const envelope = await typedDispatch(_checkTypedHandler, operation, params);
+          const envelope = await typedDispatch(_checkTypedHandler, operation, params ?? {});
           return {
             meta: dispatchMeta("mutate", "check", operation, startTime),
             success: envelope.success,
@@ -20878,8 +20880,10 @@ import {
   exportSnapshot as exportSnapshot2,
   exportUserProfile,
   formatAugmentResults,
+  getBrainNativeDb as getBrainNativeDb2,
   getDefaultSnapshotPath as getDefaultSnapshotPath2,
   getNexusDb,
+  getNexusNativeDb,
   getSharingStatus,
   getUserProfileTrait,
   importSnapshot as importSnapshot2,
@@ -20992,6 +20996,227 @@ async function nexusCriticalPath() {
     return engineError("E_INTERNAL", error instanceof Error ? error.message : String(error));
   }
 }
+async function nexusImpact(symbol, projectId, why) {
+  try {
+    await getNexusDb();
+    const db = getNexusNativeDb();
+    if (!db) {
+      return engineSuccess({
+        targetNodeId: null,
+        why: why ?? false,
+        affected: [],
+        riskLevel: "NONE"
+      });
+    }
+    const allNodes = db.prepare(
+      `SELECT id, label, kind, file_path, name, project_id
+           FROM nexus_nodes
+          WHERE project_id = ?
+            AND kind NOT IN ('community','process','file','folder')`
+    ).all(projectId || "");
+    const lowerSymbol = symbol.toLowerCase();
+    const candidates = allNodes.filter((n) => {
+      const haystack = (n.name ?? n.label ?? "").toLowerCase();
+      return haystack.length > 0 && haystack.includes(lowerSymbol);
+    });
+    candidates.sort((a, b) => {
+      const an = (a.name ?? a.label ?? "").toLowerCase();
+      const bn = (b.name ?? b.label ?? "").toLowerCase();
+      const exactA = an === lowerSymbol ? 0 : 1;
+      const exactB = bn === lowerSymbol ? 0 : 1;
+      if (exactA !== exactB) return exactA - exactB;
+      return an.length - bn.length;
+    });
+    const target = candidates[0];
+    if (!target) {
+      return engineSuccess({
+        targetNodeId: null,
+        why: why ?? false,
+        affected: [],
+        riskLevel: "NONE"
+      });
+    }
+    const allRelations = db.prepare(
+      `SELECT source_id, target_id, type, weight
+           FROM nexus_relations
+          WHERE project_id = ?
+            AND type IN ('calls','imports','accesses')`
+    ).all(projectId || "");
+    const reverseAdj = /* @__PURE__ */ new Map();
+    for (const rel of allRelations) {
+      const list = reverseAdj.get(rel.target_id);
+      if (list) {
+        list.push(rel);
+      } else {
+        reverseAdj.set(rel.target_id, [rel]);
+      }
+    }
+    const incomingCount = /* @__PURE__ */ new Map();
+    for (const rel of allRelations) {
+      incomingCount.set(rel.target_id, (incomingCount.get(rel.target_id) ?? 0) + 1);
+    }
+    const nodeById = /* @__PURE__ */ new Map();
+    for (const n of allNodes) {
+      nodeById.set(n.id, n);
+    }
+    const visited = /* @__PURE__ */ new Set([target.id]);
+    const queue = [{ id: target.id, depth: 0 }];
+    const affected = [];
+    while (queue.length > 0) {
+      const item = queue.shift();
+      if (!item) break;
+      if (item.depth >= 3) continue;
+      const callers = reverseAdj.get(item.id) ?? [];
+      for (const edge of callers) {
+        if (visited.has(edge.source_id)) continue;
+        visited.add(edge.source_id);
+        const depth = item.depth + 1;
+        const callerNode = nodeById.get(edge.source_id);
+        const reasons = [];
+        if (why) {
+          const calls = incomingCount.get(edge.source_id) ?? 0;
+          if (calls > 0) {
+            reasons.push(`called by ${calls} place${calls === 1 ? "" : "s"}`);
+          }
+          if (edge.weight != null && edge.weight > 0) {
+            reasons.push(`strength=${edge.weight.toFixed(3)} via ${edge.type}`);
+          } else {
+            reasons.push(`edge type ${edge.type} (weight=0 \u2014 no plasticity yet)`);
+          }
+          reasons.push(`depth=${depth} hop from target ${target.label ?? target.id}`);
+        }
+        affected.push({
+          nodeId: edge.source_id,
+          label: callerNode?.label ?? edge.source_id,
+          kind: callerNode?.kind ?? "unknown",
+          reasons
+        });
+        queue.push({ id: edge.source_id, depth });
+      }
+    }
+    let riskLevel = "NONE";
+    if (affected.length > 0) {
+      if (affected.length > 10) {
+        riskLevel = "CRITICAL";
+      } else if (affected.length > 5) {
+        riskLevel = "HIGH";
+      } else if (affected.length > 2) {
+        riskLevel = "MEDIUM";
+      } else {
+        riskLevel = "LOW";
+      }
+    }
+    return engineSuccess({
+      targetNodeId: target.id,
+      why: why ?? false,
+      affected,
+      riskLevel
+    });
+  } catch (error) {
+    return engineError("E_INTERNAL", error instanceof Error ? error.message : String(error));
+  }
+}
+async function nexusTopEntries(params) {
+  try {
+    const limit = typeof params?.limit === "number" && Number.isFinite(params.limit) && params.limit > 0 ? Math.floor(params.limit) : 20;
+    const brainDb = getBrainNativeDb2();
+    if (brainDb !== null && brainDb !== void 0) {
+      try {
+        const nodeType = params?.nodeType ? String(params.nodeType) : null;
+        const sql = nodeType === null ? `SELECT id, node_type, label, quality_score, last_activity_at, metadata_json
+                 FROM brain_page_nodes
+                ORDER BY quality_score DESC
+                LIMIT ?` : `SELECT id, node_type, label, quality_score, last_activity_at, metadata_json
+                 FROM brain_page_nodes
+                WHERE node_type = ?
+                ORDER BY quality_score DESC
+                LIMIT ?`;
+        const bindArgs = nodeType === null ? [limit] : [nodeType, limit];
+        const rows = brainDb.prepare(sql).all(...bindArgs);
+        const entries = rows.map((r) => ({
+          id: r.id,
+          node_type: r.node_type ?? "unknown",
+          label: r.label ?? r.id,
+          quality_score: r.quality_score ?? 0,
+          last_activity_at: r.last_activity_at ?? "",
+          metadata_json: r.metadata_json ?? null
+        }));
+        return engineSuccess({
+          entries,
+          count: entries.length,
+          limit,
+          nodeType
+        });
+      } catch {
+      }
+    }
+    const nexusDb = getNexusNativeDb();
+    if (!nexusDb) {
+      return engineSuccess({
+        entries: [],
+        count: 0,
+        limit,
+        kind: params?.kind ? String(params.kind) : null,
+        note: 'Neither brain.db nor nexus.db is available. Run "cleo nexus init" to initialize.'
+      });
+    }
+    try {
+      const kind = params?.kind ? String(params.kind) : null;
+      const sql = kind === null ? `SELECT r.source_id,
+                    SUM(COALESCE(r.weight, 0)) AS totalWeight,
+                    COUNT(*)                   AS edgeCount,
+                    n.label,
+                    n.kind,
+                    n.file_path
+               FROM nexus_relations r
+               LEFT JOIN nexus_nodes n ON n.id = r.source_id
+              GROUP BY r.source_id
+              ORDER BY totalWeight DESC, edgeCount DESC
+              LIMIT ?` : `SELECT r.source_id,
+                    SUM(COALESCE(r.weight, 0)) AS totalWeight,
+                    COUNT(*)                   AS edgeCount,
+                    n.label,
+                    n.kind,
+                    n.file_path
+               FROM nexus_relations r
+               LEFT JOIN nexus_nodes n ON n.id = r.source_id
+              WHERE n.kind = ?
+              GROUP BY r.source_id
+              ORDER BY totalWeight DESC, edgeCount DESC
+              LIMIT ?`;
+      const bindArgs = kind === null ? [limit] : [kind, limit];
+      const rows = nexusDb.prepare(sql).all(...bindArgs);
+      const entries = rows.map((r) => ({
+        nodeId: r.source_id,
+        label: r.label ?? r.source_id,
+        kind: r.kind ?? "unknown",
+        filePath: r.file_path ?? null,
+        totalWeight: r.totalWeight,
+        edgeCount: r.edgeCount
+      }));
+      const result = {
+        entries,
+        count: entries.length,
+        limit,
+        kind
+      };
+      if (entries.length === 0) {
+        result.note = "No high-impact sources detected yet. Code plasticity will accumulate as the system indexes and analyzes dependencies.";
+      }
+      return engineSuccess(result);
+    } catch {
+      return engineSuccess({
+        entries: [],
+        count: 0,
+        limit,
+        kind: params?.kind ? String(params.kind) : null,
+        note: 'Nexus registry not yet initialized. Run "cleo nexus init" to start.'
+      });
+    }
+  } catch (error) {
+    return engineError("E_INTERNAL", error instanceof Error ? error.message : String(error));
+  }
+}
 async function nexusBlockers(query) {
   try {
     const analysis = await blockingAnalysis(query);
@@ -21449,8 +21674,359 @@ var init_nexus_engine = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/nexus.ts
-import { getLogger as getLogger9, getProjectRoot as getProjectRoot7 } from "@cleocode/core/internal";
-var _nexusTypedHandler, QUERY_OPS3, MUTATE_OPS3, NexusHandler;
+import {
+  getBrainNativeDb as getBrainNativeDb3,
+  getLogger as getLogger9,
+  getNexusNativeDb as getNexusNativeDb2,
+  getProjectRoot as getProjectRoot7
+} from "@cleocode/core/internal";
+async function handleTopEntries(operation, params, startTime) {
+  const rawLimit = params?.limit;
+  const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) && rawLimit > 0 ? Math.floor(rawLimit) : 20;
+  const brainDb = getBrainNativeDb3();
+  if (brainDb !== null && brainDb !== void 0) {
+    return handleTopEntriesFromBrain(
+      operation,
+      params,
+      startTime,
+      brainDb,
+      limit
+    );
+  }
+  try {
+    const nexusDb = getNexusNativeDb2();
+    if (!nexusDb) {
+      const emptyData = {
+        entries: [],
+        count: 0,
+        limit,
+        kind: params?.kind ?? null,
+        note: 'Neither brain.db nor nexus.db is available. Run "cleo nexus init" to initialize.'
+      };
+      return wrapResult({ success: true, data: emptyData }, "query", "nexus", operation, startTime);
+    }
+    return handleTopEntriesFromNexus(
+      operation,
+      params,
+      startTime,
+      nexusDb,
+      limit
+    );
+  } catch (dbErr) {
+    return handleErrorResult("query", "nexus", operation, dbErr, startTime);
+  }
+}
+function handleTopEntriesFromBrain(operation, params, startTime, db, limit) {
+  const rawNodeType = params?.nodeType;
+  const nodeType = typeof rawNodeType === "string" && rawNodeType.length > 0 ? rawNodeType : null;
+  let rows = [];
+  try {
+    const sql = nodeType === null ? `SELECT id, node_type, label, quality_score, last_activity_at, metadata_json
+             FROM brain_page_nodes
+            ORDER BY quality_score DESC
+            LIMIT ?` : `SELECT id, node_type, label, quality_score, last_activity_at, metadata_json
+             FROM brain_page_nodes
+            WHERE node_type = ?
+            ORDER BY quality_score DESC
+            LIMIT ?`;
+    const bindArgs = nodeType === null ? [limit] : [nodeType, limit];
+    const rawRows = db.prepare(sql).all(...bindArgs);
+    rows = rawRows.map((raw) => {
+      const r = raw;
+      return {
+        id: String(r["id"] ?? ""),
+        node_type: r["node_type"] != null ? String(r["node_type"]) : null,
+        label: r["label"] != null ? String(r["label"]) : null,
+        quality_score: r["quality_score"] != null ? Number(r["quality_score"]) : null,
+        last_activity_at: r["last_activity_at"] != null ? String(r["last_activity_at"]) : null,
+        metadata_json: r["metadata_json"] != null ? String(r["metadata_json"]) : null
+      };
+    });
+  } catch {
+    rows = [];
+  }
+  const entries = rows.map((r) => ({
+    id: r.id,
+    node_type: r.node_type ?? "unknown",
+    label: r.label ?? r.id,
+    quality_score: r.quality_score ?? 0,
+    last_activity_at: r.last_activity_at ?? "",
+    metadata_json: r.metadata_json ?? null
+  }));
+  const data = {
+    entries,
+    count: entries.length,
+    limit,
+    nodeType
+  };
+  return wrapResult({ success: true, data }, "query", "nexus", operation, startTime);
+}
+function handleTopEntriesFromNexus(operation, params, startTime, db, limit) {
+  const rawKind = params?.kind;
+  const kind = typeof rawKind === "string" && rawKind.length > 0 ? rawKind : null;
+  let rows = [];
+  try {
+    const sql = kind === null ? `SELECT r.source_id,
+                  SUM(COALESCE(r.weight, 0)) AS totalWeight,
+                  COUNT(*)                   AS edgeCount,
+                  n.label,
+                  n.kind,
+                  n.file_path
+             FROM nexus_relations r
+             LEFT JOIN nexus_nodes n ON n.id = r.source_id
+            GROUP BY r.source_id
+            ORDER BY totalWeight DESC, edgeCount DESC
+            LIMIT ?` : `SELECT r.source_id,
+                  SUM(COALESCE(r.weight, 0)) AS totalWeight,
+                  COUNT(*)                   AS edgeCount,
+                  n.label,
+                  n.kind,
+                  n.file_path
+             FROM nexus_relations r
+             LEFT JOIN nexus_nodes n ON n.id = r.source_id
+            WHERE n.kind = ?
+            GROUP BY r.source_id
+            ORDER BY totalWeight DESC, edgeCount DESC
+            LIMIT ?`;
+    const bindArgs = kind === null ? [limit] : [kind, limit];
+    const rawRows = db.prepare(sql).all(...bindArgs);
+    rows = rawRows.map((raw) => {
+      const r = raw;
+      return {
+        source_id: String(r["source_id"] ?? ""),
+        totalWeight: Number(r["totalWeight"] ?? 0),
+        edgeCount: Number(r["edgeCount"] ?? 0),
+        label: r["label"] != null ? String(r["label"]) : null,
+        kind: r["kind"] != null ? String(r["kind"]) : null,
+        file_path: r["file_path"] != null ? String(r["file_path"]) : null
+      };
+    });
+  } catch {
+    rows = [];
+  }
+  const entries = rows.map((r) => ({
+    nodeId: r.source_id,
+    label: r.label ?? r.source_id,
+    kind: r.kind ?? "unknown",
+    filePath: r.file_path ?? null,
+    totalWeight: r.totalWeight,
+    edgeCount: r.edgeCount
+  }));
+  const allZero = entries.length === 0 || entries.every((e) => e.totalWeight === 0);
+  const note = allZero ? "No Hebbian weights accumulated yet. Run a dream cycle or wait for plasticity updates." : void 0;
+  const data = {
+    entries,
+    count: entries.length,
+    limit,
+    kind,
+    ...note !== void 0 ? { note } : {}
+  };
+  return wrapResult({ success: true, data }, "query", "nexus", operation, startTime);
+}
+function riskLevelFor(totalImpact) {
+  if (totalImpact === 0) return "NONE";
+  if (totalImpact <= 3) return "LOW";
+  if (totalImpact <= 10) return "MEDIUM";
+  if (totalImpact <= 25) return "HIGH";
+  return "CRITICAL";
+}
+async function handleImpact(operation, params, startTime) {
+  const symbolName = params?.symbol;
+  if (!symbolName) {
+    return errorResult(
+      "query",
+      "nexus",
+      operation,
+      "E_INVALID_INPUT",
+      "symbol is required",
+      startTime
+    );
+  }
+  const why = params?.why === true;
+  const rawDepth = params?.depth;
+  const maxDepth = Math.min(
+    typeof rawDepth === "number" && Number.isFinite(rawDepth) && rawDepth > 0 ? rawDepth : 3,
+    5
+  );
+  const projectIdParam = params?.projectId;
+  const projectId = projectIdParam ?? Buffer.from(process.cwd()).toString("base64url").slice(0, 32);
+  try {
+    const { getNexusDb: getNexusDb2 } = await import("@cleocode/core/store/nexus-sqlite");
+    await getNexusDb2();
+    const db = getNexusNativeDb2();
+    if (!db) {
+      return wrapResult(
+        {
+          success: true,
+          data: {
+            query: symbolName,
+            projectId,
+            targetNodeId: null,
+            targetLabel: null,
+            why,
+            riskLevel: "NONE",
+            totalImpact: 0,
+            maxDepth,
+            affected: []
+          }
+        },
+        "query",
+        "nexus",
+        operation,
+        startTime
+      );
+    }
+    let allNodes = [];
+    try {
+      const rawRows = db.prepare(
+        `SELECT id, label, kind, file_path, name, project_id
+             FROM nexus_nodes
+            WHERE project_id = ?
+              AND kind NOT IN ('community','process','file','folder')`
+      ).all(projectId);
+      allNodes = rawRows.map((raw) => {
+        const r = raw;
+        return {
+          id: String(r["id"] ?? ""),
+          label: r["label"] != null ? String(r["label"]) : null,
+          kind: r["kind"] != null ? String(r["kind"]) : null,
+          file_path: r["file_path"] != null ? String(r["file_path"]) : null,
+          name: r["name"] != null ? String(r["name"]) : null,
+          project_id: String(r["project_id"] ?? "")
+        };
+      });
+    } catch {
+      allNodes = [];
+    }
+    const lowerSymbol = symbolName.toLowerCase();
+    const candidates = allNodes.filter((n) => {
+      const haystack = (n.name ?? n.label ?? "").toLowerCase();
+      return haystack.length > 0 && haystack.includes(lowerSymbol);
+    });
+    candidates.sort((a, b) => {
+      const an = (a.name ?? a.label ?? "").toLowerCase();
+      const bn = (b.name ?? b.label ?? "").toLowerCase();
+      const exactA = an === lowerSymbol ? 0 : 1;
+      const exactB = bn === lowerSymbol ? 0 : 1;
+      if (exactA !== exactB) return exactA - exactB;
+      return an.length - bn.length;
+    });
+    const target = candidates[0];
+    if (!target) {
+      return wrapResult(
+        {
+          success: true,
+          data: {
+            query: symbolName,
+            projectId,
+            targetNodeId: null,
+            targetLabel: null,
+            why,
+            riskLevel: "NONE",
+            totalImpact: 0,
+            maxDepth,
+            affected: []
+          }
+        },
+        "query",
+        "nexus",
+        operation,
+        startTime
+      );
+    }
+    let allRelations = [];
+    try {
+      const rawRows = db.prepare(
+        `SELECT source_id, target_id, type, weight
+             FROM nexus_relations
+            WHERE project_id = ?
+              AND type IN ('calls','imports','accesses')`
+      ).all(projectId);
+      allRelations = rawRows.map((raw) => {
+        const r = raw;
+        return {
+          source_id: String(r["source_id"] ?? ""),
+          target_id: String(r["target_id"] ?? ""),
+          type: String(r["type"] ?? ""),
+          weight: r["weight"] != null ? Number(r["weight"]) : null
+        };
+      });
+    } catch {
+      allRelations = [];
+    }
+    const reverseAdj = /* @__PURE__ */ new Map();
+    for (const rel of allRelations) {
+      if (!IMPACT_REVERSE_TYPES.has(rel.type)) continue;
+      const list = reverseAdj.get(rel.target_id);
+      if (list) {
+        list.push(rel);
+      } else {
+        reverseAdj.set(rel.target_id, [rel]);
+      }
+    }
+    const incomingCount = /* @__PURE__ */ new Map();
+    for (const rel of allRelations) {
+      if (!IMPACT_REVERSE_TYPES.has(rel.type)) continue;
+      incomingCount.set(rel.target_id, (incomingCount.get(rel.target_id) ?? 0) + 1);
+    }
+    const nodeById = /* @__PURE__ */ new Map();
+    for (const n of allNodes) nodeById.set(n.id, n);
+    const targetId = target.id;
+    const visited = /* @__PURE__ */ new Set([targetId]);
+    const queue = [{ id: targetId, depth: 0 }];
+    const affected = [];
+    while (queue.length > 0) {
+      const item = queue.shift();
+      if (!item) break;
+      if (item.depth >= maxDepth) continue;
+      const callers = reverseAdj.get(item.id) ?? [];
+      for (const edge of callers) {
+        if (visited.has(edge.source_id)) continue;
+        visited.add(edge.source_id);
+        const depth = item.depth + 1;
+        const callerNode = nodeById.get(edge.source_id);
+        const reasons = [];
+        if (why) {
+          const calls = incomingCount.get(edge.source_id) ?? 0;
+          if (calls > 0) {
+            reasons.push(`called by ${calls} place${calls === 1 ? "" : "s"}`);
+          }
+          if (edge.weight != null && edge.weight > 0) {
+            reasons.push(`strength=${edge.weight.toFixed(3)} via ${edge.type}`);
+          } else {
+            reasons.push(`edge type ${edge.type} (weight=0 \u2014 no plasticity yet)`);
+          }
+          reasons.push(`depth=${depth} hop from target ${target.label ?? target.id}`);
+        }
+        affected.push({
+          nodeId: edge.source_id,
+          label: callerNode?.label ?? edge.source_id,
+          kind: callerNode?.kind ?? "unknown",
+          filePath: callerNode?.file_path ?? null,
+          depth,
+          reasons
+        });
+        queue.push({ id: edge.source_id, depth });
+      }
+    }
+    const totalImpact = affected.length;
+    const data = {
+      query: symbolName,
+      projectId,
+      targetNodeId: target.id,
+      targetLabel: target.label ?? target.name ?? target.id,
+      why,
+      riskLevel: riskLevelFor(totalImpact),
+      totalImpact,
+      maxDepth,
+      affected
+    };
+    return wrapResult({ success: true, data }, "query", "nexus", operation, startTime);
+  } catch (dbErr) {
+    return handleErrorResult("query", "nexus", operation, dbErr, startTime);
+  }
+}
+var _nexusTypedHandler, QUERY_OPS3, MUTATE_OPS3, NexusHandler, IMPACT_REVERSE_TYPES;
 var init_nexus2 = __esm({
   "packages/cleo/src/dispatch/domains/nexus.ts"() {
     "use strict";
@@ -21481,7 +22057,12 @@ var init_nexus2 = __esm({
             "list"
           );
         }
-        return lafsSuccess(result.data, "list");
+        const data = result.data;
+        return lafsSuccess(
+          { projects: data.projects, count: data.count, total: data.total, filtered: data.filtered },
+          "list",
+          { page: data.page ?? result.page }
+        );
       },
       show: async (params) => {
         if (!params.name) {
@@ -21571,7 +22152,12 @@ var init_nexus2 = __esm({
             "orphans.list"
           );
         }
-        return lafsSuccess(result.data, "orphans.list");
+        const data = result.data;
+        return lafsSuccess(
+          { orphans: data.orphans, count: data.count, total: data.total, filtered: data.filtered },
+          "orphans.list",
+          { page: data.page ?? result.page }
+        );
       },
       discover: async (params) => {
         if (!params.query) {
@@ -21655,8 +22241,12 @@ var init_nexus2 = __esm({
         }
         return lafsSuccess(result.data, "transfer.preview");
       },
-      "top-entries": async (_params) => {
-        const result = await nexusGraph();
+      "top-entries": async (params) => {
+        const result = await nexusTopEntries({
+          limit: params?.limit,
+          kind: params?.kind,
+          nodeType: params?.nodeType
+        });
         if (!result.success) {
           return lafsError(
             String(result.error?.code ?? "E_INTERNAL"),
@@ -21670,8 +22260,7 @@ var init_nexus2 = __esm({
         if (!params.symbol) {
           return lafsError("E_INVALID_INPUT", "symbol is required", "impact");
         }
-        const projectRoot = getProjectRoot7();
-        const result = await nexusImpactFull(params.symbol, projectRoot);
+        const result = await nexusImpact(params.symbol, params.projectId, params.why);
         if (!result.success) {
           return lafsError(
             String(result.error?.code ?? "E_INTERNAL"),
@@ -21803,7 +22392,7 @@ var init_nexus2 = __esm({
       wiki: async (params) => {
         const projectRoot = getProjectRoot7();
         const outputDir = params.outputDir ?? `${projectRoot}/.cleo/wiki`;
-        const result = await nexusWiki(projectRoot, outputDir, {
+        const result = await nexusWiki(outputDir, projectRoot, {
           communityFilter: params.communityFilter,
           incremental: params.incremental
         });
@@ -22149,6 +22738,7 @@ var init_nexus2 = __esm({
       }
     });
     QUERY_OPS3 = /* @__PURE__ */ new Set([
+      "share.status",
       "status",
       "list",
       "show",
@@ -22161,7 +22751,6 @@ var init_nexus2 = __esm({
       "discover",
       "search",
       "augment",
-      "share.status",
       "transfer.preview",
       "top-entries",
       "impact",
@@ -22181,14 +22770,14 @@ var init_nexus2 = __esm({
       "sigil.list"
     ]);
     MUTATE_OPS3 = /* @__PURE__ */ new Set([
+      "share.snapshot.export",
+      "share.snapshot.import",
       "init",
       "register",
       "unregister",
       "sync",
       "permission.set",
       "reconcile",
-      "share.snapshot.export",
-      "share.snapshot.import",
       "transfer",
       "contracts-sync",
       "contracts-link-tasks",
@@ -22212,17 +22801,35 @@ var init_nexus2 = __esm({
         if (!QUERY_OPS3.has(operation)) {
           return unsupportedOp("query", "nexus", operation, startTime);
         }
+        if (operation === "top-entries") {
+          return handleTopEntries(operation, params, startTime);
+        }
+        if (operation === "impact") {
+          return handleImpact(operation, params, startTime);
+        }
         try {
           const envelope = await typedDispatch(
             _nexusTypedHandler,
             operation,
             params ?? {}
           );
+          const env = envelope;
+          let pageMetadata = env.page;
+          let resultData = env.data;
+          if (!pageMetadata && env.success && resultData && typeof resultData === "object") {
+            const dataObj = resultData;
+            if ("page" in dataObj && dataObj.page) {
+              pageMetadata = dataObj.page;
+              const { page: _removed, ...cleanData } = dataObj;
+              resultData = cleanData;
+            }
+          }
           return wrapResult(
             {
-              success: envelope.success,
-              data: envelope.data,
-              error: envelope.error
+              success: env.success,
+              data: resultData,
+              page: pageMetadata,
+              error: env.error ? { code: String(env.error.code), message: env.error.message } : void 0
             },
             "query",
             "nexus",
@@ -22254,11 +22861,12 @@ var init_nexus2 = __esm({
             operation,
             params ?? {}
           );
+          const env = envelope;
           return wrapResult(
             {
-              success: envelope.success,
-              data: envelope.data,
-              error: envelope.error
+              success: env.success,
+              data: env.data,
+              error: env.error ? { code: String(env.error.code), message: env.error.message } : void 0
             },
             "mutate",
             "nexus",
@@ -22276,11 +22884,12 @@ var init_nexus2 = __esm({
       /** Declared operations for introspection and validation. */
       getSupportedOperations() {
         return {
-          query: Array.from(QUERY_OPS3).sort(),
-          mutate: Array.from(MUTATE_OPS3).sort()
+          query: Array.from(QUERY_OPS3),
+          mutate: Array.from(MUTATE_OPS3)
         };
       }
     };
+    IMPACT_REVERSE_TYPES = /* @__PURE__ */ new Set(["calls", "imports", "accesses"]);
   }
 });
 
@@ -31097,7 +31706,7 @@ var init_sticky = __esm({
 import { getLogger as getLogger16, getProjectRoot as getProjectRoot15 } from "@cleocode/core";
 function envelopeToEngineResult5(envelope) {
   if (envelope.success) {
-    return { success: true, data: envelope.data };
+    return { success: true, data: envelope.data, page: envelope.page };
   }
   return {
     success: false,
@@ -31173,7 +31782,15 @@ var init_tasks3 = __esm({
             "list"
           );
         }
-        return lafsSuccess(result.data, "list");
+        const envelope = lafsSuccess(result.data, "list");
+        if (result.page) {
+          return {
+            success: true,
+            data: result.data,
+            page: result.page
+          };
+        }
+        return envelope;
       },
       find: async (params) => {
         const projectRoot = getProjectRoot15();
@@ -46121,7 +46738,7 @@ import { homedir as homedir4 } from "node:os";
 import { join as join17 } from "node:path";
 import {
   getBrainDb as getBrainDb2,
-  getBrainNativeDb as getBrainNativeDb2,
+  getBrainNativeDb as getBrainNativeDb4,
   getProjectRoot as getProjectRoot25,
   runConsolidation,
   triggerManualDream
@@ -47676,7 +48293,7 @@ var tierStatsCommand = defineCommand({
     const isJson = !!args.json;
     try {
       await getBrainDb2(root);
-      const nativeDb = getBrainNativeDb2();
+      const nativeDb = getBrainNativeDb4();
       if (!nativeDb) {
         const msg = "brain.db not available";
         if (isJson) {
@@ -47832,7 +48449,7 @@ var tierPromoteCommand = defineCommand({
     }
     try {
       await getBrainDb2(root);
-      const nativeDb = getBrainNativeDb2();
+      const nativeDb = getBrainNativeDb4();
       if (!nativeDb) {
         const msg = "brain.db not available";
         if (isJson) {
@@ -47978,7 +48595,7 @@ var tierDemoteCommand = defineCommand({
     }
     try {
       await getBrainDb2(root);
-      const nativeDb = getBrainNativeDb2();
+      const nativeDb = getBrainNativeDb4();
       if (!nativeDb) {
         const msg = "brain.db not available";
         if (isJson) {