@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/audit/types.d.ts

@@ -0,0 +1,453 @@
+/**
+ * Exochain Audit Types
+ *
+ * Type definitions for deterministic logging events and chain operations.
+ * These types define the structure of the append-only audit log with
+ * DAG-based causality tracking and BFT consensus support.
+ *
+ * @module audit/types
+ */
+/**
+ * BLAKE3 hash type (32 bytes represented as 64-character hex string).
+ * Used for event IDs, Merkle roots, and content-addressable storage.
+ */
+export type Blake3Hash = string;
+/**
+ * Ed25519 signature type (64 bytes represented as 128-character hex string).
+ * Used for cryptographic signing of events and checkpoints.
+ */
+export type Ed25519Signature = string;
+/**
+ * Decentralized Identifier following the DID specification.
+ * Format: `did:method:method-specific-id`
+ *
+ * @example
+ * ```typescript
+ * const agentDid: Did = 'did:exo:agent-abc123';
+ * const peerDid: Did = 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK';
+ * ```
+ */
+export type Did = string;
+/**
+ * Hybrid Logical Clock for deterministic event ordering.
+ * Combines physical wall-clock time with a logical counter to provide
+ * causal ordering even with clock skew between agents.
+ *
+ * @see {@link https://cse.buffalo.edu/tech-reports/2014-04.pdf|HLC Paper}
+ */
+export interface HybridLogicalClock {
+    /** Physical time in milliseconds since Unix epoch */
+    physicalMs: number;
+    /** Logical counter for events at the same physical time */
+    logical: number;
+}
+/**
+ * Event payload for node creation in the knowledge graph.
+ */
+export interface NodeCreatedPayload {
+    type: 'NodeCreated';
+    /** Unique identifier for the node */
+    nodeId: string;
+    /** Type/label of the node (e.g., 'File', 'Function', 'Class') */
+    nodeType: string;
+    /** Node properties and metadata */
+    data: Record<string, unknown>;
+}
+/**
+ * Event payload for node updates in the knowledge graph.
+ */
+export interface NodeUpdatedPayload {
+    type: 'NodeUpdated';
+    /** Identifier of the updated node */
+    nodeId: string;
+    /** Changed properties (old values not stored for privacy) */
+    changes: Record<string, unknown>;
+}
+/**
+ * Event payload for node deletion in the knowledge graph.
+ */
+export interface NodeDeletedPayload {
+    type: 'NodeDeleted';
+    /** Identifier of the deleted node */
+    nodeId: string;
+}
+/**
+ * Event payload for edge creation in the knowledge graph.
+ */
+export interface EdgeCreatedPayload {
+    type: 'EdgeCreated';
+    /** Unique identifier for the edge */
+    edgeId: string;
+    /** Source node identifier */
+    sourceId: string;
+    /** Target node identifier */
+    targetId: string;
+    /** Relationship type (e.g., 'IMPORTS', 'CALLS', 'DEPENDS_ON') */
+    relation: string;
+}
+/**
+ * Event payload for edge deletion in the knowledge graph.
+ */
+export interface EdgeDeletedPayload {
+    type: 'EdgeDeleted';
+    /** Identifier of the deleted edge */
+    edgeId: string;
+}
+/**
+ * Event payload for query execution tracking.
+ */
+export interface QueryExecutedPayload {
+    type: 'QueryExecuted';
+    /** BLAKE3 hash of the query for deduplication */
+    queryHash: Blake3Hash;
+    /** Type of query (e.g., 'cypher', 'traversal', 'vector') */
+    queryType: string;
+    /** Number of results returned */
+    resultCount: number;
+}
+/**
+ * Event payload for workflow start.
+ */
+export interface WorkflowStartedPayload {
+    type: 'WorkflowStarted';
+    /** Unique workflow execution identifier */
+    workflowId: string;
+    /** Type of workflow (e.g., 'codebase-analysis', 'gap-detection') */
+    workflowType: string;
+    /** What triggered the workflow (e.g., 'manual', 'scheduled', 'event') */
+    trigger: string;
+}
+/**
+ * Event payload for workflow completion.
+ */
+export interface WorkflowCompletedPayload {
+    type: 'WorkflowCompleted';
+    /** Workflow execution identifier */
+    workflowId: string;
+    /** Final outcome of the workflow */
+    outcome: 'success' | 'failure' | 'timeout';
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Event payload for individual workflow step completion.
+ */
+export interface WorkflowStepCompletedPayload {
+    type: 'WorkflowStepCompleted';
+    /** Parent workflow identifier */
+    workflowId: string;
+    /** Unique step identifier */
+    stepId: string;
+    /** Action performed in this step */
+    action: string;
+    /** Step outcome description */
+    outcome: string;
+}
+/**
+ * Event payload for documentation gap detection.
+ */
+export interface GapDetectedPayload {
+    type: 'GapDetected';
+    /** Path to the document with gaps */
+    docPath: string;
+    /** List of identified gaps */
+    gaps: string[];
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Event payload for task specification generation.
+ */
+export interface TaskSpecGeneratedPayload {
+    type: 'TaskSpecGenerated';
+    /** Generated specification identifier */
+    specId: string;
+    /** Source document path */
+    sourceDoc: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+}
+/**
+ * Event payload for conflict detection between agents.
+ */
+export interface ConflictDetectedPayload {
+    type: 'ConflictDetected';
+    /** Resource being contested */
+    resourceId: string;
+    /** DIDs of agents in conflict */
+    conflictingAgents: Did[];
+}
+/**
+ * Event payload for conflict resolution.
+ */
+export interface ConflictResolvedPayload {
+    type: 'ConflictResolved';
+    /** Resource that was contested */
+    resourceId: string;
+    /** How the conflict was resolved */
+    resolution: string;
+    /** DID of the resolving agent */
+    resolver: Did;
+}
+/**
+ * Event payload for sync operation start.
+ */
+export interface SyncStartedPayload {
+    type: 'SyncStarted';
+    /** Peer being synced with */
+    peerId: string;
+    /** Direction of synchronization */
+    direction: 'push' | 'pull' | 'bidirectional';
+}
+/**
+ * Event payload for sync operation completion.
+ */
+export interface SyncCompletedPayload {
+    type: 'SyncCompleted';
+    /** Peer that was synced with */
+    peerId: string;
+    /** Number of events transferred */
+    eventsTransferred: number;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Event payload for checkpoint creation.
+ */
+export interface CheckpointCreatedPayload {
+    type: 'CheckpointCreated';
+    /** Checkpoint height (sequential number) */
+    height: number;
+    /** Merkle root of all events up to this checkpoint */
+    eventRoot: Blake3Hash;
+    /** Root hash of the current state */
+    stateRoot: Blake3Hash;
+}
+/**
+ * Union type of all knowledge graph event payloads.
+ * This discriminated union allows type-safe event handling.
+ *
+ * @example
+ * ```typescript
+ * function handleEvent(payload: KnowledgeGraphEventPayload) {
+ *   switch (payload.type) {
+ *     case 'NodeCreated':
+ *       console.log(`Node ${payload.nodeId} created`);
+ *       break;
+ *     case 'WorkflowCompleted':
+ *       console.log(`Workflow ${payload.workflowId} ${payload.outcome}`);
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type KnowledgeGraphEventPayload = NodeCreatedPayload | NodeUpdatedPayload | NodeDeletedPayload | EdgeCreatedPayload | EdgeDeletedPayload | QueryExecutedPayload | WorkflowStartedPayload | WorkflowCompletedPayload | WorkflowStepCompletedPayload | GapDetectedPayload | TaskSpecGeneratedPayload | ConflictDetectedPayload | ConflictResolvedPayload | SyncStartedPayload | SyncCompletedPayload | CheckpointCreatedPayload;
+/**
+ * Event envelope containing metadata and payload.
+ * The envelope wraps the payload with causality tracking (parents),
+ * ordering (HLC), and attribution (author).
+ */
+export interface EventEnvelope {
+    /** Parent event IDs forming the DAG structure (empty for genesis) */
+    parents: Blake3Hash[];
+    /** Hybrid logical clock timestamp for deterministic ordering */
+    hlc: HybridLogicalClock;
+    /** DID of the agent that created this event */
+    author: Did;
+    /** The actual event payload */
+    payload: KnowledgeGraphEventPayload;
+}
+/**
+ * Complete ledger event with cryptographic signature.
+ * This is the unit of storage and transfer in the audit chain.
+ */
+export interface LedgerEvent {
+    /** Event ID (BLAKE3 hash of the serialized envelope) */
+    id: Blake3Hash;
+    /** Event envelope with metadata and payload */
+    envelope: EventEnvelope;
+    /** Ed25519 signature of the event ID by the author */
+    signature: Ed25519Signature;
+}
+/**
+ * Validator signature for BFT checkpoint.
+ */
+export interface ValidatorSignature {
+    /** DID of the validating agent */
+    validatorDid: Did;
+    /** Ed25519 signature over the checkpoint data */
+    signature: Ed25519Signature;
+}
+/**
+ * BFT checkpoint for achieving finality.
+ * A checkpoint is final when it has 2f+1 validator signatures
+ * where f is the maximum number of Byzantine faults tolerated.
+ */
+export interface Checkpoint {
+    /** Sequential checkpoint number */
+    height: number;
+    /** Merkle root of all events finalized by this checkpoint */
+    eventRoot: Blake3Hash;
+    /** State root after applying all finalized events */
+    stateRoot: Blake3Hash;
+    /** Timestamp of checkpoint creation */
+    timestamp: Date;
+    /** Validator signatures (need 2f+1 for BFT finality) */
+    validatorSignatures: ValidatorSignature[];
+}
+/**
+ * Merkle proof for verifying event inclusion in a checkpoint.
+ * Allows lightweight verification without downloading all events.
+ */
+export interface MerkleProof {
+    /** Event being proven */
+    eventId: Blake3Hash;
+    /** Proof path containing sibling hashes */
+    path: Blake3Hash[];
+    /** Direction at each level (left=0, right=1 in binary tree) */
+    directions: ('left' | 'right')[];
+    /** Root hash that should match checkpoint's eventRoot */
+    root: Blake3Hash;
+}
+/**
+ * Request for synchronization with a peer.
+ * Used to request events since a known checkpoint.
+ */
+export interface SyncRequest {
+    /** DID of the requesting agent */
+    requester: Did;
+    /** Last checkpoint height known to requester */
+    lastCheckpointHeight: number;
+    /** Last known event root for verification */
+    lastEventRoot?: Blake3Hash;
+    /** Maximum number of events to receive */
+    maxEvents?: number;
+}
+/**
+ * Response to a synchronization request.
+ * Contains events since the requester's last checkpoint.
+ */
+export interface SyncResponse {
+    /** DID of the responding agent */
+    provider: Did;
+    /** Events since the requested checkpoint */
+    events: LedgerEvent[];
+    /** New checkpoint if one was created */
+    checkpoint?: Checkpoint;
+    /** Whether more events are available */
+    hasMore: boolean;
+    /** Cursor for pagination if hasMore is true */
+    nextCursor?: Blake3Hash;
+}
+/**
+ * Options for querying events from the audit chain.
+ */
+export interface EventQueryOptions {
+    /** Filter by specific event type */
+    type?: KnowledgeGraphEventPayload['type'];
+    /** Filter by event author */
+    author?: Did;
+    /** Return events with HLC >= since */
+    since?: HybridLogicalClock;
+    /** Return events with HLC <= until */
+    until?: HybridLogicalClock;
+    /** Maximum number of events to return */
+    limit?: number;
+    /** Include Merkle proofs for each event */
+    includeProof?: boolean;
+}
+/**
+ * Result of an event query.
+ */
+export interface EventQueryResult {
+    /** Events matching the query criteria */
+    events: LedgerEvent[];
+    /** Merkle proofs if requested (keyed by event ID) */
+    proofs?: Map<Blake3Hash, MerkleProof>;
+    /** Total count of matching events (may exceed returned count) */
+    totalCount: number;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+/**
+ * Health status of the audit chain.
+ */
+export type ChainStatus = 'healthy' | 'syncing' | 'degraded';
+/**
+ * Statistics about the audit chain state.
+ */
+export interface ChainStats {
+    /** Total number of events in the chain */
+    totalEvents: number;
+    /** Current finalized checkpoint height */
+    checkpointHeight: number;
+    /** Number of unique event authors */
+    uniqueAuthors: number;
+    /** Count of events by type */
+    eventsByType: Record<string, number>;
+    /** Timestamp of most recent event */
+    lastEventTime?: Date;
+    /** Overall chain health status */
+    status: ChainStatus;
+}
+/**
+ * Result of validating a ledger event.
+ */
+export interface EventValidation {
+    /** Whether the event passed all validation checks */
+    valid: boolean;
+    /** List of validation error messages if invalid */
+    errors: string[];
+    /** Whether the Ed25519 signature is valid */
+    signatureValid: boolean;
+    /** Whether HLC causality constraints are satisfied */
+    causalityValid: boolean;
+    /** Whether all parent events exist in the chain */
+    parentsExist: boolean;
+}
+/**
+ * Extract the payload type from an event type discriminator.
+ *
+ * @example
+ * ```typescript
+ * type NodePayload = ExtractPayload<'NodeCreated'>;
+ * // NodePayload is NodeCreatedPayload
+ * ```
+ */
+export type ExtractPayload<T extends KnowledgeGraphEventPayload['type']> = Extract<KnowledgeGraphEventPayload, {
+    type: T;
+}>;
+/**
+ * All possible event type discriminators.
+ */
+export type EventType = KnowledgeGraphEventPayload['type'];
+/**
+ * Helper to compare two HLCs for ordering.
+ *
+ * @param a - First HLC
+ * @param b - Second HLC
+ * @returns Negative if a < b, positive if a > b, zero if equal
+ *
+ * @example
+ * ```typescript
+ * const events = [...];
+ * events.sort((a, b) => compareHLC(a.envelope.hlc, b.envelope.hlc));
+ * ```
+ */
+export declare function compareHLC(a: HybridLogicalClock, b: HybridLogicalClock): number;
+/**
+ * Create a new HLC from the current time.
+ *
+ * @param lastHlc - Previous HLC for maintaining monotonicity
+ * @returns New HLC guaranteed to be greater than lastHlc
+ */
+export declare function createHLC(lastHlc?: HybridLogicalClock): HybridLogicalClock;
+/**
+ * Merge two HLCs (used when receiving events from peers).
+ *
+ * @param local - Local HLC
+ * @param remote - Remote HLC from received event
+ * @returns Merged HLC that maintains causality
+ */
+export declare function mergeHLC(local: HybridLogicalClock, remote: HybridLogicalClock): HybridLogicalClock;
+//# sourceMappingURL=types.d.ts.map

package/dist/audit/types.d.ts.map

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

package/dist/caching/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Advanced Caching Module
+ *
+ * Provides configurable caching with multiple eviction policies.
+ */
+export type EvictionPolicy = 'lru' | 'lfu' | 'fifo' | 'ttl';
+export interface CacheEntry<T> {
+    key: string;
+    value: T;
+    createdAt: number;
+    accessedAt: number;
+    accessCount: number;
+    ttl?: number;
+    size: number;
+}
+export interface CacheConfig {
+    maxSize?: number;
+    maxEntries?: number;
+    defaultTtl?: number;
+    evictionPolicy?: EvictionPolicy;
+    enableStats?: boolean;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    entryCount: number;
+    currentSize: number;
+    evictions: number;
+}
+export declare class AdvancedCache<T = unknown> {
+    private cache;
+    private config;
+    private stats;
+    constructor(config?: CacheConfig);
+    get(key: string): T | undefined;
+    set(key: string, value: T, ttl?: number): void;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    clear(): void;
+    getStats(): CacheStats;
+    keys(): string[];
+    size(): number;
+    prune(): number;
+    private shouldEvict;
+    private evictOne;
+    private findLRU;
+    private findLFU;
+    private findFIFO;
+    private findOldestTTL;
+    private estimateSize;
+    private updateHitRate;
+}
+export declare function createAdvancedCache<T = unknown>(config?: CacheConfig): AdvancedCache<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/caching/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/caching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5D,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAOX;gBAEU,MAAM,GAAE,WAAgB;IAUpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA8B/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IA2B9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI,UAAU;IAItB,IAAI,IAAI,MAAM,EAAE;IAIhB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,MAAM;IAcf,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CAItB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAEvF"}