ghagga-core 2.1.0 → 2.2.0

package/dist/index.d.ts

@@ -17,5 +17,6 @@ export type { FallbackProvider, FallbackOptions, FallbackResult } from './provid
 export { formatMemoryContext } from './memory/context.js';
 export { stripPrivateData } from './memory/privacy.js';
 export { SqliteMemoryStorage } from './memory/sqlite.js';
+export { EngramMemoryStorage } from './memory/engram.js';
 export { formatReviewComment, STATUS_EMOJI, SEVERITY_EMOJI } from './format.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI/C,YAAY,EAEV,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAGX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EAGb,oBAAoB,EACpB,UAAU,EACV,UAAU,EAGV,kBAAkB,EAClB,eAAe,EACf,aAAa,EAGb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,uBAAuB,EAGvB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI/C,YAAY,EAEV,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAGX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EAGb,oBAAoB,EACpB,UAAU,EACV,UAAU,EAGV,kBAAkB,EAClB,eAAe,EACf,aAAa,EAGb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,uBAAuB,EAGvB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIjF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -19,6 +19,7 @@ export { generateWithFallback } from './providers/fallback.js';
 export { formatMemoryContext } from './memory/context.js';
 export { stripPrivateData } from './memory/privacy.js';
 export { SqliteMemoryStorage } from './memory/sqlite.js';
+export { EngramMemoryStorage } from './memory/engram.js';
 // ─── Formatting ─────────────────────────────────────────────────
 export { formatReviewComment, STATUS_EMOJI, SEVERITY_EMOJI } from './format.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA+C/C,mEAAmE;AAEnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,mEAAmE;AAEnE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,mEAAmE;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,mEAAmE;AAEnE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA+C/C,mEAAmE;AAEnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,mEAAmE;AAEnE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,mEAAmE;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,mEAAmE;AAEnE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/engram-client.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Thin HTTP client wrapping native fetch() for the Engram REST API.
+ *
+ * Uses Node 18+ built-in fetch — no external dependencies.
+ * All methods are wrapped in try/catch and return safe fallback values
+ * (null, false, []) on failure. Errors are logged via console.warn
+ * for graceful degradation — the review never fails because of Engram.
+ */
+import type { EngramConfig, EngramObservation, EngramStats } from './engram-types.js';
+export declare class EngramClient {
+    private baseUrl;
+    private timeout;
+    constructor(config: EngramConfig);
+    /** Health check: GET /api/stats. Returns true if Engram is reachable. */
+    healthCheck(): Promise<boolean>;
+    /** Search observations. GET /api/search?q=...&project=...&limit=... */
+    search(query: string, project?: string, limit?: number): Promise<EngramObservation[]>;
+    /** Save an observation. POST /api/save */
+    save(data: {
+        type: string;
+        title: string;
+        content: string;
+        project?: string;
+        topic_key?: string;
+        scope?: string;
+    }): Promise<EngramObservation | null>;
+    /** Get a single observation by ID. GET /api/observations/:id */
+    getObservation(id: string | number): Promise<EngramObservation | null>;
+    /** Delete an observation by ID. DELETE /api/observations/:id */
+    deleteObservation(id: string | number): Promise<boolean>;
+    /** Get aggregate stats. GET /api/stats */
+    getStats(): Promise<EngramStats | null>;
+    /** Create a new session. POST /api/sessions */
+    createSession(project: string): Promise<number | null>;
+    /** End a session with a summary. POST /api/sessions/:id/summary */
+    endSession(id: number, summary: string): Promise<void>;
+}
+//# sourceMappingURL=engram-client.d.ts.map

package/dist/memory/engram-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-client.d.ts","sourceRoot":"","sources":["../../src/memory/engram-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtF,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAQhC,yEAAyE;IACnE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC,uEAAuE;IACjE,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA2B/B,0CAA0C;IACpC,IAAI,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAkBrC,gEAAgE;IAC1D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAe5E,gEAAgE;IAC1D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc9D,0CAA0C;IACpC,QAAQ,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAe7C,+CAA+C;IACzC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB5D,mEAAmE;IAC7D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7D"}

package/dist/memory/engram-client.js

@@ -0,0 +1,153 @@
+/**
+ * Thin HTTP client wrapping native fetch() for the Engram REST API.
+ *
+ * Uses Node 18+ built-in fetch — no external dependencies.
+ * All methods are wrapped in try/catch and return safe fallback values
+ * (null, false, []) on failure. Errors are logged via console.warn
+ * for graceful degradation — the review never fails because of Engram.
+ */
+export class EngramClient {
+    baseUrl;
+    timeout;
+    constructor(config) {
+        // Strip trailing slash for consistent URL construction
+        this.baseUrl = config.host.replace(/\/+$/, '');
+        this.timeout = config.timeout;
+    }
+    // ─── Public API ─────────────────────────────────────────────────
+    /** Health check: GET /api/stats. Returns true if Engram is reachable. */
+    async healthCheck() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/stats`, {
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Search observations. GET /api/search?q=...&project=...&limit=... */
+    async search(query, project, limit) {
+        try {
+            const params = new URLSearchParams({ q: query });
+            if (project)
+                params.set('project', project);
+            if (limit != null)
+                params.set('limit', String(limit));
+            const response = await fetch(`${this.baseUrl}/api/search?${params}`, {
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok)
+                return [];
+            const data = await response.json();
+            // Handle both array response and { observations: [...] } envelope
+            if (Array.isArray(data))
+                return data;
+            if (data != null && typeof data === 'object' && 'observations' in data && Array.isArray(data.observations)) {
+                return data.observations;
+            }
+            return [];
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] search failed:', error.message);
+            return [];
+        }
+    }
+    /** Save an observation. POST /api/save */
+    async save(data) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/save`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(data),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] save failed:', error.message);
+            return null;
+        }
+    }
+    /** Get a single observation by ID. GET /api/observations/:id */
+    async getObservation(id) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/observations/${id}`, {
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] getObservation failed:', error.message);
+            return null;
+        }
+    }
+    /** Delete an observation by ID. DELETE /api/observations/:id */
+    async deleteObservation(id) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/observations/${id}`, {
+                method: 'DELETE',
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            return response.ok;
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] deleteObservation failed:', error.message);
+            return false;
+        }
+    }
+    /** Get aggregate stats. GET /api/stats */
+    async getStats() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/stats`, {
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] getStats failed:', error.message);
+            return null;
+        }
+    }
+    /** Create a new session. POST /api/sessions */
+    async createSession(project) {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/sessions`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ project }),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok)
+                return null;
+            const data = (await response.json());
+            return data.id ?? null;
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] createSession failed:', error.message);
+            return null;
+        }
+    }
+    /** End a session with a summary. POST /api/sessions/:id/summary */
+    async endSession(id, summary) {
+        try {
+            await fetch(`${this.baseUrl}/api/sessions/${id}/summary`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ summary }),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+        }
+        catch (error) {
+            console.warn('[ghagga:engram] endSession failed:', error.message);
+        }
+    }
+}
+//# sourceMappingURL=engram-client.js.map

package/dist/memory/engram-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-client.js","sourceRoot":"","sources":["../../src/memory/engram-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAO,YAAY;IACf,OAAO,CAAS;IAChB,OAAO,CAAS;IAExB,YAAY,MAAoB;QAC9B,uDAAuD;QACvD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,mEAAmE;IAEnE,yEAAyE;IACzE,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE;gBACxD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAgB,EAChB,KAAc;QAEd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,OAAO;gBAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,MAAM,EAAE,EAAE;gBACnE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YAE5B,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE5C,kEAAkE;YAClE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAA2B,CAAC;YAC5D,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAgC,CAAC,YAAY,CAAC,EAAE,CAAC;gBACxI,OAAQ,IAAgC,CAAC,YAAmC,CAAC;YAC/E,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,IAAI,CAAC,IAOV;QACC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,WAAW,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,cAAc,CAAC,EAAmB;QACtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE,EAAE,EAAE;gBACrE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,iBAAiB,CAAC,EAAmB;QACzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE,EAAE,EAAE;gBACrE,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YACpF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE;gBACxD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE;gBAC3D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAE9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;YACxD,OAAO,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAChF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,OAAe;QAC1C,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAAE,UAAU,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF"}

package/dist/memory/engram-mapping.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Schema mapping between GHAGGA observation types and Engram API shapes.
+ *
+ * GHAGGA stores severity, filePaths, and a source marker as structured
+ * text within Engram's `content` field:
+ *
+ *   [severity:high]
+ *   <actual content>
+ *   ---
+ *   Files: path/a.ts, path/b.ts
+ *   ---
+ *   Source: ghagga
+ *
+ * On read, the mapping functions parse this structure back out.
+ * If the content doesn't match (e.g., an observation created by another tool),
+ * sensible defaults are used.
+ */
+import type { MemoryObservationRow, MemoryObservationDetail } from '../types.js';
+import type { EngramObservation } from './engram-types.js';
+export interface EngramSavePayload {
+    type: string;
+    title: string;
+    content: string;
+    project?: string;
+    topic_key?: string;
+    scope?: string;
+}
+/**
+ * Encode GHAGGA-specific fields into a single Engram `content` string.
+ *
+ * - Prepends `[severity:xxx]` if severity is provided
+ * - Appends `\n---\nFiles: path1, path2` if filePaths are provided
+ * - Always appends `\n---\nSource: ghagga` as a footer
+ */
+export declare function toEngramContent(data: {
+    content: string;
+    severity?: string | null;
+    filePaths?: string[] | null;
+}): string;
+/**
+ * Parse GHAGGA-structured content back into its component fields.
+ *
+ * Extracts `[severity:xxx]` from the first line, `Files: ...` from the
+ * footer section, and returns the clean content without metadata.
+ *
+ * If the content doesn't match the expected structure, returns it
+ * as-is with null severity and filePaths.
+ */
+export declare function fromEngramContent(content: string): {
+    content: string;
+    severity: string | null;
+    filePaths: string[] | null;
+};
+/**
+ * Map an Engram observation to GHAGGA's MemoryObservationRow.
+ *
+ * Uses `fromEngramContent()` to extract severity/filePaths from the
+ * content field. The Engram ID (string | number) is converted to a
+ * stable numeric ID via parseInt or a simple hash.
+ */
+export declare function toMemoryObservationRow(obs: EngramObservation): MemoryObservationRow;
+/**
+ * Map an Engram observation to GHAGGA's MemoryObservationDetail.
+ *
+ * Full mapping including metadata fields (project, topicKey, timestamps, etc.).
+ */
+export declare function toMemoryObservationDetail(obs: EngramObservation): MemoryObservationDetail;
+/**
+ * Map GHAGGA save data to the Engram save request payload.
+ *
+ * Uses `toEngramContent()` to embed severity/filePaths in the content field.
+ */
+export declare function toEngramSaveData(data: {
+    sessionId?: number;
+    project: string;
+    type: string;
+    title: string;
+    content: string;
+    topicKey?: string;
+    filePaths?: string[];
+    severity?: string;
+}): EngramSavePayload;
+//# sourceMappingURL=engram-mapping.d.ts.map

package/dist/memory/engram-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-mapping.d.ts","sourceRoot":"","sources":["../../src/memory/engram-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC7B,GAAG,MAAM,CAkBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5B,CAiCA;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,oBAAoB,CAWnF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,GAAG,uBAAuB,CAgBzF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,iBAAiB,CAYpB"}

package/dist/memory/engram-mapping.js

@@ -0,0 +1,159 @@
+/**
+ * Schema mapping between GHAGGA observation types and Engram API shapes.
+ *
+ * GHAGGA stores severity, filePaths, and a source marker as structured
+ * text within Engram's `content` field:
+ *
+ *   [severity:high]
+ *   <actual content>
+ *   ---
+ *   Files: path/a.ts, path/b.ts
+ *   ---
+ *   Source: ghagga
+ *
+ * On read, the mapping functions parse this structure back out.
+ * If the content doesn't match (e.g., an observation created by another tool),
+ * sensible defaults are used.
+ */
+// ─── GHAGGA → Engram ────────────────────────────────────────────
+/**
+ * Encode GHAGGA-specific fields into a single Engram `content` string.
+ *
+ * - Prepends `[severity:xxx]` if severity is provided
+ * - Appends `\n---\nFiles: path1, path2` if filePaths are provided
+ * - Always appends `\n---\nSource: ghagga` as a footer
+ */
+export function toEngramContent(data) {
+    const parts = [];
+    if (data.severity) {
+        parts.push(`[severity:${data.severity}]`);
+    }
+    parts.push(data.content);
+    if (data.filePaths && data.filePaths.length > 0) {
+        parts.push('---');
+        parts.push(`Files: ${data.filePaths.join(', ')}`);
+    }
+    parts.push('---');
+    parts.push('Source: ghagga');
+    return parts.join('\n');
+}
+/**
+ * Parse GHAGGA-structured content back into its component fields.
+ *
+ * Extracts `[severity:xxx]` from the first line, `Files: ...` from the
+ * footer section, and returns the clean content without metadata.
+ *
+ * If the content doesn't match the expected structure, returns it
+ * as-is with null severity and filePaths.
+ */
+export function fromEngramContent(content) {
+    let severity = null;
+    let filePaths = null;
+    let body = content;
+    // Extract [severity:xxx] from the first line
+    const severityMatch = body.match(/^\[severity:(\w+)\]\n?/);
+    if (severityMatch) {
+        severity = severityMatch[1];
+        body = body.slice(severityMatch[0].length);
+    }
+    // Extract footer sections (delimited by ---) from the end
+    // Look for "Source: ghagga" footer to confirm this is GHAGGA-structured
+    const sourceFooterIdx = body.lastIndexOf('\n---\nSource: ghagga');
+    if (sourceFooterIdx !== -1) {
+        const beforeSource = body.slice(0, sourceFooterIdx);
+        // Look for "Files: ..." section before the Source footer
+        const filesFooterIdx = beforeSource.lastIndexOf('\n---\nFiles: ');
+        if (filesFooterIdx !== -1) {
+            const filesLine = beforeSource.slice(filesFooterIdx + '\n---\nFiles: '.length);
+            filePaths = filesLine
+                .split(',')
+                .map((f) => f.trim())
+                .filter((f) => f.length > 0);
+            body = beforeSource.slice(0, filesFooterIdx);
+        }
+        else {
+            body = beforeSource;
+        }
+    }
+    return { content: body, severity, filePaths };
+}
+// ─── Engram → GHAGGA ────────────────────────────────────────────
+/**
+ * Map an Engram observation to GHAGGA's MemoryObservationRow.
+ *
+ * Uses `fromEngramContent()` to extract severity/filePaths from the
+ * content field. The Engram ID (string | number) is converted to a
+ * stable numeric ID via parseInt or a simple hash.
+ */
+export function toMemoryObservationRow(obs) {
+    const parsed = fromEngramContent(obs.content);
+    return {
+        id: toNumericId(obs.id),
+        type: obs.type ?? 'observation',
+        title: obs.title ?? '',
+        content: parsed.content,
+        filePaths: parsed.filePaths,
+        severity: parsed.severity,
+    };
+}
+/**
+ * Map an Engram observation to GHAGGA's MemoryObservationDetail.
+ *
+ * Full mapping including metadata fields (project, topicKey, timestamps, etc.).
+ */
+export function toMemoryObservationDetail(obs) {
+    const parsed = fromEngramContent(obs.content);
+    return {
+        id: toNumericId(obs.id),
+        type: obs.type ?? 'observation',
+        title: obs.title ?? '',
+        content: parsed.content,
+        filePaths: parsed.filePaths,
+        severity: parsed.severity,
+        project: obs.project ?? '',
+        topicKey: obs.topic_key ?? null,
+        revisionCount: obs.revision_count ?? 1,
+        createdAt: obs.created_at ?? new Date().toISOString(),
+        updatedAt: obs.updated_at ?? obs.created_at ?? new Date().toISOString(),
+    };
+}
+/**
+ * Map GHAGGA save data to the Engram save request payload.
+ *
+ * Uses `toEngramContent()` to embed severity/filePaths in the content field.
+ */
+export function toEngramSaveData(data) {
+    return {
+        type: data.type,
+        title: data.title,
+        content: toEngramContent({
+            content: data.content,
+            severity: data.severity,
+            filePaths: data.filePaths,
+        }),
+        project: data.project,
+        topic_key: data.topicKey,
+    };
+}
+// ─── Helpers ────────────────────────────────────────────────────
+/**
+ * Convert an Engram ID (string or number) to a stable numeric ID.
+ *
+ * - If the ID is already a number, return it directly.
+ * - If the ID is a numeric string, parse it.
+ * - Otherwise, hash the string to a positive 32-bit integer.
+ */
+function toNumericId(id) {
+    if (typeof id === 'number')
+        return id;
+    const parsed = parseInt(id, 10);
+    if (!isNaN(parsed))
+        return parsed;
+    // Simple hash for UUID/string IDs → positive 32-bit integer
+    let hash = 0;
+    for (let i = 0; i < id.length; i++) {
+        hash = ((hash << 5) - hash + id.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash);
+}
+//# sourceMappingURL=engram-mapping.js.map

package/dist/memory/engram-mapping.js.map

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

package/dist/memory/engram-types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Engram adapter types.
+ *
+ * Defines configuration and API response shapes for the Engram REST API.
+ * These types are internal to the Engram adapter — not exported from @ghagga/core.
+ */
+/** Configuration for connecting to an Engram server. */
+export interface EngramConfig {
+    /** Engram server base URL (default: 'http://localhost:7437') */
+    host: string;
+    /** HTTP request timeout in milliseconds (default: 5000) */
+    timeout: number;
+}
+/** Default Engram configuration values. */
+export declare const ENGRAM_DEFAULTS: EngramConfig;
+/** Shape of an observation returned by Engram's REST API. */
+export interface EngramObservation {
+    id: string | number;
+    type: string;
+    title: string;
+    content: string;
+    project?: string;
+    topic_key?: string;
+    revision_count?: number;
+    created_at?: string;
+    updated_at?: string;
+    deleted_at?: string | null;
+    duplicate_count?: number;
+    last_seen_at?: string;
+    scope?: string;
+}
+/** Shape of Engram's session response. */
+export interface EngramSession {
+    id: number;
+    project: string;
+    started_at?: string;
+    ended_at?: string | null;
+    summary?: string | null;
+}
+/** Shape of Engram's GET /api/stats response. */
+export interface EngramStats {
+    total_observations: number;
+    total_sessions: number;
+    projects?: string[];
+}
+/** Shape of Engram's search response. */
+export interface EngramSearchResult {
+    observations: EngramObservation[];
+    total?: number;
+}
+//# sourceMappingURL=engram-types.d.ts.map

package/dist/memory/engram-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-types.d.ts","sourceRoot":"","sources":["../../src/memory/engram-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IAEb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,eAAO,MAAM,eAAe,EAAE,YAG7B,CAAC;AAIF,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/memory/engram-types.js

@@ -0,0 +1,12 @@
+/**
+ * Engram adapter types.
+ *
+ * Defines configuration and API response shapes for the Engram REST API.
+ * These types are internal to the Engram adapter — not exported from @ghagga/core.
+ */
+/** Default Engram configuration values. */
+export const ENGRAM_DEFAULTS = {
+    host: 'http://localhost:7437',
+    timeout: 5000,
+};
+//# sourceMappingURL=engram-types.js.map

package/dist/memory/engram-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram-types.js","sourceRoot":"","sources":["../../src/memory/engram-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,IAAI;CACd,CAAC"}

package/dist/memory/engram.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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 type { MemoryStorage, MemoryObservationRow, MemoryObservationDetail, MemoryStats, ListObservationsOptions } from '../types.js';
+import type { EngramConfig } from './engram-types.js';
+export declare class EngramMemoryStorage implements MemoryStorage {
+    private 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.
+     */
+    private idMap;
+    private nextId;
+    private constructor();
+    /**
+     * 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 create(config?: Partial<EngramConfig>): Promise<EngramMemoryStorage | null>;
+    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>;
+    /** No-op — HTTP connections don't need explicit cleanup. */
+    close(): Promise<void>;
+    listObservations(options?: ListObservationsOptions): Promise<MemoryObservationDetail[]>;
+    getObservation(id: number): Promise<MemoryObservationDetail | null>;
+    deleteObservation(id: number): Promise<boolean>;
+    getStats(): Promise<MemoryStats>;
+    /**
+     * Not supported by the Engram HTTP API.
+     * Use the `engram` CLI directly for bulk operations.
+     */
+    clearObservations(_options?: {
+        project?: string;
+    }): Promise<number>;
+    /**
+     * Track the mapping between a GHAGGA numeric ID and the original Engram ID.
+     * This allows getObservation() and deleteObservation() to resolve the real ID.
+     */
+    private trackId;
+}
+//# sourceMappingURL=engram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engram.d.ts","sourceRoot":"","sources":["../../src/memory/engram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,MAAM,CAAe;IAE7B;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO;IAMP;;;;;;;;;OASG;WACU,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAsBlF,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;IAmB5B,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;IAwB3B,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;IAWrB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAyB3F,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAkBnE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB/C,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IA8BtC;;;OAGG;IACG,iBAAiB,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE;;;OAGG;IACH,OAAO,CAAC,OAAO;CAKhB"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghagga-core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "private": false,
   "type": "module",
   "description": "Core review engine for GHAGGA — AI-powered multi-agent code reviewer",