causantic 0.2.0 → 0.3.0

package/dist/storage/pruner.js.map

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

package/dist/temporal/clock-compactor.d.ts

@@ -1,65 +0,0 @@
-/**
- * Clock compaction for reference clocks.
- *
- * Reference clocks accumulate agent entries over time. This module provides
- * compaction to prune entries only when ALL edges referencing that agent
- * have fully decayed.
- *
- * Why not prune by tick recency:
- * An agent may not tick for a long time, but edges referencing it could still
- * be queried. Pruning based on tick recency would break hop count calculation
- * for those edges.
- */
-import { type VectorClock } from './vector-clock.js';
-import { type VectorDecayConfig } from '../storage/decay.js';
-/**
- * Result of clock compaction.
- */
-export interface CompactionResult {
-    /** Agent IDs that were pruned */
-    prunedAgents: string[];
-    /** Number of agent entries remaining */
-    remainingAgents: number;
-    /** Duration of compaction in milliseconds */
-    durationMs: number;
-}
-/**
- * Compact the reference clock for a project by removing agent entries
- * that no longer have any live edges referencing them.
- *
- * @param projectSlug - Project identifier
- * @param vectorConfig - Vector decay configuration (optional)
- * @returns Compaction result
- */
-export declare function compactReferenceClock(projectSlug: string, vectorConfig?: VectorDecayConfig): Promise<CompactionResult>;
-/**
- * Get statistics about clock entries for a project.
- *
- * @param projectSlug - Project identifier
- * @returns Clock statistics
- */
-export declare function getClockStats(projectSlug: string): {
-    agentCount: number;
-    totalTicks: number;
-    agents: Array<{
-        agentId: string;
-        ticks: number;
-    }>;
-};
-/**
- * Estimate the "age" of edges in hop count terms.
- * Returns distribution of edges by hop count.
- *
- * @param projectSlug - Project identifier
- * @returns Histogram of hop counts
- */
-export declare function getHopCountDistribution(projectSlug: string): Promise<Map<number, number>>;
-/**
- * Force refresh the reference clock by merging all agent clocks.
- * Useful after data recovery or manual edits.
- *
- * @param projectSlug - Project identifier
- * @returns The refreshed reference clock
- */
-export declare function refreshReferenceClock(projectSlug: string): VectorClock;
-//# sourceMappingURL=clock-compactor.d.ts.map

package/dist/temporal/clock-compactor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clock-compactor.d.ts","sourceRoot":"","sources":["../../src/temporal/clock-compactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,qBAAqB,CAAC;AAGnF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAyC3B;AA8CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,CAYA;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsB9B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAYtE"}

package/dist/temporal/clock-compactor.js

@@ -1,157 +0,0 @@
-/**
- * Clock compaction for reference clocks.
- *
- * Reference clocks accumulate agent entries over time. This module provides
- * compaction to prune entries only when ALL edges referencing that agent
- * have fully decayed.
- *
- * Why not prune by tick recency:
- * An agent may not tick for a long time, but edges referencing it could still
- * be queried. Pruning based on tick recency would break hop count calculation
- * for those edges.
- */
-import { getDb } from '../storage/db.js';
-import { getReferenceClock, setReferenceClock, getAllAgentClocks, } from '../storage/clock-store.js';
-import { hopCount, deserialize, } from './vector-clock.js';
-import { DEFAULT_VECTOR_DECAY } from '../storage/decay.js';
-import { getConfig } from '../config/memory-config.js';
-/**
- * Compact the reference clock for a project by removing agent entries
- * that no longer have any live edges referencing them.
- *
- * @param projectSlug - Project identifier
- * @param vectorConfig - Vector decay configuration (optional)
- * @returns Compaction result
- */
-export async function compactReferenceClock(projectSlug, vectorConfig) {
-    const startTime = Date.now();
-    const config = vectorConfig ?? getConfig().vectorDecay ?? DEFAULT_VECTOR_DECAY;
-    const refClock = getReferenceClock(projectSlug);
-    const agentIds = Object.keys(refClock);
-    if (agentIds.length === 0) {
-        return {
-            prunedAgents: [],
-            remainingAgents: 0,
-            durationMs: Date.now() - startTime,
-        };
-    }
-    const prunedAgents = [];
-    for (const agentId of agentIds) {
-        const hasLiveEdges = await hasEdgesReferencingAgent(projectSlug, agentId, refClock, config);
-        if (!hasLiveEdges) {
-            prunedAgents.push(agentId);
-        }
-    }
-    if (prunedAgents.length > 0) {
-        // Remove pruned agents from reference clock
-        const newClock = {};
-        for (const [id, ticks] of Object.entries(refClock)) {
-            if (!prunedAgents.includes(id)) {
-                newClock[id] = ticks;
-            }
-        }
-        setReferenceClock(projectSlug, newClock);
-    }
-    return {
-        prunedAgents,
-        remainingAgents: agentIds.length - prunedAgents.length,
-        durationMs: Date.now() - startTime,
-    };
-}
-/**
- * Check if any live edges reference a specific agent in their vector clock.
- *
- * @param projectSlug - Project identifier
- * @param agentId - Agent ID to check
- * @param refClock - Current reference clock
- * @param config - Vector decay configuration
- * @returns true if at least one live edge references this agent
- */
-async function hasEdgesReferencingAgent(projectSlug, agentId, refClock, config) {
-    const db = getDb();
-    // Find edges in this project whose vector_clock contains this agentId
-    // We use LIKE to find JSON containing the agent ID
-    const rows = db.prepare(`
-    SELECT e.vector_clock FROM edges e
-    JOIN chunks c ON e.source_chunk_id = c.id
-    WHERE c.session_slug = ?
-      AND e.vector_clock LIKE ?
-  `).all(projectSlug, `%"${agentId}":%`);
-    for (const row of rows) {
-        if (!row.vector_clock)
-            continue;
-        const edgeClock = deserialize(row.vector_clock);
-        if (!(agentId in edgeClock))
-            continue;
-        // Calculate if edge is still alive
-        const hops = hopCount(edgeClock, refClock);
-        const weight = Math.pow(config.weightPerHop, hops);
-        if (weight >= config.minWeight) {
-            return true; // At least one live edge references this agent
-        }
-    }
-    return false; // No live edges reference this agent
-}
-/**
- * Get statistics about clock entries for a project.
- *
- * @param projectSlug - Project identifier
- * @returns Clock statistics
- */
-export function getClockStats(projectSlug) {
-    const refClock = getReferenceClock(projectSlug);
-    const agents = Object.entries(refClock).map(([agentId, ticks]) => ({
-        agentId,
-        ticks,
-    }));
-    return {
-        agentCount: agents.length,
-        totalTicks: agents.reduce((sum, a) => sum + a.ticks, 0),
-        agents: agents.sort((a, b) => b.ticks - a.ticks),
-    };
-}
-/**
- * Estimate the "age" of edges in hop count terms.
- * Returns distribution of edges by hop count.
- *
- * @param projectSlug - Project identifier
- * @returns Histogram of hop counts
- */
-export async function getHopCountDistribution(projectSlug) {
-    const db = getDb();
-    const refClock = getReferenceClock(projectSlug);
-    const distribution = new Map();
-    const rows = db.prepare(`
-    SELECT e.vector_clock FROM edges e
-    JOIN chunks c ON e.source_chunk_id = c.id
-    WHERE c.session_slug = ?
-      AND e.vector_clock IS NOT NULL
-  `).all(projectSlug);
-    for (const row of rows) {
-        if (!row.vector_clock)
-            continue;
-        const edgeClock = deserialize(row.vector_clock);
-        const hops = hopCount(edgeClock, refClock);
-        distribution.set(hops, (distribution.get(hops) ?? 0) + 1);
-    }
-    return distribution;
-}
-/**
- * Force refresh the reference clock by merging all agent clocks.
- * Useful after data recovery or manual edits.
- *
- * @param projectSlug - Project identifier
- * @returns The refreshed reference clock
- */
-export function refreshReferenceClock(projectSlug) {
-    const agentClocks = getAllAgentClocks(projectSlug);
-    const refClock = {};
-    for (const [, clock] of agentClocks) {
-        for (const [agentId, ticks] of Object.entries(clock)) {
-            refClock[agentId] = Math.max(refClock[agentId] ?? 0, ticks);
-        }
-    }
-    setReferenceClock(projectSlug, refClock);
-    return refClock;
-}
-//# sourceMappingURL=clock-compactor.js.map

package/dist/temporal/clock-compactor.js.map

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

package/dist/temporal/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Temporal module exports.
- */
-export * from './vector-clock.js';
-export * from './clock-compactor.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/temporal/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/dist/temporal/index.js

@@ -1,6 +0,0 @@
-/**
- * Temporal module exports.
- */
-export * from './vector-clock.js';
-export * from './clock-compactor.js';
-//# sourceMappingURL=index.js.map

package/dist/temporal/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/temporal/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/dist/temporal/vector-clock.d.ts

@@ -1,143 +0,0 @@
-/**
- * Vector clock implementation for D-T-D memory graph.
- *
- * D-T-D = Data-Transformation-Data: an abstract representation of any
- * processing step as f(input) → output. The "T" can be any transformation:
- * Claude reasoning, human thinking, tool execution, etc.
- *
- * This representation is conducive to graph-based reasoning without getting
- * bogged down in compositional semantics, input/output types, or arities.
- *
- * Vector clocks capture logical causal distance (D-T-D hop count) instead of
- * physical time. This is more meaningful for memory retrieval - especially
- * with parallel thought streams that progress independently.
- *
- * Semantics:
- * - Domain: Per-project (each project has its own clock set)
- * - Entries: Per thought stream (main agent, human, each sub-agent)
- * - Tick: Each D-T-D cycle increments that stream's clock entry
- * - Reference clock: Element-wise max of all stream clocks
- * - Sub-agent spawn: Inherits parent clock
- * - Sub-agent debrief: Merges back via element-wise max
- */
-/**
- * A vector clock maps agent IDs to their tick counts.
- */
-export interface VectorClock {
-    [agentId: string]: number;
-}
-/** Main UI agent identifier */
-export declare const MAIN_AGENT_ID = "ui";
-/** Human user agent identifier */
-export declare const HUMAN_AGENT_ID = "human";
-/**
- * Create an empty vector clock.
- */
-export declare function createClock(): VectorClock;
-/**
- * Increment the tick count for a specific agent.
- * Returns a new clock (immutable operation).
- *
- * @param clock - Current vector clock
- * @param agentId - Agent to increment
- * @returns New vector clock with incremented tick
- */
-export declare function tick(clock: VectorClock, agentId: string): VectorClock;
-/**
- * Merge two vector clocks by taking the element-wise maximum.
- * Used when:
- * - Sub-agent inherits parent clock at spawn
- * - Parent merges sub-agent clock at debrief
- * - Computing reference clock from all agent clocks
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns Merged vector clock with max of each entry
- */
-export declare function merge(a: VectorClock, b: VectorClock): VectorClock;
-/**
- * Calculate the hop count (logical distance) between an edge's clock
- * and the current reference clock.
- *
- * Only entries present in both clocks contribute to the sum:
- * - Agents that didn't exist at edge creation (not in edgeClock) are skipped
- * - Agents that have since terminated (not in refClock) contribute 0
- *
- * This represents how many D-T-D cycles have occurred in the thought streams
- * that were active when the edge was created and still exist now.
- *
- * @param edgeClock - Vector clock stamped on the edge
- * @param refClock - Current reference clock for the project
- * @returns Total hop count (sum of per-agent differences for shared entries)
- */
-export declare function hopCount(edgeClock: VectorClock, refClock: VectorClock): number;
-/**
- * Check if clock A happened before clock B.
- * A happened before B if all entries in A are <= entries in B
- * and at least one entry in A is < the corresponding entry in B.
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns true if a happened before b
- */
-export declare function happenedBefore(a: VectorClock, b: VectorClock): boolean;
-/**
- * Check if two clocks are concurrent (neither happened before the other, and not equal).
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns true if clocks are concurrent (not equal and incomparable)
- */
-export declare function areConcurrent(a: VectorClock, b: VectorClock): boolean;
-/**
- * Compare two clocks and return their causal relationship.
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns 'before' if a < b, 'after' if a > b, 'concurrent' if neither, 'equal' if same
- */
-export declare function compare(a: VectorClock, b: VectorClock): 'before' | 'after' | 'concurrent' | 'equal';
-/**
- * Get the total number of ticks across all agents.
- * Useful for rough ordering when vector clocks are concurrent.
- *
- * @param clock - Vector clock
- * @returns Sum of all tick counts
- */
-export declare function totalTicks(clock: VectorClock): number;
-/**
- * Serialize a vector clock to JSON string for database storage.
- *
- * @param clock - Vector clock to serialize
- * @returns JSON string representation
- */
-export declare function serialize(clock: VectorClock): string;
-/**
- * Deserialize a vector clock from JSON string.
- *
- * @param json - JSON string or null
- * @returns Deserialized vector clock (empty if null or invalid)
- */
-export declare function deserialize(json: string | null | undefined): VectorClock;
-/**
- * Clone a vector clock.
- *
- * @param clock - Clock to clone
- * @returns New clock with same values
- */
-export declare function clone(clock: VectorClock): VectorClock;
-/**
- * Check if a clock is empty (no ticks recorded).
- *
- * @param clock - Vector clock to check
- * @returns true if clock has no entries or all entries are 0
- */
-export declare function isEmpty(clock: VectorClock): boolean;
-/**
- * Get all agent IDs present in a clock.
- *
- * @param clock - Vector clock
- * @returns Array of agent IDs
- */
-export declare function getAgentIds(clock: VectorClock): string[];
-//# sourceMappingURL=vector-clock.d.ts.map

package/dist/temporal/vector-clock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector-clock.d.ts","sourceRoot":"","sources":["../../src/temporal/vector-clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,+BAA+B;AAC/B,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,kCAAkC;AAClC,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;GAEG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAErE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,CAMjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,CAO9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAiBtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAgBrE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAE,WAAW,EACd,CAAC,EAAE,WAAW,GACb,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAe7C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAmBxE;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAGnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAExD"}

package/dist/temporal/vector-clock.js

@@ -1,231 +0,0 @@
-/**
- * Vector clock implementation for D-T-D memory graph.
- *
- * D-T-D = Data-Transformation-Data: an abstract representation of any
- * processing step as f(input) → output. The "T" can be any transformation:
- * Claude reasoning, human thinking, tool execution, etc.
- *
- * This representation is conducive to graph-based reasoning without getting
- * bogged down in compositional semantics, input/output types, or arities.
- *
- * Vector clocks capture logical causal distance (D-T-D hop count) instead of
- * physical time. This is more meaningful for memory retrieval - especially
- * with parallel thought streams that progress independently.
- *
- * Semantics:
- * - Domain: Per-project (each project has its own clock set)
- * - Entries: Per thought stream (main agent, human, each sub-agent)
- * - Tick: Each D-T-D cycle increments that stream's clock entry
- * - Reference clock: Element-wise max of all stream clocks
- * - Sub-agent spawn: Inherits parent clock
- * - Sub-agent debrief: Merges back via element-wise max
- */
-import { createLogger } from '../utils/logger.js';
-const log = createLogger('vector-clock');
-/** Main UI agent identifier */
-export const MAIN_AGENT_ID = 'ui';
-/** Human user agent identifier */
-export const HUMAN_AGENT_ID = 'human';
-/**
- * Create an empty vector clock.
- */
-export function createClock() {
-    return {};
-}
-/**
- * Increment the tick count for a specific agent.
- * Returns a new clock (immutable operation).
- *
- * @param clock - Current vector clock
- * @param agentId - Agent to increment
- * @returns New vector clock with incremented tick
- */
-export function tick(clock, agentId) {
-    return { ...clock, [agentId]: (clock[agentId] ?? 0) + 1 };
-}
-/**
- * Merge two vector clocks by taking the element-wise maximum.
- * Used when:
- * - Sub-agent inherits parent clock at spawn
- * - Parent merges sub-agent clock at debrief
- * - Computing reference clock from all agent clocks
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns Merged vector clock with max of each entry
- */
-export function merge(a, b) {
-    const result = { ...a };
-    for (const [id, ticks] of Object.entries(b)) {
-        result[id] = Math.max(result[id] ?? 0, ticks);
-    }
-    return result;
-}
-/**
- * Calculate the hop count (logical distance) between an edge's clock
- * and the current reference clock.
- *
- * Only entries present in both clocks contribute to the sum:
- * - Agents that didn't exist at edge creation (not in edgeClock) are skipped
- * - Agents that have since terminated (not in refClock) contribute 0
- *
- * This represents how many D-T-D cycles have occurred in the thought streams
- * that were active when the edge was created and still exist now.
- *
- * @param edgeClock - Vector clock stamped on the edge
- * @param refClock - Current reference clock for the project
- * @returns Total hop count (sum of per-agent differences for shared entries)
- */
-export function hopCount(edgeClock, refClock) {
-    let hops = 0;
-    for (const agentId of Object.keys(edgeClock)) {
-        // refClock[agentId] ?? 0: if agent terminated, contributes 0
-        hops += Math.max(0, (refClock[agentId] ?? 0) - edgeClock[agentId]);
-    }
-    return hops;
-}
-/**
- * Check if clock A happened before clock B.
- * A happened before B if all entries in A are <= entries in B
- * and at least one entry in A is < the corresponding entry in B.
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns true if a happened before b
- */
-export function happenedBefore(a, b) {
-    const allKeys = new Set([...Object.keys(a), ...Object.keys(b)]);
-    let hasStrictlyLess = false;
-    for (const key of allKeys) {
-        const aVal = a[key] ?? 0;
-        const bVal = b[key] ?? 0;
-        if (aVal > bVal) {
-            return false; // a has a larger value, so a did not happen before b
-        }
-        if (aVal < bVal) {
-            hasStrictlyLess = true;
-        }
-    }
-    return hasStrictlyLess;
-}
-/**
- * Check if two clocks are concurrent (neither happened before the other, and not equal).
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns true if clocks are concurrent (not equal and incomparable)
- */
-export function areConcurrent(a, b) {
-    // First check if they're equal
-    const allKeys = new Set([...Object.keys(a), ...Object.keys(b)]);
-    let hasAnyDifference = false;
-    for (const key of allKeys) {
-        if ((a[key] ?? 0) !== (b[key] ?? 0)) {
-            hasAnyDifference = true;
-            break;
-        }
-    }
-    if (!hasAnyDifference) {
-        return false; // Equal clocks are not concurrent
-    }
-    return !happenedBefore(a, b) && !happenedBefore(b, a);
-}
-/**
- * Compare two clocks and return their causal relationship.
- *
- * @param a - First vector clock
- * @param b - Second vector clock
- * @returns 'before' if a < b, 'after' if a > b, 'concurrent' if neither, 'equal' if same
- */
-export function compare(a, b) {
-    if (happenedBefore(a, b))
-        return 'before';
-    if (happenedBefore(b, a))
-        return 'after';
-    // Check if equal
-    const allKeys = new Set([...Object.keys(a), ...Object.keys(b)]);
-    let isEqual = true;
-    for (const key of allKeys) {
-        if ((a[key] ?? 0) !== (b[key] ?? 0)) {
-            isEqual = false;
-            break;
-        }
-    }
-    return isEqual ? 'equal' : 'concurrent';
-}
-/**
- * Get the total number of ticks across all agents.
- * Useful for rough ordering when vector clocks are concurrent.
- *
- * @param clock - Vector clock
- * @returns Sum of all tick counts
- */
-export function totalTicks(clock) {
-    return Object.values(clock).reduce((sum, t) => sum + t, 0);
-}
-/**
- * Serialize a vector clock to JSON string for database storage.
- *
- * @param clock - Vector clock to serialize
- * @returns JSON string representation
- */
-export function serialize(clock) {
-    return JSON.stringify(clock);
-}
-/**
- * Deserialize a vector clock from JSON string.
- *
- * @param json - JSON string or null
- * @returns Deserialized vector clock (empty if null or invalid)
- */
-export function deserialize(json) {
-    if (!json)
-        return {};
-    try {
-        const parsed = JSON.parse(json);
-        // Validate it's an object with number values
-        if (typeof parsed === 'object' && parsed !== null) {
-            const clock = {};
-            for (const [key, value] of Object.entries(parsed)) {
-                if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
-                    clock[key] = value;
-                }
-            }
-            return clock;
-        }
-        return {};
-    }
-    catch (err) {
-        log.warn(`Failed to deserialize clock: ${json}`, { error: err instanceof Error ? err.message : String(err) });
-        return {};
-    }
-}
-/**
- * Clone a vector clock.
- *
- * @param clock - Clock to clone
- * @returns New clock with same values
- */
-export function clone(clock) {
-    return { ...clock };
-}
-/**
- * Check if a clock is empty (no ticks recorded).
- *
- * @param clock - Vector clock to check
- * @returns true if clock has no entries or all entries are 0
- */
-export function isEmpty(clock) {
-    const values = Object.values(clock);
-    return values.length === 0 || values.every((v) => v === 0);
-}
-/**
- * Get all agent IDs present in a clock.
- *
- * @param clock - Vector clock
- * @returns Array of agent IDs
- */
-export function getAgentIds(clock) {
-    return Object.keys(clock).filter((id) => clock[id] > 0);
-}
-//# sourceMappingURL=vector-clock.js.map

package/dist/temporal/vector-clock.js.map

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