kratos-memory 1.0.0

package/dist/memory-server/concept-store.js

@@ -0,0 +1,329 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { Logger } from '../utils/logger.js';
+const logger = new Logger('ConceptStore');
+export class ConceptStore {
+    db;
+    static instances = new Map();
+    projectId;
+    constructor(projectId) {
+        this.projectId = projectId;
+        // ISOLATED concept store per project - no pollution!
+        const kratosHome = path.join(os.homedir(), '.kratos');
+        const dbPath = path.join(kratosHome, 'projects', projectId, 'databases', 'concepts.db');
+        fs.ensureDirSync(path.dirname(dbPath));
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.initializeSchema();
+        logger.info(`Concept store ISOLATED for project: ${projectId}`);
+    }
+    static getInstance(projectId) {
+        const id = projectId || 'global';
+        if (!ConceptStore.instances.has(id)) {
+            ConceptStore.instances.set(id, new ConceptStore(id));
+        }
+        return ConceptStore.instances.get(id);
+    }
+    initializeSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS concepts (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL,
+        body TEXT NOT NULL,
+        tags TEXT DEFAULT '[]',
+        importance INTEGER DEFAULT 3 CHECK(importance >= 1 AND importance <= 5),
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_concept_importance ON concepts(importance DESC);
+      CREATE INDEX IF NOT EXISTS idx_concept_created ON concepts(created_at DESC);
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS concept_fts USING fts5(
+        title,
+        body,
+        content='concepts',
+        content_rowid='rowid',
+        tokenize='porter unicode61'
+      );
+
+      -- FTS sync triggers
+      CREATE TRIGGER IF NOT EXISTS concept_fts_insert AFTER INSERT ON concepts BEGIN
+        INSERT INTO concept_fts(rowid, title, body) VALUES (new.rowid, new.title, new.body);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS concept_fts_delete AFTER DELETE ON concepts BEGIN
+        DELETE FROM concept_fts WHERE rowid = old.rowid;
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS concept_fts_update AFTER UPDATE ON concepts BEGIN
+        DELETE FROM concept_fts WHERE rowid = old.rowid;
+        INSERT INTO concept_fts(rowid, title, body) VALUES (new.rowid, new.title, new.body);
+      END;
+
+      -- Allowlist table for project-level concept permissions
+      CREATE TABLE IF NOT EXISTS project_allowlists (
+        project_id TEXT NOT NULL,
+        concept_id TEXT NOT NULL,
+        added_at INTEGER NOT NULL,
+        PRIMARY KEY (project_id, concept_id),
+        FOREIGN KEY (concept_id) REFERENCES concepts(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_allowlist_project ON project_allowlists(project_id);
+    `);
+        // Seed initial concepts if empty
+        this.seedInitialConcepts();
+    }
+    seedInitialConcepts() {
+        const count = this.db.prepare('SELECT COUNT(*) as count FROM concepts').get();
+        if (count.count === 0) {
+            const initialConcepts = [
+                {
+                    id: 'jwt-auth-v2',
+                    title: 'JWT Authentication Pattern',
+                    body: 'Standard JWT auth flow: 1) Client sends credentials 2) Server validates, generates JWT with claims 3) Client includes JWT in Authorization header 4) Server validates JWT signature & expiry 5) Extract user from claims. Key: Use RS256 for production, short expiry + refresh tokens.',
+                    tags: ['jwt', 'auth', 'security', 'pattern'],
+                    importance: 5
+                },
+                {
+                    id: 's3-upload-checklist',
+                    title: 'S3 Upload Security Checklist',
+                    body: 'Before S3 uploads: Generate presigned URLs server-side, Set expiry < 5min, Validate file type/size, Use random S3 keys (not user filenames), Set bucket CORS policy, Enable versioning, Configure lifecycle rules, Monitor with CloudWatch',
+                    tags: ['s3', 'aws', 'upload', 'security', 'checklist'],
+                    importance: 5
+                },
+                {
+                    id: 'rate-limiter-pattern',
+                    title: 'API Rate Limiting Pattern',
+                    body: 'Token bucket algorithm: Each user gets N tokens/minute. Request costs 1 token. If tokens=0, reject with 429. Refill tokens at fixed rate. Implementation: Redis INCR with TTL, or in-memory with sliding window. Add headers: X-RateLimit-Limit/Remaining/Reset.',
+                    tags: ['api', 'rate-limit', 'security', 'pattern'],
+                    importance: 4
+                },
+                {
+                    id: 'error-boundary-react',
+                    title: 'React Error Boundary Pattern',
+                    body: 'Catch React component errors: class ErrorBoundary extends React.Component { componentDidCatch(error, info) { logError(error, info); } render() { if (hasError) return <Fallback />; return children; }}. Wrap at route level. Cannot catch: async errors, event handlers, SSR.',
+                    tags: ['react', 'error-handling', 'pattern', 'frontend'],
+                    importance: 4
+                },
+                {
+                    id: 'db-migration-safety',
+                    title: 'Safe Database Migration Checklist',
+                    body: 'Safe migrations: Always backup first, Test rollback, Make backwards compatible, Separate schema vs data migrations, Add indexes CONCURRENTLY, Avoid NOT NULL without default, Use transactions, Monitor during deploy, Have recovery plan',
+                    tags: ['database', 'migration', 'safety', 'checklist'],
+                    importance: 5
+                }
+            ];
+            const stmt = this.db.prepare(`
+        INSERT INTO concepts (id, title, body, tags, importance, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `);
+            const now = Date.now();
+            for (const concept of initialConcepts) {
+                stmt.run(concept.id, concept.title, concept.body, JSON.stringify(concept.tags), concept.importance, now, now);
+            }
+            logger.info(`Seeded ${initialConcepts.length} initial concepts`);
+        }
+    }
+    search(params) {
+        const k = params.k || 10;
+        // Handle special queries
+        const searchQuery = this.normalizeSearchQuery(params.q);
+        // Use different query based on whether we have a search term
+        let query;
+        let queryParams;
+        if (searchQuery === '*' || !searchQuery.trim()) {
+            // Return all concepts when wildcard or empty query
+            query = `
+        SELECT
+          c.*,
+          1.0 as fts_score,
+          '' as snippet
+        FROM concepts c
+      `;
+            queryParams = [];
+        }
+        else {
+            // Normal FTS search
+            query = `
+        SELECT
+          c.*,
+          bm25(concept_fts) as fts_score,
+          snippet(concept_fts, 0, '[', ']', '...', 32) as snippet
+        FROM concepts c
+        JOIN concept_fts ON c.rowid = concept_fts.rowid
+        WHERE concept_fts MATCH ?
+      `;
+            queryParams = [searchQuery];
+        }
+        // Apply allowlist filter if project specified
+        if (params.projectId) {
+            if (searchQuery === '*') {
+                query += ` WHERE c.id IN (
+          SELECT concept_id FROM project_allowlists WHERE project_id = ?
+        )`;
+            }
+            else {
+                query += ` AND c.id IN (
+          SELECT concept_id FROM project_allowlists WHERE project_id = ?
+        )`;
+            }
+            queryParams.push(params.projectId);
+        }
+        else if (params.allowlist && params.allowlist.length > 0) {
+            if (searchQuery === '*') {
+                query += ` WHERE c.id IN (${params.allowlist.map(() => '?').join(',')})`;
+            }
+            else {
+                query += ` AND c.id IN (${params.allowlist.map(() => '?').join(',')})`;
+            }
+            queryParams.push(...params.allowlist);
+        }
+        // Add appropriate ordering and limit
+        if (searchQuery === '*') {
+            query += ' ORDER BY c.importance DESC, c.created_at DESC LIMIT ?';
+        }
+        else {
+            query += ' ORDER BY fts_score DESC, c.importance DESC LIMIT ?';
+        }
+        queryParams.push(k);
+        const stmt = this.db.prepare(query);
+        const results = stmt.all(...queryParams);
+        return results.map(row => ({
+            concept: this.rowToConcept(row),
+            score: -row.fts_score,
+            snippet: row.snippet
+        }));
+    }
+    get(id) {
+        const stmt = this.db.prepare('SELECT * FROM concepts WHERE id = ?');
+        const row = stmt.get(id);
+        return row ? this.rowToConcept(row) : null;
+    }
+    save(params) {
+        const now = Date.now();
+        const id = params.id || this.generateConceptId(params.title);
+        // Check body length constraint (600-900 chars recommended)
+        if (params.body.length > 1200) {
+            logger.warn(`Concept body exceeds recommended length: ${params.body.length} chars`);
+        }
+        const existing = this.get(id);
+        if (existing) {
+            // Update existing
+            const stmt = this.db.prepare(`
+        UPDATE concepts
+        SET title = ?, body = ?, tags = ?, importance = ?, updated_at = ?
+        WHERE id = ?
+      `);
+            stmt.run(params.title, params.body, JSON.stringify(params.tags || []), params.importance || existing.importance, now, id);
+        }
+        else {
+            // Insert new
+            const stmt = this.db.prepare(`
+        INSERT INTO concepts (id, title, body, tags, importance, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `);
+            stmt.run(id, params.title, params.body, JSON.stringify(params.tags || []), params.importance || 3, now, now);
+        }
+        logger.info(`Concept saved: ${id} - ${params.title}`);
+        return { id };
+    }
+    updateAllowlist(params) {
+        const result = {};
+        if (params.add && params.add.length > 0) {
+            const stmt = this.db.prepare(`
+        INSERT OR IGNORE INTO project_allowlists (project_id, concept_id, added_at)
+        VALUES (?, ?, ?)
+      `);
+            const now = Date.now();
+            const added = [];
+            for (const conceptId of params.add) {
+                // Verify concept exists
+                if (this.get(conceptId)) {
+                    const res = stmt.run(params.projectId, conceptId, now);
+                    if (res.changes > 0) {
+                        added.push(conceptId);
+                    }
+                }
+            }
+            result.added = added;
+        }
+        if (params.remove && params.remove.length > 0) {
+            const stmt = this.db.prepare(`
+        DELETE FROM project_allowlists
+        WHERE project_id = ? AND concept_id = ?
+      `);
+            const removed = [];
+            for (const conceptId of params.remove) {
+                const res = stmt.run(params.projectId, conceptId);
+                if (res.changes > 0) {
+                    removed.push(conceptId);
+                }
+            }
+            result.removed = removed;
+        }
+        if (params.list) {
+            const stmt = this.db.prepare(`
+        SELECT concept_id FROM project_allowlists
+        WHERE project_id = ?
+        ORDER BY added_at DESC
+      `);
+            const rows = stmt.all(params.projectId);
+            result.allowlist = rows.map(r => r.concept_id);
+        }
+        return result;
+    }
+    linkToProject(conceptId, projectId) {
+        const concept = this.get(conceptId);
+        if (!concept) {
+            throw new Error(`Concept not found: ${conceptId}`);
+        }
+        // This would call the project's memory.save with the concept data
+        // For now, we'll return a placeholder
+        const memoryId = `mem_linked_${conceptId}_${Date.now()}`;
+        logger.info(`Linked concept ${conceptId} to project ${projectId} as ${memoryId}`);
+        return { memoryId };
+    }
+    generateConceptId(title) {
+        // Generate readable ID from title
+        const base = title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .substring(0, 30);
+        return `${base}-v${Date.now() % 1000}`;
+    }
+    normalizeSearchQuery(query) {
+        // Handle empty or whitespace-only queries
+        if (!query || !query.trim()) {
+            return '*';
+        }
+        // Handle wildcard queries
+        if (query.trim() === '*' || query.trim() === '**') {
+            return '*';
+        }
+        // Escape FTS5 special characters and return
+        return this.escapeQuery(query.trim());
+    }
+    escapeQuery(query) {
+        return query.replace(/["]/g, '""');
+    }
+    rowToConcept(row) {
+        return {
+            id: row.id,
+            title: row.title,
+            body: row.body,
+            tags: JSON.parse(row.tags),
+            importance: row.importance,
+            created_at: row.created_at,
+            updated_at: row.updated_at
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=concept-store.js.map

package/dist/memory-server/concept-store.js.map

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

package/dist/memory-server/context-broker.d.ts

@@ -0,0 +1,63 @@
+export interface ContextInjection {
+    id: string;
+    type: 'memory' | 'concept';
+    summary: string;
+    content: string;
+    score: number;
+    source: string;
+    byteSize: number;
+}
+export interface ContextPreview {
+    injections: ContextInjection[];
+    budgetUsed: number;
+    budgetLimit: number;
+    topK: number;
+    stats: {
+        projectMatches: number;
+        pathMatches: number;
+        conceptMatches: number;
+        totalCandidates: number;
+    };
+}
+export declare class ContextBroker {
+    private memoryDb;
+    private conceptStore;
+    private projectId;
+    private projectRoot;
+    constructor(projectRoot: string, projectId: string);
+    preview(params: {
+        open_files?: string[];
+        task: string;
+        budget_bytes?: number;
+        top_k?: number;
+        mode?: 'hard' | 'soft' | 'smart';
+    }): Promise<ContextPreview>;
+    private scoreMemories;
+    private scoreConcepts;
+    private selectByBudget;
+    private inferPathPrefixes;
+    private pathMatchStrength;
+    private hasPathMatch;
+    /**
+     * Extract meaningful search terms from a task description
+     * This improves FTS search by focusing on key terms
+     */
+    private extractSearchTerms;
+    private taskMatchStrength;
+    private recencyScore;
+    private formatMemoryForInjection;
+    private formatConceptForInjection;
+    private normalizeForDedupe;
+    private getProjectAllowlist;
+    private contextRules;
+    getRules(): {
+        maxMemoryAge: number;
+        minImportance: number;
+        pathBoostMultiplier: number;
+        conceptImportanceThreshold: number;
+        dedupeThreshold: number;
+    };
+    setRules(rules: Partial<typeof this.contextRules>): void;
+    close(): void;
+}
+//# sourceMappingURL=context-broker.d.ts.map

package/dist/memory-server/context-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-broker.d.ts","sourceRoot":"","sources":["../../src/memory-server/context-broker.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAO5C,OAAO,CAAC,MAAM,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;KAClC,GAAG,OAAO,CAAC,cAAc,CAAC;IA+E3B,OAAO,CAAC,aAAa;IAqErB,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,kBAAkB;YAQZ,mBAAmB;IAcjC,OAAO,CAAC,YAAY,CAMlB;IAEF,QAAQ;;;;;;;IAIR,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC;IAKjD,KAAK;CAGN"}