@devflow-tools/memory-engine 0.14.4 → 0.16.0

package/dist/migrations/v2-to-v3.js

@@ -0,0 +1,122 @@
+import { createHash } from 'node:crypto';
+function normalizeTitle(title) {
+    return title.normalize('NFKC').trim().toLocaleLowerCase('en-US').replace(/\s+/g, ' ');
+}
+export function applyV2ToV3Migration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_versions (
+      version INTEGER PRIMARY KEY,
+      applied_at INTEGER
+    );
+  `);
+    const currentMax = db.prepare(`SELECT COALESCE(MAX(version), 0) as v FROM schema_versions`).get().v;
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS distill_leases (
+      batch_id     TEXT PRIMARY KEY,
+      event_ids    TEXT NOT NULL,
+      session_ids  TEXT NOT NULL,
+      event_count  INTEGER NOT NULL,
+      created_at   INTEGER NOT NULL,
+      expires_at   INTEGER NOT NULL,
+      status       TEXT NOT NULL CHECK (status IN ('pending','committed','expired'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_leases_expires ON distill_leases(status, expires_at);
+  `);
+    if (currentMax < 3) {
+        db.prepare(`INSERT INTO schema_versions (version, applied_at) VALUES (3, ?)`).run(Date.now());
+    }
+    // v3 quality fields are additive for fresh databases and are rebuilt here for
+    // v2 databases whose observations still have the retired CHECK constraint.
+    const memoryColumns = db.pragma('table_info(memories)');
+    if (memoryColumns.length > 0 && !memoryColumns.some(column => column.name === 'last_accessed_at')) {
+        db.exec('ALTER TABLE memories ADD COLUMN last_accessed_at INTEGER');
+    }
+    const observationColumns = db.pragma('table_info(observations)');
+    const observationSql = db.prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = 'observations'").get()?.sql ?? '';
+    const needsRebuild = observationColumns.length > 0 && (!observationColumns.some(column => column.name === 'source')
+        || !observationColumns.some(column => column.name === 'dedup_key')
+        || observationSql.includes('session_summary'));
+    if (needsRebuild) {
+        db.pragma('foreign_keys = OFF');
+        db.exec(`
+      CREATE TABLE observations_v3_new (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        project TEXT NOT NULL DEFAULT '',
+        type TEXT NOT NULL,
+        title TEXT NOT NULL,
+        narrative TEXT NOT NULL DEFAULT '',
+        facts TEXT NOT NULL DEFAULT '[]',
+        files TEXT NOT NULL DEFAULT '[]',
+        tools TEXT NOT NULL DEFAULT '[]',
+        concepts TEXT NOT NULL DEFAULT '[]',
+        importance INTEGER NOT NULL DEFAULT 5,
+        confidence REAL NOT NULL DEFAULT 0.5,
+        source TEXT NOT NULL DEFAULT 'distill',
+        dedup_key TEXT,
+        access_count INTEGER NOT NULL DEFAULT 0,
+        updated_at INTEGER NOT NULL,
+        source_event_ids TEXT NOT NULL DEFAULT '[]',
+        memory_id TEXT,
+        embedding BLOB,
+        timestamp INTEGER NOT NULL
+      );
+      INSERT INTO observations_v3_new
+        (id, session_id, project, type, title, narrative, facts, files, tools,
+         concepts, importance, confidence, source, dedup_key, access_count,
+         updated_at, source_event_ids, memory_id, embedding, timestamp)
+      SELECT id, session_id, project, type, title, narrative, facts, files, tools,
+        concepts, importance, confidence, 'distill', NULL, 0, timestamp,
+        source_event_ids, memory_id, embedding, timestamp
+      FROM observations;
+      DROP TABLE observations;
+      ALTER TABLE observations_v3_new RENAME TO observations;
+      CREATE INDEX IF NOT EXISTS idx_observations_session ON observations(session_id);
+      CREATE INDEX IF NOT EXISTS idx_observations_project ON observations(project);
+      CREATE INDEX IF NOT EXISTS idx_observations_memory ON observations(memory_id);
+      CREATE INDEX IF NOT EXISTS idx_observations_type ON observations(type);
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_observations_dedup ON observations(dedup_key);
+    `);
+        db.pragma('foreign_keys = ON');
+    }
+    else if (observationColumns.length > 0) {
+        const addColumn = (name, sql) => {
+            if (!observationColumns.some(column => column.name === name))
+                db.exec(sql);
+        };
+        addColumn('source', "ALTER TABLE observations ADD COLUMN source TEXT NOT NULL DEFAULT 'distill'");
+        addColumn('dedup_key', 'ALTER TABLE observations ADD COLUMN dedup_key TEXT');
+        addColumn('access_count', 'ALTER TABLE observations ADD COLUMN access_count INTEGER NOT NULL DEFAULT 0');
+        addColumn('updated_at', 'ALTER TABLE observations ADD COLUMN updated_at INTEGER NOT NULL DEFAULT 0');
+        db.exec('UPDATE observations SET updated_at = timestamp WHERE updated_at = 0');
+        db.exec('CREATE UNIQUE INDEX IF NOT EXISTS idx_observations_dedup ON observations(dedup_key)');
+    }
+    const migratedObservationColumns = db.pragma('table_info(observations)');
+    if (migratedObservationColumns.some(column => column.name === 'dedup_key')) {
+        const tables = new Set(db.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all().map(row => row.name));
+        const rows = db.prepare('SELECT id, type, title FROM observations ORDER BY timestamp DESC, id DESC').all();
+        const updateKey = db.prepare('UPDATE observations SET dedup_key = ? WHERE id = ?');
+        const deleteDuplicate = db.prepare('DELETE FROM observations WHERE id = ?');
+        const seen = new Set();
+        db.transaction(() => {
+            for (const row of rows) {
+                const key = createHash('sha256').update(`${row.type}|${normalizeTitle(row.title)}`).digest('hex');
+                if (seen.has(key)) {
+                    if (tables.has('embeddings')) {
+                        db.prepare("DELETE FROM embeddings WHERE source_type = 'observation' AND source_id = ?").run(row.id);
+                    }
+                    if (tables.has('observation_concepts')) {
+                        db.prepare('DELETE FROM observation_concepts WHERE observation_id = ?').run(row.id);
+                    }
+                    deleteDuplicate.run(row.id);
+                }
+                else {
+                    seen.add(key);
+                    updateKey.run(key, row.id);
+                }
+            }
+            db.exec('CREATE UNIQUE INDEX IF NOT EXISTS idx_observations_dedup ON observations(dedup_key)');
+        })();
+    }
+}
+//# sourceMappingURL=v2-to-v3.js.map

package/dist/migrations/v2-to-v3.js.map

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

package/dist/migrations/v2-to-v3.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=v2-to-v3.test.d.ts.map

package/dist/migrations/v2-to-v3.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-to-v3.test.d.ts","sourceRoot":"","sources":["../../src/migrations/v2-to-v3.test.ts"],"names":[],"mappings":""}

package/dist/migrations/v2-to-v3.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import Database from "better-sqlite3";
+import { applyV2ToV3Migration } from "./v2-to-v3.js";
+describe("v2-to-v3 migration", () => {
+    let db;
+    beforeEach(() => {
+        db = new Database(":memory:");
+        db.exec(`CREATE TABLE schema_versions (version INTEGER PRIMARY KEY, applied_at INTEGER)`);
+        db.prepare(`INSERT INTO schema_versions VALUES (2, ?)`).run(Date.now());
+    });
+    it("creates distill_leases table with correct schema", () => {
+        applyV2ToV3Migration(db);
+        const cols = db.prepare(`PRAGMA table_info(distill_leases)`).all();
+        const names = cols.map(c => c.name).sort();
+        expect(names).toEqual(["batch_id", "created_at", "event_count", "event_ids", "expires_at", "session_ids", "status"]);
+    });
+    it("creates index on (status, expires_at)", () => {
+        applyV2ToV3Migration(db);
+        const indexes = db.prepare(`PRAGMA index_list(distill_leases)`).all();
+        expect(indexes.some(i => i.name === "idx_leases_expires")).toBe(true);
+    });
+    it("updates schema_versions to 3", () => {
+        applyV2ToV3Migration(db);
+        const rows = db.prepare(`SELECT version FROM schema_versions ORDER BY version`).all();
+        expect(rows.map(r => r.version)).toContain(3);
+    });
+    it("is idempotent (re-run does not throw or duplicate)", () => {
+        applyV2ToV3Migration(db);
+        expect(() => applyV2ToV3Migration(db)).not.toThrow();
+        const count = db.prepare(`SELECT COUNT(*) as n FROM schema_versions WHERE version = 3`).get().n;
+        expect(count).toBe(1);
+    });
+    it("does not duplicate version 3 if it already exists", () => {
+        db.prepare(`INSERT INTO schema_versions VALUES (3, ?)`).run(Date.now());
+        expect(() => applyV2ToV3Migration(db)).not.toThrow();
+        const count = db.prepare(`SELECT COUNT(*) as n FROM schema_versions WHERE version = 3`).get().n;
+        expect(count).toBe(1);
+    });
+    it("allows inserting a lease row", () => {
+        applyV2ToV3Migration(db);
+        db.prepare(`
+      INSERT INTO distill_leases (batch_id, event_ids, session_ids, event_count, created_at, expires_at, status)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run("batch1", '["e1","e2"]', '["s1"]', 2, Date.now(), Date.now() + 600_000, "pending");
+        const row = db.prepare(`SELECT * FROM distill_leases WHERE batch_id = 'batch1'`).get();
+        expect(row).toBeDefined();
+    });
+    it("rejects invalid lease status", () => {
+        applyV2ToV3Migration(db);
+        expect(() => db.prepare(`
+      INSERT INTO distill_leases (batch_id, event_ids, session_ids, event_count, created_at, expires_at, status)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run("batch1", "[]", "[]", 0, Date.now(), Date.now(), "open")).toThrow();
+    });
+    it("rebuilds legacy observations with quality columns and exact dedup", () => {
+        db.exec(`
+      CREATE TABLE memories (id TEXT PRIMARY KEY);
+      CREATE TABLE observations (
+        id TEXT PRIMARY KEY, session_id TEXT NOT NULL, project TEXT NOT NULL DEFAULT '',
+        type TEXT NOT NULL CHECK(type IN ('session_summary','config_discovery')),
+        title TEXT NOT NULL, narrative TEXT NOT NULL DEFAULT '', facts TEXT NOT NULL DEFAULT '[]',
+        files TEXT NOT NULL DEFAULT '[]', tools TEXT NOT NULL DEFAULT '[]', concepts TEXT NOT NULL DEFAULT '[]',
+        importance INTEGER NOT NULL DEFAULT 5, confidence REAL NOT NULL DEFAULT 0.5,
+        source_event_ids TEXT NOT NULL DEFAULT '[]', memory_id TEXT, embedding BLOB, timestamp INTEGER NOT NULL
+      );
+      INSERT INTO observations (id, session_id, type, title, timestamp) VALUES
+        ('old-1', 's1', 'config_discovery', 'Workspace Config', 1),
+        ('old-2', 's2', 'config_discovery', '  workspace   config  ', 2);
+    `);
+        applyV2ToV3Migration(db);
+        const memoryColumns = db.pragma('table_info(memories)');
+        const observationColumns = db.pragma('table_info(observations)');
+        expect(memoryColumns.map(column => column.name)).toContain('last_accessed_at');
+        expect(observationColumns.map(column => column.name)).toEqual(expect.arrayContaining([
+            'source', 'dedup_key', 'access_count', 'updated_at',
+        ]));
+        expect(db.prepare('SELECT COUNT(*) count FROM observations').get()).toMatchObject({ count: 1 });
+        expect(db.prepare('SELECT source, dedup_key FROM observations').get()).toMatchObject({
+            source: 'distill', dedup_key: expect.stringMatching(/^[a-f0-9]{64}$/),
+        });
+        expect(() => db.prepare(`
+      INSERT INTO observations
+        (id, session_id, type, title, updated_at, timestamp)
+      VALUES ('new-1', 's3', 'user_preference', 'Use npm run dev', 3, 3)
+    `).run()).not.toThrow();
+    });
+});
+//# sourceMappingURL=v2-to-v3.test.js.map

package/dist/migrations/v2-to-v3.test.js.map

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

package/dist/observation-types.d.ts

@@ -0,0 +1,7 @@
+export declare const OBSERVATION_TYPES: readonly ["project_convention", "error_resolution", "config_discovery", "user_preference", "decision_made", "file_relationship", "api_shape"];
+export type ObservationType = (typeof OBSERVATION_TYPES)[number];
+export type ObservationSource = 'distill' | 'explicit_intent' | 'manual';
+export declare function isObservationType(value: unknown): value is ObservationType;
+export declare function normalizeObservationTitle(title: string): string;
+export declare function observationDedupKey(type: ObservationType, title: string): string;
+//# sourceMappingURL=observation-types.d.ts.map

package/dist/observation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-types.d.ts","sourceRoot":"","sources":["../src/observation-types.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,+IAQpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAIzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhF"}

package/dist/observation-types.js

@@ -0,0 +1,27 @@
+import { createHash } from 'node:crypto';
+export const OBSERVATION_TYPES = [
+    'project_convention',
+    'error_resolution',
+    'config_discovery',
+    'user_preference',
+    'decision_made',
+    'file_relationship',
+    'api_shape',
+];
+const OBSERVATION_TYPE_SET = new Set(OBSERVATION_TYPES);
+export function isObservationType(value) {
+    return typeof value === 'string' && OBSERVATION_TYPE_SET.has(value);
+}
+export function normalizeObservationTitle(title) {
+    return title
+        .normalize('NFKC')
+        .trim()
+        .toLocaleLowerCase('en-US')
+        .replace(/\s+/g, ' ');
+}
+export function observationDedupKey(type, title) {
+    return createHash('sha256')
+        .update(`${type}|${normalizeObservationTitle(title)}`)
+        .digest('hex');
+}
+//# sourceMappingURL=observation-types.js.map

package/dist/observation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-types.js","sourceRoot":"","sources":["../src/observation-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,oBAAoB;IACpB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,eAAe;IACf,mBAAmB;IACnB,WAAW;CACH,CAAC;AAKX,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,iBAAiB,CAAC,CAAC;AAEhE,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,KAAK;SACT,SAAS,CAAC,MAAM,CAAC;SACjB,IAAI,EAAE;SACN,iBAAiB,CAAC,OAAO,CAAC;SAC1B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAqB,EAAE,KAAa;IACtE,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,IAAI,IAAI,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC;SACrD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/project-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-validator.d.ts","sourceRoot":"","sources":["../src/project-validator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAwBtE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK7D"}
+{"version":3,"file":"project-validator.d.ts","sourceRoot":"","sources":["../src/project-validator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAwBtE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI7D"}

package/dist/project-validator.js

@@ -1,4 +1,4 @@
-import { existsSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 export function validateProjectRoot(rootPath) {
     const pkgJson = join(rootPath, 'package.json');
@@ -27,7 +27,6 @@ export function hasForceInitSentinel(rootPath) {
     return existsSync(join(rootPath, '.devflow', '.force-init'));
 }
 export function writeForceInitSentinel(rootPath) {
-    const { mkdirSync, writeFileSync } = require('node:fs');
     const dir = join(rootPath, '.devflow');
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });

package/dist/project-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-validator.js","sourceRoot":"","sources":["../src/project-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,iDAAiD;YACzD,cAAc,EAAE,KAAK;YACrB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,4DAA4D;YACpE,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"project-validator.js","sourceRoot":"","sources":["../src/project-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,iDAAiD;YACzD,cAAc,EAAE,KAAK;YACrB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,4DAA4D;YACpE,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/rule-extractor.d.ts

@@ -0,0 +1,14 @@
+export interface RuleEvent {
+    tool: string;
+    command?: string;
+    exitCode?: number;
+    stderr?: string;
+}
+export interface RuleMemory {
+    category: 'procedural' | 'semantic' | 'failure_lesson' | 'episodic';
+    content: string;
+    originalText?: string;
+    confidence: number;
+}
+export declare function extractRuleMemories(events: RuleEvent[]): RuleMemory[];
+//# sourceMappingURL=rule-extractor.d.ts.map

package/dist/rule-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-extractor.d.ts","sourceRoot":"","sources":["../src/rule-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,gBAAgB,GAAG,UAAU,CAAC;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AA6GD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAMrE"}

package/dist/rule-extractor.js

@@ -0,0 +1,109 @@
+const ERROR_PATTERNS = [
+    { pattern: /ENOENT:\s*no such file or directory/i, shortDesc: 'File not found (ENOENT)' },
+    { pattern: /MODULE_NOT_FOUND/i, shortDesc: 'Module not found' },
+    { pattern: /TypeError:\s*(.+?)(?:\n|$)/i, shortDesc: 'TypeError occurred' },
+    { pattern: /ReferenceError:\s*(.+?)(?:\n|$)/i, shortDesc: 'ReferenceError occurred' },
+    { pattern: /syntax error/i, shortDesc: 'Syntax error in command' },
+    { pattern: /permission denied/i, shortDesc: 'Permission denied' },
+    { pattern: /command not found/i, shortDesc: 'Command not found' },
+    { pattern: /ECONNREFUSED/i, shortDesc: 'Connection refused' },
+    { pattern: /ETIMEDOUT/i, shortDesc: 'Connection timed out' },
+    { pattern: /Cannot find module\s+(['"`])(.+?)\1/i, shortDesc: 'Cannot find module' },
+    { pattern: /FOREIGN KEY constraint failed/i, shortDesc: 'Foreign key constraint violation' },
+    { pattern: /UNIQUE constraint failed/i, shortDesc: 'Unique constraint violation' },
+    { pattern: /out of memory/i, shortDesc: 'Out of memory' },
+];
+function extractFailures(events) {
+    const results = [];
+    for (const event of events) {
+        if (event.tool !== 'Bash' && event.tool !== 'bash_command')
+            continue;
+        const stderrText = event.stderr ?? '';
+        const hasErrorCode = event.exitCode !== undefined && event.exitCode !== null && event.exitCode !== 0;
+        const hasErrorKeyword = /error:|failed|traceback|fatal|killed/i.test(event.command ?? '');
+        const hasHttpError = /HTTP\s+[45]\d{2}/i.test(stderrText);
+        if (!stderrText && !hasErrorCode && !hasErrorKeyword && !hasHttpError)
+            continue;
+        const searchText = [stderrText, event.command].filter(Boolean).join(' ');
+        for (const { pattern, shortDesc } of ERROR_PATTERNS) {
+            const match = searchText.match(pattern);
+            if (!match)
+                continue;
+            const detail = (match[1] ?? match[0]).slice(0, 80);
+            const content = `Error in \`${event.command ?? event.tool}\`: ${shortDesc} — ${detail}`;
+            if (!results.some(result => result.content === content)) {
+                results.push({
+                    category: 'failure_lesson',
+                    content,
+                    confidence: hasErrorCode ? 0.85 : 0.5,
+                });
+            }
+            break;
+        }
+    }
+    return results;
+}
+function extractCorrections(events) {
+    const results = [];
+    for (let index = 0; index < events.length; index++) {
+        const current = events[index];
+        if (!current?.command || current.exitCode === 0)
+            continue;
+        for (let laterIndex = index + 1; laterIndex < Math.min(index + 6, events.length); laterIndex++) {
+            const later = events[laterIndex];
+            if (!later?.command || (later.exitCode != null && later.exitCode !== 0))
+                continue;
+            const currentBase = current.command.split(' ')[0];
+            const laterBase = later.command.split(' ')[0];
+            if (currentBase === laterBase && later.command !== current.command) {
+                const content = `When \`${current.command.slice(0, 60)}\` fails, use \`${later.command.slice(0, 60)}\` instead`;
+                if (!results.some(result => result.content === content)) {
+                    results.push({ category: 'procedural', content, confidence: 0.9 });
+                }
+                break;
+            }
+        }
+    }
+    return results;
+}
+function extractProjectKnowledge(events) {
+    const results = [];
+    for (const event of events) {
+        if (!event.command)
+            continue;
+        if (/npm\s+(install|ci)|pnpm\s+(install|add)|yarn\s+add/.test(event.command)) {
+            const packageMatch = event.command.match(/(?:install|add)\s+(?:-[\w]+\s+)*(@?[\w@./-]+)/);
+            if (packageMatch?.[1]) {
+                const content = `Project uses package: ${packageMatch[1]}`;
+                if (!results.some(result => result.content === content)) {
+                    results.push({ category: 'semantic', content, confidence: 0.65 });
+                }
+            }
+        }
+        if (/npx\s+|pnpm\s+exec\s+|pnpm\s+dlx\s+/.test(event.command)) {
+            const toolMatch = event.command.match(/(?:npx|pnpm\s+(?:exec|dlx))\s+(.+?)\s*$/);
+            if (toolMatch?.[1]) {
+                const content = `Project uses tool: ${toolMatch[1].trim()}`;
+                if (!results.some(result => result.content === content)) {
+                    results.push({ category: 'semantic', content, confidence: 0.65 });
+                }
+            }
+        }
+        const scriptMatch = event.command.match(/npm\s+run\s+(\S+)/);
+        if (scriptMatch?.[1]) {
+            const content = `Project has npm script: ${scriptMatch[1]}`;
+            if (!results.some(result => result.content === content)) {
+                results.push({ category: 'semantic', content, confidence: 0.6 });
+            }
+        }
+    }
+    return results;
+}
+export function extractRuleMemories(events) {
+    return [
+        ...extractFailures(events),
+        ...extractCorrections(events),
+        ...extractProjectKnowledge(events),
+    ].filter(candidate => candidate.confidence >= 0.4);
+}
+//# sourceMappingURL=rule-extractor.js.map

package/dist/rule-extractor.js.map

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

package/dist/session-summarizer.d.ts

@@ -1,10 +1,18 @@
-import type { MemoryStore } from './memory-store.js';
-export interface SummarizerResult {
-    observationCount: number;
-    provider: string;
-    latencyMs: number;
-    groupsProcessed: number;
-    groupsSkipped: number;
+import { type EventGroup } from './event-grouper.js';
+import { type ObservationType } from './observation-types.js';
+export { OBSERVATION_TYPES } from './observation-types.js';
+export type { ObservationType } from './observation-types.js';
+export declare const DEFAULT_PROMPT_TOKEN_BUDGET = 4000;
+export declare const SUMMARY_SYSTEM = "You are a session summarizer for DevFlow, a developer toolchain AI.\nYour task is to analyze groups of tool-call events from a coding session and extract structured observations.\n\nFor each group, produce ONE observation (omit groups with no meaningful insight).\n\nOutput a JSON array of observations. Each observation:\n- type: exactly one of \"project_convention\" | \"error_resolution\" | \"config_discovery\" | \"user_preference\" | \"decision_made\" | \"file_relationship\" | \"api_shape\"\n- title: short summary (max 80 chars, in English)\n- narrative: 1-2 sentence description of what happened and why it matters\n- facts: array of strings - specific factual statements\n- concepts: array of 1-5 key concepts/topics (lowercase, single words or short phrases)\n- importance: 1-10 (10 = critical fix or key decision, 5 = notable, 1 = trivial)\n- confidence: 0.0-1.0\n\nRules:\n- Focus on WHAT WAS LEARNED, not what was executed\n- Errors + their fixes = high signal (importance 7-10)\n- Config discoveries = medium signal (importance 5-7)\n- Routine operations (ls, cat, cd) = skip\n- Classify only durable, reusable project knowledge. Use project_convention for repository rules,\n  user_preference for explicit user choices, file_relationship for meaningful file dependencies,\n  and api_shape for interfaces, schemas, or call contracts.\n- If a group cannot be assigned to exactly one of the seven types, omit it. If the whole batch\n  has no classifiable project knowledge, return [] rather than a session recap or tool log.\n- Translate non-English content to English\n- Return ONLY the JSON array, no markdown, no explanation\n\nGOOD example:\n[{\"type\":\"project_convention\",\"title\":\"Tests run through the workspace Vitest script\",\"narrative\":\"The repository defines its test entry point as npm test in the package workspace.\",\"facts\":[\"packages/memory-engine/package.json defines test as vitest run\",\"Tests should be invoked through the workspace script\"],\"concepts\":[\"vitest\",\"npm\",\"workspace\"],\"importance\":7,\"confidence\":0.95}]\n\nBAD examples (do not emit these):\n[{\"type\":\"session_summary\",\"title\":\"Worked on the memory engine\",\"narrative\":\"The developer inspected files, ran commands, and made changes.\",\"facts\":[\"Several tools were used\"],\"concepts\":[\"session\"],\"importance\":3,\"confidence\":0.9}]\n[{\"type\":\"user_insight\",\"title\":\"The session had an error\",\"narrative\":\"An error happened and was investigated.\",\"facts\":[\"A command failed\"],\"concepts\":[\"error\"],\"importance\":4,\"confidence\":0.8}]\n[{\"type\":\"file_operation\",\"title\":\"Read and edited files\",\"narrative\":\"The developer read files and then edited them.\",\"facts\":[\"Files were changed\"],\"concepts\":[\"files\"],\"importance\":2,\"confidence\":0.99}]";
+export declare function buildSummaryPrompt(groups: EventGroup[], tokenBudget?: number): string;
+export interface ParsedObservation {
+    type: ObservationType;
+    title: string;
+    narrative?: string;
+    facts?: string[];
+    concepts?: string[];
+    importance?: number;
+    confidence?: number;
 }
-export declare function summarizeSession(store: MemoryStore, sessionId: string, projectRoot: string): Promise<SummarizerResult>;
+export declare function estimatePromptTokens(text: string): number;
 //# sourceMappingURL=session-summarizer.d.ts.map

package/dist/session-summarizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-summarizer.d.ts","sourceRoot":"","sources":["../src/session-summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,mBAAmB,CAAC;AAiC/D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAuG3B"}
+{"version":3,"file":"session-summarizer.d.ts","sourceRoot":"","sources":["../src/session-summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAGhD,eAAO,MAAM,cAAc,6wFAiCmL,CAAC;AAE/M,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,WAAW,SAA8B,GACxC,MAAM,CAyBR;AAqBD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}