clawprobe 0.1.0

package/dist/engines/compact-diff.js

@@ -0,0 +1,124 @@
+import { getCompactedMessages } from "../core/jsonl-parser.js";
+// Patterns that signal important content
+const PREFERENCE_PATTERNS = [
+    /\b(use|prefer|always|never|don'?t|avoid|must|should|require|need)\b/i,
+    /\bnot\s+(use|do|allow|want)\b/i,
+    /\binstead\s+of\b/i,
+];
+const TECHNICAL_PATTERNS = [
+    /[./\\][a-zA-Z0-9_-]+\.[a-zA-Z]{1,10}/, // file paths
+    /\b[A-Z_]{2,}\b/, // CONSTANTS / env vars
+    /`[^`]+`/, // inline code
+    /```[\s\S]+?```/, // code blocks
+    /\b(port|host|url|api|key|token|secret|password|config|env)\b/i,
+    /https?:\/\//, // URLs
+];
+const ENTITY_PATTERNS = [
+    /\b[A-Z][a-z]+(?:[A-Z][a-z]+)+\b/, // CamelCase names
+    /\b(project|repo|database|service|component|module|package)\s+\w+/i,
+];
+const DECISION_PATTERNS = [
+    /\b(decided|agreed|confirmed|settled on|going with|chose|selected)\b/i,
+    /\b(the plan is|we will|I will|let's)\b/i,
+];
+export function scoreLoss(message, summaryText) {
+    if (message.role !== "user" && message.role !== "assistant") {
+        return { score: 0, reasons: [] };
+    }
+    const content = message.content;
+    const lowerContent = content.toLowerCase();
+    const lowerSummary = summaryText.toLowerCase();
+    const reasons = [];
+    let score = 0;
+    // Check preference patterns
+    for (const pattern of PREFERENCE_PATTERNS) {
+        const match = pattern.exec(content);
+        if (match) {
+            // Only flag if the surrounding phrase doesn't appear in summary
+            const phrase = extractPhrase(content, match.index, 40);
+            if (phrase && !lowerSummary.includes(phrase.toLowerCase().slice(0, 20))) {
+                score += 0.3;
+                reasons.push("Preference or constraint statement");
+                break;
+            }
+        }
+    }
+    // Check technical content
+    for (const pattern of TECHNICAL_PATTERNS) {
+        const match = pattern.exec(content);
+        if (match) {
+            const val = match[0].slice(0, 30);
+            if (!lowerSummary.includes(val.toLowerCase())) {
+                score += 0.25;
+                reasons.push("Technical detail (code, path, config)");
+                break;
+            }
+        }
+    }
+    // Check entity mentions
+    for (const pattern of ENTITY_PATTERNS) {
+        const match = pattern.exec(content);
+        if (match) {
+            const val = match[0].toLowerCase();
+            if (!lowerSummary.includes(val)) {
+                score += 0.2;
+                reasons.push("Named entity or project reference");
+                break;
+            }
+        }
+    }
+    // Check decision language
+    for (const pattern of DECISION_PATTERNS) {
+        if (pattern.test(content)) {
+            score += 0.25;
+            reasons.push("Decision or agreement statement");
+            break;
+        }
+    }
+    // User messages are generally more important (explicit instructions)
+    if (message.role === "user" && score > 0) {
+        score = Math.min(score * 1.2, 1.0);
+    }
+    // Long messages with no keywords — probably just conversation
+    if (score === 0 && lowerContent.length > 200) {
+        score = 0.05;
+        reasons.push("Long message (may contain context)");
+    }
+    return { score: Math.min(score, 1.0), reasons };
+}
+export function analyzeCompaction(event, allEntries, previousFirstKeptId) {
+    const compactedMessages = getCompactedMessages(allEntries, event, previousFirstKeptId);
+    const losses = [];
+    for (const msg of compactedMessages) {
+        const { score, reasons } = scoreLoss(msg, event.summaryText);
+        if (score >= 0.2) {
+            losses.push({ message: msg, score, reasons });
+        }
+    }
+    // Sort by score descending
+    losses.sort((a, b) => b.score - a.score);
+    const quality = determineQuality(losses, compactedMessages.length);
+    return {
+        event,
+        compactedMessages,
+        importantLosses: losses,
+        summaryQuality: quality,
+    };
+}
+function determineQuality(losses, totalMessages) {
+    const criticalLosses = losses.filter((l) => l.score >= 0.5).length;
+    const moderateLosses = losses.filter((l) => l.score >= 0.2).length;
+    if (criticalLosses >= 2 || (totalMessages > 5 && criticalLosses >= 1)) {
+        return "poor";
+    }
+    if (moderateLosses >= 2) {
+        return "partial";
+    }
+    return "good";
+}
+function extractPhrase(text, index, maxLen) {
+    const start = Math.max(0, index - 10);
+    const end = Math.min(text.length, index + maxLen);
+    return text.slice(start, end).replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=compact-diff.js.map

package/dist/engines/compact-diff.js.map

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

package/dist/engines/cost.d.ts

@@ -0,0 +1,73 @@
+import { DatabaseSync } from "node:sqlite";
+export declare const MODEL_PRICES: Record<string, {
+    input: number;
+    output: number;
+}>;
+export interface TokenCount {
+    input: number;
+    output: number;
+}
+export interface DailyCost {
+    date: string;
+    usd: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface PeriodCostSummary {
+    period: string;
+    startDate: string;
+    endDate: string;
+    totalUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    dailyAvg: number;
+    monthEstimate: number;
+    daily: DailyCost[];
+    model?: string;
+}
+export interface SessionCost {
+    sessionKey: string;
+    model: string | null;
+    provider: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedUsd: number;
+    startedAt: number;
+    lastActiveAt: number;
+    durationMin: number;
+    compactionCount: number;
+    costAccurate: boolean;
+    turns: TurnCost[];
+}
+export interface TurnCost {
+    turnIndex: number;
+    timestamp: number;
+    inputTokensDelta: number;
+    outputTokensDelta: number;
+    estimatedUsd: number;
+    compactOccurred: boolean;
+}
+export declare function estimateCost(tokens: TokenCount, model: string | null, customPrices?: Record<string, {
+    input: number;
+    output: number;
+}>): number;
+export declare function getSessionCost(db: DatabaseSync, agent: string, sessionKey: string, customPrices?: Record<string, {
+    input: number;
+    output: number;
+}>): SessionCost | null;
+export declare function getAllSessionCosts(db: DatabaseSync, agent: string, customPrices?: Record<string, {
+    input: number;
+    output: number;
+}>): SessionCost[];
+export declare function getPeriodCost(db: DatabaseSync, agent: string, period: "day" | "week" | "month" | "all", customPrices?: Record<string, {
+    input: number;
+    output: number;
+}>): PeriodCostSummary;
+export declare function recordDailyCost(db: DatabaseSync, agent: string, sessionKey: string, date: string, inputDelta: number, outputDelta: number, model: string | null, customPrices?: Record<string, {
+    input: number;
+    output: number;
+}>): void;
+export declare function formatDate(d: Date): string;
+export declare function todayString(): string;
+//# sourceMappingURL=cost.d.ts.map

package/dist/engines/cost.d.ts.map

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

package/dist/engines/cost.js

@@ -0,0 +1,149 @@
+import { getDailyCostSummary, getAllSessionKeys, getAllSnapshots, upsertCostRecord, } from "../core/db.js";
+// USD per 1M tokens
+export const MODEL_PRICES = {
+    // Anthropic
+    "anthropic/claude-opus-4": { input: 15.00, output: 75.00 },
+    "anthropic/claude-sonnet-4.5": { input: 3.00, output: 15.00 },
+    "anthropic/claude-haiku-3.5": { input: 0.80, output: 4.00 },
+    // OpenAI
+    "openai/gpt-5.4": { input: 5.00, output: 20.00 },
+    "openai/gpt-5.4-mini": { input: 0.30, output: 1.20 },
+    "openai/o4-mini": { input: 1.10, output: 4.40 },
+    // Google
+    "google/gemini-3.1-flash": { input: 0.075, output: 0.30 },
+    "google/gemini-3.1-pro": { input: 1.25, output: 5.00 },
+    // DeepSeek
+    "deepseek/deepseek-v3": { input: 0.27, output: 1.10 },
+    "deepseek/deepseek-r2": { input: 0.55, output: 2.19 },
+};
+export function estimateCost(tokens, model, customPrices = {}) {
+    if (!model)
+        return 0;
+    const prices = { ...MODEL_PRICES, ...customPrices };
+    // Try exact match first, then prefix-match (e.g. "claude-sonnet" → anthropic/claude-sonnet-*)
+    const price = prices[model] ??
+        Object.entries(prices).find(([key]) => model.includes(key.split("/")[1] ?? key))?.[1];
+    if (!price)
+        return 0;
+    return (tokens.input / 1_000_000) * price.input +
+        (tokens.output / 1_000_000) * price.output;
+}
+export function getSessionCost(db, agent, sessionKey, customPrices = {}) {
+    const snapshots = getAllSnapshots(db, agent, sessionKey);
+    if (snapshots.length === 0)
+        return null;
+    const first = snapshots[0];
+    const last = snapshots[snapshots.length - 1];
+    const inputDelta = last.input_tokens - first.input_tokens;
+    const outputDelta = last.output_tokens - first.output_tokens;
+    const model = last.model ?? first.model;
+    const turns = [];
+    for (let i = 1; i < snapshots.length; i++) {
+        const prev = snapshots[i - 1];
+        const curr = snapshots[i];
+        const inDelta = curr.input_tokens - prev.input_tokens;
+        const outDelta = curr.output_tokens - prev.output_tokens;
+        const compactOccurred = curr.compaction_count > prev.compaction_count;
+        turns.push({
+            turnIndex: i,
+            timestamp: curr.sampled_at,
+            inputTokensDelta: inDelta,
+            outputTokensDelta: outDelta,
+            estimatedUsd: estimateCost({ input: inDelta, output: outDelta }, model, customPrices),
+            compactOccurred,
+        });
+    }
+    return {
+        sessionKey,
+        model,
+        provider: last.provider ?? first.provider,
+        inputTokens: Math.max(0, inputDelta),
+        outputTokens: Math.max(0, outputDelta),
+        totalTokens: Math.max(0, inputDelta + outputDelta),
+        estimatedUsd: estimateCost({ input: Math.max(0, inputDelta), output: Math.max(0, outputDelta) }, model, customPrices),
+        startedAt: first.sampled_at,
+        lastActiveAt: last.sampled_at,
+        durationMin: Math.round((last.sampled_at - first.sampled_at) / 60),
+        compactionCount: last.compaction_count,
+        costAccurate: snapshots.length > 1,
+        turns,
+    };
+}
+export function getAllSessionCosts(db, agent, customPrices = {}) {
+    const keys = getAllSessionKeys(db, agent);
+    return keys
+        .map(({ session_key }) => getSessionCost(db, agent, session_key, customPrices))
+        .filter((s) => s !== null);
+}
+export function getPeriodCost(db, agent, period, customPrices = {}) {
+    const now = new Date();
+    const today = formatDate(now);
+    let days;
+    let startDate;
+    let periodLabel;
+    switch (period) {
+        case "day":
+            days = 1;
+            startDate = today;
+            periodLabel = `Today (${today})`;
+            break;
+        case "week":
+            days = 7;
+            startDate = formatDate(new Date(now.getTime() - 6 * 86400_000));
+            periodLabel = `${startDate} – ${today}`;
+            break;
+        case "month":
+            days = 30;
+            startDate = formatDate(new Date(now.getTime() - 29 * 86400_000));
+            periodLabel = `${startDate} – ${today}`;
+            break;
+        case "all":
+            days = 3650;
+            startDate = "2020-01-01";
+            periodLabel = "All time";
+            break;
+    }
+    const rows = getDailyCostSummary(db, agent, days);
+    const daily = rows.map((r) => ({
+        date: r.date,
+        usd: r.total_usd,
+        inputTokens: r.input_tokens,
+        outputTokens: r.output_tokens,
+    }));
+    const totalUsd = daily.reduce((s, d) => s + d.usd, 0);
+    const totalInput = daily.reduce((s, d) => s + d.inputTokens, 0);
+    const totalOutput = daily.reduce((s, d) => s + d.outputTokens, 0);
+    const activeDays = Math.max(daily.length, 1);
+    const dailyAvg = totalUsd / activeDays;
+    return {
+        period: periodLabel,
+        startDate,
+        endDate: today,
+        totalUsd,
+        inputTokens: totalInput,
+        outputTokens: totalOutput,
+        dailyAvg,
+        monthEstimate: dailyAvg * 30,
+        daily,
+    };
+}
+export function recordDailyCost(db, agent, sessionKey, date, inputDelta, outputDelta, model, customPrices = {}) {
+    const usd = estimateCost({ input: inputDelta, output: outputDelta }, model, customPrices);
+    upsertCostRecord(db, {
+        agent,
+        session_key: sessionKey,
+        date,
+        input_tokens: inputDelta,
+        output_tokens: outputDelta,
+        model,
+        estimated_usd: usd,
+        recorded_at: Math.floor(Date.now() / 1000),
+    });
+}
+export function formatDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+export function todayString() {
+    return formatDate(new Date());
+}
+//# sourceMappingURL=cost.js.map

package/dist/engines/cost.js.map

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

package/dist/engines/file-analyzer.d.ts

@@ -0,0 +1,28 @@
+import { DatabaseSync } from "node:sqlite";
+export interface WorkspaceFile {
+    name: string;
+    filePath: string;
+    rawChars: number;
+    injectedChars: number;
+    wasTruncated: boolean;
+    lostChars: number;
+    lostPercent: number;
+    estTokens: number;
+    injectedEstTokens: number;
+    exists: boolean;
+}
+export interface WorkspaceAnalysis {
+    files: WorkspaceFile[];
+    totalRawChars: number;
+    totalInjectedChars: number;
+    truncatedFiles: WorkspaceFile[];
+    bootstrapMaxChars: number;
+}
+export declare function analyzeWorkspaceFiles(workspaceDir: string, bootstrapMaxChars: number): WorkspaceAnalysis;
+export declare function snapshotWorkspaceFiles(db: DatabaseSync, agent: string, workspaceDir: string, bootstrapMaxChars: number): void;
+export declare function getLatestWorkspaceAnalysis(db: DatabaseSync, agent: string, workspaceDir: string, bootstrapMaxChars: number): WorkspaceAnalysis;
+export declare function getFileStaleness(workspaceDir: string): {
+    name: string;
+    daysSinceModified: number;
+}[];
+//# sourceMappingURL=file-analyzer.d.ts.map

package/dist/engines/file-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-analyzer.d.ts","sourceRoot":"","sources":["../../src/engines/file-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAaD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,iBAAiB,CAuCnB;AA2CD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAcN;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,iBAAiB,CAiCnB;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAAE,CAapG"}

package/dist/engines/file-analyzer.js

@@ -0,0 +1,139 @@
+import fs from "fs";
+import path from "path";
+import { insertFileSnapshot, getLatestFileSnapshots } from "../core/db.js";
+const WORKSPACE_FILES = [
+    "SOUL.md",
+    "AGENTS.md",
+    "TOOLS.md",
+    "USER.md",
+    "IDENTITY.md",
+    "MEMORY.md",
+    "HEARTBEAT.md",
+    "GLOBAL_AGENTS.md",
+];
+export function analyzeWorkspaceFiles(workspaceDir, bootstrapMaxChars) {
+    const files = [];
+    for (const name of WORKSPACE_FILES) {
+        const filePath = path.join(workspaceDir, name);
+        const wf = analyzeFile(name, filePath, bootstrapMaxChars);
+        files.push(wf);
+    }
+    // Also scan any extra .md files in the workspace root
+    if (fs.existsSync(workspaceDir)) {
+        const extra = fs
+            .readdirSync(workspaceDir)
+            .filter((f) => f.endsWith(".md") &&
+            !WORKSPACE_FILES.includes(f) &&
+            !f.startsWith("."));
+        for (const name of extra) {
+            const filePath = path.join(workspaceDir, name);
+            if (fs.statSync(filePath).isFile()) {
+                files.push(analyzeFile(name, filePath, bootstrapMaxChars));
+            }
+        }
+    }
+    const existing = files.filter((f) => f.exists);
+    const totalRawChars = existing.reduce((s, f) => s + f.rawChars, 0);
+    const totalInjectedChars = existing.reduce((s, f) => s + f.injectedChars, 0);
+    const truncatedFiles = existing.filter((f) => f.wasTruncated);
+    return {
+        files: existing.sort((a, b) => b.rawChars - a.rawChars),
+        totalRawChars,
+        totalInjectedChars,
+        truncatedFiles,
+        bootstrapMaxChars,
+    };
+}
+function analyzeFile(name, filePath, bootstrapMaxChars) {
+    if (!fs.existsSync(filePath)) {
+        return {
+            name,
+            filePath,
+            rawChars: 0,
+            injectedChars: 0,
+            wasTruncated: false,
+            lostChars: 0,
+            lostPercent: 0,
+            estTokens: 0,
+            injectedEstTokens: 0,
+            exists: false,
+        };
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const rawChars = content.length;
+    const injectedChars = Math.min(rawChars, bootstrapMaxChars);
+    const wasTruncated = rawChars > bootstrapMaxChars;
+    const lostChars = rawChars - injectedChars;
+    const lostPercent = rawChars > 0 ? (lostChars / rawChars) * 100 : 0;
+    return {
+        name,
+        filePath,
+        rawChars,
+        injectedChars,
+        wasTruncated,
+        lostChars,
+        lostPercent,
+        estTokens: Math.ceil(rawChars / 4),
+        injectedEstTokens: Math.ceil(injectedChars / 4),
+        exists: true,
+    };
+}
+export function snapshotWorkspaceFiles(db, agent, workspaceDir, bootstrapMaxChars) {
+    const analysis = analyzeWorkspaceFiles(workspaceDir, bootstrapMaxChars);
+    const now = Math.floor(Date.now() / 1000);
+    for (const f of analysis.files) {
+        insertFileSnapshot(db, {
+            agent,
+            file_path: f.filePath,
+            raw_chars: f.rawChars,
+            injected_chars: f.injectedChars,
+            was_truncated: f.wasTruncated ? 1 : 0,
+            sampled_at: now,
+        });
+    }
+}
+export function getLatestWorkspaceAnalysis(db, agent, workspaceDir, bootstrapMaxChars) {
+    const rows = getLatestFileSnapshots(db, agent);
+    if (rows.length === 0) {
+        // Fallback: read directly from disk
+        return analyzeWorkspaceFiles(workspaceDir, bootstrapMaxChars);
+    }
+    const files = rows.map((r) => {
+        const name = path.basename(r.file_path);
+        const lostChars = r.raw_chars - r.injected_chars;
+        const lostPercent = r.raw_chars > 0 ? (lostChars / r.raw_chars) * 100 : 0;
+        return {
+            name,
+            filePath: r.file_path,
+            rawChars: r.raw_chars,
+            injectedChars: r.injected_chars,
+            wasTruncated: r.was_truncated === 1,
+            lostChars,
+            lostPercent,
+            estTokens: Math.ceil(r.raw_chars / 4),
+            injectedEstTokens: Math.ceil(r.injected_chars / 4),
+            exists: true,
+        };
+    });
+    return {
+        files,
+        totalRawChars: files.reduce((s, f) => s + f.rawChars, 0),
+        totalInjectedChars: files.reduce((s, f) => s + f.injectedChars, 0),
+        truncatedFiles: files.filter((f) => f.wasTruncated),
+        bootstrapMaxChars,
+    };
+}
+export function getFileStaleness(workspaceDir) {
+    const now = Date.now();
+    const results = [];
+    for (const name of WORKSPACE_FILES) {
+        const filePath = path.join(workspaceDir, name);
+        if (!fs.existsSync(filePath))
+            continue;
+        const stat = fs.statSync(filePath);
+        const daysSince = (now - stat.mtimeMs) / 86400_000;
+        results.push({ name, daysSinceModified: Math.floor(daysSince) });
+    }
+    return results.sort((a, b) => b.daysSinceModified - a.daysSinceModified);
+}
+//# sourceMappingURL=file-analyzer.js.map

package/dist/engines/file-analyzer.js.map

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

package/dist/engines/rule-engine.d.ts

@@ -0,0 +1,25 @@
+import { DatabaseSync } from "node:sqlite";
+import { ProbeConfig } from "../core/config.js";
+export interface Suggestion {
+    ruleId: string;
+    severity: "critical" | "warning" | "info";
+    title: string;
+    detail: string;
+    action?: string;
+}
+export interface ProbeState {
+    db: DatabaseSync;
+    agent: string;
+    workspaceDir: string;
+    sessionsDir: string;
+    bootstrapMaxChars: number;
+    config: ProbeConfig;
+}
+export interface Rule {
+    id: string;
+    name: string;
+    check(state: ProbeState): Suggestion | null;
+}
+export declare function runRules(state: ProbeState, customRules?: Rule[]): Suggestion[];
+export declare function persistSuggestions(db: DatabaseSync, agent: string, suggestions: Suggestion[]): void;
+//# sourceMappingURL=rule-engine.d.ts.map

package/dist/engines/rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.d.ts","sourceRoot":"","sources":["../../src/engines/rule-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;CAC7C;AAuMD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,WAAW,GAAE,IAAI,EAAO,GACvB,UAAU,EAAE,CAiBd;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,UAAU,EAAE,GACxB,IAAI,CAwBN"}