@datasynx/agentic-ai-cartography 0.3.3 → 0.5.0

package/README.md

@@ -2,7 +2,7 @@
 
 # 🗺️ Datasynx Cartography
 
-**AI-powered Infrastructure Cartography**
+**AI-powered Infrastructure Cartography & SOP Generation**
 
 [![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. SOP generation is available separately via [@datasynx/cartography-shadow](https://github.com/datasynx-ai/agentic-ai-shadowing).*
+*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.*
 
 <br/>
 
@@ -59,7 +59,9 @@ $ 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 |
-| **Export Formats** | Mermaid topology, D3.js interactive graph, Backstage YAML, JSON |
+| **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 |
 | **Safety First** | `PreToolUse` hook blocks all destructive Bash commands — 100% read-only |
 
 ---
@@ -138,7 +140,7 @@ Discovery pipeline (automatic, in order):
 
 ```
 datasynx-cartography export [session-id] [options]
-  --format <fmt...>    mermaid, json, yaml, html  (default: all)
+  --format <fmt...>    mermaid, json, yaml, html, sops  (default: all)
   -o, --output <dir>   Output directory
 datasynx-cartography show [session-id]             Session details + node list
 datasynx-cartography sessions                      List all sessions
@@ -158,16 +160,23 @@ 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
+├── 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
 ```
 
 ---
 
 ## Cost Estimate
 
-| Mode | Model | Interval | Typical Cost |
-|------|-------|----------|-------------|
-| Discover | Sonnet | one-shot | $0.15–0.50 |
+| Mode | Model | Interval | per Hour | per 8h Day |
+|------|-------|----------|----------|------------|
+| Discover | Sonnet | one-shot | $0.15–0.50 | one-shot |
+| SOP generation | Sonnet | one-shot | $0.01–0.03 | one-shot |
 
 ---
 
@@ -201,6 +210,7 @@ import {
   CartographyDB,
   runDiscovery,
   exportAll,
+  exportSOPDashboard,
   safetyHook,
   defaultConfig,
 } from '@datasynx/agentic-ai-cartography';

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

@@ -35,7 +35,10 @@ var NodeSchema = z.object({
   discoveredVia: z.string(),
   confidence: z.number().min(0).max(1).default(0.5),
   metadata: z.record(z.unknown()).default({}),
-  tags: z.array(z.string()).default([])
+  tags: z.array(z.string()).default([]),
+  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")
 });
 var EdgeSchema = z.object({
   sourceId: z.string(),
@@ -60,6 +63,63 @@ var SOPSchema = z.object({
   frequency: z.string(),
   confidence: z.number().min(0).max(1)
 });
+var DataAssetSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  domain: z.string(),
+  subDomain: z.string().optional(),
+  qualityScore: z.number().min(0).max(100).optional(),
+  metadata: z.record(z.unknown()).default({}),
+  position: z.object({ q: z.number(), r: z.number() })
+});
+var ClusterSchema = z.object({
+  id: z.string(),
+  label: z.string(),
+  domain: z.string(),
+  color: z.string(),
+  assetIds: z.array(z.string()),
+  centroid: z.object({ x: z.number(), y: z.number() })
+});
+var ConnectionSchema = z.object({
+  id: z.string(),
+  sourceAssetId: z.string(),
+  targetAssetId: z.string(),
+  type: z.string().optional()
+});
+var DOMAIN_COLORS = {
+  "Quality Control": "#1a2744",
+  "Supply Chain": "#1e3a6e",
+  "Marketing": "#6a7fb5",
+  "Finance": "#3a8a8a",
+  "HR": "#2a5a9a",
+  "Logistics": "#0e7490",
+  "Sales": "#1d4ed8",
+  "Engineering": "#4338ca",
+  "Operations": "#0891b2",
+  "Data Layer": "#1e3352",
+  "Web / API": "#1a3a1a",
+  "Messaging": "#2a1a3a",
+  "Infrastructure": "#0f2a40",
+  "Other": "#374151"
+};
+var DOMAIN_PALETTE = [
+  "#1a2e5a",
+  "#1e3a8a",
+  "#1d4ed8",
+  "#2563eb",
+  "#3b82f6",
+  "#6366f1",
+  "#818cf8",
+  "#7c9fc3",
+  "#0e7490",
+  "#0891b2",
+  "#06b6d4",
+  "#22d3ee",
+  "#0d9488",
+  "#14b8a6",
+  "#2dd4bf",
+  "#5eead4"
+];
 function defaultConfig(overrides = {}) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
   return {
@@ -81,6 +141,11 @@ export {
   EdgeSchema,
   SOPStepSchema,
   SOPSchema,
+  DataAssetSchema,
+  ClusterSchema,
+  ConnectionSchema,
+  DOMAIN_COLORS,
+  DOMAIN_PALETTE,
   defaultConfig
 };
-//# sourceMappingURL=chunk-FFNOC6HF.js.map
+//# sourceMappingURL=chunk-A7FTULDM.js.map

package/dist/chunk-A7FTULDM.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  domain: z.string().optional().describe('Business domain, e.g. \"Marketing\", \"Finance\"'),\n  subDomain: z.string().optional().describe('Sub-domain, e.g. \"Forecast client orders\"'),\n  qualityScore: z.number().min(0).max(100).optional().describe('Data quality score 0–100'),\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// ── Cartography Map Types ────────────────\n\nexport const DataAssetSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  domain: z.string(),\n  subDomain: z.string().optional(),\n  qualityScore: z.number().min(0).max(100).optional(),\n  metadata: z.record(z.unknown()).default({}),\n  position: z.object({ q: z.number(), r: z.number() }),\n});\nexport type DataAsset = z.infer<typeof DataAssetSchema>;\n\nexport const ClusterSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  domain: z.string(),\n  color: z.string(),\n  assetIds: z.array(z.string()),\n  centroid: z.object({ x: z.number(), y: z.number() }),\n});\nexport type Cluster = z.infer<typeof ClusterSchema>;\n\nexport const ConnectionSchema = z.object({\n  id: z.string(),\n  sourceAssetId: z.string(),\n  targetAssetId: z.string(),\n  type: z.string().optional(),\n});\nexport type Connection = z.infer<typeof ConnectionSchema>;\n\nexport interface CartographyMapData {\n  assets: DataAsset[];\n  clusters: Cluster[];\n  connections: Connection[];\n  meta: { exportedAt: string; theme: 'light' | 'dark' };\n}\n\n/** Navy → medium blue → periwinkle → teal/cyan palette */\nexport const DOMAIN_COLORS: Record<string, string> = {\n  'Quality Control': '#1a2744',\n  'Supply Chain': '#1e3a6e',\n  'Marketing': '#6a7fb5',\n  'Finance': '#3a8a8a',\n  'HR': '#2a5a9a',\n  'Logistics': '#0e7490',\n  'Sales': '#1d4ed8',\n  'Engineering': '#4338ca',\n  'Operations': '#0891b2',\n  'Data Layer': '#1e3352',\n  'Web / API': '#1a3a1a',\n  'Messaging': '#2a1a3a',\n  'Infrastructure': '#0f2a40',\n  'Other': '#374151',\n};\n\n/** Ordered palette for dynamic domain assignment */\nexport const DOMAIN_PALETTE = [\n  '#1a2e5a', '#1e3a8a', '#1d4ed8', '#2563eb', '#3b82f6',\n  '#6366f1', '#818cf8', '#7c9fc3', '#0e7490', '#0891b2',\n  '#06b6d4', '#22d3ee', '#0d9488', '#14b8a6', '#2dd4bf', '#5eead4',\n] as const;\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":"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","names":[]}