@yoda.digital/iris-gateway 1.13.3

package/dist/intelligence/goals/lifecycle.js

@@ -0,0 +1,135 @@
+/**
+ * Goal lifecycle manager.
+ * Handles goal state transitions (active → paused → completed/abandoned),
+ * due-goal scanning, and prompt context generation.
+ *
+ * State machine:
+ *   active  → paused | completed | abandoned
+ *   paused  → active | abandoned
+ *   completed (terminal)
+ *   abandoned (terminal)
+ */
+export class GoalLifecycle {
+    store;
+    bus;
+    logger;
+    constructor(store, bus, logger) {
+        this.store = store;
+        this.bus = bus;
+        this.logger = logger;
+    }
+    /**
+     * Create a new goal for a user.
+     */
+    create(params) {
+        const goal = this.store.createGoal(params);
+        this.bus.emit({ type: "goal_created", senderId: params.senderId, goal });
+        this.logger.info({ goalId: goal.id, description: params.description }, "Goal created");
+        return goal;
+    }
+    /**
+     * Update goal progress. Adds a progress note and optionally changes next action.
+     */
+    progress(goalId, note, nextAction, nextActionDue) {
+        return this.store.updateGoal(goalId, {
+            progressNote: note,
+            nextAction: nextAction ?? undefined,
+            nextActionDue: nextActionDue ?? undefined,
+        });
+    }
+    /**
+     * Transition goal status with validation.
+     */
+    transition(goalId, newStatus) {
+        const goal = this.store.getGoal(goalId);
+        if (!goal)
+            return null;
+        // Validate transition
+        if (!this.isValidTransition(goal.status, newStatus)) {
+            this.logger.warn({ goalId, from: goal.status, to: newStatus }, "Invalid goal status transition");
+            return null;
+        }
+        return this.store.updateGoal(goalId, { status: newStatus });
+    }
+    /**
+     * Scan for goals with due next-actions.
+     * Returns goals that need attention now.
+     */
+    scanDueGoals() {
+        const dueGoals = this.store.getDueGoals();
+        for (const goal of dueGoals) {
+            this.bus.emit({ type: "goal_due", senderId: goal.senderId, goalId: goal.id });
+        }
+        return dueGoals;
+    }
+    /**
+     * Scan for stale goals (no updates in 30+ days).
+     * These may need a check-in or abandonment.
+     */
+    scanStaleGoals() {
+        return this.store.getStaleGoals();
+    }
+    /**
+     * Get goal context formatted for prompt injection.
+     */
+    getGoalContext(senderId, userLanguage) {
+        const active = this.store.getActiveGoals(senderId);
+        const paused = this.store.getPausedGoals(senderId);
+        if (active.length === 0 && paused.length === 0)
+            return null;
+        const lines = ["[USER GOALS]"];
+        if (userLanguage) {
+            lines.push(`[LANGUAGE: Always create and update goals in ${userLanguage}. User communicates in ${userLanguage}. Never use English for goals unless user writes in English.]`);
+        }
+        if (active.length > 0) {
+            lines.push("Active:");
+            for (const g of active.slice(0, 5)) {
+                const due = g.nextActionDue ? ` (next: ${this.formatDue(g.nextActionDue)})` : "";
+                const priority = g.priority > 70 ? " [HIGH]" : g.priority < 30 ? " [low]" : "";
+                lines.push(`  - ${g.description}${priority}${due}`);
+                if (g.nextAction) {
+                    lines.push(`    Next action: ${g.nextAction}`);
+                }
+                if (g.successCriteria) {
+                    lines.push(`    Success: ${g.successCriteria}`);
+                }
+            }
+        }
+        if (paused.length > 0) {
+            lines.push("Paused:");
+            for (const g of paused.slice(0, 3)) {
+                lines.push(`  - ${g.description}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Get all goals for a user (for tool server list endpoint).
+     */
+    listGoals(senderId) {
+        return {
+            active: this.store.getActiveGoals(senderId),
+            paused: this.store.getPausedGoals(senderId),
+        };
+    }
+    isValidTransition(from, to) {
+        const TRANSITIONS = {
+            active: ["paused", "completed", "abandoned"],
+            paused: ["active", "abandoned"],
+            completed: [],
+            abandoned: [],
+        };
+        return TRANSITIONS[from].includes(to);
+    }
+    formatDue(timestamp) {
+        const diff = timestamp - Date.now();
+        if (diff < 0)
+            return "overdue";
+        const hours = Math.floor(diff / 3_600_000);
+        if (hours < 24)
+            return `${hours}h`;
+        const days = Math.floor(hours / 24);
+        return `${days}d`;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/intelligence/goals/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/intelligence/goals/lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/intelligence/goals/store.d.ts

@@ -0,0 +1,30 @@
+import type { VaultDB } from "../../vault/db.js";
+import type { Goal, GoalStatus } from "../types.js";
+export declare class GoalsStore {
+    private readonly db;
+    constructor(vaultDb: VaultDB);
+    createGoal(params: {
+        senderId: string;
+        channelId: string;
+        description: string;
+        arcId?: string;
+        successCriteria?: string;
+        nextAction?: string;
+        nextActionDue?: number;
+        priority?: number;
+    }): Goal;
+    getGoal(id: string): Goal | null;
+    getActiveGoals(senderId: string): Goal[];
+    getPausedGoals(senderId: string): Goal[];
+    getDueGoals(): Goal[];
+    updateGoal(id: string, params: {
+        progressNote?: string;
+        nextAction?: string | null;
+        nextActionDue?: number | null;
+        priority?: number;
+        status?: GoalStatus;
+    }): Goal | null;
+    getStaleGoals(defaultStaleDays?: number): Goal[];
+    private toGoal;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/intelligence/goals/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/intelligence/goals/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqBpD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,OAAO,EAAE,OAAO;IAO5B,UAAU,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAeR,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKhC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAOxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAOxC,WAAW,IAAI,IAAI,EAAE;IAQrB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,UAAU,CAAC;KACrB,GAAG,IAAI,GAAG,IAAI;IAqCf,aAAa,CAAC,gBAAgB,SAAK,GAAG,IAAI,EAAE;IAQ5C,OAAO,CAAC,MAAM;CAkBf"}

package/dist/intelligence/goals/store.js

@@ -0,0 +1,105 @@
+import { randomUUID } from "node:crypto";
+const SCHEMA_SQL = `CREATE TABLE IF NOT EXISTS goals (
+  id               TEXT PRIMARY KEY,
+  sender_id        TEXT NOT NULL,
+  channel_id       TEXT NOT NULL,
+  arc_id           TEXT,
+  description      TEXT NOT NULL,
+  status           TEXT DEFAULT 'active',
+  success_criteria TEXT,
+  progress_notes   TEXT DEFAULT '[]',
+  next_action      TEXT,
+  next_action_due  INTEGER,
+  priority         INTEGER DEFAULT 50,
+  created_at       INTEGER NOT NULL,
+  updated_at       INTEGER NOT NULL,
+  completed_at     INTEGER
+);
+CREATE INDEX IF NOT EXISTS idx_goals_sender ON goals(sender_id, status);
+CREATE INDEX IF NOT EXISTS idx_goals_due ON goals(next_action_due) WHERE status = 'active';`;
+export class GoalsStore {
+    db;
+    constructor(vaultDb) {
+        this.db = vaultDb.raw();
+        this.db.exec(SCHEMA_SQL);
+    }
+    // ── Goals ──
+    createGoal(params) {
+        const id = randomUUID();
+        const now = Date.now();
+        this.db.prepare(`INSERT INTO goals (id, sender_id, channel_id, arc_id, description, status, success_criteria, progress_notes, next_action, next_action_due, priority, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, 'active', ?, '[]', ?, ?, ?, ?, ?)`).run(id, params.senderId, params.channelId, params.arcId ?? null, params.description, params.successCriteria ?? null, params.nextAction ?? null, params.nextActionDue ?? null, params.priority ?? 50, now, now);
+        return this.getGoal(id);
+    }
+    getGoal(id) {
+        const row = this.db.prepare("SELECT * FROM goals WHERE id = ?").get(id);
+        return row ? this.toGoal(row) : null;
+    }
+    getActiveGoals(senderId) {
+        const rows = this.db.prepare("SELECT * FROM goals WHERE sender_id = ? AND status = 'active' ORDER BY priority DESC, updated_at DESC").all(senderId);
+        return rows.map((r) => this.toGoal(r));
+    }
+    getPausedGoals(senderId) {
+        const rows = this.db.prepare("SELECT * FROM goals WHERE sender_id = ? AND status = 'paused' ORDER BY updated_at DESC").all(senderId);
+        return rows.map((r) => this.toGoal(r));
+    }
+    getDueGoals() {
+        const now = Date.now();
+        const rows = this.db.prepare("SELECT * FROM goals WHERE status = 'active' AND next_action_due IS NOT NULL AND next_action_due <= ? ORDER BY next_action_due ASC").all(now);
+        return rows.map((r) => this.toGoal(r));
+    }
+    updateGoal(id, params) {
+        const goal = this.getGoal(id);
+        if (!goal)
+            return null;
+        const now = Date.now();
+        if (params.progressNote) {
+            const notes = JSON.parse(goal.progressNotes);
+            notes.push({ text: params.progressNote, at: now });
+            this.db.prepare("UPDATE goals SET progress_notes = ?, updated_at = ? WHERE id = ?")
+                .run(JSON.stringify(notes), now, id);
+        }
+        if (params.nextAction !== undefined) {
+            this.db.prepare("UPDATE goals SET next_action = ?, updated_at = ? WHERE id = ?")
+                .run(params.nextAction, now, id);
+        }
+        if (params.nextActionDue !== undefined) {
+            this.db.prepare("UPDATE goals SET next_action_due = ?, updated_at = ? WHERE id = ?")
+                .run(params.nextActionDue, now, id);
+        }
+        if (params.priority !== undefined) {
+            this.db.prepare("UPDATE goals SET priority = ?, updated_at = ? WHERE id = ?")
+                .run(params.priority, now, id);
+        }
+        if (params.status) {
+            const completedAt = params.status === "completed" ? now : null;
+            this.db.prepare("UPDATE goals SET status = ?, updated_at = ?, completed_at = COALESCE(?, completed_at) WHERE id = ?")
+                .run(params.status, now, completedAt, id);
+        }
+        return this.getGoal(id);
+    }
+    getStaleGoals(defaultStaleDays = 30) {
+        const cutoff = Date.now() - defaultStaleDays * 86_400_000;
+        const rows = this.db.prepare("SELECT * FROM goals WHERE status = 'active' AND updated_at < ? ORDER BY updated_at ASC").all(cutoff);
+        return rows.map((r) => this.toGoal(r));
+    }
+    toGoal(row) {
+        return {
+            id: row["id"],
+            senderId: row["sender_id"],
+            channelId: row["channel_id"],
+            arcId: row["arc_id"],
+            description: row["description"],
+            status: row["status"],
+            successCriteria: row["success_criteria"],
+            progressNotes: row["progress_notes"],
+            nextAction: row["next_action"],
+            nextActionDue: row["next_action_due"],
+            priority: row["priority"],
+            createdAt: row["created_at"],
+            updatedAt: row["updated_at"],
+            completedAt: row["completed_at"],
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/intelligence/goals/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/intelligence/goals/store.ts"],"names":[],"mappings":"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"}

package/dist/intelligence/health/gate.d.ts

@@ -0,0 +1,41 @@
+import type { HeartbeatStore } from "../../heartbeat/store.js";
+import type { Logger } from "../../logging/logger.js";
+import type { IntelligenceBus } from "../bus.js";
+import type { TrendDetector } from "./trend-detector.js";
+import type { ThrottleLevel, HealthGateResult } from "../types.js";
+/**
+ * Health gate for the proactive engine.
+ * Checks system health before allowing proactive messages.
+ * Throttles or pauses proactive activity when the system is degraded.
+ *
+ * Levels:
+ *  - normal:  All systems healthy, full proactive activity
+ *  - reduced: Some degradation, reduce proactive frequency by 50%
+ *  - minimal: Significant issues, only critical proactive messages
+ *  - paused:  System is too unhealthy for any proactive activity
+ */
+export declare class HealthGate {
+    private readonly heartbeatStore;
+    private readonly trendDetector;
+    private readonly bus;
+    private readonly logger;
+    private currentThrottle;
+    private lastCheck;
+    private readonly CHECK_INTERVAL_MS;
+    constructor(heartbeatStore: HeartbeatStore, trendDetector: TrendDetector, bus: IntelligenceBus, logger: Logger);
+    /**
+     * Check if the system is healthy enough for proactive activity.
+     * Caches result for CHECK_INTERVAL_MS to avoid excessive queries.
+     */
+    check(channelIds?: string[]): HealthGateResult;
+    /**
+     * Whether proactive activity should proceed at current throttle level.
+     */
+    shouldProceed(priority?: "critical" | "normal" | "low"): boolean;
+    /**
+     * Get health context formatted for prompt injection.
+     */
+    getHealthHints(): string | null;
+    getCurrentThrottle(): ThrottleLevel;
+}
+//# sourceMappingURL=gate.d.ts.map

package/dist/intelligence/health/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/intelligence/health/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;gBAGzB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM;IAGjC;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB;IAsF9C;;OAEG;IACH,aAAa,CAAC,QAAQ,GAAE,UAAU,GAAG,QAAQ,GAAG,KAAgB,GAAG,OAAO;IAe1E;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAoB/B,kBAAkB,IAAI,aAAa;CAGpC"}

package/dist/intelligence/health/gate.js

@@ -0,0 +1,140 @@
+/**
+ * Health gate for the proactive engine.
+ * Checks system health before allowing proactive messages.
+ * Throttles or pauses proactive activity when the system is degraded.
+ *
+ * Levels:
+ *  - normal:  All systems healthy, full proactive activity
+ *  - reduced: Some degradation, reduce proactive frequency by 50%
+ *  - minimal: Significant issues, only critical proactive messages
+ *  - paused:  System is too unhealthy for any proactive activity
+ */
+export class HealthGate {
+    heartbeatStore;
+    trendDetector;
+    bus;
+    logger;
+    currentThrottle = "normal";
+    lastCheck = 0;
+    CHECK_INTERVAL_MS = 60_000; // Re-evaluate every minute
+    constructor(heartbeatStore, trendDetector, bus, logger) {
+        this.heartbeatStore = heartbeatStore;
+        this.trendDetector = trendDetector;
+        this.bus = bus;
+        this.logger = logger;
+    }
+    /**
+     * Check if the system is healthy enough for proactive activity.
+     * Caches result for CHECK_INTERVAL_MS to avoid excessive queries.
+     */
+    check(channelIds) {
+        const now = Date.now();
+        // Use cached result if recent enough
+        if (now - this.lastCheck < this.CHECK_INTERVAL_MS) {
+            return {
+                throttle: this.currentThrottle,
+                availableChannels: channelIds ?? [],
+                queuedChannels: [],
+                reason: "cached",
+            };
+        }
+        this.lastCheck = now;
+        const latestStatus = this.heartbeatStore.getLatestStatus();
+        const trends = this.trendDetector.analyzeAll();
+        // Count unhealthy components
+        let unhealthyCount = 0;
+        let criticalCount = 0;
+        const degradedChannels = [];
+        for (const [component, status] of latestStatus) {
+            if (status === "unhealthy" || status === "error") {
+                unhealthyCount++;
+                // Check if it's a channel component
+                if (component.startsWith("channel:")) {
+                    degradedChannels.push(component.replace("channel:", ""));
+                }
+            }
+            if (status === "critical")
+                criticalCount++;
+        }
+        // Check for critical trajectory in trends
+        const criticalTrajectories = trends.filter((t) => t.trend === "critical_trajectory");
+        // Determine throttle level
+        let newThrottle;
+        let reason;
+        if (criticalCount > 0 || criticalTrajectories.length > 0) {
+            newThrottle = "paused";
+            reason = `critical:${criticalCount} components, ${criticalTrajectories.length} trajectories`;
+        }
+        else if (unhealthyCount >= 3) {
+            newThrottle = "minimal";
+            reason = `degraded:${unhealthyCount} unhealthy components`;
+        }
+        else if (unhealthyCount >= 1) {
+            newThrottle = "reduced";
+            reason = `partially_degraded:${unhealthyCount} unhealthy components`;
+        }
+        else {
+            newThrottle = "normal";
+            reason = "all_healthy";
+        }
+        // Emit event on throttle change
+        if (newThrottle !== this.currentThrottle) {
+            this.bus.emit({
+                type: "health_changed",
+                component: "health_gate",
+                status: newThrottle,
+            });
+            this.logger.info({ from: this.currentThrottle, to: newThrottle, reason }, "Health gate throttle changed");
+            this.currentThrottle = newThrottle;
+        }
+        // Determine which channels are available vs queued
+        const available = (channelIds ?? []).filter((ch) => !degradedChannels.includes(ch));
+        const queued = (channelIds ?? []).filter((ch) => degradedChannels.includes(ch));
+        return {
+            throttle: this.currentThrottle,
+            availableChannels: available,
+            queuedChannels: queued,
+            reason,
+        };
+    }
+    /**
+     * Whether proactive activity should proceed at current throttle level.
+     */
+    shouldProceed(priority = "normal") {
+        switch (this.currentThrottle) {
+            case "normal":
+                return true;
+            case "reduced":
+                // Skip low priority, allow normal and critical
+                return priority !== "low";
+            case "minimal":
+                // Only critical priority
+                return priority === "critical";
+            case "paused":
+                return false;
+        }
+    }
+    /**
+     * Get health context formatted for prompt injection.
+     */
+    getHealthHints() {
+        if (this.currentThrottle === "normal")
+            return null;
+        const trends = this.trendDetector.analyzeAll();
+        const degrading = trends.filter((t) => t.trend === "degrading" || t.trend === "critical_trajectory");
+        if (degrading.length === 0)
+            return null;
+        const lines = [`[SYSTEM HEALTH: ${this.currentThrottle.toUpperCase()}]`];
+        for (const t of degrading) {
+            const predicted = t.predictedThresholdIn
+                ? ` (predicted breach in ${Math.round(t.predictedThresholdIn / 3_600_000)}h)`
+                : "";
+            lines.push(`- ${t.component}/${t.metric}: ${t.trend}${predicted}`);
+        }
+        return lines.join("\n");
+    }
+    getCurrentThrottle() {
+        return this.currentThrottle;
+    }
+}
+//# sourceMappingURL=gate.js.map

package/dist/intelligence/health/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../../src/intelligence/health/gate.ts"],"names":[],"mappings":"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"}

package/dist/intelligence/health/trend-detector.d.ts

@@ -0,0 +1,43 @@
+import type { VaultDB } from "../../vault/db.js";
+import type { Logger } from "../../logging/logger.js";
+import type { TrendResult } from "../types.js";
+/**
+ * Health trend detector.
+ * Runs linear regression on heartbeat_log data to detect:
+ *  - Degrading components (latency trending up, status trending down)
+ *  - Critical trajectory (predicted threshold breach within N hours)
+ *
+ * Pure math — no AI calls.
+ */
+export declare class TrendDetector {
+    private readonly logger;
+    private readonly db;
+    constructor(vaultDb: VaultDB, logger: Logger);
+    /**
+     * Analyze trends for all components.
+     * Returns trend results for components that have enough data.
+     */
+    analyzeAll(windowHours?: number, thresholdLatencyMs?: number): TrendResult[];
+    /**
+     * Analyze latency trend for a single component.
+     */
+    analyzeComponent(component: string, windowHours?: number, thresholdMs?: number): TrendResult | null;
+    /**
+     * Get error rate trend for a component.
+     */
+    analyzeErrorRate(component: string, windowHours?: number): TrendResult | null;
+    /**
+     * Simple linear regression: y = mx + b
+     * Returns slope (m) and intercept (b).
+     */
+    private linearRegression;
+    /**
+     * Classify trend based on slope magnitude and direction.
+     */
+    private classifyTrend;
+    /**
+     * Get list of components that have recent heartbeat data.
+     */
+    private getActiveComponents;
+}
+//# sourceMappingURL=trend-detector.d.ts.map

package/dist/intelligence/health/trend-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trend-detector.d.ts","sourceRoot":"","sources":["../../../src/intelligence/health/trend-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C;;;;;;;GAOG;AACH,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAGlB,OAAO,EAAE,OAAO,EACC,MAAM,EAAE,MAAM;IAKjC;;;OAGG;IACH,UAAU,CAAC,WAAW,SAAI,EAAE,kBAAkB,SAAO,GAAG,WAAW,EAAE;IAYrE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,WAAW,SAAO,GAAG,WAAW,GAAG,IAAI;IA0C5F;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,WAAW,GAAG,IAAI;IAqCxE;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAO5B"}