memobank-cli 0.2.0

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,UAAU,EAAU,MAAM,SAAS,CAAC;AAkC7C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAsCvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAetE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAStE"}

package/dist/config.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Config module
+ * Read and write meta/config.yaml
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.writeConfig = writeConfig;
+exports.initConfig = initConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const DEFAULT_CONFIG = {
+    project: {
+        name: 'default',
+        description: '',
+    },
+    memory: {
+        token_budget: 500,
+        top_k: 5,
+    },
+    embedding: {
+        engine: 'text',
+        provider: 'openai',
+        model: 'text-embedding-3-small',
+        dimensions: 1536,
+        base_url: undefined,
+    },
+    search: {
+        use_tags: true,
+        use_summary: true,
+    },
+    review: {
+        enabled: true,
+    },
+};
+/**
+ * Get config file path
+ */
+function getConfigPath(repoRoot) {
+    return path.join(repoRoot, 'meta', 'config.yaml');
+}
+/**
+ * Load config from repo root
+ * Falls back to defaults if file doesn't exist
+ */
+function loadConfig(repoRoot) {
+    const configPath = getConfigPath(repoRoot);
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const loaded = yaml.load(content);
+        // Merge with defaults
+        return {
+            project: {
+                ...DEFAULT_CONFIG.project,
+                ...loaded?.project,
+            },
+            memory: {
+                ...DEFAULT_CONFIG.memory,
+                ...loaded?.memory,
+            },
+            embedding: {
+                ...DEFAULT_CONFIG.embedding,
+                ...loaded?.embedding,
+            },
+            search: {
+                ...DEFAULT_CONFIG.search,
+                ...loaded?.search,
+            },
+            review: {
+                ...DEFAULT_CONFIG.review,
+                ...loaded?.review,
+            },
+        };
+    }
+    catch (error) {
+        console.warn(`Could not load config: ${error.message}`);
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/**
+ * Write config to repo root
+ */
+function writeConfig(repoRoot, config) {
+    const configPath = getConfigPath(repoRoot);
+    const configDir = path.dirname(configPath);
+    // Ensure meta directory exists
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    try {
+        const content = yaml.dump(config, { indent: 2 });
+        fs.writeFileSync(configPath, content, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Could not write config: ${error.message}`);
+    }
+}
+/**
+ * Initialize config with project name
+ */
+function initConfig(repoRoot, projectName) {
+    const config = {
+        ...DEFAULT_CONFIG,
+        project: {
+            name: projectName,
+        },
+    };
+    writeConfig(repoRoot, config);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/decay-engine.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Weibull decay engine for memory scoring
+ * Ported from memory-lancedb-pro
+ * Formula: score = recency_weight × frequency_weight × importance_weight
+ */
+import { MemoryFile } from '../types';
+/**
+ * Compute decay score for a memory (0-1)
+ * Based on recency, access frequency, and confidence
+ */
+export declare function computeDecayScore(memory: MemoryFile, now?: Date): number;
+/**
+ * Check if a memory is due for review
+ */
+export declare function isReviewDue(memory: MemoryFile, now?: Date): boolean;
+//# sourceMappingURL=decay-engine.d.ts.map

package/dist/core/decay-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay-engine.d.ts","sourceRoot":"","sources":["../../src/core/decay-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAc,MAAM,UAAU,CAAC;AAElD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAYpF;AAqCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAU/E"}

package/dist/core/decay-engine.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Weibull decay engine for memory scoring
+ * Ported from memory-lancedb-pro
+ * Formula: score = recency_weight × frequency_weight × importance_weight
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeDecayScore = computeDecayScore;
+exports.isReviewDue = isReviewDue;
+/**
+ * Compute decay score for a memory (0-1)
+ * Based on recency, access frequency, and confidence
+ */
+function computeDecayScore(memory, now = new Date()) {
+    // 1. Recency weight: Weibull stretched-exponential decay from created date
+    const recencyWeight = computeRecencyWeight(memory.created, now);
+    // 2. Frequency weight: 1.0 for now (will be incremented by future access tracking)
+    const frequencyWeight = 1.0;
+    // 3. Importance weight: based on confidence
+    const importanceWeight = computeImportanceWeight(memory.confidence);
+    // Final score
+    return recencyWeight * frequencyWeight * importanceWeight;
+}
+/**
+ * Compute recency weight using Weibull stretched-exponential decay
+ * Returns 0-1, where 1 is most recent
+ */
+function computeRecencyWeight(createdDate, now) {
+    const created = new Date(createdDate);
+    const daysSinceCreation = (now.getTime() - created.getTime()) / (1000 * 60 * 60 * 24);
+    // Weibull parameters
+    const k = 0.5; // shape parameter
+    const lambda = 90; // scale parameter (90 days half-life-ish)
+    // Stretched-exponential decay
+    const t = daysSinceCreation / lambda;
+    const recency = Math.exp(-Math.pow(t, k));
+    return Math.max(0, Math.min(1, recency));
+}
+/**
+ * Compute importance weight based on confidence
+ */
+function computeImportanceWeight(confidence) {
+    switch (confidence) {
+        case 'high':
+            return 1.0;
+        case 'medium':
+            return 0.7;
+        case 'low':
+            return 0.4;
+        default:
+            return 0.5; // default for unspecified
+    }
+}
+/**
+ * Check if a memory is due for review
+ */
+function isReviewDue(memory, now = new Date()) {
+    if (!memory.review_after) {
+        return false;
+    }
+    const created = new Date(memory.created);
+    const reviewDuration = parseReviewDuration(memory.review_after);
+    const reviewDate = new Date(created.getTime() + reviewDuration);
+    return now >= reviewDate;
+}
+/**
+ * Parse review duration string (e.g., "90d", "1w", "3m") into milliseconds
+ */
+function parseReviewDuration(duration) {
+    const match = duration.match(/^(\d+)([dwmy])$/);
+    if (!match?.[1]) {
+        // Default to 90 days if format is invalid
+        return 90 * 24 * 60 * 60 * 1000;
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const msPerDay = 24 * 60 * 60 * 1000;
+    switch (unit) {
+        case 'd':
+            return value * msPerDay;
+        case 'w':
+            return value * 7 * msPerDay;
+        case 'm':
+            return value * 30 * msPerDay;
+        case 'y':
+            return value * 365 * msPerDay;
+        default:
+            return 90 * msPerDay;
+    }
+}
+//# sourceMappingURL=decay-engine.js.map

package/dist/core/decay-engine.js.map

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

package/dist/core/embedding.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Embedding Generator
+ * Generates vector embeddings using OpenAI-compatible APIs
+ * Supports: OpenAI, Azure, Ollama, and other compatible providers
+ */
+export type EmbeddingProvider = 'openai' | 'azure' | 'ollama' | 'custom';
+export interface EmbeddingConfig {
+    provider: EmbeddingProvider;
+    model: string;
+    dimensions: number;
+    baseUrl?: string;
+    apiKey?: string;
+}
+export declare class EmbeddingGenerator {
+    private client;
+    private config;
+    constructor(config: EmbeddingConfig);
+    /**
+     * Get default base URL for provider
+     */
+    private getDefaultBaseUrl;
+    /**
+     * Generate embedding for a single text
+     * @param text - Input text to embed
+     * @returns Vector embedding as number array
+     */
+    generateEmbedding(text: string): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts in batch
+     * @param texts - Array of input texts
+     * @returns Array of vector embeddings
+     */
+    generateEmbeddings(texts: string[]): Promise<number[][]>;
+    /**
+     * Get embedding dimensions by querying the model
+     * Useful when dimensions are unknown for custom models
+     */
+    detectDimensions(): Promise<number>;
+    /**
+     * Create embedding config from memo config
+     * Supports multiple providers with appropriate defaults
+     */
+    static fromMemoConfig(config: {
+        embedding: {
+            provider?: string;
+            model?: string;
+            base_url?: string;
+            dimensions?: number;
+        };
+    }): EmbeddingConfig | null;
+    /**
+     * Get default model for provider
+     */
+    private static getDefaultModel;
+    /**
+     * Get default dimensions for known models
+     */
+    private static getDefaultDimensions;
+}
+//# sourceMappingURL=embedding.d.ts.map

package/dist/core/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/core/embedding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAYnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;OAIG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBxD;;;;OAIG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAmB9D;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IASzC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE;QAC5B,SAAS,EAAE;YACT,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,GAAG,eAAe,GAAG,IAAI;IAmC1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CA4BpC"}

package/dist/core/embedding.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Embedding Generator
+ * Generates vector embeddings using OpenAI-compatible APIs
+ * Supports: OpenAI, Azure, Ollama, and other compatible providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingGenerator = void 0;
+const openai_1 = require("openai");
+class EmbeddingGenerator {
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Ollama typically uses empty string or 'ollama' as API key
+        const apiKey = config.apiKey || (config.provider === 'ollama' ? 'ollama' : '');
+        this.client = new openai_1.OpenAI({
+            apiKey,
+            baseURL: config.baseUrl || this.getDefaultBaseUrl(config.provider),
+        });
+    }
+    /**
+     * Get default base URL for provider
+     */
+    getDefaultBaseUrl(provider) {
+        switch (provider) {
+            case 'ollama':
+                return 'http://localhost:11434/v1';
+            case 'azure':
+                return 'https://api.openai.com/v1'; // Azure uses different format
+            default:
+                return 'https://api.openai.com/v1';
+        }
+    }
+    /**
+     * Generate embedding for a single text
+     * @param text - Input text to embed
+     * @returns Vector embedding as number array
+     */
+    async generateEmbedding(text) {
+        try {
+            const response = await this.client.embeddings.create({
+                model: this.config.model,
+                input: text,
+            });
+            const embedding = response.data?.[0]?.embedding;
+            if (!embedding) {
+                throw new Error('No embedding returned');
+            }
+            return embedding;
+        }
+        catch (error) {
+            throw new Error(`Failed to generate embedding: ${error.message}`);
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts in batch
+     * @param texts - Array of input texts
+     * @returns Array of vector embeddings
+     */
+    async generateEmbeddings(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        try {
+            const response = await this.client.embeddings.create({
+                model: this.config.model,
+                input: texts,
+            });
+            // Sort by index to ensure order matches input
+            const sorted = response.data.sort((a, b) => a.index - b.index);
+            return sorted.map((item) => item.embedding);
+        }
+        catch (error) {
+            throw new Error(`Failed to generate embeddings: ${error.message}`);
+        }
+    }
+    /**
+     * Get embedding dimensions by querying the model
+     * Useful when dimensions are unknown for custom models
+     */
+    async detectDimensions() {
+        try {
+            const embedding = await this.generateEmbedding('test');
+            return embedding.length;
+        }
+        catch (error) {
+            throw new Error(`Failed to detect dimensions: ${error.message}`);
+        }
+    }
+    /**
+     * Create embedding config from memo config
+     * Supports multiple providers with appropriate defaults
+     */
+    static fromMemoConfig(config) {
+        const { embedding } = config;
+        const provider = embedding.provider || 'openai';
+        // Get API key based on provider
+        let apiKey;
+        if (provider === 'ollama') {
+            // Ollama doesn't require an API key
+            apiKey = undefined;
+        }
+        else {
+            // OpenAI, Azure, etc. need API key from environment
+            apiKey = process.env.OPENAI_API_KEY || process.env.AZURE_API_KEY;
+            if (!apiKey && provider !== 'custom') {
+                return null;
+            }
+        }
+        // Get model with provider-specific defaults
+        const model = embedding.model || EmbeddingGenerator.getDefaultModel(provider);
+        // Get dimensions - either from config or detect automatically later
+        let dimensions = embedding.dimensions;
+        if (!dimensions) {
+            dimensions = EmbeddingGenerator.getDefaultDimensions(model);
+        }
+        return {
+            provider,
+            model,
+            dimensions,
+            baseUrl: embedding.base_url,
+            apiKey,
+        };
+    }
+    /**
+     * Get default model for provider
+     */
+    static getDefaultModel(provider) {
+        switch (provider) {
+            case 'ollama':
+                return 'mxbai-embed-large'; // Popular Ollama embedding model
+            case 'azure':
+                return 'text-embedding-ada-002';
+            default:
+                return 'text-embedding-3-small';
+        }
+    }
+    /**
+     * Get default dimensions for known models
+     */
+    static getDefaultDimensions(model) {
+        const modelDimensions = {
+            // OpenAI
+            'text-embedding-3-small': 1536,
+            'text-embedding-3-large': 3072,
+            'text-embedding-ada-002': 1536,
+            // Ollama popular models
+            'mxbai-embed-large': 1024,
+            'nomic-embed-text': 768,
+            'all-minilm': 384,
+            'all-mpnet-base-v2': 768,
+        };
+        // Try exact match first
+        if (modelDimensions[model]) {
+            return modelDimensions[model];
+        }
+        // Try partial match
+        for (const [key, dim] of Object.entries(modelDimensions)) {
+            if (model.includes(key)) {
+                return dim;
+            }
+        }
+        // Default fallback
+        return 1536;
+    }
+}
+exports.EmbeddingGenerator = EmbeddingGenerator;
+//# sourceMappingURL=embedding.js.map

package/dist/core/embedding.js.map

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

package/dist/core/lifecycle-manager.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Memory Lifecycle Manager
+ * Handles memory promotion, demotion, archival, and correction
+ * Ported and adapted from memory-lancedb-pro
+ */
+import { MemoryFile } from '../types';
+/**
+ * Memory tiers based on usage and importance
+ */
+export type MemoryTier = 'core' | 'working' | 'peripheral';
+/**
+ * Access log for tracking memory usage
+ */
+export interface AccessLog {
+    memoryPath: string;
+    lastAccessed: Date;
+    accessCount: number;
+    recallQueries: string[];
+}
+/**
+ * Lifecycle configuration
+ */
+export interface LifecycleConfig {
+    coreThreshold: number;
+    peripheralThreshold: number;
+    archiveAfterDays: number;
+    deleteAfterDays: number;
+    allowCorrections: boolean;
+    correctionThreshold: number;
+}
+/**
+ * Load access logs
+ */
+export declare function loadAccessLogs(repoRoot: string): Record<string, AccessLog>;
+/**
+ * Save access logs
+ */
+export declare function saveAccessLogs(repoRoot: string, logs: Record<string, AccessLog>): void;
+/**
+ * Record memory access
+ */
+export declare function recordAccess(repoRoot: string, memoryPath: string, query?: string): AccessLog;
+/**
+ * Get memory tier based on access patterns
+ */
+export declare function getMemoryTier(memory: MemoryFile, accessLog?: AccessLog, config?: LifecycleConfig): MemoryTier;
+/**
+ * Analyze memory lifecycle for all memories
+ */
+export interface LifecycleAnalysis {
+    memory: MemoryFile;
+    tier: MemoryTier;
+    accessCount: number;
+    daysSinceAccess: number | null;
+    isArchivalCandidate: boolean;
+    isDeletionCandidate: boolean;
+    suggestion?: string;
+}
+export declare function analyzeLifecycle(repoRoot: string, config?: LifecycleConfig): LifecycleAnalysis[];
+/**
+ * Correction record for tracking memory corrections
+ */
+export interface CorrectionRecord {
+    memoryPath: string;
+    corrections: Array<{
+        date: string;
+        originalText: string;
+        correctedText: string;
+        reason: string;
+    }>;
+    flaggedForReview: boolean;
+}
+/**
+ * Load corrections log
+ */
+export declare function loadCorrections(repoRoot: string): Record<string, CorrectionRecord>;
+/**
+ * Save corrections log
+ */
+export declare function saveCorrections(repoRoot: string, corrections: Record<string, CorrectionRecord>): void;
+/**
+ * Record a memory correction
+ */
+export declare function recordCorrection(repoRoot: string, memoryPath: string, originalText: string, correctedText: string, reason: string): CorrectionRecord;
+/**
+ * Get memories flagged for review
+ */
+export declare function getFlaggedMemories(repoRoot: string): MemoryFile[];
+/**
+ * Archive a memory (move to archive directory)
+ */
+export declare function archiveMemory(repoRoot: string, memoryPath: string): void;
+/**
+ * Delete a memory permanently
+ */
+export declare function deleteMemory(repoRoot: string, memoryPath: string): void;
+/**
+ * Update memory content (correction)
+ */
+export declare function updateMemory(repoRoot: string, memoryPath: string, updates: Partial<MemoryFile>): void;
+/**
+ * Generate lifecycle report
+ */
+export declare function generateLifecycleReport(repoRoot: string, config?: LifecycleConfig): string;
+//# sourceMappingURL=lifecycle-manager.d.ts.map

package/dist/core/lifecycle-manager.d.ts.map

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