opentasks 0.0.1 → 0.0.2

package/dist/graph/expansion.js

@@ -0,0 +1,205 @@
+/**
+ * Query Expansion for OpenTasks (Phase 3)
+ *
+ * Enables queries that span multiple OpenTasks locations.
+ */
+import { isOpentasksUri, parseOpentasksUri } from '../core/uri.js';
+/**
+ * Query multiple providers in parallel using Promise.allSettled
+ */
+async function queryProvidersParallel(providers, queryFn, maxLocations) {
+    const entries = [...providers.entries()].slice(0, maxLocations);
+    const results = await Promise.allSettled(entries.map(async ([hash, provider]) => {
+        const nodes = await queryFn(provider);
+        return { hash, nodes };
+    }));
+    const connected = {};
+    const queriedLocations = [];
+    const unreachableLocations = [];
+    for (const result of results) {
+        if (result.status === 'fulfilled') {
+            connected[result.value.hash] = result.value.nodes;
+            queriedLocations.push(result.value.hash);
+        }
+        else {
+            // Find the hash for this failed entry by index
+            const idx = results.indexOf(result);
+            unreachableLocations.push(entries[idx][0]);
+        }
+    }
+    return { connected, queriedLocations, unreachableLocations };
+}
+/**
+ * Identify which provider hashes are referenced by local edges
+ * via opentasks:// URIs in from_id or to_id fields.
+ */
+function getReferencedLocationHashes(edges, localHash) {
+    const hashes = new Set();
+    for (const edge of edges) {
+        for (const field of [edge.from_id, edge.to_id]) {
+            if (isOpentasksUri(field)) {
+                const parsed = parseOpentasksUri(field);
+                if (parsed?.locationHash && parsed.locationHash !== localHash) {
+                    hashes.add(parsed.locationHash);
+                }
+            }
+        }
+    }
+    return hashes;
+}
+/**
+ * Find edges that reference nodes in other locations
+ */
+function findCrossLocationEdges(edges, localHash, connectedHashes) {
+    return edges.filter((edge) => {
+        for (const field of [edge.from_id, edge.to_id]) {
+            if (isOpentasksUri(field)) {
+                const parsed = parseOpentasksUri(field);
+                if (parsed?.locationHash && parsed.locationHash !== localHash) {
+                    return true;
+                }
+            }
+        }
+        // Also check if from_id or to_id appears as a hash-prefixed reference
+        return false;
+    });
+}
+/**
+ * Create a query expander
+ *
+ * @param storage - Local storage
+ * @param locationHash - Current location hash
+ * @param locationProviders - Map of location hash → Provider
+ */
+export function createQueryExpander(storage, locationHash, locationProviders) {
+    /**
+     * Get all local edges for cross-location analysis
+     */
+    async function getLocalEdges(localNodeIds) {
+        const allEdges = [];
+        for (const nodeId of localNodeIds) {
+            const edges = await storage.getEdgesFrom(nodeId);
+            allEdges.push(...edges);
+        }
+        return allEdges;
+    }
+    /**
+     * Select providers based on expansion mode
+     */
+    function selectProviders(mode, referencedHashes) {
+        if (mode === 'follow-refs' && referencedHashes) {
+            // Only query locations referenced by local edges
+            const selected = new Map();
+            for (const hash of referencedHashes) {
+                const provider = locationProviders.get(hash);
+                if (provider) {
+                    selected.set(hash, provider);
+                }
+            }
+            return selected;
+        }
+        if (mode === 'connections' || mode === 'all') {
+            return locationProviders;
+        }
+        return new Map();
+    }
+    return {
+        async expandedReady(options) {
+            const mode = options?.expand ?? 'none';
+            const maxLocations = options?.maxLocations ?? 10;
+            // Always query local
+            const local = await storage.getReady();
+            if (mode === 'none') {
+                return {
+                    local,
+                    connected: {},
+                    crossLocationEdges: [],
+                    queriedLocations: [locationHash],
+                    unreachableLocations: [],
+                    completeness: 'full',
+                };
+            }
+            // For follow-refs, analyze local edges to find referenced locations
+            let referencedHashes;
+            let localEdges = [];
+            if (mode === 'follow-refs' || mode === 'all') {
+                localEdges = await getLocalEdges(local.map((n) => n.id));
+                referencedHashes = getReferencedLocationHashes(localEdges, locationHash);
+            }
+            // Select providers based on mode
+            const providers = selectProviders(mode, referencedHashes);
+            // For 'all' mode, include all connected providers too
+            if (mode === 'all') {
+                for (const [hash, provider] of locationProviders.entries()) {
+                    providers.set(hash, provider);
+                }
+            }
+            // Query providers in parallel
+            const { connected, queriedLocations, unreachableLocations } = await queryProvidersParallel(providers, (provider) => provider.ready(), maxLocations);
+            // Identify cross-location edges
+            if (localEdges.length === 0 && mode === 'connections') {
+                localEdges = await getLocalEdges(local.map((n) => n.id));
+            }
+            const connectedHashes = new Set(queriedLocations);
+            const crossLocationEdges = findCrossLocationEdges(localEdges, locationHash, connectedHashes);
+            return {
+                local,
+                connected,
+                crossLocationEdges,
+                queriedLocations: [locationHash, ...queriedLocations],
+                unreachableLocations,
+                completeness: unreachableLocations.length === 0 ? 'full' : 'partial',
+            };
+        },
+        async expandedQuery(filter, options) {
+            const mode = options?.expand ?? 'none';
+            const maxLocations = options?.maxLocations ?? 10;
+            const local = await storage.queryNodes({
+                type: filter.type,
+                status: filter.status,
+            });
+            if (mode === 'none') {
+                return {
+                    local,
+                    connected: {},
+                    crossLocationEdges: [],
+                    queriedLocations: [locationHash],
+                    unreachableLocations: [],
+                    completeness: 'full',
+                };
+            }
+            // For follow-refs, analyze local edges to find referenced locations
+            let referencedHashes;
+            let localEdges = [];
+            if (mode === 'follow-refs' || mode === 'all') {
+                localEdges = await getLocalEdges(local.map((n) => n.id));
+                referencedHashes = getReferencedLocationHashes(localEdges, locationHash);
+            }
+            // Select providers based on mode
+            const providers = selectProviders(mode, referencedHashes);
+            // For 'all' mode, include all connected providers too
+            if (mode === 'all') {
+                for (const [hash, provider] of locationProviders.entries()) {
+                    providers.set(hash, provider);
+                }
+            }
+            // Query providers in parallel
+            const { connected, queriedLocations, unreachableLocations } = await queryProvidersParallel(providers, (provider) => provider.list(filter), maxLocations);
+            // Identify cross-location edges
+            if (localEdges.length === 0 && mode === 'connections') {
+                localEdges = await getLocalEdges(local.map((n) => n.id));
+            }
+            const connectedHashes = new Set(queriedLocations);
+            const crossLocationEdges = findCrossLocationEdges(localEdges, locationHash, connectedHashes);
+            return {
+                local,
+                connected,
+                crossLocationEdges,
+                queriedLocations: [locationHash, ...queriedLocations],
+                unreachableLocations,
+                completeness: unreachableLocations.length === 0 ? 'full' : 'partial',
+            };
+        },
+    };
+}
+//# sourceMappingURL=expansion.js.map

package/dist/graph/expansion.js.map

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

package/dist/graph/history.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Execution History and Audit Trail for OpenTasks
+ *
+ * Tracks all operations for auditing and debugging.
+ */
+import type { OperationContext } from './coordination.js';
+/**
+ * Types of operations that can be logged
+ */
+export type OperationType = 'node.create' | 'node.update' | 'node.delete' | 'node.restore' | 'edge.create' | 'edge.delete' | 'claim.acquire' | 'claim.release' | 'claim.renew' | 'claim.expire' | 'feedback.create' | 'feedback.resolve' | 'feedback.dismiss' | 'feedback.reopen' | 'sync.materialize' | 'sync.refresh' | 'sync.conflict';
+/**
+ * A single change to a field
+ */
+export interface FieldChange {
+    /** Field that was changed */
+    field: string;
+    /** Value before the change */
+    before: unknown;
+    /** Value after the change */
+    after: unknown;
+}
+/**
+ * An entry in the operation log
+ */
+export interface OperationLogEntry {
+    /** Unique ID for this log entry */
+    id: string;
+    /** ISO timestamp when operation occurred */
+    timestamp: string;
+    /** Type of operation */
+    operation: OperationType;
+    /** Primary node affected */
+    nodeId: string;
+    /** Secondary node (for edges: target node) */
+    targetNodeId?: string;
+    /** Agent that performed the operation */
+    agentId?: string;
+    /** Session context */
+    sessionId?: string;
+    /** Field-level changes (for updates) */
+    changes?: FieldChange[];
+    /** Additional operation-specific data */
+    data?: Record<string, unknown>;
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Options for querying the operation log
+ */
+export interface OperationLogQueryOptions {
+    /** Filter by node ID */
+    nodeId?: string;
+    /** Filter by agent ID */
+    agentId?: string;
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by operation type(s) */
+    operations?: OperationType[];
+    /** Only successful operations */
+    successOnly?: boolean;
+    /** Start time (inclusive) */
+    since?: string;
+    /** End time (exclusive) */
+    until?: string;
+    /** Maximum entries to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Summary of agent activity
+ */
+export interface AgentActivitySummary {
+    /** Agent ID */
+    agentId: string;
+    /** Time period start */
+    since: string;
+    /** Time period end */
+    until: string;
+    /** Total operations */
+    totalOperations: number;
+    /** Operations by type */
+    byType: Record<OperationType, number>;
+    /** Nodes created */
+    nodesCreated: number;
+    /** Nodes updated */
+    nodesUpdated: number;
+    /** Edges created */
+    edgesCreated: number;
+    /** Claims acquired */
+    claimsAcquired: number;
+    /** Feedback given */
+    feedbackGiven: number;
+    /** Success rate (0-1) */
+    successRate: number;
+}
+/**
+ * Logs and queries operations for audit trail
+ */
+export interface OperationLogger {
+    /**
+     * Log an operation
+     *
+     * @param entry - Operation log entry (id and timestamp auto-generated if not provided)
+     */
+    log(entry: Omit<OperationLogEntry, 'id' | 'timestamp'> & {
+        id?: string;
+        timestamp?: string;
+    }): Promise<void>;
+    /**
+     * Query the operation log
+     *
+     * @param options - Query options
+     * @returns Matching log entries
+     */
+    query(options: OperationLogQueryOptions): Promise<OperationLogEntry[]>;
+    /**
+     * Get history for a specific node
+     *
+     * @param nodeId - Node to get history for
+     * @param options - Query options
+     * @returns Log entries for this node
+     */
+    getNodeHistory(nodeId: string, options?: Omit<OperationLogQueryOptions, 'nodeId'>): Promise<OperationLogEntry[]>;
+    /**
+     * Get activity for a specific agent
+     *
+     * @param agentId - Agent to get activity for
+     * @param options - Query options
+     * @returns Log entries for this agent
+     */
+    getAgentActivity(agentId: string, options?: Omit<OperationLogQueryOptions, 'agentId'>): Promise<OperationLogEntry[]>;
+    /**
+     * Get activity summary for an agent
+     *
+     * @param agentId - Agent to summarize
+     * @param since - Start of period
+     * @param until - End of period (defaults to now)
+     * @returns Activity summary
+     */
+    getAgentSummary(agentId: string, since: string, until?: string): Promise<AgentActivitySummary>;
+    /**
+     * Get the most recent operations
+     *
+     * @param limit - Number of entries to return
+     * @returns Recent log entries
+     */
+    getRecent(limit?: number): Promise<OperationLogEntry[]>;
+    /**
+     * Clean up old log entries
+     *
+     * @param olderThan - ISO timestamp, entries before this will be deleted
+     * @returns Number of entries deleted
+     */
+    cleanup(olderThan: string): Promise<number>;
+    /**
+     * Get total count of log entries
+     *
+     * @param options - Filter options
+     * @returns Count of matching entries
+     */
+    count(options?: OperationLogQueryOptions): Promise<number>;
+}
+/**
+ * Create an in-memory operation logger (for testing or small-scale use)
+ *
+ * For production, use a SQLite-backed implementation.
+ */
+export declare function createInMemoryOperationLogger(): OperationLogger;
+/**
+ * Create a log entry for a node operation
+ */
+export declare function createNodeLogEntry(operation: 'node.create' | 'node.update' | 'node.delete' | 'node.restore', nodeId: string, context?: OperationContext, changes?: FieldChange[], success?: boolean, error?: string): Omit<OperationLogEntry, 'id' | 'timestamp'>;
+/**
+ * Create a log entry for an edge operation
+ */
+export declare function createEdgeLogEntry(operation: 'edge.create' | 'edge.delete', fromId: string, toId: string, edgeType: string, context?: OperationContext, success?: boolean, error?: string): Omit<OperationLogEntry, 'id' | 'timestamp'>;
+/**
+ * Create a log entry for a claim operation
+ */
+export declare function createClaimLogEntry(operation: 'claim.acquire' | 'claim.release' | 'claim.renew' | 'claim.expire', nodeId: string, agentId: string, context?: OperationContext, data?: Record<string, unknown>, success?: boolean, error?: string): Omit<OperationLogEntry, 'id' | 'timestamp'>;
+//# sourceMappingURL=history.d.ts.map

package/dist/graph/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/graph/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM1D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,GACd,aAAa,GACb,aAAa,GACb,eAAe,GACf,eAAe,GACf,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAEhB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,SAAS,EAAE,aAAa,CAAC;IAEzB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAExB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IAExB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAEtC,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CACD,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvF,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEvE;;;;;;OAMG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,GACjD,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEhC;;;;;;OAMG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAClD,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE/F;;;;;OAKG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExD;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAMD;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,eAAe,CAgH/D;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,EACzE,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,WAAW,EAAE,EACvB,OAAO,UAAO,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,CAU7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,GAAG,aAAa,EACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,UAAO,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,CAW7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,EAC7E,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,EAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,UAAO,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,CAU7C"}

package/dist/graph/history.js

@@ -0,0 +1,155 @@
+/**
+ * Execution History and Audit Trail for OpenTasks
+ *
+ * Tracks all operations for auditing and debugging.
+ */
+// ============================================================================
+// In-Memory OperationLogger Implementation
+// ============================================================================
+/**
+ * Create an in-memory operation logger (for testing or small-scale use)
+ *
+ * For production, use a SQLite-backed implementation.
+ */
+export function createInMemoryOperationLogger() {
+    const entries = [];
+    let nextId = 1;
+    return {
+        async log(entry) {
+            const fullEntry = {
+                ...entry,
+                id: entry.id ?? `log-${nextId++}`,
+                timestamp: entry.timestamp ?? new Date().toISOString(),
+            };
+            entries.push(fullEntry);
+        },
+        async query(options) {
+            let result = [...entries];
+            // Apply filters
+            if (options.nodeId) {
+                result = result.filter((e) => e.nodeId === options.nodeId || e.targetNodeId === options.nodeId);
+            }
+            if (options.agentId) {
+                result = result.filter((e) => e.agentId === options.agentId);
+            }
+            if (options.sessionId) {
+                result = result.filter((e) => e.sessionId === options.sessionId);
+            }
+            if (options.operations) {
+                result = result.filter((e) => options.operations.includes(e.operation));
+            }
+            if (options.successOnly) {
+                result = result.filter((e) => e.success);
+            }
+            if (options.since) {
+                result = result.filter((e) => e.timestamp >= options.since);
+            }
+            if (options.until) {
+                result = result.filter((e) => e.timestamp < options.until);
+            }
+            // Sort
+            result.sort((a, b) => {
+                const cmp = a.timestamp.localeCompare(b.timestamp);
+                return options.order === 'asc' ? cmp : -cmp;
+            });
+            // Pagination
+            const offset = options.offset ?? 0;
+            const limit = options.limit ?? 100;
+            return result.slice(offset, offset + limit);
+        },
+        async getNodeHistory(nodeId, options) {
+            return this.query({ ...options, nodeId });
+        },
+        async getAgentActivity(agentId, options) {
+            return this.query({ ...options, agentId });
+        },
+        async getAgentSummary(agentId, since, until) {
+            const untilTime = until ?? new Date().toISOString();
+            const activity = await this.query({ agentId, since, until: untilTime });
+            const byType = {};
+            let successful = 0;
+            for (const entry of activity) {
+                byType[entry.operation] = (byType[entry.operation] ?? 0) + 1;
+                if (entry.success)
+                    successful++;
+            }
+            return {
+                agentId,
+                since,
+                until: untilTime,
+                totalOperations: activity.length,
+                byType: byType,
+                nodesCreated: byType['node.create'] ?? 0,
+                nodesUpdated: byType['node.update'] ?? 0,
+                edgesCreated: byType['edge.create'] ?? 0,
+                claimsAcquired: byType['claim.acquire'] ?? 0,
+                feedbackGiven: byType['feedback.create'] ?? 0,
+                successRate: activity.length > 0 ? successful / activity.length : 1,
+            };
+        },
+        async getRecent(limit = 50) {
+            return this.query({ limit, order: 'desc' });
+        },
+        async cleanup(olderThan) {
+            const before = entries.length;
+            const cutoff = olderThan;
+            const remaining = entries.filter((e) => e.timestamp >= cutoff);
+            entries.length = 0;
+            entries.push(...remaining);
+            return before - entries.length;
+        },
+        async count(options) {
+            if (!options)
+                return entries.length;
+            const result = await this.query({ ...options, limit: undefined, offset: undefined });
+            return result.length;
+        },
+    };
+}
+// ============================================================================
+// Logging Helpers
+// ============================================================================
+/**
+ * Create a log entry for a node operation
+ */
+export function createNodeLogEntry(operation, nodeId, context, changes, success = true, error) {
+    return {
+        operation,
+        nodeId,
+        agentId: context?.agentId,
+        sessionId: context?.sessionId,
+        changes,
+        success,
+        error,
+    };
+}
+/**
+ * Create a log entry for an edge operation
+ */
+export function createEdgeLogEntry(operation, fromId, toId, edgeType, context, success = true, error) {
+    return {
+        operation,
+        nodeId: fromId,
+        targetNodeId: toId,
+        agentId: context?.agentId,
+        sessionId: context?.sessionId,
+        data: { edgeType },
+        success,
+        error,
+    };
+}
+/**
+ * Create a log entry for a claim operation
+ */
+export function createClaimLogEntry(operation, nodeId, agentId, context, data, success = true, error) {
+    return {
+        operation,
+        nodeId,
+        agentId,
+        sessionId: context?.sessionId,
+        data,
+        success,
+        error,
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/graph/history.js.map

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

package/dist/graph/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OpenTasks Graph Layer
+ *
+ * Provides unified CRUD, rich queries, and business logic validation
+ * on top of the persistence layer.
+ *
+ * @packageDocumentation
+ */
+export type { NodeType, CreateNodeInput, UpdateNodeInput, DeleteOptions, CreateEdgeInput, PriorityFilter, NodeFilter, EdgeFilter, BlockerOptions, ReadyOptions, FeedbackOptions, ValidationResult, ValidationError, ValidationWarning, CycleResult, FlushConfig, GraphStoreConfig, GraphErrorCode, } from './types.js';
+export { GraphError } from './types.js';
+export type { ValidationService } from './validation.js';
+export { createValidationService } from './validation.js';
+export type { QueryEngine, NodeResolver, QueryEngineOptions } from './query.js';
+export { createQueryEngine } from './query.js';
+export type { DebouncedFlusher, DebounceConfig } from './debounce.js';
+export { createDebouncedFlusher } from './debounce.js';
+export type { SyncManager, SyncConfig } from './sync.js';
+export { createSyncManager, DEFAULT_SYNC_CONFIG } from './sync.js';
+export type { GraphStore, GraphTransaction } from './store.js';
+export { createGraphStore } from './store.js';
+export type { ProviderAwareStore, ProviderStoreConfig, ResolveOptions, ProviderChangeHandler, } from './provider-store.js';
+export { createProviderAwareStore } from './provider-store.js';
+export type { EdgeTypeDefinition, EdgeTypeSupport, EdgeTypeLookupResult, } from './EdgeTypeRegistry.js';
+export { EdgeTypeRegistry, BUILTIN_EDGE_TYPES, getEdgeTypeRegistry, createEdgeTypeRegistry, resetEdgeTypeRegistry, } from './EdgeTypeRegistry.js';
+export type { NodeURI, GraphNodeAttributes, GraphEdgeAttributes, GraphologyAdapter, } from './GraphologyAdapter.js';
+export { GraphologyAdapterImpl, createGraphologyAdapter } from './GraphologyAdapter.js';
+export type { TraversalDirection, RelatedOptions, ReachableOptions, ShortestPathOptions, NodePredicate, EdgeStep, TraversalPattern, TraversalResult, SelectorType, ParsedSelector, GraphCapabilities, FederatedGraph, } from './FederatedGraph.js';
+export { FederatedGraphImpl, createFederatedGraph } from './FederatedGraph.js';
+export type { CacheConfig, ResolvedNode, FederatedReadyOptions, HydratingFederatedGraph, HydratingFederatedGraphConfig, } from './HydratingFederatedGraph.js';
+export { DEFAULT_CACHE_CONFIG, HydratingFederatedGraphImpl, createHydratingFederatedGraph, } from './HydratingFederatedGraph.js';
+export type { OperationContext, StandardNodeMetadata, ExecutionMetadata, TrackingMetadata, ExternalSyncMetadata, ClaimInfo, ClaimOptions, ClaimResult, ClaimManager, } from './coordination.js';
+export { createClaimManager } from './coordination.js';
+export type { OperationType, FieldChange, OperationLogEntry, OperationLogQueryOptions, AgentActivitySummary, OperationLogger, } from './history.js';
+export { createInMemoryOperationLogger, createNodeLogEntry, createEdgeLogEntry, createClaimLogEntry, } from './history.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGxF,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,YAAY,EACV,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/graph/index.js

@@ -0,0 +1,22 @@
+/**
+ * OpenTasks Graph Layer
+ *
+ * Provides unified CRUD, rich queries, and business logic validation
+ * on top of the persistence layer.
+ *
+ * @packageDocumentation
+ */
+export { GraphError } from './types.js';
+export { createValidationService } from './validation.js';
+export { createQueryEngine } from './query.js';
+export { createDebouncedFlusher } from './debounce.js';
+export { createSyncManager, DEFAULT_SYNC_CONFIG } from './sync.js';
+export { createGraphStore } from './store.js';
+export { createProviderAwareStore } from './provider-store.js';
+export { EdgeTypeRegistry, BUILTIN_EDGE_TYPES, getEdgeTypeRegistry, createEdgeTypeRegistry, resetEdgeTypeRegistry, } from './EdgeTypeRegistry.js';
+export { GraphologyAdapterImpl, createGraphologyAdapter } from './GraphologyAdapter.js';
+export { FederatedGraphImpl, createFederatedGraph } from './FederatedGraph.js';
+export { DEFAULT_CACHE_CONFIG, HydratingFederatedGraphImpl, createHydratingFederatedGraph, } from './HydratingFederatedGraph.js';
+export { createClaimManager } from './coordination.js';
+export { createInMemoryOperationLogger, createNodeLogEntry, createEdgeLogEntry, createClaimLogEntry, } from './history.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwBH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAS9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAiBxF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAU/E,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AActC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAWvD,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}