@a-company/sentinel 3.5.0 → 3.6.0

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   loadConfig,
   loadServerConfig,
   writeConfig
-} from "./chunk-FOF7CPJ6.js";
+} from "./chunk-NTX74ZPM.js";
 
 // src/matcher.ts
 var DEFAULT_CONFIG = {
@@ -2195,6 +2195,152 @@ var PatternImporter = class {
     };
   }
 };
+
+// src/schema/builtin-paradigm.ts
+var PARADIGM_SCHEMA = {
+  id: "paradigm-logger",
+  version: "1.0.0",
+  name: "Paradigm Logger",
+  description: "Structured logs from @a-company/paradigm-logger with symbolic context",
+  scope: {
+    field: "correlationId",
+    type: "string",
+    label: "Correlation",
+    ordering: "independent",
+    sessionField: "sessionId"
+  },
+  eventTypes: [
+    {
+      type: "log:debug",
+      category: "logs",
+      label: "Debug Log",
+      severity: "debug",
+      frequency: "high",
+      fields: [
+        { name: "symbol", type: "string", indexed: true, display: true },
+        { name: "symbolType", type: "string", indexed: true, display: true },
+        { name: "message", type: "string", display: true },
+        { name: "service", type: "string", indexed: true, display: true },
+        { name: "durationMs", type: "number", display: true }
+      ]
+    },
+    {
+      type: "log:info",
+      category: "logs",
+      label: "Info Log",
+      severity: "info",
+      frequency: "high",
+      fields: [
+        { name: "symbol", type: "string", indexed: true, display: true },
+        { name: "symbolType", type: "string", indexed: true, display: true },
+        { name: "message", type: "string", display: true },
+        { name: "service", type: "string", indexed: true, display: true },
+        { name: "durationMs", type: "number", display: true }
+      ]
+    },
+    {
+      type: "log:warn",
+      category: "logs",
+      label: "Warning Log",
+      severity: "warn",
+      frequency: "medium",
+      fields: [
+        { name: "symbol", type: "string", indexed: true, display: true },
+        { name: "symbolType", type: "string", indexed: true, display: true },
+        { name: "message", type: "string", display: true },
+        { name: "service", type: "string", indexed: true, display: true }
+      ]
+    },
+    {
+      type: "log:error",
+      category: "logs",
+      label: "Error Log",
+      severity: "error",
+      frequency: "low",
+      fields: [
+        { name: "symbol", type: "string", indexed: true, display: true },
+        { name: "symbolType", type: "string", indexed: true, display: true },
+        { name: "message", type: "string", display: true },
+        { name: "service", type: "string", indexed: true, display: true }
+      ]
+    },
+    {
+      type: "metric:counter",
+      category: "metrics",
+      label: "Counter Metric",
+      severity: "info",
+      frequency: "high",
+      fields: [
+        { name: "name", type: "string", indexed: true, display: true },
+        { name: "value", type: "number", display: true },
+        { name: "tags", type: "object" }
+      ]
+    },
+    {
+      type: "metric:gauge",
+      category: "metrics",
+      label: "Gauge Metric",
+      severity: "info",
+      frequency: "medium",
+      fields: [
+        { name: "name", type: "string", indexed: true, display: true },
+        { name: "value", type: "number", display: true },
+        { name: "tags", type: "object" }
+      ]
+    },
+    {
+      type: "metric:histogram",
+      category: "metrics",
+      label: "Histogram Metric",
+      severity: "info",
+      frequency: "medium",
+      fields: [
+        { name: "name", type: "string", indexed: true, display: true },
+        { name: "value", type: "number", display: true },
+        { name: "tags", type: "object" }
+      ]
+    },
+    {
+      type: "trace:span",
+      category: "traces",
+      label: "Trace Span",
+      severity: "info",
+      frequency: "medium",
+      fields: [
+        { name: "traceId", type: "string", indexed: true, display: true },
+        { name: "spanId", type: "string", indexed: true },
+        { name: "operation", type: "string", display: true },
+        { name: "durationMs", type: "number", display: true },
+        { name: "status", type: "string", display: true }
+      ]
+    },
+    {
+      type: "incident:recorded",
+      category: "incidents",
+      label: "Incident Recorded",
+      severity: "error",
+      frequency: "low",
+      fields: [
+        { name: "incidentId", type: "string", indexed: true, display: true },
+        { name: "errorMessage", type: "string", display: true },
+        { name: "symbols", type: "object" },
+        { name: "environment", type: "string", display: true }
+      ]
+    }
+  ],
+  visualization: {
+    defaultView: "table",
+    categoryColors: {
+      logs: "#3b82f6",
+      metrics: "#22c55e",
+      traces: "#a855f7",
+      incidents: "#ef4444"
+    },
+    summaryFields: ["symbol", "message", "service"],
+    defaultExcluded: ["log:debug"]
+  },
+  tags: ["builtin", "paradigm"]
+};
 export {
   ContextEnricher,
   DEFAULT_AUTH_CONFIG,
@@ -2202,6 +2348,7 @@ export {
   DEFAULT_SERVER_CONFIG,
   FlowTracker,
   IncidentGrouper,
+  PARADIGM_SCHEMA,
   PatternImporter,
   PatternMatcher,
   PatternSuggester,

package/dist/mcp.js

@@ -13,7 +13,7 @@ import initSqlJs from "sql.js";
 import { v4 as uuidv4 } from "uuid";
 import * as path from "path";
 import * as fs from "fs";
-var SCHEMA_VERSION = 4;
+var SCHEMA_VERSION = 5;
 var DEFAULT_CONFIDENCE = {
   score: 50,
   timesMatched: 0,
@@ -444,6 +444,54 @@ var SentinelStorage = class {
       this.db.run(
         "INSERT OR REPLACE INTO metadata (key, value) VALUES ('schema_version', '4')"
       );
+      currentVersion = 4;
+    }
+    if (currentVersion < 5) {
+      try {
+        this.db.run(`
+          CREATE TABLE IF NOT EXISTS schemas (
+            id TEXT PRIMARY KEY,
+            version TEXT NOT NULL,
+            name TEXT NOT NULL,
+            description TEXT,
+            scope_json TEXT NOT NULL,
+            event_types_json TEXT NOT NULL,
+            causality_json TEXT,
+            visualization_json TEXT,
+            tags_json TEXT DEFAULT '[]',
+            registered_at TEXT NOT NULL,
+            updated_at TEXT NOT NULL
+          );
+
+          CREATE TABLE IF NOT EXISTS events (
+            id TEXT PRIMARY KEY,
+            schema_id TEXT NOT NULL,
+            event_type TEXT NOT NULL,
+            category TEXT NOT NULL,
+            timestamp TEXT NOT NULL,
+            scope_value TEXT,
+            scope_ordinal INTEGER,
+            session_id TEXT,
+            service TEXT NOT NULL,
+            data_json TEXT,
+            severity TEXT DEFAULT 'info',
+            parent_event_id TEXT,
+            depth INTEGER DEFAULT 0
+          );
+
+          CREATE INDEX IF NOT EXISTS idx_events_schema ON events(schema_id);
+          CREATE INDEX IF NOT EXISTS idx_events_type ON events(event_type);
+          CREATE INDEX IF NOT EXISTS idx_events_scope ON events(schema_id, scope_value);
+          CREATE INDEX IF NOT EXISTS idx_events_scope_ord ON events(schema_id, scope_ordinal);
+          CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id);
+          CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+          CREATE INDEX IF NOT EXISTS idx_events_service ON events(service);
+        `);
+      } catch {
+      }
+      this.db.run(
+        "INSERT OR REPLACE INTO metadata (key, value) VALUES ('schema_version', '5')"
+      );
     }
   }
   /**
@@ -2032,6 +2080,341 @@ var SentinelStorage = class {
       logs: obj.log_ids_json ? JSON.parse(obj.log_ids_json) : []
     };
   }
+  // ─── Schema Registry ─────────────────────────────────────────────
+  registerSchema(schema) {
+    this.initializeSync();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      `INSERT INTO schemas (
+        id, version, name, description, scope_json, event_types_json,
+        causality_json, visualization_json, tags_json, registered_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         version = excluded.version,
+         name = excluded.name,
+         description = excluded.description,
+         scope_json = excluded.scope_json,
+         event_types_json = excluded.event_types_json,
+         causality_json = excluded.causality_json,
+         visualization_json = excluded.visualization_json,
+         tags_json = excluded.tags_json,
+         updated_at = excluded.updated_at`,
+      [
+        schema.id,
+        schema.version,
+        schema.name,
+        schema.description || null,
+        JSON.stringify(schema.scope),
+        JSON.stringify(schema.eventTypes),
+        schema.causality ? JSON.stringify(schema.causality) : null,
+        schema.visualization ? JSON.stringify(schema.visualization) : null,
+        JSON.stringify(schema.tags || []),
+        now,
+        now
+      ]
+    );
+    this.save();
+    return {
+      id: schema.id,
+      version: schema.version,
+      name: schema.name,
+      description: schema.description,
+      scope: schema.scope,
+      eventTypes: schema.eventTypes,
+      causality: schema.causality,
+      visualization: schema.visualization,
+      tags: schema.tags || [],
+      registeredAt: now,
+      updatedAt: now
+    };
+  }
+  getSchema(id) {
+    this.initializeSync();
+    const result = this.db.exec("SELECT * FROM schemas WHERE id = ?", [id]);
+    if (result.length === 0 || result[0].values.length === 0) return null;
+    return this.rowToSchema(result[0].columns, result[0].values[0]);
+  }
+  listSchemas() {
+    this.initializeSync();
+    const result = this.db.exec("SELECT * FROM schemas ORDER BY name ASC");
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToSchema(result[0].columns, row)
+    );
+  }
+  rowToSchema(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    return {
+      id: obj.id,
+      version: obj.version,
+      name: obj.name,
+      description: obj.description || void 0,
+      scope: JSON.parse(obj.scope_json),
+      eventTypes: JSON.parse(obj.event_types_json),
+      causality: obj.causality_json ? JSON.parse(obj.causality_json) : void 0,
+      visualization: obj.visualization_json ? JSON.parse(obj.visualization_json) : void 0,
+      tags: JSON.parse(obj.tags_json || "[]"),
+      registeredAt: obj.registered_at,
+      updatedAt: obj.updated_at
+    };
+  }
+  // ─── Generic Events ────────────────────────────────────────────
+  insertEventBatch(schemaId, service, inputs) {
+    this.initializeSync();
+    const schema = this.getSchema(schemaId);
+    const typeMap = /* @__PURE__ */ new Map();
+    if (schema) {
+      for (const et of schema.eventTypes) {
+        typeMap.set(et.type, {
+          category: et.category,
+          severity: et.severity || "info"
+        });
+      }
+    }
+    let accepted = 0;
+    const errors = [];
+    for (const input of inputs) {
+      try {
+        const id = input.id || uuidv4();
+        const timestamp = input.timestamp || (/* @__PURE__ */ new Date()).toISOString();
+        const resolved = typeMap.get(input.type);
+        const category = resolved?.category || "unknown";
+        const severity = input.severity || resolved?.severity || "info";
+        const scopeValue = input.scopeValue != null ? String(input.scopeValue) : null;
+        const scopeOrdinal = typeof input.scopeValue === "number" ? input.scopeValue : null;
+        this.db.run(
+          `INSERT INTO events (
+            id, schema_id, event_type, category, timestamp, scope_value,
+            scope_ordinal, session_id, service, data_json, severity,
+            parent_event_id, depth
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          [
+            id,
+            schemaId,
+            input.type,
+            category,
+            timestamp,
+            scopeValue,
+            scopeOrdinal,
+            input.sessionId || null,
+            service,
+            input.data ? JSON.stringify(input.data) : null,
+            severity,
+            input.parentEventId || null,
+            input.depth ?? 0
+          ]
+        );
+        accepted++;
+      } catch (err) {
+        errors.push(err instanceof Error ? err.message : String(err));
+      }
+    }
+    this.save();
+    return { accepted, errors };
+  }
+  queryEvents(options = {}) {
+    this.initializeSync();
+    const { limit = 100, offset = 0 } = options;
+    const conditions = [];
+    const params = [];
+    if (options.schemaId) {
+      conditions.push("schema_id = ?");
+      params.push(options.schemaId);
+    }
+    if (options.eventType) {
+      conditions.push("event_type = ?");
+      params.push(options.eventType);
+    }
+    if (options.category) {
+      conditions.push("category = ?");
+      params.push(options.category);
+    }
+    if (options.service) {
+      conditions.push("service = ?");
+      params.push(options.service);
+    }
+    if (options.sessionId) {
+      conditions.push("session_id = ?");
+      params.push(options.sessionId);
+    }
+    if (options.scopeValue) {
+      conditions.push("scope_value = ?");
+      params.push(options.scopeValue);
+    }
+    if (options.scopeFrom) {
+      conditions.push("scope_value >= ?");
+      params.push(options.scopeFrom);
+    }
+    if (options.scopeTo) {
+      conditions.push("scope_value <= ?");
+      params.push(options.scopeTo);
+    }
+    if (options.severity) {
+      conditions.push("severity = ?");
+      params.push(options.severity);
+    }
+    if (options.since) {
+      conditions.push("timestamp >= ?");
+      params.push(options.since);
+    }
+    if (options.until) {
+      conditions.push("timestamp <= ?");
+      params.push(options.until);
+    }
+    if (options.search) {
+      conditions.push("data_json LIKE ?");
+      params.push(`%${options.search}%`);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT * FROM events ${whereClause} ORDER BY timestamp DESC LIMIT ? OFFSET ?`,
+      [...params, limit, offset]
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToGenericEvent(result[0].columns, row)
+    );
+  }
+  queryEventsByScope(schemaId, scopeValue) {
+    this.initializeSync();
+    const result = this.db.exec(
+      `SELECT * FROM events
+       WHERE schema_id = ? AND scope_value = ?
+       ORDER BY timestamp ASC`,
+      [schemaId, scopeValue]
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToGenericEvent(result[0].columns, row)
+    );
+  }
+  getEventScopes(schemaId, options = {}) {
+    this.initializeSync();
+    const { limit = 100, offset = 0 } = options;
+    const conditions = ["schema_id = ?"];
+    const params = [schemaId];
+    if (options.sessionId) {
+      conditions.push("session_id = ?");
+      params.push(options.sessionId);
+    }
+    const whereClause = `WHERE ${conditions.join(" AND ")}`;
+    const result = this.db.exec(
+      `SELECT
+        scope_value,
+        MIN(scope_ordinal) as scope_ordinal,
+        COUNT(*) as event_count,
+        MIN(timestamp) as first_timestamp,
+        MAX(timestamp) as last_timestamp
+       FROM events
+       ${whereClause}
+       AND scope_value IS NOT NULL
+       GROUP BY scope_value
+       ORDER BY MIN(COALESCE(scope_ordinal, 0)) DESC, MIN(timestamp) DESC
+       LIMIT ? OFFSET ?`,
+      [...params, limit, offset]
+    );
+    if (result.length === 0) return [];
+    const scopes = [];
+    for (const row of result[0].values) {
+      const scopeValue = row[0];
+      const scopeOrdinal = row[1] != null ? row[1] : void 0;
+      const eventCount = row[2];
+      const firstTimestamp = row[3];
+      const lastTimestamp = row[4];
+      const catResult = this.db.exec(
+        `SELECT category, COUNT(*) as count FROM events
+         WHERE schema_id = ? AND scope_value = ?
+         GROUP BY category`,
+        [schemaId, scopeValue]
+      );
+      const categories = {};
+      if (catResult.length > 0) {
+        for (const catRow of catResult[0].values) {
+          categories[catRow[0]] = catRow[1];
+        }
+      }
+      scopes.push({
+        scopeValue,
+        scopeOrdinal,
+        eventCount,
+        categories,
+        firstTimestamp,
+        lastTimestamp
+      });
+    }
+    return scopes;
+  }
+  getEventCount(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.schemaId) {
+      conditions.push("schema_id = ?");
+      params.push(options.schemaId);
+    }
+    if (options.eventType) {
+      conditions.push("event_type = ?");
+      params.push(options.eventType);
+    }
+    if (options.service) {
+      conditions.push("service = ?");
+      params.push(options.service);
+    }
+    if (options.since) {
+      conditions.push("timestamp >= ?");
+      params.push(options.since);
+    }
+    if (options.until) {
+      conditions.push("timestamp <= ?");
+      params.push(options.until);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT COUNT(*) as count FROM events ${whereClause}`,
+      params
+    );
+    if (result.length === 0 || result[0].values.length === 0) return 0;
+    return result[0].values[0][0];
+  }
+  pruneEvents(maxCount) {
+    this.initializeSync();
+    if (maxCount <= 0) return 0;
+    const currentCount = this.getEventCount();
+    if (currentCount <= maxCount) return 0;
+    const deleteCount = currentCount - maxCount;
+    this.db.run(
+      `DELETE FROM events WHERE id IN (
+        SELECT id FROM events ORDER BY timestamp ASC LIMIT ?
+      )`,
+      [deleteCount]
+    );
+    this.save();
+    return deleteCount;
+  }
+  rowToGenericEvent(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    return {
+      id: obj.id,
+      schemaId: obj.schema_id,
+      eventType: obj.event_type,
+      category: obj.category,
+      timestamp: obj.timestamp,
+      scopeValue: obj.scope_value || void 0,
+      scopeOrdinal: obj.scope_ordinal != null ? obj.scope_ordinal : void 0,
+      sessionId: obj.session_id || void 0,
+      service: obj.service,
+      data: obj.data_json ? JSON.parse(obj.data_json) : void 0,
+      severity: obj.severity || "info",
+      parentEventId: obj.parent_event_id || void 0,
+      depth: obj.depth || 0
+    };
+  }
   close() {
     if (this.db) {
       this.save();

package/dist/{sdk-BTblv--p.d.ts → sdk-CzFDYYST.d.ts}

@@ -1,4 +1,4 @@
-import { S as SentinelStorage } from './storage-BqCJqZat.js';
+import { S as SentinelStorage } from './storage-BKyt7aPJ.js';
 import { a as SymbolicIncidentRecord, K as MatcherConfig, X as PatternMatch, e as FailurePattern, a2 as PatternTestResult, ae as SentinelConfig, C as ComponentContext, al as SymbolicContext, u as FlowPosition } from './types-BmVoO1iF.js';
 
 /**

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import { Express } from 'express';
-import { S as SentinelStorage } from '../storage-BqCJqZat.js';
+import { S as SentinelStorage, G as GenericEvent } from '../storage-BKyt7aPJ.js';
 import { S as SentinelServerConfig, L as LogEntry } from '../types-BmVoO1iF.js';
 
 /**
@@ -89,6 +89,7 @@ declare function createApp(options: ServerOptions & {
         known: boolean;
         suggestion?: string;
     }) => void;
+    onEventReceived?: (event: GenericEvent) => void;
 }): Express;
 /**
  * Start the Sentinel server with WebSocket support