@datasynx/agentic-ai-cartography 0.2.6 → 0.3.2

package/dist/index.d.ts

@@ -5,8 +5,6 @@ declare const NODE_TYPES: readonly ["host", "database_server", "database", "tabl
 type NodeType = typeof NODE_TYPES[number];
 declare const EDGE_RELATIONSHIPS: readonly ["connects_to", "reads_from", "writes_to", "calls", "contains", "depends_on"];
 type EdgeRelationship = typeof EDGE_RELATIONSHIPS[number];
-declare const EVENT_TYPES: readonly ["process_start", "process_end", "connection_open", "connection_close", "window_focus", "tool_switch"];
-type EventType = typeof EVENT_TYPES[number];
 declare const NodeSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<["host", "database_server", "database", "table", "web_service", "api_endpoint", "cache_server", "message_broker", "queue", "topic", "container", "pod", "k8s_cluster", "config_file", "saas_tool", "unknown"]>;
@@ -53,32 +51,6 @@ declare const EdgeSchema: z.ZodObject<{
     confidence?: number | undefined;
 }>;
 type DiscoveryEdge = z.infer<typeof EdgeSchema>;
-declare const EventSchema: z.ZodObject<{
-    eventType: z.ZodEnum<["process_start", "process_end", "connection_open", "connection_close", "window_focus", "tool_switch"]>;
-    process: z.ZodString;
-    pid: z.ZodNumber;
-    target: z.ZodOptional<z.ZodString>;
-    targetType: z.ZodOptional<z.ZodEnum<["host", "database_server", "database", "table", "web_service", "api_endpoint", "cache_server", "message_broker", "queue", "topic", "container", "pod", "k8s_cluster", "config_file", "saas_tool", "unknown"]>>;
-    protocol: z.ZodOptional<z.ZodString>;
-    port: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    eventType: "process_start" | "process_end" | "connection_open" | "connection_close" | "window_focus" | "tool_switch";
-    process: string;
-    pid: number;
-    target?: string | undefined;
-    targetType?: "host" | "database_server" | "database" | "table" | "web_service" | "api_endpoint" | "cache_server" | "message_broker" | "queue" | "topic" | "container" | "pod" | "k8s_cluster" | "config_file" | "saas_tool" | "unknown" | undefined;
-    protocol?: string | undefined;
-    port?: number | undefined;
-}, {
-    eventType: "process_start" | "process_end" | "connection_open" | "connection_close" | "window_focus" | "tool_switch";
-    process: string;
-    pid: number;
-    target?: string | undefined;
-    targetType?: "host" | "database_server" | "database" | "table" | "web_service" | "api_endpoint" | "cache_server" | "message_broker" | "queue" | "topic" | "container" | "pod" | "k8s_cluster" | "config_file" | "saas_tool" | "unknown" | undefined;
-    protocol?: string | undefined;
-    port?: number | undefined;
-}>;
-type ActivityEvent = z.infer<typeof EventSchema>;
 declare const SOPStepSchema: z.ZodObject<{
     order: z.ZodNumber;
     instruction: z.ZodString;
@@ -167,16 +139,35 @@ interface EdgeRow extends DiscoveryEdge {
     discoveredAt: string;
     pathId?: string;
 }
+interface SessionRow {
+    id: string;
+    mode: 'discover';
+    startedAt: string;
+    completedAt?: string;
+    config: string;
+}
+interface CartographyConfig {
+    maxDepth: number;
+    maxTurns: number;
+    entryPoints: string[];
+    agentModel: string;
+    organization?: string;
+    outputDir: string;
+    dbPath: string;
+    verbose: boolean;
+}
+declare function defaultConfig(overrides?: Partial<CartographyConfig>): CartographyConfig;
+
 interface EventRow {
     id: string;
     sessionId: string;
     taskId?: string;
     timestamp: string;
-    eventType: EventType;
+    eventType: string;
     process: string;
     pid: number;
     target?: string;
-    targetType?: NodeType;
+    targetType?: string;
     port?: number;
     durationMs?: number;
 }
@@ -203,94 +194,12 @@ interface WorkflowRow {
     avgDurationMs: number;
     involvedServices: string;
 }
-interface SessionRow {
-    id: string;
-    mode: 'discover' | 'shadow';
-    startedAt: string;
-    completedAt?: string;
-    config: string;
-}
-type DaemonMessage = {
-    type: 'event';
-    data: EventRow;
-} | {
-    type: 'prompt';
-    id: string;
-    prompt: PendingPrompt;
-} | {
-    type: 'status';
-    data: ShadowStatus;
-} | {
-    type: 'agent-output';
-    text: string;
-} | {
-    type: 'info';
-    message: string;
-};
-type ClientMessage = {
-    type: 'prompt-response';
-    id: string;
-    answer: string;
-} | {
-    type: 'command';
-    command: 'new-task' | 'end-task' | 'status' | 'stop' | 'pause' | 'resume';
-} | {
-    type: 'task-description';
-    description: string;
-};
-interface PendingPrompt {
-    kind: 'node-approval' | 'task-boundary' | 'task-end';
-    context: Record<string, unknown>;
-    options: string[];
-    defaultAnswer: string;
-    timeoutMs: number;
-    createdAt: string;
-}
-interface ShadowStatus {
-    pid: number;
-    uptime: number;
-    nodeCount: number;
-    eventCount: number;
-    taskCount: number;
-    sopCount: number;
-    pendingPrompts: number;
-    autoSave: boolean;
-    mode: 'foreground' | 'daemon';
-    agentActive: boolean;
-    paused: boolean;
-    cyclesRun: number;
-    cyclesSkipped: number;
-}
-declare const MIN_POLL_INTERVAL_MS = 15000;
-interface CartographyConfig {
-    mode: 'discover' | 'shadow';
-    maxDepth: number;
-    maxTurns: number;
-    entryPoints: string[];
-    agentModel: string;
-    shadowMode: 'foreground' | 'daemon';
-    pollIntervalMs: number;
-    inactivityTimeoutMs: number;
-    promptTimeoutMs: number;
-    trackWindowFocus: boolean;
-    autoSaveNodes: boolean;
-    enableNotifications: boolean;
-    shadowModel: string;
-    organization?: string;
-    outputDir: string;
-    dbPath: string;
-    socketPath: string;
-    pidFile: string;
-    verbose: boolean;
-}
-declare function defaultConfig(overrides?: Partial<CartographyConfig>): CartographyConfig;
-
 declare class CartographyDB {
     private db;
     constructor(dbPath: string);
     private migrate;
     close(): void;
-    createSession(mode: 'discover' | 'shadow', config: CartographyConfig): string;
+    createSession(mode: 'discover', config: CartographyConfig): string;
     endSession(id: string): void;
     getSession(id: string): SessionRow | undefined;
     getLatestSession(mode?: string): SessionRow | undefined;
@@ -301,7 +210,7 @@ declare class CartographyDB {
     deleteNode(sessionId: string, nodeId: string): void;
     insertEdge(sessionId: string, edge: DiscoveryEdge): void;
     getEdges(sessionId: string): EdgeRow[];
-    insertEvent(sessionId: string, event: ActivityEvent, taskId?: string): void;
+    insertEvent(sessionId: string, event: Pick<EventRow, 'eventType' | 'process' | 'pid' | 'target' | 'targetType' | 'port'>, taskId?: string): void;
     getEvents(sessionId: string, since?: string): EventRow[];
     startTask(sessionId: string, description?: string): string;
     endCurrentTask(sessionId: string): void;
@@ -363,8 +272,6 @@ type DiscoveryEvent = {
 };
 type AskUserFn = (question: string, context?: string) => Promise<string>;
 declare function runDiscovery(config: CartographyConfig, db: CartographyDB, sessionId: string, onEvent?: (event: DiscoveryEvent) => void, onAskUser?: AskUserFn, hint?: string): Promise<void>;
-declare function runShadowCycle(config: CartographyConfig, db: CartographyDB, sessionId: string, prevSnapshot: string, currSnapshot: string, onOutput?: (msg: unknown) => void): Promise<void>;
-declare function generateSOPs(db: CartographyDB, sessionId: string): Promise<number>;
 
 declare function generateTopologyMermaid(nodes: NodeRow[], edges: EdgeRow[]): string;
 declare function generateDependencyMermaid(nodes: NodeRow[], edges: EdgeRow[]): string;
@@ -381,6 +288,5 @@ declare function exportSOPDashboard(sops: Array<SOP & {
 declare function exportAll(db: CartographyDB, sessionId: string, outputDir: string, formats?: string[]): void;
 
 declare function checkPrerequisites(): void;
-declare function checkPollInterval(intervalMs: number): number;
 
-export { type ActivityEvent, type CartographyConfig, CartographyDB, type ClientMessage, type DaemonMessage, type DiscoveryEdge, type DiscoveryEvent, type DiscoveryNode, EDGE_RELATIONSHIPS, EVENT_TYPES, type EdgeRelationship, type EdgeRow, EdgeSchema, type EventRow, EventSchema, type EventType, MIN_POLL_INTERVAL_MS, NODE_TYPES, type NodeRow, NodeSchema, type NodeType, type PendingPrompt, type SOP, SOPSchema, type SOPStep, SOPStepSchema, type SessionRow, type ShadowStatus, type TaskRow, type WorkflowRow, checkPollInterval, checkPrerequisites, createCartographyTools, CartographyDB as default, defaultConfig, exportAll, exportBackstageYAML, exportHTML, exportJSON, exportSOPDashboard, exportSOPMarkdown, generateDependencyMermaid, generateSOPs, generateTopologyMermaid, generateWorkflowMermaid, runDiscovery, runShadowCycle, safetyHook, stripSensitive };
+export { type CartographyConfig, CartographyDB, type DiscoveryEdge, type DiscoveryEvent, type DiscoveryNode, EDGE_RELATIONSHIPS, type EdgeRelationship, type EdgeRow, EdgeSchema, NODE_TYPES, type NodeRow, NodeSchema, type NodeType, type SOP, SOPSchema, type SOPStep, SOPStepSchema, type SessionRow, checkPrerequisites, createCartographyTools, CartographyDB as default, defaultConfig, exportAll, exportBackstageYAML, exportHTML, exportJSON, exportSOPDashboard, exportSOPMarkdown, generateDependencyMermaid, generateTopologyMermaid, generateWorkflowMermaid, runDiscovery, safetyHook, stripSensitive };

package/dist/index.js

@@ -9,7 +9,7 @@ PRAGMA busy_timeout = 5000;
 
 CREATE TABLE IF NOT EXISTS sessions (
   id TEXT PRIMARY KEY,
-  mode TEXT NOT NULL CHECK (mode IN ('discover','shadow')),
+  mode TEXT NOT NULL CHECK (mode IN ('discover')),
   started_at TEXT NOT NULL,
   completed_at TEXT,
   config TEXT NOT NULL DEFAULT '{}'
@@ -454,14 +454,6 @@ var EDGE_RELATIONSHIPS = [
   "contains",
   "depends_on"
 ];
-var EVENT_TYPES = [
-  "process_start",
-  "process_end",
-  "connection_open",
-  "connection_close",
-  "window_focus",
-  "tool_switch"
-];
 var NodeSchema = z.object({
   id: z.string().describe('Format: "{type}:{host}:{port}" oder "{type}:{name}"'),
   type: z.enum(NODE_TYPES),
@@ -478,15 +470,6 @@ var EdgeSchema = z.object({
   evidence: z.string(),
   confidence: z.number().min(0).max(1).default(0.5)
 });
-var EventSchema = z.object({
-  eventType: z.enum(EVENT_TYPES),
-  process: z.string(),
-  pid: z.number(),
-  target: z.string().optional(),
-  targetType: z.enum(NODE_TYPES).optional(),
-  protocol: z.string().optional(),
-  port: z.number().optional()
-});
 var SOPStepSchema = z.object({
   order: z.number(),
   instruction: z.string(),
@@ -503,27 +486,15 @@ var SOPSchema = z.object({
   frequency: z.string(),
   confidence: z.number().min(0).max(1)
 });
-var MIN_POLL_INTERVAL_MS = 15e3;
 function defaultConfig(overrides = {}) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
   return {
-    mode: "discover",
     maxDepth: 8,
     maxTurns: 50,
     entryPoints: ["localhost"],
     agentModel: "claude-sonnet-4-5-20250929",
-    shadowMode: "daemon",
-    pollIntervalMs: 3e4,
-    inactivityTimeoutMs: 3e5,
-    promptTimeoutMs: 6e4,
-    trackWindowFocus: false,
-    autoSaveNodes: false,
-    enableNotifications: true,
-    shadowModel: "claude-haiku-4-5-20251001",
     outputDir: "./cartography-output",
     dbPath: `${home}/.cartography/cartography.db`,
-    socketPath: `${home}/.cartography/daemon.sock`,
-    pidFile: `${home}/.cartography/daemon.pid`,
     verbose: false,
     ...overrides
   };
@@ -829,24 +800,6 @@ async function createCartographyTools(db, sessionId, opts = {}) {
       });
       return { content: [{ type: "text", text: `\u2713 ${args["sourceId"]}\u2192${args["targetId"]}` }] };
     }),
-    tool("save_event", "Save an activity event (process/connection observed)", {
-      eventType: z2.enum(EVENT_TYPES),
-      process: z2.string(),
-      pid: z2.number(),
-      target: z2.string().optional(),
-      targetType: z2.enum(NODE_TYPES).optional(),
-      port: z2.number().optional()
-    }, async (args) => {
-      db.insertEvent(sessionId, {
-        eventType: args["eventType"],
-        process: args["process"],
-        pid: args["pid"],
-        target: args["target"] ? stripSensitive(args["target"]) : void 0,
-        targetType: args["targetType"],
-        port: args["port"]
-      });
-      return { content: [{ type: "text", text: `\u2713 ${args["eventType"]}` }] };
-    }),
     tool("get_catalog", "Get the current catalog \u2014 use before save_node to avoid duplicates", {
       includeEdges: z2.boolean().default(true)
     }, async (args) => {
@@ -862,22 +815,6 @@ async function createCartographyTools(db, sessionId, opts = {}) {
         }]
       };
     }),
-    tool("manage_task", "Start, end or describe a workflow task", {
-      action: z2.enum(["start", "end", "describe"]),
-      description: z2.string().optional()
-    }, async (args) => {
-      const action = args["action"];
-      if (action === "start") {
-        const id = db.startTask(sessionId, args["description"]);
-        return { content: [{ type: "text", text: `\u2713 Task started: ${id}` }] };
-      }
-      if (action === "end") {
-        db.endCurrentTask(sessionId);
-        return { content: [{ type: "text", text: "\u2713 Task ended" }] };
-      }
-      db.updateTaskDescription(sessionId, args["description"]);
-      return { content: [{ type: "text", text: "\u2713 Description updated" }] };
-    }),
     tool("ask_user", "Ask the user a question \u2014 for clarifications, missing context, or consent (e.g. before scanning browser history)", {
       question: z2.string().describe("The question for the user (clear and specific)"),
       context: z2.string().optional().describe("Optional context explaining why this is relevant")
@@ -1470,109 +1407,6 @@ Use ask_user when you need context from the user.`;
     }
   }
 }
-async function runShadowCycle(config, db, sessionId, prevSnapshot, currSnapshot, onOutput) {
-  const { query } = await import("@anthropic-ai/claude-code");
-  const tools = await createCartographyTools(db, sessionId);
-  const prompt = `Analyze the diff between these two system snapshots.
-Find:
-- New/closed TCP connections \u2192 save_event
-- New/terminated processes \u2192 save_event
-- Previously unknown services \u2192 check get_catalog, then save_node
-- Task boundaries (inactivity, tool switches) \u2192 manage_task
-target = host:port ONLY. Be concise and efficient.
-
-=== BEFORE ===
-${prevSnapshot}
-
-=== NOW ===
-${currSnapshot}`;
-  for await (const msg of query({
-    prompt,
-    options: {
-      model: config.shadowModel,
-      maxTurns: 5,
-      mcpServers: { cartography: tools },
-      allowedTools: [
-        "mcp__cartograph__save_event",
-        "mcp__cartograph__save_node",
-        "mcp__cartograph__save_edge",
-        "mcp__cartograph__get_catalog",
-        "mcp__cartograph__manage_task"
-      ],
-      permissionMode: "bypassPermissions"
-    }
-  })) {
-    if (onOutput) onOutput(msg);
-  }
-}
-async function generateSOPs(db, sessionId) {
-  const Anthropic = (await import("@anthropic-ai/sdk")).default;
-  const client = new Anthropic();
-  const tasks = db.getTasks(sessionId).filter((t) => t.status === "completed");
-  if (tasks.length === 0) return 0;
-  const clusters = clusterTasks(tasks);
-  let generated = 0;
-  for (const cluster of clusters) {
-    const workflowId = crypto.randomUUID();
-    const involved = JSON.parse(cluster[0]?.involvedServices ?? "[]");
-    const taskDescriptions = cluster.map((t, i) => `Task ${i + 1}: ${t.description ?? "Unnamed"}
-Steps: ${t.steps}`).join("\n\n");
-    const response = await client.messages.create({
-      model: "claude-sonnet-4-5-20250929",
-      max_tokens: 2048,
-      messages: [{
-        role: "user",
-        content: `Generate a Standard Operating Procedure (SOP) for this recurring workflow.
-Reply ONLY with valid JSON in this format:
-{
-  "title": "...",
-  "description": "...",
-  "steps": [{"order": 1, "instruction": "...", "tool": "...", "target": "...", "notes": "..."}],
-  "involvedSystems": ["..."],
-  "estimatedDuration": "~N minutes",
-  "frequency": "X times daily",
-  "confidence": 0.8
-}
-
-Tasks:
-${taskDescriptions}
-
-Involved services: ${involved.join(", ")}`
-      }]
-    });
-    const text = response.content[0]?.type === "text" ? response.content[0].text : "";
-    try {
-      const jsonMatch = text.match(/\{[\s\S]*\}/);
-      if (!jsonMatch) continue;
-      const parsed = JSON.parse(jsonMatch[0]);
-      db.insertSOP({ workflowId, ...parsed });
-      generated++;
-    } catch {
-    }
-  }
-  return generated;
-}
-function clusterTasks(tasks) {
-  const clusters = [];
-  const assigned = /* @__PURE__ */ new Set();
-  for (const task of tasks) {
-    if (assigned.has(task.id)) continue;
-    const cluster = [task];
-    assigned.add(task.id);
-    const taskServices = new Set(JSON.parse(task.involvedServices ?? "[]"));
-    for (const other of tasks) {
-      if (assigned.has(other.id)) continue;
-      const otherServices = new Set(JSON.parse(other.involvedServices ?? "[]"));
-      const overlap = [...taskServices].filter((s) => otherServices.has(s));
-      if (overlap.length > 0) {
-        cluster.push(other);
-        assigned.add(other.id);
-      }
-    }
-    clusters.push(cluster);
-  }
-  return clusters;
-}
 
 // src/exporter.ts
 import { mkdirSync as mkdirSync2, writeFileSync } from "fs";
@@ -2428,7 +2262,7 @@ function exportSOPDashboard(sops) {
 <body>
 <div class="header">
   <h1>SOP Dashboard</h1>
-  <div class="subtitle">Datasynx Cartography \u2014 Standard Operating Procedures</div>
+  <div class="subtitle">Cartography \u2014 Standard Operating Procedures</div>
   <div class="stats-row">
     <div class="stat-card"><div class="value" id="sop-count">0</div><div class="label">SOPs</div></div>
     <div class="stat-card"><div class="value" id="step-count">0</div><div class="label">Total Steps</div></div>
@@ -2465,7 +2299,7 @@ systems.forEach(([name, count]) => {
 
 const listDiv = document.getElementById('sop-list');
 if (sops.length === 0) {
-  listDiv.innerHTML = '<div class="empty">No SOPs found. Start the shadow daemon and observe workflows.</div>';
+  listDiv.innerHTML = '<div class="empty">No SOPs found. Run a discovery session first.</div>';
 }
 
 sops.forEach((sop, i) => {
@@ -2585,20 +2419,8 @@ function checkPrerequisites() {
     process.stderr.write("\u2713 Eingeloggt via claude login (Subscription)\n");
   }
 }
-function checkPollInterval(intervalMs) {
-  if (intervalMs < MIN_POLL_INTERVAL_MS) {
-    process.stderr.write(
-      `\u26A0 Minimum Shadow-Intervall: ${MIN_POLL_INTERVAL_MS / 1e3} Sekunden (Agent SDK Overhead)
-`
-    );
-    return MIN_POLL_INTERVAL_MS;
-  }
-  return intervalMs;
-}
 export {
   CartographyDB,
-  MIN_POLL_INTERVAL_MS,
-  checkPollInterval,
   checkPrerequisites,
   createCartographyTools,
   CartographyDB as default,
@@ -2610,11 +2432,9 @@ export {
   exportSOPDashboard,
   exportSOPMarkdown,
   generateDependencyMermaid,
-  generateSOPs,
   generateTopologyMermaid,
   generateWorkflowMermaid,
   runDiscovery,
-  runShadowCycle,
   safetyHook,
   stripSensitive
 };