@datasynx/agentic-ai-cartography 0.3.3 → 0.4.0

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   NODE_TYPES,
   SOPStepSchema,
   defaultConfig
-} from "./chunk-FFNOC6HF.js";
+} from "./chunk-7NRS3WP6.js";
 import {
   scanAllBookmarks,
   scanAllHistory
@@ -79,9 +79,21 @@ CREATE TABLE IF NOT EXISTS nodes (
   confidence REAL DEFAULT 0.5,
   metadata TEXT NOT NULL DEFAULT '{}',
   tags TEXT NOT NULL DEFAULT '[]',
+  domain TEXT,
+  sub_domain TEXT,
+  quality_score REAL,
   PRIMARY KEY (id, session_id)
 );
 
+CREATE TABLE IF NOT EXISTS connections (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL REFERENCES sessions(id),
+  source_asset_id TEXT NOT NULL,
+  target_asset_id TEXT NOT NULL,
+  type TEXT,
+  created_at TEXT NOT NULL
+);
+
 CREATE TABLE IF NOT EXISTS edges (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id),
@@ -156,6 +168,7 @@ CREATE INDEX IF NOT EXISTS idx_edges_session ON edges(session_id);
 CREATE INDEX IF NOT EXISTS idx_events_session ON activity_events(session_id);
 CREATE INDEX IF NOT EXISTS idx_events_task ON activity_events(task_id);
 CREATE INDEX IF NOT EXISTS idx_tasks_session ON tasks(session_id);
+CREATE INDEX IF NOT EXISTS idx_connections_session ON connections(session_id);
 `;
 var CartographyDB = class {
   db;
@@ -171,7 +184,24 @@ var CartographyDB = class {
     const version = this.db.pragma("user_version", { simple: true });
     if (version === 0) {
       this.db.exec(SCHEMA);
-      this.db.pragma("user_version = 1");
+      this.db.pragma("user_version = 2");
+    } else if (version === 1) {
+      const cols = this.db.prepare("PRAGMA table_info(nodes)").all().map((c) => c.name);
+      if (!cols.includes("domain")) this.db.exec("ALTER TABLE nodes ADD COLUMN domain TEXT");
+      if (!cols.includes("sub_domain")) this.db.exec("ALTER TABLE nodes ADD COLUMN sub_domain TEXT");
+      if (!cols.includes("quality_score")) this.db.exec("ALTER TABLE nodes ADD COLUMN quality_score REAL");
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS connections (
+          id TEXT PRIMARY KEY,
+          session_id TEXT NOT NULL REFERENCES sessions(id),
+          source_asset_id TEXT NOT NULL,
+          target_asset_id TEXT NOT NULL,
+          type TEXT,
+          created_at TEXT NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS idx_connections_session ON connections(session_id);
+      `);
+      this.db.pragma("user_version = 2");
     }
   }
   close() {
@@ -214,8 +244,9 @@ var CartographyDB = class {
   upsertNode(sessionId, node, depth = 0) {
     this.db.prepare(`
       INSERT OR REPLACE INTO nodes
-        (id, session_id, type, name, discovered_via, discovered_at, depth, confidence, metadata, tags)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        (id, session_id, type, name, discovered_via, discovered_at, depth, confidence, metadata, tags,
+         domain, sub_domain, quality_score)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `).run(
       node.id,
       sessionId,
@@ -226,12 +257,18 @@ var CartographyDB = class {
       depth,
       node.confidence,
       JSON.stringify(node.metadata ?? {}),
-      JSON.stringify(node.tags ?? [])
+      JSON.stringify(node.tags ?? []),
+      node.domain ?? null,
+      node.subDomain ?? null,
+      node.qualityScore ?? null
     );
   }
   getNodes(sessionId) {
     const rows = this.db.prepare("SELECT * FROM nodes WHERE session_id = ?").all(sessionId);
-    return rows.map((r) => ({
+    return rows.map((r) => this.mapNode(r));
+  }
+  mapNode(r) {
+    return {
       id: r["id"],
       sessionId: r["session_id"],
       type: r["type"],
@@ -242,8 +279,11 @@ var CartographyDB = class {
       confidence: r["confidence"],
       metadata: JSON.parse(r["metadata"]),
       tags: JSON.parse(r["tags"]),
-      pathId: r["path_id"]
-    }));
+      pathId: r["path_id"],
+      domain: r["domain"] ?? void 0,
+      subDomain: r["sub_domain"] ?? void 0,
+      qualityScore: r["quality_score"] ?? void 0
+    };
   }
   deleteNode(sessionId, nodeId) {
     this.db.prepare("DELETE FROM nodes WHERE session_id = ? AND id = ?").run(sessionId, nodeId);
@@ -455,6 +495,33 @@ var CartographyDB = class {
       generatedAt: r["generated_at"]
     }));
   }
+  // ── Connections (user-created hex map links) ─────────────────────────────
+  upsertConnection(sessionId, conn) {
+    const existing = this.db.prepare(
+      "SELECT id FROM connections WHERE session_id = ? AND source_asset_id = ? AND target_asset_id = ?"
+    ).get(sessionId, conn.sourceAssetId, conn.targetAssetId);
+    if (existing) return existing.id;
+    const id = crypto.randomUUID();
+    this.db.prepare(`
+      INSERT INTO connections (id, session_id, source_asset_id, target_asset_id, type, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, sessionId, conn.sourceAssetId, conn.targetAssetId, conn.type ?? null, (/* @__PURE__ */ new Date()).toISOString());
+    return id;
+  }
+  getConnections(sessionId) {
+    const rows = this.db.prepare("SELECT * FROM connections WHERE session_id = ?").all(sessionId);
+    return rows.map((r) => ({
+      id: r["id"],
+      sessionId: r["session_id"],
+      sourceAssetId: r["source_asset_id"],
+      targetAssetId: r["target_asset_id"],
+      type: r["type"] ?? void 0,
+      createdAt: r["created_at"]
+    }));
+  }
+  deleteConnection(sessionId, connectionId) {
+    this.db.prepare("DELETE FROM connections WHERE session_id = ? AND id = ?").run(sessionId, connectionId);
+  }
   // ── Approvals ───────────────────────────
   setApproval(pattern, action) {
     this.db.prepare(`
@@ -496,7 +563,10 @@ async function createCartographyTools(db, sessionId, opts = {}) {
       discoveredVia: z.string(),
       confidence: z.number().min(0).max(1),
       metadata: z.record(z.unknown()).optional(),
-      tags: z.array(z.string()).optional()
+      tags: z.array(z.string()).optional(),
+      domain: z.string().optional().describe('Business domain, e.g. "Marketing", "Finance"'),
+      subDomain: z.string().optional().describe('Sub-domain, e.g. "Forecast client orders"'),
+      qualityScore: z.number().min(0).max(100).optional().describe("Data quality score 0\u2013100")
     }, async (args) => {
       const node = {
         id: stripSensitive(args["id"]),
@@ -505,7 +575,10 @@ async function createCartographyTools(db, sessionId, opts = {}) {
         discoveredVia: args["discoveredVia"],
         confidence: args["confidence"],
         metadata: args["metadata"] ?? {},
-        tags: args["tags"] ?? []
+        tags: args["tags"] ?? [],
+        domain: args["domain"],
+        subDomain: args["subDomain"],
+        qualityScore: args["qualityScore"]
       };
       db.upsertNode(sessionId, node);
       return { content: [{ type: "text", text: `\u2713 Node: ${node.id}` }] };
@@ -600,14 +673,14 @@ async function createCartographyTools(db, sessionId, opts = {}) {
     tool("scan_local_databases", "Scan for local database files and running DB servers \u2014 PostgreSQL databases, MySQL, SQLite files from installed apps", {
       deep: z.boolean().default(false).optional().describe("Also search home directory recursively for SQLite/DB files (slower)")
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const { homedir } = await import("os");
       const { existsSync: existsSync3 } = await import("fs");
       const deep = args["deep"] ?? false;
       const HOME = homedir();
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 1e4, shell: "/bin/sh" }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 1e4, shell: "/bin/sh" }).toString().trim();
         } catch {
           return "";
         }
@@ -634,12 +707,12 @@ ${v}`).join("\n\n");
     tool("scan_k8s_resources", "Scan Kubernetes cluster via kubectl \u2014 100% readonly (get, describe)", {
       namespace: z.string().optional().describe("Filter by namespace \u2014 empty = all namespaces")
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const ns = args["namespace"];
       const nsFlag = ns ? `-n ${ns}` : "--all-namespaces";
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 15e3, shell: "/bin/sh" }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 15e3, shell: "/bin/sh" }).toString().trim();
         } catch (e) {
           return `(error: ${e instanceof Error ? e.message.split("\n")[0] : String(e)})`;
         }
@@ -663,7 +736,7 @@ ${run(c)}`).join("\n\n");
       region: z.string().optional().describe("AWS Region \u2014 default: AWS_DEFAULT_REGION or profile"),
       profile: z.string().optional().describe("AWS CLI profile")
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const region = args["region"];
       const profile = args["profile"];
       const env = { ...process.env };
@@ -671,7 +744,7 @@ ${run(c)}`).join("\n\n");
       const pf = profile ? `--profile ${profile}` : "";
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh", env }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh", env }).toString().trim();
         } catch (e) {
           return `(error: ${e instanceof Error ? e.message.split("\n")[0] : String(e)})`;
         }
@@ -693,12 +766,12 @@ ${run(c)}`).join("\n\n");
     tool("scan_gcp_resources", "Scan Google Cloud Platform via gcloud CLI \u2014 100% readonly (list, describe)", {
       project: z.string().optional().describe("GCP Project ID \u2014 default: current gcloud project")
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const project = args["project"];
       const pf = project ? `--project ${project}` : "";
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh" }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh" }).toString().trim();
         } catch (e) {
           return `(error: ${e instanceof Error ? e.message.split("\n")[0] : String(e)})`;
         }
@@ -722,14 +795,14 @@ ${run(c)}`).join("\n\n");
       subscription: z.string().optional().describe("Azure Subscription ID"),
       resourceGroup: z.string().optional().describe("Filter by resource group")
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const sub = args["subscription"];
       const rg = args["resourceGroup"];
       const sf = sub ? `--subscription ${sub}` : "";
       const rf = rg ? `--resource-group ${rg}` : "";
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh" }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 2e4, shell: "/bin/sh" }).toString().trim();
         } catch (e) {
           return `(error: ${e instanceof Error ? e.message.split("\n")[0] : String(e)})`;
         }
@@ -752,11 +825,11 @@ ${run(c)}`).join("\n\n");
     tool("scan_installed_apps", "Scan all installed apps and tools \u2014 IDEs, office, dev tools, business apps, databases", {
       searchHint: z.string().optional().describe('Optional search term to find specific tools (e.g. "hubspot windsurf cursor")')
     }, async (args) => {
-      const { execSync: execSync2 } = await import("child_process");
+      const { execSync: execSync3 } = await import("child_process");
       const hint = args["searchHint"];
       const run = (cmd) => {
         try {
-          return execSync2(cmd, { stdio: "pipe", timeout: 15e3, shell: "/bin/sh" }).toString().trim();
+          return execSync3(cmd, { stdio: "pipe", timeout: 15e3, shell: "/bin/sh" }).toString().trim();
         } catch {
           return "";
         }
@@ -1137,6 +1210,227 @@ Use ask_user when you need context from the user.`;
 // src/exporter.ts
 import { mkdirSync as mkdirSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
+
+// src/hex.ts
+function hexToPixel(q, r, size) {
+  const x = size * (Math.sqrt(3) * q + Math.sqrt(3) / 2 * r);
+  const y = size * (3 / 2 * r);
+  return { x, y };
+}
+var HEX_DIRECTIONS = [
+  { q: 1, r: 0 },
+  { q: 1, r: -1 },
+  { q: 0, r: -1 },
+  { q: -1, r: 0 },
+  { q: -1, r: 1 },
+  { q: 0, r: 1 }
+];
+function hexDistance(a, b) {
+  return (Math.abs(a.q - b.q) + Math.abs(a.q + a.r - b.q - b.r) + Math.abs(a.r - b.r)) / 2;
+}
+function hexRing(center, radius) {
+  if (radius === 0) return [{ ...center }];
+  const results = [];
+  let hex = {
+    q: center.q + HEX_DIRECTIONS[4].q * radius,
+    r: center.r + HEX_DIRECTIONS[4].r * radius
+  };
+  for (let side = 0; side < 6; side++) {
+    for (let step = 0; step < radius; step++) {
+      results.push({ q: hex.q, r: hex.r });
+      hex = {
+        q: hex.q + HEX_DIRECTIONS[side].q,
+        r: hex.r + HEX_DIRECTIONS[side].r
+      };
+    }
+  }
+  return results;
+}
+function hexSpiral(center, count) {
+  const positions = [];
+  let ring = 0;
+  while (positions.length < count) {
+    const ring_positions = hexRing(center, ring);
+    for (const pos of ring_positions) {
+      if (positions.length >= count) break;
+      positions.push(pos);
+    }
+    ring++;
+  }
+  return positions;
+}
+
+// src/cluster.ts
+var DOMAIN_PALETTE = [
+  "#1a2e5a",
+  // 0 deep navy
+  "#1e3a8a",
+  // 1 dark blue
+  "#1d4ed8",
+  // 2 medium blue
+  "#2563eb",
+  // 3 blue
+  "#3b82f6",
+  // 4 light blue
+  "#6366f1",
+  // 5 indigo
+  "#818cf8",
+  // 6 periwinkle
+  "#7c9fc3",
+  // 7 slate blue
+  "#0e7490",
+  // 8 dark teal
+  "#0891b2",
+  // 9 teal
+  "#06b6d4",
+  // 10 cyan
+  "#22d3ee",
+  // 11 light cyan
+  "#0d9488",
+  // 12 dark teal-green
+  "#14b8a6",
+  // 13 teal
+  "#2dd4bf",
+  // 14 light teal
+  "#5eead4"
+  // 15 pale teal
+];
+function domainColor(domain, allDomains) {
+  const idx = allDomains.indexOf(domain);
+  return DOMAIN_PALETTE[idx % DOMAIN_PALETTE.length];
+}
+var HEX_SIZE = 24;
+var CLUSTER_GAP = 3;
+function layoutClusters(domainSizes) {
+  const placements = [];
+  const occupied = /* @__PURE__ */ new Set();
+  const key = (q, r) => `${q},${r}`;
+  for (const { domain, count } of domainSizes) {
+    let origin = { q: 0, r: 0 };
+    if (placements.length > 0) {
+      origin = findFreeOrigin(placements, occupied, count, CLUSTER_GAP);
+    }
+    const positions = hexSpiral(origin, count);
+    for (const p of positions) {
+      occupied.add(key(p.q, p.r));
+    }
+    placements.push({ domain, positions, origin });
+  }
+  return placements;
+}
+function findFreeOrigin(existing, occupied, newCount, gap) {
+  const radius = estimateRadius(newCount);
+  for (let searchRing = 1; searchRing < 200; searchRing++) {
+    const candidates = hexSpiral({ q: 0, r: 0 }, searchRing * (radius * 2 + gap + 2));
+    for (const candidate of candidates) {
+      const testPositions = hexSpiral(candidate, newCount);
+      let fits = true;
+      for (const tp of testPositions) {
+        for (const ep of existing.flatMap((p) => p.positions)) {
+          if (hexDistance(tp, ep) < gap) {
+            fits = false;
+            break;
+          }
+        }
+        if (!fits) break;
+      }
+      if (fits) return candidate;
+    }
+  }
+  return { q: existing.length * 20, r: 0 };
+}
+function estimateRadius(count) {
+  return Math.ceil(Math.sqrt(count));
+}
+function computeCentroid(positions, size) {
+  let sx = 0, sy = 0;
+  for (const { q, r } of positions) {
+    const { x, y } = hexToPixel(q, r, size);
+    sx += x;
+    sy += y;
+  }
+  return { x: sx / positions.length, y: sy / positions.length };
+}
+function groupBySubDomain(assets) {
+  const map = /* @__PURE__ */ new Map();
+  for (const a of assets) {
+    if (!a.subDomain) continue;
+    if (!map.has(a.subDomain)) map.set(a.subDomain, []);
+    map.get(a.subDomain).push(a.id);
+  }
+  return Array.from(map.entries()).map(([subDomain, assetIds]) => ({
+    subDomain,
+    assetIds,
+    centroid: { x: 0, y: 0 }
+    // filled in after position assignment
+  }));
+}
+function buildClusterLayout(nodes) {
+  const size = HEX_SIZE;
+  const byDomain = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    const d = n.domain ?? "Other";
+    if (!byDomain.has(d)) byDomain.set(d, []);
+    byDomain.get(d).push(n);
+  }
+  const domainSizes = Array.from(byDomain.entries()).map(([domain, ns]) => ({ domain, count: ns.length })).sort((a, b) => b.count - a.count);
+  const allDomains = domainSizes.map((d) => d.domain);
+  const placements = layoutClusters(domainSizes);
+  const clusters = [];
+  const subClustersMap = /* @__PURE__ */ new Map();
+  for (const placement of placements) {
+    const { domain, positions } = placement;
+    const domainNodes = byDomain.get(domain) ?? [];
+    const color = domainColor(domain, allDomains);
+    const assets = domainNodes.map((n, i) => ({
+      id: n.id,
+      name: n.name,
+      domain: n.domain ?? "Other",
+      subDomain: n.subDomain,
+      qualityScore: n.qualityScore,
+      metadata: n.metadata ?? {},
+      position: positions[i] ?? { q: 0, r: 0 }
+    }));
+    const centroid = computeCentroid(positions.slice(0, assets.length), size);
+    const clusterId = `cluster:${domain}`;
+    clusters.push({
+      id: clusterId,
+      label: domain,
+      domain,
+      color,
+      assets,
+      centroid
+    });
+    const subs = groupBySubDomain(assets);
+    const assetById = new Map(assets.map((a) => [a.id, a]));
+    for (const sub of subs) {
+      const subPositions = sub.assetIds.map((id) => assetById.get(id)?.position).filter(Boolean);
+      if (subPositions.length > 0) {
+        sub.centroid = computeCentroid(subPositions, size);
+      }
+    }
+    if (subs.length > 0) subClustersMap.set(clusterId, subs);
+  }
+  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+  for (const cluster of clusters) {
+    for (const asset of cluster.assets) {
+      const { x, y } = hexToPixel(asset.position.q, asset.position.r, size);
+      if (x < minX) minX = x;
+      if (y < minY) minY = y;
+      if (x > maxX) maxX = x;
+      if (y > maxY) maxY = y;
+    }
+  }
+  if (!isFinite(minX)) {
+    minX = 0;
+    minY = 0;
+    maxX = 0;
+    maxY = 0;
+  }
+  return { clusters, subClusters: subClustersMap, hexSize: size, bounds: { minX, minY, maxX, maxY } };
+}
+
+// src/exporter.ts
 function nodeLayer(type) {
   if (type === "saas_tool") return "saas";
   if (["web_service", "api_endpoint"].includes(type)) return "web";
@@ -1880,7 +2174,7 @@ function exportSOPMarkdown(sop) {
   }
   return lines.join("\n");
 }
-function exportAll(db, sessionId, outputDir, formats = ["mermaid", "json", "yaml", "html", "sops"]) {
+function exportAll(db, sessionId, outputDir, formats = ["mermaid", "json", "yaml", "html", "hexmap", "sops"]) {
   mkdirSync2(outputDir, { recursive: true });
   mkdirSync2(join2(outputDir, "sops"), { recursive: true });
   mkdirSync2(join2(outputDir, "workflows"), { recursive: true });
@@ -1916,12 +2210,795 @@ function exportAll(db, sessionId, outputDir, formats = ["mermaid", "json", "yaml
 `);
     }
   }
+  if (formats.includes("hexmap")) {
+    const connections = db.getConnections(sessionId);
+    writeFileSync(join2(outputDir, "hexmap.html"), exportHexMap(nodes, connections));
+    process.stderr.write("\u2713 hexmap.html\n");
+  }
+}
+function exportHexMap(nodes, connections) {
+  const layout = buildClusterLayout(nodes);
+  const { clusters, subClusters, hexSize, bounds } = layout;
+  const clustersJson = JSON.stringify(clusters.map((c) => ({
+    id: c.id,
+    label: c.label,
+    domain: c.domain,
+    color: c.color,
+    centroid: c.centroid,
+    assets: c.assets.map((a) => ({
+      id: a.id,
+      name: a.name,
+      domain: a.domain,
+      subDomain: a.subDomain ?? null,
+      qualityScore: a.qualityScore ?? null,
+      metadata: a.metadata,
+      q: a.position.q,
+      r: a.position.r
+    }))
+  })));
+  const subClustersJson = JSON.stringify(
+    Object.fromEntries(
+      Array.from(subClusters.entries()).map(([cid, subs]) => [
+        cid,
+        subs.map((s) => ({ subDomain: s.subDomain, assetIds: s.assetIds, centroid: s.centroid }))
+      ])
+    )
+  );
+  const connectionsJson = JSON.stringify(connections.map((c) => ({
+    id: c.id,
+    sourceAssetId: c.sourceAssetId,
+    targetAssetId: c.targetAssetId,
+    type: c.type ?? "connection"
+  })));
+  const hexSizeVal = hexSize;
+  const isEmpty = nodes.length === 0;
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+<title>Data Cartography Map</title>
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+html,body{width:100%;height:100%;overflow:hidden;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif}
+body{display:flex;flex-direction:column;background:#f8fafc;color:#1e293b}
+#topbar{
+  height:48px;display:flex;align-items:center;gap:16px;padding:0 20px;
+  background:#fff;border-bottom:1px solid #e2e8f0;z-index:10;flex-shrink:0;
+}
+#topbar h1{font-size:15px;font-weight:600;color:#0f172a;letter-spacing:-0.01em}
+#topbar .nav-items{display:flex;gap:4px;margin-left:auto}
+#topbar .nav-item{
+  padding:5px 12px;border-radius:6px;font-size:13px;cursor:pointer;
+  color:#64748b;border:none;background:transparent;
+}
+#topbar .nav-item:hover{background:#f1f5f9;color:#0f172a}
+#topbar .nav-item.active{background:#eff6ff;color:#2563eb;font-weight:500}
+#search-box{
+  display:flex;align-items:center;gap:8px;background:#f1f5f9;
+  border-radius:8px;padding:5px 10px;margin-left:8px;
+}
+#search-box input{
+  border:none;background:transparent;font-size:13px;outline:none;width:160px;color:#0f172a;
+}
+#search-box input::placeholder{color:#94a3b8}
+#search-icon{color:#94a3b8;font-size:14px}
+#main{flex:1;display:flex;overflow:hidden;position:relative}
+#canvas-wrap{flex:1;position:relative;overflow:hidden;cursor:grab}
+#canvas-wrap.dragging{cursor:grabbing}
+#canvas-wrap.connecting{cursor:crosshair}
+canvas{display:block;width:100%;height:100%}
+/* Detail panel */
+#detail-panel{
+  width:280px;background:#fff;border-left:1px solid #e2e8f0;
+  display:flex;flex-direction:column;transform:translateX(100%);
+  transition:transform .2s ease;z-index:5;flex-shrink:0;overflow-y:auto;
+}
+#detail-panel.open{transform:translateX(0)}
+#detail-panel .panel-header{
+  padding:16px;border-bottom:1px solid #e2e8f0;display:flex;align-items:center;gap:10px;
+}
+#detail-panel .panel-header h3{font-size:14px;font-weight:600;flex:1;word-break:break-word}
+#detail-panel .close-btn{
+  width:24px;height:24px;border:none;background:transparent;cursor:pointer;
+  color:#94a3b8;border-radius:4px;display:flex;align-items:center;justify-content:center;font-size:16px;
+}
+#detail-panel .close-btn:hover{background:#f1f5f9;color:#0f172a}
+#detail-panel .panel-body{padding:12px 16px;display:flex;flex-direction:column;gap:12px}
+#detail-panel .meta-row{display:flex;flex-direction:column;gap:3px}
+#detail-panel .meta-label{font-size:11px;font-weight:500;color:#94a3b8;text-transform:uppercase;letter-spacing:.05em}
+#detail-panel .meta-value{font-size:13px;color:#1e293b;word-break:break-all}
+#detail-panel .quality-bar{height:6px;border-radius:3px;background:#e2e8f0;margin-top:4px}
+#detail-panel .quality-fill{height:6px;border-radius:3px;transition:width .3s}
+#detail-panel .badge{
+  display:inline-flex;align-items:center;gap:4px;padding:2px 8px;
+  border-radius:12px;font-size:11px;font-weight:500;
+}
+/* Bottom-left toolbar */
+#toolbar-left{
+  position:absolute;bottom:20px;left:20px;display:flex;gap:8px;z-index:10;
+}
+.tb-btn{
+  width:40px;height:40px;border-radius:10px;border:1px solid #e2e8f0;
+  background:#fff;box-shadow:0 1px 4px rgba(0,0,0,.08);cursor:pointer;
+  display:flex;align-items:center;justify-content:center;font-size:18px;
+  transition:all .15s;position:relative;
+}
+.tb-btn:hover{border-color:#94a3b8;box-shadow:0 2px 8px rgba(0,0,0,.12)}
+.tb-btn.active{background:#eff6ff;border-color:#3b82f6}
+.tb-btn[title]:hover::after{
+  content:attr(title);position:absolute;bottom:calc(100% + 6px);left:50%;
+  transform:translateX(-50%);background:#1e293b;color:#fff;padding:4px 8px;
+  border-radius:5px;font-size:11px;white-space:nowrap;pointer-events:none;
+}
+/* Bottom-right toolbar */
+#toolbar-right{
+  position:absolute;bottom:20px;right:20px;display:flex;flex-direction:column;
+  align-items:flex-end;gap:8px;z-index:10;
+}
+#zoom-controls{display:flex;align-items:center;gap:6px}
+.zoom-btn{
+  width:34px;height:34px;border-radius:8px;border:1px solid #e2e8f0;
+  background:#fff;box-shadow:0 1px 4px rgba(0,0,0,.08);cursor:pointer;
+  font-size:18px;color:#1e293b;display:flex;align-items:center;justify-content:center;
+}
+.zoom-btn:hover{background:#f1f5f9}
+#zoom-pct{
+  font-size:12px;font-weight:500;color:#64748b;min-width:38px;text-align:center;
+}
+#detail-selector{display:flex;flex-direction:column;gap:4px}
+.detail-btn{
+  width:34px;height:34px;border-radius:8px;border:1px solid #e2e8f0;
+  background:#fff;box-shadow:0 1px 4px rgba(0,0,0,.08);cursor:pointer;
+  font-size:12px;font-weight:600;color:#64748b;display:flex;align-items:center;justify-content:center;
+}
+.detail-btn:hover{background:#f1f5f9;color:#0f172a}
+.detail-btn.active{background:#eff6ff;border-color:#3b82f6;color:#2563eb}
+#connect-btn{
+  width:40px;height:40px;border-radius:10px;border:1px solid #e2e8f0;
+  background:#fff;box-shadow:0 1px 4px rgba(0,0,0,.08);cursor:pointer;
+  font-size:18px;display:flex;align-items:center;justify-content:center;
+}
+#connect-btn.active{background:#fef3c7;border-color:#f59e0b}
+/* Tooltip */
+#tooltip{
+  position:fixed;background:#1e293b;color:#fff;border-radius:8px;
+  padding:8px 12px;font-size:12px;pointer-events:none;z-index:100;
+  display:none;max-width:200px;box-shadow:0 4px 12px rgba(0,0,0,.15);
+}
+#tooltip .tt-name{font-weight:600;margin-bottom:2px}
+#tooltip .tt-domain{color:#94a3b8;font-size:11px}
+/* Empty state */
+#empty-state{
+  position:absolute;inset:0;display:flex;flex-direction:column;
+  align-items:center;justify-content:center;gap:12px;color:#94a3b8;
+}
+#empty-state .es-icon{font-size:48px}
+#empty-state p{font-size:14px}
+/* Theme toggle */
+#theme-btn{
+  width:40px;height:40px;border-radius:10px;border:1px solid #e2e8f0;
+  background:#fff;box-shadow:0 1px 4px rgba(0,0,0,.08);cursor:pointer;
+  font-size:18px;display:flex;align-items:center;justify-content:center;
+}
+/* Dark mode overrides */
+body.dark{background:#0f172a;color:#e2e8f0}
+body.dark #topbar{background:#1e293b;border-color:#334155}
+body.dark #topbar h1{color:#f1f5f9}
+body.dark #topbar .nav-item{color:#94a3b8}
+body.dark #topbar .nav-item:hover{background:#334155;color:#f1f5f9}
+body.dark #search-box{background:#334155}
+body.dark #search-box input{color:#f1f5f9}
+body.dark #detail-panel{background:#1e293b;border-color:#334155}
+body.dark #detail-panel .panel-header{border-color:#334155}
+body.dark #detail-panel .meta-value{color:#e2e8f0}
+body.dark .tb-btn,body.dark .zoom-btn,body.dark .detail-btn,body.dark #connect-btn,body.dark #theme-btn{
+  background:#1e293b;border-color:#334155;color:#e2e8f0;
+}
+body.dark .tb-btn:hover,body.dark .zoom-btn:hover,body.dark .detail-btn:hover{background:#334155}
+body.dark #zoom-pct{color:#94a3b8}
+/* Connection mode indicator */
+#connect-hint{
+  position:absolute;top:12px;left:50%;transform:translateX(-50%);
+  background:#fef3c7;border:1px solid #f59e0b;color:#92400e;
+  padding:6px 14px;border-radius:20px;font-size:12px;font-weight:500;
+  display:none;z-index:20;pointer-events:none;
+}
+</style>
+</head>
+<body>
+<!-- Top bar -->
+<div id="topbar">
+  <h1>\u{1F5FA} Data Cartography Map</h1>
+  <div class="nav-items">
+    <button class="nav-item active">Data Product Map</button>
+    <button class="nav-item">Raw Data Map</button>
+    <button class="nav-item">Analysis</button>
+  </div>
+  <div id="search-box">
+    <span id="search-icon">\u2315</span>
+    <input id="search-input" type="text" placeholder="Search assets\u2026" aria-label="Search data assets"/>
+  </div>
+  <button id="theme-btn" title="Toggle dark/light mode" aria-label="Toggle theme">\u{1F319}</button>
+</div>
+
+<!-- Main area -->
+<div id="main">
+  <div id="canvas-wrap" role="application" aria-label="Data cartography hex map" tabindex="0">
+    <canvas id="hexmap" aria-hidden="true"></canvas>
+    ${isEmpty ? '<div id="empty-state"><div class="es-icon">\u{1F5FA}</div><p>No data assets available</p><p style="font-size:12px">Run <code>datasynx-cartography discover</code> to populate the map</p></div>' : ""}
+  </div>
+  <div id="detail-panel" role="complementary" aria-label="Asset details">
+    <div class="panel-header">
+      <h3 id="dp-name">\u2014</h3>
+      <button class="close-btn" id="dp-close" aria-label="Close panel">\u2715</button>
+    </div>
+    <div class="panel-body" id="dp-body"></div>
+  </div>
+</div>
+
+<!-- Bottom-left toolbar -->
+<div id="toolbar-left">
+  <button class="tb-btn active" id="btn-org" title="Organization view" aria-pressed="true" aria-label="Organization view">\u{1F3E2}</button>
+  <button class="tb-btn active" id="btn-labels" title="Show labels" aria-pressed="true" aria-label="Toggle labels">\u{1F3F7}</button>
+  <button class="tb-btn" id="btn-quality" title="Quality layer" aria-pressed="false" aria-label="Toggle quality layer">\u{1F441}</button>
+</div>
+
+<!-- Bottom-right toolbar -->
+<div id="toolbar-right">
+  <div id="zoom-controls">
+    <button class="zoom-btn" id="zoom-out" aria-label="Zoom out">\u2212</button>
+    <span id="zoom-pct">100%</span>
+    <button class="zoom-btn" id="zoom-in" aria-label="Zoom in">+</button>
+  </div>
+  <div id="detail-selector">
+    <button class="detail-btn" id="dl-1" aria-label="Detail level 1">1</button>
+    <button class="detail-btn active" id="dl-2" aria-label="Detail level 2">2</button>
+    <button class="detail-btn" id="dl-3" aria-label="Detail level 3">3</button>
+    <button class="detail-btn" id="dl-4" aria-label="Detail level 4">4</button>
+  </div>
+  <button id="connect-btn" title="Connection tool" aria-label="Toggle connection tool">\u{1F517}</button>
+</div>
+
+<!-- Connection mode hint -->
+<div id="connect-hint">Click two assets to create a connection</div>
+
+<!-- Hover tooltip -->
+<div id="tooltip" role="tooltip">
+  <div class="tt-name" id="tt-name"></div>
+  <div class="tt-domain" id="tt-domain"></div>
+</div>
+
+<script>
+(function() {
+'use strict';
+
+// \u2500\u2500 Data \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const CLUSTERS = ${clustersJson};
+const SUB_CLUSTERS = ${subClustersJson};
+const CONNECTIONS = ${connectionsJson};
+const HEX_SIZE = ${hexSizeVal};
+const IS_EMPTY = ${isEmpty};
+
+// Build flat asset index
+const assetIndex = new Map();
+for (const c of CLUSTERS) {
+  for (const a of c.assets) {
+    assetIndex.set(a.id, { ...a, clusterColor: c.color, clusterId: c.id });
+  }
+}
+
+// \u2500\u2500 Canvas Setup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const canvas = document.getElementById('hexmap');
+const ctx = canvas.getContext('2d');
+const wrap = document.getElementById('canvas-wrap');
+
+let W = 0, H = 0;
+function resize() {
+  const dpr = window.devicePixelRatio || 1;
+  W = wrap.clientWidth; H = wrap.clientHeight;
+  canvas.width = W * dpr; canvas.height = H * dpr;
+  canvas.style.width = W + 'px'; canvas.style.height = H + 'px';
+  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+  draw();
+}
+window.addEventListener('resize', resize);
+
+// \u2500\u2500 Viewport state \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+let vx = 0, vy = 0, scale = 1;
+let detailLevel = 2;
+let showLabels = true;
+let showQuality = false;
+let showOrg = true;
+let isDark = false;
+let connectMode = false;
+let connectFirst = null;
+let hoveredAssetId = null;
+let selectedAssetId = null;
+let searchQuery = '';
+let localConnections = [...CONNECTIONS];
+
+function fitToView() {
+  if (IS_EMPTY || CLUSTERS.length === 0) { vx = 0; vy = 0; scale = 1; return; }
+  let minX=Infinity, minY=Infinity, maxX=-Infinity, maxY=-Infinity;
+  for (const c of CLUSTERS) for (const a of c.assets) {
+    const px = hexToPixelX(a.q, a.r);
+    const py = hexToPixelY(a.q, a.r);
+    if(px<minX)minX=px; if(py<minY)minY=py;
+    if(px>maxX)maxX=px; if(py>maxY)maxY=py;
+  }
+  const pw = maxX-minX+HEX_SIZE*4, ph = maxY-minY+HEX_SIZE*4;
+  scale = Math.min(W/pw, H/ph, 1) * 0.85;
+  vx = W/2 - ((minX+maxX)/2)*scale;
+  vy = H/2 - ((minY+maxY)/2)*scale;
+}
+
+// \u2500\u2500 Hex math (inline for self-contained HTML) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function hexToPixelX(q, r) { return HEX_SIZE * (Math.sqrt(3)*q + Math.sqrt(3)/2*r); }
+function hexToPixelY(q, r) { return HEX_SIZE * (3/2*r); }
+
+function worldToScreen(wx, wy) {
+  return { x: wx*scale+vx, y: wy*scale+vy };
+}
+function screenToWorld(sx, sy) {
+  return { x: (sx-vx)/scale, y: (sy-vy)/scale };
+}
+
+// \u2500\u2500 Drawing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function hexPath(cx, cy, r) {
+  ctx.beginPath();
+  for (let i=0;i<6;i++) {
+    const angle = Math.PI/180*(60*i-30);
+    const x = cx+r*Math.cos(angle), y = cy+r*Math.sin(angle);
+    i===0 ? ctx.moveTo(x,y) : ctx.lineTo(x,y);
+  }
+  ctx.closePath();
+}
+
+function draw() {
+  ctx.clearRect(0, 0, W, H);
+
+  // Background
+  ctx.fillStyle = isDark ? '#0f172a' : '#f8fafc';
+  ctx.fillRect(0, 0, W, H);
+
+  if (IS_EMPTY) return;
+
+  const size = HEX_SIZE * scale;
+  const matchedIds = getSearchMatches();
+  const hasSearch = searchQuery.length > 0;
+
+  // \u2500\u2500 Draw connections (edges) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  ctx.save();
+  ctx.strokeStyle = isDark ? 'rgba(148,163,184,0.4)' : 'rgba(100,116,139,0.3)';
+  ctx.lineWidth = 1.5;
+  ctx.setLineDash([4,4]);
+  for (const conn of localConnections) {
+    const src = assetIndex.get(conn.sourceAssetId);
+    const tgt = assetIndex.get(conn.targetAssetId);
+    if (!src || !tgt) continue;
+    const sp = worldToScreen(hexToPixelX(src.q, src.r), hexToPixelY(src.q, src.r));
+    const tp = worldToScreen(hexToPixelX(tgt.q, tgt.r), hexToPixelY(tgt.q, tgt.r));
+    ctx.beginPath(); ctx.moveTo(sp.x, sp.y); ctx.lineTo(tp.x, tp.y); ctx.stroke();
+  }
+  ctx.setLineDash([]);
+  ctx.restore();
+
+  // \u2500\u2500 Draw hexagons per cluster \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  for (const cluster of CLUSTERS) {
+    const baseColor = cluster.color;
+    const isClusterMatch = !hasSearch || cluster.assets.some(a =>
+      matchedIds.has(a.id)
+    );
+    const clusterDim = hasSearch && !isClusterMatch;
+
+    for (let ai=0; ai<cluster.assets.length; ai++) {
+      const asset = cluster.assets[ai];
+      const wx = hexToPixelX(asset.q, asset.r);
+      const wy = hexToPixelY(asset.q, asset.r);
+      const s = worldToScreen(wx, wy);
+      const cx = s.x, cy = s.y;
+
+      // Frustum cull
+      if (cx+size<0 || cx-size>W || cy+size<0 || cy-size>H) continue;
+
+      // Shade variation: every 3rd hex slightly lighter
+      const shade = ai%3===0 ? 18 : ai%3===1 ? 8 : 0;
+      let fillColor = shadeVariant(baseColor, shade);
+
+      // Quality layer override
+      if (showQuality && asset.qualityScore !== null) {
+        const q = asset.qualityScore;
+        if (q < 40) fillColor = '#ef4444';
+        else if (q < 70) fillColor = '#f97316';
+      }
+
+      // Dim non-matching in search
+      const alpha = clusterDim ? 0.18 : 1;
+
+      // Hover / selected highlight
+      const isHovered = asset.id === hoveredAssetId;
+      const isSelected = asset.id === selectedAssetId;
+      const isConnectFirst = asset.id === connectFirst;
+
+      ctx.save();
+      ctx.globalAlpha = alpha;
+
+      hexPath(cx, cy, size*0.92);
+
+      if (isDark) {
+        // Glow effect in dark mode
+        if (isHovered || isSelected || isConnectFirst) {
+          ctx.shadowColor = fillColor;
+          ctx.shadowBlur = isSelected ? 16 : 8;
+        }
+      }
+
+      ctx.fillStyle = fillColor;
+      ctx.fill();
+
+      if (isSelected || isConnectFirst) {
+        ctx.strokeStyle = isConnectFirst ? '#f59e0b' : '#fff';
+        ctx.lineWidth = 2.5;
+        ctx.stroke();
+      } else if (isHovered) {
+        ctx.strokeStyle = isDark ? 'rgba(255,255,255,0.4)' : 'rgba(0,0,0,0.2)';
+        ctx.lineWidth = 1.5;
+        ctx.stroke();
+      } else {
+        ctx.strokeStyle = isDark ? 'rgba(255,255,255,0.06)' : 'rgba(255,255,255,0.4)';
+        ctx.lineWidth = 1;
+        ctx.stroke();
+      }
+
+      ctx.restore();
+
+      // Quality dot indicator
+      if (showQuality && asset.qualityScore !== null && size > 8) {
+        const q = asset.qualityScore;
+        if (q < 70) {
+          ctx.beginPath();
+          ctx.arc(cx+size*0.4, cy-size*0.4, Math.max(3, size*0.14), 0, Math.PI*2);
+          ctx.fillStyle = q<40 ? '#ef4444' : '#f97316';
+          ctx.fill();
+        }
+      }
+
+      // Asset-level labels (detail 4, or 3 at high zoom)
+      const showAssetLabel = showLabels && !clusterDim && (
+        (detailLevel >= 4) ||
+        (detailLevel === 3 && scale >= 0.8)
+      );
+      if (showAssetLabel && size > 14) {
+        const label = asset.name.length > 12 ? asset.name.substring(0,11)+'\u2026' : asset.name;
+        ctx.save();
+        ctx.font = \`\${Math.max(8, Math.min(11, size*0.38))}px -apple-system,sans-serif\`;
+        ctx.fillStyle = isDark ? 'rgba(255,255,255,0.85)' : 'rgba(255,255,255,0.9)';
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.fillText(label, cx, cy);
+        ctx.restore();
+      }
+    }
+  }
+
+  // \u2500\u2500 Cluster labels (pill badges) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  if (showLabels && detailLevel >= 1) {
+    for (const cluster of CLUSTERS) {
+      if (cluster.assets.length === 0) continue;
+      const hasSearch_ = searchQuery.length > 0;
+      const isMatch = !hasSearch_ || cluster.assets.some(a => getSearchMatches().has(a.id));
+      if (hasSearch_ && !isMatch) continue;
+
+      const s = worldToScreen(cluster.centroid.x, cluster.centroid.y);
+      drawPillLabel(s.x, s.y, cluster.label, cluster.color, 14, isDark);
+    }
+  }
+
+  // \u2500\u2500 Sub-cluster labels (detail 2+) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  if (showLabels && detailLevel >= 2) {
+    for (const [clusterId, subs] of Object.entries(SUB_CLUSTERS)) {
+      for (const sub of subs) {
+        const s = worldToScreen(sub.centroid.x, sub.centroid.y);
+        // Offset slightly below cluster centroid
+        drawPillLabel(s.x, s.y + size*1.8, sub.subDomain, '#64748b', 11, isDark);
+      }
+    }
+  }
+}
+
+function shadeVariant(hex, amount) {
+  if (!hex || hex.length < 7) return hex;
+  const num = parseInt(hex.replace('#',''), 16);
+  const r = Math.min(255, (num>>16) + amount);
+  const g = Math.min(255, ((num>>8)&0xff) + amount);
+  const b = Math.min(255, (num&0xff) + amount);
+  return '#' + r.toString(16).padStart(2,'0') + g.toString(16).padStart(2,'0') + b.toString(16).padStart(2,'0');
+}
+
+function drawPillLabel(x, y, text, color, fontSize, dark) {
+  if (!text) return;
+  ctx.save();
+  ctx.font = \`600 \${fontSize}px -apple-system,sans-serif\`;
+  const tw = ctx.measureText(text).width;
+  const ph = fontSize+8, pw = tw+20;
+  // Pill background
+  ctx.beginPath();
+  ctx.roundRect(x-pw/2, y-ph/2, pw, ph, ph/2);
+  ctx.fillStyle = dark ? 'rgba(30,41,59,0.9)' : 'rgba(255,255,255,0.92)';
+  ctx.shadowColor = 'rgba(0,0,0,0.15)';
+  ctx.shadowBlur = 6;
+  ctx.fill();
+  ctx.shadowBlur = 0;
+  // Text
+  ctx.fillStyle = dark ? '#e2e8f0' : '#0f172a';
+  ctx.textAlign = 'center';
+  ctx.textBaseline = 'middle';
+  ctx.fillText(text, x, y);
+  ctx.restore();
+}
+
+// \u2500\u2500 Hit testing \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function getAssetAtScreen(sx, sy) {
+  const w = screenToWorld(sx, sy);
+  const size = HEX_SIZE;
+  for (const cluster of CLUSTERS) {
+    for (const asset of cluster.assets) {
+      const wx = hexToPixelX(asset.q, asset.r);
+      const wy = hexToPixelY(asset.q, asset.r);
+      const dx = Math.abs(w.x-wx), dy = Math.abs(w.y-wy);
+      const hw = Math.sqrt(3)/2*size;
+      if (dx > hw || dy > size) continue;
+      if (hw*size - size*dx - (hw/2)*dy >= 0) return asset;
+    }
+  }
+  return null;
+}
+
+// \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function getSearchMatches() {
+  if (!searchQuery) return new Set();
+  const q = searchQuery.toLowerCase();
+  const matches = new Set();
+  for (const c of CLUSTERS) {
+    for (const a of c.assets) {
+      if (a.name.toLowerCase().includes(q) ||
+          (a.domain && a.domain.toLowerCase().includes(q)) ||
+          (a.subDomain && a.subDomain.toLowerCase().includes(q))) {
+        matches.add(a.id);
+      }
+    }
+  }
+  return matches;
+}
+
+// \u2500\u2500 Pan & Zoom \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+let dragging = false, lastMX = 0, lastMY = 0;
+
+wrap.addEventListener('mousedown', e => {
+  if (e.button !== 0) return;
+  dragging = true; lastMX = e.clientX; lastMY = e.clientY;
+  wrap.classList.add('dragging');
+});
+window.addEventListener('mouseup', () => { dragging = false; wrap.classList.remove('dragging'); });
+window.addEventListener('mousemove', e => {
+  if (dragging) {
+    vx += e.clientX - lastMX; vy += e.clientY - lastMY;
+    lastMX = e.clientX; lastMY = e.clientY;
+    draw();
+    return;
+  }
+  const rect = wrap.getBoundingClientRect();
+  const sx = e.clientX - rect.left, sy = e.clientY - rect.top;
+  const asset = getAssetAtScreen(sx, sy);
+  const newId = asset ? asset.id : null;
+  if (newId !== hoveredAssetId) { hoveredAssetId = newId; draw(); }
+  if (asset) {
+    const tooltip = document.getElementById('tooltip');
+    document.getElementById('tt-name').textContent = asset.name;
+    document.getElementById('tt-domain').textContent = asset.domain + (asset.subDomain ? ' \u203A '+asset.subDomain : '');
+    tooltip.style.display = 'block';
+    tooltip.style.left = (e.clientX+12)+'px';
+    tooltip.style.top = (e.clientY-8)+'px';
+  } else {
+    document.getElementById('tooltip').style.display = 'none';
+  }
+});
+
+wrap.addEventListener('click', e => {
+  const rect = wrap.getBoundingClientRect();
+  const sx = e.clientX-rect.left, sy = e.clientY-rect.top;
+  const asset = getAssetAtScreen(sx, sy);
+  if (connectMode) {
+    if (!asset) return;
+    if (!connectFirst) {
+      connectFirst = asset.id; draw();
+    } else if (connectFirst !== asset.id) {
+      // Create connection
+      const conn = {id: crypto.randomUUID(), sourceAssetId: connectFirst, targetAssetId: asset.id, type:'connection'};
+      localConnections.push(conn);
+      connectFirst = null;
+      draw();
+    }
+    return;
+  }
+  if (asset) {
+    selectedAssetId = asset.id;
+    showDetailPanel(asset);
+  } else {
+    selectedAssetId = null;
+    document.getElementById('detail-panel').classList.remove('open');
+  }
+  draw();
+});
+
+// Touch pan
+let lastTouches = [];
+wrap.addEventListener('touchstart', e => { lastTouches = [...e.touches]; }, { passive:true });
+wrap.addEventListener('touchmove', e => {
+  if (e.touches.length === 1) {
+    const dx = e.touches[0].clientX - lastTouches[0].clientX;
+    const dy = e.touches[0].clientY - lastTouches[0].clientY;
+    vx += dx; vy += dy; draw();
+  } else if (e.touches.length === 2) {
+    // Pinch zoom
+    const d0 = Math.hypot(lastTouches[0].clientX-lastTouches[1].clientX, lastTouches[0].clientY-lastTouches[1].clientY);
+    const d1 = Math.hypot(e.touches[0].clientX-e.touches[1].clientX, e.touches[0].clientY-e.touches[1].clientY);
+    const mx = (e.touches[0].clientX+e.touches[1].clientX)/2;
+    const my = (e.touches[0].clientY+e.touches[1].clientY)/2;
+    applyZoom(d1/d0, mx, my);
+  }
+  lastTouches = [...e.touches];
+}, { passive:true });
+
+wrap.addEventListener('wheel', e => {
+  e.preventDefault();
+  const rect = wrap.getBoundingClientRect();
+  const factor = e.deltaY < 0 ? 1.12 : 1/1.12;
+  applyZoom(factor, e.clientX-rect.left, e.clientY-rect.top);
+}, { passive:false });
+
+function applyZoom(factor, sx, sy) {
+  const newScale = Math.max(0.05, Math.min(8, scale*factor));
+  const wx = (sx-vx)/scale, wy = (sy-vy)/scale;
+  scale = newScale;
+  vx = sx - wx*scale; vy = sy - wy*scale;
+  document.getElementById('zoom-pct').textContent = Math.round(scale*100)+'%';
+  draw();
+}
+
+document.getElementById('zoom-in').addEventListener('click', () => applyZoom(1.25, W/2, H/2));
+document.getElementById('zoom-out').addEventListener('click', () => applyZoom(1/1.25, W/2, H/2));
+
+// Keyboard navigation
+wrap.addEventListener('keydown', e => {
+  const step = 40;
+  if (e.key === 'ArrowLeft') { vx += step; draw(); }
+  else if (e.key === 'ArrowRight') { vx -= step; draw(); }
+  else if (e.key === 'ArrowUp') { vy += step; draw(); }
+  else if (e.key === 'ArrowDown') { vy -= step; draw(); }
+  else if (e.key === '+' || e.key === '=') applyZoom(1.2, W/2, H/2);
+  else if (e.key === '-') applyZoom(1/1.2, W/2, H/2);
+  else if (e.key === 'Escape') {
+    selectedAssetId = null;
+    document.getElementById('detail-panel').classList.remove('open');
+    if (connectMode) toggleConnectMode();
+    draw();
+  }
+});
+
+// \u2500\u2500 Detail Panel \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function showDetailPanel(asset) {
+  document.getElementById('dp-name').textContent = asset.name;
+  const body = document.getElementById('dp-body');
+  const rows = [
+    ['Domain', asset.domain],
+    ['Sub-domain', asset.subDomain],
+    ['Quality Score', asset.qualityScore !== null ? renderQuality(asset.qualityScore) : null],
+    ...Object.entries(asset.metadata || {}).slice(0,8).map(([k,v]) => [k, String(v)]),
+  ].filter(([,v]) => v !== null && v !== undefined && v !== '');
+
+  body.innerHTML = rows.map(([label, value]) => \`
+    <div class="meta-row">
+      <div class="meta-label">\${escHtml(String(label))}</div>
+      <div class="meta-value">\${value}</div>
+    </div>\`).join('');
+
+  // Connections
+  const related = localConnections.filter(c => c.sourceAssetId===asset.id || c.targetAssetId===asset.id);
+  if (related.length > 0) {
+    body.innerHTML += \`<div class="meta-row"><div class="meta-label">Connections (\${related.length})</div><div>\${
+      related.map(c => {
+        const otherId = c.sourceAssetId===asset.id ? c.targetAssetId : c.sourceAssetId;
+        const other = assetIndex.get(otherId);
+        return \`<div class="meta-value" style="margin-top:4px;font-size:12px">\${other ? escHtml(other.name) : otherId}</div>\`;
+      }).join('')
+    }</div></div>\`;
+  }
+
+  document.getElementById('detail-panel').classList.add('open');
+}
+
+function renderQuality(score) {
+  const color = score>=70 ? '#22c55e' : score>=40 ? '#f97316' : '#ef4444';
+  return \`\${score}/100 <div class="quality-bar"><div class="quality-fill" style="width:\${score}%;background:\${color}"></div></div>\`;
+}
+
+function escHtml(s) {
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}
+
+document.getElementById('dp-close').addEventListener('click', () => {
+  document.getElementById('detail-panel').classList.remove('open');
+  selectedAssetId = null; draw();
+});
+
+// \u2500\u2500 Toolbar \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+[1,2,3,4].forEach(n => {
+  document.getElementById('dl-'+n).addEventListener('click', () => {
+    detailLevel = n;
+    document.querySelectorAll('.detail-btn').forEach(b => b.classList.remove('active'));
+    document.getElementById('dl-'+n).classList.add('active');
+    draw();
+  });
+});
+
+document.getElementById('btn-org').addEventListener('click', () => {
+  showOrg = !showOrg;
+  document.getElementById('btn-org').classList.toggle('active', showOrg);
+  draw();
+});
+document.getElementById('btn-labels').addEventListener('click', () => {
+  showLabels = !showLabels;
+  document.getElementById('btn-labels').classList.toggle('active', showLabels);
+  draw();
+});
+document.getElementById('btn-quality').addEventListener('click', () => {
+  showQuality = !showQuality;
+  document.getElementById('btn-quality').classList.toggle('active', showQuality);
+  draw();
+});
+
+function toggleConnectMode() {
+  connectMode = !connectMode;
+  connectFirst = null;
+  document.getElementById('connect-btn').classList.toggle('active', connectMode);
+  wrap.classList.toggle('connecting', connectMode);
+  document.getElementById('connect-hint').style.display = connectMode ? 'block' : 'none';
+  draw();
+}
+document.getElementById('connect-btn').addEventListener('click', toggleConnectMode);
+
+document.getElementById('theme-btn').addEventListener('click', () => {
+  isDark = !isDark;
+  document.body.classList.toggle('dark', isDark);
+  document.getElementById('theme-btn').textContent = isDark ? '\u2600\uFE0F' : '\u{1F319}';
+  draw();
+});
+
+// \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+document.getElementById('search-input').addEventListener('input', e => {
+  searchQuery = e.target.value.trim();
+  draw();
+});
+
+// \u2500\u2500 Init \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+resize();
+fitToView();
+document.getElementById('zoom-pct').textContent = Math.round(scale*100)+'%';
+draw();
+
+})();
+</script>
+</body>
+</html>`;
 }
 
 // src/cli.ts
-import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync2, existsSync as existsSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
 import { createInterface } from "readline";
+import { execSync as execSync2 } from "child_process";
 var bold = (s) => `\x1B[1m${s}\x1B[0m`;
 var dim = (s) => `\x1B[2m${s}\x1B[0m`;
 var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
@@ -2146,8 +3223,16 @@ function main() {
     exportAll(db, sessionId, config.outputDir);
     const osc8 = (url, label) => `\x1B]8;;${url}\x1B\\${label}\x1B]8;;\x1B\\`;
     const htmlPath = resolve(config.outputDir, "topology.html");
+    const hexmapPath = resolve(config.outputDir, "hexmap.html");
     const topoPath = resolve(config.outputDir, "topology.mermaid");
     w("\n");
+    if (existsSync2(hexmapPath)) {
+      const fileUrl = `file://${hexmapPath}`;
+      w(`  ${green("\u2192")}  ${osc8(fileUrl, bold("Open hexmap.html"))}  ${dim("\u2190 Data Cartography Map")}
+`);
+      w(`     ${dim(fileUrl)}
+`);
+    }
     if (existsSync2(htmlPath)) {
       const fileUrl = `file://${htmlPath}`;
       w(`  ${green("\u2192")}  ${osc8(fileUrl, bold("Open topology.html"))}
@@ -2217,7 +3302,7 @@ function main() {
     }
     db.close();
   });
-  program.command("export [session-id]").description("Generate all output files").option("-o, --output <dir>", "Output directory", "./datasynx-output").option("--format <fmt...>", "Formats: mermaid,json,yaml,html,sops").action((sessionId, opts) => {
+  program.command("export [session-id]").description("Generate all output files").option("-o, --output <dir>", "Output directory", "./datasynx-output").option("--format <fmt...>", "Formats: mermaid,json,yaml,html,hexmap,sops").action((sessionId, opts) => {
     const config = defaultConfig({ outputDir: opts.output });
     const db = new CartographyDB(config.dbPath);
     const session = sessionId ? db.getSession(sessionId) : db.getLatestSession();
@@ -2227,12 +3312,44 @@ function main() {
       process.exitCode = 1;
       return;
     }
-    const formats = opts.format ?? ["mermaid", "json", "yaml", "html", "sops"];
+    const formats = opts.format ?? ["mermaid", "json", "yaml", "html", "hexmap", "sops"];
     exportAll(db, session.id, opts.output, formats);
     process.stderr.write(`\u2713 Exported to: ${opts.output}
 `);
     db.close();
   });
+  program.command("map [session-id]").description("Open the interactive Data Cartography hex map in your browser").option("-o, --output <dir>", "Output directory", "./datasynx-output").action((sessionId, opts) => {
+    const config = defaultConfig({ outputDir: opts.output });
+    const db = new CartographyDB(config.dbPath);
+    const session = sessionId ? db.getSession(sessionId) : db.getLatestSession();
+    if (!session) {
+      process.stderr.write("\u274C No session found. Run discover first.\n");
+      db.close();
+      process.exitCode = 1;
+      return;
+    }
+    const nodes = db.getNodes(session.id);
+    const connections = db.getConnections(session.id);
+    const outDir = resolve(opts.output);
+    const outPath = resolve(outDir, "hexmap.html");
+    import("fs").then(({ mkdirSync: mkdirSync3 }) => mkdirSync3(outDir, { recursive: true })).catch(() => {
+    });
+    writeFileSync2(outPath, exportHexMap(nodes, connections));
+    db.close();
+    const osc8 = (url, label) => `\x1B]8;;${url}\x1B\\${label}\x1B]8;;\x1B\\`;
+    const fileUrl = `file://${outPath}`;
+    process.stderr.write(`
+  ${green("\u2192")}  ${osc8(fileUrl, bold("Open hexmap.html"))}
+`);
+    process.stderr.write(`     ${dim(fileUrl)}
+
+`);
+    try {
+      const cmd = process.platform === "darwin" ? `open "${outPath}"` : process.platform === "win32" ? `start "" "${outPath}"` : `xdg-open "${outPath}"`;
+      execSync2(cmd, { stdio: "ignore" });
+    } catch {
+    }
+  });
   program.command("show [session-id]").description("Show session details").action((sessionId) => {
     const config = defaultConfig();
     const db = new CartographyDB(config.dbPath);
@@ -2591,6 +3708,9 @@ ${infraSummary.substring(0, 12e3)}`;
         const port = entry["port"];
         const tags = entry["tags"] ?? [];
         const metadata = entry["metadata"] ?? {};
+        const domain = entry["domain"];
+        const subDomain = entry["subDomain"];
+        const qualityScore = entry["qualityScore"];
         if (!type || !name) {
           w(yellow(`  \u26A0  Skipped (no type/name): ${JSON.stringify(entry)}
 `));
@@ -2604,7 +3724,10 @@ ${infraSummary.substring(0, 12e3)}`;
           discoveredVia: "manual",
           confidence: 1,
           metadata: { ...metadata, ...host ? { host } : {}, ...port ? { port } : {} },
-          tags
+          tags,
+          domain,
+          subDomain,
+          qualityScore
         });
         out(`  ${green("+")}  ${cyan(id)}  ${dim("(" + type + ")")}
 `);
@@ -2617,7 +3740,7 @@ ${infraSummary.substring(0, 12e3)}`;
 `);
       return;
     }
-    const { NODE_TYPES: NODE_TYPES2 } = await import("./types-ROE3Z6HY.js");
+    const { NODE_TYPES: NODE_TYPES2 } = await import("./types-A6K73WE4.js");
     if (!process.stdin.isTTY) {
       w(red("\n  \u2717  Interactive mode requires a terminal (use --file for non-interactive)\n\n"));
       process.exitCode = 1;
@@ -2660,9 +3783,15 @@ ${infraSummary.substring(0, 12e3)}`;
       const hostRaw = (await ask(`  ${cyan("Host / IP")} ${dim("[optional, Enter=skip]")}: `)).trim();
       const portRaw = (await ask(`  ${cyan("Port")} ${dim("[optional]")}: `)).trim();
       const tagsRaw = (await ask(`  ${cyan("Tags")} ${dim("[comma-separated, optional]")}: `)).trim();
+      const domainRaw = (await ask(`  ${cyan("Domain")} ${dim('[e.g. "Marketing", "Finance", optional]')}: `)).trim();
+      const subDomainRaw = (await ask(`  ${cyan("Sub-domain")} ${dim('[e.g. "Forecast client orders", optional]')}: `)).trim();
+      const qualityRaw = (await ask(`  ${cyan("Quality score")} ${dim("[0\u2013100, optional]")}: `)).trim();
       const host = hostRaw || void 0;
       const port = portRaw ? parseInt(portRaw, 10) : void 0;
       const tags = tagsRaw ? tagsRaw.split(",").map((t) => t.trim()).filter(Boolean) : [];
+      const domain = domainRaw || void 0;
+      const subDomain = subDomainRaw || void 0;
+      const qualityScore = qualityRaw ? Math.max(0, Math.min(100, parseFloat(qualityRaw))) : void 0;
       const id = host ? `${nodeType}:${host}${port ? ":" + port : ""}` : `${nodeType}:${name.toLowerCase().replace(/\s+/g, "-")}`;
       db.upsertNode(sessionId, {
         id,
@@ -2671,7 +3800,10 @@ ${infraSummary.substring(0, 12e3)}`;
         discoveredVia: "manual",
         confidence: 1,
         metadata: { ...host ? { host } : {}, ...port ? { port } : {} },
-        tags
+        tags,
+        domain,
+        subDomain,
+        qualityScore
       });
       out(`  ${green("+")}  ${cyan(id)}
 `);
@@ -2692,7 +3824,7 @@ ${infraSummary.substring(0, 12e3)}`;
 `);
   });
   program.command("doctor").description("Check all requirements and cloud CLIs").action(async () => {
-    const { execSync: execSync2 } = await import("child_process");
+    const { execSync: execSync3 } = await import("child_process");
     const { existsSync: existsSync3, readFileSync: readFileSync3 } = await import("fs");
     const { join: join3 } = await import("path");
     const out = (s) => process.stdout.write(s);
@@ -2715,7 +3847,7 @@ ${infraSummary.substring(0, 12e3)}`;
       allGood = false;
     }
     try {
-      const v = execSync2("claude --version", { stdio: "pipe" }).toString().trim();
+      const v = execSync3("claude --version", { stdio: "pipe" }).toString().trim();
       ok(`Claude CLI  ${dim2(v)}`);
     } catch {
       err("Claude CLI not found \u2014 npm i -g @anthropic-ai/claude-code");
@@ -2739,7 +3871,7 @@ ${infraSummary.substring(0, 12e3)}`;
       allGood = false;
     }
     try {
-      const v = execSync2("kubectl version --client --short 2>/dev/null || kubectl version --client", { stdio: "pipe" }).toString().split("\n")[0]?.trim() ?? "";
+      const v = execSync3("kubectl version --client --short 2>/dev/null || kubectl version --client", { stdio: "pipe" }).toString().split("\n")[0]?.trim() ?? "";
       ok(`kubectl  ${dim2(v || "(client OK)")}`);
     } catch {
       warn(`kubectl not found  ${dim2("\u2014 install: https://kubernetes.io/docs/tasks/tools/")}`);
@@ -2751,7 +3883,7 @@ ${infraSummary.substring(0, 12e3)}`;
     ];
     for (const [name, cmd, hint] of cloudClis) {
       try {
-        execSync2(cmd, { stdio: "pipe" });
+        execSync3(cmd, { stdio: "pipe" });
         ok(`${name}  ${dim2("(cloud scanning available)")}`);
       } catch {
         warn(`${name} not found  ${dim2("\u2014 cloud scan skipped | " + hint)}`);
@@ -2763,7 +3895,7 @@ ${infraSummary.substring(0, 12e3)}`;
     ];
     for (const [name, cmd] of localTools) {
       try {
-        execSync2(cmd, { stdio: "pipe" });
+        execSync3(cmd, { stdio: "pipe" });
         ok(`${name}  ${dim2("(discovery tool)")}`);
       } catch {
         warn(`${name} not found  ${dim2("\u2014 discovery without " + name + " will be limited")}`);