om-memory-system 3.0.0

package/dist/services/user-profile/profile-utils.js

@@ -0,0 +1,45 @@
+export const safeArray = (arr) => {
+    if (!arr)
+        return [];
+    let result = arr;
+    if (typeof result === "string") {
+        try {
+            result = JSON.parse(result);
+        }
+        catch {
+            try {
+                result = JSON.parse(result.trim().replace(/,$/, ""));
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+    if (!Array.isArray(result))
+        return [];
+    const flattened = [];
+    const walk = (item) => {
+        if (Array.isArray(item)) {
+            item.forEach(walk);
+        }
+        else if (item) {
+            flattened.push(item);
+        }
+    };
+    walk(result);
+    return flattened;
+};
+export const safeObject = (obj, fallback) => {
+    if (!obj)
+        return fallback;
+    let result = obj;
+    if (typeof result === "string") {
+        try {
+            result = JSON.parse(result);
+        }
+        catch {
+            return fallback;
+        }
+    }
+    return result && typeof result === "object" && !Array.isArray(result) ? result : fallback;
+};

package/dist/services/user-profile/types.d.ts

@@ -0,0 +1,92 @@
+export interface UserProfilePreference {
+    category: string;
+    description: string;
+    confidence: number;
+    frequency: number;
+    evidence: string[];
+    lastSeen: number;
+    centroid?: number[];
+    anchor?: number[];
+    weakHitCount?: number;
+    lastWeakHitAt?: number;
+    driftBelowCount?: number;
+    alpha?: number;
+    beta?: number;
+    weakAlpha?: number;
+    weakBeta?: number;
+    pendingValidation?: boolean;
+    lastMatchTime?: number;
+    firstSeen?: number;
+}
+export interface UserProfilePattern {
+    category: string;
+    description: string;
+    confidence: number;
+    frequency: number;
+    evidence: string[];
+    lastSeen: number;
+    centroid?: number[];
+    anchor?: number[];
+    weakHitCount?: number;
+    lastWeakHitAt?: number;
+    driftBelowCount?: number;
+    alpha?: number;
+    beta?: number;
+    weakAlpha?: number;
+    weakBeta?: number;
+    pendingValidation?: boolean;
+    lastMatchTime?: number;
+    firstSeen?: number;
+}
+export interface UserProfileWorkflow {
+    description: string;
+    steps: string[];
+    confidence: number;
+    frequency: number;
+    evidence: string[];
+    lastSeen: number;
+    centroid?: number[];
+    anchor?: number[];
+    weakHitCount?: number;
+    lastWeakHitAt?: number;
+    driftBelowCount?: number;
+    alpha?: number;
+    beta?: number;
+    weakAlpha?: number;
+    weakBeta?: number;
+    pendingValidation?: boolean;
+    lastMatchTime?: number;
+    firstSeen?: number;
+}
+export interface UserProfileData {
+    preferences: UserProfilePreference[];
+    patterns: UserProfilePattern[];
+    workflows: UserProfileWorkflow[];
+    learning_paths?: {
+        topic: string;
+        chain: string[];
+        description: string;
+    }[];
+}
+export interface UserProfile {
+    id: string;
+    userId: string;
+    displayName: string;
+    userName: string;
+    userEmail: string;
+    profileData: string;
+    version: number;
+    createdAt: number;
+    lastAnalyzedAt: number;
+    totalPromptsAnalyzed: number;
+    isActive: boolean;
+}
+export interface UserProfileChangelog {
+    id: string;
+    profileId: string;
+    version: number;
+    changeType: string;
+    changeSummary: string;
+    profileDataSnapshot: string;
+    createdAt: number;
+}

package/dist/services/user-profile/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/user-profile/user-profile-manager.d.ts

@@ -0,0 +1,65 @@
+import type { UserProfile, UserProfileChangelog, UserProfileData } from "./types.js";
+import { EmbeddingService } from "../embedding.js";
+export declare class UserProfileManager {
+    private db;
+    private dbPath;
+    private initPromise;
+    private coldBuffers;
+    private coldBufferPath;
+    private dedupCheckedCache;
+    constructor();
+    reset(): void;
+    private initialize;
+    private ready;
+    private emptyColdBuffer;
+    private getColdBuffer;
+    private loadColdBuffers;
+    private saveColdBuffers;
+    private initDatabase;
+    getActiveProfile(userId: string): Promise<UserProfile | null>;
+    createProfile(userId: string, displayName: string, userName: string, userEmail: string, profileData: UserProfileData, promptsAnalyzed: number): Promise<string>;
+    updateProfile(profileId: string, profileData: UserProfileData, additionalPromptsAnalyzed: number, changeSummary: string): Promise<boolean>;
+    private addChangelog;
+    private cleanupOldChangelogs;
+    getProfileChangelogs(profileId: string, limit?: number): Promise<UserProfileChangelog[]>;
+    getChangelogById(id: string): Promise<UserProfileChangelog | undefined>;
+    decayInMemory(data: UserProfileData): {
+        data: UserProfileData;
+        hasChanges: boolean;
+    };
+    private decayItems;
+    deleteProfile(profileId: string): Promise<void>;
+    getProfileById(profileId: string): Promise<UserProfile | null>;
+    getAllActiveProfiles(): Promise<UserProfile[]>;
+    private rowToProfile;
+    private rowToChangelog;
+    mergeProfileData(existing: UserProfileData, updates: Partial<UserProfileData>, embedService?: EmbeddingService, profileId?: string): Promise<UserProfileData>;
+    private mergeItems;
+    /**
+     * Merge a new confirmed observation into an existing profile entry.
+     * ONLY call for confirmed matches (exact, strong sameCat/crossCat, Thompson upgrade).
+     * Do NOT call for forced merge or cross-validation — those handle fields directly.
+     */
+    private mergeConfirmedMatch;
+    private initItem;
+    /**
+     * Three-way merge: item1 + item2 + newItem → single combined entry.
+     * Called when top-1 and top-2 both strongly match the same new observation
+     * within the same category, confirming they describe the same behavior.
+     */
+    private combineThree;
+    private ensureArray;
+    private isMilestone;
+    private minEvidenceForEvolve;
+    syncConfidence(item: any): void;
+    private lazyMigrateAlpha;
+    private detectConflicts;
+    private checkSemanticDuplicate;
+    private deduplicateItems;
+    private checkConflict;
+    private evolveDescription;
+    evolveAndUpdate(item: any, itemType: string, profileId?: string): Promise<void>;
+    private callOpencodeProvider;
+    private callExternalAPI;
+}
+export declare const userProfileManager: UserProfileManager;