ghagga-core 2.0.1 → 2.2.0

package/dist/memory/engram.js

@@ -0,0 +1,194 @@
+/**
+ * Engram-backed memory storage.
+ *
+ * Implements the MemoryStorage interface by mapping each method to HTTP
+ * calls against Engram's REST API (localhost:7437). Uses native fetch()
+ * with no external dependencies.
+ *
+ * Graceful degradation: the async factory performs a health check. If
+ * Engram is unreachable it returns null so the caller can fall back to
+ * SQLite. During operation, individual method calls catch HTTP errors
+ * and return safe defaults — the review never fails because of Engram.
+ */
+import { EngramClient } from './engram-client.js';
+import { toMemoryObservationRow, toMemoryObservationDetail, toEngramSaveData, } from './engram-mapping.js';
+export class EngramMemoryStorage {
+    client;
+    /**
+     * Maps GHAGGA numeric IDs → Engram original IDs (string | number).
+     * Populated by searchObservations(), listObservations(), and saveObservation().
+     * Used by getObservation() and deleteObservation() to resolve the real Engram ID.
+     */
+    idMap = new Map();
+    nextId = 1;
+    constructor(client) {
+        this.client = client;
+    }
+    // ─── Factory ────────────────────────────────────────────────────
+    /**
+     * Async factory — creates an instance after verifying Engram is reachable.
+     *
+     * Config resolution order:
+     *   1. Explicit `config` parameter
+     *   2. Environment variables (GHAGGA_ENGRAM_HOST, GHAGGA_ENGRAM_TIMEOUT)
+     *   3. Defaults (http://localhost:7437, 5000ms)
+     *
+     * Returns null if Engram is not reachable (caller should fall back to SQLite).
+     */
+    static async create(config) {
+        const fullConfig = {
+            host: config?.host ?? process.env.GHAGGA_ENGRAM_HOST ?? 'http://localhost:7437',
+            timeout: config?.timeout ?? Number(process.env.GHAGGA_ENGRAM_TIMEOUT ?? '5') * 1000,
+        };
+        const client = new EngramClient(fullConfig);
+        const healthy = await client.healthCheck();
+        if (!healthy) {
+            console.warn('[ghagga:engram] Engram server not reachable at %s — falling back to SQLite', fullConfig.host);
+            return null;
+        }
+        return new EngramMemoryStorage(client);
+    }
+    // ─── Hot-path methods ───────────────────────────────────────────
+    async searchObservations(project, query, options = {}) {
+        const { limit = 10, type } = options;
+        const results = await this.client.search(query, project, limit);
+        let mapped = results.map((obs) => {
+            const row = toMemoryObservationRow(obs);
+            this.trackId(row.id, obs.id);
+            return row;
+        });
+        // Client-side type filter (Engram may not support it natively)
+        if (type) {
+            mapped = mapped.filter((r) => r.type === type);
+        }
+        return mapped;
+    }
+    async saveObservation(data) {
+        const payload = toEngramSaveData(data);
+        const result = await this.client.save(payload);
+        if (!result) {
+            // Graceful degradation: return a synthetic row so the pipeline continues
+            console.warn('[ghagga:engram] saveObservation: Engram save failed, returning synthetic row');
+            return {
+                id: -1,
+                type: data.type,
+                title: data.title,
+                content: data.content,
+                filePaths: data.filePaths ?? null,
+                severity: data.severity ?? null,
+            };
+        }
+        const row = toMemoryObservationRow(result);
+        this.trackId(row.id, result.id);
+        return row;
+    }
+    // ─── Session methods ────────────────────────────────────────────
+    async createSession(data) {
+        const sessionId = await this.client.createSession(data.project);
+        if (sessionId == null) {
+            console.warn('[ghagga:engram] createSession failed, returning synthetic id');
+            return { id: -1 };
+        }
+        return { id: sessionId };
+    }
+    async endSession(sessionId, summary) {
+        // Skip if session was never properly created
+        if (sessionId === -1)
+            return;
+        await this.client.endSession(sessionId, summary);
+    }
+    /** No-op — HTTP connections don't need explicit cleanup. */
+    async close() {
+        // Nothing to clean up for HTTP-based storage
+    }
+    // ─── Management methods ─────────────────────────────────────────
+    async listObservations(options = {}) {
+        const { project, type, limit = 20 } = options;
+        // Use search with empty query to list all observations
+        const results = await this.client.search('', project, limit);
+        let mapped = results.map((obs) => {
+            const detail = toMemoryObservationDetail(obs);
+            this.trackId(detail.id, obs.id);
+            return detail;
+        });
+        // Client-side type filter
+        if (type) {
+            mapped = mapped.filter((r) => r.type === type);
+        }
+        // Client-side offset (Engram may not support it natively)
+        if (options.offset && options.offset > 0) {
+            mapped = mapped.slice(options.offset);
+        }
+        return mapped;
+    }
+    async getObservation(id) {
+        const realId = this.idMap.get(id);
+        if (realId == null) {
+            console.warn('[ghagga:engram] getObservation: ID %d not found in local map. ' +
+                'Run searchObservations or listObservations first.', id);
+            return null;
+        }
+        const obs = await this.client.getObservation(realId);
+        if (!obs)
+            return null;
+        return toMemoryObservationDetail(obs);
+    }
+    async deleteObservation(id) {
+        const realId = this.idMap.get(id);
+        if (realId == null) {
+            console.warn('[ghagga:engram] deleteObservation: ID %d not found in local map.', id);
+            return false;
+        }
+        const deleted = await this.client.deleteObservation(realId);
+        if (deleted) {
+            this.idMap.delete(id);
+        }
+        return deleted;
+    }
+    async getStats() {
+        const stats = await this.client.getStats();
+        if (!stats) {
+            return {
+                totalObservations: 0,
+                byType: {},
+                byProject: {},
+                oldestObservation: null,
+                newestObservation: null,
+            };
+        }
+        // Map Engram stats to GHAGGA's MemoryStats shape
+        const byProject = {};
+        if (stats.projects) {
+            for (const p of stats.projects) {
+                byProject[p] = 0; // Engram doesn't provide per-project counts in stats
+            }
+        }
+        return {
+            totalObservations: stats.total_observations,
+            byType: {}, // Engram stats endpoint doesn't break down by type
+            byProject,
+            oldestObservation: null, // Not provided by Engram stats
+            newestObservation: null, // Not provided by Engram stats
+        };
+    }
+    /**
+     * Not supported by the Engram HTTP API.
+     * Use the `engram` CLI directly for bulk operations.
+     */
+    async clearObservations(_options) {
+        console.warn('[ghagga:engram] clearObservations is not supported with the Engram backend. ' +
+            'Use the "engram" CLI directly for bulk deletion.');
+        return 0;
+    }
+    // ─── Internal helpers ───────────────────────────────────────────
+    /**
+     * Track the mapping between a GHAGGA numeric ID and the original Engram ID.
+     * This allows getObservation() and deleteObservation() to resolve the real ID.
+     */
+    trackId(numericId, engramId) {
+        if (!this.idMap.has(numericId)) {
+            this.idMap.set(numericId, engramId);
+        }
+    }
+}
+//# sourceMappingURL=engram.js.map

package/dist/memory/engram.js.map

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

package/dist/memory/persist.d.ts

@@ -5,18 +5,18 @@
  * and saves them as memory observations so future reviews of
  * the same project can benefit from past context.
  */
-import type { ReviewResult } from '../types.js';
+import type { MemoryStorage, ReviewResult } from '../types.js';
 /**
  * Persist notable review findings as memory observations.
  *
  * Creates a memory session for the review, extracts significant
- * findings, strips private data, and saves them via ghagga-db.
- * Gracefully handles database errors without propagating them.
+ * findings, strips private data, and saves them via MemoryStorage.
+ * Gracefully handles storage errors without propagating them.
  *
- * @param db - Database instance (typed as unknown for loose coupling)
+ * @param storage - Memory storage backend (SQLite or PostgreSQL)
  * @param project - Project identifier (e.g., "owner/repo")
  * @param prNumber - Pull request number
  * @param result - The completed review result
  */
-export declare function persistReviewObservations(db: unknown, project: string, prNumber: number, result: ReviewResult): Promise<void>;
+export declare function persistReviewObservations(storage: MemoryStorage, project: string, prNumber: number, result: ReviewResult): Promise<void>;
 //# sourceMappingURL=persist.d.ts.map

package/dist/memory/persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/memory/persist.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAoChF;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Df"}
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/memory/persist.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAkC,MAAM,aAAa,CAAC;AAoC/F;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/memory/persist.js

@@ -5,7 +5,6 @@
  * and saves them as memory observations so future reviews of
  * the same project can benefit from past context.
  */
-import { saveObservation, createMemorySession, endMemorySession } from 'ghagga-db';
 import { stripPrivateData } from './privacy.js';
 // ─── Helpers ────────────────────────────────────────────────────
 /**
@@ -34,30 +33,31 @@ function findingToObservationType(finding) {
  * We only save high and critical findings to avoid noise.
  */
 function isSignificantFinding(finding) {
-    return finding.severity === 'critical' || finding.severity === 'high';
+    return finding.severity === 'critical' || finding.severity === 'high' || finding.severity === 'medium';
 }
 // ─── Main Function ──────────────────────────────────────────────
 /**
  * Persist notable review findings as memory observations.
  *
  * Creates a memory session for the review, extracts significant
- * findings, strips private data, and saves them via ghagga-db.
- * Gracefully handles database errors without propagating them.
+ * findings, strips private data, and saves them via MemoryStorage.
+ * Gracefully handles storage errors without propagating them.
  *
- * @param db - Database instance (typed as unknown for loose coupling)
+ * @param storage - Memory storage backend (SQLite or PostgreSQL)
  * @param project - Project identifier (e.g., "owner/repo")
  * @param prNumber - Pull request number
  * @param result - The completed review result
  */
-export async function persistReviewObservations(db, project, prNumber, result) {
+export async function persistReviewObservations(storage, project, prNumber, result) {
     try {
-        if (!db)
+        if (!storage)
             return;
-        const typedDb = db;
-        // Create a memory session for this review
-        const session = await createMemorySession(typedDb, { project, prNumber });
-        // Extract significant findings as observations
+        // Extract significant findings first — skip session if nothing to persist
         const significantFindings = result.findings.filter(isSignificantFinding);
+        if (significantFindings.length === 0)
+            return;
+        // Create a memory session for this review
+        const session = await storage.createSession({ project, prNumber });
         for (const finding of significantFindings) {
             const sanitizedMessage = stripPrivateData(finding.message);
             const sanitizedSuggestion = finding.suggestion
@@ -71,29 +71,28 @@ export async function persistReviewObservations(db, project, prNumber, result) {
             ]
                 .filter(Boolean)
                 .join('\n');
-            await saveObservation(typedDb, {
+            await storage.saveObservation({
                 sessionId: session.id,
                 project,
                 type: findingToObservationType(finding),
                 title: `${finding.category}: ${sanitizedMessage.slice(0, 80)}`,
                 content,
                 filePaths: [finding.file],
+                severity: finding.severity,
             });
         }
         // Save a summary observation for the overall review
-        if (significantFindings.length > 0) {
-            await saveObservation(typedDb, {
-                sessionId: session.id,
-                project,
-                type: 'decision',
-                title: `PR #${prNumber} review: ${result.status}`,
-                content: stripPrivateData(result.summary),
-                topicKey: `pr-${prNumber}-review`,
-                filePaths: significantFindings.map((f) => f.file),
-            });
-        }
+        await storage.saveObservation({
+            sessionId: session.id,
+            project,
+            type: 'decision',
+            title: `PR #${prNumber} review: ${result.status}`,
+            content: stripPrivateData(result.summary),
+            topicKey: `pr-${prNumber}-review`,
+            filePaths: significantFindings.map((f) => f.file),
+        });
         // End the session with a summary
-        await endMemorySession(typedDb, session.id, `Review of PR #${prNumber}: ${result.status} with ${significantFindings.length} significant findings.`);
+        await storage.endSession(session.id, `Review of PR #${prNumber}: ${result.status} with ${significantFindings.length} significant findings.`);
     }
     catch (error) {
         // Memory persistence is optional — never let it break the pipeline

package/dist/memory/persist.js.map

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

package/dist/memory/search.d.ts

@@ -2,19 +2,20 @@
  * Memory search — retrieves relevant past observations for prompt injection.
  *
  * Builds a search query from the file paths in the current diff,
- * then uses PostgreSQL full-text search (via ghagga-db) to find
- * observations from past reviews of the same project.
+ * then uses the MemoryStorage interface to find observations from
+ * past reviews of the same project.
  */
+import type { MemoryStorage } from '../types.js';
 /**
  * Search past review observations for context relevant to the current diff.
  *
  * Returns a formatted string suitable for injection into agent prompts,
- * or null if no relevant observations are found (or if db is unavailable).
+ * or null if no relevant observations are found (or if storage is unavailable).
  *
- * @param db - Database instance (from ghagga-db). Typed as unknown for loose coupling.
+ * @param storage - Memory storage backend (SQLite or PostgreSQL)
  * @param project - Project identifier (e.g., "owner/repo")
  * @param fileList - List of file paths in the current diff
  * @returns Formatted memory context string, or null
  */
-export declare function searchMemoryForContext(db: unknown, project: string, fileList: string[]): Promise<string | null>;
+export declare function searchMemoryForContext(storage: MemoryStorage, project: string, fileList: string[]): Promise<string | null>;
 //# sourceMappingURL=search.d.ts.map

package/dist/memory/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqDH;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwCjD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB"}

package/dist/memory/search.js

@@ -2,10 +2,9 @@
  * Memory search — retrieves relevant past observations for prompt injection.
  *
  * Builds a search query from the file paths in the current diff,
- * then uses PostgreSQL full-text search (via ghagga-db) to find
- * observations from past reviews of the same project.
+ * then uses the MemoryStorage interface to find observations from
+ * past reviews of the same project.
  */
-import { searchObservations } from 'ghagga-db';
 import { formatMemoryContext } from './context.js';
 // ─── Helpers ────────────────────────────────────────────────────
 /**
@@ -42,22 +41,22 @@ function buildSearchQuery(fileList) {
  * Search past review observations for context relevant to the current diff.
  *
  * Returns a formatted string suitable for injection into agent prompts,
- * or null if no relevant observations are found (or if db is unavailable).
+ * or null if no relevant observations are found (or if storage is unavailable).
  *
- * @param db - Database instance (from ghagga-db). Typed as unknown for loose coupling.
+ * @param storage - Memory storage backend (SQLite or PostgreSQL)
  * @param project - Project identifier (e.g., "owner/repo")
  * @param fileList - List of file paths in the current diff
  * @returns Formatted memory context string, or null
  */
-export async function searchMemoryForContext(db, project, fileList) {
+export async function searchMemoryForContext(storage, project, fileList) {
     try {
-        if (!db)
+        if (!storage)
             return null;
         const query = buildSearchQuery(fileList);
         if (!query)
             return null;
         // Search with a reasonable limit — we don't want to flood the prompt
-        const observations = await searchObservations(db, project, query, { limit: 8 });
+        const observations = await storage.searchObservations(project, query, { limit: 3 });
         if (!observations || observations.length === 0)
             return null;
         // Format observations for prompt injection

package/dist/memory/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAYnD,mEAAmE;AAEnE;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAErD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,wCAAwC;YACxC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvF,SAAS;YACX,CAAC;YAED,iDAAiD;YACjD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,mEAAmE;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAW,EACX,OAAe,EACf,QAAkB;IAElB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAErB,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,qEAAqE;QACrE,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,EAA8C,EAC9C,OAAO,EACP,KAAK,EACL,EAAE,KAAK,EAAE,CAAC,EAAE,CACb,CAAC;QAEF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,2CAA2C;QAC3C,OAAO,mBAAmB,CACxB,YAAY,CAAC,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CACV,uDAAuD,EACvD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,mEAAmE;AAEnE;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAErD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,wCAAwC;YACxC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvF,SAAS;YACX,CAAC;YAED,iDAAiD;YACjD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,mEAAmE;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAsB,EACtB,OAAe,EACf,QAAkB;IAElB,IAAI,CAAC;QACH,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,qEAAqE;QACrE,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,kBAAkB,CACnD,OAAO,EACP,KAAK,EACL,EAAE,KAAK,EAAE,CAAC,EAAE,CACb,CAAC;QAEF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,2CAA2C;QAC3C,OAAO,mBAAmB,CACxB,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CACV,uDAAuD,EACvD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/memory/sqlite.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SQLite-backed memory storage using sql.js (pure WASM).
+ *
+ * Thread safety: This class is NOT thread-safe. It operates as an in-memory
+ * database with manual file persistence via close(). Designed for single-process
+ * environments (CLI, GitHub Action).
+ */
+import type { MemoryStorage, MemoryObservationRow, MemoryObservationDetail, MemoryStats, ListObservationsOptions } from '../types.js';
+export declare class SqliteMemoryStorage implements MemoryStorage {
+    private db;
+    private filePath;
+    private constructor();
+    /**
+     * Async factory — handles WASM initialization and file loading.
+     * If filePath exists, loads the existing DB. Otherwise, creates a fresh one.
+     */
+    static create(filePath: string): Promise<SqliteMemoryStorage>;
+    searchObservations(project: string, query: string, options?: {
+        limit?: number;
+        type?: string;
+    }): Promise<MemoryObservationRow[]>;
+    saveObservation(data: {
+        sessionId?: number;
+        project: string;
+        type: string;
+        title: string;
+        content: string;
+        topicKey?: string;
+        filePaths?: string[];
+        severity?: string;
+    }): Promise<MemoryObservationRow>;
+    createSession(data: {
+        project: string;
+        prNumber?: number;
+    }): Promise<{
+        id: number;
+    }>;
+    endSession(sessionId: number, summary: string): Promise<void>;
+    private mapToDetail;
+    listObservations(options?: ListObservationsOptions): Promise<MemoryObservationDetail[]>;
+    getObservation(id: number): Promise<MemoryObservationDetail | null>;
+    deleteObservation(id: number): Promise<boolean>;
+    getStats(): Promise<MemoryStats>;
+    clearObservations(options?: {
+        project?: string;
+    }): Promise<number>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/memory/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/memory/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AA+DtI,qBAAa,mBAAoB,YAAW,aAAa;IAErD,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ;IAFlB,OAAO;IAKP;;;OAGG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuB7D,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9C,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkD5B,eAAe,CAAC,IAAI,EAAE;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0G3B,aAAa,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAUrB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE,OAAO,CAAC,WAAW;IAgBb,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAmC3F,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAmBnE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAmChC,iBAAiB,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAStE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}