@red-codes/agentguard 1.0.0 → 1.1.1

package/dist/kernel/replay-comparator.d.ts

@@ -1,72 +0,0 @@
-import type { DomainEvent } from '../core/types.js';
-import type { ReplayAction, ReplaySession, ReplaySessionSummary, ReplayLoadOptions } from './replay-engine.js';
-/** The result of comparing a single field between original and replayed. */
-export interface FieldDifference {
-    readonly field: string;
-    readonly original: unknown;
-    readonly replayed: unknown;
-}
-/** Comparison status for a single action. */
-export type ComparisonStatus = 'match' | 'divergent' | 'missing' | 'extra';
-/** Side-by-side comparison of a single action encounter. */
-export interface ActionComparison {
-    /** Position in the comparison list (0-based). */
-    readonly index: number;
-    /** Whether the action matched, diverged, or was only in one session. */
-    readonly status: ComparisonStatus;
-    /** The action from the original session (null if status is 'extra'). */
-    readonly original: ReplayAction | null;
-    /** The action from the replayed session (null if status is 'missing'). */
-    readonly replayed: ReplayAction | null;
-    /** Field-level differences (empty for 'match', 'missing', 'extra'). */
-    readonly differences: readonly FieldDifference[];
-}
-/** Diff of session-level summary statistics. */
-export interface SummaryDiff {
-    readonly original: ReplaySessionSummary;
-    readonly replayed: ReplaySessionSummary;
-    readonly differences: readonly FieldDifference[];
-}
-/** Full comparison report between two governance sessions. */
-export interface ComparisonReport {
-    readonly originalRunId: string;
-    readonly replayedRunId: string;
-    /** Total number of action comparisons performed. */
-    readonly totalComparisons: number;
-    /** Number of actions that produced identical decisions. */
-    readonly matches: number;
-    /** Number of actions that produced different decisions. */
-    readonly divergences: number;
-    /** Number of actions present in original but absent in replayed. */
-    readonly missing: number;
-    /** Number of actions present in replayed but absent in original. */
-    readonly extra: number;
-    /** Per-action comparison details. */
-    readonly comparisons: readonly ActionComparison[];
-    /** Session-level summary diff. */
-    readonly summaryDiff: SummaryDiff;
-    /** Whether the two sessions produced identical governance decisions. */
-    readonly identical: boolean;
-}
-/**
- * Compare two replay sessions action-by-action.
- *
- * Actions are matched by position (index). If one session has more actions
- * than the other, the extra actions are reported as 'missing' or 'extra'.
- */
-export declare function compareReplaySessions(original: ReplaySession, replayed: ReplaySession): ComparisonReport;
-/**
- * Compare two sessions by run ID, loading from JSONL files.
- * Returns null if either session cannot be loaded.
- */
-export declare function compareRunIds(originalRunId: string, replayedRunId: string, options?: ReplayLoadOptions): ComparisonReport | null;
-/**
- * Compare an original session against an in-memory event array.
- * Useful for re-evaluating a recorded session with a modified policy.
- */
-export declare function compareSessionWithEvents(original: ReplaySession, replayedEvents: DomainEvent[], replayedRunId?: string): ComparisonReport;
-/**
- * Format a comparison report as a human-readable string.
- */
-export declare function formatComparisonReport(report: ComparisonReport): string;
-//# sourceMappingURL=replay-comparator.d.ts.map

package/dist/kernel/replay-comparator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"replay-comparator.d.ts","sourceRoot":"","sources":["../../src/kernel/replay-comparator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAO5B,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3E,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAqFD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,GACtB,gBAAgB,CA2ElB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,GAAG,IAAI,CAOzB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,WAAW,EAAE,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAGlB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA2EvE"}

package/dist/kernel/replay-comparator.js

@@ -1,251 +0,0 @@
-// Replay Comparator — diffs two governance sessions to detect decision changes.
-//
-// Compares original vs replayed outcomes action-by-action, producing a structured
-// report of matching decisions, divergences, and missing/extra actions.
-// Use cases: policy regression testing, kernel correctness verification, audit validation.
-import { loadReplaySession, buildReplaySession } from './replay-engine.js';
-// ---------------------------------------------------------------------------
-// Action Comparison
-// ---------------------------------------------------------------------------
-/** Fields compared on each action to determine match vs divergence. */
-const COMPARED_FIELDS = ['allowed', 'executed', 'succeeded', 'actionType', 'target'];
-/**
- * Compare two ReplayAction objects field-by-field.
- * Returns an array of field differences (empty if they match).
- */
-function diffActions(original, replayed) {
-    const differences = [];
-    for (const field of COMPARED_FIELDS) {
-        const origVal = original[field];
-        const replayVal = replayed[field];
-        if (origVal !== replayVal) {
-            differences.push({ field, original: origVal, replayed: replayVal });
-        }
-    }
-    // Compare governance event counts
-    const origGovCount = original.governanceEvents.length;
-    const replayGovCount = replayed.governanceEvents.length;
-    if (origGovCount !== replayGovCount) {
-        differences.push({
-            field: 'governanceEventCount',
-            original: origGovCount,
-            replayed: replayGovCount,
-        });
-    }
-    // Compare denial reasons (from decision events)
-    const origReason = original.decisionEvent?.reason ?? null;
-    const replayReason = replayed.decisionEvent?.reason ?? null;
-    if (origReason !== replayReason) {
-        differences.push({ field: 'decisionReason', original: origReason, replayed: replayReason });
-    }
-    return differences;
-}
-// ---------------------------------------------------------------------------
-// Summary Comparison
-// ---------------------------------------------------------------------------
-/** Summary fields to compare. */
-const SUMMARY_FIELDS = [
-    'totalActions',
-    'allowed',
-    'denied',
-    'executed',
-    'failed',
-    'violations',
-    'escalations',
-    'simulationsRun',
-];
-/**
- * Compare two session summaries field-by-field.
- */
-function diffSummaries(original, replayed) {
-    const differences = [];
-    for (const field of SUMMARY_FIELDS) {
-        const origVal = original[field];
-        const replayVal = replayed[field];
-        if (origVal !== replayVal) {
-            differences.push({ field, original: origVal, replayed: replayVal });
-        }
-    }
-    return differences;
-}
-// ---------------------------------------------------------------------------
-// Core Comparator
-// ---------------------------------------------------------------------------
-/**
- * Compare two replay sessions action-by-action.
- *
- * Actions are matched by position (index). If one session has more actions
- * than the other, the extra actions are reported as 'missing' or 'extra'.
- */
-export function compareReplaySessions(original, replayed) {
-    const origActions = original.actions;
-    const replayActions = replayed.actions;
-    const maxLen = Math.max(origActions.length, replayActions.length);
-    const comparisons = [];
-    let matches = 0;
-    let divergences = 0;
-    let missing = 0;
-    let extra = 0;
-    for (let i = 0; i < maxLen; i++) {
-        const origAction = i < origActions.length ? origActions[i] : null;
-        const replayAction = i < replayActions.length ? replayActions[i] : null;
-        if (origAction && replayAction) {
-            const differences = diffActions(origAction, replayAction);
-            if (differences.length === 0) {
-                comparisons.push({
-                    index: i,
-                    status: 'match',
-                    original: origAction,
-                    replayed: replayAction,
-                    differences,
-                });
-                matches++;
-            }
-            else {
-                comparisons.push({
-                    index: i,
-                    status: 'divergent',
-                    original: origAction,
-                    replayed: replayAction,
-                    differences,
-                });
-                divergences++;
-            }
-        }
-        else if (origAction && !replayAction) {
-            comparisons.push({
-                index: i,
-                status: 'missing',
-                original: origAction,
-                replayed: null,
-                differences: [],
-            });
-            missing++;
-        }
-        else if (!origAction && replayAction) {
-            comparisons.push({
-                index: i,
-                status: 'extra',
-                original: null,
-                replayed: replayAction,
-                differences: [],
-            });
-            extra++;
-        }
-    }
-    const summaryDiff = {
-        original: original.summary,
-        replayed: replayed.summary,
-        differences: diffSummaries(original.summary, replayed.summary),
-    };
-    return {
-        originalRunId: original.runId,
-        replayedRunId: replayed.runId,
-        totalComparisons: comparisons.length,
-        matches,
-        divergences,
-        missing,
-        extra,
-        comparisons,
-        summaryDiff,
-        identical: divergences === 0 && missing === 0 && extra === 0,
-    };
-}
-// ---------------------------------------------------------------------------
-// Convenience API
-// ---------------------------------------------------------------------------
-/**
- * Compare two sessions by run ID, loading from JSONL files.
- * Returns null if either session cannot be loaded.
- */
-export function compareRunIds(originalRunId, replayedRunId, options = {}) {
-    const original = loadReplaySession(originalRunId, options);
-    const replayed = loadReplaySession(replayedRunId, options);
-    if (!original || !replayed)
-        return null;
-    return compareReplaySessions(original, replayed);
-}
-/**
- * Compare an original session against an in-memory event array.
- * Useful for re-evaluating a recorded session with a modified policy.
- */
-export function compareSessionWithEvents(original, replayedEvents, replayedRunId) {
-    const replayed = buildReplaySession(replayedRunId || `${original.runId}-replay`, replayedEvents);
-    return compareReplaySessions(original, replayed);
-}
-// ---------------------------------------------------------------------------
-// Report Formatting
-// ---------------------------------------------------------------------------
-/**
- * Format a comparison report as a human-readable string.
- */
-export function formatComparisonReport(report) {
-    const lines = [];
-    lines.push('Replay Comparison Report');
-    lines.push('========================');
-    lines.push(`Original: ${report.originalRunId}`);
-    lines.push(`Replayed: ${report.replayedRunId}`);
-    lines.push('');
-    // Overall result
-    if (report.identical) {
-        lines.push('Result: IDENTICAL — all governance decisions match.');
-    }
-    else {
-        lines.push('Result: DIVERGENT — governance decisions differ.');
-    }
-    lines.push('');
-    // Stats
-    lines.push('Summary:');
-    lines.push(`  Total comparisons: ${report.totalComparisons}`);
-    lines.push(`  Matches:           ${report.matches}`);
-    lines.push(`  Divergences:       ${report.divergences}`);
-    lines.push(`  Missing (original only): ${report.missing}`);
-    lines.push(`  Extra (replayed only):   ${report.extra}`);
-    lines.push('');
-    // Divergent actions
-    const divergent = report.comparisons.filter((c) => c.status === 'divergent');
-    if (divergent.length > 0) {
-        lines.push('Divergent Actions:');
-        lines.push('------------------');
-        for (const comp of divergent) {
-            const actionType = comp.original?.actionType || comp.replayed?.actionType || 'unknown';
-            const target = comp.original?.target || comp.replayed?.target || '';
-            lines.push(`  [${comp.index}] ${actionType} → ${target}`);
-            for (const diff of comp.differences) {
-                lines.push(`    ${diff.field}: ${String(diff.original)} → ${String(diff.replayed)}`);
-            }
-        }
-        lines.push('');
-    }
-    // Missing actions
-    const missingActions = report.comparisons.filter((c) => c.status === 'missing');
-    if (missingActions.length > 0) {
-        lines.push('Missing Actions (in original, not in replayed):');
-        lines.push('-----------------------------------------------');
-        for (const comp of missingActions) {
-            lines.push(`  [${comp.index}] ${comp.original.actionType} → ${comp.original.target}`);
-        }
-        lines.push('');
-    }
-    // Extra actions
-    const extraActions = report.comparisons.filter((c) => c.status === 'extra');
-    if (extraActions.length > 0) {
-        lines.push('Extra Actions (in replayed, not in original):');
-        lines.push('---------------------------------------------');
-        for (const comp of extraActions) {
-            lines.push(`  [${comp.index}] ${comp.replayed.actionType} → ${comp.replayed.target}`);
-        }
-        lines.push('');
-    }
-    // Summary-level diffs
-    if (report.summaryDiff.differences.length > 0) {
-        lines.push('Summary Differences:');
-        lines.push('--------------------');
-        for (const diff of report.summaryDiff.differences) {
-            lines.push(`  ${diff.field}: ${String(diff.original)} → ${String(diff.replayed)}`);
-        }
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=replay-comparator.js.map

package/dist/kernel/replay-comparator.js.map

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

package/dist/kernel/replay-engine.d.ts

@@ -1,108 +0,0 @@
-import type { DomainEvent, EventKind } from '../core/types.js';
-/** A single action encounter — the full lifecycle of one proposed action. */
-export interface ReplayAction {
-    /** The index of this action in the session (0-based). */
-    readonly index: number;
-    /** The ActionRequested event that started this encounter. */
-    readonly requestedEvent: DomainEvent;
-    /** The ActionAllowed or ActionDenied decision event (null if stream truncated). */
-    readonly decisionEvent: DomainEvent | null;
-    /** The ActionExecuted or ActionFailed result (null if denied or dry-run). */
-    readonly executionEvent: DomainEvent | null;
-    /** The SimulationCompleted event if pre-execution simulation ran. */
-    readonly simulationEvent: DomainEvent | null;
-    /** The DecisionRecorded audit event. */
-    readonly decisionRecordEvent: DomainEvent | null;
-    /** ActionEscalated event if the action was escalated. */
-    readonly escalationEvent: DomainEvent | null;
-    /** Governance violation events (PolicyDenied, InvariantViolation, etc.). */
-    readonly governanceEvents: readonly DomainEvent[];
-    /** Whether this action was ultimately allowed. */
-    readonly allowed: boolean;
-    /** Whether this action was executed (allowed + not dry-run). */
-    readonly executed: boolean;
-    /** Whether execution succeeded (false if ActionFailed). */
-    readonly succeeded: boolean;
-    /** Action type from the requested event (e.g. 'file.write', 'git.push'). */
-    readonly actionType: string;
-    /** Target from the requested event. */
-    readonly target: string;
-}
-/** Session-level summary statistics. */
-export interface ReplaySessionSummary {
-    readonly totalActions: number;
-    readonly allowed: number;
-    readonly denied: number;
-    readonly executed: number;
-    readonly failed: number;
-    readonly violations: number;
-    readonly escalations: number;
-    readonly simulationsRun: number;
-    readonly durationMs: number;
-    readonly actionTypes: Readonly<Record<string, number>>;
-    readonly denialReasons: readonly string[];
-}
-/** A fully reconstructed governance session. */
-export interface ReplaySession {
-    /** The run ID extracted from events or the JSONL filename. */
-    readonly runId: string;
-    /** All raw events in timestamp order. */
-    readonly events: readonly DomainEvent[];
-    /** Reconstructed action encounters, in order. */
-    readonly actions: readonly ReplayAction[];
-    /** Session-level summary statistics. */
-    readonly summary: ReplaySessionSummary;
-    /** The RunStarted event (if present). */
-    readonly startEvent: DomainEvent | null;
-    /** The RunEnded event (if present). */
-    readonly endEvent: DomainEvent | null;
-}
-/** Options for loading a replay session. */
-export interface ReplayLoadOptions {
-    /** Base directory containing the events/ folder. Defaults to '.agentguard'. */
-    readonly baseDir?: string;
-}
-/**
- * Load domain events from a JSONL file.
- * Each line is a JSON-serialized DomainEvent.
- * Malformed lines are silently skipped.
- */
-export declare function loadEventsFromJsonl(filePath: string): DomainEvent[];
-/**
- * Resolve the JSONL file path for a given run ID.
- */
-export declare function resolveEventFilePath(runId: string, baseDir?: string): string;
-/**
- * List all available run IDs that have stored events.
- */
-export declare function listRunIds(baseDir?: string): string[];
-/**
- * Load a replay session from a JSONL event file by run ID.
- * Returns null if the file does not exist.
- */
-export declare function loadReplaySession(runId: string, options?: ReplayLoadOptions): ReplaySession | null;
-/**
- * Build a replay session from an in-memory event array.
- * Useful for testing and when events are already loaded.
- */
-export declare function buildReplaySession(runId: string, events: DomainEvent[]): ReplaySession;
-/**
- * Iterator for stepping through action encounters one at a time.
- * Yields ReplayAction objects in chronological order.
- */
-export declare function iterateActions(session: ReplaySession): Generator<ReplayAction>;
-/**
- * Filter a replay session's actions by a predicate.
- * Returns a new session with only matching actions (events are not filtered).
- */
-export declare function filterActions(session: ReplaySession, predicate: (action: ReplayAction) => boolean): ReplaySession;
-/**
- * Get the most recent run ID from stored events.
- * Returns null if no runs exist.
- */
-export declare function getLatestRunId(baseDir?: string): string | null;
-/**
- * Extract the event kinds present in a session as a frequency map.
- */
-export declare function getEventKindCounts(session: ReplaySession): Record<EventKind, number>;
-//# sourceMappingURL=replay-engine.d.ts.map

package/dist/kernel/replay-engine.d.ts.map

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