@winspan/claude-forge 4.0.0 → 6.0.0

package/dist/engine/dsl/parser.js

@@ -0,0 +1,174 @@
+/**
+ * Convention DSL Parser
+ *
+ * Responsibilities:
+ * - Parse YAML Convention files
+ * - Zod schema validation
+ * - Handle inheritance and overrides
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { z } from 'zod';
+// -- Zod Schemas --
+const RuleSchema = z.object({
+    id: z.string(),
+    when: z.string(),
+    level: z.enum(['allow', 'warn', 'confirm', 'block']),
+    message: z.string(),
+    suggestion: z.string().optional(),
+    enabled: z.boolean().optional().default(true),
+});
+const EscalationRuleSchema = z.object({
+    id: z.string(),
+    when: z.string(),
+    action: z.enum(['allow', 'warn', 'confirm', 'block']),
+    message: z.string(),
+    suggestion: z.string().optional(),
+    enabled: z.boolean().optional().default(true),
+});
+const DeliverableSchema = z.object({
+    name: z.string(),
+    pattern: z.string().optional(),
+    command: z.string().optional(),
+    required: z.boolean(),
+    check_at: z.enum(['session_end', 'before_commit', 'on_demand']),
+    condition: z.string().optional(),
+});
+const RuleOverrideSchema = z.object({
+    rule_id: z.string(),
+    level: z.enum(['allow', 'warn', 'confirm', 'block']).optional(),
+    message: z.string().optional(),
+    enabled: z.boolean().optional(),
+});
+const ConventionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    extends: z.array(z.string()).optional(),
+    variables: z.record(z.string(), z.any()).optional().default({}),
+    forbidden: z.array(RuleSchema).optional().default([]),
+    escalation: z.array(EscalationRuleSchema).optional().default([]),
+    deliverables: z.array(DeliverableSchema).optional().default([]),
+    overrides: z.array(RuleOverrideSchema).optional().default([]),
+    principles: z.string().optional().default(''),
+});
+// -- Parser --
+export class ConventionParser {
+    conventionsDir;
+    constructor(conventionsDir) {
+        this.conventionsDir =
+            conventionsDir ?? path.join(process.env.HOME ?? '', '.claude', 'conventions');
+    }
+    parseFile(filePath) {
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Convention file not found: ${filePath}`);
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const raw = yaml.load(content);
+        const result = ConventionSchema.safeParse(raw);
+        if (!result.success) {
+            throw new Error(`Invalid convention schema in ${filePath}: ${result.error.message}`);
+        }
+        return result.data;
+    }
+    loadAll() {
+        const conventions = new Map();
+        if (!fs.existsSync(this.conventionsDir)) {
+            return conventions;
+        }
+        const files = fs.readdirSync(this.conventionsDir);
+        for (const file of files) {
+            if (!file.endsWith('.yaml') && !file.endsWith('.yml')) {
+                continue;
+            }
+            const filePath = path.join(this.conventionsDir, file);
+            try {
+                const convention = this.parseFile(filePath);
+                conventions.set(convention.id, convention);
+            }
+            catch (error) {
+                console.error(`Failed to load convention ${file}:`, error);
+            }
+        }
+        return conventions;
+    }
+    resolveInheritance(conventionId, allConventions) {
+        const convention = allConventions.get(conventionId);
+        if (!convention) {
+            throw new Error(`Convention not found: ${conventionId}`);
+        }
+        if (!convention.extends || convention.extends.length === 0) {
+            return convention;
+        }
+        const parents = convention.extends.map((parentId) => this.resolveInheritance(parentId, allConventions));
+        return this.mergeConventions([...parents, convention]);
+    }
+    mergeConventions(conventions) {
+        if (conventions.length === 0) {
+            throw new Error('Cannot merge empty conventions');
+        }
+        if (conventions.length === 1) {
+            return conventions[0];
+        }
+        const base = conventions[0];
+        const merged = {
+            ...base,
+            variables: { ...base.variables },
+            forbidden: [...base.forbidden],
+            escalation: [...base.escalation],
+            deliverables: [...base.deliverables],
+            overrides: [...base.overrides],
+        };
+        for (let i = 1; i < conventions.length; i++) {
+            const current = conventions[i];
+            Object.assign(merged.variables, current.variables);
+            const forbiddenMap = new Map(merged.forbidden.map((r) => [r.id, r]));
+            for (const rule of current.forbidden) {
+                forbiddenMap.set(rule.id, rule);
+            }
+            merged.forbidden = Array.from(forbiddenMap.values());
+            const escalationMap = new Map(merged.escalation.map((r) => [r.id, r]));
+            for (const rule of current.escalation) {
+                escalationMap.set(rule.id, rule);
+            }
+            merged.escalation = Array.from(escalationMap.values());
+            const deliverableMap = new Map(merged.deliverables.map((d) => [d.name, d]));
+            for (const deliverable of current.deliverables) {
+                deliverableMap.set(deliverable.name, deliverable);
+            }
+            merged.deliverables = Array.from(deliverableMap.values());
+            merged.overrides.push(...current.overrides);
+            if (current.principles) {
+                merged.principles += '\n\n' + current.principles;
+            }
+        }
+        this.applyOverrides(merged);
+        return merged;
+    }
+    applyOverrides(convention) {
+        for (const override of convention.overrides) {
+            const forbiddenRule = convention.forbidden.find((r) => r.id === override.rule_id);
+            if (forbiddenRule) {
+                if (override.level !== undefined)
+                    forbiddenRule.level = override.level;
+                if (override.message !== undefined)
+                    forbiddenRule.message = override.message;
+                if (override.enabled !== undefined)
+                    forbiddenRule.enabled = override.enabled;
+                continue;
+            }
+            const escalationRule = convention.escalation.find((r) => r.id === override.rule_id);
+            if (escalationRule) {
+                if (override.level !== undefined)
+                    escalationRule.action = override.level;
+                if (override.message !== undefined)
+                    escalationRule.message = override.message;
+                if (override.enabled !== undefined)
+                    escalationRule.enabled = override.enabled;
+            }
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/engine/dsl/parser.js.map

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

package/dist/engine/dsl/runtime.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DSL Runtime — helper functions for compiled expressions
+ *
+ * Provides extension methods via Proxy wrapping for chain calls.
+ */
+export type DSLValue = string | number | boolean | null | undefined | RegExp | unknown[] | Record<string, unknown>;
+export interface DSLWrapped {
+    valueOf(): unknown;
+    startsWith(prefix: string): boolean;
+    endsWith(suffix: string): boolean;
+    includes(sub: string): boolean;
+    match(pattern: RegExp): RegExpMatchArray | null;
+    trim(): string;
+    lower(): string;
+    upper(): string;
+    split(sep: string): string[];
+    replace(from: string | RegExp, to: string): string;
+    length: number;
+    filter(fn: (item: unknown) => boolean): unknown[];
+    map(fn: (item: unknown) => unknown): unknown[];
+    any(fn: (item: unknown) => boolean): boolean;
+    all(fn: (item: unknown) => boolean): boolean;
+    none(fn: (item: unknown) => boolean): boolean;
+    count(fn?: (item: unknown) => boolean): number;
+    first(fn?: (item: unknown) => boolean): unknown;
+    last(n?: number): unknown[];
+    flat(): unknown[];
+    join(sep: string): string;
+    in(arr: unknown[]): boolean;
+    ok(): boolean;
+    abs(): number;
+    clamp(min: number, max: number): number;
+    basename(): string;
+    dirname(): string;
+    extname(): string;
+}
+/**
+ * Create a DSL Proxy wrapping any value with extension methods.
+ * Native methods take priority; DSL methods are fallback.
+ */
+export declare function createDSLProxy(value: unknown): unknown;
+/**
+ * Enhance a RuleContext with DSL proxy wrapping on all properties.
+ */
+export declare function enhanceContext(ctx: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/engine/dsl/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/engine/dsl/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnH,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC;IACnB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAChD,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC;IAClD,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC;IAC/C,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;IAC7C,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;IAC9C,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;IAChD,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC5B,IAAI,IAAI,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,EAAE,IAAI,OAAO,CAAC;IACd,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,IAAI,MAAM,CAAC;CACnB;AAiDD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoFtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBpF"}

package/dist/engine/dsl/runtime.js

@@ -0,0 +1,173 @@
+/**
+ * DSL Runtime — helper functions for compiled expressions
+ *
+ * Provides extension methods via Proxy wrapping for chain calls.
+ */
+const DSL_METHODS = {
+    in: (value, arr) => Array.isArray(arr) && arr.includes(value),
+    ok: (value) => value != null && value !== false,
+    lower: (value) => typeof value === 'string' ? value.toLowerCase() : value,
+    upper: (value) => typeof value === 'string' ? value.toUpperCase() : value,
+    any: (value, fn) => Array.isArray(value) && typeof fn === 'function' && value.some(item => fn(createDSLProxy(item))),
+    all: (value, fn) => Array.isArray(value) && typeof fn === 'function' && value.every(item => fn(createDSLProxy(item))),
+    none: (value, fn) => Array.isArray(value) && typeof fn === 'function' && !value.some(item => fn(createDSLProxy(item))),
+    count: (value, fn) => {
+        if (!Array.isArray(value))
+            return 0;
+        if (typeof fn === 'function')
+            return value.filter(item => fn(createDSLProxy(item))).length;
+        return value.length;
+    },
+    first: (value, fn) => {
+        if (!Array.isArray(value))
+            return null;
+        if (typeof fn === 'function')
+            return value.find(item => fn(createDSLProxy(item))) ?? null;
+        return value[0] ?? null;
+    },
+    last: (value, n) => {
+        if (!Array.isArray(value))
+            return [];
+        if (typeof n === 'number')
+            return value.slice(-n);
+        return value.slice(-1);
+    },
+    flat: (value) => Array.isArray(value) ? value.flat() : value,
+    abs: (value) => typeof value === 'number' ? Math.abs(value) : value,
+    clamp: (value, min, max) => {
+        if (typeof value !== 'number' || typeof min !== 'number' || typeof max !== 'number')
+            return value;
+        return Math.min(Math.max(value, min), max);
+    },
+    basename: (value) => {
+        if (typeof value !== 'string')
+            return value;
+        const parts = value.split('/');
+        return parts[parts.length - 1] || '';
+    },
+    dirname: (value) => {
+        if (typeof value !== 'string')
+            return value;
+        const parts = value.split('/');
+        parts.pop();
+        return parts.join('/') || '/';
+    },
+    extname: (value) => {
+        if (typeof value !== 'string')
+            return value;
+        const dot = value.lastIndexOf('.');
+        return dot >= 0 ? value.slice(dot) : '';
+    },
+};
+/**
+ * Create a DSL Proxy wrapping any value with extension methods.
+ * Native methods take priority; DSL methods are fallback.
+ */
+export function createDSLProxy(value) {
+    if (value == null)
+        return value;
+    if (typeof value !== 'object' && typeof value !== 'string')
+        return value;
+    const unwrapped = value;
+    return new Proxy(Object(value), {
+        get(target, prop, receiver) {
+            if (prop === Symbol.toPrimitive) {
+                return (hint) => {
+                    if (hint === 'number')
+                        return Number(unwrapped);
+                    if (hint === 'string')
+                        return String(unwrapped);
+                    return unwrapped;
+                };
+            }
+            if (prop === 'valueOf')
+                return () => unwrapped;
+            if (prop === Symbol.iterator && Array.isArray(unwrapped)) {
+                return () => unwrapped[Symbol.iterator]();
+            }
+            if (prop === 'length') {
+                if (Array.isArray(unwrapped))
+                    return unwrapped.length;
+                if (typeof unwrapped === 'string')
+                    return unwrapped.length;
+                return Reflect.get(target, prop, receiver);
+            }
+            const methodName = String(prop);
+            // DSL extension methods (when no native method exists)
+            if (methodName in DSL_METHODS) {
+                const hasNative = typeof unwrapped === 'object' && unwrapped !== null && methodName in unwrapped;
+                if (!hasNative) {
+                    return (...args) => DSL_METHODS[methodName](unwrapped, ...args);
+                }
+            }
+            // Arrays: call methods on the original array
+            if (Array.isArray(unwrapped)) {
+                const arrMethod = unwrapped[methodName];
+                if (typeof arrMethod === 'function') {
+                    return (...args) => {
+                        const result = arrMethod.apply(unwrapped, args);
+                        if (result != null && typeof result === 'object') {
+                            return createDSLProxy(result);
+                        }
+                        return result;
+                    };
+                }
+                return Reflect.get(target, prop, receiver);
+            }
+            // Strings: call methods on the original string
+            if (typeof unwrapped === 'string') {
+                const strMethod = unwrapped[methodName];
+                if (typeof strMethod === 'function') {
+                    return (...args) => {
+                        const result = strMethod.apply(unwrapped, args);
+                        if (result != null && typeof result === 'object') {
+                            return createDSLProxy(result);
+                        }
+                        return result;
+                    };
+                }
+                return unwrapped[methodName];
+            }
+            // Other objects
+            const nativeValue = Reflect.get(target, prop, receiver);
+            if (typeof nativeValue === 'function') {
+                return (...args) => {
+                    const result = nativeValue.apply(target, args);
+                    if (result != null && typeof result === 'object') {
+                        return createDSLProxy(result);
+                    }
+                    return result;
+                };
+            }
+            if (nativeValue != null && typeof nativeValue === 'object') {
+                return createDSLProxy(nativeValue);
+            }
+            return nativeValue;
+        },
+    });
+}
+/**
+ * Enhance a RuleContext with DSL proxy wrapping on all properties.
+ */
+export function enhanceContext(ctx) {
+    return new Proxy(ctx, {
+        get(target, prop) {
+            const value = Reflect.get(target, prop);
+            if (value == null)
+                return value;
+            if (typeof value === 'function')
+                return value;
+            if (typeof value === 'object') {
+                if (Array.isArray(value)) {
+                    return createDSLProxy(value);
+                }
+                if (value instanceof RegExp) {
+                    return value;
+                }
+                return enhanceContext(value);
+            }
+            return createDSLProxy(value);
+        },
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/engine/dsl/runtime.js.map

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

package/dist/engine/dsl/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Convention DSL type definitions
+ *
+ * Core concepts:
+ * - Convention: a collection of governance rules
+ * - Rule: a single rule (forbidden / escalation)
+ * - RuleContext: runtime context for rule evaluation
+ * - GovernanceDecision: rule evaluation result
+ */
+export type DecisionLevel = 'allow' | 'warn' | 'confirm' | 'block';
+export interface GovernanceDecision {
+    level: DecisionLevel;
+    rule_id?: string;
+    reason?: string;
+    suggestion?: string;
+}
+export interface Convention {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    extends?: string[];
+    variables: Record<string, unknown>;
+    forbidden: Rule[];
+    escalation: EscalationRule[];
+    deliverables: Deliverable[];
+    overrides: RuleOverride[];
+    principles: string;
+}
+export interface Rule {
+    id: string;
+    when: string;
+    level: DecisionLevel;
+    message: string;
+    suggestion?: string;
+    enabled?: boolean;
+}
+export interface EscalationRule {
+    id: string;
+    when: string;
+    action: DecisionLevel;
+    message: string;
+    suggestion?: string;
+    enabled?: boolean;
+}
+export interface Deliverable {
+    name: string;
+    pattern?: string;
+    command?: string;
+    required: boolean;
+    check_at: 'session_end' | 'before_commit' | 'on_demand';
+    condition?: string;
+}
+export interface RuleOverride {
+    rule_id: string;
+    level?: DecisionLevel;
+    message?: string;
+    enabled?: boolean;
+}
+export interface ConventionBinding {
+    convention_id: string;
+    project_path: string;
+    enabled: boolean;
+    disabled_rules: string[];
+    overrides: RuleOverride[];
+    created_at: number;
+}
+export interface ToolEvent {
+    tool: string;
+    args: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    success: boolean;
+    error?: string;
+    timestamp: number;
+}
+export interface RuleContext {
+    tool: string;
+    args: Record<string, unknown>;
+    file_path: string | null;
+    file_ext: string | null;
+    file_dir: string | null;
+    session: {
+        id: string;
+        phase: string;
+        duration_minutes: number;
+    };
+    git: {
+        branch: string;
+        has_uncommitted: boolean;
+    };
+    history: {
+        last(n: number): ToolEvent[];
+        consecutive_failures: number;
+        file_changes: string[];
+        tool_calls: number;
+    };
+    vars: Record<string, unknown>;
+}
+export type CompiledExpression = (ctx: RuleContext) => boolean;
+export interface CompiledRule {
+    id: string;
+    level: DecisionLevel;
+    message: string;
+    suggestion?: string;
+    evaluate: CompiledExpression;
+    render: (ctx: RuleContext) => string;
+    source_convention: string;
+}
+export interface RuleIndex {
+    byTool: Map<string, CompiledRule[]>;
+    global: CompiledRule[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/dsl/types.d.ts.map

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

package/dist/engine/dsl/types.js

@@ -0,0 +1,11 @@
+/**
+ * Convention DSL type definitions
+ *
+ * Core concepts:
+ * - Convention: a collection of governance rules
+ * - Rule: a single rule (forbidden / escalation)
+ * - RuleContext: runtime context for rule evaluation
+ * - GovernanceDecision: rule evaluation result
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/dsl/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/dsl/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/engine/evidence-store.d.ts

@@ -0,0 +1,44 @@
+/**
+ * EvidenceStore — evidence storage
+ *
+ * Records tool calls and governance decisions, provides history queries.
+ * In-memory implementation with optional persistence callback.
+ */
+import type { ToolEvent, GovernanceDecision } from './dsl/types.js';
+export interface DecisionRecord {
+    decision: GovernanceDecision;
+    event: ToolEvent;
+    user_choice?: string;
+    timestamp: number;
+}
+export interface SessionStats {
+    tool_calls: number;
+    file_changes: string[];
+    consecutive_failures: number;
+    total_failures: number;
+    total_blocks: number;
+    total_warns: number;
+}
+/** Optional persistence interface — implement to persist evidence to DB */
+export interface EvidencePersistence {
+    insertEvent(sessionId: string, event: ToolEvent): Promise<string>;
+    insertDecision(sessionId: string, eventId: string, decision: GovernanceDecision, userChoice?: string): Promise<void>;
+    updateStats(sessionId: string, stats: SessionStats): Promise<void>;
+}
+export declare class EvidenceStore {
+    private events;
+    private decisions;
+    private stats;
+    private persistence?;
+    constructor(persistence?: EvidencePersistence);
+    recordEvent(sessionId: string, event: ToolEvent): void;
+    recordDecision(sessionId: string, decision: GovernanceDecision, event: ToolEvent, userChoice?: string): void;
+    getEvents(sessionId: string): ToolEvent[];
+    getLastEvents(sessionId: string, n: number): ToolEvent[];
+    getDecisions(sessionId: string): DecisionRecord[];
+    getStats(sessionId: string): SessionStats;
+    clearSession(sessionId: string): void;
+    private updateStats;
+    private getOrCreateStats;
+}
+//# sourceMappingURL=evidence-store.d.ts.map

package/dist/engine/evidence-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-store.d.ts","sourceRoot":"","sources":["../../src/engine/evidence-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,WAAW,CAAC,CAAsB;gBAE9B,WAAW,CAAC,EAAE,mBAAmB;IAI7C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAkBtD,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IA2BP,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAIjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAIzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMrC,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,gBAAgB;CAazB"}