@red-codes/agentguard 1.0.0

package/dist/core/execution-log/event-log.js

@@ -0,0 +1,103 @@
+// Execution Event Log — append-only event log with causal chain support.
+// Stores execution events and supports query, replay, trace, and NDJSON serialization.
+// No DOM, no Node.js APIs — pure domain logic.
+import { validateExecutionEvent } from './event-schema.js';
+/**
+ * Create an in-memory execution event log.
+ * Append-only with support for causal chain tracing and NDJSON persistence.
+ */
+export function createExecutionEventLog() {
+    let events = [];
+    const indexById = new Map();
+    function rebuildIndex() {
+        indexById.clear();
+        for (let i = 0; i < events.length; i++) {
+            indexById.set(events[i].id, i);
+        }
+    }
+    return {
+        append(event) {
+            const { valid, errors } = validateExecutionEvent(event);
+            if (!valid) {
+                throw new Error(`Cannot append invalid execution event: ${errors.join('; ')}`);
+            }
+            if (event.causedBy && !indexById.has(event.causedBy)) {
+                // causedBy references must point to events already in the log,
+                // or to events from a previous session (allow unknown references)
+            }
+            indexById.set(event.id, events.length);
+            events.push(event);
+        },
+        query(filter = {}) {
+            let result = events;
+            if (filter.kind) {
+                result = result.filter((e) => e.kind === filter.kind);
+            }
+            if (filter.actor) {
+                result = result.filter((e) => e.actor === filter.actor);
+            }
+            if (filter.source) {
+                result = result.filter((e) => e.source === filter.source);
+            }
+            if (filter.since !== undefined) {
+                result = result.filter((e) => e.timestamp >= filter.since);
+            }
+            if (filter.until !== undefined) {
+                result = result.filter((e) => e.timestamp <= filter.until);
+            }
+            if (filter.agentRunId) {
+                result = result.filter((e) => e.context.agentRunId === filter.agentRunId);
+            }
+            if (filter.file) {
+                result = result.filter((e) => e.context.file === filter.file);
+            }
+            return result;
+        },
+        replay(fromId) {
+            if (!fromId)
+                return [...events];
+            const idx = indexById.get(fromId);
+            if (idx === undefined)
+                return [];
+            return events.slice(idx);
+        },
+        trace(eventId) {
+            const chain = [];
+            const visited = new Set();
+            let currentId = eventId;
+            while (currentId && !visited.has(currentId)) {
+                visited.add(currentId);
+                const idx = indexById.get(currentId);
+                if (idx === undefined)
+                    break;
+                const event = events[idx];
+                chain.unshift(event);
+                currentId = event.causedBy;
+            }
+            return chain;
+        },
+        count() {
+            return events.length;
+        },
+        clear() {
+            events = [];
+            indexById.clear();
+        },
+        toNDJSON() {
+            return events.map((e) => JSON.stringify(e)).join('\n');
+        },
+        fromNDJSON(ndjson) {
+            const lines = ndjson.split('\n').filter((line) => line.trim().length > 0);
+            let loaded = 0;
+            for (const line of lines) {
+                const parsed = JSON.parse(line);
+                indexById.set(parsed.id, events.length);
+                events.push(parsed);
+                loaded++;
+            }
+            rebuildIndex();
+            return loaded;
+        },
+    };
+}
+//# sourceMappingURL=event-log.js.map

package/dist/core/execution-log/event-log.js.map

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

package/dist/core/execution-log/event-projections.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionEvent, ExecutionEventLog, FailureCluster, EncounterMapping, RiskScore } from '../types.js';
+/**
+ * Build the full causal chain leading to an event.
+ * Walks `causedBy` references back to the root cause.
+ * Returns events in chronological order (root first).
+ */
+export declare function buildCausalChain(log: ExecutionEventLog, eventId: string): ExecutionEvent[];
+/**
+ * Score an agent run by its risk profile.
+ * Higher score = more risk. Based on failures, violations,
+ * skipped tests, sensitive file edits, and action velocity.
+ */
+export declare function scoreAgentRun(log: ExecutionEventLog, agentRunId: string): RiskScore;
+export interface ClusterOptions {
+    readonly windowMs?: number;
+}
+/**
+ * Cluster related failures by file and time proximity.
+ * Groups failures that share a common file or occur within a time window.
+ */
+export declare function clusterFailures(log: ExecutionEventLog, options?: ClusterOptions): FailureCluster[];
+/**
+ * Map an execution event to a game encounter.
+ * Only failure events produce encounters.
+ * Returns null for non-failure events.
+ */
+export declare function mapToEncounter(event: ExecutionEvent): EncounterMapping | null;
+//# sourceMappingURL=event-projections.d.ts.map

package/dist/core/execution-log/event-projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-projections.d.ts","sourceRoot":"","sources":["../../../src/core/execution-log/event-projections.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,SAAS,EAGV,MAAM,aAAa,CAAC;AAerB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1F;AA6BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAsFnF;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,cAAmB,GAC3B,cAAc,EAAE,CA0FlB;AA8CD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAe7E"}

package/dist/core/execution-log/event-projections.js

@@ -0,0 +1,272 @@
+// Execution Event Projections — derived views from the execution event stream.
+// Causal chain construction, risk scoring, failure clustering, encounter mapping.
+// No DOM, no Node.js APIs — pure domain logic.
+import { simpleHash } from '../hash.js';
+import { FAILURE_KINDS, VIOLATION_KINDS, AGENT_ACTION_KINDS, TESTS_SKIPPED, RUNTIME_EXCEPTION, TEST_SUITE_FAILED, DEPLOYMENT_FAILED, BUILD_FAILED, } from './event-schema.js';
+// --- Causal Chain ---
+/**
+ * Build the full causal chain leading to an event.
+ * Walks `causedBy` references back to the root cause.
+ * Returns events in chronological order (root first).
+ */
+export function buildCausalChain(log, eventId) {
+    return log.trace(eventId);
+}
+// --- Risk Scoring ---
+const RISK_WEIGHTS = {
+    failure: 10,
+    violation: 25,
+    skippedTests: 15,
+    sensitiveFileEdit: 20,
+    highActionRate: 5,
+};
+const SENSITIVE_PATTERNS = [
+    /auth/i,
+    /security/i,
+    /password/i,
+    /secret/i,
+    /key/i,
+    /token/i,
+    /credential/i,
+    /\.env/i,
+    /migration/i,
+    /deploy/i,
+];
+function isSensitiveFile(file) {
+    return SENSITIVE_PATTERNS.some((p) => p.test(file));
+}
+/**
+ * Score an agent run by its risk profile.
+ * Higher score = more risk. Based on failures, violations,
+ * skipped tests, sensitive file edits, and action velocity.
+ */
+export function scoreAgentRun(log, agentRunId) {
+    const events = log.query({ agentRunId });
+    const factors = [];
+    let totalScore = 0;
+    let failureCount = 0;
+    let violationCount = 0;
+    // Count failures
+    const failures = events.filter((e) => FAILURE_KINDS.has(e.kind));
+    failureCount = failures.length;
+    if (failureCount > 0) {
+        const weight = failureCount * RISK_WEIGHTS.failure;
+        totalScore += weight;
+        factors.push({
+            name: 'failures',
+            weight,
+            detail: `${failureCount} failure(s) during agent run`,
+        });
+    }
+    // Count violations
+    const violations = events.filter((e) => VIOLATION_KINDS.has(e.kind));
+    violationCount = violations.length;
+    if (violationCount > 0) {
+        const weight = violationCount * RISK_WEIGHTS.violation;
+        totalScore += weight;
+        factors.push({
+            name: 'violations',
+            weight,
+            detail: `${violationCount} policy/invariant violation(s)`,
+        });
+    }
+    // Skipped tests
+    const skipped = events.filter((e) => e.kind === TESTS_SKIPPED);
+    if (skipped.length > 0) {
+        totalScore += RISK_WEIGHTS.skippedTests;
+        factors.push({
+            name: 'skipped_tests',
+            weight: RISK_WEIGHTS.skippedTests,
+            detail: `Tests were skipped ${skipped.length} time(s)`,
+        });
+    }
+    // Sensitive file edits
+    const agentActions = events.filter((e) => AGENT_ACTION_KINDS.has(e.kind));
+    const sensitiveEdits = agentActions.filter((e) => e.context.file && isSensitiveFile(e.context.file));
+    if (sensitiveEdits.length > 0) {
+        const weight = sensitiveEdits.length * RISK_WEIGHTS.sensitiveFileEdit;
+        totalScore += weight;
+        factors.push({
+            name: 'sensitive_file_edits',
+            weight,
+            detail: `${sensitiveEdits.length} edit(s) to sensitive files`,
+        });
+    }
+    // High action rate (>50 actions in a single run is suspicious)
+    if (agentActions.length > 50) {
+        totalScore += RISK_WEIGHTS.highActionRate;
+        factors.push({
+            name: 'high_action_rate',
+            weight: RISK_WEIGHTS.highActionRate,
+            detail: `${agentActions.length} agent actions in a single run`,
+        });
+    }
+    // Determine risk level
+    let level;
+    if (totalScore >= 75)
+        level = 'critical';
+    else if (totalScore >= 40)
+        level = 'high';
+    else if (totalScore >= 15)
+        level = 'medium';
+    else
+        level = 'low';
+    return {
+        agentRunId,
+        score: totalScore,
+        level,
+        factors,
+        eventCount: events.length,
+        failureCount,
+        violationCount,
+    };
+}
+/**
+ * Cluster related failures by file and time proximity.
+ * Groups failures that share a common file or occur within a time window.
+ */
+export function clusterFailures(log, options = {}) {
+    const windowMs = options.windowMs ?? 60_000; // 1 minute default
+    const failures = log.query({}).filter((e) => FAILURE_KINDS.has(e.kind));
+    if (failures.length === 0)
+        return [];
+    // Group by file, then by time proximity
+    const byFile = new Map();
+    const noFile = [];
+    for (const event of failures) {
+        const file = event.context.file ?? event.payload.file;
+        if (file) {
+            const existing = byFile.get(file) ?? [];
+            existing.push(event);
+            byFile.set(file, existing);
+        }
+        else {
+            noFile.push(event);
+        }
+    }
+    const clusters = [];
+    // File-based clusters
+    for (const [file, fileEvents] of byFile) {
+        const sorted = [...fileEvents].sort((a, b) => a.timestamp - b.timestamp);
+        let clusterEvents = [sorted[0]];
+        for (let i = 1; i < sorted.length; i++) {
+            if (sorted[i].timestamp - sorted[i - 1].timestamp <= windowMs) {
+                clusterEvents.push(sorted[i]);
+            }
+            else {
+                if (clusterEvents.length > 0) {
+                    clusters.push({
+                        id: simpleHash(`cluster:${file}:${clusterEvents[0].id}`),
+                        rootEvent: clusterEvents[0],
+                        events: clusterEvents,
+                        commonFile: file,
+                        commonKind: getMostCommonKind(clusterEvents),
+                        severity: Math.min(5, clusterEvents.length),
+                    });
+                }
+                clusterEvents = [sorted[i]];
+            }
+        }
+        if (clusterEvents.length > 0) {
+            clusters.push({
+                id: simpleHash(`cluster:${file}:${clusterEvents[0].id}`),
+                rootEvent: clusterEvents[0],
+                events: clusterEvents,
+                commonFile: file,
+                commonKind: getMostCommonKind(clusterEvents),
+                severity: Math.min(5, clusterEvents.length),
+            });
+        }
+    }
+    // Time-based clusters for events without files
+    if (noFile.length > 0) {
+        const sorted = [...noFile].sort((a, b) => a.timestamp - b.timestamp);
+        let clusterEvents = [sorted[0]];
+        for (let i = 1; i < sorted.length; i++) {
+            if (sorted[i].timestamp - sorted[i - 1].timestamp <= windowMs) {
+                clusterEvents.push(sorted[i]);
+            }
+            else {
+                if (clusterEvents.length > 0) {
+                    clusters.push({
+                        id: simpleHash(`cluster:time:${clusterEvents[0].id}`),
+                        rootEvent: clusterEvents[0],
+                        events: clusterEvents,
+                        commonKind: getMostCommonKind(clusterEvents),
+                        severity: Math.min(5, clusterEvents.length),
+                    });
+                }
+                clusterEvents = [sorted[i]];
+            }
+        }
+        if (clusterEvents.length > 0) {
+            clusters.push({
+                id: simpleHash(`cluster:time:${clusterEvents[0].id}`),
+                rootEvent: clusterEvents[0],
+                events: clusterEvents,
+                commonKind: getMostCommonKind(clusterEvents),
+                severity: Math.min(5, clusterEvents.length),
+            });
+        }
+    }
+    return clusters.sort((a, b) => b.severity - a.severity);
+}
+function getMostCommonKind(events) {
+    const counts = new Map();
+    for (const e of events) {
+        counts.set(e.kind, (counts.get(e.kind) ?? 0) + 1);
+    }
+    let maxKind = events[0].kind;
+    let maxCount = 0;
+    for (const [kind, count] of counts) {
+        if (count > maxCount) {
+            maxKind = kind;
+            maxCount = count;
+        }
+    }
+    return maxKind;
+}
+// --- Encounter Mapping ---
+const KIND_TO_ENCOUNTER = {
+    [RUNTIME_EXCEPTION]: {
+        encounterType: 'monster',
+        severity: 3,
+        name: 'Runtime Wraith',
+    },
+    [TEST_SUITE_FAILED]: {
+        encounterType: 'monster',
+        severity: 2,
+        name: 'Test Phantom',
+    },
+    [BUILD_FAILED]: {
+        encounterType: 'monster',
+        severity: 2,
+        name: 'Build Specter',
+    },
+    [DEPLOYMENT_FAILED]: {
+        encounterType: 'boss',
+        severity: 4,
+        name: 'Deploy Colossus',
+    },
+};
+/**
+ * Map an execution event to a game encounter.
+ * Only failure events produce encounters.
+ * Returns null for non-failure events.
+ */
+export function mapToEncounter(event) {
+    const mapping = KIND_TO_ENCOUNTER[event.kind];
+    if (!mapping)
+        return null;
+    const description = event.payload.message
+        ? String(event.payload.message)
+        : `${event.kind} in ${event.context.file ?? 'unknown'}`;
+    return {
+        eventId: event.id,
+        encounterType: mapping.encounterType,
+        severity: mapping.severity,
+        name: mapping.name,
+        description,
+    };
+}
+//# sourceMappingURL=event-projections.js.map

package/dist/core/execution-log/event-projections.js.map

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

package/dist/core/execution-log/event-schema.d.ts

@@ -0,0 +1,56 @@
+import type { Actor, EventSource, ExecutionContext, ExecutionEvent, ValidationResult } from '../types.js';
+export declare const AGENT_EDIT_FILE = "AgentEditFile";
+export declare const AGENT_RUN_COMMAND = "AgentRunCommand";
+export declare const AGENT_CREATE_FILE = "AgentCreateFile";
+export declare const AGENT_DELETE_FILE = "AgentDeleteFile";
+export declare const TEST_SUITE_STARTED = "TestSuiteStarted";
+export declare const TEST_SUITE_PASSED = "TestSuitePassed";
+export declare const TEST_SUITE_FAILED = "TestSuiteFailed";
+export declare const TESTS_SKIPPED = "TestsSkipped";
+export declare const LINT_VIOLATION = "LintViolation";
+export declare const BUILD_STARTED = "BuildStarted";
+export declare const BUILD_SUCCEEDED = "BuildSucceeded";
+export declare const BUILD_FAILED = "BuildFailed";
+export declare const FILE_DELETED = "FileDeleted";
+export declare const DEPENDENCY_INSTALLED = "DependencyInstalled";
+export declare const DEPENDENCY_REMOVED = "DependencyRemoved";
+export declare const MIGRATION_EXECUTED = "MigrationExecuted";
+export declare const PR_CREATED = "PRCreated";
+export declare const PR_MERGED = "PRMerged";
+export declare const BRANCH_CREATED = "BranchCreated";
+export declare const RUNTIME_EXCEPTION = "RuntimeException";
+export declare const DEPLOYMENT_STARTED = "DeploymentStarted";
+export declare const DEPLOYMENT_SUCCEEDED = "DeploymentSucceeded";
+export declare const DEPLOYMENT_FAILED = "DeploymentFailed";
+export declare const POLICY_VIOLATION_DETECTED = "PolicyViolationDetected";
+export declare const INVARIANT_CHECK_FAILED = "InvariantCheckFailed";
+export declare const APPROVAL_REQUIRED = "ApprovalRequired";
+export declare const APPROVAL_GRANTED = "ApprovalGranted";
+/** All known execution event kinds */
+export declare const ALL_EXECUTION_EVENT_KINDS: Set<string>;
+/** Kinds that represent failures */
+export declare const FAILURE_KINDS: Set<string>;
+/** Kinds that represent governance violations */
+export declare const VIOLATION_KINDS: Set<string>;
+/** Kinds that represent agent actions */
+export declare const AGENT_ACTION_KINDS: Set<string>;
+/** Reset the counter. Exported for test determinism. */
+export declare function resetExecutionEventCounter(): void;
+/**
+ * Validate an execution event object.
+ */
+export declare function validateExecutionEvent(event: Record<string, unknown>): ValidationResult;
+export interface CreateExecutionEventOptions {
+    readonly actor: Actor;
+    readonly source: EventSource;
+    readonly context?: ExecutionContext;
+    readonly payload?: Record<string, unknown>;
+    readonly causedBy?: string;
+    readonly timestamp?: number;
+}
+/**
+ * Create a validated execution event.
+ * Assigns a unique ID and content fingerprint.
+ */
+export declare function createExecutionEvent(kind: string, options: CreateExecutionEventOptions): ExecutionEvent;
+//# sourceMappingURL=event-schema.d.ts.map

package/dist/core/execution-log/event-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-schema.d.ts","sourceRoot":"","sources":["../../../src/core/execution-log/event-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAMrB,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAGnD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAC5C,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAC5C,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAG1C,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,UAAU,cAAc,CAAC;AACtC,eAAO,MAAM,SAAS,aAAa,CAAC;AACpC,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAG9C,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAGpD,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,sCAAsC;AACtC,eAAO,MAAM,yBAAyB,aA4BpC,CAAC;AAEH,oCAAoC;AACpC,eAAO,MAAM,aAAa,aAOxB,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,eAAe,aAAuE,CAAC;AAEpG,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,aAK7B,CAAC;AAKH,wDAAwD;AACxD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAmBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CA2CvF;AAID,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,2BAA2B,GACnC,cAAc,CAyBhB"}

package/dist/core/execution-log/event-schema.js

@@ -0,0 +1,160 @@
+// Execution Event schema — defines the universal execution event format.
+// All development environment actions become execution events.
+// No DOM, no Node.js APIs — pure data definitions.
+import { simpleHash } from '../hash.js';
+// --- Execution Event Kinds ---
+// Agent actions
+export const AGENT_EDIT_FILE = 'AgentEditFile';
+export const AGENT_RUN_COMMAND = 'AgentRunCommand';
+export const AGENT_CREATE_FILE = 'AgentCreateFile';
+export const AGENT_DELETE_FILE = 'AgentDeleteFile';
+// CI/CD
+export const TEST_SUITE_STARTED = 'TestSuiteStarted';
+export const TEST_SUITE_PASSED = 'TestSuitePassed';
+export const TEST_SUITE_FAILED = 'TestSuiteFailed';
+export const TESTS_SKIPPED = 'TestsSkipped';
+export const LINT_VIOLATION = 'LintViolation';
+export const BUILD_STARTED = 'BuildStarted';
+export const BUILD_SUCCEEDED = 'BuildSucceeded';
+export const BUILD_FAILED = 'BuildFailed';
+// Git
+export const FILE_DELETED = 'FileDeleted';
+export const DEPENDENCY_INSTALLED = 'DependencyInstalled';
+export const DEPENDENCY_REMOVED = 'DependencyRemoved';
+export const MIGRATION_EXECUTED = 'MigrationExecuted';
+export const PR_CREATED = 'PRCreated';
+export const PR_MERGED = 'PRMerged';
+export const BRANCH_CREATED = 'BranchCreated';
+// Runtime
+export const RUNTIME_EXCEPTION = 'RuntimeException';
+export const DEPLOYMENT_STARTED = 'DeploymentStarted';
+export const DEPLOYMENT_SUCCEEDED = 'DeploymentSucceeded';
+export const DEPLOYMENT_FAILED = 'DeploymentFailed';
+// Governance
+export const POLICY_VIOLATION_DETECTED = 'PolicyViolationDetected';
+export const INVARIANT_CHECK_FAILED = 'InvariantCheckFailed';
+export const APPROVAL_REQUIRED = 'ApprovalRequired';
+export const APPROVAL_GRANTED = 'ApprovalGranted';
+/** All known execution event kinds */
+export const ALL_EXECUTION_EVENT_KINDS = new Set([
+    AGENT_EDIT_FILE,
+    AGENT_RUN_COMMAND,
+    AGENT_CREATE_FILE,
+    AGENT_DELETE_FILE,
+    TEST_SUITE_STARTED,
+    TEST_SUITE_PASSED,
+    TEST_SUITE_FAILED,
+    TESTS_SKIPPED,
+    LINT_VIOLATION,
+    BUILD_STARTED,
+    BUILD_SUCCEEDED,
+    BUILD_FAILED,
+    FILE_DELETED,
+    DEPENDENCY_INSTALLED,
+    DEPENDENCY_REMOVED,
+    MIGRATION_EXECUTED,
+    PR_CREATED,
+    PR_MERGED,
+    BRANCH_CREATED,
+    RUNTIME_EXCEPTION,
+    DEPLOYMENT_STARTED,
+    DEPLOYMENT_SUCCEEDED,
+    DEPLOYMENT_FAILED,
+    POLICY_VIOLATION_DETECTED,
+    INVARIANT_CHECK_FAILED,
+    APPROVAL_REQUIRED,
+    APPROVAL_GRANTED,
+]);
+/** Kinds that represent failures */
+export const FAILURE_KINDS = new Set([
+    TEST_SUITE_FAILED,
+    BUILD_FAILED,
+    RUNTIME_EXCEPTION,
+    DEPLOYMENT_FAILED,
+    POLICY_VIOLATION_DETECTED,
+    INVARIANT_CHECK_FAILED,
+]);
+/** Kinds that represent governance violations */
+export const VIOLATION_KINDS = new Set([POLICY_VIOLATION_DETECTED, INVARIANT_CHECK_FAILED]);
+/** Kinds that represent agent actions */
+export const AGENT_ACTION_KINDS = new Set([
+    AGENT_EDIT_FILE,
+    AGENT_RUN_COMMAND,
+    AGENT_CREATE_FILE,
+    AGENT_DELETE_FILE,
+]);
+// --- Event ID Generation ---
+let eventCounter = 0;
+/** Reset the counter. Exported for test determinism. */
+export function resetExecutionEventCounter() {
+    eventCounter = 0;
+}
+function generateId(timestamp) {
+    return `xev_${timestamp}_${++eventCounter}`;
+}
+function fingerprintExecutionEvent(kind, actor, source, payload) {
+    const payloadKeys = Object.keys(payload).sort();
+    const parts = payloadKeys.map((k) => `${k}=${JSON.stringify(payload[k])}`);
+    return simpleHash(`${kind}:${actor}:${source}:${parts.join(',')}`);
+}
+// --- Validation ---
+/**
+ * Validate an execution event object.
+ */
+export function validateExecutionEvent(event) {
+    const errors = [];
+    if (!event || typeof event !== 'object') {
+        return { valid: false, errors: ['ExecutionEvent must be a non-null object'] };
+    }
+    const requiredFields = ['id', 'timestamp', 'actor', 'source', 'kind', 'context', 'payload'];
+    for (const field of requiredFields) {
+        if (event[field] === undefined || event[field] === null) {
+            errors.push(`ExecutionEvent missing required field: ${field}`);
+        }
+    }
+    const validActors = ['human', 'agent', 'system'];
+    if (event.actor && !validActors.includes(event.actor)) {
+        errors.push(`Invalid actor: ${event.actor}. Must be one of: ${validActors.join(', ')}`);
+    }
+    const validSources = ['cli', 'ci', 'git', 'runtime', 'editor', 'governance'];
+    if (event.source && !validSources.includes(event.source)) {
+        errors.push(`Invalid source: ${event.source}. Must be one of: ${validSources.join(', ')}`);
+    }
+    if (event.context !== undefined &&
+        (typeof event.context !== 'object' || event.context === null)) {
+        errors.push('ExecutionEvent context must be an object');
+    }
+    if (event.payload !== undefined &&
+        (typeof event.payload !== 'object' || event.payload === null)) {
+        errors.push('ExecutionEvent payload must be an object');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Create a validated execution event.
+ * Assigns a unique ID and content fingerprint.
+ */
+export function createExecutionEvent(kind, options) {
+    const timestamp = options.timestamp ?? Date.now();
+    const context = options.context ?? {};
+    const payload = options.payload ?? {};
+    const id = generateId(timestamp);
+    const fingerprint = fingerprintExecutionEvent(kind, options.actor, options.source, payload);
+    const event = {
+        id,
+        timestamp,
+        actor: options.actor,
+        source: options.source,
+        kind,
+        context,
+        payload,
+        fingerprint,
+        ...(options.causedBy ? { causedBy: options.causedBy } : {}),
+    };
+    const { valid, errors } = validateExecutionEvent(event);
+    if (!valid) {
+        throw new Error(`Invalid execution event: ${errors.join('; ')}`);
+    }
+    return event;
+}
+//# sourceMappingURL=event-schema.js.map

package/dist/core/execution-log/event-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-schema.js","sourceRoot":"","sources":["../../../src/core/execution-log/event-schema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+DAA+D;AAC/D,mDAAmD;AASnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,gCAAgC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD,QAAQ;AACR,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,MAAM;AACN,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AACtC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAE9C,UAAU;AACV,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEpD,aAAa;AACb,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAElD,sCAAsC;AACtC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IACvD,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,aAAa;IACb,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,kBAAkB;IAClB,UAAU;IACV,SAAS;IACT,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;IACpB,iBAAiB;IACjB,yBAAyB;IACzB,sBAAsB;IACtB,iBAAiB;IACjB,gBAAgB;CACjB,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS;IAC3C,iBAAiB;IACjB,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,yBAAyB;IACzB,sBAAsB;CACvB,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAEpG,yCAAyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS;IAChD,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;CAClB,CAAC,CAAC;AAEH,8BAA8B;AAC9B,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,wDAAwD;AACxD,MAAM,UAAU,0BAA0B;IACxC,YAAY,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO,OAAO,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,yBAAyB,CAChC,IAAY,EACZ,KAAa,EACb,MAAc,EACd,OAAgC;IAEhC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,UAAU,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,qBAAqB;AAErB;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA8B;IACnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0CAA0C,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAc,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CACT,kBAAkB,KAAK,CAAC,KAAe,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC5F,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAqB,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CACT,mBAAmB,KAAK,CAAC,MAAgB,qBAAqB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,EAC7D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED,IACE,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,EAC7D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,OAAoC;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5F,MAAM,KAAK,GAAmB;QAC5B,EAAE;QACF,SAAS;QACT,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI;QACJ,OAAO;QACP,OAAO;QACP,WAAW;QACX,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,KAA2C,CAAC,CAAC;IAC9F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}