@datasynx/agentic-ai-cartography 0.2.6 → 0.3.2

package/README.md

@@ -2,7 +2,7 @@
 
 # 🗺️ Datasynx Cartography
 
-**AI-powered Infrastructure Cartography & SOP Generation**
+**AI-powered Infrastructure Cartography**
 
 [![npm version](https://img.shields.io/npm/v/@datasynx/agentic-ai-cartography?style=flat-square&color=CB3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/@datasynx/agentic-ai-cartography)
 [![npm downloads](https://img.shields.io/npm/dm/@datasynx/agentic-ai-cartography?style=flat-square&color=CB3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/@datasynx/agentic-ai-cartography)
@@ -13,7 +13,7 @@
 
 <br/>
 
-*Claude IS the agent — it decides which read-only commands to run, analyses the output, and stores results via custom MCP tools into SQLite. No hand-written parsers, diff logic, or decision trees.*
+*Claude IS the agent — it decides which read-only commands to run, analyses the output, and stores results via custom MCP tools into SQLite. No hand-written parsers, diff logic, or decision trees. SOP generation is available separately via [@datasynx/cartography-shadow](https://github.com/datasynx-ai/agentic-ai-shadowing).*
 
 <br/>
 
@@ -59,10 +59,7 @@ $ datasynx-cartography discover
 | **Browser Bookmarks** | Chrome, Firefox, Safari, Brave, Edge — extracts business/SaaS domains automatically |
 | **Cloud Scanning** | AWS (EC2/RDS/EKS/S3), GCP (Compute/GKE/Cloud Run), Azure (AKS/WebApps), Kubernetes |
 | **Human-in-the-Loop** | Chat with the agent mid-discovery: type `"hubspot windsurf"` to search for specific tools |
-| **Shadow Daemon** | Background observer every 30s — detects new services, ports, processes |
-| **SOP Generation** | Automatically generates Standard Operating Procedures from observed workflows |
-| **SOP Dashboard** | HTML dashboard with all SOPs, step details, frequency stats |
-| **Export Formats** | Mermaid topology, D3.js interactive graph, Backstage YAML, JSON, SOP Markdown |
+| **Export Formats** | Mermaid topology, D3.js interactive graph, Backstage YAML, JSON |
 | **Safety First** | `PreToolUse` hook blocks all destructive Bash commands — 100% read-only |
 
 ---
@@ -107,22 +104,6 @@ datasynx-cartography seed
 # View all browser bookmarks
 datasynx-cartography bookmarks
 
-# Start background observer (Claude Haiku, every 30s)
-datasynx-cartography shadow start
-
-# Attach to live event feed
-datasynx-cartography shadow attach     # [P] pause  [T] new task  [D] detach  [Q] stop
-
-# Pause / resume the daemon
-datasynx-cartography shadow pause
-datasynx-cartography shadow resume
-
-# Stop daemon + generate SOPs + open HTML dashboard
-datasynx-cartography shadow stop
-
-# Generate SOPs manually from a session
-datasynx-cartography sops [session-id]
-
 # Full feature reference
 datasynx-cartography docs
 ```
@@ -153,31 +134,11 @@ Discovery pipeline (automatic, in order):
 5. **Config files** — `.env`, `docker-compose.yml`, etc.
 6. **Human-in-the-loop** — interactive follow-up after initial scan
 
-### Shadow Daemon
-
-```
-datasynx-cartography shadow start [options]
-
-  --interval <ms>       Poll interval        (default: 30000, min: 15000)
-  --inactivity <ms>     Task boundary gap    (default: 300000)
-  --model <m>           Claude model         (default: claude-haiku-4-5-...)
-  --track-windows       Track window focus (requires xdotool)
-  --auto-save           Save nodes without prompting
-  --foreground          Run in foreground (no fork)
-
-datasynx-cartography shadow stop      # stops + generates SOPs + opens dashboard
-datasynx-cartography shadow pause     # SIGUSR1
-datasynx-cartography shadow resume    # SIGUSR2
-datasynx-cartography shadow status
-datasynx-cartography shadow attach
-```
-
 ### Analysis & Export
 
 ```
-datasynx-cartography sops [session-id]             Generate SOPs from observed workflows
 datasynx-cartography export [session-id] [options]
-  --format <fmt...>    mermaid, json, yaml, html, sops  (default: all)
+  --format <fmt...>    mermaid, json, yaml, html  (default: all)
   -o, --output <dir>   Output directory
 datasynx-cartography show [session-id]             Session details + node list
 datasynx-cartography sessions                      List all sessions
@@ -197,28 +158,16 @@ datasynx-output/
 ├── catalog-info.yaml          Backstage service catalog
 ├── topology.mermaid           Infrastructure topology (graph TB)
 ├── dependencies.mermaid       Service dependencies (graph LR)
-├── topology.html              Interactive D3.js force graph
-├── sop-dashboard.html         HTML dashboard with all SOPs + frequency stats
-├── sops/
-│   ├── deploy-check.md
-│   └── db-migration.md
-└── workflows/
-    └── workflow-001.mermaid
+└── topology.html              Interactive D3.js force graph
 ```
 
 ---
 
 ## Cost Estimate
 
-| Mode | Model | Interval | per Hour | per 8h Day |
-|------|-------|----------|----------|------------|
-| Discover | Sonnet | one-shot | $0.15–0.50 | one-shot |
-| Shadow | Haiku | 30s | $0.12–0.36 | $0.96–2.88 |
-| Shadow | Haiku | 60s | $0.06–0.18 | $0.48–1.44 |
-| Shadow (quiet)* | Haiku | 30s | ~$0.02 | ~$0.16 |
-| SOP generation | Sonnet | one-shot | $0.01–0.03 | one-shot |
-
-\* *quiet = diff-check skips ~90% of cycles when the system is idle*
+| Mode | Model | Interval | Typical Cost |
+|------|-------|----------|-------------|
+| Discover | Sonnet | one-shot | $0.15–0.50 |
 
 ---
 
@@ -228,22 +177,13 @@ datasynx-output/
 CLI (Commander.js)
   └── Preflight: Claude CLI + API key + interval validation
       └── Agent Orchestrator (src/agent.ts)
-          ├── runDiscovery()     Claude Sonnet + Bash + MCP Tools
-          │   ├── scan_bookmarks()         browser bookmark extraction
-          │   ├── scan_installed_apps()    /Applications, brew, dpkg, which
-          │   ├── scan_k8s_resources()     kubectl (readonly)
-          │   ├── scan_aws/gcp/azure()     cloud CLI scans (readonly)
-          │   └── ask_user()               human-in-the-loop questions
-          ├── runShadowCycle()   Claude Haiku + MCP Tools only (no Bash)
-          └── generateSOPs()     Anthropic Messages API (no agent loop)
+          └── runDiscovery()     Claude Sonnet + Bash + MCP Tools
+              ├── scan_bookmarks()         browser bookmark extraction
+              ├── scan_installed_apps()    /Applications, brew, dpkg, which
+              ├── scan_k8s_resources()     kubectl (readonly)
+              ├── scan_aws/gcp/azure()     cloud CLI scans (readonly)
+              └── ask_user()               human-in-the-loop questions
               └── Custom MCP Tools → CartographyDB (SQLite WAL)
-
-Shadow Daemon (src/daemon.ts)
-  ├── takeSnapshot()   →  ss + ps  (no Claude!)
-  ├── Diff-check       →  calls Claude only when something changed
-  ├── SIGUSR1/2        →  pause / resume
-  ├── IPC Server       →  Unix socket ~/.cartography/daemon.sock
-  └── Notifications    →  desktop alerts when no client attached
 ```
 
 ### Safety
@@ -260,10 +200,7 @@ Every Bash call is guarded by a `PreToolUse` hook that blocks destructive comman
 import {
   CartographyDB,
   runDiscovery,
-  runShadowCycle,
-  generateSOPs,
   exportAll,
-  exportSOPDashboard,
   safetyHook,
   defaultConfig,
 } from '@datasynx/agentic-ai-cartography';

package/dist/{chunk-EVJP2FWQ.js → chunk-FFNOC6HF.js}

@@ -28,14 +28,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),
@@ -52,15 +44,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(),
@@ -77,27 +60,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
   };
@@ -106,13 +77,10 @@ function defaultConfig(overrides = {}) {
 export {
   NODE_TYPES,
   EDGE_RELATIONSHIPS,
-  EVENT_TYPES,
   NodeSchema,
   EdgeSchema,
-  EventSchema,
   SOPStepSchema,
   SOPSchema,
-  MIN_POLL_INTERVAL_MS,
   defaultConfig
 };
-//# sourceMappingURL=chunk-EVJP2FWQ.js.map
+//# sourceMappingURL=chunk-FFNOC6HF.js.map

package/dist/chunk-FFNOC6HF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { z } from 'zod';\n\n// ── Enums ────────────────────────────────\n\nexport const NODE_TYPES = [\n  'host', 'database_server', 'database', 'table',\n  'web_service', 'api_endpoint', 'cache_server',\n  'message_broker', 'queue', 'topic',\n  'container', 'pod', 'k8s_cluster',\n  'config_file', 'saas_tool', 'unknown',\n] as const;\nexport type NodeType = typeof NODE_TYPES[number];\n\nexport const EDGE_RELATIONSHIPS = [\n  'connects_to', 'reads_from', 'writes_to',\n  'calls', 'contains', 'depends_on',\n] as const;\nexport type EdgeRelationship = typeof EDGE_RELATIONSHIPS[number];\n\n// ── Zod Schemas ──────────────────────────\n\nexport const NodeSchema = z.object({\n  id: z.string().describe('Format: \"{type}:{host}:{port}\" oder \"{type}:{name}\"'),\n  type: z.enum(NODE_TYPES),\n  name: z.string(),\n  discoveredVia: z.string(),\n  confidence: z.number().min(0).max(1).default(0.5),\n  metadata: z.record(z.unknown()).default({}),\n  tags: z.array(z.string()).default([]),\n});\nexport type DiscoveryNode = z.infer<typeof NodeSchema>;\n\nexport const EdgeSchema = z.object({\n  sourceId: z.string(),\n  targetId: z.string(),\n  relationship: z.enum(EDGE_RELATIONSHIPS),\n  evidence: z.string(),\n  confidence: z.number().min(0).max(1).default(0.5),\n});\nexport type DiscoveryEdge = z.infer<typeof EdgeSchema>;\n\nexport const SOPStepSchema = z.object({\n  order: z.number(),\n  instruction: z.string(),\n  tool: z.string(),\n  target: z.string().optional(),\n  notes: z.string().optional(),\n});\nexport type SOPStep = z.infer<typeof SOPStepSchema>;\n\nexport const SOPSchema = z.object({\n  title: z.string(),\n  description: z.string(),\n  steps: z.array(SOPStepSchema),\n  involvedSystems: z.array(z.string()),\n  estimatedDuration: z.string(),\n  frequency: z.string(),\n  confidence: z.number().min(0).max(1),\n});\nexport type SOP = z.infer<typeof SOPSchema>;\n\n// ── DB Row Types ─────────────────────────\n\nexport interface NodeRow extends DiscoveryNode {\n  sessionId: string;\n  discoveredAt: string;\n  depth: number;\n  pathId?: string;\n}\n\nexport interface EdgeRow extends DiscoveryEdge {\n  id: string;\n  sessionId: string;\n  discoveredAt: string;\n  pathId?: string;\n}\n\nexport interface SessionRow {\n  id: string;\n  mode: 'discover';\n  startedAt: string;\n  completedAt?: string;\n  config: string;\n}\n\n// ── Config ───────────────────────────────\n\nexport interface CartographyConfig {\n  maxDepth: number;\n  maxTurns: number;\n  entryPoints: string[];\n  agentModel: string;\n  organization?: string;\n  outputDir: string;\n  dbPath: string;\n  verbose: boolean;\n}\n\nexport function defaultConfig(overrides: Partial<CartographyConfig> = {}): CartographyConfig {\n  const home = process.env.HOME ?? process.env.USERPROFILE ?? '/tmp';\n  return {\n    maxDepth: 8,\n    maxTurns: 50,\n    entryPoints: ['localhost'],\n    agentModel: 'claude-sonnet-4-5-20250929',\n    outputDir: './cartography-output',\n    dbPath: `${home}/.cartography/cartography.db`,\n    verbose: false,\n    ...overrides,\n  };\n}\n"],"mappings":";;;AAAA,SAAS,SAAS;AAIX,IAAM,aAAa;AAAA,EACxB;AAAA,EAAQ;AAAA,EAAmB;AAAA,EAAY;AAAA,EACvC;AAAA,EAAe;AAAA,EAAgB;AAAA,EAC/B;AAAA,EAAkB;AAAA,EAAS;AAAA,EAC3B;AAAA,EAAa;AAAA,EAAO;AAAA,EACpB;AAAA,EAAe;AAAA,EAAa;AAC9B;AAGO,IAAM,qBAAqB;AAAA,EAChC;AAAA,EAAe;AAAA,EAAc;AAAA,EAC7B;AAAA,EAAS;AAAA,EAAY;AACvB;AAKO,IAAM,aAAa,EAAE,OAAO;AAAA,EACjC,IAAI,EAAE,OAAO,EAAE,SAAS,qDAAqD;AAAA,EAC7E,MAAM,EAAE,KAAK,UAAU;AAAA,EACvB,MAAM,EAAE,OAAO;AAAA,EACf,eAAe,EAAE,OAAO;AAAA,EACxB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG;AAAA,EAChD,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC1C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAGM,IAAM,aAAa,EAAE,OAAO;AAAA,EACjC,UAAU,EAAE,OAAO;AAAA,EACnB,UAAU,EAAE,OAAO;AAAA,EACnB,cAAc,EAAE,KAAK,kBAAkB;AAAA,EACvC,UAAU,EAAE,OAAO;AAAA,EACnB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG;AAClD,CAAC;AAGM,IAAM,gBAAgB,EAAE,OAAO;AAAA,EACpC,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,MAAM,EAAE,OAAO;AAAA,EACf,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,OAAO,EAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAGM,IAAM,YAAY,EAAE,OAAO;AAAA,EAChC,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,OAAO,EAAE,MAAM,aAAa;AAAA,EAC5B,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA,EACnC,mBAAmB,EAAE,OAAO;AAAA,EAC5B,WAAW,EAAE,OAAO;AAAA,EACpB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;AACrC,CAAC;AAwCM,SAAS,cAAc,YAAwC,CAAC,GAAsB;AAC3F,QAAM,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI,eAAe;AAC5D,SAAO;AAAA,IACL,UAAU;AAAA,IACV,UAAU;AAAA,IACV,aAAa,CAAC,WAAW;AAAA,IACzB,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,QAAQ,GAAG,IAAI;AAAA,IACf,SAAS;AAAA,IACT,GAAG;AAAA,EACL;AACF;","names":[]}