@datasynx/agentic-ai-cartography 0.1.7 → 0.1.8

package/dist/cli.js

@@ -665,7 +665,7 @@ function stripSensitive(target) {
     return target.replace(/\/.*$/, "").replace(/\?.*$/, "").replace(/@.*:/, ":");
   }
 }
-async function createCartographyTools(db, sessionId) {
+async function createCartographyTools(db, sessionId, opts = {}) {
   const sdk = await import("@anthropic-ai/claude-code");
   const { tool, createSdkMcpServer } = sdk;
   const tools = [
@@ -755,6 +755,20 @@ async function createCartographyTools(db, sessionId) {
       db.updateTaskDescription(sessionId, args["description"]);
       return { content: [{ type: "text", text: "\u2713 Beschreibung aktualisiert" }] };
     }),
+    tool("ask_user", "R\xFCckfrage an den User stellen \u2014 bei Unklarheiten, fehlenden Credentials-Hinweisen oder wenn Kontext fehlt", {
+      question: z2.string().describe("Die Frage an den User (klar und konkret)"),
+      context: z2.string().optional().describe("Optionaler Zusatzkontext warum die Frage relevant ist")
+    }, async (args) => {
+      const question = args["question"];
+      const context = args["context"];
+      if (opts.onAskUser) {
+        const answer = await opts.onAskUser(question, context);
+        return { content: [{ type: "text", text: answer }] };
+      }
+      return {
+        content: [{ type: "text", text: "(Kein interaktiver Modus \u2014 bitte ohne diese Information fortfahren)" }]
+      };
+    }),
     tool("scan_bookmarks", "Alle Browser-Lesezeichen scannen \u2014 nur Hostnamen, keine pers\xF6nlichen Daten", {
       minConfidence: z2.number().min(0).max(1).default(0.5).optional()
     }, async () => {
@@ -830,40 +844,54 @@ var safetyHook = async (input) => {
 };
 
 // src/agent.ts
-async function runDiscovery(config, db, sessionId, onEvent) {
+async function runDiscovery(config, db, sessionId, onEvent, onAskUser) {
   const { query } = await import("@anthropic-ai/claude-code");
-  const tools = await createCartographyTools(db, sessionId);
-  const systemPrompt = `Du bist ein Infrastruktur-Discovery-Agent.
-Kartographiere die gesamte Systemlandschaft \u2014 lokale Infrastruktur UND SaaS-Tools.
+  const tools = await createCartographyTools(db, sessionId, { onAskUser });
+  const systemPrompt = `Du bist ein Infrastruktur-Discovery-Agent. Kartographiere die gesamte Systemlandschaft \u2014 lokale Services UND SaaS-Tools des Users.
+
+\u2501\u2501 PFLICHT-REIHENFOLGE \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+SCHRITT 1 \u2014 Browser-Lesezeichen (IMMER ZUERST):
+  scan_bookmarks() aufrufen \u2192 jede zur\xFCckgegebene Domain klassifizieren:
+  \u2022 Business-Tools (GitHub, Notion, Jira, Linear, Vercel, AWS, Datadog, etc.) \u2192 save_node als saas_tool
+  \u2022 Interne Hosts (IPs, custom.company.com:PORT) \u2192 save_node als web_service
+  \u2022 Pers\xF6nliches (Social Media, News, Streaming, Shopping) \u2192 IGNORIEREN, NICHT speichern
 
-STRATEGIE:
-1. ss -tlnp + ps aux \u2192 \xDCberblick lokaler Services
-2. Jeden Service tiefer (Datenbanken\u2192Tabellen, APIs\u2192Endpoints, Queues\u2192Topics)
-3. scan_bookmarks \u2192 Browser-Lesezeichen analysieren: Welche Domains sind Business-Tools?
-   - Nur Tools mit Business-Daten als saas_tool speichern (GitHub, Notion, Jira, AWS, etc.)
-   - Pers\xF6nliches (Social Media, News, Shopping) IGNORIEREN
-   - Interne Hosts (IP-Adressen, custom.domain.com) als web_service speichern
-4. save_node + save_edge f\xFCr alles. get_catalog \u2192 keine Duplikate.
-5. Config-Files folgen: .env (nur Host:Port!), docker-compose.yml, application.yml
-6. Backtrack wenn Spur ersch\xF6pft. Stop wenn alles explored.
+SCHRITT 2 \u2014 Lokale Infrastruktur:
+  ss -tlnp && ps aux \u2192 alle lauschenden Ports/Prozesse identifizieren
+  Jeden Service vertiefen: DB\u2192Schemas, API\u2192Endpoints, Queue\u2192Topics
+
+SCHRITT 3 \u2014 Config-Files:
+  .env, docker-compose.yml, application.yml, kubernetes/*.yml
+  Nur Host:Port extrahieren \u2014 KEINE Credentials
+
+SCHRITT 4 \u2014 R\xFCckfragen bei Unklarheit:
+  ask_user() nutzen wenn: Dienst unklar ist, Kontext fehlt, oder User Input sinnvoll w\xE4re
+  Beispiele: "Welche Umgebung ist das (dev/staging/prod)?", "Ist <host> ein internes Tool?"
+
+SCHRITT 5 \u2014 Fertig wenn alle Spuren ersch\xF6pft.
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
 PORT-MAPPING: 5432=postgres, 3306=mysql, 27017=mongodb, 6379=redis,
 9092=kafka, 5672=rabbitmq, 80/443/8080/3000=web_service,
 9090=prometheus, 8500=consul, 8200=vault, 2379=etcd
 
 REGELN:
-- NUR read-only Commands (ss, ps, cat, head, curl -s, docker inspect, kubectl get)
-- Targets NUR Host:Port \u2014 KEINE URLs, Pfade, Credentials
-- Node IDs: "{type}:{host}:{port}" oder "{type}:{name}"
-- saas_tool Node IDs: "saas_tool:{hostname}" (z.B. "saas_tool:github.com")
-- Confidence: 0.9 direkt beobachtet, 0.7 aus Config/Lesezeichen, 0.5 Vermutung
-- KEINE Credentials, KEINE pers\xF6nlichen Daten speichern
-- metadata: { description, url_base, category } \u2014 NUR technische Daten
+\u2022 Nur read-only (ss, ps, cat, head, curl -s, docker inspect, kubectl get)
+\u2022 Node IDs: "type:host:port" oder "type:name" \u2014 keine Pfade, keine Credentials
+\u2022 saas_tool IDs: "saas_tool:github.com", "saas_tool:notion.so"
+\u2022 Confidence: 0.9 direkt gesehen, 0.7 aus Config/Bookmarks, 0.5 Vermutung
+\u2022 metadata erlaubt: { description, category, port, version } \u2014 keine Passw\xF6rter
+\u2022 get_catalog vor save_node \u2192 Duplikate vermeiden
+\u2022 Edges speichern wenn Verbindungen klar erkennbar sind
 
 Entrypoints: ${config.entryPoints.join(", ")}`;
+  const initialPrompt = `Starte Discovery jetzt.
+F\xFChre SOFORT als erstes scan_bookmarks aus \u2014 noch bevor du ss oder ps verwendest.
+Dann systematisch lokale Services, dann Config-Files.
+Nutze ask_user wenn du Kontext vom User brauchst.`;
   let turnCount = 0;
   for await (const msg of query({
-    prompt: systemPrompt,
+    prompt: initialPrompt,
     options: {
       model: config.agentModel,
       maxTurns: config.maxTurns,
@@ -874,7 +902,8 @@ Entrypoints: ${config.entryPoints.join(", ")}`;
         "mcp__cartograph__save_node",
         "mcp__cartograph__save_edge",
         "mcp__cartograph__get_catalog",
-        "mcp__cartograph__scan_bookmarks"
+        "mcp__cartograph__scan_bookmarks",
+        "mcp__cartograph__ask_user"
       ],
       hooks: {
         PreToolUse: [{ matcher: "Bash", hooks: [safetyHook] }]
@@ -1024,6 +1053,25 @@ function clusterTasks(tasks) {
 // src/exporter.ts
 import { mkdirSync as mkdirSync2, writeFileSync } from "fs";
 import { join as join3 } from "path";
+function nodeLayer(type) {
+  if (type === "saas_tool") return "saas";
+  if (["web_service", "api_endpoint"].includes(type)) return "web";
+  if (["database_server", "database", "table", "cache_server"].includes(type)) return "data";
+  if (["message_broker", "queue", "topic"].includes(type)) return "messaging";
+  if (["host", "container", "pod", "k8s_cluster"].includes(type)) return "infra";
+  if (type === "config_file") return "config";
+  return "other";
+}
+var LAYER_LABELS = {
+  saas: "\u2601 SaaS Tools",
+  web: "\u{1F310} Web / API",
+  data: "\u{1F5C4} Data Layer",
+  messaging: "\u{1F4E8} Messaging",
+  infra: "\u{1F5A5} Infrastructure",
+  config: "\u{1F4C4} Config",
+  other: "\u2753 Sonstige"
+};
+var LAYER_ORDER = ["saas", "web", "data", "messaging", "infra", "config", "other"];
 var MERMAID_ICONS = {
   host: "\u{1F5A5}",
   database_server: "\u{1F5C4}",
@@ -1076,18 +1124,18 @@ function nodeLabel(node) {
   const parts = node.id.split(":");
   const location = parts.length >= 3 ? `${parts[1]}:${parts[2]}` : parts[1] ?? "";
   const conf = `${Math.round(node.confidence * 100)}%`;
-  const loc = location ? `<br/><small>${location}</small>` : "";
-  return `"${icon} <b>${node.name}</b>${loc}<br/><small>${node.type} \xB7 ${conf}</small>"`;
-}
-function groupByHost(nodes) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const node of nodes) {
-    const parts = node.id.split(":");
-    const group = node.type === "saas_tool" ? "__saas__" : parts.length >= 3 ? parts[1] : "__local__";
-    if (!groups.has(group)) groups.set(group, []);
-    groups.get(group).push(node);
+  const meta = node.metadata;
+  const extras = [];
+  for (const key of ["category", "version", "description"]) {
+    const v = meta[key];
+    if (typeof v === "string" && v.length > 0) {
+      extras.push(v.substring(0, 28));
+      break;
+    }
   }
-  return groups;
+  const locLine = location ? `<br/><small>${location}</small>` : "";
+  const extraLine = extras.length ? `<br/><small>${extras[0]}</small>` : "";
+  return `["${icon} <b>${node.name}</b>${locLine}${extraLine}<br/><small>${node.type} \xB7 ${conf}</small>"]`;
 }
 function generateTopologyMermaid(nodes, edges) {
   if (nodes.length === 0) return 'graph TB\n    empty["No nodes discovered yet"]';
@@ -1098,25 +1146,29 @@ function generateTopologyMermaid(nodes, edges) {
     lines.push(`    classDef ${type.replace(/_/g, "")} ${style}`);
   }
   lines.push("");
-  const groups = groupByHost(nodes);
-  for (const [group, groupNodes] of groups) {
-    const isSubgraph = groups.size > 1;
-    if (isSubgraph) {
-      const label = group === "__saas__" ? "SaaS Tools \u2601" : group === "__local__" ? "Local" : group;
-      lines.push(`    subgraph ${sanitize(group)}["${label}"]`);
-    }
-    for (const node of groupNodes) {
-      lines.push(`    ${sanitize(node.id)}${nodeLabel(node)}:::${node.type.replace(/_/g, "")}`);
+  const layerMap = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const layer = nodeLayer(node.type);
+    if (!layerMap.has(layer)) layerMap.set(layer, []);
+    layerMap.get(layer).push(node);
+  }
+  for (const layerKey of LAYER_ORDER) {
+    const layerNodes = layerMap.get(layerKey);
+    if (!layerNodes || layerNodes.length === 0) continue;
+    const label = LAYER_LABELS[layerKey] ?? layerKey;
+    lines.push(`    subgraph ${layerKey}["${label}"]`);
+    for (const node of layerNodes) {
+      lines.push(`      ${sanitize(node.id)}${nodeLabel(node)}:::${node.type.replace(/_/g, "")}`);
     }
-    if (isSubgraph) lines.push("    end");
+    lines.push("    end");
     lines.push("");
   }
   for (const edge of edges) {
     const src = sanitize(edge.sourceId);
     const tgt = sanitize(edge.targetId);
     const label = EDGE_LABELS[edge.relationship] ?? edge.relationship;
-    const conf = edge.confidence < 0.6 ? " ?" : "";
-    lines.push(`    ${src} -->|"${label}${conf}"| ${tgt}`);
+    const arrow = edge.confidence < 0.6 ? `-. "${label}" .->` : `-->|"${label}"|`;
+    lines.push(`    ${src} ${arrow} ${tgt}`);
   }
   return lines.join("\n");
 }
@@ -1206,8 +1258,23 @@ function exportJSON(db, sessionId) {
 }
 function exportHTML(nodes, edges) {
   const graphData = JSON.stringify({
-    nodes: nodes.map((n) => ({ id: n.id, name: n.name, type: n.type, confidence: n.confidence })),
-    links: edges.map((e) => ({ source: e.sourceId, target: e.targetId, relationship: e.relationship }))
+    nodes: nodes.map((n) => ({
+      id: n.id,
+      name: n.name,
+      type: n.type,
+      confidence: n.confidence,
+      discoveredVia: n.discoveredVia,
+      discoveredAt: n.discoveredAt,
+      tags: n.tags,
+      metadata: n.metadata
+    })),
+    links: edges.map((e) => ({
+      source: e.sourceId,
+      target: e.targetId,
+      relationship: e.relationship,
+      confidence: e.confidence,
+      evidence: e.evidence
+    }))
   });
   return `<!DOCTYPE html>
 <html lang="de">
@@ -1216,22 +1283,50 @@ function exportHTML(nodes, edges) {
   <title>Cartography \u2014 Topology</title>
   <script src="https://d3js.org/d3.v7.min.js"></script>
   <style>
-    body { margin: 0; background: #1a1a2e; color: #eee; font-family: monospace; }
-    svg { width: 100vw; height: 100vh; }
-    .node circle { stroke: #fff; stroke-width: 1.5px; }
-    .node text { font-size: 10px; fill: #eee; }
-    .link { stroke: #666; stroke-opacity: 0.6; }
-    #info { position: fixed; top: 10px; right: 10px; background: rgba(0,0,0,0.7);
-            padding: 10px; border-radius: 4px; font-size: 12px; }
+    * { box-sizing: border-box; }
+    body { margin: 0; background: #0d1117; color: #e6edf3; font-family: 'SF Mono', 'Fira Code', monospace; display: flex; }
+    #graph { flex: 1; height: 100vh; }
+    svg { width: 100%; height: 100%; }
+    .link { stroke-opacity: 0.5; }
+    .link-label { font-size: 9px; fill: #8b949e; }
+    .node circle { stroke-width: 2px; cursor: pointer; transition: r 0.15s; }
+    .node circle:hover { r: 14; }
+    .node text { font-size: 11px; fill: #c9d1d9; pointer-events: none; }
+    /* \u2500\u2500 Sidebar \u2500\u2500 */
+    #sidebar {
+      width: 300px; min-width: 300px; height: 100vh; overflow-y: auto;
+      background: #161b22; border-left: 1px solid #30363d;
+      padding: 16px; font-size: 12px; line-height: 1.6;
+    }
+    #sidebar h2 { margin: 0 0 8px; font-size: 14px; color: #58a6ff; }
+    #sidebar .meta-table { width: 100%; border-collapse: collapse; }
+    #sidebar .meta-table td { padding: 3px 6px; border-bottom: 1px solid #21262d; vertical-align: top; }
+    #sidebar .meta-table td:first-child { color: #8b949e; white-space: nowrap; width: 90px; }
+    #sidebar .tag { display: inline-block; background: #21262d; border-radius: 3px; padding: 1px 5px; margin: 1px; }
+    #sidebar .conf-bar { height: 6px; border-radius: 3px; background: #21262d; margin-top: 3px; }
+    #sidebar .conf-fill { height: 100%; border-radius: 3px; }
+    #sidebar .edges-list { margin-top: 12px; }
+    #sidebar .edge-item { padding: 4px 0; border-bottom: 1px solid #21262d; color: #8b949e; }
+    #sidebar .edge-item span { color: #c9d1d9; }
+    .hint { color: #484f58; font-size: 11px; margin-top: 8px; }
+    #header { position: fixed; top: 10px; left: 10px; background: rgba(13,17,23,0.85);
+              padding: 8px 12px; border-radius: 6px; font-size: 12px; border: 1px solid #30363d; }
+    #header strong { color: #58a6ff; }
   </style>
 </head>
 <body>
-<div id="info">
-  <strong>Cartography</strong><br>
-  Nodes: ${nodes.length} | Edges: ${edges.length}<br>
-  <small>Drag to explore</small>
+<div id="graph">
+  <div id="header">
+    <strong>Cartography</strong> &nbsp;
+    <span style="color:#8b949e">${nodes.length} Nodes \xB7 ${edges.length} Edges</span><br>
+    <span style="color:#484f58;font-size:10px">Scroll=zoom \xB7 Drag=pan \xB7 Click=details</span>
+  </div>
+  <svg></svg>
+</div>
+<div id="sidebar">
+  <h2>Infrastructure Map</h2>
+  <p class="hint">Klicke einen Node um Details anzuzeigen.</p>
 </div>
-<svg></svg>
 <script>
 const data = ${graphData};
 
@@ -1240,41 +1335,100 @@ const TYPE_COLORS = {
   web_service: '#6bcb77', api_endpoint: '#4d96ff', cache_server: '#ffd93d',
   message_broker: '#c77dff', queue: '#e0aaff', topic: '#9d4edd',
   container: '#48cae4', pod: '#00b4d8', k8s_cluster: '#0077b6',
-  config_file: '#adb5bd', unknown: '#6c757d',
+  config_file: '#adb5bd', saas_tool: '#da8bff', unknown: '#6c757d',
 };
 
-const svg = d3.select('svg');
-const width = window.innerWidth, height = window.innerHeight;
-const g = svg.append('g');
+const NODE_RADIUS = { saas_tool: 10, host: 11, database_server: 11, k8s_cluster: 13, default: 8 };
+const radius = d => NODE_RADIUS[d.type] || NODE_RADIUS.default;
+
+const sidebar = document.getElementById('sidebar');
+
+function showNode(d) {
+  const c = TYPE_COLORS[d.type] || '#aaa';
+  const confPct = Math.round(d.confidence * 100);
+  const tags = (d.tags || []).map(t => \`<span class="tag">\${t}</span>\`).join('');
+  const metaRows = Object.entries(d.metadata || {})
+    .filter(([,v]) => v !== null && v !== undefined && String(v).length > 0)
+    .map(([k,v]) => \`<tr><td>\${k}</td><td>\${JSON.stringify(v)}</td></tr>\`)
+    .join('');
+  const related = data.links.filter(l =>
+    (l.source.id||l.source) === d.id || (l.target.id||l.target) === d.id
+  );
+  const edgeItems = related.map(l => {
+    const isOut = (l.source.id||l.source) === d.id;
+    const other = isOut ? (l.target.id||l.target) : (l.source.id||l.source);
+    return \`<div class="edge-item">\${isOut ? '\u2192' : '\u2190'} <span>\${other}</span> <small>[\${l.relationship}]</small></div>\`;
+  }).join('');
+
+  sidebar.innerHTML = \`
+    <h2>\${d.name}</h2>
+    <table class="meta-table">
+      <tr><td>ID</td><td style="font-size:10px;word-break:break-all">\${d.id}</td></tr>
+      <tr><td>Typ</td><td><span style="color:\${c}">\${d.type}</span></td></tr>
+      <tr><td>Confidence</td><td>
+        \${confPct}%
+        <div class="conf-bar"><div class="conf-fill" style="width:\${confPct}%;background:\${c}"></div></div>
+      </td></tr>
+      <tr><td>Entdeckt via</td><td>\${d.discoveredVia || '\u2014'}</td></tr>
+      <tr><td>Zeitpunkt</td><td>\${d.discoveredAt ? d.discoveredAt.substring(0,19).replace('T',' ') : '\u2014'}</td></tr>
+      \${tags ? '<tr><td>Tags</td><td>'+tags+'</td></tr>' : ''}
+      \${metaRows}
+    </table>
+    \${related.length > 0 ? '<div class="edges-list"><strong>Verbindungen:</strong>'+edgeItems+'</div>' : ''}
+  \`;
+}
+
+const svgEl = d3.select('svg');
+const graphDiv = document.getElementById('graph');
+const width = () => graphDiv.clientWidth;
+const height = () => graphDiv.clientHeight;
+const g = svgEl.append('g');
 
-svg.call(d3.zoom().on('zoom', e => g.attr('transform', e.transform)));
+svgEl.call(d3.zoom().scaleExtent([0.1, 4]).on('zoom', e => g.attr('transform', e.transform)));
 
 const sim = d3.forceSimulation(data.nodes)
-  .force('link', d3.forceLink(data.links).id(d => d.id).distance(100))
-  .force('charge', d3.forceManyBody().strength(-200))
-  .force('center', d3.forceCenter(width / 2, height / 2));
+  .force('link', d3.forceLink(data.links).id(d => d.id).distance(d => d.relationship === 'contains' ? 60 : 120))
+  .force('charge', d3.forceManyBody().strength(-320))
+  .force('center', d3.forceCenter(width() / 2, height() / 2))
+  .force('collision', d3.forceCollide().radius(d => radius(d) + 20));
 
-const link = g.append('g').selectAll('line')
-  .data(data.links).join('line').attr('class', 'link');
+const link = g.append('g')
+  .selectAll('line').data(data.links).join('line')
+  .attr('class', 'link')
+  .attr('stroke', d => d.confidence < 0.6 ? '#444' : '#555')
+  .attr('stroke-dasharray', d => d.confidence < 0.6 ? '4 3' : null)
+  .attr('stroke-width', d => d.confidence < 0.6 ? 1 : 1.5);
 
-const node = g.append('g').selectAll('g')
-  .data(data.nodes).join('g').attr('class', 'node')
+link.append('title').text(d => \`\${d.relationship} (conf:\${d.confidence})
+\${d.evidence||''}\`);
+
+const node = g.append('g')
+  .selectAll('g').data(data.nodes).join('g').attr('class', 'node')
   .call(d3.drag()
     .on('start', (e, d) => { if (!e.active) sim.alphaTarget(0.3).restart(); d.fx = d.x; d.fy = d.y; })
     .on('drag', (e, d) => { d.fx = e.x; d.fy = e.y; })
     .on('end', (e, d) => { if (!e.active) sim.alphaTarget(0); d.fx = null; d.fy = null; })
-  );
+  )
+  .on('click', (e, d) => { e.stopPropagation(); showNode(d); });
+
+node.append('circle')
+  .attr('r', radius)
+  .attr('fill', d => TYPE_COLORS[d.type] || '#aaa')
+  .attr('stroke', d => d3.color(TYPE_COLORS[d.type] || '#aaa').brighter(1).formatHex())
+  .append('title').text(d => \`\${d.id}
+conf:\${d.confidence}\`);
 
-node.append('circle').attr('r', 8).attr('fill', d => TYPE_COLORS[d.type] || '#aaa');
-node.append('text').attr('dx', 12).attr('dy', '.35em').text(d => d.name);
-node.append('title').text(d => \`\${d.type}: \${d.id}
-Confidence: \${d.confidence}\`);
+node.append('text').attr('dx', d => radius(d) + 4).attr('dy', '.35em').text(d => d.name);
 
 sim.on('tick', () => {
   link.attr('x1', d => d.source.x).attr('y1', d => d.source.y)
       .attr('x2', d => d.target.x).attr('y2', d => d.target.y);
   node.attr('transform', d => \`translate(\${d.x},\${d.y})\`);
 });
+
+svgEl.on('click', () => {
+  sidebar.innerHTML = '<h2>Infrastructure Map</h2><p class="hint">Klicke einen Node um Details anzuzeigen.</p>';
+});
 </script>
 </body>
 </html>`;
@@ -1792,10 +1946,17 @@ if (process.env.CARTOGRAPHYY_DAEMON === "1") {
 } else {
   main();
 }
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+var green = (s) => `\x1B[32m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var magenta = (s) => `\x1B[35m${s}\x1B[0m`;
+var red = (s) => `\x1B[31m${s}\x1B[0m`;
 function main() {
   const program = new Command();
   const CMD = "datasynx-cartography";
-  const VERSION = "0.1.7";
+  const VERSION = "0.1.8";
   program.name(CMD).description("AI-powered Infrastructure Cartography & SOP Generation").version(VERSION);
   program.command("discover").description("Infrastruktur scannen und kartographieren").option("--entry <hosts...>", "Startpunkte", ["localhost"]).option("--depth <n>", "Max Tiefe", "8").option("--max-turns <n>", "Max Agent-Turns", "50").option("--model <m>", "Agent-Model", "claude-sonnet-4-5-20250929").option("--org <name>", "Organisation (f\xFCr Backstage)").option("-o, --output <dir>", "Output-Dir", "./datasynx-output").option("--db <path>", "DB-Pfad").option("-v, --verbose", "Agent-Reasoning anzeigen", false).action(async (opts) => {
     checkPrerequisites();
@@ -1813,12 +1974,6 @@ function main() {
     const db = new CartographyDB(config.dbPath);
     const sessionId = db.createSession("discover", config);
     const w = process.stderr.write.bind(process.stderr);
-    const bold = (s) => `\x1B[1m${s}\x1B[0m`;
-    const dim = (s) => `\x1B[2m${s}\x1B[0m`;
-    const cyan = (s) => `\x1B[36m${s}\x1B[0m`;
-    const green = (s) => `\x1B[32m${s}\x1B[0m`;
-    const yellow = (s) => `\x1B[33m${s}\x1B[0m`;
-    const magenta = (s) => `\x1B[35m${s}\x1B[0m`;
     const SPINNER = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
     let spinIdx = 0;
     let spinnerTimer = null;
@@ -1892,6 +2047,12 @@ function main() {
             startSpinner(`Turn ${turnNum}/${config.maxTurns}  ${dim(`nodes:${nodeCount} edges:${edgeCount}`)}`);
           } else if (toolName === "get_catalog") {
             startSpinner(`Catalog-Check ${dim("(Duplikate vermeiden)")}`);
+          } else if (toolName === "scan_bookmarks") {
+            logLine(cyan("\u{1F516}"), `Browser-Lesezeichen werden gescannt\u2026`);
+            startSpinner(`scan_bookmarks`);
+          } else if (toolName === "ask_user") {
+            const q = (event.input["question"] ?? "").substring(0, 100);
+            logLine(yellow("?"), `${bold("Agent fragt:")} ${q}`);
           } else {
             startSpinner(`${toolName}...`);
           }
@@ -1904,8 +2065,28 @@ function main() {
           break;
       }
     };
+    const onAskUser = async (question, context) => {
+      stopSpinner();
+      w("\n");
+      w(dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+      w(`  ${yellow(bold("?"))}  ${bold("Agent fragt:")} ${question}
+`);
+      if (context) w(`     ${dim(context)}
+`);
+      if (!process.stdin.isTTY) {
+        w(`  ${dim("(Kein Terminal \u2014 Agent f\xE4hrt ohne Antwort fort)")}
+
+`);
+        return "(Kein interaktiver Modus \u2014 bitte ohne diese Information fortfahren)";
+      }
+      const rl = createInterface({ input: process.stdin, output: process.stderr });
+      const answer = await new Promise((resolve2) => rl.question(`  ${cyan("\u2192")} `, resolve2));
+      rl.close();
+      w("\n");
+      return answer || "(Keine Antwort \u2014 bitte fortfahren)";
+    };
     try {
-      await runDiscovery(config, db, sessionId, handleEvent);
+      await runDiscovery(config, db, sessionId, handleEvent, onAskUser);
     } catch (err) {
       stopSpinner();
       w(`
@@ -2141,13 +2322,154 @@ Session: ${session.id}
     }
     db.close();
   });
+  program.command("overview").description("\xDCbersicht aller Cartographies + SOPs").option("--db <path>", "DB-Pfad").action((opts) => {
+    const config = defaultConfig();
+    const db = new CartographyDB(opts.db ?? config.dbPath);
+    const sessions = db.getSessions();
+    const b = bold, d = dim;
+    const w = (s) => process.stdout.write(s);
+    w("\n");
+    w(`  ${b("CARTOGRAPHY OVERVIEW")}
+`);
+    w(d("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+    if (sessions.length === 0) {
+      w(`  ${d("Noch keine Sessions. Starte mit:")} ${green("datasynx-cartography discover")}
+
+`);
+      db.close();
+      return;
+    }
+    let totalNodes = 0, totalEdges = 0, totalSops = 0;
+    for (const s of sessions) {
+      const st = db.getStats(s.id);
+      totalNodes += st.nodes;
+      totalEdges += st.edges;
+      totalSops += db.getSOPs(s.id).length;
+    }
+    w(`  ${b(String(sessions.length))} Sessions \xB7 ${b(String(totalNodes))} Nodes \xB7 `);
+    w(`${b(String(totalEdges))} Edges \xB7 ${b(String(totalSops))} SOPs
+
+`);
+    for (const session of sessions) {
+      const stats = db.getStats(session.id);
+      const nodes = db.getNodes(session.id);
+      const sops = db.getSOPs(session.id);
+      const status = session.completedAt ? green("\u2713") : yellow("\u25CF");
+      const age = session.startedAt.substring(0, 16).replace("T", " ");
+      const sid = cyan(session.id.substring(0, 8));
+      w(`  ${status} ${sid}  ${b("[" + session.mode + "]")}  ${d(age)}
+`);
+      w(`    ${d("Nodes: " + stats.nodes + "  Edges: " + stats.edges + "  SOPs: " + sops.length)}
+`);
+      const byType = /* @__PURE__ */ new Map();
+      for (const n of nodes) byType.set(n.type, (byType.get(n.type) ?? 0) + 1);
+      if (byType.size > 0) {
+        const parts = [...byType.entries()].map(([t, c]) => `${t}:${c}`).join("  ");
+        w(`    ${d(parts)}
+`);
+      }
+      const topNodes = nodes.slice(0, 5).map((n) => n.id).join(", ");
+      if (topNodes) w(`    ${d("Nodes: " + topNodes + (nodes.length > 5 ? " \u2026" : ""))}
+`);
+      for (const sop of sops.slice(0, 3)) {
+        w(`    ${green("\u25BA")} ${sop.title} ${d("(" + sop.estimatedDuration + ")")}
+`);
+      }
+      if (sops.length > 3) w(`    ${d("\u2026 +" + (sops.length - 3) + " weitere SOPs")}
+`);
+      w("\n");
+    }
+    db.close();
+  });
+  program.command("chat [session-id]").description("Interaktiver Chat \xFCber die kartographierte Infrastruktur").option("--db <path>", "DB-Pfad").option("--model <m>", "Model", "claude-sonnet-4-5-20250929").action(async (sessionIdArg, opts) => {
+    const config = defaultConfig();
+    const db = new CartographyDB(opts.db ?? config.dbPath);
+    const sessions = db.getSessions();
+    const session = sessionIdArg ? sessions.find((s) => s.id.startsWith(sessionIdArg)) : sessions.filter((s) => s.completedAt).at(-1) ?? sessions.at(-1);
+    if (!session) {
+      process.stderr.write("Keine Session gefunden. F\xFChre zuerst discover aus.\n");
+      db.close();
+      return;
+    }
+    const nodes = db.getNodes(session.id);
+    const edges = db.getEdges(session.id);
+    const sops = db.getSOPs(session.id);
+    const w = (s) => process.stdout.write(s);
+    w("\n");
+    w(dim(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`));
+    w(`  ${bold("CARTOGRAPHY CHAT")}  ${dim("Session " + session.id.substring(0, 8))}
+`);
+    w(`  ${dim(String(nodes.length) + " Nodes \xB7 " + edges.length + " Edges \xB7 " + sops.length + " SOPs")}
+`);
+    w(dim(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`));
+    w(`  ${dim("Frage alles \xFCber deine Infrastruktur. exit = beenden.\n\n")}`);
+    const Anthropic = (await import("@anthropic-ai/sdk")).default;
+    const client = new Anthropic();
+    const infraSummary = JSON.stringify({
+      nodes: nodes.map((n) => ({
+        id: n.id,
+        name: n.name,
+        type: n.type,
+        confidence: n.confidence,
+        metadata: n.metadata,
+        tags: n.tags
+      })),
+      edges: edges.map((e) => ({ from: e.sourceId, to: e.targetId, rel: e.relationship, conf: e.confidence })),
+      sops: sops.map((s) => ({ title: s.title, description: s.description, steps: s.steps.length, duration: s.estimatedDuration }))
+    });
+    const systemPrompt = `Du bist ein Infrastruktur-Analyst f\xFCr Cartography.
+Du hast Zugriff auf die vollst\xE4ndig kartographierte Infrastruktur dieser Session.
+Beantworte Fragen pr\xE4zise und hilfreich. Nutze die Daten konkret.
+Du kannst SOPs erkl\xE4ren, Abh\xE4ngigkeiten analysieren, Risiken benennen, Optimierungen vorschlagen.
+
+INFRASTRUKTUR-SNAPSHOT (${nodes.length} Nodes, ${edges.length} Edges, ${sops.length} SOPs):
+${infraSummary.substring(0, 12e3)}`;
+    const history = [];
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = () => new Promise((resolve2) => rl.question(`  ${cyan(">")} `, resolve2));
+    while (true) {
+      let userInput;
+      try {
+        userInput = await ask();
+      } catch {
+        break;
+      }
+      if (!userInput.trim()) continue;
+      if (["exit", "quit", ":q"].includes(userInput.trim().toLowerCase())) break;
+      history.push({ role: "user", content: userInput });
+      try {
+        const resp = await client.messages.create({
+          model: opts.model,
+          max_tokens: 1024,
+          system: systemPrompt,
+          messages: history
+        });
+        const reply = resp.content.find((b) => b.type === "text")?.text ?? "";
+        history.push({ role: "assistant", content: reply });
+        w("\n");
+        for (const line of reply.split("\n")) {
+          w(`  ${line}
+`);
+        }
+        w("\n");
+      } catch (err) {
+        w(`  ${red("\u2717")}  Fehler: ${err}
+
+`);
+      }
+    }
+    rl.close();
+    db.close();
+    w(`
+  ${dim("Chat beendet.")}
+
+`);
+  });
   program.command("docs").description("Alle Features und Befehle auf einen Blick").action(() => {
     const out = process.stdout.write.bind(process.stdout);
-    const b = (s) => `\x1B[1m${s}\x1B[0m`;
-    const dim = (s) => `\x1B[2m${s}\x1B[0m`;
-    const cyan = (s) => `\x1B[36m${s}\x1B[0m`;
-    const green = (s) => `\x1B[32m${s}\x1B[0m`;
-    const yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+    const b = bold;
     const line = () => out(dim("\u2500".repeat(60)) + "\n");
     out("\n");
     out(b("  DATASYNX CARTOGRAPHY") + "  " + dim("v" + VERSION) + "\n");
@@ -2303,10 +2625,10 @@ Session: ${session.id}
 `);
     const warn = (msg) => out(`  \x1B[33m\u26A0\x1B[0m  ${msg}
 `);
-    const dim = (s) => `\x1B[2m${s}\x1B[0m`;
+    const dim2 = (s) => `\x1B[2m${s}\x1B[0m`;
     let allGood = true;
     out("\n  \x1B[1mDatasynx Cartography \u2014 Doctor\x1B[0m\n");
-    out(dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+    out(dim2("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
     const nodeVer = process.versions.node;
     const [major] = nodeVer.split(".").map(Number);
     if ((major ?? 0) >= 18) {
@@ -2317,7 +2639,7 @@ Session: ${session.id}
     }
     try {
       const v = execSync3("claude --version", { stdio: "pipe" }).toString().trim();
-      ok(`Claude CLI  ${dim(v)}`);
+      ok(`Claude CLI  ${dim2(v)}`);
     } catch {
       err("Claude CLI nicht gefunden \u2014 npm i -g @anthropic-ai/claude-code");
       allGood = false;
@@ -2347,18 +2669,18 @@ Session: ${session.id}
     for (const [name, cmd] of optional) {
       try {
         execSync3(cmd, { stdio: "pipe" });
-        ok(`${name}  ${dim("(Discovery-Tool)")}`);
+        ok(`${name}  ${dim2("(Discovery-Tool)")}`);
       } catch {
-        warn(`${name} nicht gefunden  ${dim("\u2014 Discovery ohne " + name + " eingeschr\xE4nkt")}`);
+        warn(`${name} nicht gefunden  ${dim2("\u2014 Discovery ohne " + name + " eingeschr\xE4nkt")}`);
       }
     }
     const dbDir = join4(home, ".cartography");
     if (existsSync6(dbDir)) {
-      ok(`~/.cartography  ${dim("(Daten-Verzeichnis vorhanden)")}`);
+      ok(`~/.cartography  ${dim2("(Daten-Verzeichnis vorhanden)")}`);
     } else {
-      warn("~/.cartography existiert noch nicht  " + dim("\u2014 wird beim ersten Start angelegt"));
+      warn("~/.cartography existiert noch nicht  " + dim2("\u2014 wird beim ersten Start angelegt"));
     }
-    out(dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+    out(dim2("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
     if (allGood) {
       out("  \x1B[32m\x1B[1mAlle Checks bestanden \u2014 datasynx-cartography discover\x1B[0m\n\n");
     } else {