@a-company/sentinel 0.2.0 → 3.6.0

package/dist/{sdk-B27_vK1g.d.ts → types-BmVoO1iF.d.ts}

@@ -74,7 +74,7 @@ type CreateIncidentInput = Omit<SymbolicIncidentRecord, 'id' | 'notes' | 'relate
     status?: IncidentStatus;
 };
 type PatternSource = 'manual' | 'suggested' | 'imported' | 'community';
-type ResolutionStrategy = 'retry' | 'fallback' | 'fix-data' | 'fix-code' | 'ignore' | 'escalate';
+type ResolutionStrategy = 'retry' | 'fallback' | 'fix-data' | 'fix-code' | 'rollback' | 'config-change' | 'scale-up' | 'investigate' | 'ignore' | 'escalate';
 type PatternPriority = 'low' | 'medium' | 'high' | 'critical';
 /**
  * Symbol criteria for pattern matching
@@ -378,267 +378,204 @@ interface PracticeEventQuery {
     limit?: number;
     offset?: number;
 }
-
-/**
- * Paradigm Sentinel - SQLite Storage Layer
- *
- * Persistent storage for incidents, patterns, groups, and resolutions.
- * Uses sql.js for pure JavaScript SQLite (no native compilation needed).
- */
-
-declare class SentinelStorage {
-    private db;
-    private dbPath;
-    private incidentCounter;
-    private initialized;
-    constructor(dbPath?: string);
-    private getDefaultDbPath;
-    private createSchema;
-    private save;
-    recordIncident(input: CreateIncidentInput): string;
-    private initializeSync;
-    /**
-     * Run schema migrations from older versions
-     */
-    private migrateSchema;
-    /**
-     * Ensure the storage is ready for use. Must be called once before using storage methods.
-     */
-    ensureReady(): Promise<void>;
-    getIncident(id: string): SymbolicIncidentRecord | null;
-    getRecentIncidents(options?: IncidentQueryOptions): SymbolicIncidentRecord[];
-    updateIncident(id: string, updates: Partial<SymbolicIncidentRecord>): void;
-    addIncidentNote(incidentId: string, note: Omit<IncidentNote, 'id'>): void;
-    linkIncidents(incidentId: string, relatedId: string): void;
-    getIncidentCount(options?: IncidentQueryOptions): number;
-    addPattern(input: CreatePatternInput): string;
-    getPattern(id: string): FailurePattern | null;
-    getAllPatterns(options?: PatternQueryOptions): FailurePattern[];
-    updatePattern(id: string, updates: Partial<FailurePattern>): void;
-    deletePattern(id: string): void;
-    updatePatternConfidence(patternId: string, event: 'matched' | 'resolved' | 'recurred'): void;
-    createGroup(input: CreateGroupInput): string;
-    getGroup(id: string): IncidentGroup | null;
-    getGroups(options?: {
-        limit?: number;
-    }): IncidentGroup[];
-    addToGroup(groupId: string, incidentId: string): void;
-    recordResolution(resolution: {
-        incidentId: string;
-        patternId?: string;
-        commitHash?: string;
-        prUrl?: string;
-        notes?: string;
-    }): void;
-    markRecurred(incidentId: string): void;
-    getResolutionHistory(options?: ResolutionQueryOptions): ResolutionRecord[];
-    getStats(period: {
-        start: string;
-        end: string;
-    }): SentinelStats;
-    getSymbolHealth(symbol: string): SymbolHealth;
-    exportPatterns(options?: {
-        includePrivate?: boolean;
-    }): PatternExport;
-    importPatterns(data: PatternExport, options?: {
-        overwrite?: boolean;
-    }): {
-        imported: number;
-        skipped: number;
-    };
-    exportBackup(): BackupExport;
-    importBackup(data: BackupExport): void;
-    private rowToIncident;
-    private rowToPattern;
-    private rowToGroup;
-    recordPracticeEvent(input: PracticeEventInput): string;
-    getPracticeEvents(options?: PracticeEventQuery): PracticeEvent[];
-    getPracticeEventCount(options?: PracticeEventQuery): number;
-    getComplianceRate(options?: PracticeEventQuery): {
-        total: number;
-        followed: number;
-        skipped: number;
-        partial: number;
-        rate: number;
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogSymbolType = 'component' | 'gate' | 'signal' | 'flow' | 'aspect' | 'raw';
+interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    symbol: string;
+    symbolType: LogSymbolType;
+    message: string;
+    data?: Record<string, unknown>;
+    service: string;
+    sessionId?: string;
+    correlationId?: string;
+    durationMs?: number;
+    environment?: string;
+}
+interface LogEntryInput {
+    id?: string;
+    timestamp?: string;
+    level: LogLevel;
+    symbol: string;
+    symbolType?: LogSymbolType;
+    message: string;
+    data?: Record<string, unknown>;
+    service: string;
+    sessionId?: string;
+    correlationId?: string;
+    durationMs?: number;
+    environment?: string;
+}
+interface LogQueryOptions {
+    level?: LogLevel;
+    symbol?: string;
+    service?: string;
+    sessionId?: string;
+    correlationId?: string;
+    search?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+}
+interface ServiceInfo {
+    name: string;
+    version?: string;
+    pid?: number;
+    startedAt: string;
+    lastSeenAt: string;
+    environment?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ServiceRegistration {
+    name: string;
+    version?: string;
+    pid?: number;
+    environment?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AppState {
+    service: string;
+    sessionId: string;
+    timestamp: string;
+    state: Record<string, unknown>;
+    activeFlows?: string[];
+    activeGates?: string[];
+}
+interface SymbolValidationResult {
+    symbol: string;
+    known: boolean;
+    type?: string;
+    definedIn?: string;
+    suggestion?: string;
+}
+interface CorsConfig {
+    origin?: string | string[];
+    credentials?: boolean;
+}
+interface SentinelServerConfig {
+    port: number;
+    maxLogs: number;
+    maxBatchSize: number;
+    wsMaxSubscribers: number;
+    pruneIntervalInserts: number;
+    logRetentionDays: number;
+    auth: AuthConfig;
+    rateLimit: RateLimitConfig;
+    cors?: CorsConfig;
+    tls?: {
+        cert: string;
+        key: string;
     };
-    private rowToPracticeEvent;
-    close(): void;
 }
-
-/**
- * Paradigm Sentinel - Pattern Matching Engine
- *
- * Matches incidents against failure patterns using symbolic context,
- * error text, and missing signals.
- */
-
-declare class PatternMatcher {
-    private storage;
-    constructor(storage: SentinelStorage);
-    /**
-     * Match an incident against all patterns and return ranked results
-     */
-    match(incident: SymbolicIncidentRecord, config?: Partial<MatcherConfig>): PatternMatch[];
-    /**
-     * Test a pattern against historical incidents
-     */
-    testPattern(pattern: FailurePattern, limit?: number): PatternTestResult;
-    /**
-     * Score how well a pattern matches an incident
-     */
-    private scoreMatch;
-    /**
-     * Match symbols between pattern and incident
-     */
-    private matchSymbols;
-    /**
-     * Match a single symbol value (supports wildcards)
-     */
-    private matchSingleSymbol;
-    /**
-     * Match error text keywords and regex
-     */
-    private matchErrorText;
-    /**
-     * Match missing signals from flow position
-     */
-    private matchMissingSignals;
-    /**
-     * Check if pattern's environment filter matches incident
-     */
-    private matchEnvironment;
+interface AuthConfig {
+    enabled: boolean;
+    tokens: AuthToken[];
 }
-
-/**
- * Sentinel SDK
- *
- * The developer-facing API for capturing errors with symbolic context.
- * Wraps the core storage and pattern matching engine.
- *
- * Usage:
- *   import { Sentinel } from '@a-company/sentinel';
- *   const sentinel = new Sentinel({ project: 'my-app' });
- *   sentinel.capture(new Error('Payment failed'), { component: '#checkout' });
- */
-
-/**
- * Flow tracker for monitoring multi-step flows.
- *
- * Usage:
- *   const flow = sentinel.flow('$checkout-flow');
- *   flow.expect('!payment-authorized', '!order-created');
- *   flow.gate('^authenticated', true);
- *   flow.signal('!payment-authorized');
- *   flow.complete();
- */
-declare class FlowTracker {
-    private flowId;
-    private sentinel;
-    private actual;
-    private expected;
-    private completed;
-    constructor(flowId: string, sentinel: Sentinel);
-    /** Declare which signals/gates are expected in this flow */
-    expect(...symbols: string[]): this;
-    /** Record a generic step in the flow */
-    step(symbol: string): this;
-    /** Record a gate check result */
-    gate(id: string, passed: boolean): this;
-    /** Record a signal emission */
-    signal(id: string, _data?: object): this;
-    /** Mark the flow as successfully completed */
-    complete(): void;
-    /** Capture an error with full flow position context */
-    fail(error: Error): void;
+interface AuthToken {
+    id: string;
+    name: string;
+    token: string;
+    permissions: AuthPermission[];
+    createdAt: string;
+    expiresAt?: string;
 }
-/**
- * The main Sentinel SDK class.
- *
- * Usage:
- *   const sentinel = new Sentinel({ project: 'my-app', environment: 'production' });
- *
- *   // Capture errors with symbolic context
- *   sentinel.capture(error, { component: '#checkout', gate: '^payment-validated' });
- *
- *   // Component context for scoped captures
- *   const ctx = sentinel.component('#checkout');
- *   ctx.capture(error);
- *
- *   // Flow tracking
- *   const flow = sentinel.flow('$checkout-flow');
- *   flow.gate('^authenticated', true);
- *   flow.signal('!payment-authorized');
- *   flow.complete();
- */
-declare class Sentinel {
-    private storage;
-    private matcher;
-    private config;
-    private ready;
-    private readyPromise;
-    private seeded;
-    constructor(config: SentinelConfig);
-    /** Explicitly initialize storage. Optional — auto-called on first capture. */
-    init(): Promise<void>;
-    private doInit;
-    private ensureReady;
-    /**
-     * Create a component context for scoped error capture.
-     *
-     * @param id - Component symbol (e.g. '#checkout' or 'checkout')
-     * @returns ComponentContext with capture() and wrap() methods
-     */
-    component(id: string): ComponentContext;
-    /**
-     * Record a gate check result.
-     * If the gate fails, auto-captures an incident.
-     *
-     * @param id - Gate symbol (e.g. '^authenticated' or 'authenticated')
-     * @param passed - Whether the gate passed
-     */
-    gate(id: string, passed: boolean): void;
-    /**
-     * Record a signal emission. Primarily for flow tracking context.
-     *
-     * @param id - Signal symbol (e.g. '!payment-authorized' or 'payment-authorized')
-     */
-    signal(id: string, _data?: object): void;
-    /**
-     * Create a flow tracker for monitoring multi-step operations.
-     *
-     * @param id - Flow symbol (e.g. '$checkout-flow' or 'checkout-flow')
-     * @returns FlowTracker instance
-     */
-    flow(id: string): FlowTracker;
-    /**
-     * Capture an error with symbolic context.
-     *
-     * @param error - The error to capture
-     * @param context - Symbolic context (component, gate, flow, signal)
-     * @param flowPosition - Optional flow position data
-     * @returns Incident ID (e.g. 'INC-001')
-     */
-    capture(error: Error, context?: Partial<SymbolicContext>, flowPosition?: FlowPosition): string;
-    /**
-     * Get pattern matches for a captured incident.
-     *
-     * @param incidentId - The incident ID to match
-     * @returns Array of pattern matches sorted by confidence
-     */
-    match(incidentId: string): PatternMatch[];
-    /**
-     * Create Express error-handling middleware.
-     *
-     * Usage:
-     *   app.use(sentinel.express());
-     */
-    express(): any;
-    /** Close the database connection. Call when shutting down. */
-    close(): void;
-    /** Get the underlying storage instance (for advanced usage). */
-    getStorage(): SentinelStorage;
-    /** Get the underlying pattern matcher (for advanced usage). */
-    getMatcher(): PatternMatcher;
+type AuthPermission = 'read' | 'write' | 'admin';
+declare const DEFAULT_AUTH_CONFIG: AuthConfig;
+type MetricType = 'counter' | 'gauge' | 'histogram';
+interface MetricEntry {
+    id: string;
+    timestamp: string;
+    name: string;
+    type: MetricType;
+    value: number;
+    tags: Record<string, string>;
+    service: string;
+    environment?: string;
+}
+interface MetricInput {
+    name: string;
+    type: MetricType;
+    value: number;
+    tags?: Record<string, string>;
+    service: string;
+    timestamp?: string;
+    environment?: string;
+}
+interface MetricQueryOptions {
+    name?: string;
+    type?: MetricType;
+    service?: string;
+    tag?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+}
+interface MetricAggregation {
+    name: string;
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+    p50?: number;
+    p95?: number;
+    p99?: number;
+}
+interface HistogramBucket {
+    le: number;
+    count: number;
+}
+interface RateLimitConfig {
+    enabled: boolean;
+    global: RateLimitRule;
+    perService: Record<string, RateLimitRule>;
+}
+interface RateLimitRule {
+    maxRequestsPerMinute: number;
+    maxEntriesPerBatch: number;
+    samplingRate: number;
+}
+declare const DEFAULT_RATE_LIMIT_CONFIG: RateLimitConfig;
+declare const DEFAULT_SERVER_CONFIG: SentinelServerConfig;
+interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    service: string;
+    symbol: string;
+    operation: string;
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    status: 'ok' | 'error';
+    tags: Record<string, string>;
+    logs: string[];
+}
+interface TraceSpanInput {
+    traceId: string;
+    spanId?: string;
+    parentSpanId?: string;
+    service: string;
+    symbol: string;
+    operation: string;
+    startTime?: string;
+    endTime?: string;
+    durationMs?: number;
+    status?: 'ok' | 'error';
+    tags?: Record<string, string>;
+    logIds?: string[];
+}
+interface TraceView {
+    traceId: string;
+    spans: TraceSpan[];
+    services: string[];
+    totalDurationMs: number;
+    startTime: string;
+    endTime: string;
 }
 
-export { type SymbolResolutionTime as $, type PatternRecurrence as A, type BackupExport as B, type ComponentContext as C, type DayCount as D, type EnrichedIncident as E, type FlowTimeline as F, type PatternResolution as G, type PatternSource as H, type IncidentGroup as I, type PatternSymbolCriteria as J, type PatternTestResult as K, type PracticeCategory as L, type MatchedCriteria as M, type PracticeEvent as N, type PracticeEventInput as O, type PatternCandidate as P, type PracticeEventQuery as Q, type PracticeResult as R, SentinelStorage as S, type Resolution as T, type ResolutionQueryOptions as U, type ResolutionRecord as V, type ResolutionStrategy as W, Sentinel as X, type SentinelConfig as Y, type SymbolHotspot as Z, type SymbolIncidentCount as _, type SymbolicIncidentRecord as a, type SymbolicContext as a0, type SentinelStats as b, type SymbolHealth as c, type SymbolEnrichment as d, type FailurePattern as e, type PatternExport as f, type CreateGroupInput as g, type CreateIncidentInput as h, type CreatePatternInput as i, type Environment as j, type ErrorDetails as k, type FlowEvent as l, type FlowEventType as m, type FlowPosition as n, FlowTracker as o, type IncidentNote as p, type IncidentQueryOptions as q, type IncidentStatus as r, type MatcherConfig as s, type PatternConfidence as t, type PatternCriteria as u, type PatternEffectiveness as v, type PatternMatch as w, PatternMatcher as x, type PatternPriority as y, type PatternQueryOptions as z };
+export { type PatternResolution as $, type AppState as A, type BackupExport as B, type ComponentContext as C, DEFAULT_AUTH_CONFIG as D, type EnrichedIncident as E, type FlowTimeline as F, type LogQueryOptions as G, type HistogramBucket as H, type IncidentGroup as I, type LogSymbolType as J, type MatcherConfig as K, type LogEntry as L, type MatchedCriteria as M, type MetricAggregation as N, type MetricEntry as O, type PatternCandidate as P, type MetricInput as Q, type MetricQueryOptions as R, type SentinelServerConfig as S, type MetricType as T, type PatternConfidence as U, type PatternCriteria as V, type PatternEffectiveness as W, type PatternMatch as X, type PatternPriority as Y, type PatternQueryOptions as Z, type PatternRecurrence as _, type SymbolicIncidentRecord as a, type PatternSource as a0, type PatternSymbolCriteria as a1, type PatternTestResult as a2, type PracticeCategory as a3, type PracticeEvent as a4, type PracticeEventInput as a5, type PracticeEventQuery as a6, type PracticeResult as a7, type RateLimitConfig as a8, type RateLimitRule as a9, type Resolution as aa, type ResolutionQueryOptions as ab, type ResolutionRecord as ac, type ResolutionStrategy as ad, type SentinelConfig as ae, type ServiceInfo as af, type ServiceRegistration as ag, type SymbolHotspot as ah, type SymbolIncidentCount as ai, type SymbolResolutionTime as aj, type SymbolValidationResult as ak, type SymbolicContext as al, type TraceSpan as am, type TraceSpanInput as an, type TraceView as ao, type SentinelStats as b, type SymbolHealth as c, type SymbolEnrichment as d, type FailurePattern as e, type PatternExport as f, type AuthConfig as g, type AuthPermission as h, type AuthToken as i, type CorsConfig as j, type CreateGroupInput as k, type CreateIncidentInput as l, type CreatePatternInput as m, DEFAULT_RATE_LIMIT_CONFIG as n, DEFAULT_SERVER_CONFIG as o, type DayCount as p, type Environment as q, type ErrorDetails as r, type FlowEvent as s, type FlowEventType as t, type FlowPosition as u, type IncidentNote as v, type IncidentQueryOptions as w, type IncidentStatus as x, type LogEntryInput as y, type LogLevel as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-company/sentinel",
-  "version": "0.2.0",
+  "version": "3.6.0",
   "description": "Semantic error monitoring — errors that speak your language",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,6 +29,18 @@
     "./hono": {
       "types": "./dist/adapters/hono.d.ts",
       "import": "./dist/adapters/hono.js"
+    },
+    "./transport": {
+      "types": "./dist/transport.d.ts",
+      "import": "./dist/transport.js"
+    }
+  },
+  "peerDependencies": {
+    "@a-company/paradigm-logger": ">=1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@a-company/paradigm-logger": {
+      "optional": true
     }
   },
   "files": [
@@ -53,6 +65,7 @@
     "simple-git": "^3.22.0",
     "sql.js": "^1.10.3",
     "uuid": "^9.0.0",
+    "ws": "^8.19.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {
@@ -61,6 +74,7 @@
     "@types/react": "^18.2.45",
     "@types/react-dom": "^18.2.18",
     "@types/uuid": "^9.0.7",
+    "@types/ws": "^8.18.1",
     "@vitejs/plugin-react": "^4.2.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",