hippo-memory 0.36.0 → 0.37.0

package/dist/src/memory.js

@@ -0,0 +1,280 @@
+/**
+ * Core data model for Hippo memory entries.
+ * Based on the strength formula from PLAN.md.
+ */
+import { randomUUID } from 'crypto';
+export var Layer;
+(function (Layer) {
+    Layer["Buffer"] = "buffer";
+    Layer["Episodic"] = "episodic";
+    Layer["Semantic"] = "semantic";
+    Layer["Trace"] = "trace";
+})(Layer || (Layer = {}));
+export const DECISION_HALF_LIFE_DAYS = 90;
+// Emotional multipliers from PLAN.md
+const EMOTIONAL_MULTIPLIERS = {
+    neutral: 1.0,
+    positive: 1.3,
+    negative: 1.5, // error-tagged
+    critical: 2.0,
+};
+/**
+ * Compute the reward factor from cumulative outcome counts.
+ *
+ *   reward_ratio  = (positive - negative) / (positive + negative + 1)
+ *   reward_factor = 1 + 0.5 * reward_ratio
+ *
+ * Range: (0.5, 1.5). Neutral (no outcomes) returns 1.0.
+ * Modulates effective half-life: memories with consistent positive outcomes
+ * decay slower; consistent negative outcomes decay faster.
+ */
+export function calculateRewardFactor(entry) {
+    const pos = entry.outcome_positive ?? 0;
+    const neg = entry.outcome_negative ?? 0;
+    if (pos === 0 && neg === 0)
+        return 1.0;
+    const ratio = (pos - neg) / (pos + neg + 1);
+    return 1 + 0.5 * ratio;
+}
+/**
+ * Calculate current strength at a given time.
+ * strength(t) = base_strength * decay * retrieval_boost * emotional_multiplier
+ *
+ * Decay basis modes:
+ * - clock: classic wall-clock decay (daysSince / halfLife)
+ * - session: decay by sleep cycles instead of days (sessionsSince / halfLife)
+ * - adaptive: wall-clock decay with half-life scaled by session frequency
+ *
+ * Pinned memories always return 1.0 (no decay).
+ */
+export function calculateStrength(entry, now = new Date(), options = {}) {
+    if (entry.pinned)
+        return 1.0;
+    const lastRetrieved = new Date(entry.last_retrieved);
+    const daysSince = (now.getTime() - lastRetrieved.getTime()) / (1000 * 60 * 60 * 24);
+    // Reward-proportional half-life modulation
+    const rewardFactor = calculateRewardFactor(entry);
+    let effectiveHalfLife = entry.half_life_days * rewardFactor;
+    // Guard: zero half-life causes 0/0 = NaN in the exponent
+    if (effectiveHalfLife <= 0)
+        return 0.0;
+    const basis = options.decayBasis ?? 'clock';
+    let decayExponent;
+    if (basis === 'session') {
+        // Decay by session count: each sleep cycle = 1 "day" in the decay formula.
+        // Estimate sessions since last retrieval from wall-clock time and avg interval.
+        const avgInterval = options.avgSessionIntervalDays ?? 1;
+        const sessionsSince = avgInterval > 0 ? Math.max(0, daysSince / avgInterval) : daysSince;
+        decayExponent = sessionsSince / effectiveHalfLife;
+    }
+    else if (basis === 'adaptive') {
+        // Scale half-life by session frequency: infrequent agents get longer half-lives
+        const avgInterval = options.avgSessionIntervalDays ?? 0;
+        if (avgInterval > 1) {
+            effectiveHalfLife *= avgInterval;
+        }
+        decayExponent = daysSince / effectiveHalfLife;
+    }
+    else {
+        // clock: classic wall-clock decay
+        decayExponent = daysSince / effectiveHalfLife;
+    }
+    const decay = Math.pow(0.5, decayExponent);
+    // Retrieval boost: 1 + 0.1 * log2(retrieval_count + 1)
+    const retrievalBoost = 1 + 0.1 * Math.log2(entry.retrieval_count + 1);
+    // Emotional multiplier
+    const emotionalMultiplier = EMOTIONAL_MULTIPLIERS[entry.emotional_valence] ?? 1.0;
+    const raw = decay * retrievalBoost * emotionalMultiplier;
+    // Clamp to [0, 1] with NaN guard
+    const clamped = Math.min(1.0, Math.max(0.0, raw));
+    return Number.isFinite(clamped) ? clamped : 0.0;
+}
+/**
+ * Derive half-life based on signals, as per PLAN.md table.
+ */
+export function deriveHalfLife(base, entry) {
+    let hl = base;
+    // Error-tagged: 2x half-life
+    if (entry.tags?.includes('error')) {
+        hl *= 2;
+    }
+    // High schema fit: consolidates faster (1.5x)
+    if (entry.schema_fit !== undefined && entry.schema_fit > 0.7) {
+        hl *= 1.5;
+    }
+    // Low schema fit: decay faster (0.5x)
+    if (entry.schema_fit !== undefined && entry.schema_fit < 0.3) {
+        hl *= 0.5;
+    }
+    return hl;
+}
+/**
+ * Apply outcome feedback to a memory entry.
+ *
+ * Increments outcome_positive or outcome_negative counters.
+ * The reward factor in calculateStrength() uses these counts to
+ * continuously modulate the effective half-life:
+ *   reward_ratio  = (pos - neg) / (pos + neg + 1)
+ *   reward_factor = 1 + 0.5 * reward_ratio    // range (0.5, 1.5)
+ *   effective_hl  = half_life_days * reward_factor
+ *
+ * No fixed half-life delta. Decay rate adjusts proportionally to
+ * cumulative reward signal, inspired by R-STDP in spiking networks.
+ */
+export function applyOutcome(entry, good) {
+    const updated = {
+        ...entry,
+        outcome_score: good ? 1 : -1,
+        outcome_positive: (entry.outcome_positive ?? 0) + (good ? 1 : 0),
+        outcome_negative: (entry.outcome_negative ?? 0) + (good ? 0 : 1),
+    };
+    updated.strength = calculateStrength(updated);
+    return updated;
+}
+/**
+ * Generate a random memory ID using crypto.randomUUID().
+ */
+export function generateId(prefix = 'mem') {
+    return `${prefix}_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+}
+/**
+ * Resolve the effective confidence for a memory entry.
+ * If the entry has not been retrieved in 30+ days and is not 'verified',
+ * returns 'stale'. Otherwise returns the stored confidence value.
+ */
+export function resolveConfidence(entry, now = new Date()) {
+    if (entry.pinned || entry.confidence === 'verified')
+        return entry.confidence;
+    const lastRetrieved = new Date(entry.last_retrieved);
+    const daysSince = (now.getTime() - lastRetrieved.getTime()) / (1000 * 60 * 60 * 24);
+    if (daysSince > 30)
+        return 'stale';
+    return entry.confidence;
+}
+/**
+ * Create a new memory entry with defaults.
+ */
+export function createMemory(content, options = {}) {
+    const trimmed = content.trim();
+    if (trimmed.length < 3) {
+        throw new Error(`Memory content too short (${trimmed.length} chars, minimum 3): "${trimmed}"`);
+    }
+    const validOutcomes = ['success', 'failure', 'partial', null];
+    if (options.trace_outcome !== undefined && !validOutcomes.includes(options.trace_outcome)) {
+        throw new Error(`Invalid trace_outcome: ${options.trace_outcome}. Must be 'success', 'failure', 'partial', or null.`);
+    }
+    const now = new Date().toISOString();
+    const layer = options.layer ?? Layer.Episodic;
+    const tags = options.tags ?? [];
+    const emotional_valence = options.emotional_valence ?? inferValence(tags);
+    const schema_fit = options.schema_fit ?? 0.5;
+    const partial = { tags, schema_fit };
+    const half_life_days = deriveHalfLife(options.baseHalfLifeDays ?? 7, partial);
+    const entry = {
+        id: generateId(layer === Layer.Semantic ? 'sem' : 'mem'),
+        created: now,
+        last_retrieved: now,
+        retrieval_count: 0,
+        strength: 1.0,
+        half_life_days,
+        layer,
+        tags,
+        emotional_valence,
+        schema_fit,
+        source: options.source ?? 'cli',
+        outcome_score: null,
+        outcome_positive: 0,
+        outcome_negative: 0,
+        conflicts_with: [],
+        pinned: options.pinned ?? false,
+        confidence: options.confidence ?? 'verified',
+        content,
+        parents: [],
+        starred: false,
+        trace_outcome: options.trace_outcome ?? null,
+        source_session_id: options.source_session_id ?? null,
+        valid_from: options.valid_from ?? now,
+        superseded_by: null,
+        extracted_from: options.extracted_from ?? null,
+        dag_level: options.dag_level ?? 0,
+        dag_parent_id: options.dag_parent_id ?? null,
+        kind: options.kind ?? 'distilled',
+        scope: options.scope ?? null,
+        owner: options.owner ?? null,
+        artifact_ref: options.artifact_ref ?? null,
+        tenantId: options.tenantId ?? 'default',
+    };
+    // Recalculate strength with the emotional multiplier applied
+    entry.strength = calculateStrength(entry);
+    return entry;
+}
+/**
+ * Compute how well new content fits existing knowledge patterns.
+ * Returns 0..1 where:
+ *   >0.7 = high fit (consistent with existing knowledge, consolidates faster)
+ *   0.3-0.7 = moderate fit
+ *   <0.3 = novel (doesn't match existing patterns, decays faster if unused)
+ *
+ * Uses tag overlap (always available) weighted by how common each tag is.
+ * Rare shared tags signal stronger schema fit than common ones.
+ */
+export function computeSchemaFit(content, tags, existingEntries) {
+    if (existingEntries.length === 0)
+        return 0.5; // no schema yet, neutral
+    // Build tag frequency map across all existing entries
+    const tagFreq = new Map();
+    for (const entry of existingEntries) {
+        for (const tag of entry.tags) {
+            tagFreq.set(tag, (tagFreq.get(tag) ?? 0) + 1);
+        }
+    }
+    if (tags.length === 0 && tagFreq.size === 0)
+        return 0.5;
+    // Tag overlap: IDF-weighted Jaccard
+    // Shared rare tags matter more than shared common tags
+    let weightedOverlap = 0;
+    let totalWeight = 0;
+    const N = existingEntries.length;
+    for (const tag of tags) {
+        const freq = tagFreq.get(tag) ?? 0;
+        // IDF-weighted: rare shared tags score higher
+        const maxIdf = Math.log(N + 1) + 1;
+        if (freq > 0) {
+            const idf = Math.log(N / freq) + 1;
+            weightedOverlap += idf;
+        }
+        totalWeight += maxIdf;
+    }
+    // Scale so that matching half the tags at average IDF gives ~0.5
+    const tagScore = totalWeight > 0 ? Math.min(1, (weightedOverlap / totalWeight) * 2) : 0;
+    // Content overlap: check how many existing entries share significant tokens
+    const newTokens = new Set(content.toLowerCase().replace(/[^\w\s]/g, ' ').split(/\s+/).filter((t) => t.length > 3));
+    if (newTokens.size === 0)
+        return Math.min(1, Math.max(0, tagScore));
+    let contentMatches = 0;
+    for (const entry of existingEntries) {
+        const entryTokens = new Set(entry.content.toLowerCase().replace(/[^\w\s]/g, ' ').split(/\s+/).filter((t) => t.length > 3));
+        let shared = 0;
+        for (const token of newTokens) {
+            if (entryTokens.has(token))
+                shared++;
+        }
+        const overlap = shared / Math.max(newTokens.size, 1);
+        if (overlap > 0.2)
+            contentMatches++;
+    }
+    const contentScore = Math.min(1, contentMatches / Math.max(5, N * 0.1));
+    // Blend: 60% tag overlap, 40% content overlap
+    const fit = 0.6 * tagScore + 0.4 * contentScore;
+    return Math.min(1, Math.max(0, fit));
+}
+function inferValence(tags) {
+    if (tags.includes('critical'))
+        return 'critical';
+    if (tags.includes('error'))
+        return 'negative';
+    if (tags.includes('success') || tags.includes('win'))
+        return 'positive';
+    return 'neutral';
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/memory.js.map

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

package/dist/src/multihop.js

@@ -0,0 +1,32 @@
+import { search } from './search.js';
+export function multihopSearch(query, entries, options = {}) {
+    const pass1 = search(query, entries, { ...options, budget: (options.budget ?? 4000) * 2 });
+    const topK = pass1.slice(0, 10);
+    if (topK.length === 0)
+        return [];
+    const entityTags = new Set();
+    for (const r of topK) {
+        for (const tag of r.entry.tags) {
+            if (tag.startsWith('speaker:') || tag.startsWith('topic:')) {
+                entityTags.add(tag);
+            }
+        }
+    }
+    const queryLower = query.toLowerCase();
+    const newEntities = [...entityTags]
+        .map((t) => t.split(':')[1])
+        .filter((e) => !queryLower.includes(e.toLowerCase()));
+    if (newEntities.length === 0)
+        return pass1;
+    const followUpQuery = newEntities.join(' ') + ' ' + query;
+    const pass2 = search(followUpQuery, entries, options);
+    const merged = new Map();
+    for (const r of [...pass1, ...pass2]) {
+        const existing = merged.get(r.entry.id);
+        if (!existing || r.score > existing.score) {
+            merged.set(r.entry.id, r);
+        }
+    }
+    return [...merged.values()].sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=multihop.js.map

package/dist/src/multihop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multihop.js","sourceRoot":"","sources":["../../src/multihop.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAExD,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,OAAsB,EACtB,UAAgI,EAAE;IAElI,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3D,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,CAAC,GAAG,UAAU,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAExD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3C,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/path-context.js

@@ -0,0 +1,32 @@
+/**
+ * Extract meaningful path segments from a directory path.
+ * Returns tags like ['path:src', 'path:api', 'path:my-project'].
+ * Filters out noise (node_modules, .git, Users, home dirs, drive letters).
+ */
+export function extractPathTags(dirPath) {
+    const normalized = dirPath.replace(/\\/g, '/');
+    const segments = normalized.split('/').filter(Boolean);
+    const noise = new Set([
+        'users', 'home', 'documents', 'desktop', 'downloads',
+        'node_modules', '.git', '.hippo', 'dist', 'build',
+        'c:', 'd:', 'tmp', 'temp', 'var', 'usr', 'opt', 'etc',
+        'appdata', 'local', 'roaming', 'program files', 'program files (x86)',
+    ]);
+    return segments
+        .filter(s => s.length >= 2 && !noise.has(s.toLowerCase()))
+        .slice(-4) // keep last 4 meaningful segments (most specific)
+        .map(s => `path:${s.toLowerCase()}`);
+}
+/**
+ * Compute path overlap score between two sets of path tags.
+ * Returns 0..1 where 1 = perfect match.
+ */
+export function pathOverlapScore(memoryPathTags, currentPathTags) {
+    if (memoryPathTags.length === 0 || currentPathTags.length === 0)
+        return 0;
+    const memSet = new Set(memoryPathTags);
+    const matches = currentPathTags.filter(t => memSet.has(t)).length;
+    // Weight toward the memory's path tags (what fraction of the memory's context matches)
+    return matches / memoryPathTags.length;
+}
+//# sourceMappingURL=path-context.js.map

package/dist/src/path-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-context.js","sourceRoot":"","sources":["../../src/path-context.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW;QACpD,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;QACjD,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;QACrD,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,qBAAqB;KACtE,CAAC,CAAC;IAEH,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SACzD,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,kDAAkD;SAC7D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,cAAwB,EAAE,eAAyB;IAClF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,uFAAuF;IACvF,OAAO,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC;AACzC,CAAC"}

package/dist/src/physics-config.js

@@ -0,0 +1,26 @@
+/**
+ * Physics engine configuration for Hippo memory-as-physics.
+ * All constants are tunable; defaults calibrated for ~500 memory corpus.
+ */
+export const DEFAULT_PHYSICS_CONFIG = {
+    enabled: 'auto',
+    G_query: 2.0,
+    G_memory: 0.01,
+    K_repulsion: 0.5,
+    drag: 0.3,
+    interference_gain: 0.3,
+    momentum_weight: 0.1,
+    max_velocity: 0.1,
+    dt: 0.1,
+    substeps: 5,
+    feedback_alpha: 0.01,
+    temperature_decay: 1.0,
+    cluster_threshold: 0.7,
+    cluster_top_k: 20,
+};
+export function mergePhysicsConfig(partial) {
+    if (!partial)
+        return { ...DEFAULT_PHYSICS_CONFIG };
+    return { ...DEFAULT_PHYSICS_CONFIG, ...partial };
+}
+//# sourceMappingURL=physics-config.js.map

package/dist/src/physics-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics-config.js","sourceRoot":"","sources":["../../src/physics-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH,MAAM,CAAC,MAAM,sBAAsB,GAA4B;IAC7D,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,iBAAiB,EAAE,GAAG;IACtB,eAAe,EAAE,GAAG;IACpB,YAAY,EAAE,GAAG;IACjB,EAAE,EAAE,GAAG;IACP,QAAQ,EAAE,CAAC;IACX,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,GAAG;IACtB,iBAAiB,EAAE,GAAG;IACtB,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,GAAG,sBAAsB,EAAE,CAAC;IACnD,OAAO,EAAE,GAAG,sBAAsB,EAAE,GAAG,OAAO,EAAE,CAAC;AACnD,CAAC"}

package/dist/src/physics-state.js

@@ -0,0 +1,163 @@
+/**
+ * Physics state persistence for Hippo.
+ * Stores and loads particle state (position, velocity, mass, charge, temperature)
+ * in SQLite using BLOB columns for 384-dim vectors.
+ */
+import { computeMass, computeCharge, computeTemperature, vecZero } from './physics.js';
+import { calculateStrength } from './memory.js';
+// ---------------------------------------------------------------------------
+// Float32Array <-> Buffer serialization
+// ---------------------------------------------------------------------------
+export function float32ToBuffer(arr) {
+    const f32 = new Float32Array(arr);
+    return Buffer.from(f32.buffer);
+}
+export function bufferToFloat32(buf) {
+    if (buf.byteLength === 0 || buf.byteLength % 4 !== 0)
+        return [];
+    // Ensure we have a properly aligned copy (SQLite may return Uint8Array, not Buffer)
+    const bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    const aligned = new ArrayBuffer(bytes.length);
+    new Uint8Array(aligned).set(bytes);
+    return Array.from(new Float32Array(aligned));
+}
+// ---------------------------------------------------------------------------
+// Schema migration
+// ---------------------------------------------------------------------------
+/**
+ * Create the memory_physics table (migration v8).
+ * Call this from db.ts MIGRATIONS array.
+ */
+export function createPhysicsTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS memory_physics (
+      memory_id TEXT PRIMARY KEY REFERENCES memories(id) ON DELETE CASCADE,
+      position_blob BLOB NOT NULL,
+      velocity_blob BLOB NOT NULL,
+      mass REAL NOT NULL,
+      charge REAL NOT NULL,
+      temperature REAL NOT NULL,
+      last_simulation TEXT NOT NULL,
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_memory_physics_mass
+    ON memory_physics(mass DESC);
+  `);
+}
+/**
+ * Load physics state for specific memory IDs (or all if no IDs given).
+ */
+export function loadPhysicsState(db, memoryIds) {
+    const map = new Map();
+    let rows;
+    if (memoryIds && memoryIds.length > 0) {
+        const placeholders = memoryIds.map(() => '?').join(',');
+        rows = db.prepare(`SELECT memory_id, position_blob, velocity_blob, mass, charge, temperature, last_simulation
+       FROM memory_physics WHERE memory_id IN (${placeholders})`).all(...memoryIds);
+    }
+    else {
+        rows = db.prepare(`SELECT memory_id, position_blob, velocity_blob, mass, charge, temperature, last_simulation
+       FROM memory_physics`).all();
+    }
+    for (const row of rows) {
+        map.set(row.memory_id, {
+            memoryId: row.memory_id,
+            position: bufferToFloat32(row.position_blob),
+            velocity: bufferToFloat32(row.velocity_blob),
+            mass: row.mass,
+            charge: row.charge,
+            temperature: row.temperature,
+            lastSimulation: row.last_simulation,
+        });
+    }
+    return map;
+}
+/**
+ * Save physics state for multiple particles (batch upsert).
+ */
+export function savePhysicsState(db, particles) {
+    if (particles.length === 0)
+        return;
+    const stmt = db.prepare(`
+    INSERT INTO memory_physics (memory_id, position_blob, velocity_blob, mass, charge, temperature, last_simulation, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, datetime('now'))
+    ON CONFLICT(memory_id) DO UPDATE SET
+      position_blob = excluded.position_blob,
+      velocity_blob = excluded.velocity_blob,
+      mass = excluded.mass,
+      charge = excluded.charge,
+      temperature = excluded.temperature,
+      last_simulation = excluded.last_simulation,
+      updated_at = datetime('now')
+  `);
+    db.exec('BEGIN');
+    try {
+        for (const p of particles) {
+            stmt.run(p.memoryId, float32ToBuffer(p.position), float32ToBuffer(p.velocity), p.mass, p.charge, p.temperature, p.lastSimulation);
+        }
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+/**
+ * Initialize physics state for a memory from its embedding vector.
+ * Returns the new particle (does not persist — caller must save).
+ */
+export function initializeParticle(entry, embedding, now = new Date()) {
+    const strength = calculateStrength(entry, now);
+    const ageDays = (now.getTime() - new Date(entry.created).getTime()) / (1000 * 60 * 60 * 24);
+    return {
+        memoryId: entry.id,
+        position: [...embedding], // copy — position will diverge from original embedding
+        velocity: vecZero(embedding.length),
+        mass: computeMass(strength, entry.retrieval_count),
+        charge: computeCharge(entry.emotional_valence),
+        temperature: computeTemperature(ageDays, 1.0),
+        lastSimulation: now.toISOString(),
+    };
+}
+/**
+ * Delete physics state for a memory. (Also handled by CASCADE, but explicit for clarity.)
+ */
+export function deletePhysicsState(db, memoryId) {
+    db.prepare('DELETE FROM memory_physics WHERE memory_id = ?').run(memoryId);
+}
+/**
+ * Reset all physics states from original embeddings.
+ * Drops existing physics data and re-initializes from the embedding index.
+ */
+export function resetAllPhysicsState(db, entries, embeddingIndex, now = new Date()) {
+    db.exec('DELETE FROM memory_physics');
+    const particles = [];
+    for (const entry of entries) {
+        const embedding = embeddingIndex[entry.id];
+        if (!embedding || embedding.length === 0)
+            continue;
+        particles.push(initializeParticle(entry, embedding, now));
+    }
+    if (particles.length > 0) {
+        savePhysicsState(db, particles);
+    }
+    return particles.length;
+}
+/**
+ * Refresh mass, charge, and temperature for existing particles
+ * based on current memory attributes (called during consolidation).
+ */
+export function refreshParticleProperties(particles, entries, now = new Date()) {
+    for (const p of particles) {
+        const entry = entries.get(p.memoryId);
+        if (!entry)
+            continue;
+        const strength = calculateStrength(entry, now);
+        const ageDays = (now.getTime() - new Date(entry.created).getTime()) / (1000 * 60 * 60 * 24);
+        p.mass = computeMass(strength, entry.retrieval_count);
+        p.charge = computeCharge(entry.emotional_valence);
+        p.temperature = computeTemperature(ageDays, 1.0);
+    }
+}
+//# sourceMappingURL=physics-state.js.map

package/dist/src/physics-state.js.map

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